@lacspace/env 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lacspace
+
+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/dist/index.cjs

@@ -0,0 +1,148 @@
+'use strict';
+
+// src/index.ts
+var EnvError = class extends Error {
+  constructor(message, issues) {
+    super(message);
+    this.issues = issues;
+    this.name = "EnvError";
+  }
+};
+function fail(key, msg) {
+  throw new Error(`"${key}" ${msg}`);
+}
+function withDefault(raw, key, opts, cast) {
+  if (raw === void 0 || raw === "") {
+    if (opts && "default" in opts && opts.default !== void 0) return opts.default;
+    if (opts?.optional) return void 0;
+    fail(key, "is required but was not set");
+  }
+  return cast(raw);
+}
+function str(opts) {
+  return {
+    parse(raw, key) {
+      if (opts?.allowEmpty && raw === "") return "";
+      return withDefault(raw, key, opts, (v) => v);
+    }
+  };
+}
+function num(opts) {
+  return {
+    parse(raw, key) {
+      return withDefault(raw, key, opts, (v) => {
+        const n = Number(v);
+        if (!Number.isFinite(n)) fail(key, `must be a number, got "${v}"`);
+        if (opts?.min !== void 0 && n < opts.min) fail(key, `must be >= ${opts.min}`);
+        if (opts?.max !== void 0 && n > opts.max) fail(key, `must be <= ${opts.max}`);
+        return n;
+      });
+    }
+  };
+}
+function int(opts) {
+  const base = num(opts);
+  return {
+    parse(raw, key) {
+      const n = base.parse(raw, key);
+      if (n !== void 0 && !Number.isInteger(n)) fail(key, `must be an integer, got "${raw}"`);
+      return n;
+    }
+  };
+}
+function port(opts) {
+  return int({ ...opts, min: 1, max: 65535 });
+}
+function bool(opts) {
+  return {
+    parse(raw, key) {
+      return withDefault(raw, key, opts, (v) => {
+        const s = v.trim().toLowerCase();
+        if (["true", "1", "yes", "on"].includes(s)) return true;
+        if (["false", "0", "no", "off"].includes(s)) return false;
+        fail(key, `must be a boolean, got "${v}"`);
+      });
+    }
+  };
+}
+function url(opts) {
+  return {
+    parse(raw, key) {
+      return withDefault(raw, key, opts, (v) => {
+        try {
+          new URL(v);
+        } catch {
+          fail(key, `must be a valid URL, got "${v}"`);
+        }
+        return v;
+      });
+    }
+  };
+}
+function email(opts) {
+  return {
+    parse(raw, key) {
+      return withDefault(raw, key, opts, (v) => {
+        if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(v)) fail(key, `must be an email, got "${v}"`);
+        return v;
+      });
+    }
+  };
+}
+function oneOf(values, opts) {
+  return {
+    parse(raw, key) {
+      return withDefault(raw, key, opts, (v) => {
+        if (!values.includes(v)) fail(key, `must be one of ${values.join(", ")}, got "${v}"`);
+        return v;
+      });
+    }
+  };
+}
+function json(opts) {
+  return {
+    parse(raw, key) {
+      return withDefault(raw, key, opts, (v) => {
+        try {
+          return JSON.parse(v);
+        } catch {
+          fail(key, "must be valid JSON");
+        }
+      });
+    }
+  };
+}
+var defaultSource = typeof process !== "undefined" && process.env ? process.env : {};
+function createEnv(schema, source = defaultSource) {
+  const out = {};
+  const issues = [];
+  for (const key of Object.keys(schema)) {
+    try {
+      out[key] = schema[key].parse(source[key], key);
+    } catch (e) {
+      issues.push(`  \u2022 ${e.message}`);
+    }
+  }
+  if (issues.length) {
+    throw new EnvError(
+      `Invalid environment variables:
+${issues.join("\n")}`,
+      issues.map((i) => i.trim().replace(/^• /, ""))
+    );
+  }
+  return Object.freeze(out);
+}
+
+exports.EnvError = EnvError;
+exports.bool = bool;
+exports.createEnv = createEnv;
+exports.email = email;
+exports.int = int;
+exports.json = json;
+exports.num = num;
+exports.oneOf = oneOf;
+exports.port = port;
+exports.str = str;
+exports.url = url;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;AAeO,IAAM,QAAA,GAAN,cAAuB,KAAA,CAAM;AAAA,EAClC,WAAA,CACE,SACO,MAAA,EACP;AACA,IAAA,KAAA,CAAM,OAAO,CAAA;AAFN,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAGP,IAAA,IAAA,CAAK,IAAA,GAAO,UAAA;AAAA,EACd;AACF;AAEA,SAAS,IAAA,CAAK,KAAa,GAAA,EAAoB;AAC7C,EAAA,MAAM,IAAI,KAAA,CAAM,CAAA,CAAA,EAAI,GAAG,CAAA,EAAA,EAAK,GAAG,CAAA,CAAE,CAAA;AACnC;AAOA,SAAS,WAAA,CACP,GAAA,EACA,GAAA,EACA,IAAA,EACA,IAAA,EACG;AACH,EAAA,IAAI,GAAA,KAAQ,MAAA,IAAa,GAAA,KAAQ,EAAA,EAAI;AACnC,IAAA,IAAI,QAAQ,SAAA,IAAa,IAAA,IAAQ,KAAK,OAAA,KAAY,MAAA,SAAkB,IAAA,CAAK,OAAA;AACzE,IAAA,IAAI,IAAA,EAAM,UAAU,OAAO,MAAA;AAC3B,IAAA,IAAA,CAAK,KAAK,6BAA6B,CAAA;AAAA,EACzC;AACA,EAAA,OAAO,KAAK,GAAG,CAAA;AACjB;AAGO,SAAS,IAAI,IAAA,EAAuE;AACzF,EAAA,OAAO;AAAA,IACL,KAAA,CAAM,KAAK,GAAA,EAAK;AACd,MAAA,IAAI,IAAA,EAAM,UAAA,IAAc,GAAA,KAAQ,EAAA,EAAI,OAAO,EAAA;AAC3C,MAAA,OAAO,YAAY,GAAA,EAAK,GAAA,EAAK,IAAA,EAAM,CAAC,MAAM,CAAC,CAAA;AAAA,IAC7C;AAAA,GACF;AACF;AAGO,SAAS,IAAI,IAAA,EAA6E;AAC/F,EAAA,OAAO;AAAA,IACL,KAAA,CAAM,KAAK,GAAA,EAAK;AACd,MAAA,OAAO,WAAA,CAAY,GAAA,EAAK,GAAA,EAAK,IAAA,EAAM,CAAC,CAAA,KAAM;AACxC,QAAA,MAAM,CAAA,GAAI,OAAO,CAAC,CAAA;AAClB,QAAA,IAAI,CAAC,OAAO,QAAA,CAAS,CAAC,GAAG,IAAA,CAAK,GAAA,EAAK,CAAA,uBAAA,EAA0B,CAAC,CAAA,CAAA,CAAG,CAAA;AACjE,QAAA,IAAI,IAAA,EAAM,GAAA,KAAQ,MAAA,IAAa,CAAA,GAAI,IAAA,CAAK,GAAA,EAAK,IAAA,CAAK,GAAA,EAAK,CAAA,WAAA,EAAc,IAAA,CAAK,GAAG,CAAA,CAAE,CAAA;AAC/E,QAAA,IAAI,IAAA,EAAM,GAAA,KAAQ,MAAA,IAAa,CAAA,GAAI,IAAA,CAAK,GAAA,EAAK,IAAA,CAAK,GAAA,EAAK,CAAA,WAAA,EAAc,IAAA,CAAK,GAAG,CAAA,CAAE,CAAA;AAC/E,QAAA,OAAO,CAAA;AAAA,MACT,CAAC,CAAA;AAAA,IACH;AAAA,GACF;AACF;AAGO,SAAS,IAAI,IAAA,EAA6E;AAC/F,EAAA,MAAM,IAAA,GAAO,IAAI,IAAI,CAAA;AACrB,EAAA,OAAO;AAAA,IACL,KAAA,CAAM,KAAK,GAAA,EAAK;AACd,MAAA,MAAM,CAAA,GAAI,IAAA,CAAK,KAAA,CAAM,GAAA,EAAK,GAAG,CAAA;AAC7B,MAAA,IAAI,CAAA,KAAM,MAAA,IAAa,CAAC,MAAA,CAAO,SAAA,CAAU,CAAC,CAAA,EAAG,IAAA,CAAK,GAAA,EAAK,CAAA,yBAAA,EAA4B,GAAG,CAAA,CAAA,CAAG,CAAA;AACzF,MAAA,OAAO,CAAA;AAAA,IACT;AAAA,GACF;AACF;AAGO,SAAS,KAAK,IAAA,EAA4C;AAC/D,EAAA,OAAO,GAAA,CAAI,EAAE,GAAG,IAAA,EAAM,KAAK,CAAA,EAAG,GAAA,EAAK,OAAO,CAAA;AAC5C;AAGO,SAAS,KAAK,IAAA,EAA8C;AACjE,EAAA,OAAO;AAAA,IACL,KAAA,CAAM,KAAK,GAAA,EAAK;AACd,MAAA,OAAO,WAAA,CAAY,GAAA,EAAK,GAAA,EAAK,IAAA,EAAM,CAAC,CAAA,KAAM;AACxC,QAAA,MAAM,CAAA,GAAI,CAAA,CAAE,IAAA,EAAK,CAAE,WAAA,EAAY;AAC/B,QAAA,IAAI,CAAC,QAAQ,GAAA,EAAK,KAAA,EAAO,IAAI,CAAA,CAAE,QAAA,CAAS,CAAC,CAAA,EAAG,OAAO,IAAA;AACnD,QAAA,IAAI,CAAC,SAAS,GAAA,EAAK,IAAA,EAAM,KAAK,CAAA,CAAE,QAAA,CAAS,CAAC,CAAA,EAAG,OAAO,KAAA;AACpD,QAAA,IAAA,CAAK,GAAA,EAAK,CAAA,wBAAA,EAA2B,CAAC,CAAA,CAAA,CAAG,CAAA;AAAA,MAC3C,CAAC,CAAA;AAAA,IACH;AAAA,GACF;AACF;AAGO,SAAS,IAAI,IAAA,EAA4C;AAC9D,EAAA,OAAO;AAAA,IACL,KAAA,CAAM,KAAK,GAAA,EAAK;AACd,MAAA,OAAO,WAAA,CAAY,GAAA,EAAK,GAAA,EAAK,IAAA,EAAM,CAAC,CAAA,KAAM;AACxC,QAAA,IAAI;AACF,UAAA,IAAI,IAAI,CAAC,CAAA;AAAA,QACX,CAAA,CAAA,MAAQ;AACN,UAAA,IAAA,CAAK,GAAA,EAAK,CAAA,0BAAA,EAA6B,CAAC,CAAA,CAAA,CAAG,CAAA;AAAA,QAC7C;AACA,QAAA,OAAO,CAAA;AAAA,MACT,CAAC,CAAA;AAAA,IACH;AAAA,GACF;AACF;AAGO,SAAS,MAAM,IAAA,EAA4C;AAChE,EAAA,OAAO;AAAA,IACL,KAAA,CAAM,KAAK,GAAA,EAAK;AACd,MAAA,OAAO,WAAA,CAAY,GAAA,EAAK,GAAA,EAAK,IAAA,EAAM,CAAC,CAAA,KAAM;AACxC,QAAA,IAAI,CAAC,6BAA6B,IAAA,CAAK,CAAC,GAAG,IAAA,CAAK,GAAA,EAAK,CAAA,uBAAA,EAA0B,CAAC,CAAA,CAAA,CAAG,CAAA;AACnF,QAAA,OAAO,CAAA;AAAA,MACT,CAAC,CAAA;AAAA,IACH;AAAA,GACF;AACF;AAGO,SAAS,KAAA,CACd,QACA,IAAA,EACc;AACd,EAAA,OAAO;AAAA,IACL,KAAA,CAAM,KAAK,GAAA,EAAK;AACd,MAAA,OAAO,WAAA,CAAY,GAAA,EAAK,GAAA,EAAK,IAAA,EAAM,CAAC,CAAA,KAAM;AACxC,QAAA,IAAI,CAAC,MAAA,CAAO,QAAA,CAAS,CAAM,GAAG,IAAA,CAAK,GAAA,EAAK,CAAA,eAAA,EAAkB,MAAA,CAAO,IAAA,CAAK,IAAI,CAAC,CAAA,OAAA,EAAU,CAAC,CAAA,CAAA,CAAG,CAAA;AACzF,QAAA,OAAO,CAAA;AAAA,MACT,CAAC,CAAA;AAAA,IACH;AAAA,GACF;AACF;AAGO,SAAS,KAAkB,IAAA,EAAkC;AAClE,EAAA,OAAO;AAAA,IACL,KAAA,CAAM,KAAK,GAAA,EAAK;AACd,MAAA,OAAO,WAAA,CAAY,GAAA,EAAK,GAAA,EAAK,IAAA,EAAM,CAAC,CAAA,KAAM;AACxC,QAAA,IAAI;AACF,UAAA,OAAO,IAAA,CAAK,MAAM,CAAC,CAAA;AAAA,QACrB,CAAA,CAAA,MAAQ;AACN,UAAA,IAAA,CAAK,KAAK,oBAAoB,CAAA;AAAA,QAChC;AAAA,MACF,CAAC,CAAA;AAAA,IACH;AAAA,GACF;AACF;AAMA,IAAM,aAAA,GACJ,OAAO,OAAA,KAAY,WAAA,IAAe,QAAQ,GAAA,GAAM,OAAA,CAAQ,MAAM,EAAC;AAa1D,SAAS,SAAA,CACd,MAAA,EACA,MAAA,GAA6C,aAAA,EAChC;AACb,EAAA,MAAM,MAA+B,EAAC;AACtC,EAAA,MAAM,SAAmB,EAAC;AAC1B,EAAA,KAAA,MAAW,GAAA,IAAO,MAAA,CAAO,IAAA,CAAK,MAAM,CAAA,EAAG;AACrC,IAAA,IAAI;AACF,MAAA,GAAA,CAAI,GAAG,IAAI,MAAA,CAAO,GAAG,EAAG,KAAA,CAAM,MAAA,CAAO,GAAG,CAAA,EAAG,GAAG,CAAA;AAAA,IAChD,SAAS,CAAA,EAAG;AACV,MAAA,MAAA,CAAO,IAAA,CAAK,CAAA,SAAA,EAAQ,CAAA,CAAY,OAAO,CAAA,CAAE,CAAA;AAAA,IAC3C;AAAA,EACF;AACA,EAAA,IAAI,OAAO,MAAA,EAAQ;AACjB,IAAA,MAAM,IAAI,QAAA;AAAA,MACR,CAAA;AAAA,EAAmC,MAAA,CAAO,IAAA,CAAK,IAAI,CAAC,CAAA,CAAA;AAAA,MACpD,MAAA,CAAO,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,CAAE,MAAK,CAAE,OAAA,CAAQ,KAAA,EAAO,EAAE,CAAC;AAAA,KAC/C;AAAA,EACF;AACA,EAAA,OAAO,MAAA,CAAO,OAAO,GAAG,CAAA;AAC1B","file":"index.cjs","sourcesContent":["/**\n * @lacspace/env\n * Typed, validated environment variables — fail fast at boot.\n *\n * Declare a schema, validate `process.env` once at startup, and get a typed,\n * frozen object back. Missing or malformed variables throw a single, clear\n * error listing everything that's wrong — before your app serves traffic.\n *\n * Zero dependencies · isomorphic · fully typed.\n */\n\nexport interface Validator<T> {\n  parse(raw: string | undefined, key: string): T;\n}\n\nexport class EnvError extends Error {\n  constructor(\n    message: string,\n    public issues: string[],\n  ) {\n    super(message);\n    this.name = \"EnvError\";\n  }\n}\n\nfunction fail(key: string, msg: string): never {\n  throw new Error(`\"${key}\" ${msg}`);\n}\n\ninterface BaseOpts<T> {\n  default?: T;\n  optional?: boolean;\n}\n\nfunction withDefault<T>(\n  raw: string | undefined,\n  key: string,\n  opts: BaseOpts<T> | undefined,\n  cast: (v: string) => T,\n): T {\n  if (raw === undefined || raw === \"\") {\n    if (opts && \"default\" in opts && opts.default !== undefined) return opts.default;\n    if (opts?.optional) return undefined as unknown as T;\n    fail(key, \"is required but was not set\");\n  }\n  return cast(raw);\n}\n\n/** A string. `allowEmpty` keeps \"\"; otherwise empty is treated as missing. */\nexport function str(opts?: BaseOpts<string> & { allowEmpty?: boolean }): Validator<string> {\n  return {\n    parse(raw, key) {\n      if (opts?.allowEmpty && raw === \"\") return \"\";\n      return withDefault(raw, key, opts, (v) => v);\n    },\n  };\n}\n\n/** A number (integer or float). */\nexport function num(opts?: BaseOpts<number> & { min?: number; max?: number }): Validator<number> {\n  return {\n    parse(raw, key) {\n      return withDefault(raw, key, opts, (v) => {\n        const n = Number(v);\n        if (!Number.isFinite(n)) fail(key, `must be a number, got \"${v}\"`);\n        if (opts?.min !== undefined && n < opts.min) fail(key, `must be >= ${opts.min}`);\n        if (opts?.max !== undefined && n > opts.max) fail(key, `must be <= ${opts.max}`);\n        return n;\n      });\n    },\n  };\n}\n\n/** An integer. */\nexport function int(opts?: BaseOpts<number> & { min?: number; max?: number }): Validator<number> {\n  const base = num(opts);\n  return {\n    parse(raw, key) {\n      const n = base.parse(raw, key);\n      if (n !== undefined && !Number.isInteger(n)) fail(key, `must be an integer, got \"${raw}\"`);\n      return n;\n    },\n  };\n}\n\n/** A TCP port (1–65535). */\nexport function port(opts?: BaseOpts<number>): Validator<number> {\n  return int({ ...opts, min: 1, max: 65535 });\n}\n\n/** A boolean. Accepts true/1/yes/on and false/0/no/off (case-insensitive). */\nexport function bool(opts?: BaseOpts<boolean>): Validator<boolean> {\n  return {\n    parse(raw, key) {\n      return withDefault(raw, key, opts, (v) => {\n        const s = v.trim().toLowerCase();\n        if ([\"true\", \"1\", \"yes\", \"on\"].includes(s)) return true;\n        if ([\"false\", \"0\", \"no\", \"off\"].includes(s)) return false;\n        fail(key, `must be a boolean, got \"${v}\"`);\n      });\n    },\n  };\n}\n\n/** A valid URL string. */\nexport function url(opts?: BaseOpts<string>): Validator<string> {\n  return {\n    parse(raw, key) {\n      return withDefault(raw, key, opts, (v) => {\n        try {\n          new URL(v);\n        } catch {\n          fail(key, `must be a valid URL, got \"${v}\"`);\n        }\n        return v;\n      });\n    },\n  };\n}\n\n/** A plausible email address. */\nexport function email(opts?: BaseOpts<string>): Validator<string> {\n  return {\n    parse(raw, key) {\n      return withDefault(raw, key, opts, (v) => {\n        if (!/^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(v)) fail(key, `must be an email, got \"${v}\"`);\n        return v;\n      });\n    },\n  };\n}\n\n/** One of a fixed set of string values. */\nexport function oneOf<const T extends string>(\n  values: readonly T[],\n  opts?: BaseOpts<T>,\n): Validator<T> {\n  return {\n    parse(raw, key) {\n      return withDefault(raw, key, opts, (v) => {\n        if (!values.includes(v as T)) fail(key, `must be one of ${values.join(\", \")}, got \"${v}\"`);\n        return v as T;\n      });\n    },\n  };\n}\n\n/** JSON-parsed value. */\nexport function json<T = unknown>(opts?: BaseOpts<T>): Validator<T> {\n  return {\n    parse(raw, key) {\n      return withDefault(raw, key, opts, (v) => {\n        try {\n          return JSON.parse(v) as T;\n        } catch {\n          fail(key, \"must be valid JSON\");\n        }\n      });\n    },\n  };\n}\n\nexport type InferEnv<S extends Record<string, Validator<unknown>>> = {\n  readonly [K in keyof S]: S[K] extends Validator<infer T> ? T : never;\n};\n\nconst defaultSource: Record<string, string | undefined> =\n  typeof process !== \"undefined\" && process.env ? process.env : {};\n\n/**\n * Validate a schema against a source (defaults to `process.env`) and return a\n * typed, frozen object. Throws a single {@link EnvError} listing every problem.\n * @example\n * export const env = createEnv({\n *   NODE_ENV: oneOf([\"development\", \"production\", \"test\"], { default: \"development\" }),\n *   PORT: port({ default: 3000 }),\n *   DATABASE_URL: url(),\n *   DEBUG: bool({ default: false }),\n * });\n */\nexport function createEnv<S extends Record<string, Validator<unknown>>>(\n  schema: S,\n  source: Record<string, string | undefined> = defaultSource,\n): InferEnv<S> {\n  const out: Record<string, unknown> = {};\n  const issues: string[] = [];\n  for (const key of Object.keys(schema)) {\n    try {\n      out[key] = schema[key]!.parse(source[key], key);\n    } catch (e) {\n      issues.push(`  • ${(e as Error).message}`);\n    }\n  }\n  if (issues.length) {\n    throw new EnvError(\n      `Invalid environment variables:\\n${issues.join(\"\\n\")}`,\n      issues.map((i) => i.trim().replace(/^• /, \"\")),\n    );\n  }\n  return Object.freeze(out) as InferEnv<S>;\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,64 @@
+/**
+ * @lacspace/env
+ * Typed, validated environment variables — fail fast at boot.
+ *
+ * Declare a schema, validate `process.env` once at startup, and get a typed,
+ * frozen object back. Missing or malformed variables throw a single, clear
+ * error listing everything that's wrong — before your app serves traffic.
+ *
+ * Zero dependencies · isomorphic · fully typed.
+ */
+interface Validator<T> {
+    parse(raw: string | undefined, key: string): T;
+}
+declare class EnvError extends Error {
+    issues: string[];
+    constructor(message: string, issues: string[]);
+}
+interface BaseOpts<T> {
+    default?: T;
+    optional?: boolean;
+}
+/** A string. `allowEmpty` keeps ""; otherwise empty is treated as missing. */
+declare function str(opts?: BaseOpts<string> & {
+    allowEmpty?: boolean;
+}): Validator<string>;
+/** A number (integer or float). */
+declare function num(opts?: BaseOpts<number> & {
+    min?: number;
+    max?: number;
+}): Validator<number>;
+/** An integer. */
+declare function int(opts?: BaseOpts<number> & {
+    min?: number;
+    max?: number;
+}): Validator<number>;
+/** A TCP port (1–65535). */
+declare function port(opts?: BaseOpts<number>): Validator<number>;
+/** A boolean. Accepts true/1/yes/on and false/0/no/off (case-insensitive). */
+declare function bool(opts?: BaseOpts<boolean>): Validator<boolean>;
+/** A valid URL string. */
+declare function url(opts?: BaseOpts<string>): Validator<string>;
+/** A plausible email address. */
+declare function email(opts?: BaseOpts<string>): Validator<string>;
+/** One of a fixed set of string values. */
+declare function oneOf<const T extends string>(values: readonly T[], opts?: BaseOpts<T>): Validator<T>;
+/** JSON-parsed value. */
+declare function json<T = unknown>(opts?: BaseOpts<T>): Validator<T>;
+type InferEnv<S extends Record<string, Validator<unknown>>> = {
+    readonly [K in keyof S]: S[K] extends Validator<infer T> ? T : never;
+};
+/**
+ * Validate a schema against a source (defaults to `process.env`) and return a
+ * typed, frozen object. Throws a single {@link EnvError} listing every problem.
+ * @example
+ * export const env = createEnv({
+ *   NODE_ENV: oneOf(["development", "production", "test"], { default: "development" }),
+ *   PORT: port({ default: 3000 }),
+ *   DATABASE_URL: url(),
+ *   DEBUG: bool({ default: false }),
+ * });
+ */
+declare function createEnv<S extends Record<string, Validator<unknown>>>(schema: S, source?: Record<string, string | undefined>): InferEnv<S>;
+
+export { EnvError, type InferEnv, type Validator, bool, createEnv, email, int, json, num, oneOf, port, str, url };

package/dist/index.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @lacspace/env
+ * Typed, validated environment variables — fail fast at boot.
+ *
+ * Declare a schema, validate `process.env` once at startup, and get a typed,
+ * frozen object back. Missing or malformed variables throw a single, clear
+ * error listing everything that's wrong — before your app serves traffic.
+ *
+ * Zero dependencies · isomorphic · fully typed.
+ */
+interface Validator<T> {
+    parse(raw: string | undefined, key: string): T;
+}
+declare class EnvError extends Error {
+    issues: string[];
+    constructor(message: string, issues: string[]);
+}
+interface BaseOpts<T> {
+    default?: T;
+    optional?: boolean;
+}
+/** A string. `allowEmpty` keeps ""; otherwise empty is treated as missing. */
+declare function str(opts?: BaseOpts<string> & {
+    allowEmpty?: boolean;
+}): Validator<string>;
+/** A number (integer or float). */
+declare function num(opts?: BaseOpts<number> & {
+    min?: number;
+    max?: number;
+}): Validator<number>;
+/** An integer. */
+declare function int(opts?: BaseOpts<number> & {
+    min?: number;
+    max?: number;
+}): Validator<number>;
+/** A TCP port (1–65535). */
+declare function port(opts?: BaseOpts<number>): Validator<number>;
+/** A boolean. Accepts true/1/yes/on and false/0/no/off (case-insensitive). */
+declare function bool(opts?: BaseOpts<boolean>): Validator<boolean>;
+/** A valid URL string. */
+declare function url(opts?: BaseOpts<string>): Validator<string>;
+/** A plausible email address. */
+declare function email(opts?: BaseOpts<string>): Validator<string>;
+/** One of a fixed set of string values. */
+declare function oneOf<const T extends string>(values: readonly T[], opts?: BaseOpts<T>): Validator<T>;
+/** JSON-parsed value. */
+declare function json<T = unknown>(opts?: BaseOpts<T>): Validator<T>;
+type InferEnv<S extends Record<string, Validator<unknown>>> = {
+    readonly [K in keyof S]: S[K] extends Validator<infer T> ? T : never;
+};
+/**
+ * Validate a schema against a source (defaults to `process.env`) and return a
+ * typed, frozen object. Throws a single {@link EnvError} listing every problem.
+ * @example
+ * export const env = createEnv({
+ *   NODE_ENV: oneOf(["development", "production", "test"], { default: "development" }),
+ *   PORT: port({ default: 3000 }),
+ *   DATABASE_URL: url(),
+ *   DEBUG: bool({ default: false }),
+ * });
+ */
+declare function createEnv<S extends Record<string, Validator<unknown>>>(schema: S, source?: Record<string, string | undefined>): InferEnv<S>;
+
+export { EnvError, type InferEnv, type Validator, bool, createEnv, email, int, json, num, oneOf, port, str, url };

package/dist/index.js

@@ -0,0 +1,136 @@
+// src/index.ts
+var EnvError = class extends Error {
+  constructor(message, issues) {
+    super(message);
+    this.issues = issues;
+    this.name = "EnvError";
+  }
+};
+function fail(key, msg) {
+  throw new Error(`"${key}" ${msg}`);
+}
+function withDefault(raw, key, opts, cast) {
+  if (raw === void 0 || raw === "") {
+    if (opts && "default" in opts && opts.default !== void 0) return opts.default;
+    if (opts?.optional) return void 0;
+    fail(key, "is required but was not set");
+  }
+  return cast(raw);
+}
+function str(opts) {
+  return {
+    parse(raw, key) {
+      if (opts?.allowEmpty && raw === "") return "";
+      return withDefault(raw, key, opts, (v) => v);
+    }
+  };
+}
+function num(opts) {
+  return {
+    parse(raw, key) {
+      return withDefault(raw, key, opts, (v) => {
+        const n = Number(v);
+        if (!Number.isFinite(n)) fail(key, `must be a number, got "${v}"`);
+        if (opts?.min !== void 0 && n < opts.min) fail(key, `must be >= ${opts.min}`);
+        if (opts?.max !== void 0 && n > opts.max) fail(key, `must be <= ${opts.max}`);
+        return n;
+      });
+    }
+  };
+}
+function int(opts) {
+  const base = num(opts);
+  return {
+    parse(raw, key) {
+      const n = base.parse(raw, key);
+      if (n !== void 0 && !Number.isInteger(n)) fail(key, `must be an integer, got "${raw}"`);
+      return n;
+    }
+  };
+}
+function port(opts) {
+  return int({ ...opts, min: 1, max: 65535 });
+}
+function bool(opts) {
+  return {
+    parse(raw, key) {
+      return withDefault(raw, key, opts, (v) => {
+        const s = v.trim().toLowerCase();
+        if (["true", "1", "yes", "on"].includes(s)) return true;
+        if (["false", "0", "no", "off"].includes(s)) return false;
+        fail(key, `must be a boolean, got "${v}"`);
+      });
+    }
+  };
+}
+function url(opts) {
+  return {
+    parse(raw, key) {
+      return withDefault(raw, key, opts, (v) => {
+        try {
+          new URL(v);
+        } catch {
+          fail(key, `must be a valid URL, got "${v}"`);
+        }
+        return v;
+      });
+    }
+  };
+}
+function email(opts) {
+  return {
+    parse(raw, key) {
+      return withDefault(raw, key, opts, (v) => {
+        if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(v)) fail(key, `must be an email, got "${v}"`);
+        return v;
+      });
+    }
+  };
+}
+function oneOf(values, opts) {
+  return {
+    parse(raw, key) {
+      return withDefault(raw, key, opts, (v) => {
+        if (!values.includes(v)) fail(key, `must be one of ${values.join(", ")}, got "${v}"`);
+        return v;
+      });
+    }
+  };
+}
+function json(opts) {
+  return {
+    parse(raw, key) {
+      return withDefault(raw, key, opts, (v) => {
+        try {
+          return JSON.parse(v);
+        } catch {
+          fail(key, "must be valid JSON");
+        }
+      });
+    }
+  };
+}
+var defaultSource = typeof process !== "undefined" && process.env ? process.env : {};
+function createEnv(schema, source = defaultSource) {
+  const out = {};
+  const issues = [];
+  for (const key of Object.keys(schema)) {
+    try {
+      out[key] = schema[key].parse(source[key], key);
+    } catch (e) {
+      issues.push(`  \u2022 ${e.message}`);
+    }
+  }
+  if (issues.length) {
+    throw new EnvError(
+      `Invalid environment variables:
+${issues.join("\n")}`,
+      issues.map((i) => i.trim().replace(/^• /, ""))
+    );
+  }
+  return Object.freeze(out);
+}
+
+export { EnvError, bool, createEnv, email, int, json, num, oneOf, port, str, url };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";AAeO,IAAM,QAAA,GAAN,cAAuB,KAAA,CAAM;AAAA,EAClC,WAAA,CACE,SACO,MAAA,EACP;AACA,IAAA,KAAA,CAAM,OAAO,CAAA;AAFN,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAGP,IAAA,IAAA,CAAK,IAAA,GAAO,UAAA;AAAA,EACd;AACF;AAEA,SAAS,IAAA,CAAK,KAAa,GAAA,EAAoB;AAC7C,EAAA,MAAM,IAAI,KAAA,CAAM,CAAA,CAAA,EAAI,GAAG,CAAA,EAAA,EAAK,GAAG,CAAA,CAAE,CAAA;AACnC;AAOA,SAAS,WAAA,CACP,GAAA,EACA,GAAA,EACA,IAAA,EACA,IAAA,EACG;AACH,EAAA,IAAI,GAAA,KAAQ,MAAA,IAAa,GAAA,KAAQ,EAAA,EAAI;AACnC,IAAA,IAAI,QAAQ,SAAA,IAAa,IAAA,IAAQ,KAAK,OAAA,KAAY,MAAA,SAAkB,IAAA,CAAK,OAAA;AACzE,IAAA,IAAI,IAAA,EAAM,UAAU,OAAO,MAAA;AAC3B,IAAA,IAAA,CAAK,KAAK,6BAA6B,CAAA;AAAA,EACzC;AACA,EAAA,OAAO,KAAK,GAAG,CAAA;AACjB;AAGO,SAAS,IAAI,IAAA,EAAuE;AACzF,EAAA,OAAO;AAAA,IACL,KAAA,CAAM,KAAK,GAAA,EAAK;AACd,MAAA,IAAI,IAAA,EAAM,UAAA,IAAc,GAAA,KAAQ,EAAA,EAAI,OAAO,EAAA;AAC3C,MAAA,OAAO,YAAY,GAAA,EAAK,GAAA,EAAK,IAAA,EAAM,CAAC,MAAM,CAAC,CAAA;AAAA,IAC7C;AAAA,GACF;AACF;AAGO,SAAS,IAAI,IAAA,EAA6E;AAC/F,EAAA,OAAO;AAAA,IACL,KAAA,CAAM,KAAK,GAAA,EAAK;AACd,MAAA,OAAO,WAAA,CAAY,GAAA,EAAK,GAAA,EAAK,IAAA,EAAM,CAAC,CAAA,KAAM;AACxC,QAAA,MAAM,CAAA,GAAI,OAAO,CAAC,CAAA;AAClB,QAAA,IAAI,CAAC,OAAO,QAAA,CAAS,CAAC,GAAG,IAAA,CAAK,GAAA,EAAK,CAAA,uBAAA,EAA0B,CAAC,CAAA,CAAA,CAAG,CAAA;AACjE,QAAA,IAAI,IAAA,EAAM,GAAA,KAAQ,MAAA,IAAa,CAAA,GAAI,IAAA,CAAK,GAAA,EAAK,IAAA,CAAK,GAAA,EAAK,CAAA,WAAA,EAAc,IAAA,CAAK,GAAG,CAAA,CAAE,CAAA;AAC/E,QAAA,IAAI,IAAA,EAAM,GAAA,KAAQ,MAAA,IAAa,CAAA,GAAI,IAAA,CAAK,GAAA,EAAK,IAAA,CAAK,GAAA,EAAK,CAAA,WAAA,EAAc,IAAA,CAAK,GAAG,CAAA,CAAE,CAAA;AAC/E,QAAA,OAAO,CAAA;AAAA,MACT,CAAC,CAAA;AAAA,IACH;AAAA,GACF;AACF;AAGO,SAAS,IAAI,IAAA,EAA6E;AAC/F,EAAA,MAAM,IAAA,GAAO,IAAI,IAAI,CAAA;AACrB,EAAA,OAAO;AAAA,IACL,KAAA,CAAM,KAAK,GAAA,EAAK;AACd,MAAA,MAAM,CAAA,GAAI,IAAA,CAAK,KAAA,CAAM,GAAA,EAAK,GAAG,CAAA;AAC7B,MAAA,IAAI,CAAA,KAAM,MAAA,IAAa,CAAC,MAAA,CAAO,SAAA,CAAU,CAAC,CAAA,EAAG,IAAA,CAAK,GAAA,EAAK,CAAA,yBAAA,EAA4B,GAAG,CAAA,CAAA,CAAG,CAAA;AACzF,MAAA,OAAO,CAAA;AAAA,IACT;AAAA,GACF;AACF;AAGO,SAAS,KAAK,IAAA,EAA4C;AAC/D,EAAA,OAAO,GAAA,CAAI,EAAE,GAAG,IAAA,EAAM,KAAK,CAAA,EAAG,GAAA,EAAK,OAAO,CAAA;AAC5C;AAGO,SAAS,KAAK,IAAA,EAA8C;AACjE,EAAA,OAAO;AAAA,IACL,KAAA,CAAM,KAAK,GAAA,EAAK;AACd,MAAA,OAAO,WAAA,CAAY,GAAA,EAAK,GAAA,EAAK,IAAA,EAAM,CAAC,CAAA,KAAM;AACxC,QAAA,MAAM,CAAA,GAAI,CAAA,CAAE,IAAA,EAAK,CAAE,WAAA,EAAY;AAC/B,QAAA,IAAI,CAAC,QAAQ,GAAA,EAAK,KAAA,EAAO,IAAI,CAAA,CAAE,QAAA,CAAS,CAAC,CAAA,EAAG,OAAO,IAAA;AACnD,QAAA,IAAI,CAAC,SAAS,GAAA,EAAK,IAAA,EAAM,KAAK,CAAA,CAAE,QAAA,CAAS,CAAC,CAAA,EAAG,OAAO,KAAA;AACpD,QAAA,IAAA,CAAK,GAAA,EAAK,CAAA,wBAAA,EAA2B,CAAC,CAAA,CAAA,CAAG,CAAA;AAAA,MAC3C,CAAC,CAAA;AAAA,IACH;AAAA,GACF;AACF;AAGO,SAAS,IAAI,IAAA,EAA4C;AAC9D,EAAA,OAAO;AAAA,IACL,KAAA,CAAM,KAAK,GAAA,EAAK;AACd,MAAA,OAAO,WAAA,CAAY,GAAA,EAAK,GAAA,EAAK,IAAA,EAAM,CAAC,CAAA,KAAM;AACxC,QAAA,IAAI;AACF,UAAA,IAAI,IAAI,CAAC,CAAA;AAAA,QACX,CAAA,CAAA,MAAQ;AACN,UAAA,IAAA,CAAK,GAAA,EAAK,CAAA,0BAAA,EAA6B,CAAC,CAAA,CAAA,CAAG,CAAA;AAAA,QAC7C;AACA,QAAA,OAAO,CAAA;AAAA,MACT,CAAC,CAAA;AAAA,IACH;AAAA,GACF;AACF;AAGO,SAAS,MAAM,IAAA,EAA4C;AAChE,EAAA,OAAO;AAAA,IACL,KAAA,CAAM,KAAK,GAAA,EAAK;AACd,MAAA,OAAO,WAAA,CAAY,GAAA,EAAK,GAAA,EAAK,IAAA,EAAM,CAAC,CAAA,KAAM;AACxC,QAAA,IAAI,CAAC,6BAA6B,IAAA,CAAK,CAAC,GAAG,IAAA,CAAK,GAAA,EAAK,CAAA,uBAAA,EAA0B,CAAC,CAAA,CAAA,CAAG,CAAA;AACnF,QAAA,OAAO,CAAA;AAAA,MACT,CAAC,CAAA;AAAA,IACH;AAAA,GACF;AACF;AAGO,SAAS,KAAA,CACd,QACA,IAAA,EACc;AACd,EAAA,OAAO;AAAA,IACL,KAAA,CAAM,KAAK,GAAA,EAAK;AACd,MAAA,OAAO,WAAA,CAAY,GAAA,EAAK,GAAA,EAAK,IAAA,EAAM,CAAC,CAAA,KAAM;AACxC,QAAA,IAAI,CAAC,MAAA,CAAO,QAAA,CAAS,CAAM,GAAG,IAAA,CAAK,GAAA,EAAK,CAAA,eAAA,EAAkB,MAAA,CAAO,IAAA,CAAK,IAAI,CAAC,CAAA,OAAA,EAAU,CAAC,CAAA,CAAA,CAAG,CAAA;AACzF,QAAA,OAAO,CAAA;AAAA,MACT,CAAC,CAAA;AAAA,IACH;AAAA,GACF;AACF;AAGO,SAAS,KAAkB,IAAA,EAAkC;AAClE,EAAA,OAAO;AAAA,IACL,KAAA,CAAM,KAAK,GAAA,EAAK;AACd,MAAA,OAAO,WAAA,CAAY,GAAA,EAAK,GAAA,EAAK,IAAA,EAAM,CAAC,CAAA,KAAM;AACxC,QAAA,IAAI;AACF,UAAA,OAAO,IAAA,CAAK,MAAM,CAAC,CAAA;AAAA,QACrB,CAAA,CAAA,MAAQ;AACN,UAAA,IAAA,CAAK,KAAK,oBAAoB,CAAA;AAAA,QAChC;AAAA,MACF,CAAC,CAAA;AAAA,IACH;AAAA,GACF;AACF;AAMA,IAAM,aAAA,GACJ,OAAO,OAAA,KAAY,WAAA,IAAe,QAAQ,GAAA,GAAM,OAAA,CAAQ,MAAM,EAAC;AAa1D,SAAS,SAAA,CACd,MAAA,EACA,MAAA,GAA6C,aAAA,EAChC;AACb,EAAA,MAAM,MAA+B,EAAC;AACtC,EAAA,MAAM,SAAmB,EAAC;AAC1B,EAAA,KAAA,MAAW,GAAA,IAAO,MAAA,CAAO,IAAA,CAAK,MAAM,CAAA,EAAG;AACrC,IAAA,IAAI;AACF,MAAA,GAAA,CAAI,GAAG,IAAI,MAAA,CAAO,GAAG,EAAG,KAAA,CAAM,MAAA,CAAO,GAAG,CAAA,EAAG,GAAG,CAAA;AAAA,IAChD,SAAS,CAAA,EAAG;AACV,MAAA,MAAA,CAAO,IAAA,CAAK,CAAA,SAAA,EAAQ,CAAA,CAAY,OAAO,CAAA,CAAE,CAAA;AAAA,IAC3C;AAAA,EACF;AACA,EAAA,IAAI,OAAO,MAAA,EAAQ;AACjB,IAAA,MAAM,IAAI,QAAA;AAAA,MACR,CAAA;AAAA,EAAmC,MAAA,CAAO,IAAA,CAAK,IAAI,CAAC,CAAA,CAAA;AAAA,MACpD,MAAA,CAAO,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,CAAE,MAAK,CAAE,OAAA,CAAQ,KAAA,EAAO,EAAE,CAAC;AAAA,KAC/C;AAAA,EACF;AACA,EAAA,OAAO,MAAA,CAAO,OAAO,GAAG,CAAA;AAC1B","file":"index.js","sourcesContent":["/**\n * @lacspace/env\n * Typed, validated environment variables — fail fast at boot.\n *\n * Declare a schema, validate `process.env` once at startup, and get a typed,\n * frozen object back. Missing or malformed variables throw a single, clear\n * error listing everything that's wrong — before your app serves traffic.\n *\n * Zero dependencies · isomorphic · fully typed.\n */\n\nexport interface Validator<T> {\n  parse(raw: string | undefined, key: string): T;\n}\n\nexport class EnvError extends Error {\n  constructor(\n    message: string,\n    public issues: string[],\n  ) {\n    super(message);\n    this.name = \"EnvError\";\n  }\n}\n\nfunction fail(key: string, msg: string): never {\n  throw new Error(`\"${key}\" ${msg}`);\n}\n\ninterface BaseOpts<T> {\n  default?: T;\n  optional?: boolean;\n}\n\nfunction withDefault<T>(\n  raw: string | undefined,\n  key: string,\n  opts: BaseOpts<T> | undefined,\n  cast: (v: string) => T,\n): T {\n  if (raw === undefined || raw === \"\") {\n    if (opts && \"default\" in opts && opts.default !== undefined) return opts.default;\n    if (opts?.optional) return undefined as unknown as T;\n    fail(key, \"is required but was not set\");\n  }\n  return cast(raw);\n}\n\n/** A string. `allowEmpty` keeps \"\"; otherwise empty is treated as missing. */\nexport function str(opts?: BaseOpts<string> & { allowEmpty?: boolean }): Validator<string> {\n  return {\n    parse(raw, key) {\n      if (opts?.allowEmpty && raw === \"\") return \"\";\n      return withDefault(raw, key, opts, (v) => v);\n    },\n  };\n}\n\n/** A number (integer or float). */\nexport function num(opts?: BaseOpts<number> & { min?: number; max?: number }): Validator<number> {\n  return {\n    parse(raw, key) {\n      return withDefault(raw, key, opts, (v) => {\n        const n = Number(v);\n        if (!Number.isFinite(n)) fail(key, `must be a number, got \"${v}\"`);\n        if (opts?.min !== undefined && n < opts.min) fail(key, `must be >= ${opts.min}`);\n        if (opts?.max !== undefined && n > opts.max) fail(key, `must be <= ${opts.max}`);\n        return n;\n      });\n    },\n  };\n}\n\n/** An integer. */\nexport function int(opts?: BaseOpts<number> & { min?: number; max?: number }): Validator<number> {\n  const base = num(opts);\n  return {\n    parse(raw, key) {\n      const n = base.parse(raw, key);\n      if (n !== undefined && !Number.isInteger(n)) fail(key, `must be an integer, got \"${raw}\"`);\n      return n;\n    },\n  };\n}\n\n/** A TCP port (1–65535). */\nexport function port(opts?: BaseOpts<number>): Validator<number> {\n  return int({ ...opts, min: 1, max: 65535 });\n}\n\n/** A boolean. Accepts true/1/yes/on and false/0/no/off (case-insensitive). */\nexport function bool(opts?: BaseOpts<boolean>): Validator<boolean> {\n  return {\n    parse(raw, key) {\n      return withDefault(raw, key, opts, (v) => {\n        const s = v.trim().toLowerCase();\n        if ([\"true\", \"1\", \"yes\", \"on\"].includes(s)) return true;\n        if ([\"false\", \"0\", \"no\", \"off\"].includes(s)) return false;\n        fail(key, `must be a boolean, got \"${v}\"`);\n      });\n    },\n  };\n}\n\n/** A valid URL string. */\nexport function url(opts?: BaseOpts<string>): Validator<string> {\n  return {\n    parse(raw, key) {\n      return withDefault(raw, key, opts, (v) => {\n        try {\n          new URL(v);\n        } catch {\n          fail(key, `must be a valid URL, got \"${v}\"`);\n        }\n        return v;\n      });\n    },\n  };\n}\n\n/** A plausible email address. */\nexport function email(opts?: BaseOpts<string>): Validator<string> {\n  return {\n    parse(raw, key) {\n      return withDefault(raw, key, opts, (v) => {\n        if (!/^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(v)) fail(key, `must be an email, got \"${v}\"`);\n        return v;\n      });\n    },\n  };\n}\n\n/** One of a fixed set of string values. */\nexport function oneOf<const T extends string>(\n  values: readonly T[],\n  opts?: BaseOpts<T>,\n): Validator<T> {\n  return {\n    parse(raw, key) {\n      return withDefault(raw, key, opts, (v) => {\n        if (!values.includes(v as T)) fail(key, `must be one of ${values.join(\", \")}, got \"${v}\"`);\n        return v as T;\n      });\n    },\n  };\n}\n\n/** JSON-parsed value. */\nexport function json<T = unknown>(opts?: BaseOpts<T>): Validator<T> {\n  return {\n    parse(raw, key) {\n      return withDefault(raw, key, opts, (v) => {\n        try {\n          return JSON.parse(v) as T;\n        } catch {\n          fail(key, \"must be valid JSON\");\n        }\n      });\n    },\n  };\n}\n\nexport type InferEnv<S extends Record<string, Validator<unknown>>> = {\n  readonly [K in keyof S]: S[K] extends Validator<infer T> ? T : never;\n};\n\nconst defaultSource: Record<string, string | undefined> =\n  typeof process !== \"undefined\" && process.env ? process.env : {};\n\n/**\n * Validate a schema against a source (defaults to `process.env`) and return a\n * typed, frozen object. Throws a single {@link EnvError} listing every problem.\n * @example\n * export const env = createEnv({\n *   NODE_ENV: oneOf([\"development\", \"production\", \"test\"], { default: \"development\" }),\n *   PORT: port({ default: 3000 }),\n *   DATABASE_URL: url(),\n *   DEBUG: bool({ default: false }),\n * });\n */\nexport function createEnv<S extends Record<string, Validator<unknown>>>(\n  schema: S,\n  source: Record<string, string | undefined> = defaultSource,\n): InferEnv<S> {\n  const out: Record<string, unknown> = {};\n  const issues: string[] = [];\n  for (const key of Object.keys(schema)) {\n    try {\n      out[key] = schema[key]!.parse(source[key], key);\n    } catch (e) {\n      issues.push(`  • ${(e as Error).message}`);\n    }\n  }\n  if (issues.length) {\n    throw new EnvError(\n      `Invalid environment variables:\\n${issues.join(\"\\n\")}`,\n      issues.map((i) => i.trim().replace(/^• /, \"\")),\n    );\n  }\n  return Object.freeze(out) as InferEnv<S>;\n}\n"]}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@lacspace/env",
+  "version": "1.0.0",
+  "description": "Typed, validated environment variables — declare a schema, validate process.env at boot, get a typed frozen object or a clear fail-fast error. A zero-dependency t3-env / envalid alternative.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "env",
+    "environment-variables",
+    "dotenv",
+    "env-validation",
+    "t3-env",
+    "envalid",
+    "config",
+    "type-safe",
+    "typescript"
+  ],
+  "author": "Lacspace <contact@lacspace.com>",
+  "license": "MIT",
+  "homepage": "https://lacspace.com/packages",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lacspace/npm-packages.git",
+    "directory": "env"
+  },
+  "bugs": {
+    "url": "https://github.com/lacspace/npm-packages/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}