@adonisjs/env 4.2.0-6 → 4.2.0-8

package/build/{chunk-NSHYMAZE.js → chunk-H6UKLEIO.js}

@@ -93,3 +93,4 @@ export {
   debug_default,
   EnvLoader
 };
+//# sourceMappingURL=chunk-H6UKLEIO.js.map

package/build/chunk-H6UKLEIO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/loader.ts","../src/debug.ts"],"sourcesContent":["/*\n * @adonisjs/env\n *\n * (c) AdonisJS\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\nimport { fileURLToPath } from 'node:url'\nimport { readFile } from 'node:fs/promises'\nimport { isAbsolute, join } from 'node:path'\n\nimport debug from './debug.js'\n\n/**\n * Read the contents of one or more dot-env files. Following is how the files\n * are read.\n *\n * - Load file from the \"ENV_PATH\" environment file.\n *    (Raise error if file is missing)\n *\n * - If \"ENV_PATH\" is not defined, then find \".env\" file in the app root.\n *    (Ignore if file is missing)\n *\n * - Find \".env.[NODE_ENV]\" file in the app root.\n *    (Ignore if file is missing)\n *\n * ```ts\n * const loader = new EnvLoader(new URL('./', import.meta.url))\n *\n * const { envContents, currentEnvContents } = await loader.load()\n *\n * // envContents: Contents of .env or file specified via ENV_PATH\n * // currentEnvContents: Contents of .env.[NODE_ENV] file\n * ```\n */\nexport class EnvLoader {\n  #appRoot: string\n  #loadExampleFile: boolean\n\n  constructor(appRoot: string | URL, loadExampleFile: boolean = false) {\n    this.#appRoot = typeof appRoot === 'string' ? appRoot : fileURLToPath(appRoot)\n    this.#loadExampleFile = loadExampleFile\n  }\n\n  /**\n   * Optionally read a file from the disk\n   */\n  async #loadFile(filePath: string | URL): Promise<{ fileExists: boolean; contents: string }> {\n    try {\n      const contents = await readFile(filePath, 'utf-8')\n      return { contents, fileExists: true }\n    } catch (error) {\n      /* c8 ignore next 3 */\n      if (error.code !== 'ENOENT') {\n        throw error\n      }\n\n      return { contents: '', fileExists: false }\n    }\n  }\n\n  /**\n   * Load contents of the main dot-env file and the current\n   * environment dot-env file\n   */\n  async load(): Promise<{ contents: string; path: string; fileExists: boolean }[]> {\n    const ENV_PATH = process.env.ENV_PATH\n    const NODE_ENV = process.env.NODE_ENV\n    const envFiles: { path: string; contents: string; fileExists: boolean }[] = []\n\n    if (debug.enabled) {\n      debug('ENV_PATH variable is %s', ENV_PATH ? 'set' : 'not set')\n      debug('NODE_ENV variable is %s', NODE_ENV ? 'set' : 'not set')\n    }\n\n    /**\n     * Base path to load .env files from\n     */\n    const baseEnvPath = ENV_PATH\n      ? isAbsolute(ENV_PATH)\n        ? ENV_PATH\n        : join(this.#appRoot, ENV_PATH)\n      : this.#appRoot\n\n    if (debug.enabled) {\n      debug('dot-env files base path \"%s\"', baseEnvPath)\n    }\n\n    /**\n     * 1st\n     * The top most priority is given to the \".env.[NODE_ENV].local\" file\n     */\n    if (NODE_ENV) {\n      const nodeEnvLocalFile = join(baseEnvPath, `.env.${NODE_ENV}.local`)\n      envFiles.push({\n        path: nodeEnvLocalFile,\n        ...(await this.#loadFile(nodeEnvLocalFile)),\n      })\n    }\n\n    /**\n     * 2nd\n     * Next, we give priority to the \".env.local\" file\n     */\n    if (!NODE_ENV || !['test', 'testing'].includes(NODE_ENV)) {\n      const envLocalFile = join(baseEnvPath, '.env.local')\n      envFiles.push({\n        path: envLocalFile,\n        ...(await this.#loadFile(envLocalFile)),\n      })\n    }\n\n    /**\n     * 3rd\n     * Next, we give priority to the \".env.[NODE_ENV]\" file\n     */\n    if (NODE_ENV) {\n      const nodeEnvFile = join(baseEnvPath, `.env.${NODE_ENV}`)\n      envFiles.push({\n        path: nodeEnvFile,\n        ...(await this.#loadFile(nodeEnvFile)),\n      })\n    }\n\n    /**\n     * Finally, we push the contents of the \".env\" file.\n     */\n    const envFile = join(baseEnvPath, '.env')\n    envFiles.push({\n      path: envFile,\n      ...(await this.#loadFile(envFile)),\n    })\n\n    /**\n     * Load example file\n     */\n    if (this.#loadExampleFile) {\n      const envExampleFile = join(baseEnvPath, '.env.example')\n      envFiles.push({\n        path: envExampleFile,\n        ...(await this.#loadFile(envExampleFile)),\n      })\n    }\n\n    return envFiles\n  }\n}\n","/*\n * @adonisjs/env\n *\n * (c) AdonisJS\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\nimport { debuglog } from 'node:util'\nexport default debuglog('adonisjs:env')\n"],"mappings":";;;;;;;AASA,SAAS,qBAAqB;AAC9B,SAAS,gBAAgB;AACzB,SAAS,YAAY,YAAY;;;ACFjC,SAAS,gBAAgB;AACzB,IAAO,gBAAQ,SAAS,cAAc;;;AD2B/B,IAAM,YAAN,MAAgB;AAAA,EACrB;AAAA,EACA;AAAA,EAEA,YAAY,SAAuB,kBAA2B,OAAO;AACnE,SAAK,WAAW,OAAO,YAAY,WAAW,UAAU,cAAc,OAAO;AAC7E,SAAK,mBAAmB;AAAA,EAC1B;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,UAAU,UAA4E;AAC1F,QAAI;AACF,YAAM,WAAW,MAAM,SAAS,UAAU,OAAO;AACjD,aAAO,EAAE,UAAU,YAAY,KAAK;AAAA,IACtC,SAAS,OAAO;AAEd,UAAI,MAAM,SAAS,UAAU;AAC3B,cAAM;AAAA,MACR;AAEA,aAAO,EAAE,UAAU,IAAI,YAAY,MAAM;AAAA,IAC3C;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,OAA2E;AAC/E,UAAM,WAAW,QAAQ,IAAI;AAC7B,UAAM,WAAW,QAAQ,IAAI;AAC7B,UAAM,WAAsE,CAAC;AAE7E,QAAI,cAAM,SAAS;AACjB,oBAAM,2BAA2B,WAAW,QAAQ,SAAS;AAC7D,oBAAM,2BAA2B,WAAW,QAAQ,SAAS;AAAA,IAC/D;AAKA,UAAM,cAAc,WAChB,WAAW,QAAQ,IACjB,WACA,KAAK,KAAK,UAAU,QAAQ,IAC9B,KAAK;AAET,QAAI,cAAM,SAAS;AACjB,oBAAM,gCAAgC,WAAW;AAAA,IACnD;AAMA,QAAI,UAAU;AACZ,YAAM,mBAAmB,KAAK,aAAa,QAAQ,QAAQ,QAAQ;AACnE,eAAS,KAAK;AAAA,QACZ,MAAM;AAAA,QACN,GAAI,MAAM,KAAK,UAAU,gBAAgB;AAAA,MAC3C,CAAC;AAAA,IACH;AAMA,QAAI,CAAC,YAAY,CAAC,CAAC,QAAQ,SAAS,EAAE,SAAS,QAAQ,GAAG;AACxD,YAAM,eAAe,KAAK,aAAa,YAAY;AACnD,eAAS,KAAK;AAAA,QACZ,MAAM;AAAA,QACN,GAAI,MAAM,KAAK,UAAU,YAAY;AAAA,MACvC,CAAC;AAAA,IACH;AAMA,QAAI,UAAU;AACZ,YAAM,cAAc,KAAK,aAAa,QAAQ,QAAQ,EAAE;AACxD,eAAS,KAAK;AAAA,QACZ,MAAM;AAAA,QACN,GAAI,MAAM,KAAK,UAAU,WAAW;AAAA,MACtC,CAAC;AAAA,IACH;AAKA,UAAM,UAAU,KAAK,aAAa,MAAM;AACxC,aAAS,KAAK;AAAA,MACZ,MAAM;AAAA,MACN,GAAI,MAAM,KAAK,UAAU,OAAO;AAAA,IAClC,CAAC;AAKD,QAAI,KAAK,kBAAkB;AACzB,YAAM,iBAAiB,KAAK,aAAa,cAAc;AACvD,eAAS,KAAK;AAAA,QACZ,MAAM;AAAA,QACN,GAAI,MAAM,KAAK,UAAU,cAAc;AAAA,MACzC,CAAC;AAAA,IACH;AAEA,WAAO;AAAA,EACT;AACF;","names":[]}

package/build/index.d.ts

@@ -1,247 +1,5 @@
-import * as _poppinss_validator_lite_build_src_schema_oneOf_js from '@poppinss/validator-lite/build/src/schema/oneOf.js';
-import * as _poppinss_validator_lite_build_src_schema_boolean_js from '@poppinss/validator-lite/build/src/schema/boolean.js';
-import * as _poppinss_validator_lite_build_src_schema_string_js from '@poppinss/validator-lite/build/src/schema/string.js';
-import * as _poppinss_validator_lite_build_src_schema_number_js from '@poppinss/validator-lite/build/src/schema/number.js';
-import { ValidateFn } from '@poppinss/validator-lite';
-import { DotenvParseOutput } from 'dotenv';
-
-/**
- * Exposes the API to validate environment variables against a
- * pre-defined schema.
- *
- * The class is not exported in the main API and used internally.
- */
-declare class EnvValidator<Schema extends {
-    [key: string]: ValidateFn<unknown>;
-}> {
-    #private;
-    constructor(schema: Schema);
-    /**
-     * Accepts an object of values to validate against the pre-defined
-     * schema.
-     *
-     * The return value is a merged copy of the original object and the
-     * values mutated by the schema validator.
-     */
-    validate(values: {
-        [K: string]: string | undefined;
-    }): {
-        [K in keyof Schema]: ReturnType<Schema[K]>;
-    };
-}
-
-/**
- * A wrapper over "process.env" with types information.
- *
- * ```ts
- * const validate = Env.rules({
- *   PORT: Env.schema.number()
- * })
- *
- * const validatedEnvVars = validate(process.env)
- *
- * const env = new EnvValues(validatedEnvVars)
- * env.get('PORT') // type === number
- * ```
- */
-declare class Env<EnvValues extends Record<string, any>> {
-    #private;
-    constructor(values: EnvValues);
-    /**
-     * Create an instance of the env class by validating the
-     * environment variables. Also, the `.env` files are
-     * loaded from the appRoot
-     */
-    static create<Schema extends {
-        [key: string]: ValidateFn<unknown>;
-    }>(appRoot: URL, schema: Schema): Promise<Env<{
-        [K in keyof Schema]: ReturnType<Schema[K]>;
-    }>>;
-    /**
-     * The schema builder for defining validation rules
-     */
-    static schema: {
-        number: typeof _poppinss_validator_lite_build_src_schema_number_js.number;
-        string: typeof _poppinss_validator_lite_build_src_schema_string_js.string;
-        boolean: typeof _poppinss_validator_lite_build_src_schema_boolean_js.boolean;
-        enum: typeof _poppinss_validator_lite_build_src_schema_oneOf_js.oneOf;
-    };
-    /**
-     * Define the validation rules for validating environment
-     * variables. The return value is an instance of the
-     * env validator
-     */
-    static rules<T extends {
-        [key: string]: ValidateFn<unknown>;
-    }>(schema: T): EnvValidator<T>;
-    /**
-     * Get the value of an environment variable by key. The values are
-     * lookedup inside the validated environment and "process.env"
-     * is used as a fallback.
-     *
-     * The second param is the default value, which is returned when
-     * the environment variable does not exist.
-     *
-     * ```ts
-     * Env.get('PORT')
-     *
-     * // With default value
-     * Env.get('PORT', 3000)
-     * ```
-     */
-    get<K extends keyof EnvValues>(key: K): EnvValues[K];
-    get<K extends keyof EnvValues>(key: K, defaultValue: Exclude<EnvValues[K], undefined>): Exclude<EnvValues[K], undefined>;
-    get(key: string): string | undefined;
-    get(key: string, defaultValue: string): string;
-    /**
-     * Update/set value of an environment variable.
-     *
-     * The value is not casted/validated using the validator, so make sure
-     * to set the correct data type.
-     *
-     * ```ts
-     * Env.set('PORT', 3000)
-     *
-     * Env.get('PORT') === 3000 // true
-     * process.env.PORT === '3000' // true
-     * ```
-     */
-    set<K extends keyof EnvValues>(key: K, value: EnvValues[K]): void;
-    set(key: string, value: string): void;
-}
-
-/**
- * Env parser parses the environment variables from a string formatted
- * as a key-value pair seperated using an `=`. For example:
- *
- * ```dotenv
- * PORT=3333
- * HOST=127.0.0.1
- * ```
- *
- * The variables can reference other environment variables as well using `$`.
- * For example:
- *
- * ```dotenv
- * PORT=3333
- * REDIS_PORT=$PORT
- * ```
- *
- * The variables using characters other than letters can wrap variable
- * named inside a curly brace.
- *
- * ```dotenv
- * APP-PORT=3333
- * REDIS_PORT=${APP-PORT}
- * ```
- *
- * You can escape the `$` sign with a backtick.
- *
- * ```dotenv
- * REDIS_PASSWORD=foo\$123
- * ```
- *
- * ## Usage
- *
- * ```ts
- * const parser = new EnvParser(envContents)
- * const output = parser.parse()
- *
- * // The output is a key-value pair
- * ```
- */
-declare class EnvParser {
-    #private;
-    constructor(envContents: string, options?: {
-        ignoreProcessEnv: boolean;
-    });
-    /**
-     * Parse the env string to an object of environment variables.
-     */
-    parse(): DotenvParseOutput;
-}
-
-/**
- * Read the contents of one or more dot-env files. Following is how the files
- * are read.
- *
- * - Load file from the "ENV_PATH" environment file.
- *    (Raise error if file is missing)
- *
- * - If "ENV_PATH" is not defined, then find ".env" file in the app root.
- *    (Ignore if file is missing)
- *
- * - Find ".env.[NODE_ENV]" file in the app root.
- *    (Ignore if file is missing)
- *
- * ```ts
- * const loader = new EnvLoader(new URL('./', import.meta.url))
- *
- * const { envContents, currentEnvContents } = await loader.load()
- *
- * // envContents: Contents of .env or file specified via ENV_PATH
- * // currentEnvContents: Contents of .env.[NODE_ENV] file
- * ```
- */
-declare class EnvLoader {
-    #private;
-    constructor(appRoot: string | URL, loadExampleFile?: boolean);
-    /**
-     * Load contents of the main dot-env file and the current
-     * environment dot-env file
-     */
-    load(): Promise<{
-        contents: string;
-        path: string;
-        fileExists: boolean;
-    }[]>;
-}
-
-/**
- * Exception raised when one or more env variables
- * are invalid
- */
-declare const E_INVALID_ENV_VARIABLES: {
-    new (message?: string | undefined, options?: (ErrorOptions & {
-        code?: string | undefined;
-        status?: number | undefined;
-    }) | undefined): {
-        help: string;
-        name: string;
-        code?: string | undefined;
-        status: number;
-        toString(): string;
-        readonly [Symbol.toStringTag]: string;
-        message: string;
-        stack?: string | undefined;
-        cause?: unknown;
-    };
-    message: string;
-    code: string;
-    help?: string | undefined;
-    status?: number | undefined;
-    captureStackTrace(targetObject: object, constructorOpt?: Function | undefined): void;
-    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
-    stackTraceLimit: number;
-};
-
-declare const errors_E_INVALID_ENV_VARIABLES: typeof E_INVALID_ENV_VARIABLES;
-declare namespace errors {
-  export {
-    errors_E_INVALID_ENV_VARIABLES as E_INVALID_ENV_VARIABLES,
-  };
-}
-
-/**
- * Env processors loads, parses and process environment variables.
- */
-declare class EnvProcessor {
-    #private;
-    constructor(appRoot: URL);
-    /**
-     * Process env variables
-     */
-    process(): Promise<Record<string, any>>;
-}
-
-export { Env, EnvLoader, EnvParser, EnvProcessor, errors };
+export { Env } from './src/env.js';
+export { EnvParser } from './src/parser.js';
+export { EnvLoader } from './src/loader.js';
+export * as errors from './src/errors.js';
+export { EnvProcessor } from './src/processor.js';

package/build/index.js

@@ -2,7 +2,7 @@ import {
   EnvLoader,
   __export,
   debug_default
-} from "./chunk-NSHYMAZE.js";
+} from "./chunk-H6UKLEIO.js";
 
 // src/env.ts
 import { schema as envSchema } from "@poppinss/validator-lite";
@@ -249,3 +249,4 @@ export {
   EnvProcessor,
   errors_exports as errors
 };
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/env.ts","../src/errors.ts","../src/validator.ts","../src/parser.ts","../src/processor.ts"],"sourcesContent":["/*\n * @adonisjs/env\n *\n * (c) AdonisJS\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\nimport { schema as envSchema, type ValidateFn } from '@poppinss/validator-lite'\nimport { EnvValidator } from './validator.js'\nimport { EnvProcessor } from './processor.js'\n\n/**\n * A wrapper over \"process.env\" with types information.\n *\n * ```ts\n * const validate = Env.rules({\n *   PORT: Env.schema.number()\n * })\n *\n * const validatedEnvVars = validate(process.env)\n *\n * const env = new EnvValues(validatedEnvVars)\n * env.get('PORT') // type === number\n * ```\n */\nexport class Env<EnvValues extends Record<string, any>> {\n  /**\n   * A cache of env values\n   */\n  #values: EnvValues\n\n  constructor(values: EnvValues) {\n    this.#values = values\n  }\n\n  /**\n   * Create an instance of the env class by validating the\n   * environment variables. Also, the `.env` files are\n   * loaded from the appRoot\n   */\n  static async create<Schema extends { [key: string]: ValidateFn<unknown> }>(\n    appRoot: URL,\n    schema: Schema\n  ): Promise<\n    Env<{\n      [K in keyof Schema]: ReturnType<Schema[K]>\n    }>\n  > {\n    const values = await new EnvProcessor(appRoot).process()\n    const validator = this.rules(schema)\n    return new Env(validator.validate(values))\n  }\n\n  /**\n   * The schema builder for defining validation rules\n   */\n  static schema = envSchema\n\n  /**\n   * Define the validation rules for validating environment\n   * variables. The return value is an instance of the\n   * env validator\n   */\n  static rules<T extends { [key: string]: ValidateFn<unknown> }>(schema: T): EnvValidator<T> {\n    const validator = new EnvValidator<T>(schema)\n    return validator\n  }\n\n  /**\n   * Get the value of an environment variable by key. The values are\n   * lookedup inside the validated environment and \"process.env\"\n   * is used as a fallback.\n   *\n   * The second param is the default value, which is returned when\n   * the environment variable does not exist.\n   *\n   * ```ts\n   * Env.get('PORT')\n   *\n   * // With default value\n   * Env.get('PORT', 3000)\n   * ```\n   */\n  get<K extends keyof EnvValues>(key: K): EnvValues[K]\n  get<K extends keyof EnvValues>(\n    key: K,\n    defaultValue: Exclude<EnvValues[K], undefined>\n  ): Exclude<EnvValues[K], undefined>\n  get(key: string): string | undefined\n  get(key: string, defaultValue: string): string\n  get(key: string, defaultValue?: any): any {\n    /**\n     * Return cached value\n     */\n    if (this.#values[key] !== undefined) {\n      return this.#values[key]\n    }\n\n    /**\n     * Get value from \"process.env\" and update the cache\n     */\n    const envValue = process.env[key]\n    if (envValue) {\n      return envValue\n    }\n\n    /**\n     * Return default value when unable to lookup any other value\n     */\n    return defaultValue\n  }\n\n  /**\n   * Update/set value of an environment variable.\n   *\n   * The value is not casted/validated using the validator, so make sure\n   * to set the correct data type.\n   *\n   * ```ts\n   * Env.set('PORT', 3000)\n   *\n   * Env.get('PORT') === 3000 // true\n   * process.env.PORT === '3000' // true\n   * ```\n   */\n  set<K extends keyof EnvValues>(key: K, value: EnvValues[K]): void\n  set(key: string, value: string): void\n  set(key: string | keyof EnvValues, value: any): void {\n    this.#values[key] = value\n    process.env[key as string] = value\n  }\n}\n","/*\n * @adonisjs/env\n *\n * (c) AdonisJS\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\nimport { Exception } from '@poppinss/utils'\n\n/**\n * Exception raised when one or more env variables\n * are invalid\n */\nexport const E_INVALID_ENV_VARIABLES = class EnvValidationException extends Exception {\n  static message = 'Validation failed for one or more environment variables'\n  static code = 'E_INVALID_ENV_VARIABLES'\n  help: string = ''\n}\n","/*\n * @adonisjs/env\n *\n * (c) AdonisJS\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\nimport type { Exception } from '@poppinss/utils'\nimport { ValidateFn } from '@poppinss/validator-lite'\n\nimport { E_INVALID_ENV_VARIABLES } from './errors.js'\n\n/**\n * Exposes the API to validate environment variables against a\n * pre-defined schema.\n *\n * The class is not exported in the main API and used internally.\n */\nexport class EnvValidator<Schema extends { [key: string]: ValidateFn<unknown> }> {\n  #schema: Schema\n  #error: Exception\n\n  constructor(schema: Schema) {\n    this.#schema = schema\n    this.#error = new E_INVALID_ENV_VARIABLES()\n  }\n\n  /**\n   * Accepts an object of values to validate against the pre-defined\n   * schema.\n   *\n   * The return value is a merged copy of the original object and the\n   * values mutated by the schema validator.\n   */\n  validate(values: { [K: string]: string | undefined }): {\n    [K in keyof Schema]: ReturnType<Schema[K]>\n  } {\n    const help: string[] = []\n\n    const validated = Object.keys(this.#schema).reduce(\n      (result, key) => {\n        const value = process.env[key] || values[key]\n\n        try {\n          result[key] = this.#schema[key](key, value) as any\n        } catch (error) {\n          help.push(`- ${error.message}`)\n        }\n        return result\n      },\n      { ...values }\n    ) as { [K in keyof Schema]: ReturnType<Schema[K]> }\n\n    if (help.length) {\n      this.#error.help = help.join('\\n')\n      throw this.#error\n    }\n\n    return validated\n  }\n}\n","/*\n * @adonisjs/env\n *\n * (c) AdonisJS\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\nimport dotenv, { DotenvParseOutput } from 'dotenv'\n\n/**\n * Env parser parses the environment variables from a string formatted\n * as a key-value pair seperated using an `=`. For example:\n *\n * ```dotenv\n * PORT=3333\n * HOST=127.0.0.1\n * ```\n *\n * The variables can reference other environment variables as well using `$`.\n * For example:\n *\n * ```dotenv\n * PORT=3333\n * REDIS_PORT=$PORT\n * ```\n *\n * The variables using characters other than letters can wrap variable\n * named inside a curly brace.\n *\n * ```dotenv\n * APP-PORT=3333\n * REDIS_PORT=${APP-PORT}\n * ```\n *\n * You can escape the `$` sign with a backtick.\n *\n * ```dotenv\n * REDIS_PASSWORD=foo\\$123\n * ```\n *\n * ## Usage\n *\n * ```ts\n * const parser = new EnvParser(envContents)\n * const output = parser.parse()\n *\n * // The output is a key-value pair\n * ```\n */\nexport class EnvParser {\n  #envContents: string\n  #preferProcessEnv: boolean = true\n\n  constructor(envContents: string, options?: { ignoreProcessEnv: boolean }) {\n    if (options?.ignoreProcessEnv) {\n      this.#preferProcessEnv = false\n    }\n\n    this.#envContents = envContents\n  }\n\n  /**\n   * Returns the value from the parsed object\n   */\n  #getValue(key: string, parsed: DotenvParseOutput): string {\n    if (this.#preferProcessEnv && process.env[key]) {\n      return process.env[key]!\n    }\n\n    if (parsed[key]) {\n      return this.#interpolate(parsed[key], parsed)\n    }\n\n    return process.env[key] || ''\n  }\n\n  /**\n   * Interpolating the token wrapped inside the mustache braces.\n   */\n  #interpolateMustache(token: string, parsed: DotenvParseOutput) {\n    /**\n     * Finding the closing brace. If closing brace is missing, we\n     * consider the block as a normal string\n     */\n    const closingBrace = token.indexOf('}')\n    if (closingBrace === -1) {\n      return token\n    }\n\n    /**\n     * Then we pull everything until the closing brace, except\n     * the opening brace and trim off all white spaces.\n     */\n    const varReference = token.slice(1, closingBrace).trim()\n\n    /**\n     * Getting the value of the reference inside the braces\n     */\n    return `${this.#getValue(varReference, parsed)}${token.slice(closingBrace + 1)}`\n  }\n\n  /**\n   * Interpolating the variable reference starting with a\n   * `$`. We only capture numbers,letter and underscore.\n   * For other characters, one can use the mustache\n   * braces.\n   */\n  #interpolateVariable(token: string, parsed: any) {\n    return token.replace(/[a-zA-Z0-9_]+/, (key) => {\n      return this.#getValue(key, parsed)\n    })\n  }\n\n  /**\n   * Interpolates the referenced values\n   */\n  #interpolate(value: string, parsed: DotenvParseOutput): string {\n    const tokens = value.split('$')\n\n    let newValue = ''\n    let skipNextToken = true\n\n    tokens.forEach((token) => {\n      /**\n       * If the value is an escaped sequence, then we replace it\n       * with a `$` and then skip the next token.\n       */\n      if (token === '\\\\') {\n        newValue += '$'\n        skipNextToken = true\n        return\n      }\n\n      /**\n       * Use the value as it is when \"skipNextToken\" is set to true.\n       */\n      if (skipNextToken) {\n        /**\n         * Replace the ending escape sequence with a $\n         */\n        newValue += token.replace(/\\\\$/, '$')\n        /**\n         *  and then skip the next token if it ends with escape sequence\n         */\n        if (token.endsWith('\\\\')) {\n          return\n        }\n      } else {\n        /**\n         * Handle mustache block\n         */\n        if (token.startsWith('{')) {\n          newValue += this.#interpolateMustache(token, parsed)\n          return\n        }\n\n        /**\n         * Process all words as variable\n         */\n        newValue += this.#interpolateVariable(token, parsed)\n      }\n\n      /**\n       * Process next token\n       */\n      skipNextToken = false\n    })\n\n    return newValue\n  }\n\n  /**\n   * Parse the env string to an object of environment variables.\n   */\n  parse(): DotenvParseOutput {\n    const envCollection = dotenv.parse(this.#envContents.trim())\n\n    return Object.keys(envCollection).reduce<DotenvParseOutput>((result, key) => {\n      result[key] = this.#getValue(key, envCollection)\n      return result\n    }, {})\n  }\n}\n","/*\n * @adonisjs/application\n *\n * (c) AdonisJS\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\nimport debug from './debug.js'\nimport { EnvParser } from './parser.js'\nimport { EnvLoader } from './loader.js'\n\n/**\n * Env processors loads, parses and process environment variables.\n */\nexport class EnvProcessor {\n  /**\n   * App root is needed to load files\n   */\n  #appRoot: URL\n\n  constructor(appRoot: URL) {\n    this.#appRoot = appRoot\n  }\n\n  /**\n   * Parse env variables from raw contents\n   */\n  #processContents(envContents: string, store: Record<string, any>) {\n    /**\n     * Collected env variables\n     */\n    if (!envContents.trim()) {\n      return store\n    }\n\n    const values = new EnvParser(envContents).parse()\n    Object.keys(values).forEach((key) => {\n      let value = process.env[key]\n\n      if (!value) {\n        value = values[key]\n        process.env[key] = values[key]\n      }\n\n      if (!store[key]) {\n        store[key] = value\n      }\n    })\n\n    return store\n  }\n\n  /**\n   * Parse env variables by loading dot files.\n   */\n  async #loadAndProcessDotFiles() {\n    const loader = new EnvLoader(this.#appRoot)\n    const envFiles = await loader.load()\n\n    if (debug.enabled) {\n      debug(\n        'processing .env files (priority from top to bottom) %O',\n        envFiles.map((file) => file.path)\n      )\n    }\n\n    /**\n     * Collected env variables\n     */\n    const envValues: Record<string, any> = {}\n    envFiles.forEach(({ contents }) => this.#processContents(contents, envValues))\n    return envValues\n  }\n\n  /**\n   * Process env variables\n   */\n  async process() {\n    return this.#loadAndProcessDotFiles()\n  }\n}\n"],"mappings":";;;;;;;AASA,SAAS,UAAU,iBAAkC;;;ACTrD;AAAA;AAAA;AAAA;AASA,SAAS,iBAAiB;AAMnB,IAAM,0BAA0B,MAAM,+BAA+B,UAAU;AAAA,EACpF,OAAO,UAAU;AAAA,EACjB,OAAO,OAAO;AAAA,EACd,OAAe;AACjB;;;ACCO,IAAM,eAAN,MAA0E;AAAA,EAC/E;AAAA,EACA;AAAA,EAEA,YAAY,QAAgB;AAC1B,SAAK,UAAU;AACf,SAAK,SAAS,IAAI,wBAAwB;AAAA,EAC5C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,SAAS,QAEP;AACA,UAAM,OAAiB,CAAC;AAExB,UAAM,YAAY,OAAO,KAAK,KAAK,OAAO,EAAE;AAAA,MAC1C,CAAC,QAAQ,QAAQ;AACf,cAAM,QAAQ,QAAQ,IAAI,GAAG,KAAK,OAAO,GAAG;AAE5C,YAAI;AACF,iBAAO,GAAG,IAAI,KAAK,QAAQ,GAAG,EAAE,KAAK,KAAK;AAAA,QAC5C,SAAS,OAAO;AACd,eAAK,KAAK,KAAK,MAAM,OAAO,EAAE;AAAA,QAChC;AACA,eAAO;AAAA,MACT;AAAA,MACA,EAAE,GAAG,OAAO;AAAA,IACd;AAEA,QAAI,KAAK,QAAQ;AACf,WAAK,OAAO,OAAO,KAAK,KAAK,IAAI;AACjC,YAAM,KAAK;AAAA,IACb;AAEA,WAAO;AAAA,EACT;AACF;;;ACrDA,OAAO,YAAmC;AA0CnC,IAAM,YAAN,MAAgB;AAAA,EACrB;AAAA,EACA,oBAA6B;AAAA,EAE7B,YAAY,aAAqB,SAAyC;AACxE,QAAI,SAAS,kBAAkB;AAC7B,WAAK,oBAAoB;AAAA,IAC3B;AAEA,SAAK,eAAe;AAAA,EACtB;AAAA;AAAA;AAAA;AAAA,EAKA,UAAU,KAAa,QAAmC;AACxD,QAAI,KAAK,qBAAqB,QAAQ,IAAI,GAAG,GAAG;AAC9C,aAAO,QAAQ,IAAI,GAAG;AAAA,IACxB;AAEA,QAAI,OAAO,GAAG,GAAG;AACf,aAAO,KAAK,aAAa,OAAO,GAAG,GAAG,MAAM;AAAA,IAC9C;AAEA,WAAO,QAAQ,IAAI,GAAG,KAAK;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA,EAKA,qBAAqB,OAAe,QAA2B;AAK7D,UAAM,eAAe,MAAM,QAAQ,GAAG;AACtC,QAAI,iBAAiB,IAAI;AACvB,aAAO;AAAA,IACT;AAMA,UAAM,eAAe,MAAM,MAAM,GAAG,YAAY,EAAE,KAAK;AAKvD,WAAO,GAAG,KAAK,UAAU,cAAc,MAAM,CAAC,GAAG,MAAM,MAAM,eAAe,CAAC,CAAC;AAAA,EAChF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,qBAAqB,OAAe,QAAa;AAC/C,WAAO,MAAM,QAAQ,iBAAiB,CAAC,QAAQ;AAC7C,aAAO,KAAK,UAAU,KAAK,MAAM;AAAA,IACnC,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,aAAa,OAAe,QAAmC;AAC7D,UAAM,SAAS,MAAM,MAAM,GAAG;AAE9B,QAAI,WAAW;AACf,QAAI,gBAAgB;AAEpB,WAAO,QAAQ,CAAC,UAAU;AAKxB,UAAI,UAAU,MAAM;AAClB,oBAAY;AACZ,wBAAgB;AAChB;AAAA,MACF;AAKA,UAAI,eAAe;AAIjB,oBAAY,MAAM,QAAQ,OAAO,GAAG;AAIpC,YAAI,MAAM,SAAS,IAAI,GAAG;AACxB;AAAA,QACF;AAAA,MACF,OAAO;AAIL,YAAI,MAAM,WAAW,GAAG,GAAG;AACzB,sBAAY,KAAK,qBAAqB,OAAO,MAAM;AACnD;AAAA,QACF;AAKA,oBAAY,KAAK,qBAAqB,OAAO,MAAM;AAAA,MACrD;AAKA,sBAAgB;AAAA,IAClB,CAAC;AAED,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,QAA2B;AACzB,UAAM,gBAAgB,OAAO,MAAM,KAAK,aAAa,KAAK,CAAC;AAE3D,WAAO,OAAO,KAAK,aAAa,EAAE,OAA0B,CAAC,QAAQ,QAAQ;AAC3E,aAAO,GAAG,IAAI,KAAK,UAAU,KAAK,aAAa;AAC/C,aAAO;AAAA,IACT,GAAG,CAAC,CAAC;AAAA,EACP;AACF;;;ACxKO,IAAM,eAAN,MAAmB;AAAA;AAAA;AAAA;AAAA,EAIxB;AAAA,EAEA,YAAY,SAAc;AACxB,SAAK,WAAW;AAAA,EAClB;AAAA;AAAA;AAAA;AAAA,EAKA,iBAAiB,aAAqB,OAA4B;AAIhE,QAAI,CAAC,YAAY,KAAK,GAAG;AACvB,aAAO;AAAA,IACT;AAEA,UAAM,SAAS,IAAI,UAAU,WAAW,EAAE,MAAM;AAChD,WAAO,KAAK,MAAM,EAAE,QAAQ,CAAC,QAAQ;AACnC,UAAI,QAAQ,QAAQ,IAAI,GAAG;AAE3B,UAAI,CAAC,OAAO;AACV,gBAAQ,OAAO,GAAG;AAClB,gBAAQ,IAAI,GAAG,IAAI,OAAO,GAAG;AAAA,MAC/B;AAEA,UAAI,CAAC,MAAM,GAAG,GAAG;AACf,cAAM,GAAG,IAAI;AAAA,MACf;AAAA,IACF,CAAC;AAED,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,0BAA0B;AAC9B,UAAM,SAAS,IAAI,UAAU,KAAK,QAAQ;AAC1C,UAAM,WAAW,MAAM,OAAO,KAAK;AAEnC,QAAI,cAAM,SAAS;AACjB;AAAA,QACE;AAAA,QACA,SAAS,IAAI,CAAC,SAAS,KAAK,IAAI;AAAA,MAClC;AAAA,IACF;AAKA,UAAM,YAAiC,CAAC;AACxC,aAAS,QAAQ,CAAC,EAAE,SAAS,MAAM,KAAK,iBAAiB,UAAU,SAAS,CAAC;AAC7E,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,UAAU;AACd,WAAO,KAAK,wBAAwB;AAAA,EACtC;AACF;;;AJvDO,IAAM,MAAN,MAAM,KAA2C;AAAA;AAAA;AAAA;AAAA,EAItD;AAAA,EAEA,YAAY,QAAmB;AAC7B,SAAK,UAAU;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,aAAa,OACX,SACA,QAKA;AACA,UAAM,SAAS,MAAM,IAAI,aAAa,OAAO,EAAE,QAAQ;AACvD,UAAM,YAAY,KAAK,MAAM,MAAM;AACnC,WAAO,IAAI,KAAI,UAAU,SAAS,MAAM,CAAC;AAAA,EAC3C;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOhB,OAAO,MAAwD,QAA4B;AACzF,UAAM,YAAY,IAAI,aAAgB,MAAM;AAC5C,WAAO;AAAA,EACT;AAAA,EAwBA,IAAI,KAAa,cAAyB;AAIxC,QAAI,KAAK,QAAQ,GAAG,MAAM,QAAW;AACnC,aAAO,KAAK,QAAQ,GAAG;AAAA,IACzB;AAKA,UAAM,WAAW,QAAQ,IAAI,GAAG;AAChC,QAAI,UAAU;AACZ,aAAO;AAAA,IACT;AAKA,WAAO;AAAA,EACT;AAAA,EAiBA,IAAI,KAA+B,OAAkB;AACnD,SAAK,QAAQ,GAAG,IAAI;AACpB,YAAQ,IAAI,GAAa,IAAI;AAAA,EAC/B;AACF;","names":[]}

package/build/src/debug.d.ts

@@ -0,0 +1,3 @@
+/// <reference types="node" resolution-mode="require"/>
+declare const _default: import("util").DebugLogger;
+export default _default;

package/build/src/editor.d.ts

@@ -1,4 +1,5 @@
-declare class EnvEditor {
+/// <reference types="node" resolution-mode="require"/>
+export declare class EnvEditor {
     #private;
     /**
      * Creates an instance of env editor and loads .env files
@@ -24,5 +25,3 @@ declare class EnvEditor {
      */
     save(): Promise<void>;
 }
-
-export { EnvEditor };

package/build/src/editor.js

@@ -1,6 +1,6 @@
 import {
   EnvLoader
-} from "../chunk-NSHYMAZE.js";
+} from "../chunk-H6UKLEIO.js";
 
 // src/editor.ts
 import splitLines from "split-lines";
@@ -65,3 +65,4 @@ var EnvEditor = class _EnvEditor {
 export {
   EnvEditor
 };
+//# sourceMappingURL=editor.js.map

package/build/src/editor.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/editor.ts"],"sourcesContent":["/*\n * @adonisjs/env\n *\n * (c) AdonisJS\n *\n * For the full copyright and license information, please view the LICENSE\n * file that was distributed with this source code.\n */\n\nimport splitLines from 'split-lines'\nimport lodash from '@poppinss/utils/lodash'\nimport { writeFile } from 'node:fs/promises'\n\nimport { EnvLoader } from './loader.js'\n\nexport class EnvEditor {\n  #appRoot: URL\n  #loader: EnvLoader\n  #files: { contents: string[]; path: string }[] = []\n\n  /**\n   * Creates an instance of env editor and loads .env files\n   * contents.\n   */\n  static async create(appRoot: URL) {\n    const editor = new EnvEditor(appRoot)\n    await editor.load()\n\n    return editor\n  }\n\n  constructor(appRoot: URL) {\n    this.#appRoot = appRoot\n    this.#loader = new EnvLoader(this.#appRoot, true)\n  }\n\n  /**\n   * Loads .env files for editing. Only \".env\" and \".env.example\"\n   * files are picked for editing.\n   */\n  async load() {\n    const envFiles = await this.#loader.load()\n\n    this.#files = envFiles\n      .filter(\n        (envFile) =>\n          envFile.fileExists &&\n          (envFile.path.endsWith('.env') || envFile.path.endsWith('.env.example'))\n      )\n      .map((envFile) => {\n        return {\n          contents: splitLines(envFile.contents.trim()),\n          path: envFile.path,\n        }\n      })\n  }\n\n  /**\n   * Add key-value pair to the dot-env files.\n   */\n  add(key: string, value: string | number | boolean) {\n    this.#files.forEach((file) => {\n      let entryIndex = file.contents.findIndex((line) => line.startsWith(`${key}=`))\n\n      entryIndex = entryIndex === -1 ? file.contents.length : entryIndex\n      lodash.set(file.contents, entryIndex, `${key}=${String(value)}`)\n    })\n  }\n\n  toJSON() {\n    return this.#files\n  }\n\n  /**\n   * Save changes to the disk\n   */\n  async save() {\n    await Promise.all(\n      this.#files.map((file) => {\n        return writeFile(file.path, file.contents.join('\\n'))\n      })\n    )\n  }\n}\n"],"mappings":";;;;;AASA,OAAO,gBAAgB;AACvB,OAAO,YAAY;AACnB,SAAS,iBAAiB;AAInB,IAAM,YAAN,MAAM,WAAU;AAAA,EACrB;AAAA,EACA;AAAA,EACA,SAAiD,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMlD,aAAa,OAAO,SAAc;AAChC,UAAM,SAAS,IAAI,WAAU,OAAO;AACpC,UAAM,OAAO,KAAK;AAElB,WAAO;AAAA,EACT;AAAA,EAEA,YAAY,SAAc;AACxB,SAAK,WAAW;AAChB,SAAK,UAAU,IAAI,UAAU,KAAK,UAAU,IAAI;AAAA,EAClD;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,OAAO;AACX,UAAM,WAAW,MAAM,KAAK,QAAQ,KAAK;AAEzC,SAAK,SAAS,SACX;AAAA,MACC,CAAC,YACC,QAAQ,eACP,QAAQ,KAAK,SAAS,MAAM,KAAK,QAAQ,KAAK,SAAS,cAAc;AAAA,IAC1E,EACC,IAAI,CAAC,YAAY;AAChB,aAAO;AAAA,QACL,UAAU,WAAW,QAAQ,SAAS,KAAK,CAAC;AAAA,QAC5C,MAAM,QAAQ;AAAA,MAChB;AAAA,IACF,CAAC;AAAA,EACL;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,KAAa,OAAkC;AACjD,SAAK,OAAO,QAAQ,CAAC,SAAS;AAC5B,UAAI,aAAa,KAAK,SAAS,UAAU,CAAC,SAAS,KAAK,WAAW,GAAG,GAAG,GAAG,CAAC;AAE7E,mBAAa,eAAe,KAAK,KAAK,SAAS,SAAS;AACxD,aAAO,IAAI,KAAK,UAAU,YAAY,GAAG,GAAG,IAAI,OAAO,KAAK,CAAC,EAAE;AAAA,IACjE,CAAC;AAAA,EACH;AAAA,EAEA,SAAS;AACP,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,OAAO;AACX,UAAM,QAAQ;AAAA,MACZ,KAAK,OAAO,IAAI,CAAC,SAAS;AACxB,eAAO,UAAU,KAAK,MAAM,KAAK,SAAS,KAAK,IAAI,CAAC;AAAA,MACtD,CAAC;AAAA,IACH;AAAA,EACF;AACF;","names":[]}

package/build/src/env.d.ts

@@ -0,0 +1,82 @@
+/// <reference types="node" resolution-mode="require"/>
+import { type ValidateFn } from '@poppinss/validator-lite';
+import { EnvValidator } from './validator.js';
+/**
+ * A wrapper over "process.env" with types information.
+ *
+ * ```ts
+ * const validate = Env.rules({
+ *   PORT: Env.schema.number()
+ * })
+ *
+ * const validatedEnvVars = validate(process.env)
+ *
+ * const env = new EnvValues(validatedEnvVars)
+ * env.get('PORT') // type === number
+ * ```
+ */
+export declare class Env<EnvValues extends Record<string, any>> {
+    #private;
+    constructor(values: EnvValues);
+    /**
+     * Create an instance of the env class by validating the
+     * environment variables. Also, the `.env` files are
+     * loaded from the appRoot
+     */
+    static create<Schema extends {
+        [key: string]: ValidateFn<unknown>;
+    }>(appRoot: URL, schema: Schema): Promise<Env<{
+        [K in keyof Schema]: ReturnType<Schema[K]>;
+    }>>;
+    /**
+     * The schema builder for defining validation rules
+     */
+    static schema: {
+        number: typeof import("@poppinss/validator-lite/build/src/schema/number.js").number;
+        string: typeof import("@poppinss/validator-lite/build/src/schema/string.js").string;
+        boolean: typeof import("@poppinss/validator-lite/build/src/schema/boolean.js").boolean;
+        enum: typeof import("@poppinss/validator-lite/build/src/schema/oneOf.js").oneOf;
+    };
+    /**
+     * Define the validation rules for validating environment
+     * variables. The return value is an instance of the
+     * env validator
+     */
+    static rules<T extends {
+        [key: string]: ValidateFn<unknown>;
+    }>(schema: T): EnvValidator<T>;
+    /**
+     * Get the value of an environment variable by key. The values are
+     * lookedup inside the validated environment and "process.env"
+     * is used as a fallback.
+     *
+     * The second param is the default value, which is returned when
+     * the environment variable does not exist.
+     *
+     * ```ts
+     * Env.get('PORT')
+     *
+     * // With default value
+     * Env.get('PORT', 3000)
+     * ```
+     */
+    get<K extends keyof EnvValues>(key: K): EnvValues[K];
+    get<K extends keyof EnvValues>(key: K, defaultValue: Exclude<EnvValues[K], undefined>): Exclude<EnvValues[K], undefined>;
+    get(key: string): string | undefined;
+    get(key: string, defaultValue: string): string;
+    /**
+     * Update/set value of an environment variable.
+     *
+     * The value is not casted/validated using the validator, so make sure
+     * to set the correct data type.
+     *
+     * ```ts
+     * Env.set('PORT', 3000)
+     *
+     * Env.get('PORT') === 3000 // true
+     * process.env.PORT === '3000' // true
+     * ```
+     */
+    set<K extends keyof EnvValues>(key: K, value: EnvValues[K]): void;
+    set(key: string, value: string): void;
+}

package/build/src/errors.d.ts

@@ -0,0 +1,28 @@
+/// <reference types="node" resolution-mode="require"/>
+/**
+ * Exception raised when one or more env variables
+ * are invalid
+ */
+export declare const E_INVALID_ENV_VARIABLES: {
+    new (message?: string | undefined, options?: (ErrorOptions & {
+        code?: string | undefined;
+        status?: number | undefined;
+    }) | undefined): {
+        help: string;
+        name: string;
+        code?: string | undefined;
+        status: number;
+        toString(): string;
+        readonly [Symbol.toStringTag]: string;
+        message: string;
+        stack?: string | undefined;
+        cause?: unknown;
+    };
+    message: string;
+    code: string;
+    help?: string | undefined;
+    status?: number | undefined;
+    captureStackTrace(targetObject: object, constructorOpt?: Function | undefined): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};

package/build/src/loader.d.ts

@@ -0,0 +1,36 @@
+/// <reference types="node" resolution-mode="require"/>
+/**
+ * Read the contents of one or more dot-env files. Following is how the files
+ * are read.
+ *
+ * - Load file from the "ENV_PATH" environment file.
+ *    (Raise error if file is missing)
+ *
+ * - If "ENV_PATH" is not defined, then find ".env" file in the app root.
+ *    (Ignore if file is missing)
+ *
+ * - Find ".env.[NODE_ENV]" file in the app root.
+ *    (Ignore if file is missing)
+ *
+ * ```ts
+ * const loader = new EnvLoader(new URL('./', import.meta.url))
+ *
+ * const { envContents, currentEnvContents } = await loader.load()
+ *
+ * // envContents: Contents of .env or file specified via ENV_PATH
+ * // currentEnvContents: Contents of .env.[NODE_ENV] file
+ * ```
+ */
+export declare class EnvLoader {
+    #private;
+    constructor(appRoot: string | URL, loadExampleFile?: boolean);
+    /**
+     * Load contents of the main dot-env file and the current
+     * environment dot-env file
+     */
+    load(): Promise<{
+        contents: string;
+        path: string;
+        fileExists: boolean;
+    }[]>;
+}

package/build/src/parser.d.ts

@@ -0,0 +1,51 @@
+import { DotenvParseOutput } from 'dotenv';
+/**
+ * Env parser parses the environment variables from a string formatted
+ * as a key-value pair seperated using an `=`. For example:
+ *
+ * ```dotenv
+ * PORT=3333
+ * HOST=127.0.0.1
+ * ```
+ *
+ * The variables can reference other environment variables as well using `$`.
+ * For example:
+ *
+ * ```dotenv
+ * PORT=3333
+ * REDIS_PORT=$PORT
+ * ```
+ *
+ * The variables using characters other than letters can wrap variable
+ * named inside a curly brace.
+ *
+ * ```dotenv
+ * APP-PORT=3333
+ * REDIS_PORT=${APP-PORT}
+ * ```
+ *
+ * You can escape the `$` sign with a backtick.
+ *
+ * ```dotenv
+ * REDIS_PASSWORD=foo\$123
+ * ```
+ *
+ * ## Usage
+ *
+ * ```ts
+ * const parser = new EnvParser(envContents)
+ * const output = parser.parse()
+ *
+ * // The output is a key-value pair
+ * ```
+ */
+export declare class EnvParser {
+    #private;
+    constructor(envContents: string, options?: {
+        ignoreProcessEnv: boolean;
+    });
+    /**
+     * Parse the env string to an object of environment variables.
+     */
+    parse(): DotenvParseOutput;
+}

package/build/src/processor.d.ts

@@ -0,0 +1,12 @@
+/// <reference types="node" resolution-mode="require"/>
+/**
+ * Env processors loads, parses and process environment variables.
+ */
+export declare class EnvProcessor {
+    #private;
+    constructor(appRoot: URL);
+    /**
+     * Process env variables
+     */
+    process(): Promise<Record<string, any>>;
+}

package/build/src/validator.d.ts

@@ -0,0 +1,25 @@
+import { ValidateFn } from '@poppinss/validator-lite';
+/**
+ * Exposes the API to validate environment variables against a
+ * pre-defined schema.
+ *
+ * The class is not exported in the main API and used internally.
+ */
+export declare class EnvValidator<Schema extends {
+    [key: string]: ValidateFn<unknown>;
+}> {
+    #private;
+    constructor(schema: Schema);
+    /**
+     * Accepts an object of values to validate against the pre-defined
+     * schema.
+     *
+     * The return value is a merged copy of the original object and the
+     * values mutated by the schema validator.
+     */
+    validate(values: {
+        [K: string]: string | undefined;
+    }): {
+        [K in keyof Schema]: ReturnType<Schema[K]>;
+    };
+}

package/package.json

@@ -1,11 +1,14 @@
 {
   "name": "@adonisjs/env",
-  "version": "4.2.0-6",
+  "version": "4.2.0-8",
   "description": "Environment variable manager for Node.js",
   "main": "build/index.js",
   "type": "module",
   "files": [
-    "build"
+    "build",
+    "!build/bin",
+    "!build/examples",
+    "!build/tests"
   ],
   "exports": {
     ".": "./build/index.js",
@@ -19,7 +22,8 @@
     "test": "cross-env NODE_DEBUG=adonisjs:env c8 npm run quick:test",
     "clean": "del-cli build",
     "typecheck": "tsc --noEmit",
-    "compile": "npm run lint && npm run clean && tsup-node",
+    "precompile": "npm run lint && npm run clean",
+    "compile": "tsup-node && tsc --emitDeclarationOnly --declaration",
     "build": "npm run compile",
     "release": "np",
     "version": "npm run build",
@@ -36,31 +40,31 @@
   "author": "virk,adonisjs",
   "license": "MIT",
   "devDependencies": {
-    "@adonisjs/eslint-config": "^1.1.8",
-    "@adonisjs/prettier-config": "^1.1.8",
-    "@adonisjs/tsconfig": "^1.1.8",
-    "@commitlint/cli": "^17.8.0",
-    "@commitlint/config-conventional": "^17.8.0",
-    "@japa/assert": "^2.0.0",
-    "@japa/expect-type": "^2.0.0",
-    "@japa/file-system": "^2.0.0",
-    "@japa/runner": "^3.0.2",
-    "@swc/core": "1.3.82",
-    "@types/node": "^20.8.6",
+    "@adonisjs/eslint-config": "^1.2.0",
+    "@adonisjs/prettier-config": "^1.2.0",
+    "@adonisjs/tsconfig": "^1.2.0",
+    "@commitlint/cli": "^18.4.3",
+    "@commitlint/config-conventional": "^18.4.3",
+    "@japa/assert": "^2.1.0",
+    "@japa/expect-type": "^2.0.1",
+    "@japa/file-system": "^2.1.0",
+    "@japa/runner": "^3.1.1",
+    "@swc/core": "^1.3.101",
+    "@types/node": "^20.10.5",
     "c8": "^8.0.1",
     "cross-env": "^7.0.3",
     "del-cli": "^5.1.0",
-    "eslint": "^8.51.0",
+    "eslint": "^8.56.0",
     "github-label-sync": "^2.3.1",
     "husky": "^8.0.3",
-    "np": "^8.0.4",
-    "prettier": "^3.0.3",
-    "ts-node": "^10.9.1",
-    "tsup": "^7.2.0",
-    "typescript": "^5.2.2"
+    "np": "^9.2.0",
+    "prettier": "^3.1.1",
+    "ts-node": "^10.9.2",
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3"
   },
   "dependencies": {
-    "@poppinss/utils": "^6.5.0",
+    "@poppinss/utils": "^6.7.0",
     "@poppinss/validator-lite": "^1.0.3",
     "dotenv": "^16.3.1",
     "split-lines": "^3.0.0"
@@ -109,7 +113,8 @@
     "outDir": "./build",
     "clean": true,
     "format": "esm",
-    "dts": true,
+    "dts": false,
+    "sourcemap": true,
     "target": "esnext"
   }
 }