@adamhl8/configs 0.24.13 → 0.25.0

package/dist/configs/knip.base.d.ts

@@ -6,7 +6,7 @@ declare const knipConfig: OptionalMergeConfigFn<KnipConfig, {
   readonly project: ["**"];
   readonly entry: ["./src/index.ts", "**/*.test.ts", "./tsdown.config.ts"];
   readonly ignoreBinaries: ["lefthook", "gh"];
-  readonly ignoreDependencies: ("@adamhl8/eslint-plugin-clean-modules" | "@commitlint/cli")[];
+  readonly ignoreDependencies: ("@commitlint/cli" | "@adamhl8/eslint-plugin-clean-modules")[];
   readonly tsdown: false;
 }>;
 //#endregion

package/dist/env/index.d.ts

@@ -0,0 +1,9 @@
+import { requireWhen } from "./utils.js";
+import arkenv from "arkenv";
+
+//#region src/env/index.d.ts
+type ArkEnv = typeof arkenv;
+declare const parseEnv: ArkEnv;
+//#endregion
+export { parseEnv, requireWhen };
+//# sourceMappingURL=index.d.ts.map

package/dist/env/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/env/index.ts"],"mappings":";;;;KAKK,MAAA,UAAgB,MAAM;AAAA,cAEd,QAAA,EAOP,MAAM"}

package/dist/env/index.js

@@ -0,0 +1,17 @@
+import { requireWhen } from "./utils.js";
+import process from "node:process";
+import arkenv from "arkenv";
+import { attempt, isErr } from "ts-explicit-errors";
+//#region src/env/index.ts
+const parseEnv = ((...args) => {
+	const env = attempt(() => arkenv(...args));
+	if (isErr(env)) {
+		console.error(env.message);
+		process.exit(1);
+	}
+	return env;
+});
+//#endregion
+export { parseEnv, requireWhen };
+
+//# sourceMappingURL=index.js.map

package/dist/env/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/env/index.ts"],"sourcesContent":["import process from \"node:process\"\n\nimport arkenv from \"arkenv\"\nimport { attempt, isErr } from \"ts-explicit-errors\"\n\ntype ArkEnv = typeof arkenv\n\nexport const parseEnv = ((...args: Parameters<ArkEnv>) => {\n  const env = attempt(() => arkenv(...args))\n  if (isErr(env)) {\n    console.error(env.message)\n    process.exit(1)\n  }\n  return env\n}) as ArkEnv\n\nexport { requireWhen } from \"#/env/utils.ts\"\n"],"mappings":";;;;;AAOA,MAAa,aAAa,GAAG,SAA6B;CACxD,MAAM,MAAM,cAAc,OAAO,GAAG,IAAI,CAAC;CACzC,IAAI,MAAM,GAAG,GAAG;EACd,QAAQ,MAAM,IAAI,OAAO;EACzB,QAAQ,KAAK,CAAC;CAChB;CACA,OAAO;AACT"}

package/dist/env/utils.d.ts

@@ -0,0 +1,14 @@
+import { type } from "arktype";
+
+//#region src/env/utils.d.ts
+/**
+ * Makes an env var required while `when` is true, otherwise optional.
+ *
+ * A set value must always satisfy `def`. An unset var takes `fallback` (exempt from `def` validation), or the key is
+ * omitted entirely if no fallback is given.
+ */
+declare function requireWhen<const type$1>(when: boolean, type: type.validate<type$1>): ReturnType<type.instantiate<type$1>["optional"]>;
+declare function requireWhen<const type$2>(when: boolean, type: type.validate<type$2>, fallback: type.infer<type$2>): type.instantiate<type$2>;
+//#endregion
+export { requireWhen };
+//# sourceMappingURL=utils.d.ts.map

package/dist/env/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","names":[],"sources":["../../src/env/utils.ts"],"mappings":";;;;;AASA;;;;iBAAgB,WAAA,eACd,IAAA,WACA,IAAA,EAAM,IAAA,CAAQ,QAAA,CAAS,MAAA,IACtB,UAAA,CAAW,IAAA,CAAQ,WAAA,CAAY,MAAA;AAAA,iBAClB,WAAA,eACd,IAAA,WACA,IAAA,EAAM,IAAA,CAAQ,QAAA,CAAS,MAAA,GACvB,QAAA,EAAU,IAAA,CAAQ,KAAA,CAAM,MAAA,IACvB,IAAA,CAAQ,WAAA,CAAY,MAAA"}

package/dist/env/utils.js

@@ -0,0 +1,14 @@
+import { type } from "arkenv";
+//#region src/env/utils.ts
+function requireWhen(when, type$1, ...rest) {
+	const t = type.raw(type$1);
+	if (when) return t;
+	if (rest.length === 0) return t.optional();
+	const [fallback] = rest;
+	const unset = Symbol("unset");
+	return t.or(type.unit(unset)).pipe((v) => v === unset ? fallback : v).default(unset);
+}
+//#endregion
+export { requireWhen };
+
+//# sourceMappingURL=utils.js.map

package/dist/env/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","names":["arkenvType","type"],"sources":["../../src/env/utils.ts"],"sourcesContent":["import { type as arkenvType } from \"arkenv\"\nimport type { type as arktype } from \"arktype\"\n\n/**\n * Makes an env var required while `when` is true, otherwise optional.\n *\n * A set value must always satisfy `def`. An unset var takes `fallback` (exempt from `def` validation), or the key is\n * omitted entirely if no fallback is given.\n */\nexport function requireWhen<const type>(\n  when: boolean,\n  type: arktype.validate<type>,\n): ReturnType<arktype.instantiate<type>[\"optional\"]>\nexport function requireWhen<const type>(\n  when: boolean,\n  type: arktype.validate<type>,\n  fallback: arktype.infer<type>,\n): arktype.instantiate<type>\n/* oxlint-disable typescript/no-unsafe-type-assertion */\nexport function requireWhen(when: boolean, type: unknown, ...rest: [unknown?]): never {\n  const t = arkenvType.raw(type)\n  if (when) return t as never\n  if (rest.length === 0) return t.optional() as never\n  const [fallback] = rest\n  // defaulting to a sentinel keeps the fallback exempt from def validation without\n  // letting an explicitly set value bypass it (env values can never be a symbol)\n  const unset = Symbol(\"unset\")\n  return t\n    .or(arkenvType.unit(unset))\n    .pipe((v: unknown) => (v === unset ? fallback : v))\n    .default(unset as never) as never\n}\n"],"mappings":";;AAmBA,SAAgB,YAAY,MAAe,QAAe,GAAG,MAAyB;CACpF,MAAM,IAAIA,KAAW,IAAIC,MAAI;CAC7B,IAAI,MAAM,OAAO;CACjB,IAAI,KAAK,WAAW,GAAG,OAAO,EAAE,SAAS;CACzC,MAAM,CAAC,YAAY;CAGnB,MAAM,QAAQ,OAAO,OAAO;CAC5B,OAAO,EACJ,GAAGD,KAAW,KAAK,KAAK,CAAC,CAAC,CAC1B,MAAM,MAAgB,MAAM,QAAQ,WAAW,CAAE,CAAC,CAClD,QAAQ,KAAc;AAC3B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adamhl8/configs",
-  "version": "0.24.13",
+  "version": "0.25.0",
   "homepage": "https://github.com/adamhl8/configs",
   "bugs": {
     "url": "https://github.com/adamhl8/configs/issues"
@@ -31,6 +31,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./env": {
+      "types": "./dist/env/index.d.ts",
+      "import": "./dist/env/index.js"
     }
   },
   "publishConfig": {
@@ -48,7 +52,10 @@
     "@adamhl8/eslint-plugin-clean-modules": "^0.1.3",
     "@commitlint/config-conventional": "^21.2.0",
     "@commitlint/types": "^21.2.0",
+    "arkenv": "^0.12.2",
+    "arktype": "^2.2.2",
     "es-toolkit": "^1.49.0",
+    "ts-explicit-errors": "^4.1.2",
     "type-fest": "^5.7.0"
   },
   "devDependencies": {