@dyanet/nestjs-config-aws 1.0.1

package/dist/types/interfaces/default-schema.interface.d.ts

@@ -0,0 +1,195 @@
+import { z } from 'zod';
+/**
+ * Default configuration schema using Zod.
+ * Provides a flexible base schema that can be extended by applications.
+ */
+export declare const defaultConfigSchema: z.ZodObject<{
+    /** Node.js environment */
+    NODE_ENV: z.ZodOptional<z.ZodEnum<["production", "development", "test"]>>;
+    /** Application environment (mirrors NODE_ENV with 'local' default) */
+    APP_ENV: z.ZodDefault<z.ZodEnum<["production", "test", "development", "local"]>>;
+    /** AWS region for services */
+    AWS_REGION: z.ZodOptional<z.ZodString>;
+    /** AWS profile for local development */
+    AWS_PROFILE: z.ZodOptional<z.ZodString>;
+    /** Application port */
+    PORT: z.ZodOptional<z.ZodNumber>;
+    /** Application host */
+    HOST: z.ZodOptional<z.ZodString>;
+    /** Log level */
+    LOG_LEVEL: z.ZodOptional<z.ZodEnum<["error", "warn", "info", "debug", "verbose"]>>;
+    /** Database URL */
+    DATABASE_URL: z.ZodOptional<z.ZodString>;
+    /** Redis URL */
+    REDIS_URL: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    APP_ENV: "production" | "development" | "test" | "local";
+    NODE_ENV?: "production" | "development" | "test" | undefined;
+    AWS_REGION?: string | undefined;
+    AWS_PROFILE?: string | undefined;
+    PORT?: number | undefined;
+    HOST?: string | undefined;
+    LOG_LEVEL?: "error" | "warn" | "info" | "debug" | "verbose" | undefined;
+    DATABASE_URL?: string | undefined;
+    REDIS_URL?: string | undefined;
+}, {
+    NODE_ENV?: "production" | "development" | "test" | undefined;
+    APP_ENV?: "production" | "development" | "test" | "local" | undefined;
+    AWS_REGION?: string | undefined;
+    AWS_PROFILE?: string | undefined;
+    PORT?: number | undefined;
+    HOST?: string | undefined;
+    LOG_LEVEL?: "error" | "warn" | "info" | "debug" | "verbose" | undefined;
+    DATABASE_URL?: string | undefined;
+    REDIS_URL?: string | undefined;
+}>;
+/**
+ * Type inference for the default configuration schema.
+ */
+export type DefaultConfigSchema = z.infer<typeof defaultConfigSchema>;
+/**
+ * Environment-specific validation schemas.
+ */
+export declare const environmentSchemas: {
+    local: z.ZodObject<{
+        NODE_ENV: z.ZodOptional<z.ZodEnum<["production", "development", "test"]>>;
+        APP_ENV: z.ZodDefault<z.ZodEnum<["production", "test", "development", "local"]>>;
+        AWS_PROFILE: z.ZodOptional<z.ZodString>;
+        PORT: z.ZodOptional<z.ZodNumber>;
+        HOST: z.ZodOptional<z.ZodString>;
+        LOG_LEVEL: z.ZodOptional<z.ZodEnum<["error", "warn", "info", "debug", "verbose"]>>;
+        DATABASE_URL: z.ZodOptional<z.ZodString>;
+        REDIS_URL: z.ZodOptional<z.ZodString>;
+    } & {
+        AWS_REGION: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        APP_ENV: "production" | "development" | "test" | "local";
+        NODE_ENV?: "production" | "development" | "test" | undefined;
+        AWS_REGION?: string | undefined;
+        AWS_PROFILE?: string | undefined;
+        PORT?: number | undefined;
+        HOST?: string | undefined;
+        LOG_LEVEL?: "error" | "warn" | "info" | "debug" | "verbose" | undefined;
+        DATABASE_URL?: string | undefined;
+        REDIS_URL?: string | undefined;
+    }, {
+        NODE_ENV?: "production" | "development" | "test" | undefined;
+        APP_ENV?: "production" | "development" | "test" | "local" | undefined;
+        AWS_REGION?: string | undefined;
+        AWS_PROFILE?: string | undefined;
+        PORT?: number | undefined;
+        HOST?: string | undefined;
+        LOG_LEVEL?: "error" | "warn" | "info" | "debug" | "verbose" | undefined;
+        DATABASE_URL?: string | undefined;
+        REDIS_URL?: string | undefined;
+    }>;
+    development: z.ZodObject<{
+        NODE_ENV: z.ZodOptional<z.ZodEnum<["production", "development", "test"]>>;
+        APP_ENV: z.ZodDefault<z.ZodEnum<["production", "test", "development", "local"]>>;
+        AWS_PROFILE: z.ZodOptional<z.ZodString>;
+        PORT: z.ZodOptional<z.ZodNumber>;
+        HOST: z.ZodOptional<z.ZodString>;
+        LOG_LEVEL: z.ZodOptional<z.ZodEnum<["error", "warn", "info", "debug", "verbose"]>>;
+        DATABASE_URL: z.ZodOptional<z.ZodString>;
+        REDIS_URL: z.ZodOptional<z.ZodString>;
+    } & {
+        AWS_REGION: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        APP_ENV: "production" | "development" | "test" | "local";
+        AWS_REGION: string;
+        NODE_ENV?: "production" | "development" | "test" | undefined;
+        AWS_PROFILE?: string | undefined;
+        PORT?: number | undefined;
+        HOST?: string | undefined;
+        LOG_LEVEL?: "error" | "warn" | "info" | "debug" | "verbose" | undefined;
+        DATABASE_URL?: string | undefined;
+        REDIS_URL?: string | undefined;
+    }, {
+        AWS_REGION: string;
+        NODE_ENV?: "production" | "development" | "test" | undefined;
+        APP_ENV?: "production" | "development" | "test" | "local" | undefined;
+        AWS_PROFILE?: string | undefined;
+        PORT?: number | undefined;
+        HOST?: string | undefined;
+        LOG_LEVEL?: "error" | "warn" | "info" | "debug" | "verbose" | undefined;
+        DATABASE_URL?: string | undefined;
+        REDIS_URL?: string | undefined;
+    }>;
+    test: z.ZodObject<{
+        NODE_ENV: z.ZodOptional<z.ZodEnum<["production", "development", "test"]>>;
+        APP_ENV: z.ZodDefault<z.ZodEnum<["production", "test", "development", "local"]>>;
+        AWS_PROFILE: z.ZodOptional<z.ZodString>;
+        PORT: z.ZodOptional<z.ZodNumber>;
+        HOST: z.ZodOptional<z.ZodString>;
+        LOG_LEVEL: z.ZodOptional<z.ZodEnum<["error", "warn", "info", "debug", "verbose"]>>;
+        DATABASE_URL: z.ZodOptional<z.ZodString>;
+        REDIS_URL: z.ZodOptional<z.ZodString>;
+    } & {
+        AWS_REGION: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        APP_ENV: "production" | "development" | "test" | "local";
+        AWS_REGION: string;
+        NODE_ENV?: "production" | "development" | "test" | undefined;
+        AWS_PROFILE?: string | undefined;
+        PORT?: number | undefined;
+        HOST?: string | undefined;
+        LOG_LEVEL?: "error" | "warn" | "info" | "debug" | "verbose" | undefined;
+        DATABASE_URL?: string | undefined;
+        REDIS_URL?: string | undefined;
+    }, {
+        AWS_REGION: string;
+        NODE_ENV?: "production" | "development" | "test" | undefined;
+        APP_ENV?: "production" | "development" | "test" | "local" | undefined;
+        AWS_PROFILE?: string | undefined;
+        PORT?: number | undefined;
+        HOST?: string | undefined;
+        LOG_LEVEL?: "error" | "warn" | "info" | "debug" | "verbose" | undefined;
+        DATABASE_URL?: string | undefined;
+        REDIS_URL?: string | undefined;
+    }>;
+    production: z.ZodObject<{
+        NODE_ENV: z.ZodOptional<z.ZodEnum<["production", "development", "test"]>>;
+        APP_ENV: z.ZodDefault<z.ZodEnum<["production", "test", "development", "local"]>>;
+        AWS_PROFILE: z.ZodOptional<z.ZodString>;
+        PORT: z.ZodOptional<z.ZodNumber>;
+        HOST: z.ZodOptional<z.ZodString>;
+        DATABASE_URL: z.ZodOptional<z.ZodString>;
+        REDIS_URL: z.ZodOptional<z.ZodString>;
+    } & {
+        AWS_REGION: z.ZodString;
+        LOG_LEVEL: z.ZodDefault<z.ZodEnum<["error", "warn", "info"]>>;
+    }, "strip", z.ZodTypeAny, {
+        APP_ENV: "production" | "development" | "test" | "local";
+        AWS_REGION: string;
+        LOG_LEVEL: "error" | "warn" | "info";
+        NODE_ENV?: "production" | "development" | "test" | undefined;
+        AWS_PROFILE?: string | undefined;
+        PORT?: number | undefined;
+        HOST?: string | undefined;
+        DATABASE_URL?: string | undefined;
+        REDIS_URL?: string | undefined;
+    }, {
+        AWS_REGION: string;
+        NODE_ENV?: "production" | "development" | "test" | undefined;
+        APP_ENV?: "production" | "development" | "test" | "local" | undefined;
+        AWS_PROFILE?: string | undefined;
+        PORT?: number | undefined;
+        HOST?: string | undefined;
+        LOG_LEVEL?: "error" | "warn" | "info" | undefined;
+        DATABASE_URL?: string | undefined;
+        REDIS_URL?: string | undefined;
+    }>;
+};
+/**
+ * Helper function to get the appropriate schema for the current environment.
+ */
+export declare function getSchemaForEnvironment(appEnv: string): z.ZodSchema;
+/**
+ * Validation helper for APP_ENV values.
+ */
+export declare const appEnvSchema: z.ZodEnum<["production", "test", "development", "local"]>;
+/**
+ * Type for valid APP_ENV values.
+ */
+export type AppEnv = z.infer<typeof appEnvSchema>;
+//# sourceMappingURL=default-schema.interface.d.ts.map

package/dist/types/interfaces/default-schema.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-schema.interface.d.ts","sourceRoot":"","sources":["../../../src/interfaces/default-schema.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,mBAAmB;IAC9B,0BAA0B;;IAG1B,sEAAsE;;IAGtE,8BAA8B;;IAG9B,wCAAwC;;IAGxC,uBAAuB;;IAGvB,uBAAuB;;IAGvB,gBAAgB;;IAGhB,mBAAmB;;IAGnB,gBAAgB;;;;;;;;;;;;;;;;;;;;;;EAEhB,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEtE;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqB9B,CAAC;AAEF;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,CAAC,SAAS,CAGnE;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,2DAAyD,CAAC;AAEnF;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/types/interfaces/errors.interface.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Base error class for all configuration-related errors.
+ */
+export declare class ConfigurationError extends Error {
+    readonly cause?: Error | undefined;
+    constructor(message: string, cause?: Error | undefined);
+}
+/**
+ * Error thrown when configuration validation fails.
+ */
+export declare class ValidationError extends ConfigurationError {
+    readonly validationErrors: any;
+    readonly invalidKeys?: string[] | undefined;
+    constructor(message: string, validationErrors: any, invalidKeys?: string[] | undefined);
+}
+/**
+ * Error thrown when AWS service operations fail.
+ */
+export declare class AWSServiceError extends ConfigurationError {
+    readonly service: 'SecretsManager' | 'SSM';
+    readonly operation: string;
+    constructor(message: string, service: 'SecretsManager' | 'SSM', operation: string, cause?: Error);
+}
+/**
+ * Error thrown when required configuration is missing.
+ */
+export declare class MissingConfigurationError extends ConfigurationError {
+    readonly missingKeys: string[];
+    constructor(missingKeys: string[], message?: string);
+}
+/**
+ * Error thrown when configuration loading fails.
+ */
+export declare class ConfigurationLoadError extends ConfigurationError {
+    readonly loader: string;
+    constructor(message: string, loader: string, cause?: Error);
+}
+//# sourceMappingURL=errors.interface.d.ts.map

package/dist/types/interfaces/errors.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.interface.d.ts","sourceRoot":"","sources":["../../../src/interfaces/errors.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;aACE,KAAK,CAAC,EAAE,KAAK;gBAA9C,OAAO,EAAE,MAAM,EAAkB,KAAK,CAAC,EAAE,KAAK,YAAA;CAS3D;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,kBAAkB;aAGnC,gBAAgB,EAAE,GAAG;aACrB,WAAW,CAAC,EAAE,MAAM,EAAE;gBAFtC,OAAO,EAAE,MAAM,EACC,gBAAgB,EAAE,GAAG,EACrB,WAAW,CAAC,EAAE,MAAM,EAAE,YAAA;CASzC;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,kBAAkB;aAGnC,OAAO,EAAE,gBAAgB,GAAG,KAAK;aACjC,SAAS,EAAE,MAAM;gBAFjC,OAAO,EAAE,MAAM,EACC,OAAO,EAAE,gBAAgB,GAAG,KAAK,EACjC,SAAS,EAAE,MAAM,EACjC,KAAK,CAAC,EAAE,KAAK;CAShB;AAED;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,kBAAkB;aAE7C,WAAW,EAAE,MAAM,EAAE;gBAArB,WAAW,EAAE,MAAM,EAAE,EACrC,OAAO,CAAC,EAAE,MAAM;CASnB;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,kBAAkB;aAG1C,MAAM,EAAE,MAAM;gBAD9B,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EAC9B,KAAK,CAAC,EAAE,KAAK;CAShB"}

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

@@ -0,0 +1,6 @@
+export * from './config-service.interface';
+export * from './config-loader.interface';
+export * from './module-options.interface';
+export * from './errors.interface';
+export * from './default-schema.interface';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/interfaces/index.ts"],"names":[],"mappings":"AACA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAG3C,cAAc,oBAAoB,CAAC;AAGnC,cAAc,4BAA4B,CAAC"}

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

@@ -0,0 +1,64 @@
+import { ZodType } from 'zod';
+/**
+ * Configuration for AWS Secrets Manager integration.
+ */
+export interface SecretsManagerConfig {
+    /** AWS region for Secrets Manager */
+    region?: string;
+    /** Base path for secrets in different environments */
+    paths?: {
+        development?: string;
+        test?: string;
+        production?: string;
+    };
+    /** Whether to enable Secrets Manager integration */
+    enabled?: boolean;
+}
+/**
+ * Configuration for AWS Systems Manager Parameter Store integration.
+ */
+export interface SSMConfig {
+    /** AWS region for SSM Parameter Store */
+    region?: string;
+    /** Base path for parameters in different environments */
+    paths?: {
+        development?: string;
+        test?: string;
+        production?: string;
+    };
+    /** Whether to enable SSM Parameter Store integration */
+    enabled?: boolean;
+    /** Whether to decrypt SecureString parameters */
+    decrypt?: boolean;
+}
+/**
+ * Options for configuring the NestJS AWS Configuration module.
+ */
+export interface NestConfigAwsModuleOptions<T = any> {
+    /** Zod schema for configuration validation */
+    schema?: ZodType<T>;
+    /** Configuration for AWS Secrets Manager integration */
+    secretsManagerConfig?: SecretsManagerConfig;
+    /** Configuration for AWS Systems Manager Parameter Store integration */
+    ssmConfig?: SSMConfig;
+    /** Prefix for environment variables (e.g., 'APP_') */
+    envPrefix?: string;
+    /** Whether to ignore validation errors and continue with partial config */
+    ignoreValidationErrors?: boolean;
+    /** Custom environment variable name for APP_ENV (defaults to 'APP_ENV') */
+    appEnvVariable?: string;
+    /** Whether to load configuration synchronously during module initialization */
+    loadSync?: boolean;
+}
+/**
+ * Async factory options for dynamic module configuration.
+ */
+export interface NestConfigAwsModuleAsyncOptions<T = any> {
+    /** Factory function to create module options */
+    useFactory: (...args: any[]) => Promise<NestConfigAwsModuleOptions<T>> | NestConfigAwsModuleOptions<T>;
+    /** Dependencies to inject into the factory function */
+    inject?: any[];
+    /** Imports required for the factory function */
+    imports?: any[];
+}
+//# sourceMappingURL=module-options.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"module-options.interface.d.ts","sourceRoot":"","sources":["../../../src/interfaces/module-options.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAE9B;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,KAAK,CAAC,EAAE;QACN,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,oDAAoD;IACpD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,KAAK,CAAC,EAAE;QACN,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,wDAAwD;IACxD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iDAAiD;IACjD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B,CAAC,CAAC,GAAG,GAAG;IACjD,8CAA8C;IAC9C,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAEpB,wDAAwD;IACxD,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAE5C,wEAAwE;IACxE,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,2EAA2E;IAC3E,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,+BAA+B,CAAC,CAAC,GAAG,GAAG;IACtD,gDAAgD;IAChD,UAAU,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC,GAAG,0BAA0B,CAAC,CAAC,CAAC,CAAC;IAEvG,uDAAuD;IACvD,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;IAEf,gDAAgD;IAChD,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC;CACjB"}

package/dist/types/loaders/environment.loader.d.ts

@@ -0,0 +1,26 @@
+import { ConfigLoader } from '../interfaces/config-loader.interface';
+/**
+ * Configuration loader that loads values from environment variables (process.env).
+ * This loader is always available and serves as the base configuration source.
+ */
+export declare class EnvironmentLoader implements ConfigLoader {
+    private readonly envPrefix?;
+    constructor(envPrefix?: string);
+    /**
+     * Load configuration from environment variables.
+     * @returns Promise resolving to environment variables as key-value pairs
+     */
+    load(): Promise<Record<string, any>>;
+    /**
+     * Get the name of this loader for logging and debugging.
+     * @returns The loader name
+     */
+    getName(): string;
+    /**
+     * Check if this loader is available.
+     * Environment variables are always available.
+     * @returns Promise resolving to true
+     */
+    isAvailable(): Promise<boolean>;
+}
+//# sourceMappingURL=environment.loader.d.ts.map

package/dist/types/loaders/environment.loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.loader.d.ts","sourceRoot":"","sources":["../../../src/loaders/environment.loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAErE;;;GAGG;AACH,qBAAa,iBAAkB,YAAW,YAAY;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;gBAExB,SAAS,CAAC,EAAE,MAAM;IAI9B;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IA6B1C;;;OAGG;IACH,OAAO,IAAI,MAAM;IAIjB;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAGtC"}

package/dist/types/loaders/secrets-manager.loader.d.ts

@@ -0,0 +1,52 @@
+import { ConfigLoader } from '../interfaces/config-loader.interface';
+/**
+ * Configuration options for SecretsManagerLoader
+ */
+export interface SecretsManagerLoaderConfig {
+    /**
+     * Base secret name/path (without environment prefix)
+     * @default '/nestjs-config-aws'
+     */
+    secretName?: string;
+    /**
+     * AWS region for Secrets Manager client
+     * If not provided, will use AWS_REGION environment variable or default to 'us-east-1'
+     */
+    region?: string;
+    /**
+     * Custom environment mapping for secret paths
+     * @default { development: 'dev', test: 'test', production: 'production' }
+     */
+    environmentMapping?: Record<string, string>;
+}
+/**
+ * Configuration loader that loads values from AWS Secrets Manager.
+ * Supports environment-aware secret path construction and JSON parsing with string fallback.
+ */
+export declare class SecretsManagerLoader implements ConfigLoader {
+    private readonly client;
+    private readonly config;
+    private readonly appEnv;
+    constructor(config?: SecretsManagerLoaderConfig);
+    /**
+     * Load configuration from AWS Secrets Manager.
+     * @returns Promise resolving to configuration key-value pairs from the secret
+     */
+    load(): Promise<Record<string, any>>;
+    /**
+     * Get the name of this loader for logging and debugging.
+     * @returns The loader name with secret path
+     */
+    getName(): string;
+    /**
+     * Check if this loader is available in the current environment.
+     * @returns Promise resolving to true if not in local environment and AWS credentials are available
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Build the environment-aware secret name/path.
+     * @returns The full secret name with environment prefix
+     */
+    private buildSecretName;
+}
+//# sourceMappingURL=secrets-manager.loader.d.ts.map

package/dist/types/loaders/secrets-manager.loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets-manager.loader.d.ts","sourceRoot":"","sources":["../../../src/loaders/secrets-manager.loader.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAGrE;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7C;AAED;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,GAAE,0BAA+B;IAqBnD;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IA8D1C;;;OAGG;IACH,OAAO,IAAI,MAAM;IAKjB;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAgBrC;;;OAGG;IACH,OAAO,CAAC,eAAe;CAYxB"}

package/dist/types/loaders/ssm-parameter-store.loader.d.ts

@@ -0,0 +1,68 @@
+import { ConfigLoader } from '../interfaces/config-loader.interface';
+/**
+ * Configuration options for SSMParameterStoreLoader
+ */
+export interface SSMParameterStoreLoaderConfig {
+    /**
+     * Base parameter path (without environment prefix)
+     * @default '/nestjs-config-aws'
+     */
+    parameterPath?: string;
+    /**
+     * AWS region for SSM client
+     * If not provided, will use AWS_REGION environment variable or default to 'us-east-1'
+     */
+    region?: string;
+    /**
+     * Custom environment mapping for parameter paths
+     * @default { development: 'dev', test: 'test', production: 'production' }
+     */
+    environmentMapping?: Record<string, string>;
+    /**
+     * Whether to decrypt SecureString parameters
+     * @default true
+     */
+    withDecryption?: boolean;
+}
+/**
+ * Configuration loader that loads values from AWS Systems Manager Parameter Store.
+ * Supports environment-aware parameter path construction, recursive parameter fetching with pagination,
+ * and parameter name transformation (remove prefix, convert to uppercase).
+ */
+export declare class SSMParameterStoreLoader implements ConfigLoader {
+    private readonly client;
+    private readonly config;
+    private readonly appEnv;
+    constructor(config?: SSMParameterStoreLoaderConfig);
+    /**
+     * Load configuration from AWS Systems Manager Parameter Store.
+     * Implements recursive parameter fetching with NextToken handling for pagination.
+     * @returns Promise resolving to configuration key-value pairs from parameters
+     */
+    load(): Promise<Record<string, any>>;
+    /**
+     * Get the name of this loader for logging and debugging.
+     * @returns The loader name with parameter path
+     */
+    getName(): string;
+    /**
+     * Check if this loader is available in the current environment.
+     * @returns Promise resolving to true if not in local environment, AWS_REGION is set, and AWS credentials are available
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Build the environment-aware parameter path.
+     * @returns The full parameter path with environment prefix
+     */
+    private buildParameterPath;
+    /**
+     * Transform parameter name by removing the prefix and converting to uppercase.
+     * Example: '/dev/nestjs-config-aws/database/host' -> 'DATABASEHOST'
+     * This matches the original prospectory-backend implementation
+     * @param parameterName The full parameter name from AWS
+     * @param pathPrefix The path prefix to remove
+     * @returns The transformed parameter name or null if invalid
+     */
+    private transformParameterName;
+}
+//# sourceMappingURL=ssm-parameter-store.loader.d.ts.map

package/dist/types/loaders/ssm-parameter-store.loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssm-parameter-store.loader.d.ts","sourceRoot":"","sources":["../../../src/loaders/ssm-parameter-store.loader.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAGrE;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE5C;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;GAIG;AACH,qBAAa,uBAAwB,YAAW,YAAY;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;IACjE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,GAAE,6BAAkC;IAsBtD;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAsE1C;;;OAGG;IACH,OAAO,IAAI,MAAM;IAKjB;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAgBrC;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;;;;;;OAOG;IACH,OAAO,CAAC,sBAAsB;CAY/B"}

package/dist/types/services/config.service.d.ts

@@ -0,0 +1,94 @@
+import { ZodType } from 'zod';
+import { ConfigService } from '../interfaces/config-service.interface';
+import { ConfigLoader } from '../interfaces/config-loader.interface';
+import { DefaultConfigSchema } from '../interfaces/default-schema.interface';
+/**
+ * Configuration options for ConfigServiceImpl
+ */
+export interface ConfigServiceOptions<T = DefaultConfigSchema> {
+    /**
+     * Zod schema for configuration validation
+     * @default defaultConfigSchema
+     */
+    schema?: ZodType<T>;
+    /**
+     * Custom configuration loaders
+     * If not provided, default loaders (env, secrets manager, ssm) will be used
+     */
+    loaders?: ConfigLoader[];
+    /**
+     * Environment variable prefix for EnvironmentLoader
+     */
+    envPrefix?: string;
+    /**
+     * Whether to validate configuration on load
+     * @default true
+     */
+    validateOnLoad?: boolean;
+    /**
+     * Whether to log configuration loading steps
+     * @default true
+     */
+    enableLogging?: boolean;
+}
+/**
+ * Implementation of ConfigService with AWS integration and APP_ENV logic.
+ * Provides type-safe configuration access with orchestrated loading from multiple sources.
+ */
+export declare class ConfigServiceImpl<T = DefaultConfigSchema> extends ConfigService<T> {
+    private readonly logger;
+    private readonly schema;
+    private readonly loaders;
+    private readonly options;
+    private config;
+    private initialized;
+    private appEnv;
+    constructor(options?: ConfigServiceOptions<T>);
+    /**
+     * Initialize the configuration service by loading and validating configuration.
+     * This method should be called during application startup.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get a configuration value by key with type safety.
+     * @param key - The configuration key to retrieve
+     * @returns The configuration value with proper typing
+     */
+    get<K extends keyof T>(key: K): T[K];
+    /**
+     * Check if the configuration service has been initialized.
+     * @returns True if the service is ready to serve configuration values
+     */
+    isInitialized(): boolean;
+    /**
+     * Get all configuration values.
+     * @returns The complete configuration object
+     */
+    getAll(): T;
+    /**
+     * Get the current APP_ENV value.
+     * @returns The current application environment
+     */
+    getAppEnv(): string;
+    /**
+     * Initialize APP_ENV with NODE_ENV mirroring and warning logic.
+     * Implements requirement 2.0: APP_ENV mirroring NODE_ENV with "local" default and warning logic.
+     */
+    private initializeAppEnv;
+    /**
+     * Create default configuration loaders.
+     * @returns Array of default loaders in precedence order
+     */
+    private createDefaultLoaders;
+    /**
+     * Load configuration from all sources with proper precedence order.
+     * Implements orchestration: env -> secrets -> ssm with proper merging.
+     */
+    private loadConfiguration;
+    /**
+     * Handle local environment overrides according to requirement 2.4.
+     * In local mode with valid AWS profile and .env file, .env values override AWS values.
+     */
+    private handleLocalEnvironmentOverrides;
+}
+//# sourceMappingURL=config.service.d.ts.map

package/dist/types/services/config.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.service.d.ts","sourceRoot":"","sources":["../../../src/services/config.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAE9B,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAyC,MAAM,wCAAwC,CAAC;AAOpH;;GAEG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC,GAAG,mBAAmB;IAC3D;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAEpB;;;OAGG;IACH,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IAEzB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;GAGG;AACH,qBACa,iBAAiB,CAAC,CAAC,GAAG,mBAAmB,CAAE,SAAQ,aAAa,CAAC,CAAC,CAAC;IAC9E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;IAC7D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAItB;IAEF,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,GAAE,oBAAoB,CAAC,CAAC,CAAM;IAoBjD;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAoCjC;;;;OAIG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAUpC;;;OAGG;IACH,aAAa,IAAI,OAAO;IAIxB;;;OAGG;IACH,MAAM,IAAI,CAAC;IAUX;;;OAGG;IACH,SAAS,IAAI,MAAM;IAInB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IA+DxB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAQ5B;;;OAGG;YACW,iBAAiB;IAqD/B;;;OAGG;YACW,+BAA+B;CA8C9C"}

package/dist/types/utils/validation.util.d.ts

@@ -0,0 +1,53 @@
+import { ZodError, ZodType, TypeOf } from 'zod';
+import { ValidationError } from '../interfaces/errors.interface';
+/**
+ * Framework-agnostic validation utility for configuration values
+ * Adapted from ZodValidationPipe for standalone use
+ */
+export declare class ConfigValidationUtil {
+    /**
+     * Validates a value against a Zod schema
+     * @param schema The Zod schema to validate against
+     * @param value The value to validate
+     * @param context Optional context for error messages
+     * @returns The validated and transformed value
+     * @throws ValidationError if validation fails
+     */
+    static validate<T extends ZodType>(schema: T, value: unknown, context?: string): TypeOf<T>;
+    /**
+     * Safely validates a value against a Zod schema without throwing
+     * @param schema The Zod schema to validate against
+     * @param value The value to validate
+     * @returns Object with success flag and either data or error
+     */
+    static safeValidate<T extends ZodType>(schema: T, value: unknown): {
+        success: true;
+        data: TypeOf<T>;
+    } | {
+        success: false;
+        error: ValidationError;
+    };
+    /**
+     * Formats Zod validation errors into a structured format
+     * @param error The ZodError to format
+     * @returns Formatted error object or string
+     */
+    static formatValidationErrors(error: ZodError): any;
+    /**
+     * Creates a detailed error message for configuration validation failures
+     * @param error The ZodError to create a message for
+     * @param context Optional context for the error
+     * @returns Detailed error message string
+     */
+    static createDetailedErrorMessage(error: ZodError, context?: string): string;
+    /**
+     * Validates configuration with enhanced error context
+     * @param schema The Zod schema to validate against
+     * @param value The configuration object to validate
+     * @param source The source of the configuration (e.g., 'environment', 'secrets-manager')
+     * @returns The validated configuration
+     * @throws ValidationError with enhanced context
+     */
+    static validateConfiguration<T extends ZodType>(schema: T, value: unknown, source: string): TypeOf<T>;
+}
+//# sourceMappingURL=validation.util.d.ts.map

package/dist/types/utils/validation.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.util.d.ts","sourceRoot":"","sources":["../../../src/utils/validation.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE;;;GAGG;AACH,qBAAa,oBAAoB;IAC/B;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,OAAO,EAC/B,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAAC,CAAC,CAAC;IAaZ;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,CAAC,SAAS,OAAO,EACnC,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,OAAO,GACb;QAAE,OAAO,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;KAAE,GAAG;QAAE,OAAO,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,eAAe,CAAA;KAAE;IAalF;;;;OAIG;IACH,MAAM,CAAC,sBAAsB,CAAC,KAAK,EAAE,QAAQ,GAAG,GAAG;IA4BnD;;;;;OAKG;IACH,MAAM,CAAC,0BAA0B,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IAmB5E;;;;;;;OAOG;IACH,MAAM,CAAC,qBAAqB,CAAC,CAAC,SAAS,OAAO,EAC5C,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,MAAM,GACb,MAAM,CAAC,CAAC,CAAC;CAYb"}