arkenv 0.2.0 → 0.4.0

package/README.md

@@ -1,7 +1,90 @@
-# ArkEnv
-
-Hello, developers! Welcome to the ArkEnv package codebase. This directory contains the core implementation of the ArkEnv library, which provides typesafe environment variable parsing and validation for Node.js.
-
-For more information, please refer to the main [README](../../README.md) in the monorepo root.
-
-Happy coding!
+<p align="center">
+  <a href="https://arkenv.js.org">
+    <img alt="arkenv - Typesafe Environment Variables" src="https://og.tailgraph.com/og?titleFontFamily=JetBrains+Mono&textFontFamily=Inter&title=ArkEnv&titleTailwind=text-[%23e9eef9]%20font-bold%20relative%20decoration-%5Brgb(180,215,255)%5D%20decoration-wavy%20decoration-[5px]%20underline%20underline-offset-[16px]%20text-5xl%20mb-8&text=Typesafe%20environment%20variables%20powered%20by%20ArkType&textTailwind=text-[%238b9dc1]%20text-3xl&bgTailwind=bg-gradient-to-b%20from-[%23061a3a]%20to-black" width="645px">
+  </a>
+  <br />
+  <a href="https://github.com/yamcodes/arkenv/actions/workflows/tests.yml?query=branch%3Amain"><img alt="Tests Status" src="https://github.com/yamcodes/arkenv/actions/workflows/tests.yml/badge.svg?event=push&branch=main"></a>
+  <a href="https://bundlephobia.com/package/arkenv"><img alt="Bundle Size" src="https://img.shields.io/bundlephobia/min/arkenv?label=bundle%20size&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAxMzcgMTU3IiB3aWR0aD0iMTM3IiBoZWlnaHQ9IjE1NyI+PHJlY3QgZmlsbD0iI2ZmZiIgeD0iNjIuMzEiIHk9IjEwMi4zMSIgd2lkdGg9IjE2Ljc0IiBoZWlnaHQ9IjE1Ljk0IiByeD0iNy45NyIvPjxyZWN0IGZpbGw9IiNmZmYiIHg9IjYyLjMxIiB5PSI4Ni4zNyIgd2lkdGg9IjE2Ljc0IiBoZWlnaHQ9IjMxLjg4IiByeD0iOC4zNyIvPjxlbGxpcHNlIGZpbGw9IiNmZmYiIGN4PSI0NC4zNCIgY3k9IjU0LjIyIiByeD0iNy4xMyIgcnk9IjguNDUiLz48ZWxsaXBzZSBmaWxsPSIjZmZmIiBjeD0iOTMuNzUiIGN5PSI1NC4yMiIgcng9IjcuMTMiIHJ5PSI4LjQ1Ii8+PHBhdGggZmlsbD0iI2ZmZiIgZD0iTTExNC4xIDExNy44NGMxLjItMS4wMiAxLjc0LTEuOTYgMi40OC0zLjU2bDE5LjMtNDIuOTJjLTIuMDItMjcuMS0zLjQ0LTQwLjctMy40NC00MC43NyAwLTIuNy0yLjE0LTQuOC00Ljc4LTQuOC0yLjYgMC00LjczIDIuMS00Ljc4IDQuNzBsLTMuMDUgMzcuNy0xNC43NiA0Mi4xYy0uNDQuOC0uNyAxLjgtLjcgMi44IDAgLjgzLjIgMS42NC41IDIuNGwxMC40MyA0MC4xMiAxMS41NS0zLjEtMTIuNzQtMzQuOHoiLz48cGF0aCBmaWxsPSIjZmZmIiBkPSJNMjMuMjcgMTE3Ljg0Yy0xLjItMS4wMi0xLjczLTEuOTYtMi40Ny0zLjU2TDEuNSA3MS4zNmMyLjAyLTI3LjEgMy40My00MC43IDMuNDMtNDAuNzcgMC0yLjcgMi4xNC00LjggNC44LTQuOCAyLjYgMCA0LjcyIDIuMSA0Ljc3IDQuN2wzLjA1IDM3LjcgMTQuNzUgNDIuMmMuNDUuOC43IDEuOC43IDIuOCAwIC44LS4xOCAxLjYtLjUgMi40bC0xMC40IDQwLjEtMTEuNTUtMy4xIDEyLjc0LTM0Ljh6Ii8+PHBhdGggZmlsbD0iI2ZmZiIgZD0iTTk0LjI2IDkxLjIzYzEyLjItNy41NCAyMC4yNS0yMC4zOCAyMC4yNS0zNC45NCAwLTMuOS0uNS03LjYtMS41LTExLjFDMTEyLjggMjEgOTMuMiAxLjUgNjguOTggMS41UzI1IDIxLjAyIDI0Ljg3IDQ1LjJjLTEuMDUgMy41Mi0xLjYgNy4yMy0xLjYgMTEuMDUgMCAxNi41NCAxMC40MyAzMC45IDI1LjYgMzcuNzItLjEgMS40LS4xIDIuODItLjEgNC4yNiAwIDIzLjIyIDEwLjIyIDQyLjA0IDIyLjkgNDIuMDQgMTIuNjUgMCAyMi45Mi0xOC44IDIyLjkyLTQyLjAzIDAtMi40LS4yLTQuOC0uNC03LjF6Ii8+PC9zdmc+"></a>
+  <a href="https://www.npmjs.com/package/arkenv?activeTab=versions"><img alt="Total Downloads" src="https://badgen.net/npm/dt/arkenv?icon=npm&color=blue&label=downloads"></a>
+  <a href="https://www.npmjs.com/package/arkenv?activeTab=dependencies"><img alt="Dependency Count" src="https://badgen.net/bundlephobia/dependency-count/arkenv?icon=npm&color=blue&label=dependencies"></a>
+  <a href="https://arktype.io/"><img alt="Powered By ArkType" src="https://badgen.net/static/powered by/ArkType"></a>
+</p>
+
+## Installation
+
+<details open>
+<summary>npm</summary>
+
+```sh
+npm install arkenv arktype
+```
+</details>
+
+<details>
+<summary>pnpm</summary>
+
+```sh
+pnpm add arkenv arktype
+```
+</details>
+
+<details>
+<summary>Yarn</summary>
+
+```sh
+yarn add arkenv arktype
+```
+</details>
+
+<details>
+<summary>Bun</summary>
+
+```sh
+bun add arkenv arktype
+```
+</details>
+
+## Quickstart
+
+> [!TIP]
+> Find more examples in the [examples](https://github.com/yamcodes/arkenv/tree/main/examples) directory.
+
+```ts
+import { createEnv } from 'arkenv';
+
+const env = createEnv({
+  HOST: "string.host", // valid IP address or localhost
+  PORT: "number.port", // valid port number (0-65535)
+  NODE_ENV: "'development' | 'production' | 'test'",
+});
+
+// Automatically validate and parse process.env
+// TypeScript knows the ✨exact✨ types!
+console.log(env.HOST);     // (property) HOST: string
+console.log(env.PORT);     // (property) PORT: number
+console.log(env.NODE_ENV); // (property) NODE_ENV: "development" | "production" | "test"
+```
+
+## Features
+
+- 🔒 **Typesafe**: Full TypeScript support with inferred types
+- 🚀 **Runtime validation**: Catch missing or invalid environment variables early
+- 💪 **Powered by ArkType**: Leverage ArkType's powerful type system
+- 🪶 **Lightweight**: Only a single dependency ([5.6 kB](https://bundlephobia.com/package/chalk@5.4.1))
+- ⚡ **Fast**: Optimized for performance with minimal overhead
+
+## Documentation
+
+For detailed documentation and examples, please visit our [documentation site](https://arkenv.js.org/docs).
+
+## Plugins
+
+- [@arkenv/vite-plugin](https://github.com/yamcodes/arkenv/tree/main/packages/vite-plugin): [Vite](https://vite.dev/) plugin to validate environment variables at build time
+
+## Contributing
+
+Contributions are welcome! Please see [CONTRIBUTING.md](https://github.com/yamcodes/arkenv/blob/main/CONTRIBUTING.md) for more information.
+
+## Thanks / Inspiration
+
+Find projects and people who helped or inspired the creation of ArkEnv in [THANKS.md](https://github.com/yamcodes/arkenv/blob/main/THANKS.md). Thank you 🙏

package/dist/index.cjs

@@ -30,19 +30,17 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  default: () => index_default,
-  defineEnv: () => defineEnv,
-  host: () => host,
-  port: () => port
+  createEnv: () => createEnv,
+  default: () => index_default
 });
 module.exports = __toCommonJS(index_exports);
 
-// src/define-env.ts
-var define_env_exports = {};
-__export(define_env_exports, {
-  defineEnv: () => defineEnv
+// src/create-env.ts
+var create_env_exports = {};
+__export(create_env_exports, {
+  createEnv: () => createEnv
 });
-var import_arktype = require("arktype");
+var import_arktype3 = require("arktype");
 
 // src/errors.ts
 var import_chalk = __toESM(require("chalk"), 1);
@@ -75,30 +73,12 @@ ${indent(formatErrors(errors))}
   }
 };
 
-// src/define-env.ts
-var defineEnv = (def, env = process.env) => {
-  const schema = (0, import_arktype.type)(def);
-  const requiredEnvKeys = Object.keys(
-    def
-  );
-  const filteredEnvVars = Object.fromEntries(
-    Object.entries(env).filter(([key]) => requiredEnvKeys.includes(key))
-  );
-  const validatedEnv = schema(filteredEnvVars);
-  if (validatedEnv instanceof import_arktype.type.errors) {
-    throw new ArkEnvError(validatedEnv);
-  }
-  return validatedEnv;
-};
+// src/scope.ts
+var import_arktype2 = require("arktype");
 
 // src/types.ts
-var types_exports = {};
-__export(types_exports, {
-  host: () => host,
-  port: () => port
-});
-var import_arktype2 = require("arktype");
-var port = (0, import_arktype2.type)("string", "=>", (data, ctx) => {
+var import_arktype = require("arktype");
+var port = (0, import_arktype.type)("string", "=>", (data, ctx) => {
   const asNumber = Number.parseInt(data);
   const isInteger = Number.isInteger(asNumber);
   const isBetween = 0 <= asNumber && asNumber <= 65535;
@@ -107,13 +87,33 @@ var port = (0, import_arktype2.type)("string", "=>", (data, ctx) => {
   }
   return asNumber;
 });
-var host = (0, import_arktype2.type)("string.ip | 'localhost'");
+var host = (0, import_arktype.type)("string.ip | 'localhost'");
+
+// src/scope.ts
+var $ = (0, import_arktype2.scope)({
+  string: import_arktype2.type.module({
+    ...import_arktype2.type.keywords.string,
+    host
+  }),
+  number: import_arktype2.type.module({
+    ...import_arktype2.type.keywords.number,
+    port
+  })
+});
+
+// src/create-env.ts
+function createEnv(def, env = process.env) {
+  const schema = $.type.raw(def);
+  const validatedEnv = schema(env);
+  if (validatedEnv instanceof import_arktype3.type.errors) {
+    throw new ArkEnvError(validatedEnv);
+  }
+  return validatedEnv;
+}
 
 // src/index.ts
-var index_default = { ...define_env_exports, ...types_exports };
+var index_default = { ...create_env_exports };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  defineEnv,
-  host,
-  port
+  createEnv
 });

package/dist/index.d.cts

@@ -1,34 +1,102 @@
 import * as arktype from 'arktype';
 import { type, distill } from 'arktype';
-import * as arktype_internal_methods_string_ts from 'arktype/internal/methods/string.ts';
-import * as arktype_internal_methods_morph_ts from 'arktype/internal/methods/morph.ts';
 import * as arktype_internal_attributes_ts from 'arktype/internal/attributes.ts';
+import * as arktype_internal_keywords_string_ts from 'arktype/internal/keywords/string.ts';
 
-type UserEnvironment = Record<string, string | undefined>;
-type EnvSchema<T extends Record<string, string | undefined> = Record<string, string | undefined>> = type.validate<T>;
 /**
- * Define an environment variable schema and validate it against a given environment (defaults to `process.env`)
- * @param def - The environment variable schema
- * @param env - The environment variables to validate, defaults to `process.env`
- * @returns The validated environment variable schema
+ * The root scope for the ArkEnv library, containing extensions to the ArkType scopes with ArkEnv-specific types like `string.host` and `number.port`.
  */
-declare const defineEnv: <const T extends Record<string, string | undefined>>(def: EnvSchema<T>, env?: UserEnvironment) => distill.Out<type.infer<T>>;
+declare const $: arktype.Scope<{
+    string: arktype.Submodule<{
+        root: string;
+        " arkInferred": string;
+        trim: arktype.Submodule<arktype_internal_keywords_string_ts.trim.$ & {
+            " arkInferred": (In: string) => arktype_internal_attributes_ts.To<string>;
+        }>;
+        normalize: arktype.Submodule<arktype_internal_keywords_string_ts.normalize.$ & {
+            " arkInferred": (In: string) => arktype_internal_attributes_ts.To<string>;
+        }>;
+        alpha: string;
+        alphanumeric: string;
+        hex: string;
+        base64: arktype.Submodule<{
+            root: string;
+            url: string;
+        } & {
+            " arkInferred": string;
+        }>;
+        capitalize: arktype.Submodule<arktype_internal_keywords_string_ts.capitalize.$ & {
+            " arkInferred": (In: string) => arktype_internal_attributes_ts.To<string>;
+        }>;
+        creditCard: string;
+        date: arktype.Submodule<arktype_internal_keywords_string_ts.stringDate.$ & {
+            " arkInferred": string;
+        }>;
+        digits: string;
+        email: string;
+        integer: arktype.Submodule<arktype_internal_keywords_string_ts.stringInteger.$ & {
+            " arkInferred": string;
+        }>;
+        ip: arktype.Submodule<arktype_internal_keywords_string_ts.ip.$ & {
+            " arkInferred": string;
+        }>;
+        json: arktype.Submodule<arktype_internal_keywords_string_ts.stringJson.$ & {
+            " arkInferred": string;
+        }>;
+        lower: arktype.Submodule<arktype_internal_keywords_string_ts.lower.$ & {
+            " arkInferred": (In: string) => arktype_internal_attributes_ts.To<string>;
+        }>;
+        numeric: arktype.Submodule<arktype_internal_keywords_string_ts.stringNumeric.$ & {
+            " arkInferred": string;
+        }>;
+        regex: string;
+        semver: string;
+        upper: arktype.Submodule<{
+            root: (In: string) => arktype_internal_attributes_ts.To<string>;
+            preformatted: string;
+        } & {
+            " arkInferred": (In: string) => arktype_internal_attributes_ts.To<string>;
+        }>;
+        url: arktype.Submodule<arktype_internal_keywords_string_ts.url.$ & {
+            " arkInferred": string;
+        }>;
+        uuid: arktype.Submodule<arktype_internal_keywords_string_ts.uuid.$ & {
+            " arkInferred": string;
+        }>;
+        host: string;
+    }>;
+    number: arktype.Submodule<{
+        NaN: number;
+        Infinity: number;
+        root: number;
+        " arkInferred": number;
+        integer: number;
+        epoch: number;
+        safe: number;
+        NegativeInfinity: number;
+        port: (In: string) => arktype.Out<number>;
+    }>;
+}>;
 
+type RuntimeEnvironment = Record<string, string | undefined>;
+type EnvSchema<def, $ = {}> = type.validate<def, $>;
 /**
- * A `string` that can be parsed into a number between 0 and 65535
- */
-declare const port: arktype_internal_methods_morph_ts.MorphType<(In: string) => arktype_internal_attributes_ts.Out<number>, {}>;
-/**
- * An IP address or `"localhost"`
+ * Create an environment variables object from a schema and an environment
+ * @param def - The environment variable schema
+ * @param env - The environment variables to validate, defaults to `process.env`
+ * @returns The validated environment variable schema
+ * @throws An error if the environment variables are invalid. See {@link ArkEnvError}
  */
-declare const host: arktype_internal_methods_string_ts.StringType<string, {}>;
+declare function createEnv<const T extends Record<string, string | undefined>>(def: EnvSchema<T, (typeof $)["t"]>, env?: RuntimeEnvironment): distill.Out<type.infer<T, (typeof $)["t"]>>;
+declare function createEnv<const T extends Record<string, string | undefined>>(def: EnvSchema<T>, env?: RuntimeEnvironment): distill.Out<type.infer<T>>;
 
 declare const _default: {
-    port: arktype_internal_methods_morph_ts.MorphType<(In: string) => arktype_internal_attributes_ts.Out<number>, {}>;
-    host: arktype_internal_methods_string_ts.StringType<string, {}>;
-    defineEnv: <const T extends Record<string, string | undefined>>(def: EnvSchema<T>, env?: {
+    createEnv<const T extends Record<string, string | undefined>>(def: EnvSchema<T, typeof $["t"]>, env?: {
+        [x: string]: string | undefined;
+    }): arktype.distill.Out<arktype.type.infer<T, typeof $["t"]>>;
+    createEnv<const T extends Record<string, string | undefined>>(def: EnvSchema<T>, env?: {
         [x: string]: string | undefined;
-    }) => arktype.distill.Out<arktype.type.infer<T>>;
+    }): arktype.distill.Out<arktype.type.infer<T>>;
 };
 
-export { type EnvSchema, _default as default, defineEnv, host, port };
+export { type EnvSchema, createEnv, _default as default };

package/dist/index.d.ts

@@ -1,34 +1,102 @@
 import * as arktype from 'arktype';
 import { type, distill } from 'arktype';
-import * as arktype_internal_methods_string_ts from 'arktype/internal/methods/string.ts';
-import * as arktype_internal_methods_morph_ts from 'arktype/internal/methods/morph.ts';
 import * as arktype_internal_attributes_ts from 'arktype/internal/attributes.ts';
+import * as arktype_internal_keywords_string_ts from 'arktype/internal/keywords/string.ts';
 
-type UserEnvironment = Record<string, string | undefined>;
-type EnvSchema<T extends Record<string, string | undefined> = Record<string, string | undefined>> = type.validate<T>;
 /**
- * Define an environment variable schema and validate it against a given environment (defaults to `process.env`)
- * @param def - The environment variable schema
- * @param env - The environment variables to validate, defaults to `process.env`
- * @returns The validated environment variable schema
+ * The root scope for the ArkEnv library, containing extensions to the ArkType scopes with ArkEnv-specific types like `string.host` and `number.port`.
  */
-declare const defineEnv: <const T extends Record<string, string | undefined>>(def: EnvSchema<T>, env?: UserEnvironment) => distill.Out<type.infer<T>>;
+declare const $: arktype.Scope<{
+    string: arktype.Submodule<{
+        root: string;
+        " arkInferred": string;
+        trim: arktype.Submodule<arktype_internal_keywords_string_ts.trim.$ & {
+            " arkInferred": (In: string) => arktype_internal_attributes_ts.To<string>;
+        }>;
+        normalize: arktype.Submodule<arktype_internal_keywords_string_ts.normalize.$ & {
+            " arkInferred": (In: string) => arktype_internal_attributes_ts.To<string>;
+        }>;
+        alpha: string;
+        alphanumeric: string;
+        hex: string;
+        base64: arktype.Submodule<{
+            root: string;
+            url: string;
+        } & {
+            " arkInferred": string;
+        }>;
+        capitalize: arktype.Submodule<arktype_internal_keywords_string_ts.capitalize.$ & {
+            " arkInferred": (In: string) => arktype_internal_attributes_ts.To<string>;
+        }>;
+        creditCard: string;
+        date: arktype.Submodule<arktype_internal_keywords_string_ts.stringDate.$ & {
+            " arkInferred": string;
+        }>;
+        digits: string;
+        email: string;
+        integer: arktype.Submodule<arktype_internal_keywords_string_ts.stringInteger.$ & {
+            " arkInferred": string;
+        }>;
+        ip: arktype.Submodule<arktype_internal_keywords_string_ts.ip.$ & {
+            " arkInferred": string;
+        }>;
+        json: arktype.Submodule<arktype_internal_keywords_string_ts.stringJson.$ & {
+            " arkInferred": string;
+        }>;
+        lower: arktype.Submodule<arktype_internal_keywords_string_ts.lower.$ & {
+            " arkInferred": (In: string) => arktype_internal_attributes_ts.To<string>;
+        }>;
+        numeric: arktype.Submodule<arktype_internal_keywords_string_ts.stringNumeric.$ & {
+            " arkInferred": string;
+        }>;
+        regex: string;
+        semver: string;
+        upper: arktype.Submodule<{
+            root: (In: string) => arktype_internal_attributes_ts.To<string>;
+            preformatted: string;
+        } & {
+            " arkInferred": (In: string) => arktype_internal_attributes_ts.To<string>;
+        }>;
+        url: arktype.Submodule<arktype_internal_keywords_string_ts.url.$ & {
+            " arkInferred": string;
+        }>;
+        uuid: arktype.Submodule<arktype_internal_keywords_string_ts.uuid.$ & {
+            " arkInferred": string;
+        }>;
+        host: string;
+    }>;
+    number: arktype.Submodule<{
+        NaN: number;
+        Infinity: number;
+        root: number;
+        " arkInferred": number;
+        integer: number;
+        epoch: number;
+        safe: number;
+        NegativeInfinity: number;
+        port: (In: string) => arktype.Out<number>;
+    }>;
+}>;
 
+type RuntimeEnvironment = Record<string, string | undefined>;
+type EnvSchema<def, $ = {}> = type.validate<def, $>;
 /**
- * A `string` that can be parsed into a number between 0 and 65535
- */
-declare const port: arktype_internal_methods_morph_ts.MorphType<(In: string) => arktype_internal_attributes_ts.Out<number>, {}>;
-/**
- * An IP address or `"localhost"`
+ * Create an environment variables object from a schema and an environment
+ * @param def - The environment variable schema
+ * @param env - The environment variables to validate, defaults to `process.env`
+ * @returns The validated environment variable schema
+ * @throws An error if the environment variables are invalid. See {@link ArkEnvError}
  */
-declare const host: arktype_internal_methods_string_ts.StringType<string, {}>;
+declare function createEnv<const T extends Record<string, string | undefined>>(def: EnvSchema<T, (typeof $)["t"]>, env?: RuntimeEnvironment): distill.Out<type.infer<T, (typeof $)["t"]>>;
+declare function createEnv<const T extends Record<string, string | undefined>>(def: EnvSchema<T>, env?: RuntimeEnvironment): distill.Out<type.infer<T>>;
 
 declare const _default: {
-    port: arktype_internal_methods_morph_ts.MorphType<(In: string) => arktype_internal_attributes_ts.Out<number>, {}>;
-    host: arktype_internal_methods_string_ts.StringType<string, {}>;
-    defineEnv: <const T extends Record<string, string | undefined>>(def: EnvSchema<T>, env?: {
+    createEnv<const T extends Record<string, string | undefined>>(def: EnvSchema<T, typeof $["t"]>, env?: {
+        [x: string]: string | undefined;
+    }): arktype.distill.Out<arktype.type.infer<T, typeof $["t"]>>;
+    createEnv<const T extends Record<string, string | undefined>>(def: EnvSchema<T>, env?: {
         [x: string]: string | undefined;
-    }) => arktype.distill.Out<arktype.type.infer<T>>;
+    }): arktype.distill.Out<arktype.type.infer<T>>;
 };
 
-export { type EnvSchema, _default as default, defineEnv, host, port };
+export { type EnvSchema, createEnv, _default as default };

package/dist/index.js

@@ -4,12 +4,12 @@ var __export = (target, all) => {
     __defProp(target, name, { get: all[name], enumerable: true });
 };
 
-// src/define-env.ts
-var define_env_exports = {};
-__export(define_env_exports, {
-  defineEnv: () => defineEnv
+// src/create-env.ts
+var create_env_exports = {};
+__export(create_env_exports, {
+  createEnv: () => createEnv
 });
-import { type } from "arktype";
+import { type as type3 } from "arktype";
 
 // src/errors.ts
 import chalk from "chalk";
@@ -42,30 +42,12 @@ ${indent(formatErrors(errors))}
   }
 };
 
-// src/define-env.ts
-var defineEnv = (def, env = process.env) => {
-  const schema = type(def);
-  const requiredEnvKeys = Object.keys(
-    def
-  );
-  const filteredEnvVars = Object.fromEntries(
-    Object.entries(env).filter(([key]) => requiredEnvKeys.includes(key))
-  );
-  const validatedEnv = schema(filteredEnvVars);
-  if (validatedEnv instanceof type.errors) {
-    throw new ArkEnvError(validatedEnv);
-  }
-  return validatedEnv;
-};
+// src/scope.ts
+import { scope, type as type2 } from "arktype";
 
 // src/types.ts
-var types_exports = {};
-__export(types_exports, {
-  host: () => host,
-  port: () => port
-});
-import { type as type2 } from "arktype";
-var port = type2("string", "=>", (data, ctx) => {
+import { type } from "arktype";
+var port = type("string", "=>", (data, ctx) => {
   const asNumber = Number.parseInt(data);
   const isInteger = Number.isInteger(asNumber);
   const isBetween = 0 <= asNumber && asNumber <= 65535;
@@ -74,13 +56,33 @@ var port = type2("string", "=>", (data, ctx) => {
   }
   return asNumber;
 });
-var host = type2("string.ip | 'localhost'");
+var host = type("string.ip | 'localhost'");
+
+// src/scope.ts
+var $ = scope({
+  string: type2.module({
+    ...type2.keywords.string,
+    host
+  }),
+  number: type2.module({
+    ...type2.keywords.number,
+    port
+  })
+});
+
+// src/create-env.ts
+function createEnv(def, env = process.env) {
+  const schema = $.type.raw(def);
+  const validatedEnv = schema(env);
+  if (validatedEnv instanceof type3.errors) {
+    throw new ArkEnvError(validatedEnv);
+  }
+  return validatedEnv;
+}
 
 // src/index.ts
-var index_default = { ...define_env_exports, ...types_exports };
+var index_default = { ...create_env_exports };
 export {
-  index_default as default,
-  defineEnv,
-  host,
-  port
+  createEnv,
+  index_default as default
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "arkenv",
   "type": "module",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -23,7 +23,7 @@
     "validation"
   ],
   "license": "MIT",
-  "homepage": "https://yam.codes/arkenv",
+  "homepage": "https://arkenv.js.org",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/yamcodes/arkenv.git"
@@ -37,7 +37,7 @@
     "typescript": "^5.9.2"
   },
   "peerDependencies": {
-    "arktype": "^2.0.2"
+    "arktype": "^2.1.22"
   },
   "dependencies": {
     "chalk": "^5.6.0"
@@ -47,6 +47,7 @@
     "test:once": "pnpm test",
     "typecheck": "tsc --noEmit",
     "clean": "rimraf dist node_modules",
-    "test": "pnpm -w test --project arkenv"
+    "test": "pnpm -w test --project arkenv",
+    "fix": "pnpm -w run fix"
   }
 }