@arkstack/common 0.14.18 → 0.14.19

package/dist/index.d.ts

@@ -172,7 +172,75 @@ declare class Logger {
 //#endregion
 //#region src/types.d.ts
 interface ConfigRegistry {}
-interface EnvRegistry {}
+/**
+ * Map of known environment variables to their (coerced) value types.
+ *
+ * Used to give {@link GlobalEnv | env()} precise return types. Unknown keys fall
+ * back to `string`. Augment this interface (declaration merging) to register
+ * application-specific variables:
+ *
+ * ```ts
+ * declare module '@arkstack/common' {
+ *   interface EnvRegistry { MY_FLAG: boolean }
+ * }
+ * ```
+ */
+interface EnvRegistry {
+  APP_NAME: string;
+  APP_ENV: 'development' | 'production' | 'staging' | 'local';
+  APP_KEY: string;
+  APP_URL: string;
+  APP_HOST: string;
+  APP_PORT: number;
+  NODE_ENV: 'development' | 'production' | 'test';
+  PORT: number;
+  HOST: string;
+  FRONTEND_URL: string;
+  OUTPUT_DIR: string;
+  OUTPUT_DIR_DEV: string;
+  CONFIG_PATH: string;
+  TUNNEL: boolean;
+  FILESYSTEM_DISK: string;
+  CACHE_STORE: string;
+  CACHE_PREFIX: string;
+  CACHE_TABLE: string;
+  QUEUE_CONNECTION: string;
+  QUEUE_TABLE: string;
+  QUEUE_NAME: string;
+  QUEUE_RETRY_AFTER: number;
+  REDIS_HOST: string;
+  REDIS_PORT: number;
+  REDIS_PASSWORD: string;
+  REDIS_CACHE_DB: number;
+  REDIS_QUEUE_DB: number;
+  JWT_EXPIRES_IN: string;
+  SESSION_LIFETIME: number;
+  TWO_FACTOR_SMS_TTL_MINUTES: number;
+  DATABASE_URL: string;
+  DB_CONNECTION: string;
+  DB_HOST: string;
+  DB_PORT: number;
+  DB_DATABASE: string;
+  DB_USERNAME: string;
+  DB_PASSWORD: string;
+  MAIL_HOST: string;
+  MAIL_PORT: number;
+  MAIL_SECURE: boolean;
+  MAIL_USERNAME: string;
+  MAIL_PASSWORD: string;
+  MAIL_FROM_ADDRESS: string;
+  MAIL_TEST_ADDRESS: string;
+  AWS_ACCESS_KEY_ID: string;
+  AWS_SECRET_ACCESS_KEY: string;
+  AWS_DEFAULT_REGION: string;
+  AWS_BUCKET: string;
+  AWS_URL: string;
+  AWS_ENDPOINT: string;
+}
+/** Known environment variable names. */
+type EnvKey = keyof EnvRegistry & string;
+/** The registered type for a known key, or `string` for an unknown one. */
+type EnvLookup<K extends string> = [K] extends [EnvKey] ? EnvRegistry[K] : string;
 type UnionToIntersection<U> = (U extends any ? (x: U) => void : never) extends ((x: infer I) => void) ? I : never;
 type MergedConfig<X> = UnionToIntersection<X>;
 type Primitive = string | number | boolean | null | undefined | Function;
@@ -196,8 +264,17 @@ interface LoggerLog {
   <L extends boolean>(config: LoggerParseSignature, joiner?: string, log?: L, sc?: LoggerChalk): L extends true ? void : string;
   <L extends boolean>(config?: LoggerParseSignature, joiner?: string, log?: L, sc?: LoggerChalk): L extends true ? void : string | Logger;
 }
+/**
+ * Return type of {@link GlobalEnv | env()}.
+ *
+ * When an explicit value type `X` is given it wins (backward compatible with
+ * `env<boolean>('FLAG')`). Otherwise the type registered for the key `K` is used
+ * — falling back to `string` for unknown keys. A provided default `D` is unioned
+ * into the result.
+ */
+type EnvReturn<X, K extends string, D> = [X] extends [never] ? [D] extends [undefined] ? EnvLookup<K> : EnvLookup<K> | D : [D] extends [undefined] ? X : X | D;
 interface GlobalEnv {
-  <X = string, Y = undefined | X>(env: string, defaultValue?: Y): Y extends undefined ? X : Y;
+  <X = never, D = undefined, K extends string = string>(env: K, defaultValue?: D): EnvReturn<X, K, D>;
 }
 type ConfigShape = keyof ConfigRegistry extends never ? Record<string, any> : ConfigRegistry;
 interface GlobalConfig {
@@ -285,7 +362,6 @@ declare const env: GlobalEnv;
  * @returns
  */
 declare const appUrl: (link?: string) => string;
-declare const CONFIG_KEY: unique symbol;
 /**
  * Gets the application configuration.
  *
@@ -589,4 +665,81 @@ declare class Hook {
   static clear: () => void;
 }
 //#endregion
-export { AbstractModelConstructor, AppException, ArkstackErrorPayload, ArkstackErrorShape, CONFIG_KEY, ConfigRegistry, ConfigShape, DotPath, DotPathValue, Encryption, EnvRegistry, ErrorHandler, Exception, FileImporter, GlobalConfig, GlobalEnv, Hash, Hook, HookArgs, HookFor, HookName, HookPos, HookPositions, HookRegistry, IHook, Logger, LoggerChalk, LoggerLog, LoggerParseSignature, MergedConfig, ModelConstructor, ModelRegistry, Primitive, PublishEntry, PublishFilter, PublishGroup, Publisher, RequestException, UnionToIntersection, abort, abortIf, appKey, appUrl, assertFound, bindGracefulShutdown, bootWithDetectedPort, config, createErrorPayload, discoverCommands, env, getErrorLogger, getModel, getPrimaryError, getValidationErrors, importFile, initializeGlobalContext, interopDefault, isClass, isModelNotFoundError, isValidationError, loadPrototypes, logUnhandledError, nodeEnv, normalizeStatusCode, outputDir, perPage, rebuildOutput, renderError, resolveRuntimeDir, resolveRuntimeModule, serializeError, shouldHideStack, shouldLogError, toErrorShape, toOutputPath };
+//#region src/EnvLoader.d.ts
+/**
+ * Loads environment variables, reading the `.env` file on first access.
+ *
+ * The `.env` file is loaded lazily the first time a variable is read, so
+ * environment access never depends on a side-effect `import 'dotenv/config'`
+ * running first. Import ordering — which linters and bundlers may rewrite —
+ * could otherwise place an env-reading module before dotenv has populated
+ * `process.env`, leaving that module with default/stale values.
+ * `dotenv.config()` never overrides variables already set, so the lazy load is
+ * safe alongside other loaders.
+ */
+declare class EnvLoader {
+  private loaded;
+  /**
+   * Load the `.env` file once.
+   *
+   * @returns
+   */
+  private ensureLoaded;
+  /**
+   * Read an environment variable, coercing booleans, numbers and `null`, and
+   * falling back to `defaultValue` when it is unset.
+   *
+   * @param name          The variable name.
+   * @param defaultValue  Returned when the variable is unset.
+   */
+  get<X = never, D = undefined, K extends string = string>(name: K, defaultValue?: D): EnvReturn<X, K, D>;
+}
+/**
+ * Shared environment loader backing {@link env}.
+ */
+declare const envLoader: EnvLoader;
+//#endregion
+//#region src/ConfigLoader.d.ts
+declare const CONFIG_KEY: unique symbol;
+/**
+ * Loads and resolves application configuration from the config directory.
+ *
+ * Config modules are read once (lazily) from the output directory and cached on
+ * a global symbol, then queried by dot-path. A partial config object can also be
+ * merged in at runtime.
+ */
+declare class ConfigLoader {
+  /**
+   * The cached config store, shared across instances via a global symbol.
+   */
+  private get store();
+  private set store(value);
+  /**
+   * Read and cache config modules from the config directory on first use.
+   */
+  private load;
+  /**
+   * Resolve the directory to load config modules from.
+   *
+   * Prefers an explicit `CONFIG_PATH`, then the environment-selected output
+   * directory. Falls back to the other build output (`dist` ⇄
+   * `.arkstack/build`) so config still loads if the selected directory is
+   * missing or transiently emptied — e.g. a concurrent rebuild (`clean: true`)
+   * during a test run.
+   */
+  private resolveConfigDir;
+  /**
+   * Resolve configuration: read a dot-path value, merge a partial config
+   * object, or return the whole config.
+   *
+   * @param key           Dot-path to read, or an object to merge in.
+   * @param defaultValue  Returned when a string key is not found.
+   */
+  resolve<X extends ConfigRegistry | unknown = unknown, P extends DotPath<X> | undefined = undefined>(key?: P, defaultValue?: any): any;
+}
+/**
+ * Shared config loader backing {@link config}.
+ */
+declare const configLoader: ConfigLoader;
+//#endregion
+export { AbstractModelConstructor, AppException, ArkstackErrorPayload, ArkstackErrorShape, CONFIG_KEY, ConfigLoader, ConfigRegistry, ConfigShape, DotPath, DotPathValue, Encryption, EnvKey, EnvLoader, EnvLookup, EnvRegistry, EnvReturn, ErrorHandler, Exception, FileImporter, GlobalConfig, GlobalEnv, Hash, Hook, HookArgs, HookFor, HookName, HookPos, HookPositions, HookRegistry, IHook, Logger, LoggerChalk, LoggerLog, LoggerParseSignature, MergedConfig, ModelConstructor, ModelRegistry, Primitive, PublishEntry, PublishFilter, PublishGroup, Publisher, RequestException, UnionToIntersection, abort, abortIf, appKey, appUrl, assertFound, bindGracefulShutdown, bootWithDetectedPort, config, configLoader, createErrorPayload, discoverCommands, env, envLoader, getErrorLogger, getModel, getPrimaryError, getValidationErrors, importFile, initializeGlobalContext, interopDefault, isClass, isModelNotFoundError, isValidationError, loadPrototypes, logUnhandledError, nodeEnv, normalizeStatusCode, outputDir, perPage, rebuildOutput, renderError, resolveRuntimeDir, resolveRuntimeModule, serializeError, shouldHideStack, shouldLogError, toErrorShape, toOutputPath };

package/dist/index.js

@@ -1,7 +1,7 @@
-import { A as resolveRuntimeDir, C as discoverCommands, D as nodeEnv, E as interopDefault, M as toOutputPath, O as outputDir, S as config, T as importFile, _ as Hash, b as appKey, c as abortIf, d as initializeGlobalContext, f as isClass, g as Exception, h as AppException, j as resolveRuntimeModule, k as rebuildOutput, l as assertFound, m as RequestException, p as perPage, s as abort, u as getModel, v as Encryption, w as env, x as appUrl, y as CONFIG_KEY } from "./utils-DJQAOLbx.js";
+import { A as resolveRuntimeModule, C as env, D as outputDir, E as nodeEnv, F as ConfigLoader, I as configLoader, M as EnvLoader, N as envLoader, O as rebuildOutput, P as CONFIG_KEY, S as discoverCommands, T as interopDefault, _ as Hash, b as appUrl, c as abortIf, d as initializeGlobalContext, f as isClass, g as Exception, h as AppException, j as toOutputPath, k as resolveRuntimeDir, l as assertFound, m as RequestException, p as perPage, s as abort, u as getModel, v as Encryption, w as importFile, x as config, y as appKey } from "./utils-DEflBOXp.js";
 import { Hook as Hook$1 } from "@arkstack/foundry";
-import { str } from "@h3ravel/support";
 import { Arkstack } from "@arkstack/contract";
+import { str } from "@h3ravel/support";
 import path from "node:path";
 import { ModelNotFoundException } from "arkormx";
 import { detect } from "detect-port";
@@ -529,4 +529,4 @@ var Hook = class {
 	};
 };
 //#endregion
-export { AppException, CONFIG_KEY, Encryption, ErrorHandler, Exception, Hash, Hook, Logger, Publisher, RequestException, abort, abortIf, appKey, appUrl, assertFound, bindGracefulShutdown, bootWithDetectedPort, config, createErrorPayload, discoverCommands, env, getErrorLogger, getModel, getPrimaryError, getValidationErrors, importFile, initializeGlobalContext, interopDefault, isClass, isModelNotFoundError, isValidationError, loadPrototypes, logUnhandledError, nodeEnv, normalizeStatusCode, outputDir, perPage, rebuildOutput, renderError, resolveRuntimeDir, resolveRuntimeModule, serializeError, shouldHideStack, shouldLogError, toErrorShape, toOutputPath };
+export { AppException, CONFIG_KEY, ConfigLoader, Encryption, EnvLoader, ErrorHandler, Exception, Hash, Hook, Logger, Publisher, RequestException, abort, abortIf, appKey, appUrl, assertFound, bindGracefulShutdown, bootWithDetectedPort, config, configLoader, createErrorPayload, discoverCommands, env, envLoader, getErrorLogger, getModel, getPrimaryError, getValidationErrors, importFile, initializeGlobalContext, interopDefault, isClass, isModelNotFoundError, isValidationError, loadPrototypes, logUnhandledError, nodeEnv, normalizeStatusCode, outputDir, perPage, rebuildOutput, renderError, resolveRuntimeDir, resolveRuntimeModule, serializeError, shouldHideStack, shouldLogError, toErrorShape, toOutputPath };

package/dist/utils/index.js

@@ -1,2 +1,2 @@
-import { _ as Hash, a as use, c as abortIf, d as initializeGlobalContext, f as isClass, i as trait, l as assertFound, n as crc32, o as uses, p as perPage, r as getTraitMethods, s as abort, t as callTraitMethods, u as getModel, v as Encryption } from "../utils-DJQAOLbx.js";
+import { _ as Hash, a as use, c as abortIf, d as initializeGlobalContext, f as isClass, i as trait, l as assertFound, n as crc32, o as uses, p as perPage, r as getTraitMethods, s as abort, t as callTraitMethods, u as getModel, v as Encryption } from "../utils-DEflBOXp.js";
 export { Encryption, Hash, abort, abortIf, assertFound, callTraitMethods, crc32, getModel, getTraitMethods, initializeGlobalContext, isClass, perPage, trait, use, uses };

package/dist/{utils-DJQAOLbx.js → utils-DEflBOXp.js}

@@ -1,16 +1,170 @@
 import { createCipheriv, createDecipheriv, createHash, randomBytes } from "node:crypto";
-import { Arr, Obj, undot } from "@h3ravel/support";
 import { createJiti } from "jiti";
 import { existsSync, readdirSync } from "fs";
 import { Arkstack } from "@arkstack/contract";
+import { Arr, Obj, undot } from "@h3ravel/support";
+import { readdirSync as readdirSync$1 } from "node:fs";
 import { createRequire } from "module";
 import path, { resolve } from "node:path";
+import { config } from "dotenv";
 import { pathToFileURL } from "node:url";
 import { rm } from "node:fs/promises";
 import { spawn } from "node:child_process";
 import { Secret, TOTP } from "otpauth";
 import { compare, genSalt, hash } from "bcryptjs";
 import { getUserConfig } from "arkormx";
+//#region src/ConfigLoader.ts
+const CONFIG_KEY = Symbol("globalConfig");
+globalThis[CONFIG_KEY] = {};
+/**
+* Loads and resolves application configuration from the config directory.
+*
+* Config modules are read once (lazily) from the output directory and cached on
+* a global symbol, then queried by dot-path. A partial config object can also be
+* merged in at runtime.
+*/
+var ConfigLoader = class {
+	/** 
+	* The cached config store, shared across instances via a global symbol.
+	*/
+	get store() {
+		return globalThis[CONFIG_KEY];
+	}
+	set store(value) {
+		globalThis[CONFIG_KEY] = value;
+	}
+	/** 
+	* Read and cache config modules from the config directory on first use.
+	*/
+	load() {
+		if (Object.entries(this.store).length >= 1) return;
+		let files;
+		const require = createRequire(import.meta.url);
+		const configDir = this.resolveConfigDir();
+		try {
+			files = readdirSync$1(configDir, { withFileTypes: true }).filter((file) => {
+				if (file.name.includes("middleware") && globalThis.arkctx?.runtime === "CLI") return false;
+				return file.isFile() && (file.name.endsWith(".js") || file.name.endsWith(".ts"));
+			});
+		} catch {
+			files = [];
+		}
+		Object.assign(this.store, files.reduce((configs, file) => {
+			const configName = path.basename(file.name, path.extname(file.name));
+			try {
+				configs[configName] = require(path.join(file.parentPath, file.name)).default(typeof globalThis.app === "function" ? globalThis.app() : {});
+			} catch (error) {
+				console.warn(`[arkstack] Skipped config "${configName}": ${error.message}`);
+			}
+			return configs;
+		}, {}));
+	}
+	/**
+	* Resolve the directory to load config modules from.
+	*
+	* Prefers an explicit `CONFIG_PATH`, then the environment-selected output
+	* directory. Falls back to the other build output (`dist` ⇄
+	* `.arkstack/build`) so config still loads if the selected directory is
+	* missing or transiently emptied — e.g. a concurrent rebuild (`clean: true`)
+	* during a test run.
+	*/
+	resolveConfigDir() {
+		const root = Arkstack.rootDir();
+		const explicit = env("CONFIG_PATH");
+		if (explicit) return explicit;
+		const candidates = [
+			path.join(outputDir(), "config"),
+			path.join(root, env("OUTPUT_DIR", "dist"), "config"),
+			path.join(root, env("OUTPUT_DIR_DEV", ".arkstack/build"), "config")
+		];
+		return candidates.find((dir) => {
+			try {
+				return readdirSync$1(dir).some((file) => file.endsWith(".js") || file.endsWith(".ts"));
+			} catch {
+				return false;
+			}
+		}) ?? candidates[0];
+	}
+	/**
+	* Resolve configuration: read a dot-path value, merge a partial config
+	* object, or return the whole config.
+	*
+	* @param key           Dot-path to read, or an object to merge in.
+	* @param defaultValue  Returned when a string key is not found.
+	*/
+	resolve(key, defaultValue) {
+		if (typeof globalThis.env === "undefined") globalThis.env = (k, def) => k ? process.env[k] ?? def : process.env;
+		this.load();
+		if (typeof key === "object" && key !== null) this.store = undot(Object.assign({}, Arr.dot(this.store), Arr.dot(key)));
+		else if (typeof key === "string") return Obj.get(this.store, key, defaultValue);
+		return this.store;
+	}
+};
+/** 
+* Shared config loader backing {@link config}.
+*/
+const configLoader = new ConfigLoader();
+//#endregion
+//#region src/EnvLoader.ts
+/**
+* Loads environment variables, reading the `.env` file on first access.
+*
+* The `.env` file is loaded lazily the first time a variable is read, so
+* environment access never depends on a side-effect `import 'dotenv/config'`
+* running first. Import ordering — which linters and bundlers may rewrite —
+* could otherwise place an env-reading module before dotenv has populated
+* `process.env`, leaving that module with default/stale values.
+* `dotenv.config()` never overrides variables already set, so the lazy load is
+* safe alongside other loaders.
+*/
+var EnvLoader = class {
+	loaded = false;
+	/**
+	* Load the `.env` file once.
+	* 
+	* @returns 
+	*/
+	ensureLoaded() {
+		if (this.loaded) return;
+		this.loaded = true;
+		try {
+			config({ quiet: true });
+		} catch {}
+	}
+	/**
+	* Read an environment variable, coercing booleans, numbers and `null`, and
+	* falling back to `defaultValue` when it is unset.
+	*
+	* @param name          The variable name.
+	* @param defaultValue  Returned when the variable is unset.
+	*/
+	get(name, defaultValue) {
+		this.ensureLoaded();
+		let val = process.env[name] ?? "";
+		if ([
+			true,
+			"true",
+			"on",
+			false,
+			"false",
+			"off"
+		].includes(val)) val = [
+			true,
+			"true",
+			"on"
+		].includes(val);
+		if (!isNaN(Number(val)) && typeof val !== "boolean" && typeof val !== "undefined" && val !== "") val = Number(val);
+		if (val === "") val = void 0;
+		if (val === "null") val = null;
+		val ??= defaultValue;
+		return val;
+	}
+};
+/** 
+* Shared environment loader backing {@link env}.
+*/
+const envLoader = new EnvLoader();
+//#endregion
 //#region src/system.ts
 /**
 * Read the .env file
@@ -19,26 +173,7 @@ import { getUserConfig } from "arkormx";
 * @param def
 * @returns
 */
-const env = (env, defaultValue) => {
-	let val = process.env[env] ?? "";
-	if ([
-		true,
-		"true",
-		"on",
-		false,
-		"false",
-		"off"
-	].includes(val)) val = [
-		true,
-		"true",
-		"on"
-	].includes(val);
-	if (!isNaN(Number(val)) && typeof val !== "boolean" && typeof val !== "undefined" && val !== "") val = Number(val);
-	if (val === "") val = void 0;
-	if (val === "null") val = null;
-	val ??= defaultValue;
-	return val;
-};
+const env$1 = (env, defaultValue) => envLoader.get(env, defaultValue);
 /**
 * Build the app url
 *
@@ -46,12 +181,12 @@ const env = (env, defaultValue) => {
 * @returns
 */
 const appUrl = (link) => {
-	const port = env("PORT", env("APP_PORT", "3000"));
+	const port = env$1("PORT", env$1("APP_PORT", "3000"));
 	const defaultUrl = `http://localhost:${port}`;
-	const appUrl = env("APP_URL", `http://localhost:${port}`);
+	const appUrl = env$1("APP_URL", `http://localhost:${port}`);
 	try {
 		const url = new URL(appUrl);
-		if (url.port || url.hostname === "localhost") url.port = port;
+		if (url.port || url.hostname === "localhost") url.port = String(port);
 		const baseUrl = url.toString().replace(/\/$/, "");
 		if (link) return `${baseUrl}${`/${link.replace(/^\/+/, "")}`}`;
 		return baseUrl;
@@ -59,8 +194,6 @@ const appUrl = (link) => {
 		return link ? `${defaultUrl}/${link.replace(/^\/+/, "")}` : defaultUrl;
 	}
 };
-const CONFIG_KEY = Symbol("globalConfig");
-globalThis[CONFIG_KEY] = {};
 /**
 * Gets the application configuration.
 *
@@ -68,35 +201,7 @@ globalThis[CONFIG_KEY] = {};
 * @param defaultValue    The default value to return if the key is not found.
 * @returns               The configuration value.
 */
-const config = (key, defaultValue) => {
-	if (typeof globalThis.env === "undefined") globalThis.env = (key, def) => key ? process.env[key] ?? def : process.env;
-	const config = globalThis[CONFIG_KEY];
-	if (Object.entries(config).length < 1) {
-		let files;
-		const dist = path.relative(Arkstack.rootDir(), outputDir());
-		const require = createRequire(import.meta.url);
-		const configDir = env("CONFIG_PATH", path.join(Arkstack.rootDir(), `${dist}/config`));
-		try {
-			files = readdirSync(configDir, { withFileTypes: true }).filter((file) => {
-				if (file.name.includes("middleware") && globalThis.arkctx?.runtime === "CLI") return false;
-				return file.isFile() && (file.name.endsWith(".js") || file.name.endsWith(".ts"));
-			});
-		} catch {
-			files = [];
-		}
-		Object.assign(config, files.reduce((configs, file) => {
-			const configName = path.basename(file.name, path.extname(file.name));
-			configs[configName] = require(path.join(file.parentPath, file.name)).default(typeof globalThis.app === "function" ? globalThis.app() : {});
-			return configs;
-		}, {}));
-		globalThis[CONFIG_KEY] = config;
-	}
-	if (typeof key === "object" && key !== null) {
-		const config = Object.assign({}, Arr.dot(globalThis[CONFIG_KEY]), Arr.dot(key));
-		globalThis[CONFIG_KEY] = undot(config);
-	} else if (typeof key === "string") return Obj.get(globalThis[CONFIG_KEY], key, defaultValue);
-	return globalThis[CONFIG_KEY];
-};
+const config$1 = (key, defaultValue) => configLoader.resolve(key, defaultValue);
 /**
 * Resolve the unified application key.
 *
@@ -114,13 +219,13 @@ const config = (key, defaultValue) => {
 * @returns       The resolved key, or `undefined` when none is configured.
 */
 const appKey = (legacy = []) => {
-	const explicit = env("APP_KEY");
+	const explicit = env$1("APP_KEY");
 	if (explicit) return explicit;
 	for (const name of Array.isArray(legacy) ? legacy : [legacy]) {
-		const value = env(name);
+		const value = env$1(name);
 		if (value) return value;
 	}
-	return config("app.key") || void 0;
+	return config$1("app.key") || void 0;
 };
 /**
 * Gets the current Node environment (development or production).
@@ -128,7 +233,7 @@ const appKey = (legacy = []) => {
 * @returns
 */
 const nodeEnv = () => {
-	let envValue = env("NODE_ENV", "development");
+	let envValue = env$1("NODE_ENV", "development");
 	if (envValue !== "development" && envValue !== "production") envValue = "development";
 	return envValue === "production" ? "prod" : "dev";
 };
@@ -142,8 +247,8 @@ const outputDir = (cwd) => {
 	cwd ??= Arkstack.rootDir();
 	const NODE_ENV = nodeEnv();
 	const output = {
-		dev: env("OUTPUT_DIR_DEV", ".arkstack/build"),
-		prod: env("OUTPUT_DIR", "dist")
+		dev: env$1("OUTPUT_DIR_DEV", ".arkstack/build"),
+		prod: env$1("OUTPUT_DIR", "dist")
 	};
 	return path.isAbsolute(output[NODE_ENV] ?? output.dev) ? output[NODE_ENV] ?? output.dev : path.join(cwd, output[NODE_ENV] ?? output.dev);
 };
@@ -431,13 +536,13 @@ var Hash = class {
 		return new TOTP({
 			label,
 			digits,
-			issuer: env("APP_NAME", "Roseed"),
+			issuer: env$1("APP_NAME", "Roseed"),
 			algorithm: "SHA1",
 			period,
 			secret: "US3WHSG7X5KAPV27VANWKQHF3SH3HULL"
 		});
 	}
-	static totp(secret, label, issuer = env("APP_NAME", "Roseed"), period = 30) {
+	static totp(secret, label, issuer = env$1("APP_NAME", "Roseed"), period = 30) {
 		return new TOTP({
 			issuer,
 			label,
@@ -800,4 +905,4 @@ function uses(instance, trait) {
 	return false;
 }
 //#endregion
-export { resolveRuntimeDir as A, discoverCommands as C, nodeEnv as D, interopDefault as E, toOutputPath as M, outputDir as O, config as S, importFile as T, Hash as _, use as a, appKey as b, abortIf as c, initializeGlobalContext as d, isClass as f, Exception as g, AppException as h, trait as i, resolveRuntimeModule as j, rebuildOutput as k, assertFound as l, RequestException as m, crc32 as n, uses as o, perPage as p, getTraitMethods as r, abort as s, callTraitMethods as t, getModel as u, Encryption as v, env as w, appUrl as x, CONFIG_KEY as y };
+export { resolveRuntimeModule as A, env$1 as C, outputDir as D, nodeEnv as E, ConfigLoader as F, configLoader as I, EnvLoader as M, envLoader as N, rebuildOutput as O, CONFIG_KEY as P, discoverCommands as S, interopDefault as T, Hash as _, use as a, appUrl as b, abortIf as c, initializeGlobalContext as d, isClass as f, Exception as g, AppException as h, trait as i, toOutputPath as j, resolveRuntimeDir as k, assertFound as l, RequestException as m, crc32 as n, uses as o, perPage as p, getTraitMethods as r, abort as s, callTraitMethods as t, getModel as u, Encryption as v, importFile as w, config$1 as x, appKey as y };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkstack/common",
-  "version": "0.14.18",
+  "version": "0.14.19",
   "type": "module",
   "description": "Core utilities, primitives, and shared infrastructure for the Arkstack ecosystem.",
   "homepage": "https://arkstack.toneflix.net",
@@ -36,14 +36,15 @@
     "bcryptjs": "^3.0.3",
     "chalk": "^5.6.2",
     "detect-port": "^2.1.0",
+    "dotenv": "^17.4.2",
     "otpauth": "^9.5.1",
     "pino": "^10.3.1"
   },
   "peerDependencies": {
     "@h3ravel/support": "^2.2.0",
     "arkormx": "^2.10.1",
-    "@arkstack/foundry": "^0.14.18",
-    "@arkstack/contract": "^0.14.18"
+    "@arkstack/foundry": "^0.14.19",
+    "@arkstack/contract": "^0.14.19"
   },
   "scripts": {
     "build": "tsdown --config-loader unrun",