@itgorillaz/configify 1.1.0

package/.prettierrc

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

package/LICENSE

@@ -0,0 +1,21 @@
+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

@@ -0,0 +1,281 @@
+<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>
+  
+## 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 {}
+```
+
+By default, when bootstraping, the module will lookup for a `.env` or an `application.yml` file at the root folder of the project:
+
+```
+my-web-app
+| .env
+| application.yml
+```
+
+You can also provide the location of the configuration files by overring 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: (value: any) => parseInt(value)
+  })
+  port: number;
+
+  @Value('database.metadata', {
+    parse: (value: any) => JSON.parse(value)
+  })
+  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 expasion 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
+```
+
+### Dealing with Secrets
+
+Out of the box, this module can resolve AWS Secrets Manager and Parameter Store secrets.
+
+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: (value: any) => JSON.parse(value)
+  })
+  myDbConfig: MyDBConfig;
+}
+```
+
+### Validating Configuration Classes
+
+Depending on how critical a configuration is, you may want to validate it before bootstraping 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 otions by providing an object as argumento 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 AWS Secrets Manager Client
+* If no client is provided, the module will create one.
+*/
+secretsManagerClient?: SecretsManagerClient;
+
+/**
+* The AWS Systems Manager Client
+* If no client is provided, the module will create one.
+*/
+ssmClient?: SSMClient;
+```
+
+## 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

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

package/dist/index.js

@@ -0,0 +1,18 @@
+"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("./src"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wCAAsB"}

package/dist/src/configify.module.d.ts

@@ -0,0 +1,12 @@
+import { DynamicModule } from '@nestjs/common';
+import { ConfigfyModuleOptions } from './configuration';
+export declare class ConfigifyModule {
+    private static readonly DEFAULT_CONFIG_FILES;
+    private static readonly SECRETS_RESOLVER_PIPELINE;
+    static forRootAsync(options?: ConfigfyModuleOptions): Promise<DynamicModule>;
+    private static runSecretsResolverPipeline;
+    private static buildConfigurationProviders;
+    private static flattenObjectKeys;
+    private static parseConfigurationFiles;
+    private static resolveConfigurationFiles;
+}

package/dist/src/configify.module.js

@@ -0,0 +1,120 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var ConfigifyModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigifyModule = void 0;
+const client_secrets_manager_1 = require("@aws-sdk/client-secrets-manager");
+const client_ssm_1 = require("@aws-sdk/client-ssm");
+const common_1 = require("@nestjs/common");
+const class_validator_1 = require("class-validator");
+const fs = require("fs");
+const path_1 = require("path");
+const configuration_1 = require("./configuration");
+const parameter_store_configuration_resolver_1 = require("./configuration/resolvers/aws/parameter-store-configuration.resolver");
+const variables_1 = require("./interpolation/variables");
+let ConfigifyModule = ConfigifyModule_1 = class ConfigifyModule {
+    static async forRootAsync(options = {}) {
+        const settings = Object.assign(Object.assign({}, options), configuration_1.DefaultConfigfyModuleOptions);
+        const files = this.resolveConfigurationFiles(settings.configFilePath);
+        const envVars = settings.ignoreEnvVars ? {} : process.env;
+        const fromFile = settings.ignoreConfigFile
+            ? {}
+            : this.parseConfigurationFiles(files);
+        const container = Object.assign(Object.assign({}, envVars), fromFile);
+        const secrets = await this.runSecretsResolverPipeline(container, settings);
+        const configuration = Object.assign(Object.assign({}, container), secrets);
+        if (settings.expandConfig) {
+            const expanded = variables_1.Variables.expand(configuration);
+            Object.assign(configuration, expanded);
+        }
+        Object.assign(process.env, configuration);
+        const { exports, providers } = this.buildConfigurationProviders();
+        return {
+            exports,
+            providers,
+            global: true,
+            module: ConfigifyModule_1,
+        };
+    }
+    static async runSecretsResolverPipeline(config, options) {
+        const secrets = {};
+        for (const buildResolver of this.SECRETS_RESOLVER_PIPELINE) {
+            const resolver = buildResolver(options);
+            const result = await resolver.resolve(config);
+            Object.assign(secrets, result);
+        }
+        return secrets;
+    }
+    static buildConfigurationProviders() {
+        var _a;
+        const exports = [];
+        const providers = [];
+        const registry = configuration_1.ConfigurationRegistry.getRegistry();
+        for (const ConfigType of registry) {
+            const instance = new ConfigType();
+            const attributes = configuration_1.ConfigurationRegistry.getValueDecoratedAttributes(instance);
+            for (const attribute of attributes) {
+                const metadata = configuration_1.ConfigurationRegistry.getValueDecoratedKey(instance, attribute);
+                const parse = (_a = metadata.options) === null || _a === void 0 ? void 0 : _a.parse;
+                const value = parse
+                    ? parse(process.env[metadata.key])
+                    : process.env[metadata.key];
+                instance[attribute] = value;
+            }
+            const errors = (0, class_validator_1.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 };
+    }
+    static flattenObjectKeys(source, path = [], target = {}) {
+        if (typeof source === 'object') {
+            for (const key in source) {
+                this.flattenObjectKeys(source[key], [...path, key], target);
+            }
+        }
+        else {
+            target[path.join('.')] = source;
+        }
+    }
+    static parseConfigurationFiles(files) {
+        const kv = {};
+        const config = {};
+        for (const file of files) {
+            const parser = configuration_1.ConfigurationParserFactory.getParser(file);
+            const parsed = parser.parse(file);
+            Object.assign(config, parsed);
+        }
+        this.flattenObjectKeys(config, [], kv);
+        return kv;
+    }
+    static resolveConfigurationFiles(path) {
+        return []
+            .concat(path, this.DEFAULT_CONFIG_FILES)
+            .filter((file) => fs.existsSync(file) && configuration_1.ConfigurationParserFactory.supports(file));
+    }
+};
+exports.ConfigifyModule = ConfigifyModule;
+ConfigifyModule.DEFAULT_CONFIG_FILES = [
+    (0, path_1.resolve)(process.cwd(), '.env'),
+    (0, path_1.resolve)(process.cwd(), 'application.yml'),
+    (0, path_1.resolve)(process.cwd(), 'application.json'),
+];
+ConfigifyModule.SECRETS_RESOLVER_PIPELINE = [
+    (options) => new configuration_1.AwsSecretsManagerConfigurationResolver(options.secretsManagerClient || new client_secrets_manager_1.SecretsManagerClient()),
+    (options) => new parameter_store_configuration_resolver_1.AwsParameterStoreConfigurationResolver(options.ssmClient || new client_ssm_1.SSMClient()),
+];
+exports.ConfigifyModule = ConfigifyModule = ConfigifyModule_1 = __decorate([
+    (0, common_1.Module)({})
+], ConfigifyModule);
+//# sourceMappingURL=configify.module.js.map

package/dist/src/configify.module.js.map

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

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

@@ -0,0 +1,11 @@
+import { SecretsManagerClient } from '@aws-sdk/client-secrets-manager';
+import { SSMClient } from '@aws-sdk/client-ssm';
+export interface ConfigfyModuleOptions {
+    ignoreConfigFile?: boolean;
+    ignoreEnvVars?: boolean;
+    configFilePath?: string | string[];
+    expandConfig?: boolean;
+    secretsManagerClient?: SecretsManagerClient;
+    ssmClient?: SSMClient;
+}
+export declare const DefaultConfigfyModuleOptions: ConfigfyModuleOptions;

package/dist/src/configuration/configuration-options.interface.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultConfigfyModuleOptions = void 0;
+exports.DefaultConfigfyModuleOptions = {
+    ignoreConfigFile: false,
+    ignoreEnvVars: false,
+    expandConfig: true,
+};
+//# sourceMappingURL=configuration-options.interface.js.map

package/dist/src/configuration/configuration-options.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration-options.interface.js","sourceRoot":"","sources":["../../../src/configuration/configuration-options.interface.ts"],"names":[],"mappings":";;;AA8Ca,QAAA,4BAA4B,GAA0B;IACjE,gBAAgB,EAAE,KAAK;IACvB,aAAa,EAAE,KAAK;IACpB,YAAY,EAAE,IAAI;CACnB,CAAC"}

package/dist/src/configuration/configuration-parser.interface.d.ts

@@ -0,0 +1,3 @@
+export interface ConfigurationParser {
+    parse(file: string): Record<string, any>;
+}

package/dist/src/configuration/configuration-parser.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=configuration-parser.interface.js.map

package/dist/src/configuration/configuration-parser.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration-parser.interface.js","sourceRoot":"","sources":["../../../src/configuration/configuration-parser.interface.ts"],"names":[],"mappings":""}

package/dist/src/configuration/configuration-providers.interface.d.ts

@@ -0,0 +1,5 @@
+import { Provider } from '@nestjs/common';
+export interface ConfigurationProviders {
+    exports: any[];
+    providers: Provider[];
+}

package/dist/src/configuration/configuration-providers.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=configuration-providers.interface.js.map

package/dist/src/configuration/configuration-providers.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration-providers.interface.js","sourceRoot":"","sources":["../../../src/configuration/configuration-providers.interface.ts"],"names":[],"mappings":""}

package/dist/src/configuration/configuration.registry.d.ts

@@ -0,0 +1,9 @@
+import { ValueDecoratedKey } from '../decorators';
+export declare class ConfigurationRegistry {
+    private static readonly registry;
+    static registerTarget(type: any): void;
+    static registerAttribute(target: any, attribute: string): void;
+    static getRegistry(): any[];
+    static getValueDecoratedAttributes(target: any): string[];
+    static getValueDecoratedKey(instance: any, attribute: string): ValueDecoratedKey;
+}

package/dist/src/configuration/configuration.registry.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigurationRegistry = void 0;
+const decorators_1 = require("../decorators");
+class ConfigurationRegistry {
+    static registerTarget(type) {
+        this.registry.push(type);
+    }
+    static registerAttribute(target, attribute) {
+        (target[decorators_1.VALUE_PROPERTIES_METADATA] ||
+            (target[decorators_1.VALUE_PROPERTIES_METADATA] = [])).push(attribute);
+    }
+    static getRegistry() {
+        return this.registry;
+    }
+    static getValueDecoratedAttributes(target) {
+        return target[decorators_1.VALUE_PROPERTIES_METADATA];
+    }
+    static getValueDecoratedKey(instance, attribute) {
+        return Reflect.getMetadata(decorators_1.VALUE_METADATA, instance, attribute);
+    }
+}
+exports.ConfigurationRegistry = ConfigurationRegistry;
+ConfigurationRegistry.registry = [];
+//# sourceMappingURL=configuration.registry.js.map

package/dist/src/configuration/configuration.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.registry.js","sourceRoot":"","sources":["../../../src/configuration/configuration.registry.ts"],"names":[],"mappings":";;;AAAA,8CAIuB;AAQvB,MAAa,qBAAqB;IAQhC,MAAM,CAAC,cAAc,CAAC,IAAS;QAC7B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAQD,MAAM,CAAC,iBAAiB,CAAC,MAAW,EAAE,SAAiB;QACrD,CACE,MAAM,CAAC,sCAAyB,CAAC;YACjC,CAAC,MAAM,CAAC,sCAAyB,CAAC,GAAG,EAAE,CAAC,CACzC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACpB,CAAC;IAOD,MAAM,CAAC,WAAW;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAQD,MAAM,CAAC,2BAA2B,CAAC,MAAW;QAC5C,OAAO,MAAM,CAAC,sCAAyB,CAAC,CAAC;IAC3C,CAAC;IASD,MAAM,CAAC,oBAAoB,CACzB,QAAa,EACb,SAAiB;QAEjB,OAAO,OAAO,CAAC,WAAW,CAAC,2BAAc,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IAClE,CAAC;;AAxDH,sDAyDC;AAxDyB,8BAAQ,GAAG,EAAE,CAAC"}

package/dist/src/configuration/index.d.ts

@@ -0,0 +1,6 @@
+export * from './configuration-options.interface';
+export * from './configuration-parser.interface';
+export * from './configuration-providers.interface';
+export * from './configuration.registry';
+export * from './parsers';
+export * from './resolvers';

package/dist/src/configuration/index.js

@@ -0,0 +1,23 @@
+"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("./configuration-options.interface"), exports);
+__exportStar(require("./configuration-parser.interface"), exports);
+__exportStar(require("./configuration-providers.interface"), exports);
+__exportStar(require("./configuration.registry"), exports);
+__exportStar(require("./parsers"), exports);
+__exportStar(require("./resolvers"), exports);
+//# sourceMappingURL=index.js.map

package/dist/src/configuration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/configuration/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oEAAkD;AAClD,mEAAiD;AACjD,sEAAoD;AACpD,2DAAyC;AACzC,4CAA0B;AAC1B,8CAA4B"}

package/dist/src/configuration/parsers/configuration-parser.factory.d.ts

@@ -0,0 +1,7 @@
+import { ConfigurationParser } from '../configuration-parser.interface';
+export declare class ConfigurationParserFactory {
+    private static readonly parsers;
+    static getParser(file: string): ConfigurationParser;
+    static supports(file: string): boolean;
+    private static getFileExt;
+}

package/dist/src/configuration/parsers/configuration-parser.factory.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigurationParserFactory = void 0;
+const dotenv_configuration_parser_1 = require("./dotenv-configuration.parser");
+const json_configuration_parser_1 = require("./json-configuration.parser");
+const yaml_configuration_parser_1 = require("./yaml-configuration.parser");
+class ConfigurationParserFactory {
+    static getParser(file) {
+        const ext = this.getFileExt(file);
+        return this.parsers[ext];
+    }
+    static supports(file) {
+        const ext = this.getFileExt(file);
+        return this.parsers.hasOwnProperty(ext);
+    }
+    static getFileExt(file) {
+        return file.split('.').pop();
+    }
+}
+exports.ConfigurationParserFactory = ConfigurationParserFactory;
+ConfigurationParserFactory.parsers = {
+    env: new dotenv_configuration_parser_1.DotEnvConfigurationParser(),
+    yml: new yaml_configuration_parser_1.YamlConfigurationParser(),
+    yaml: new yaml_configuration_parser_1.YamlConfigurationParser(),
+    json: new json_configuration_parser_1.JsonConfigurationParser(),
+};
+//# sourceMappingURL=configuration-parser.factory.js.map

package/dist/src/configuration/parsers/configuration-parser.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration-parser.factory.js","sourceRoot":"","sources":["../../../../src/configuration/parsers/configuration-parser.factory.ts"],"names":[],"mappings":";;;AACA,+EAA0E;AAC1E,2EAAsE;AACtE,2EAAsE;AAOtE,MAAa,0BAA0B;IAiBrC,MAAM,CAAC,SAAS,CAAC,IAAY;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAQD,MAAM,CAAC,QAAQ,CAAC,IAAY;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IAC1C,CAAC;IAQO,MAAM,CAAC,UAAU,CAAC,IAAY;QACpC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;IAC/B,CAAC;;AAzCH,gEA0CC;AAtCyB,kCAAO,GAAG;IAChC,GAAG,EAAE,IAAI,uDAAyB,EAAE;IACpC,GAAG,EAAE,IAAI,mDAAuB,EAAE;IAClC,IAAI,EAAE,IAAI,mDAAuB,EAAE;IACnC,IAAI,EAAE,IAAI,mDAAuB,EAAE;CACpC,CAAC"}

package/dist/src/configuration/parsers/dotenv-configuration.parser.d.ts

@@ -0,0 +1,4 @@
+import { ConfigurationParser } from '../configuration-parser.interface';
+export declare class DotEnvConfigurationParser implements ConfigurationParser {
+    parse(file: string): Record<string, any>;
+}