zenvx 0.2.0 → 0.2.1

package/dist/chunk-E7OYVDFC.js

@@ -0,0 +1,67 @@
+// src/core/tx.ts
+import { z } from "zod";
+var SEMVER_REGEX = /^\d+\.\d+\.\d+(-[0-9A-Za-z-.]+)?$/;
+var tx = {
+  /**
+   * STRICT STRING:
+   * Rejects purely numeric strings (e.g. "12345").
+   * Good for API Keys.
+   */
+  string: (message = "Value should be text, but looks like a number.") => z.string().trim().regex(/^(?!\d+$).+$/, { error: message }).describe("Non-numeric string"),
+  /**
+   * SMART NUMBER:
+   * Automatically converts "3000" -> 3000.
+   * Fails if the value is not a valid number (e.g. "abc").
+   */
+  number: (message = "Must be a number") => z.coerce.number({ error: message }).finite().describe("Numeric value"),
+  /**
+   * PORT VALIDATOR:
+   * Coerces to number and ensures it is between 1 and 65535.
+   */
+  port: (message = "Must be a valid port (1\u201365535)") => z.coerce.number({ error: message }).int().min(1).max(65535).describe("TCP/UDP port number (1\u201365535)"),
+  /**
+   * SMART BOOLEAN:
+   * Handles "true", "TRUE", "1" -> true
+   * Handles "false", "FALSE", "0" -> false
+   * Throws error on anything else.
+   */
+  bool: (message) => {
+    return z.union([z.string(), z.boolean()]).transform((val, ctx) => {
+      if (typeof val === "boolean") return val;
+      const v = val.toLowerCase();
+      if (v === "true" || v === "1") return true;
+      if (v === "false" || v === "0") return false;
+      ctx.addIssue({
+        code: z.ZodIssueCode.custom,
+        message: message || 'Must be a boolean ("true"/"false"/"1"/"0")'
+      });
+      return z.NEVER;
+    });
+  },
+  /**
+   * URL:
+   * Strict URL checking.
+   */
+  url: (message = "Must be a valid URL (e.g. https://...)") => z.url({ error: message }).describe("A valid URL including protocol"),
+  email: (message = "Must be a valid email address") => z.email({ error: message }).describe("A valid email address"),
+  positiveNumber: (message = "Must be > 0") => z.coerce.number().gt(0, { error: message }).describe("A positive number"),
+  nonEmptyString: (message = "Cannot be empty") => z.string().trim().min(1, { error: message }).describe("A non-empty string"),
+  semver: (message = "Must be valid semver") => z.string().regex(SEMVER_REGEX, { error: message }).describe("Semantic version (x.y.z)"),
+  path: (message = "Must be a valid path") => z.string().trim().min(1, { error: message }).describe("Filesystem path"),
+  enum: (values, message = `Must be one of: ${values.join(", ")}`) => z.enum(values, { error: message }).describe(`One of: ${values.join(", ")}`),
+  json: (message = "Must be valid JSON") => z.string().transform((val, ctx) => {
+    try {
+      return JSON.parse(val);
+    } catch {
+      ctx.addIssue({
+        code: "custom",
+        error: message
+      });
+      return z.NEVER;
+    }
+  }).describe("JSON-encoded value")
+};
+
+export {
+  tx
+};

package/dist/chunk-ELPQSMQJ.js

@@ -0,0 +1,24 @@
+import {
+  generateExample
+} from "./chunk-KGVPNFG3.js";
+import {
+  parseEnv
+} from "./chunk-3HCQKBTL.js";
+import {
+  createTypedProxy
+} from "./chunk-DX3SLVGQ.js";
+
+// src/core/define-env.ts
+import { z } from "zod";
+function defineEnv(shape, source, options) {
+  const schema = z.object(shape);
+  const parsed = parseEnv(schema, source, options?.mode ?? "runtime");
+  if (options?.generateExample) {
+    generateExample(schema);
+  }
+  return createTypedProxy(parsed);
+}
+
+export {
+  defineEnv
+};

package/dist/chunk-KGVPNFG3.js

@@ -0,0 +1,43 @@
+// src/core/generate-example.ts
+import {
+  ZodDefault,
+  ZodOptional,
+  ZodString,
+  ZodNumber,
+  ZodBoolean
+} from "zod";
+import fs from "fs";
+function getZodTypeName(schema) {
+  let type = "unknown";
+  if (schema instanceof ZodString) type = "string";
+  else if (schema instanceof ZodNumber) type = "number";
+  else if (schema instanceof ZodBoolean) type = "boolean";
+  return type;
+}
+function generateExample(schema, path = ".env.example") {
+  const header = [
+    "# Example environment variables",
+    "# Copy this file to .env and fill in the values",
+    ""
+  ];
+  const lines = Object.entries(schema.shape).map(([key, zodSchema]) => {
+    let placeholder = "";
+    let othertype = null;
+    let actualSchema = zodSchema;
+    if (zodSchema instanceof ZodOptional) actualSchema = zodSchema.unwrap();
+    if (zodSchema instanceof ZodDefault) {
+      actualSchema = zodSchema.def.innerType;
+      placeholder = zodSchema.def.defaultValue ?? "";
+      othertype = typeof zodSchema.def.defaultValue;
+    }
+    const type = getZodTypeName(actualSchema);
+    return `${key}=${placeholder ?? ""}  # ${othertype ?? type}`;
+  });
+  const content = [...header, ...lines].join("\n") + "\n";
+  fs.writeFileSync(path, content);
+  console.log(`\u2705 .env.example generated at ${path}`);
+}
+
+export {
+  generateExample
+};

package/dist/chunk-R2XSSP2M.js

@@ -0,0 +1,24 @@
+import {
+  createTypedProxy
+} from "./chunk-DX3SLVGQ.js";
+import {
+  generateExample
+} from "./chunk-KGVPNFG3.js";
+import {
+  parseEnv
+} from "./chunk-3HCQKBTL.js";
+
+// src/core/define-env.ts
+import { z } from "zod";
+function defineEnv(shape, source, options) {
+  const schema = z.object(shape);
+  const parsed = parseEnv(schema, source, options?.mode ?? "runtime");
+  if (options?.generateExample) {
+    generateExample(schema);
+  }
+  return createTypedProxy(parsed);
+}
+
+export {
+  defineEnv
+};

package/dist/core/define-env.cjs

@@ -0,0 +1,125 @@
+"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/core/define-env.ts
+var define_env_exports = {};
+__export(define_env_exports, {
+  defineEnv: () => defineEnv
+});
+module.exports = __toCommonJS(define_env_exports);
+var import_zod3 = require("zod");
+
+// src/core/parser.ts
+var import_zod = require("zod");
+function parseEnv(schema, source, mode = "runtime") {
+  const result = schema.safeParse(source);
+  if (!result.success) {
+    const issues = result.error.issues.map((i) => `\u274C ${i.path.join(".")}: ${i.message}`).join("\n");
+    const header = mode === "build" ? [
+      "\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"
+    ] : [
+      "\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 \u26A0 WARNING INVALID ENVIRONMENT VARIABLES \u26A0  \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"
+    ];
+    const box = ["", ...header, issues, ""].join("\n");
+    if (mode === "build") {
+      throw new Error(box);
+    } else {
+      console.warn(box);
+      process.exit(1);
+    }
+  }
+  return result.success ? 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/core/generate-example.ts
+var import_zod2 = require("zod");
+var import_fs = __toESM(require("fs"), 1);
+function getZodTypeName(schema) {
+  let type = "unknown";
+  if (schema instanceof import_zod2.ZodString) type = "string";
+  else if (schema instanceof import_zod2.ZodNumber) type = "number";
+  else if (schema instanceof import_zod2.ZodBoolean) type = "boolean";
+  return type;
+}
+function generateExample(schema, path = ".env.example") {
+  const header = [
+    "# Example environment variables",
+    "# Copy this file to .env and fill in the values",
+    ""
+  ];
+  const lines = Object.entries(schema.shape).map(([key, zodSchema]) => {
+    let placeholder = "";
+    let othertype = null;
+    let actualSchema = zodSchema;
+    if (zodSchema instanceof import_zod2.ZodOptional) actualSchema = zodSchema.unwrap();
+    if (zodSchema instanceof import_zod2.ZodDefault) {
+      actualSchema = zodSchema.def.innerType;
+      placeholder = zodSchema.def.defaultValue ?? "";
+      othertype = typeof zodSchema.def.defaultValue;
+    }
+    const type = getZodTypeName(actualSchema);
+    return `${key}=${placeholder ?? ""}  # ${othertype ?? type}`;
+  });
+  const content = [...header, ...lines].join("\n") + "\n";
+  import_fs.default.writeFileSync(path, content);
+  console.log(`\u2705 .env.example generated at ${path}`);
+}
+
+// src/core/define-env.ts
+function defineEnv(shape, source, options) {
+  const schema = import_zod3.z.object(shape);
+  const parsed = parseEnv(schema, source, options?.mode ?? "runtime");
+  if (options?.generateExample) {
+    generateExample(schema);
+  }
+  return createTypedProxy(parsed);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  defineEnv
+});

package/dist/core/define-env.d.cts

@@ -0,0 +1,6 @@
+import { z } from 'zod';
+import { DefineEnvOptions } from './types.cjs';
+
+declare function defineEnv<T extends z.ZodRawShape>(shape: T, source: Record<string, unknown>, options?: DefineEnvOptions): { [K in keyof T]: z.core.output<T[K]>; };
+
+export { defineEnv };

package/dist/core/define-env.d.ts

@@ -0,0 +1,6 @@
+import { z } from 'zod';
+import { DefineEnvOptions } from './types.js';
+
+declare function defineEnv<T extends z.ZodRawShape>(shape: T, source: Record<string, unknown>, options?: DefineEnvOptions): { [K in keyof T]: z.core.output<T[K]>; };
+
+export { defineEnv };

package/dist/core/define-env.js

@@ -0,0 +1,9 @@
+import {
+  defineEnv
+} from "../chunk-ELPQSMQJ.js";
+import "../chunk-KGVPNFG3.js";
+import "../chunk-3HCQKBTL.js";
+import "../chunk-DX3SLVGQ.js";
+export {
+  defineEnv
+};

package/dist/core/generate-example.cjs

@@ -0,0 +1,71 @@
+"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/core/generate-example.ts
+var generate_example_exports = {};
+__export(generate_example_exports, {
+  generateExample: () => generateExample
+});
+module.exports = __toCommonJS(generate_example_exports);
+var import_zod = require("zod");
+var import_fs = __toESM(require("fs"), 1);
+function getZodTypeName(schema) {
+  let type = "unknown";
+  if (schema instanceof import_zod.ZodString) type = "string";
+  else if (schema instanceof import_zod.ZodNumber) type = "number";
+  else if (schema instanceof import_zod.ZodBoolean) type = "boolean";
+  return type;
+}
+function generateExample(schema, path = ".env.example") {
+  const header = [
+    "# Example environment variables",
+    "# Copy this file to .env and fill in the values",
+    ""
+  ];
+  const lines = Object.entries(schema.shape).map(([key, zodSchema]) => {
+    let placeholder = "";
+    let othertype = null;
+    let actualSchema = zodSchema;
+    if (zodSchema instanceof import_zod.ZodOptional) actualSchema = zodSchema.unwrap();
+    if (zodSchema instanceof import_zod.ZodDefault) {
+      actualSchema = zodSchema.def.innerType;
+      placeholder = zodSchema.def.defaultValue ?? "";
+      othertype = typeof zodSchema.def.defaultValue;
+    }
+    const type = getZodTypeName(actualSchema);
+    return `${key}=${placeholder ?? ""}  # ${othertype ?? type}`;
+  });
+  const content = [...header, ...lines].join("\n") + "\n";
+  import_fs.default.writeFileSync(path, content);
+  console.log(`\u2705 .env.example generated at ${path}`);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  generateExample
+});

package/dist/core/generate-example.d.cts

@@ -0,0 +1,5 @@
+import { ZodRawShape, ZodObject } from 'zod';
+
+declare function generateExample<T extends ZodRawShape>(schema: ZodObject<T>, path?: string): void;
+
+export { generateExample };

package/dist/core/generate-example.d.ts

@@ -0,0 +1,5 @@
+import { ZodRawShape, ZodObject } from 'zod';
+
+declare function generateExample<T extends ZodRawShape>(schema: ZodObject<T>, path?: string): void;
+
+export { generateExample };

package/dist/core/generate-example.js

@@ -0,0 +1,6 @@
+import {
+  generateExample
+} from "../chunk-KGVPNFG3.js";
+export {
+  generateExample
+};

package/dist/core/parser.cjs

@@ -0,0 +1,53 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/core/parser.ts
+var parser_exports = {};
+__export(parser_exports, {
+  parseEnv: () => parseEnv
+});
+module.exports = __toCommonJS(parser_exports);
+var import_zod = require("zod");
+function parseEnv(schema, source, mode = "runtime") {
+  const result = schema.safeParse(source);
+  if (!result.success) {
+    const issues = result.error.issues.map((i) => `\u274C ${i.path.join(".")}: ${i.message}`).join("\n");
+    const header = mode === "build" ? [
+      "\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"
+    ] : [
+      "\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 \u26A0 WARNING INVALID ENVIRONMENT VARIABLES \u26A0  \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"
+    ];
+    const box = ["", ...header, issues, ""].join("\n");
+    if (mode === "build") {
+      throw new Error(box);
+    } else {
+      console.warn(box);
+      process.exit(1);
+    }
+  }
+  return result.success ? result.data : {};
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  parseEnv
+});

package/dist/core/parser.d.cts

@@ -0,0 +1,6 @@
+import { ZodRawShape, ZodObject, z } from 'zod';
+import { ValidationMode } from './types.cjs';
+
+declare function parseEnv<T extends ZodRawShape>(schema: ZodObject<T>, source: Record<string, unknown>, mode?: ValidationMode): z.infer<ZodObject<T>>;
+
+export { parseEnv };

package/dist/core/parser.d.ts

@@ -0,0 +1,6 @@
+import { ZodRawShape, ZodObject, z } from 'zod';
+import { ValidationMode } from './types.js';
+
+declare function parseEnv<T extends ZodRawShape>(schema: ZodObject<T>, source: Record<string, unknown>, mode?: ValidationMode): z.infer<ZodObject<T>>;
+
+export { parseEnv };

package/dist/core/parser.js

@@ -0,0 +1,6 @@
+import {
+  parseEnv
+} from "../chunk-3HCQKBTL.js";
+export {
+  parseEnv
+};

package/dist/core/proxy.cjs

@@ -0,0 +1,42 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/core/proxy.ts
+var proxy_exports = {};
+__export(proxy_exports, {
+  createTypedProxy: () => createTypedProxy
+});
+module.exports = __toCommonJS(proxy_exports);
+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];
+    }
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createTypedProxy
+});

package/dist/core/proxy.d.cts

@@ -0,0 +1,3 @@
+declare function createTypedProxy<T extends object>(obj: T): T;
+
+export { createTypedProxy };

package/dist/core/proxy.d.ts

@@ -0,0 +1,3 @@
+declare function createTypedProxy<T extends object>(obj: T): T;
+
+export { createTypedProxy };

package/dist/core/proxy.js

@@ -0,0 +1,6 @@
+import {
+  createTypedProxy
+} from "../chunk-DX3SLVGQ.js";
+export {
+  createTypedProxy
+};

package/dist/core/tx.cjs

@@ -0,0 +1,91 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/core/tx.ts
+var tx_exports = {};
+__export(tx_exports, {
+  tx: () => tx
+});
+module.exports = __toCommonJS(tx_exports);
+var import_zod = require("zod");
+var SEMVER_REGEX = /^\d+\.\d+\.\d+(-[0-9A-Za-z-.]+)?$/;
+var tx = {
+  /**
+   * STRICT STRING:
+   * Rejects purely numeric strings (e.g. "12345").
+   * Good for API Keys.
+   */
+  string: (message = "Value should be text, but looks like a number.") => import_zod.z.string().trim().regex(/^(?!\d+$).+$/, { error: message }).describe("Non-numeric string"),
+  /**
+   * SMART NUMBER:
+   * Automatically converts "3000" -> 3000.
+   * Fails if the value is not a valid number (e.g. "abc").
+   */
+  number: (message = "Must be a number") => import_zod.z.coerce.number({ error: message }).finite().describe("Numeric value"),
+  /**
+   * PORT VALIDATOR:
+   * Coerces to number and ensures it is between 1 and 65535.
+   */
+  port: (message = "Must be a valid port (1\u201365535)") => import_zod.z.coerce.number({ error: message }).int().min(1).max(65535).describe("TCP/UDP port number (1\u201365535)"),
+  /**
+   * SMART BOOLEAN:
+   * Handles "true", "TRUE", "1" -> true
+   * Handles "false", "FALSE", "0" -> false
+   * Throws error on anything else.
+   */
+  bool: (message) => {
+    return import_zod.z.union([import_zod.z.string(), import_zod.z.boolean()]).transform((val, ctx) => {
+      if (typeof val === "boolean") return val;
+      const v = val.toLowerCase();
+      if (v === "true" || v === "1") return true;
+      if (v === "false" || v === "0") return false;
+      ctx.addIssue({
+        code: import_zod.z.ZodIssueCode.custom,
+        message: message || 'Must be a boolean ("true"/"false"/"1"/"0")'
+      });
+      return import_zod.z.NEVER;
+    });
+  },
+  /**
+   * URL:
+   * Strict URL checking.
+   */
+  url: (message = "Must be a valid URL (e.g. https://...)") => import_zod.z.url({ error: message }).describe("A valid URL including protocol"),
+  email: (message = "Must be a valid email address") => import_zod.z.email({ error: message }).describe("A valid email address"),
+  positiveNumber: (message = "Must be > 0") => import_zod.z.coerce.number().gt(0, { error: message }).describe("A positive number"),
+  nonEmptyString: (message = "Cannot be empty") => import_zod.z.string().trim().min(1, { error: message }).describe("A non-empty string"),
+  semver: (message = "Must be valid semver") => import_zod.z.string().regex(SEMVER_REGEX, { error: message }).describe("Semantic version (x.y.z)"),
+  path: (message = "Must be a valid path") => import_zod.z.string().trim().min(1, { error: message }).describe("Filesystem path"),
+  enum: (values, message = `Must be one of: ${values.join(", ")}`) => import_zod.z.enum(values, { error: message }).describe(`One of: ${values.join(", ")}`),
+  json: (message = "Must be valid JSON") => import_zod.z.string().transform((val, ctx) => {
+    try {
+      return JSON.parse(val);
+    } catch {
+      ctx.addIssue({
+        code: "custom",
+        error: message
+      });
+      return import_zod.z.NEVER;
+    }
+  }).describe("JSON-encoded value")
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  tx
+});