@itgorillaz/configify 3.0.0-alpha.0 → 3.0.0-alpha.2

package/index.d.ts

@@ -1 +1,3 @@
-export * from './dist';
+export * from './configify.module';
+export * from './configuration';
+export * from './decorators';

package/index.js

@@ -1,6 +1,20 @@
-'use strict';
-function __export(m) {
-    for (var p in m) if (!exports.hasOwnProperty(p)) exports[p] = m[p];
-}
-exports.__esModule = true;
-__export(require("./dist"));
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./configify.module"), exports);
+__exportStar(require("./configuration"), exports);
+__exportStar(require("./decorators"), exports);
+//# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itgorillaz/configify",
-  "version": "3.0.0-alpha.0",
+  "version": "3.0.0-alpha.2",
   "description": "NestJS Config on Steroids",
   "author": "tommelo",
   "private": false,

package/.prettierrc

@@ -1,4 +0,0 @@
-{
-  "singleQuote": true,
-  "trailingComma": "all"
-}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2024 ITGorillaz
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/README.md

@@ -1,319 +0,0 @@
-<p align="center">
-  <a href="http://nestjs.com/" target="blank"><img src="https://nestjs.com/img/logo-small.svg" width="200" alt="Nest Logo" /></a>
-</p>
-
-<p align="center"><b>@itgorillaz/configify</b></p>
-<p align="center">NestJS config on steroids</p>
-
-<p align="center">
-  <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** is a NestJS configuration module that makes it easier to deal with configuration files and secrets.
-
-## Installation
-
-```bash
-$ 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:
-
-```js
-@Module({
-  imports: [ConfigifyModule.forRootAsync()],
-  controllers: [AppController],
-  providers: [AppService],
-})
-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.
-
-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:
-
-```
-my-web-app
-| .env
-| application.yml
-| application.json
-```
-
-You can also provide the location of the configuration files by overriding the configuration 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.
-
-Example of a `.env` file mapped to a class:
-
-```
-APPLICATION_CLIENT_ID=ABC
-APPLICATION_CLIENT_TOKEN=TEST
-```
-
-```js
-@Configuration()
-export class ApplicationClientConfig {
-  @Value('APPLICATION_CLIENT_ID')
-  appClientId: string;
-
-  @Value('APPLICATION_CLIENT_TOKEN')
-  appClientToken: string
-}
-```
-
-Example of a `.yml` file mapped to a class:
-
-```
-database:
-  host: localhost
-  port: 3306
-  username: test
-  password: test
-  metadata: |
-    {
-      "label": "staging"
-    }
-```
-
-```js
-@Configuration()
-export class DatabaseConfiguration {
-  @Value('database.host')
-  host: string;
-
-  @Value('database.port', {
-    parse: parseInt
-  })
-  port: number;
-
-  @Value('database.metadata', {
-    parse: JSON.parse
-  })
-  metadata: MetadataType;
-}
-```
-
-You can map your configuration file to multiple configuration classes:
-
-```
-# database config
-DATABASE_HOST=localhost
-DATABASE_USER=test
-DATABASE_PASSWORD=test
-
-# okta config
-OKTA_API_TOKEN=test
-OKTA_CLIENT_ID=test
-```
-
-```js
-@Configuration()
-export class DatabaseConfiguration {
-  // database configuration attributes
-}
-```
-
-```js
-@Configuration()
-export class OktaConfiguration {
-  // okta configuration attributes
-}
-```
-
-### Dependency 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:
-
-```js
-export class AppService {
-  private readonly LOGGER = new Logger(AppService.name);
-
-  constructor(private readonly config: MyConfig) {
-    this.LOGGER.log(JSON.stringify(config));
-  }
-
-}
-```
-
-### Variables Expansion
-
-You can make use of variable expansion in your configuration files:
-
-```
-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
-
-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:
-
-```js
-@Configuration()
-export class DatabaseConfiguration {
-  @Value('DB_HOST', { default: 'localhost' })
-  host: string;
-
-  @Value('DB_PORT', {
-    parse: parseInt,
-    default: 3306
-  })
-  port: number;
-}
-```
-
-### Dealing with Secrets
-
-Out of the box, this module can resolve AWS Secrets Manager and Parameter Store secrets. For that, just need to choose which strategies you would like to use to resolve AWS secrets:
-
-```js
-// use default aws client instances
-ConfigifyModule.forRootAsync({
-  secretsResolverStrategies: [
-    AwsSecretsResolverFactory.defaultParameterStoreResolver(),
-    AwsSecretsResolverFactory.defaultSecretsManagerResolver(),
-   ],
-});
-
-// or provide your own aws client instances
-ConfigifyModule.forRootAsync({
-  secretsResolverStrategies: [
-    new AwsParameterStoreConfigurationResolver(new SSMClient())
-    new AwsSecretsManagerConfigurationResolver(
-      new SecretsManagerClient(),
-    ),
-   ],
-});
-```
-
-Every configuration attribute stating with `AWS_SECRETS_MANAGER`, `AWS_PARAMETER_STORE`, `aws-secrets-manager` and `aws-parameter-store` will be considered a special configuration attribute and the module will try to resolve it's remote value.
-
-E.g.: `.env`
-
-```
-MY_DB_PASSWORD=${AWS_SECRETS_MANAGER_DB_PASSWORD}
-MY_API_TOKEN=${AWS_PARAMETER_STORE_API_TOKEN}
-
-AWS_SECRETS_MANAGER_DB_PASSWORD=<secret-id-here>
-AWS_PARAMETER_STORE_API_TOKEN=<parameter-name-here>
-```
-
-`application.yml`
-
-```yaml
-my-db-password: ${aws-secrets-manager.db.password}
-my-api-token: ${aws-parameter-store.api.token}
-
-aws-secrets-manager:
-  db:
-    password: <secret-id-here>
-
-aws-parameter-store:
-  api:
-    token: <parameter-name-here>
-```
-
-```js
-@Configuration()
-export class SecretConfiguration {
-  @Value('my-db-password') // or @Value('aws-secrets-manager.db.password')
-  myDbPassword: string;
-
-  @Value('my-api-token') // or @Value('aws-parameter-store.api.token')
-  myApiToken: string;
-}
-```
-
-### Parsing Configuration Values
-
-Parsing a configuration value can be easily done by using a parse callback function available as argument of the `@Value()` decorator:
-
-```yaml
-db-json-config: |
-  {
-    "host": "localhost",
-    "user": "test",
-    "password": "test"
-  }
-```
-
-```js
-export interface MyDBConfig {
-  host: string;
-  user: string;
-  password: string;
-}
-
-@Configuration()
-export class SuperSecretConfiguration {
-  @Value('db-json-config', {
-    parse: JSON.parse
-  })
-  myDbConfig: MyDBConfig;
-}
-```
-
-### Validating Configuration Classes
-
-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:
-
-```js
-@Configuration()
-export class MyConfiguration {
-  @IsEmail()
-  @Value('SENDER_EMAIL')
-  senderEmail: string;
-
-  @IsNotEmpty()
-  @Value('my-api-token')
-  myApiToken: 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[];
-```
-
-## License
-
-This code is licensed under the [MIT License](./LICENSE.txt).
-
-All files located in the node_modules and external directories are externally maintained libraries used by this software which have their own licenses; we recommend you read them, as their terms may differ from the terms in the MIT License.

package/dist/index.d.ts

@@ -1,3 +0,0 @@
-export * from './configify.module';
-export * from './configuration';
-export * from './decorators';

package/dist/index.js

@@ -1,20 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./configify.module"), exports);
-__exportStar(require("./configuration"), exports);
-__exportStar(require("./decorators"), exports);
-//# sourceMappingURL=index.js.map

package/index.ts

@@ -1 +0,0 @@
-export * from './dist';

package/nest-cli.json

@@ -1,8 +0,0 @@
-{
-  "$schema": "https://json.schemastore.org/nest-cli",
-  "collection": "@nestjs/schematics",
-  "sourceRoot": "src",
-  "compilerOptions": {
-    "deleteOutDir": true
-  }
-}

package/src/configify.module.ts

@@ -1,223 +0,0 @@
-import { DynamicModule, Module, Provider } from '@nestjs/common';
-import { validateSync } from 'class-validator';
-import * as fs from 'fs';
-import { resolve } from 'path';
-import {
-  ConfigifyModuleOptions,
-  ConfigurationParserFactory,
-  ConfigurationProviders,
-  ConfigurationRegistry,
-  DefaultConfigifyModuleOptions,
-} from './configuration';
-import { Variables } from './interpolation/variables';
-
-/**
- * The configify module.
- * A NestJS configuration module on steroids.
- *
- * This module provides out of the box configuration files parsing,
- * remote secrets fetching, variables expansion and configuration validation.
- *
- * The lifecycle of the module consists of:
- * - Reading configuration files
- * - Resolving remote secrets
- * - Expanding variables
- * - Creating object instances decorated with Configuration and assigning its values
- * - Validating the configuration instance
- *
- * All the configuration set to the configuration files will be assigned to the process.env object
- */
-@Module({})
-export class ConfigifyModule {
-  /**
-   * The default configuration files.
-   * If no configuration files are provided this module will
-   * lookup at a .env, application.yml and an application.json files
-   * at the root path of the project.
-   */
-  private static readonly DEFAULT_CONFIG_FILES = [
-    resolve(process.cwd(), '.env'),
-    resolve(process.cwd(), 'application.yml'),
-    resolve(process.cwd(), 'application.json'),
-  ];
-
-  /**
-   * Creates the configfy dynamic module.
-   *
-   * The module will manage the instance of all classes decorated the Configuration decorator,
-   * meaning, the module will create the instance and associate the value to attributes according to the
-   * keys provided by the Value decorator.
-   *
-   * The configuration key pair values will also be available on process.env object.
-   *
-   * @param   { ConfigifyModuleOptions } options The module config options
-   * @returns { DynamicModule }         module  The configy module
-   */
-  static async forRootAsync(
-    options: ConfigifyModuleOptions = {},
-  ): Promise<DynamicModule> {
-    const settings = { ...options, ...DefaultConfigifyModuleOptions };
-    const files = this.resolveConfigurationFiles(settings.configFilePath);
-
-    const envVars = settings.ignoreEnvVars ? {} : process.env;
-    const fromFile = settings.ignoreConfigFile
-      ? {}
-      : this.parseConfigurationFiles(files);
-
-    const container = { ...envVars, ...fromFile };
-    const secrets = await this.runSecretsResolverPipeline(container, settings);
-    const configuration = { ...container, ...secrets };
-
-    if (settings.expandConfig) {
-      const expanded = Variables.expand(configuration);
-      Object.assign(configuration, expanded);
-    }
-
-    Object.assign(process.env, configuration);
-
-    const { exports, providers } = this.buildConfigurationProviders();
-
-    return {
-      exports,
-      providers,
-      global: true,
-      module: ConfigifyModule,
-    };
-  }
-
-  /**
-   * Runs the secrets resolver pipeline.
-   *
-   * @param   {Record<string, any>}            config the configuration object
-   * @param   {ConfigifyModuleOptions}          options the module options
-   * @returns {Promise<Record<string, any>>}   the resolved secrets
-   */
-  private static async runSecretsResolverPipeline(
-    config: Record<string, any>,
-    options: ConfigifyModuleOptions,
-  ): Promise<Record<string, any>> {
-    const secrets = {};
-    if (options.secretsResolverStrategies?.length) {
-      for (const resolver of options.secretsResolverStrategies) {
-        const result = await resolver.resolve(config);
-        Object.assign(secrets, result);
-      }
-    }
-    return secrets;
-  }
-
-  /**
-   * Creates the configuration module providers.
-   * It creates the configuration instances, assign its value
-   * and perform the object validation.
-   *
-   * @returns {ConfigurationProviders} the module configuration providers
-   */
-  private static buildConfigurationProviders(): ConfigurationProviders {
-    const exports: unknown[] = [];
-    const providers: Provider[] = [];
-
-    const registry = ConfigurationRegistry.getRegistry();
-    for (const ConfigType of registry) {
-      const instance = new ConfigType();
-
-      const attributes =
-        ConfigurationRegistry.getValueDecoratedAttributes(instance);
-
-      for (const attribute of attributes) {
-        const metadata = ConfigurationRegistry.getValueDecoratedKey(
-          instance,
-          attribute,
-        );
-
-        const parse = metadata.options?.parse;
-
-        const defaultValue =
-          process.env[metadata.key] || metadata.options?.default;
-
-        const value = parse ? parse(defaultValue) : defaultValue;
-
-        instance[attribute] = value;
-      }
-
-      const errors = validateSync(instance);
-      if (errors && errors.length) {
-        throw new Error(
-          `validation constraints violated:\n${errors
-            .map((e) =>
-              JSON.stringify(
-                { attribute: e.property, constraints: e.constraints },
-                null,
-                2,
-              ),
-            )
-            .join('\n')}`,
-        );
-      }
-
-      exports.push(ConfigType);
-      providers.push({ provide: ConfigType, useValue: instance });
-    }
-
-    return { exports, providers };
-  }
-
-  /**
-   * Flattens a nested object into an one level key value pair object
-   *
-   * @param {object}              source the source object
-   * @param {string[]}            path   the key path
-   * @param {Record<string, any>} target the target object
-   */
-  private static flattenObjectKeys(
-    source: any,
-    path: string[] = [],
-    target: Record<string, any> = {},
-  ) {
-    if (typeof source === 'object') {
-      for (const key in source) {
-        this.flattenObjectKeys(source[key], [...path, key], target);
-      }
-    } else {
-      target[path.join('.')] = source;
-    }
-  }
-
-  /**
-   * Parses configuration files and assign its contents to a configuration object.
-   *
-   * @param   {string[]} files  the configuration file paths
-   * @returns {object}          the object representation of the configuration files
-   */
-  private static parseConfigurationFiles(files: string[]): Record<string, any> {
-    const kv = {};
-    const config = {};
-
-    for (const file of files) {
-      const parser = ConfigurationParserFactory.getParser(file);
-      const parsed = parser.parse(file);
-      Object.assign(config, parsed);
-    }
-
-    this.flattenObjectKeys(config, [], kv);
-
-    return kv;
-  }
-
-  /**
-   * Resolve the path of the configuration files.
-   * It ignores files that does not exist or is not
-   * suppported by the configuration parsers.
-   *
-   * @param   {string | string[]} path  the configuration path
-   * @returns {string[]}                list of configuration files
-   */
-  private static resolveConfigurationFiles(path?: string | string[]): string[] {
-    return ([] as string[])
-      .concat(path || [], this.DEFAULT_CONFIG_FILES)
-      .filter(
-        (file) =>
-          fs.existsSync(file) && ConfigurationParserFactory.supports(file),
-      );
-  }
-}

package/src/configuration/configuration-options.interface.ts

@@ -1,43 +0,0 @@
-import { ConfigurationResolver } from './resolvers';
-
-/**
- * The configuration options interface
- */
-export interface ConfigifyModuleOptions {
-  /**
-   * 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[];
-}
-
-/**
- * The default module options
- */
-export const DefaultConfigifyModuleOptions: ConfigifyModuleOptions = {
-  ignoreConfigFile: false,
-  ignoreEnvVars: false,
-  expandConfig: true,
-};