zenvx 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sean Wilfred T. Custodio
+
+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/README.md

@@ -0,0 +1,142 @@
+# zenvx
+
+**Type-safe environment variables with Zen-like peace of mind.**
+
+`zenvx` is a lightweight wrapper around **Zod** and **dotenv** designed to fix the common headaches of environment variables in Node.js / TypeScript. It provides strict validation (blocking `"123"` as an API Key), smart coercion, and beautiful, human-readable error reporting.
+
+![License](https://img.shields.io/badge/license-MIT-blue.svg)
+![TypeScript](https://img.shields.io/badge/built%20with-TypeScript-blue)
+![NPM](https://img.shields.io/npm/v/zenvx)
+
+---
+
+## Why zenvx?
+
+Standard Zod is great, but environment variables are always strings. This leads to common pitfalls:
+
+- `z.string()` accepts `"12345"`, which is usually a mistake for API keys
+- `z.boolean()` fails on `"true"` strings
+- Validation errors are often ugly JSON dumps that clog your terminal
+
+**zenvx solves this:**
+
+1. **Strict Validators** – `tx.string()` ensures values are text, not just numbers
+2. **Smart Coercion** – Automatically handles ports, numbers, and booleans
+3. **Beautiful Errors** – Formatting that tells you exactly what to fix
+
+---
+
+## Installation
+
+```bash
+npm install zenvx zod
+# or
+pnpm add zenvx zod
+# or
+yarn add zenvx zod
+```
+
+> Note: Zod is a peer dependency, so you must have it installed.
+
+## Quick Start
+
+Create a file (e.g., src/env.ts) and export your configuration:
+
+```javascript
+import { defineEnv, tx } from "zenvx";
+
+export const env = defineEnv({
+  // 1. Smart Coercion
+  PORT: tx.port(), // Coerces "3000" -> 3000
+  DEBUG: tx.bool(), // Coerces "true"/"1" -> true
+
+  // 2. Strict Validation
+  DATABASE_URL: tx.url(), // Must be a valid URL
+  API_KEY: tx.string(), // "12345" will FAIL (Must be text)
+
+  // 3. Native Zod Support (optional)
+  NODE_ENV: tx.enum(["development", "production"]),
+});
+```
+
+Now use it anywhere in your app:
+
+```javascript
+import { env } from "./env";
+
+console.log(`Server running on port ${env.PORT}`);
+// TypeScript knows env.PORT is a number!
+```
+
+## Beautiful Error Handling
+
+If your .env file is missing values or has invalid types, zenvx stops the process immediately and prints a clear message:
+
+```
+┌──────────────────────────────────────────────┐
+│ ❌ INVALID ENVIRONMENT VARIABLES DETECTED │
+└──────────────────────────────────────────────┘
+PORT: Must be a valid port (1-65535)
+API_KEY: Value should be text, but looks like a number.
+DATABASE_URL: Must be a valid URL
+```
+
+# The `tx` Validator Helper
+
+`zenvx` provides a `tx` object with pre-configured Zod schemas optimized for `.env` files.
+
+| Validator        | Description                                                        | Example Input (.env) | Result (JS)     |
+| ---------------- | ------------------------------------------------------------------ | -------------------- | --------------- |
+| `tx.string()`    | Strict string. Rejects purely numeric values (prevents lazy keys). | `abc_key`            | `"abc_key"`     |
+| `tx.number()`    | Coerces string to number.                                          | `"50"`               | `50`            |
+| `tx.bool()`      | Smart boolean. Accepts true, false, 1, 0.                          | `"true"`, `"1"`      | `true`          |
+| `tx.port()`      | Validates port range (1-65535).                                    | `"3000"`             | `3000`          |
+| `tx.url()`       | Strict URL validation.                                             | `"https://site.com"` | `"https://..."` |
+| `tx.email()`     | Valid email address.                                               | `"admin@app.com"`    | `"admin@..."`   |
+| `tx.json()`      | Parses a JSON string into an Object.                               | `{"foo":"bar"}`      | `{foo: "bar"}`  |
+| `tx.enum([...])` | Strict allow-list.                                                 | `"PROD"`             | `"PROD"`        |
+| `tx.ip()`        | Validates IPv4 format.                                             | `"192.168.1.1"`      | `"192..."`      |
+
+## Customizing Error Messages
+
+Every tx validator accepts an optional custom error message.
+
+```javascript
+export const env = defineEnv({
+  API_KEY: tx.string("Please provide a REAL API Key, not just numbers!"),
+  PORT: tx.port("Port is invalid or out of range"),
+});
+```
+
+## Advanced Configuration
+
+Custom .env Path
+
+By default, zenvx looks for .env in your project root. You can change this:
+
+```javascript
+export const env = defineEnv(
+  {
+    PORT: tx.port(),
+  },
+  {
+    path: "./config/.env.production",
+  },
+);
+```
+
+## Mixing with Standard Zod
+
+You can mix tx helpers with standard Zod schemas if you need specific logic.
+
+```javascript
+import { defineEnv, tx } from "zenvx";
+import { z } from "zod";
+
+export const env = defineEnv({
+  PORT: tx.port(),
+
+  // Standard Zod Schema
+  APP_NAME: z.string().min(5).default("My Super App"),
+});
+```

package/dist/index.cjs

@@ -0,0 +1,175 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  defineEnv: () => defineEnv,
+  tx: () => tx
+});
+module.exports = __toCommonJS(index_exports);
+var import_zod2 = require("zod");
+
+// src/loaders/dotenv.ts
+var import_dotenv = __toESM(require("dotenv"), 1);
+var import_fs = __toESM(require("fs"), 1);
+function loadDotEnv(path = ".env") {
+  if (!import_fs.default.existsSync(path)) {
+    throw new Error(
+      `[envx] .env file not found at path "${path}"
+Tip: Set { dotenv: false } if you manage environment variables yourself.`
+    );
+  }
+  const result = import_dotenv.default.config({ path });
+  if (result.error) {
+    throw result.error;
+  }
+  return result.parsed ?? {};
+}
+
+// src/core/parser.ts
+var import_zod = require("zod");
+function parseEnv(schema, source) {
+  const result = schema.safeParse(source);
+  if (!result.success) {
+    const issues = result.error.issues.map((i) => `\u274C ${i.path.join(".")}: ${i.message}`).join("\n");
+    throw new Error(
+      [
+        "",
+        "\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510",
+        "\u2502  \u274C INVALID ENVIRONMENT VARIABLES DETECTED   \u2502",
+        "\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518",
+        issues,
+        ""
+      ].join("\n")
+    );
+  }
+  return result.data;
+}
+
+// src/core/proxy.ts
+function createTypedProxy(obj) {
+  return new Proxy(obj, {
+    get(target, prop) {
+      if (!(prop in target)) {
+        console.error(
+          `\u274C Tried to access undefined environment variable "${prop}"`
+        );
+        process.exit(1);
+      }
+      return target[prop];
+    }
+  });
+}
+
+// src/index.ts
+var tx = {
+  /**
+   * STRICT STRING:
+   * Rejects purely numeric strings (e.g. "12345").
+   * Good for API Keys.
+   */
+  string: (message) => import_zod2.z.string().refine((val) => !/^\d+$/.test(val), {
+    error: message || "Value should be text, but looks like a number."
+  }),
+  /**
+   * SMART NUMBER:
+   * Automatically converts "3000" -> 3000.
+   * Fails if the value is not a valid number (e.g. "abc").
+   */
+  number: (message) => import_zod2.z.coerce.number({ error: message || "Must be a number" }),
+  /**
+   * PORT VALIDATOR:
+   * Coerces to number and ensures it is between 1 and 65535.
+   */
+  port: (message) => import_zod2.z.coerce.number().min(1).max(65535).catch((ctx) => {
+    ctx.error;
+    return -1;
+  }).refine((val) => val >= 1 && val <= 65535, {
+    error: message || "Must be a valid port (1-65535)."
+  }),
+  /**
+   * SMART BOOLEAN:
+   * Handles "true", "TRUE", "1" -> true
+   * Handles "false", "FALSE", "0" -> false
+   * Throws error on anything else.
+   */
+  bool: (message) => import_zod2.z.string().transform((val, ctx) => {
+    const v = val.toLowerCase();
+    if (v === "true" || v === "1") return true;
+    if (v === "false" || v === "0") return false;
+    ctx.addIssue({
+      code: import_zod2.z.ZodIssueCode.custom,
+      error: message || "Must be a boolean (true/false or 1/0)."
+    });
+    return import_zod2.z.NEVER;
+  }),
+  /**
+   * URL:
+   * Strict URL checking.
+   */
+  url: (message) => import_zod2.z.url({ error: message || "Must be a valid URL (e.g. https://...)" }),
+  /**
+   * EMAIL:
+   * Strict Email checking.
+   */
+  email: (message) => import_zod2.z.email({ error: message || "Must be a valid email address." }),
+  positiveNumber: (message) => import_zod2.z.coerce.number().refine((val) => val > 0, { error: message || "Must be > 0" }),
+  nonEmptyString: (message) => import_zod2.z.string().min(1, { error: message || "Cannot be empty" }),
+  semver: (message) => import_zod2.z.string().refine((val) => /^\d+\.\d+\.\d+(-[0-9A-Za-z-.]+)?$/.test(val), {
+    error: message || "Must be valid semver"
+  }),
+  path: (message) => import_zod2.z.string().min(1, { error: message || "Must be a valid path" }),
+  enum: (values, message) => import_zod2.z.string().refine((val) => values.includes(val), {
+    error: message || `Must be one of: ${values.join(", ")}`
+  }),
+  json: (message) => import_zod2.z.string().transform((val, ctx) => {
+    try {
+      return JSON.parse(val);
+    } catch {
+      ctx.addIssue({
+        code: import_zod2.z.ZodIssueCode.custom,
+        message: message || "Must be valid JSON"
+      });
+      return import_zod2.z.NEVER;
+    }
+  })
+};
+function defineEnv(shape, options) {
+  const fileEnv = loadDotEnv(options?.path);
+  const merged = { ...fileEnv, ...process.env };
+  const schema = import_zod2.z.object(shape);
+  const parsed = parseEnv(schema, merged);
+  return createTypedProxy(parsed);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  defineEnv,
+  tx
+});

package/dist/index.d.cts

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+
+interface DefineEnvOptions {
+    path?: string;
+}
+declare const tx: {
+    /**
+     * STRICT STRING:
+     * Rejects purely numeric strings (e.g. "12345").
+     * Good for API Keys.
+     */
+    string: (message?: string) => z.ZodString;
+    /**
+     * SMART NUMBER:
+     * Automatically converts "3000" -> 3000.
+     * Fails if the value is not a valid number (e.g. "abc").
+     */
+    number: (message?: string) => z.ZodCoercedNumber<unknown>;
+    /**
+     * PORT VALIDATOR:
+     * Coerces to number and ensures it is between 1 and 65535.
+     */
+    port: (message?: string) => z.ZodCatch<z.ZodCoercedNumber<unknown>>;
+    /**
+     * SMART BOOLEAN:
+     * Handles "true", "TRUE", "1" -> true
+     * Handles "false", "FALSE", "0" -> false
+     * Throws error on anything else.
+     */
+    bool: (message?: string) => z.ZodPipe<z.ZodString, z.ZodTransform<boolean, string>>;
+    /**
+     * URL:
+     * Strict URL checking.
+     */
+    url: (message?: string) => z.ZodURL;
+    /**
+     * EMAIL:
+     * Strict Email checking.
+     */
+    email: (message?: string) => z.ZodEmail;
+    positiveNumber: (message?: string) => z.ZodCoercedNumber<unknown>;
+    nonEmptyString: (message?: string) => z.ZodString;
+    semver: (message?: string) => z.ZodString;
+    path: (message?: string) => z.ZodString;
+    enum: <T extends readonly [string, ...string[]]>(values: T, message?: string) => z.ZodString;
+    json: (message?: string) => z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>;
+};
+declare function defineEnv<T extends z.ZodRawShape>(shape: T, options?: DefineEnvOptions): { [K in keyof T]: z.core.output<T[K]>; };
+
+export { defineEnv, tx };

package/dist/index.d.ts

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+
+interface DefineEnvOptions {
+    path?: string;
+}
+declare const tx: {
+    /**
+     * STRICT STRING:
+     * Rejects purely numeric strings (e.g. "12345").
+     * Good for API Keys.
+     */
+    string: (message?: string) => z.ZodString;
+    /**
+     * SMART NUMBER:
+     * Automatically converts "3000" -> 3000.
+     * Fails if the value is not a valid number (e.g. "abc").
+     */
+    number: (message?: string) => z.ZodCoercedNumber<unknown>;
+    /**
+     * PORT VALIDATOR:
+     * Coerces to number and ensures it is between 1 and 65535.
+     */
+    port: (message?: string) => z.ZodCatch<z.ZodCoercedNumber<unknown>>;
+    /**
+     * SMART BOOLEAN:
+     * Handles "true", "TRUE", "1" -> true
+     * Handles "false", "FALSE", "0" -> false
+     * Throws error on anything else.
+     */
+    bool: (message?: string) => z.ZodPipe<z.ZodString, z.ZodTransform<boolean, string>>;
+    /**
+     * URL:
+     * Strict URL checking.
+     */
+    url: (message?: string) => z.ZodURL;
+    /**
+     * EMAIL:
+     * Strict Email checking.
+     */
+    email: (message?: string) => z.ZodEmail;
+    positiveNumber: (message?: string) => z.ZodCoercedNumber<unknown>;
+    nonEmptyString: (message?: string) => z.ZodString;
+    semver: (message?: string) => z.ZodString;
+    path: (message?: string) => z.ZodString;
+    enum: <T extends readonly [string, ...string[]]>(values: T, message?: string) => z.ZodString;
+    json: (message?: string) => z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>;
+};
+declare function defineEnv<T extends z.ZodRawShape>(shape: T, options?: DefineEnvOptions): { [K in keyof T]: z.core.output<T[K]>; };
+
+export { defineEnv, tx };

package/dist/index.js

@@ -0,0 +1,139 @@
+// src/index.ts
+import { z as z2 } from "zod";
+
+// src/loaders/dotenv.ts
+import dotenv from "dotenv";
+import fs from "fs";
+function loadDotEnv(path = ".env") {
+  if (!fs.existsSync(path)) {
+    throw new Error(
+      `[envx] .env file not found at path "${path}"
+Tip: Set { dotenv: false } if you manage environment variables yourself.`
+    );
+  }
+  const result = dotenv.config({ path });
+  if (result.error) {
+    throw result.error;
+  }
+  return result.parsed ?? {};
+}
+
+// src/core/parser.ts
+import "zod";
+function parseEnv(schema, source) {
+  const result = schema.safeParse(source);
+  if (!result.success) {
+    const issues = result.error.issues.map((i) => `\u274C ${i.path.join(".")}: ${i.message}`).join("\n");
+    throw new Error(
+      [
+        "",
+        "\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510",
+        "\u2502  \u274C INVALID ENVIRONMENT VARIABLES DETECTED   \u2502",
+        "\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518",
+        issues,
+        ""
+      ].join("\n")
+    );
+  }
+  return result.data;
+}
+
+// src/core/proxy.ts
+function createTypedProxy(obj) {
+  return new Proxy(obj, {
+    get(target, prop) {
+      if (!(prop in target)) {
+        console.error(
+          `\u274C Tried to access undefined environment variable "${prop}"`
+        );
+        process.exit(1);
+      }
+      return target[prop];
+    }
+  });
+}
+
+// src/index.ts
+var tx = {
+  /**
+   * STRICT STRING:
+   * Rejects purely numeric strings (e.g. "12345").
+   * Good for API Keys.
+   */
+  string: (message) => z2.string().refine((val) => !/^\d+$/.test(val), {
+    error: message || "Value should be text, but looks like a number."
+  }),
+  /**
+   * SMART NUMBER:
+   * Automatically converts "3000" -> 3000.
+   * Fails if the value is not a valid number (e.g. "abc").
+   */
+  number: (message) => z2.coerce.number({ error: message || "Must be a number" }),
+  /**
+   * PORT VALIDATOR:
+   * Coerces to number and ensures it is between 1 and 65535.
+   */
+  port: (message) => z2.coerce.number().min(1).max(65535).catch((ctx) => {
+    ctx.error;
+    return -1;
+  }).refine((val) => val >= 1 && val <= 65535, {
+    error: message || "Must be a valid port (1-65535)."
+  }),
+  /**
+   * SMART BOOLEAN:
+   * Handles "true", "TRUE", "1" -> true
+   * Handles "false", "FALSE", "0" -> false
+   * Throws error on anything else.
+   */
+  bool: (message) => z2.string().transform((val, ctx) => {
+    const v = val.toLowerCase();
+    if (v === "true" || v === "1") return true;
+    if (v === "false" || v === "0") return false;
+    ctx.addIssue({
+      code: z2.ZodIssueCode.custom,
+      error: message || "Must be a boolean (true/false or 1/0)."
+    });
+    return z2.NEVER;
+  }),
+  /**
+   * URL:
+   * Strict URL checking.
+   */
+  url: (message) => z2.url({ error: message || "Must be a valid URL (e.g. https://...)" }),
+  /**
+   * EMAIL:
+   * Strict Email checking.
+   */
+  email: (message) => z2.email({ error: message || "Must be a valid email address." }),
+  positiveNumber: (message) => z2.coerce.number().refine((val) => val > 0, { error: message || "Must be > 0" }),
+  nonEmptyString: (message) => z2.string().min(1, { error: message || "Cannot be empty" }),
+  semver: (message) => z2.string().refine((val) => /^\d+\.\d+\.\d+(-[0-9A-Za-z-.]+)?$/.test(val), {
+    error: message || "Must be valid semver"
+  }),
+  path: (message) => z2.string().min(1, { error: message || "Must be a valid path" }),
+  enum: (values, message) => z2.string().refine((val) => values.includes(val), {
+    error: message || `Must be one of: ${values.join(", ")}`
+  }),
+  json: (message) => z2.string().transform((val, ctx) => {
+    try {
+      return JSON.parse(val);
+    } catch {
+      ctx.addIssue({
+        code: z2.ZodIssueCode.custom,
+        message: message || "Must be valid JSON"
+      });
+      return z2.NEVER;
+    }
+  })
+};
+function defineEnv(shape, options) {
+  const fileEnv = loadDotEnv(options?.path);
+  const merged = { ...fileEnv, ...process.env };
+  const schema = z2.object(shape);
+  const parsed = parseEnv(schema, merged);
+  return createTypedProxy(parsed);
+}
+export {
+  defineEnv,
+  tx
+};

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "zenvx",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "author": {
+    "name": "Sean Wilfred T. Custodio",
+    "email": "custodiocsean@gmail.com"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts --external zod,dotenv",
+    "dev": "tsup src/index.ts --watch --external zod,dotenv",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "prepublishOnly": "npm run lint && npm run build",
+    "clean": "rimraf dist",
+    "test": "vitest run"
+  },
+  "peerDependencies": {
+    "zod": "^4.3.5"
+  },
+  "dependencies": {
+    "dotenv": "^16.4.7"
+  },
+  "peerDependenciesMeta": {
+    "zod": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.9",
+    "@typescript-eslint/eslint-plugin": "^8.53.1",
+    "@typescript-eslint/parser": "^8.53.1",
+    "dotenv": "^17.2.3",
+    "eslint": "^9.39.2",
+    "rimraf": "^5.0.0",
+    "tsup": "^8.5.1",
+    "vitest": "^4.0.17",
+    "zod": "^4.3.5"
+  }
+}