@itgorillaz/configify 4.0.2 → 4.1.0

package/README.md

@@ -9,21 +9,25 @@
   <a href="https://buymeacoffee.com/tommelo" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/default-orange.png" alt="Buy Me A Coffee" height="41" width="174"></a>
 </p>
 
-## Description
+# configify
 
-**configify** is a NestJS configuration module that makes it easier to deal with configuration files and secrets.
+**configify** is a NestJS configuration module that simplifies loading, validating, and injecting configuration from environment variables, config files, and remote secret managers.
 
 ## Installation
 
 ```bash
-$ npm install --save @itgorillaz/configify
+npm install --save @itgorillaz/configify
 ```
 
-## Usage
+---
 
-To start using the <b>configify</b> module in your application import the module by calling the `forRootAsync` function:
+## Quick Start
+
+Import `ConfigifyModule` into your root module using `forRootAsync()`:
+
+```typescript
+import { ConfigifyModule } from '@itgorillaz/configify';
 
-```js
 @Module({
   imports: [ConfigifyModule.forRootAsync()],
   controllers: [AppController],
@@ -32,44 +36,63 @@ To start using the <b>configify</b> module in your application import the module
 export class AppModule {}
 ```
 
-**Important Note**: When working with strict mode enabled `"strict": true`(tsconfig.json) it's necessary to set the option `strictPropertyInitialization` to `false` since the module will initialize the configuration class properties during runtime after resolving the values of the environment variables.
+> **TypeScript strict mode:** If you have `"strict": true` in your `tsconfig.json` and you are not using [constructor configuration injection](#mapping-configuration-classes-with-constructor-injection), you must also set `"strictPropertyInitialization": false`. This is required because configify initializes configuration properties at runtime.
+>
+> ```json
+> {
+>   "compilerOptions": {
+>     "strict": true,
+>     "strictPropertyInitialization": false
+>   }
+> }
+> ```
+
+---
 
-By default, when bootstraping, the module will lookup for a `.env`, an `application.yml` and an `application.json` file at the root folder of the project:
+## Configuration File Discovery
+
+By default, configify looks for the following files in the **root of your project**:
 
 ```
-my-web-app
-| .env
-| application.yml
-| application.json
+my-app/
+├── .env
+├── application.yml
+└── application.json
 ```
 
-You can also provide the location of the configuration files by overriding the configuration options.
+All three formats are supported and can be used together. You can also [customize the file paths](#overriding-default-options).
 
-### Mapping Configuration Classes
+---
 
-This module will lookup for every class decorated with `@Configuration` and it will make its instance globally available for the application.
+## Mapping Configuration Classes
 
-Example of a `.env` file mapped to a class:
+Decorate any class with `@Configuration()` and configify will automatically discover it, populate its properties, and make the instance available for dependency injection throughout your application.
 
-```
+### From a `.env` file
+
+```bash
+# .env
 APPLICATION_CLIENT_ID=ABC
 APPLICATION_CLIENT_TOKEN=TEST
 ```
 
-```js
+```typescript
+import { Configuration, Value } from '@itgorillaz/configify';
+
 @Configuration()
 export class ApplicationClientConfig {
   @Value('APPLICATION_CLIENT_ID')
   appClientId: string;
 
   @Value('APPLICATION_CLIENT_TOKEN')
-  appClientToken: string
+  appClientToken: string;
 }
 ```
 
-Example of a `.yml` file mapped to a class:
+### From a `.yml` file
 
-```
+```yaml
+# application.yml
 database:
   host: localhost
   port: 3306
@@ -81,112 +104,164 @@ database:
     }
 ```
 
-```js
+```typescript
+import { Configuration, Value } from '@itgorillaz/configify';
+
+interface DatabaseMetadata {
+  label: string;
+}
+
 @Configuration()
 export class DatabaseConfiguration {
   @Value('database.host')
   host: string;
 
-  @Value('database.port', {
-    parse: parseInt
-  })
+  @Value('database.port', { parse: parseInt })
   port: number;
 
-  @Value('database.metadata', {
-    parse: JSON.parse
-  })
-  metadata: MetadataType;
+  @Value('database.metadata', { parse: JSON.parse })
+  metadata: DatabaseMetadata;
 }
 ```
 
-You can map your configuration file to multiple configuration classes:
+### Splitting one file into multiple configuration classes
 
-```
-# database config
+A single config file can be split across multiple configuration classes to keep concerns separated:
+
+```bash
+# .env
 DATABASE_HOST=localhost
 DATABASE_USER=test
 DATABASE_PASSWORD=test
 
-# okta config
 OKTA_API_TOKEN=test
 OKTA_CLIENT_ID=test
 ```
 
-```js
+```typescript
 @Configuration()
 export class DatabaseConfiguration {
-  // database configuration attributes
+  @Value('DATABASE_HOST')
+  host: string;
+
+  @Value('DATABASE_USER')
+  user: string;
+
+  @Value('DATABASE_PASSWORD')
+  password: string;
 }
-```
 
-```js
 @Configuration()
 export class OktaConfiguration {
-  // okta configuration attributes
+  @Value('OKTA_API_TOKEN')
+  apiToken: string;
+
+  @Value('OKTA_CLIENT_ID')
+  clientId: string;
 }
 ```
 
-### Dependency Injection
+### Mapping Configuration Classes with Constructor Injection
 
-This module makes all the configuration instances globally available to the application, to access it you just need to declare the configuration class as an argument in the class constructor:
+Decorate your configuration class with `@RequiredArgsConstructor()` and configify will automatically create the instance of the configuration class passing the configuration values as an object to the constructor.
 
-```js
-export class AppService {
-  private readonly LOGGER = new Logger(AppService.name);
+```bash
+# .env
+DATABASE_HOST=localhost
+DATABASE_USER=test
+DATABASE_PASSWORD=test
+```
 
-  constructor(private readonly config: MyConfig) {
-    this.LOGGER.log(JSON.stringify(config));
-  }
+```typescript
+@Configuration()
+@RequiredArgsConstructor()
+export class DatabaseConfiguration {
+  @Value('DATABASE_HOST')
+  host: string;
+
+  @Value('DATABASE_USER')
+  user: string;
 
+  @Value('DATABASE_PASSWORD')
+  password: string;
+
+  constructor(config: Required<DatabaseConfiguration>) {
+    this.host = config.host;
+    this.user = config.user;
+    this.password = config.password;
+  }
 }
 ```
 
-### Variables Expansion
+---
 
-You can make use of variable expansion in your configuration files:
+## Dependency Injection
 
+All `@Configuration()` classes are registered globally. Inject them into any provider via the constructor:
+
+```typescript
+import { Injectable, Logger } from '@nestjs/common';
+import { DatabaseConfiguration } from './database.configuration';
+
+@Injectable()
+export class AppService {
+  private readonly logger = new Logger(AppService.name);
+
+  constructor(private readonly dbConfig: DatabaseConfiguration) {
+    this.logger.log(
+      `Connecting to database at ${dbConfig.host}:${dbConfig.port}`,
+    );
+  }
+}
 ```
-MY_API_KEY=${MY_SECRET} // --> MY_API_KEY=TEST
-ANY_OTHER_CONFIG=TEST
-MY_SECRET=TEST
-APP_CLIENT_ID=${NON_EXISTING_ENV:-DEFAULT_ID} // --> APP_CLIENT_ID=DEFAULT_ID
-```
 
-### Defining Default Configuration Values
+---
+
+## Default Values
 
-Other than defining default values with variables expansion, you can also define a default value to an attribute using the `default` option provided by the `@Value()` decorator:
+You can provide fallback values in two ways:
 
-```js
+**Option 1 — Variable expansion syntax (in the config file):**
+
+```bash
+# .env
+APP_CLIENT_ID=${NON_EXISTING_VAR:-DEFAULT_ID}  # resolves to DEFAULT_ID
+```
+
+**Option 2 — `@Value()` decorator option:**
+
+```typescript
 @Configuration()
 export class DatabaseConfiguration {
   @Value('DB_HOST', { default: 'localhost' })
   host: string;
 
-  @Value('DB_PORT', {
-    parse: parseInt,
-    default: 3306
-  })
+  @Value('DB_PORT', { parse: parseInt, default: 3306 })
   port: number;
 }
 ```
 
-### Dealing with Secrets
+---
 
-Out of the box, this module can resolve secrets from:
+## Variable Expansion
 
-- AWS Secrets Manager and AWS Parameter Store
-- Azure Key Vault
-- Bitwarden Secrets Manager
-- Google Cloud Secret Manager
-- Custom Remote Configuration Resolver(your own implementation)
+configify supports variable expansion in config files, including cross-variable references and default fallbacks:
 
-Check the [examples](/examples/) and their documentation to learn how to use them.
+```bash
+# .env
+MY_SECRET=TEST
+MY_API_KEY=${MY_SECRET}              # resolves to: TEST
+APP_CLIENT_ID=${NON_EXISTING:-DEFAULT_ID}  # resolves to: DEFAULT_ID
+```
+
+---
 
-### Parsing Configuration Values
+## Parsing Configuration Values
 
-Parsing a configuration value can be easily done by using a parse callback function available as argument of the `@Value()` decorator:
+Use the `parse` option to transform raw string values into the types your application needs:
 
 ```yaml
+# application.yml
 db-json-config: |
   {
     "host": "localhost",
@@ -195,71 +270,99 @@ db-json-config: |
   }
 ```
 
-```js
-export interface MyDBConfig {
+```typescript
+interface DbConfig {
   host: string;
   user: string;
   password: string;
 }
 
 @Configuration()
-export class SuperSecretConfiguration {
-  @Value('db-json-config', {
-    parse: JSON.parse
-  })
-  myDbConfig: MyDBConfig;
+export class DatabaseConfiguration {
+  @Value('db-json-config', { parse: JSON.parse })
+  dbConfig: DbConfig;
 }
 ```
 
-### Validating Configuration Classes
+The `parse` option accepts any function with the signature `(value: string) => T`, so you can use built-ins like `parseInt`, `JSON.parse`, or your own custom parser.
+
+---
 
-Depending on how critical a configuration is, you may want to validate it before starting the application, for that you can use [class-validator](https://github.com/typestack/class-validator) to make sure your configuration is loaded correctly:
+## Validating Configuration
+
+Use [`class-validator`](https://github.com/typestack/class-validator) decorators alongside `@Value()` to validate configuration at startup — before your application begins serving requests:
+
+```bash
+npm install --save class-validator
+```
+
+```typescript
+import { IsEmail, IsNotEmpty, IsUrl } from 'class-validator';
+import { Configuration, Value } from '@itgorillaz/configify';
 
-```js
 @Configuration()
-export class MyConfiguration {
+export class NotificationConfiguration {
   @IsEmail()
   @Value('SENDER_EMAIL')
   senderEmail: string;
 
   @IsNotEmpty()
-  @Value('my-api-token')
-  myApiToken: string;
+  @Value('API_TOKEN')
+  apiToken: string;
+
+  @IsUrl()
+  @Value('WEBHOOK_URL')
+  webhookUrl: string;
 }
 ```
 
-### Overwrite Default Options
-
-You can overwrite default module options by providing an object as argument to the `forRootAsync()` method:
-
-```js
-/**
-* Ignores any config file.
-* The default value is false;
-*/
-ignoreConfigFile?: boolean;
-
-/**
-* Ignores environment variables
-* The default value is false;
-*/
-ignoreEnvVars?: boolean;
-
-/**
-* The path of the configuration files
-*/
-configFilePath?: string | string[];
-
-/**
-* Expands variables
-* The default value is true
-*/
-expandConfig?: boolean;
-
-/**
- * The secrets resolvers strategies
- */
-secretsResolverStrategies?: ConfigurationResolver[];
+If validation fails, the application will throw an error on startup with a clear message describing which values are missing or invalid.
+
+---
+
+## Secrets Management
+
+configify has built-in support for resolving secrets from external providers:
+
+| Provider                    | Notes                                      |
+| --------------------------- | ------------------------------------------ |
+| AWS Secrets Manager         |                                            |
+| AWS Parameter Store         |                                            |
+| Azure Key Vault             |                                            |
+| Bitwarden Secrets Manager   |                                            |
+| Google Cloud Secret Manager |                                            |
+| Custom resolver             | Implement your own `ConfigurationResolver` |
+
+See the [examples directory](/examples/) for provider-specific setup instructions.
+
+---
+
+## Overriding Default Options
+
+Pass an options object to `forRootAsync()` to customize module behavior:
+
+```typescript
+ConfigifyModule.forRootAsync({
+  // Ignore all config files (.env, application.yml, application.json)
+  // Default: false
+  ignoreConfigFile: false,
+
+  // Ignore environment variables
+  // Default: false
+  ignoreEnvVars: false,
+
+  // Path(s) to configuration files (overrides default discovery)
+  configFilePath: './config/app.yml',
+  // or multiple files:
+  // configFilePath: ['./config/database.yml', './config/app.env'],
+
+  // Enable/disable variable expansion
+  // Default: true
+  expandConfig: true,
+
+  // Custom secrets resolver strategies
+  secretsResolverStrategies: [],
+});
 ```
 
 ## License

package/configify.module.js

@@ -13,6 +13,7 @@ const class_validator_1 = require("class-validator");
 const fs = require("fs");
 const path_1 = require("path");
 const configuration_1 = require("./configuration");
+const decorators_1 = require("./decorators");
 const variables_1 = require("./interpolation/variables");
 let ConfigifyModule = ConfigifyModule_1 = class ConfigifyModule {
     static async forRootAsync(options = {}) {
@@ -55,15 +56,21 @@ let ConfigifyModule = ConfigifyModule_1 = class ConfigifyModule {
         const providers = [];
         const registry = configuration_1.ConfigurationRegistry.getRegistry();
         for (const ConfigType of registry) {
-            const instance = new ConfigType();
-            const attributes = configuration_1.ConfigurationRegistry.getValueDecoratedAttributes(instance);
+            const prototype = ConfigType.prototype;
+            const requiresArgsConstructor = !!Reflect.getMetadata(decorators_1.REQUIRED_ARGS_CONSTRUCTOR_METADATA, ConfigType);
+            const attributes = configuration_1.ConfigurationRegistry.getValueDecoratedAttributes(prototype);
+            const ctorArgs = {};
+            const target = requiresArgsConstructor ? ctorArgs : new ConfigType();
             for (const attribute of attributes) {
-                const metadata = configuration_1.ConfigurationRegistry.getValueDecoratedKey(instance, attribute);
+                const metadata = configuration_1.ConfigurationRegistry.getValueDecoratedKey(prototype, attribute);
                 const parse = (_a = metadata.options) === null || _a === void 0 ? void 0 : _a.parse;
                 const defaultValue = process.env[metadata.key] || ((_b = metadata.options) === null || _b === void 0 ? void 0 : _b.default);
                 const value = parse ? parse(defaultValue) : defaultValue;
-                instance[attribute] = value;
+                target[attribute] = value;
             }
+            const instance = requiresArgsConstructor
+                ? new ConfigType(target)
+                : target;
             const errors = (0, class_validator_1.validateSync)(instance, this.VALIDATION_OPTIONS);
             if (errors && errors.length) {
                 throw new Error(`validation constraints violated:\n${errors

package/configify.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"configify.module.js","sourceRoot":"","sources":["../src/configify.module.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"configify.module.js","sourceRoot":"","sources":["../src/configify.module.ts"],"names":[],"mappings":"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"}

package/decorators/index.d.ts

@@ -1,2 +1,3 @@
 export * from './configuration.decorator';
+export * from './required-args-constructor.decorator';
 export * from './value.decorator';

package/decorators/index.js

@@ -15,5 +15,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./configuration.decorator"), exports);
+__exportStar(require("./required-args-constructor.decorator"), exports);
 __exportStar(require("./value.decorator"), exports);
 //# sourceMappingURL=index.js.map

package/decorators/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4DAA0C;AAC1C,oDAAkC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4DAA0C;AAC1C,wEAAsD;AACtD,oDAAkC"}

package/decorators/required-args-constructor.decorator.d.ts

@@ -0,0 +1,2 @@
+export declare const REQUIRED_ARGS_CONSTRUCTOR_METADATA: unique symbol;
+export declare function RequiredArgsConstructor(): ClassDecorator;

package/decorators/required-args-constructor.decorator.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REQUIRED_ARGS_CONSTRUCTOR_METADATA = void 0;
+exports.RequiredArgsConstructor = RequiredArgsConstructor;
+exports.REQUIRED_ARGS_CONSTRUCTOR_METADATA = Symbol.for('REQUIRED_ARGS_CONSTRUCTOR_METADATA');
+function RequiredArgsConstructor() {
+    return (target) => {
+        Reflect.defineMetadata(exports.REQUIRED_ARGS_CONSTRUCTOR_METADATA, true, target);
+    };
+}
+//# sourceMappingURL=required-args-constructor.decorator.js.map

package/decorators/required-args-constructor.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"required-args-constructor.decorator.js","sourceRoot":"","sources":["../../src/decorators/required-args-constructor.decorator.ts"],"names":[],"mappings":";;;AAaA,0DAIC;AAbY,QAAA,kCAAkC,GAAG,MAAM,CAAC,GAAG,CAC1D,oCAAoC,CACrC,CAAC;AAOF,SAAgB,uBAAuB;IACrC,OAAO,CAAC,MAAc,EAAE,EAAE;QACxB,OAAO,CAAC,cAAc,CAAC,0CAAkC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC3E,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -20,8 +20,8 @@
     "@nestjs/testing": "^11.0.5",
     "@types/jest": "30.0.0",
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "24.10.1",
-    "@types/supertest": "^6.0.2",
+    "@types/node": "25.3.2",
+    "@types/supertest": "^7.2.0",
     "@typescript-eslint/eslint-plugin": "^8.1.0",
     "@typescript-eslint/parser": "^8.1.0",
     "eslint": "^8.0.0 || ^9.0.0",
@@ -82,5 +82,5 @@
     "lint": "eslint \"{src,apps,libs,test}/**/*.ts\" --fix",
     "test": "jest --config ./test/jest.config.json --coverage --silent=false --verbose --runInBand"
   },
-  "version": "4.0.2"
+  "version": "4.1.0"
 }