@lowerdeck/env 1.0.0

package/.turbo/turbo-build.log

@@ -0,0 +1,11 @@
+
+$ microbundle
+Build "@lowerdeck/env" to dist:
+        218 B: index.cjs.gz
+        164 B: index.cjs.br
+        212 B: index.modern.js.gz
+        170 B: index.modern.js.br
+        225 B: index.module.js.gz
+        175 B: index.module.js.br
+        304 B: index.umd.js.gz
+        267 B: index.umd.js.br

package/.turbo/turbo-test.log

@@ -0,0 +1,28 @@
+
+$ vitest run --passWithNoTests
+[?25l
+ RUN  v3.2.4 /Users/tobias/code/metorial/metorial-enterprise/oss/src/packages/backend/env
+
+[?2026h
+ ❯ src/env.test.ts [queued]
+
+ Test Files 0 passed (1)
+      Tests 0 passed (0)
+   Start at 10:23:43
+   Duration 102ms
+[?2026l[?2026h
+ ❯ src/env.test.ts 0/1
+
+ Test Files 0 passed (1)
+      Tests 0 passed (1)
+   Start at 10:23:43
+   Duration 303ms
+[?2026l ✓ src/env.test.ts (1 test) 2ms
+   ✓ createValidatedEnv > validates env 1ms
+
+ Test Files  1 passed (1)
+      Tests  1 passed (1)
+   Start at  10:23:43
+   Duration  335ms (transform 97ms, setup 0ms, collect 128ms, tests 2ms, environment 0ms, prepare 37ms)
+
+[?25h

package/README.md

@@ -0,0 +1,64 @@
+# `@lowerdeck/env`
+
+Type-safe environment variable validation. Ensure required environment variables exist and have proper types at application startup.
+
+## Installation
+
+```bash
+npm install @lowerdeck/env
+yarn add @lowerdeck/env
+bun add @lowerdeck/env
+pnpm add @lowerdeck/env
+```
+
+## Usage
+
+```typescript
+import { createValidatedEnv } from '@lowerdeck/env';
+import { string, number, object } from '@lowerdeck/validation';
+
+// Define environment schema
+const env = createValidatedEnv(
+  object({
+    NODE_ENV: string().oneOf(['development', 'production', 'test']),
+    PORT: number().min(1).max(65535),
+    DATABASE_URL: string().url(),
+    API_KEY: string().min(32),
+    DEBUG: string().optional()
+  })
+);
+
+// Use validated environment variables
+console.log(env.PORT);         // number type
+console.log(env.NODE_ENV);     // 'development' | 'production' | 'test'
+console.log(env.DATABASE_URL); // validated URL string
+
+// Throws error if validation fails
+// Error: Environment variable PORT is required
+// Error: Environment variable DATABASE_URL must be a valid URL
+```
+
+### With Default Values
+
+```typescript
+import { createValidatedEnv } from '@lowerdeck/env';
+import { string, number, object, optional } from '@lowerdeck/validation';
+
+const env = createValidatedEnv(
+  object({
+    PORT: optional(number().min(1)).default(3000),
+    HOST: optional(string()).default('localhost'),
+    LOG_LEVEL: optional(string().oneOf(['debug', 'info', 'warn', 'error'])).default('info')
+  })
+);
+
+console.log(env.PORT); // 3000 if not set
+```
+
+## License
+
+This project is licensed under the Apache License 2.0.
+
+<div align="center">
+  <sub>Built with ❤️ by <a href="https://metorial.com">Metorial</a></sub>
+</div>

package/dist/env.d.ts

@@ -0,0 +1,3 @@
+import { ValidationType, ValidationTypeValue } from '@lowerdeck/validation';
+export declare let createValidatedEnv: <Env extends Record<string, Record<string, ValidationType<any>>>>(env: Env) => { [K in keyof Env]: { [P in keyof Env[K]]: ValidationTypeValue<Env[K][P]>; }; };
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5E,eAAO,IAAI,kBAAkB,GAC3B,GAAG,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAE/D,KAAK,GAAG,KACP,GACA,CAAC,IAAI,MAAM,GAAG,GAAG,GACf,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACpD,GAgBF,CAAC"}

package/dist/env.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=env.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"env.test.d.ts","sourceRoot":"","sources":["../src/env.test.ts"],"names":[],"mappings":""}

package/dist/index.cjs

@@ -0,0 +1,2 @@
+exports.createValidatedEnv=function(e){return Object.fromEntries(Object.entries(e).map(function(e){return[e[0],Object.fromEntries(Object.entries(e[1]).map(function(e){var r=e[0],t=e[1].validate(process.env[r]);if(!t.success)throw new Error("ENV VALIDATION: "+r+" - "+t.errors[0].message);return[r,t.value]}))]}))};
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../src/env.ts"],"sourcesContent":["import { ValidationType, ValidationTypeValue } from '@lowerdeck/validation';\n\nexport let createValidatedEnv = <\n  Env extends Record<string, Record<string, ValidationType<any>>>\n>(\n  env: Env\n): {\n  [K in keyof Env]: {\n    [P in keyof Env[K]]: ValidationTypeValue<Env[K][P]>;\n  };\n} => {\n  return Object.fromEntries(\n    Object.entries(env).map(([key, value]) => [\n      key,\n      Object.fromEntries(\n        Object.entries(value).map(([key, value]) => {\n          let res = value.validate(process.env[key]);\n          if (!res.success)\n            throw new Error(`ENV VALIDATION: ${key} - ${res.errors[0].message}`);\n\n          return [key, res.value];\n        })\n      )\n    ])\n  ) as any;\n};\n"],"names":["env","Object","fromEntries","entries","map","_ref","_ref2","key","res","validate","process","success","Error","errors","message","value"],"mappings":"2BAEgC,SAG9BA,GAMA,OAAOC,OAAOC,YACZD,OAAOE,QAAQH,GAAKI,IAAI,SAAAC,GAAY,MAAM,CAAbA,EAAA,GAE3BJ,OAAOC,YACLD,OAAOE,QAHyBE,EAAA,IAGVD,IAAI,SAAAE,GAAiB,IAAfC,EAAGD,EAAA,GACzBE,EADgCF,EAAA,GACpBG,SAASC,QAAQV,IAAIO,IACrC,IAAKC,EAAIG,QACP,MAAM,IAAIC,MAAK,mBAAoBL,EAAG,MAAMC,EAAIK,OAAO,GAAGC,SAE5D,MAAO,CAACP,EAAKC,EAAIO,MACnB,IAEH,GAEL"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './env';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC"}

package/dist/index.modern.js

@@ -0,0 +1,2 @@
+let e=e=>Object.fromEntries(Object.entries(e).map(([e,r])=>[e,Object.fromEntries(Object.entries(r).map(([e,r])=>{let t=r.validate(process.env[e]);if(!t.success)throw new Error(`ENV VALIDATION: ${e} - ${t.errors[0].message}`);return[e,t.value]}))]));export{e as createValidatedEnv};
+//# sourceMappingURL=index.modern.js.map

package/dist/index.modern.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.modern.js","sources":["../src/env.ts"],"sourcesContent":["import { ValidationType, ValidationTypeValue } from '@lowerdeck/validation';\n\nexport let createValidatedEnv = <\n  Env extends Record<string, Record<string, ValidationType<any>>>\n>(\n  env: Env\n): {\n  [K in keyof Env]: {\n    [P in keyof Env[K]]: ValidationTypeValue<Env[K][P]>;\n  };\n} => {\n  return Object.fromEntries(\n    Object.entries(env).map(([key, value]) => [\n      key,\n      Object.fromEntries(\n        Object.entries(value).map(([key, value]) => {\n          let res = value.validate(process.env[key]);\n          if (!res.success)\n            throw new Error(`ENV VALIDATION: ${key} - ${res.errors[0].message}`);\n\n          return [key, res.value];\n        })\n      )\n    ])\n  ) as any;\n};\n"],"names":["createValidatedEnv","env","Object","fromEntries","entries","map","key","value","res","validate","process","success","Error","errors","message"],"mappings":"AAEW,IAAAA,EAGTC,GAMOC,OAAOC,YACZD,OAAOE,QAAQH,GAAKI,IAAI,EAAEC,EAAKC,KAAW,CACxCD,EACAJ,OAAOC,YACLD,OAAOE,QAAQG,GAAOF,IAAI,EAAEC,EAAKC,MAC/B,IAAIC,EAAMD,EAAME,SAASC,QAAQT,IAAIK,IACrC,IAAKE,EAAIG,QACP,MAAU,IAAAC,MAAM,mBAAmBN,OAASE,EAAIK,OAAO,GAAGC,WAE5D,MAAO,CAACR,EAAKE,EAAID"}

package/dist/index.module.js

@@ -0,0 +1,2 @@
+var e=function(e){return Object.fromEntries(Object.entries(e).map(function(e){return[e[0],Object.fromEntries(Object.entries(e[1]).map(function(e){var r=e[0],t=e[1].validate(process.env[r]);if(!t.success)throw new Error("ENV VALIDATION: "+r+" - "+t.errors[0].message);return[r,t.value]}))]}))};export{e as createValidatedEnv};
+//# sourceMappingURL=index.module.js.map

package/dist/index.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.module.js","sources":["../src/env.ts"],"sourcesContent":["import { ValidationType, ValidationTypeValue } from '@lowerdeck/validation';\n\nexport let createValidatedEnv = <\n  Env extends Record<string, Record<string, ValidationType<any>>>\n>(\n  env: Env\n): {\n  [K in keyof Env]: {\n    [P in keyof Env[K]]: ValidationTypeValue<Env[K][P]>;\n  };\n} => {\n  return Object.fromEntries(\n    Object.entries(env).map(([key, value]) => [\n      key,\n      Object.fromEntries(\n        Object.entries(value).map(([key, value]) => {\n          let res = value.validate(process.env[key]);\n          if (!res.success)\n            throw new Error(`ENV VALIDATION: ${key} - ${res.errors[0].message}`);\n\n          return [key, res.value];\n        })\n      )\n    ])\n  ) as any;\n};\n"],"names":["createValidatedEnv","env","Object","fromEntries","entries","map","_ref","_ref2","key","res","validate","process","success","Error","errors","message","value"],"mappings":"AAEW,IAAAA,EAAqB,SAG9BC,GAMA,OAAOC,OAAOC,YACZD,OAAOE,QAAQH,GAAKI,IAAI,SAAAC,GAAY,MAAM,CAAbA,EAAA,GAE3BJ,OAAOC,YACLD,OAAOE,QAHyBE,EAAA,IAGVD,IAAI,SAAAE,GAAiB,IAAfC,EAAGD,EAAA,GACzBE,EADgCF,EAAA,GACpBG,SAASC,QAAQV,IAAIO,IACrC,IAAKC,EAAIG,QACP,MAAM,IAAIC,MAAK,mBAAoBL,EAAG,MAAMC,EAAIK,OAAO,GAAGC,SAE5D,MAAO,CAACP,EAAKC,EAAIO,MACnB,IAEH,GAEL"}

package/dist/index.umd.js

@@ -0,0 +1,2 @@
+!function(e,n){"object"==typeof exports&&"undefined"!=typeof module?n(exports):"function"==typeof define&&define.amd?define(["exports"],n):n((e||self).env={})}(this,function(e){e.createValidatedEnv=function(e){return Object.fromEntries(Object.entries(e).map(function(e){return[e[0],Object.fromEntries(Object.entries(e[1]).map(function(e){var n=e[0],t=e[1].validate(process.env[n]);if(!t.success)throw new Error("ENV VALIDATION: "+n+" - "+t.errors[0].message);return[n,t.value]}))]}))}});
+//# sourceMappingURL=index.umd.js.map

package/dist/index.umd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.umd.js","sources":["../src/env.ts"],"sourcesContent":["import { ValidationType, ValidationTypeValue } from '@lowerdeck/validation';\n\nexport let createValidatedEnv = <\n  Env extends Record<string, Record<string, ValidationType<any>>>\n>(\n  env: Env\n): {\n  [K in keyof Env]: {\n    [P in keyof Env[K]]: ValidationTypeValue<Env[K][P]>;\n  };\n} => {\n  return Object.fromEntries(\n    Object.entries(env).map(([key, value]) => [\n      key,\n      Object.fromEntries(\n        Object.entries(value).map(([key, value]) => {\n          let res = value.validate(process.env[key]);\n          if (!res.success)\n            throw new Error(`ENV VALIDATION: ${key} - ${res.errors[0].message}`);\n\n          return [key, res.value];\n        })\n      )\n    ])\n  ) as any;\n};\n"],"names":["env","Object","fromEntries","entries","map","_ref","_ref2","key","res","validate","process","success","Error","errors","message","value"],"mappings":"kPAEgC,SAG9BA,GAMA,OAAOC,OAAOC,YACZD,OAAOE,QAAQH,GAAKI,IAAI,SAAAC,GAAY,MAAM,CAAbA,EAAA,GAE3BJ,OAAOC,YACLD,OAAOE,QAHyBE,EAAA,IAGVD,IAAI,SAAAE,GAAiB,IAAfC,EAAGD,EAAA,GACzBE,EADgCF,EAAA,GACpBG,SAASC,QAAQV,IAAIO,IACrC,IAAKC,EAAIG,QACP,MAAM,IAAIC,MAAK,mBAAoBL,EAAG,MAAMC,EAAIK,OAAO,GAAGC,SAE5D,MAAO,CAACP,EAAKC,EAAIO,MACnB,IAEH,GAEL"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@lowerdeck/env",
+  "version": "1.0.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "Tobias Herber",
+  "license": "Apache 2",
+  "type": "module",
+  "source": "src/index.ts",
+  "exports": {
+    "require": "./dist/index.cjs",
+    "default": "./dist/index.modern.js"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.module.js",
+  "types": "dist/index.d.ts",
+  "unpkg": "./dist/index.umd.js",
+  "scripts": {
+    "test": "vitest run --passWithNoTests",
+    "lint": "prettier src/**/*.ts --check",
+    "build": "microbundle"
+  },
+  "dependencies": {
+    "@lowerdeck/validation": "^1.0.0"
+  },
+  "devDependencies": {
+    "microbundle": "^0.15.1",
+    "@lowerdeck/tsconfig": "^1.0.0",
+    "typescript": "5.8.2",
+    "vitest": "^3.1.2"
+  }
+}

package/src/env.test.ts

@@ -0,0 +1,38 @@
+import { v } from '@lowerdeck/validation';
+import { describe, expect, test } from 'vitest';
+import { createValidatedEnv } from './env';
+
+describe('createValidatedEnv', () => {
+  test('validates env', () => {
+    process.env.PORT = '3000';
+    process.env.TEST = 'true';
+    process.env.TEST2 = 'false';
+    process.env.HELLO = 'world';
+
+    let env = createValidatedEnv({
+      test: {
+        PORT: v.string(),
+        TEST: v.boolean()
+      },
+      test2: {
+        TEST2: v.boolean()
+      },
+      hello: {
+        HELLO: v.string()
+      }
+    });
+
+    expect(env).toEqual({
+      test: {
+        PORT: '3000',
+        TEST: true
+      },
+      test2: {
+        TEST2: false
+      },
+      hello: {
+        HELLO: 'world'
+      }
+    });
+  });
+});

package/src/env.ts

@@ -0,0 +1,26 @@
+import { ValidationType, ValidationTypeValue } from '@lowerdeck/validation';
+
+export let createValidatedEnv = <
+  Env extends Record<string, Record<string, ValidationType<any>>>
+>(
+  env: Env
+): {
+  [K in keyof Env]: {
+    [P in keyof Env[K]]: ValidationTypeValue<Env[K][P]>;
+  };
+} => {
+  return Object.fromEntries(
+    Object.entries(env).map(([key, value]) => [
+      key,
+      Object.fromEntries(
+        Object.entries(value).map(([key, value]) => {
+          let res = value.validate(process.env[key]);
+          if (!res.success)
+            throw new Error(`ENV VALIDATION: ${key} - ${res.errors[0].message}`);
+
+          return [key, res.value];
+        })
+      )
+    ])
+  ) as any;
+};

package/src/index.ts

@@ -0,0 +1 @@
+export * from './env';

package/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "@lowerdeck/tsconfig/base.json",
+  "exclude": ["dist"],
+  "include": ["src"],
+  "compilerOptions": {
+    "outDir": "dist",
+    "lib": ["es2021"],
+    "target": "ES2019"
+  }
+}