@theholocron/env-utils 1.5.1 → 1.6.0

package/dist/index.d.mts

@@ -1,4 +1,27 @@
 import "dotenv/config";
+//#region src/create-env-lookup.d.ts
+interface EnvLookup {
+  /** Return the string value for `key`, or `undefined` if absent or empty. */
+  get(key: string): string | undefined;
+}
+/**
+ * Create a lightweight env lookup backed by a fixed source dict or, when
+ * called with no arguments, by a lazy read of `process.env` on every call.
+ *
+ * Use the no-arg form for the application singleton — it always reflects the
+ * current state of `process.env` so tests can mutate it freely:
+ *
+ * @example
+ * // singleton — reads process.env lazily
+ * export const env = createEnvLookup();
+ *
+ * // injectable — tests pass a fake dict
+ * export function makeEnv(source?: Record<string, string | undefined>) {
+ *   return createEnvLookup(source);
+ * }
+ */
+declare function createEnvLookup(source?: Record<string, string | undefined>): EnvLookup;
+//#endregion
 //#region src/types.d.ts
 type Primitive = string | number | boolean;
 type EnvObject = {
@@ -195,4 +218,4 @@ declare function filterByNamespace(raw: Record<string, string | undefined>, name
  */
 declare function mergeNamespaces(raw: Record<string, string | undefined>, namespaces: string[]): Record<string, string | undefined>;
 //#endregion
-export { DEFAULT_ENVIRONMENT, DEPLOYED_ENVIRONMENTS, DotenvLoader, ENVIRONMENTS, type EnvLoader, type EnvObject, type EnvParser, type EnvParserOptions, type Environment, type Primitive, createEnvParser, environment, filterByNamespace, mergeNamespaces };
+export { DEFAULT_ENVIRONMENT, DEPLOYED_ENVIRONMENTS, DotenvLoader, ENVIRONMENTS, type EnvLoader, type EnvLookup, type EnvObject, type EnvParser, type EnvParserOptions, type Environment, type Primitive, createEnvLookup, createEnvParser, environment, filterByNamespace, mergeNamespaces };

package/dist/index.mjs

@@ -1,4 +1,28 @@
 import "dotenv/config";
+//#region src/create-env-lookup.ts
+/**
+* Create a lightweight env lookup backed by a fixed source dict or, when
+* called with no arguments, by a lazy read of `process.env` on every call.
+*
+* Use the no-arg form for the application singleton — it always reflects the
+* current state of `process.env` so tests can mutate it freely:
+*
+* @example
+* // singleton — reads process.env lazily
+* export const env = createEnvLookup();
+*
+* // injectable — tests pass a fake dict
+* export function makeEnv(source?: Record<string, string | undefined>) {
+*   return createEnvLookup(source);
+* }
+*/
+function createEnvLookup(source) {
+	return { get(key) {
+		const val = (source ?? process.env)[key];
+		return typeof val === "string" && val ? val : void 0;
+	} };
+}
+//#endregion
 //#region src/environment.ts
 const ENVIRONMENTS = [
 	"local",
@@ -286,4 +310,4 @@ function createEnvParser(options) {
 	};
 }
 //#endregion
-export { DEFAULT_ENVIRONMENT, DEPLOYED_ENVIRONMENTS, DotenvLoader, ENVIRONMENTS, createEnvParser, environment, filterByNamespace, mergeNamespaces };
+export { DEFAULT_ENVIRONMENT, DEPLOYED_ENVIRONMENTS, DotenvLoader, ENVIRONMENTS, createEnvLookup, createEnvParser, environment, filterByNamespace, mergeNamespaces };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/env-utils",
-  "version": "1.5.1",
+  "version": "1.6.0",
   "description": "Runtime environment detection and typed env-var parsing.",
   "keywords": [
     "env",