zod-validate 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bibek Bhattarai
+
+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,833 @@
+# zod-validate
+
+Reusable validation utilities built on top of [Zod](https://zod.dev/) for frontend and backend applications.
+
+`zod-validate` provides a small layer around Zod's `safeParse()` API so you can create a reusable validator from a schema and use the same validator for:
+
+- Whole-form validation
+- Individual field validation
+- Nested object validation
+- Nested array validation
+- Validation error codes
+- Human-readable message resolution
+- Localized validation messages
+
+The package does **not** replace Zod. Zod remains the validation engine.
+
+---
+
+## Installation
+
+```bash
+npm install zod-validate zod
+```
+
+---
+
+## Why zod-validate?
+
+Zod already provides excellent schema validation.
+
+The problem is usually what happens **around** the schema.
+
+For example, an application may need to:
+
+- Validate an entire form.
+- Validate one field while the user is typing.
+- Keep validation errors associated with their original fields.
+- Handle deeply nested objects and arrays.
+- Return stable validation codes instead of UI-specific messages.
+- Resolve those codes into different languages on the frontend.
+
+`zod-validate` provides a small, consistent API for those tasks.
+
+Instead of repeatedly working directly with Zod's `safeParse()` result, create a validator once:
+
+```ts
+const signup = createValidator(signupSchema);
+```
+
+Then use it wherever needed:
+
+```ts
+signup.validate(data);
+signup.validateField("mobile_no", value);
+```
+
+---
+
+# Basic Usage
+
+## 1. Define a Zod schema
+
+You continue to define your validation rules using Zod.
+
+```ts
+import { z } from "zod";
+
+const signupSchema = z.object({
+  mobile_no: z
+    .string("mobile_no")
+    .trim()
+    .min(1, "mobile_no_required")
+    .regex(/^[0-9]+$/, "mobile_no_digits")
+    .regex(/^(98|97)/, "mobile_no_prefix")
+    .length(10, "mobile_no_length"),
+
+  password: z.string("password").min(8, "password_min_length"),
+});
+```
+
+The validation codes are supplied as Zod messages:
+
+```ts
+"mobile_no_required";
+"mobile_no_digits";
+"mobile_no_prefix";
+"mobile_no_length";
+"password_min_length";
+```
+
+These codes can later be converted into human-readable messages.
+
+---
+
+# 2. Create a Validator
+
+Import `createValidator`:
+
+```ts
+import { createValidator } from "zod-validate";
+```
+
+Create a validator from your schema:
+
+```ts
+const signup = createValidator(signupSchema);
+```
+
+The validator is now tied to that schema.
+
+---
+
+# 3. Validate an Entire Object
+
+Pass your data to `validate()`:
+
+```ts
+const result = signup.validate({
+  mobile_no: "9812345678",
+  password: "password123",
+});
+```
+
+If the data is valid:
+
+```ts
+{
+  valid: true,
+  data: {
+    mobile_no: "9812345678",
+    password: "password123"
+  }
+}
+```
+
+The returned `data` is the data parsed by Zod.
+
+This means Zod transformations are also preserved.
+
+---
+
+## Invalid data
+
+```ts
+const result = signup.validate({
+  mobile_no: "",
+  password: "123",
+});
+```
+
+The result is:
+
+```ts
+{
+  valid: false,
+  errors: {
+    mobile_no: "mobile_no_required",
+    password: "password_min_length"
+  }
+}
+```
+
+The validator returns the validation codes rather than forcing a human-readable message into your validation layer.
+
+---
+
+# 4. Type-Safe Result Handling
+
+The result is a discriminated union.
+
+```ts
+const result = signup.validate(data);
+
+if (result.valid) {
+  console.log(result.data);
+} else {
+  console.log(result.errors);
+}
+```
+
+TypeScript understands that:
+
+```ts
+result.valid === true;
+```
+
+means `result.data` is available.
+
+And:
+
+```ts
+result.valid === false;
+```
+
+means `result.errors` is available.
+
+---
+
+# 5. Validate a Single Field
+
+For frontend forms, you often don't want to validate the entire form.
+
+For example, while the user is entering their mobile number:
+
+```ts
+const result = signup.validateField("mobile_no", "9812345678");
+```
+
+If valid:
+
+```ts
+{
+  valid: true,
+  data: "9812345678"
+}
+```
+
+If invalid:
+
+```ts
+const result = signup.validateField("mobile_no", "abc");
+```
+
+You get:
+
+```ts
+{
+  valid: false,
+  errors: {
+    mobile_no: "mobile_no_digits"
+  }
+}
+```
+
+This makes the same schema useful for both:
+
+```text
+Whole form validation
+        +
+Individual field validation
+```
+
+---
+
+# 6. Why Field Validation Is Useful
+
+A frontend form might use the validator like this:
+
+```ts
+const result = signup.validateField("mobile_no", mobileNo);
+
+if (!result.valid) {
+  setMobileError(result.errors.mobile_no);
+}
+```
+
+Then when the entire form is submitted:
+
+```ts
+const result = signup.validate(formData);
+
+if (!result.valid) {
+  setErrors(result.errors);
+}
+```
+
+You don't need a separate schema for field validation.
+
+The same Zod schema is used for both operations.
+
+---
+
+# 7. Nested Objects
+
+`zod-validate` preserves the structure of nested validation errors.
+
+Consider:
+
+```ts
+const userSchema = z.object({
+  name: z.string("name_required"),
+
+  address: z.object({
+    city: z.string("city_required"),
+    street: z.string("street_required"),
+  }),
+});
+```
+
+Create the validator:
+
+```ts
+const userValidator = createValidator(userSchema);
+```
+
+Validate:
+
+```ts
+const result = userValidator.validate({
+  name: "Bibek",
+  address: {
+    city: "",
+    street: "",
+  },
+});
+```
+
+The errors mirror the input structure:
+
+```ts
+{
+  valid: false,
+  errors: {
+    address: {
+      city: "city_required",
+      street: "street_required"
+    }
+  }
+}
+```
+
+This is useful because the error structure follows the same hierarchy as the data.
+
+---
+
+# 8. Nested Arrays
+
+Arrays are also preserved.
+
+For example:
+
+```ts
+const buildingSchema = z.object({
+  name: z.string("building_name_required"),
+
+  floors: z.array(
+    z.object({
+      floor_number: z.number("floor_number_required"),
+
+      name: z.string("floor_name_required"),
+
+      units: z.array(
+        z.object({
+          unit_number: z.string("unit_number_required"),
+
+          rent: z.number("rent_required"),
+        }),
+      ),
+    }),
+  ),
+});
+```
+
+Create the validator:
+
+```ts
+const buildingValidator = createValidator(buildingSchema);
+```
+
+Suppose the second floor contains invalid data:
+
+```ts
+const result = buildingValidator.validate({
+  name: "Sunrise Apartments",
+
+  floors: [
+    {
+      floor_number: 1,
+      name: "Ground Floor",
+      units: [
+        {
+          unit_number: "101",
+          rent: 15000,
+        },
+      ],
+    },
+
+    {
+      floor_number: 2,
+      name: "",
+      units: [
+        {
+          unit_number: "",
+          rent: -5000,
+        },
+      ],
+    },
+  ],
+});
+```
+
+The resulting errors follow the same structure:
+
+```ts
+{
+  valid: false,
+  errors: {
+    floors: [
+      <empty>,
+      {
+        name: "floor_name_required",
+
+        units: [
+          {
+            unit_number: "unit_number_required",
+            rent: "rent_required"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+The error at:
+
+```ts
+errors.floors[1].name;
+```
+
+belongs to:
+
+```ts
+floors[1].name;
+```
+
+And:
+
+```ts
+errors.floors[1].units[0].rent;
+```
+
+belongs to:
+
+```ts
+floors[1].units[0].rent;
+```
+
+The structure is intentionally aligned with the original data.
+
+---
+
+# 9. Using Nested Errors in React
+
+This structure works naturally with component hierarchies.
+
+For example:
+
+```tsx
+<Building errors={errors} />
+```
+
+The building component can pass the appropriate floor errors:
+
+```tsx
+<Floors errors={errors.floors?.[floorIndex]} />
+```
+
+The floor component can pass errors to a unit:
+
+```tsx
+<Unit errors={errors?.units?.[unitIndex]} />
+```
+
+And the unit component can access:
+
+```tsx
+errors?.rent;
+```
+
+For example:
+
+```tsx
+<input />;
+
+{
+  errors?.rent && <p>{errors.rent}</p>;
+}
+```
+
+This works because the validation error structure follows the data structure.
+
+You don't need to convert:
+
+```text
+floors[1].units[0].rent
+```
+
+into a flat string just to find the error.
+
+---
+
+# 10. Sparse Array Errors
+
+When only some array items contain errors, the resulting error array can contain empty slots.
+
+For example:
+
+```ts
+[
+  <empty>,
+  {
+    name: "floor_name_required"
+  }
+]
+```
+
+The empty slot represents an array item that has no validation error.
+
+Therefore:
+
+```ts
+errors.floors?.[0];
+```
+
+returns:
+
+```ts
+undefined;
+```
+
+while:
+
+```ts
+errors.floors?.[1];
+```
+
+contains the second floor's errors.
+
+This allows the error array to preserve the original data indexes.
+
+---
+
+# 11. Validation Codes
+
+A major part of the design is that the validation layer can return stable codes.
+
+For example:
+
+```ts
+const result = signup.validate(data);
+```
+
+may produce:
+
+```ts
+{
+  valid: false,
+  errors: {
+    mobile_no: "mobile_no_required",
+    password: "password_min_length"
+  }
+}
+```
+
+The validation layer doesn't need to know how these errors should be displayed.
+
+This allows the application to decide what each code means.
+
+For example:
+
+```ts
+const messages = {
+  mobile_no_required: "Mobile number is required.",
+  password_min_length: "Password must be at least 8 characters.",
+};
+```
+
+---
+
+# 12. Resolve Validation Messages
+
+Import:
+
+```ts
+import { resolveValidationMessages } from "zod-validate";
+```
+
+Then:
+
+```ts
+const resolvedErrors = resolveValidationMessages(result.errors, messages);
+```
+
+Given:
+
+```ts
+const errors = {
+  mobile_no: "mobile_no_required",
+  password: "password_min_length",
+};
+```
+
+and:
+
+```ts
+const messages = {
+  mobile_no_required: "Mobile number is required.",
+  password_min_length: "Password must be at least 8 characters.",
+};
+```
+
+the result is:
+
+```ts
+{
+  mobile_no: "Mobile number is required.",
+  password: "Password must be at least 8 characters."
+}
+```
+
+---
+
+# 13. Missing Message Codes
+
+A message does not have to exist for every validation code.
+
+For example:
+
+```ts
+const errors = {
+  mobile_no: "mobile_no_required",
+  password: "password_min_length",
+};
+
+const messages = {
+  mobile_no_required: "Mobile number is required.",
+};
+```
+
+The known message is resolved:
+
+```ts
+{
+  mobile_no: "Mobile number is required.",
+  password: "password_min_length"
+}
+```
+
+An unknown code falls back to the original code.
+
+This means missing translations do not silently disappear.
+
+---
+
+# 14. Localized Messages
+
+Messages can also be provided by locale.
+
+```ts
+const messages = {
+  en: {
+    mobile_no_required: "Mobile number is required.",
+    password_min_length: "Password must be at least 8 characters.",
+  },
+
+  np: {
+    mobile_no_required: "मोबाइल नम्बर आवश्यक छ।",
+    password_min_length: "पासवर्ड कम्तीमा ८ अक्षरको हुनुपर्छ।",
+  },
+};
+```
+
+Resolve English messages:
+
+```ts
+const errors = resolveValidationMessages(
+  validationResult.errors,
+  messages,
+  "en",
+);
+```
+
+Result:
+
+```ts
+{
+  mobile_no: "Mobile number is required.",
+  password: "Password must be at least 8 characters."
+}
+```
+
+Resolve Nepali messages:
+
+```ts
+const errors = resolveValidationMessages(
+  validationResult.errors,
+  messages,
+  "np",
+);
+```
+
+Result:
+
+```ts
+{
+  mobile_no: "मोबाइल नम्बर आवश्यक छ।",
+  password: "पासवर्ड कम्तीमा ८ अक्षरको हुनुपर्छ।"
+}
+```
+
+---
+
+# 15. Default Locale
+
+If no locale is supplied and the message configuration is localized, `en` is preferred when available.
+
+For example:
+
+```ts
+const messages = {
+  en: {
+    required: "This field is required.",
+  },
+
+  np: {
+    required: "यो field आवश्यक छ।",
+  },
+};
+```
+
+Then:
+
+```ts
+resolveValidationMessages(errors, messages);
+```
+
+uses the English messages.
+
+If `en` does not exist, the first available locale is used.
+
+---
+
+# 16. Plain Messages
+
+Localization is optional.
+
+You can simply use:
+
+```ts
+const messages = {
+  required: "This field is required.",
+  invalid_email: "Invalid email address.",
+};
+```
+
+Then:
+
+```ts
+resolveValidationMessages(errors, messages);
+```
+
+No locale is required.
+
+---
+
+# 17. Locale Configuration Validation
+
+The resolver validates the message configuration.
+
+A plain message map must contain string messages:
+
+```ts
+const messages = {
+  required: "This field is required.",
+  invalid: "Invalid value.",
+};
+```
+
+A localized message map must contain message maps:
+
+```ts
+const messages = {
+  en: {
+    required: "This field is required.",
+  },
+
+  np: {
+    required: "यो field आवश्यक छ।",
+  },
+};
+```
+
+Invalid message values are rejected instead of being silently accepted.
+
+For example:
+
+```ts
+const messages = {
+  en: {
+    required: 123,
+  },
+};
+```
+
+is invalid because validation messages must be strings.
+
+---
+
+# 18. Frontend Use Case
+
+A React form can use the library in two stages.
+
+### During field interaction
+
+```ts
+const result = signup.validateField("mobile_no", mobileNo);
+
+if (!result.valid) {
+  setErrors(result.errors);
+}
+```
+
+### During submission
+
+```ts
+const result = signup.validate(formData);
+
+if (!result.valid) {
+  const errors = resolveValidationMessages(result.errors, messages);
+
+  setErrors(errors);
+  return;
+}
+
+submitForm(result.data);
+```
+
+This gives the frontend:
+
+```text
+Zod schema
+```

package/dist/createValidators.d.ts

@@ -0,0 +1,7 @@
+import { z } from "zod";
+import type { ValidationResult } from "./types.js";
+export declare const createValidator: <S extends z.ZodType>(schema: S) => {
+    validate(data: unknown): ValidationResult<z.infer<S>>;
+    validateField<K extends keyof z.infer<S>>(field: K, value: unknown): ValidationResult<z.infer<S>[K]>;
+};
+//# sourceMappingURL=createValidators.d.ts.map

package/dist/createValidators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createValidators.d.ts","sourceRoot":"","sources":["../src/createValidators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGnD,eAAO,MAAM,eAAe,GAAI,CAAC,SAAS,CAAC,CAAC,OAAO,UAAU,CAAC;IAK1D,QAAQ,OAAO,OAAO,GAAG,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAIrD,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAC/B,CAAC,SACD,OAAO,GACb,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CASrC,CAAC"}

package/dist/createValidators.js

@@ -0,0 +1,16 @@
+import { z } from "zod";
+import { validateFieldEngine, validateObjectEngine } from "./engine.js";
+export const createValidator = (schema) => {
+    const validateField = schema instanceof z.ZodObject ? validateFieldEngine(schema) : undefined;
+    return {
+        validate(data) {
+            return validateObjectEngine(schema, data);
+        },
+        validateField(field, value) {
+            if (!validateField)
+                throw new Error("validateField() can only be used with a Zod object schema.");
+            return validateField(field, value);
+        },
+    };
+};
+//# sourceMappingURL=createValidators.js.map

package/dist/createValidators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createValidators.js","sourceRoot":"","sources":["../src/createValidators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAsB,MAAS,EAAE,EAAE;IAChE,MAAM,aAAa,GACjB,MAAM,YAAY,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE1E,OAAO;QACL,QAAQ,CAAC,IAAa;YACpB,OAAO,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC5C,CAAC;QAED,aAAa,CACX,KAAQ,EACR,KAAc;YAEd,IAAI,CAAC,aAAa;gBAChB,MAAM,IAAI,KAAK,CACb,4DAA4D,CAC7D,CAAC;YAEJ,OAAO,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACrC,CAAC;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/engine.d.ts

@@ -0,0 +1,5 @@
+import { z } from "zod";
+import type { ValidationResult } from "./types.js";
+export declare const validateObjectEngine: <S extends z.ZodType>(schema: S, data: unknown) => ValidationResult<z.infer<S>>;
+export declare const validateFieldEngine: <T extends z.ZodObject<any>>(schema: T) => <K extends keyof z.infer<T>>(field: K, value: unknown) => ValidationResult<z.infer<T>[K]>;
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,CAAC,CAAC,OAAO,UAC9C,CAAC,QACH,OAAO,KACZ,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CA0B7B,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,MAG/D,CAAC,SAAS,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SACzB,CAAC,SACD,OAAO,KACb,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAYlC,CAAC"}

package/dist/engine.js

@@ -0,0 +1,39 @@
+import { z } from "zod";
+export const validateObjectEngine = (schema, data) => {
+    const result = schema.safeParse(data);
+    if (result.success)
+        return { valid: true, data: result.data };
+    const errors = {};
+    for (const issue of result.error.issues) {
+        let current = errors;
+        const path = issue.path;
+        for (let i = 0; i < path.length; i++) {
+            const key = path[i];
+            const isLast = i === path.length - 1;
+            if (isLast) {
+                if (current[key] === undefined)
+                    current[key] = issue.message;
+            }
+            else {
+                if (!current[key] || typeof current[key] !== "object")
+                    current[key] = typeof path[i + 1] === "number" ? [] : {};
+                current = current[key];
+            }
+        }
+    }
+    return { valid: false, errors };
+};
+export const validateFieldEngine = (schema) => {
+    const shape = schema.shape;
+    return (field, value) => {
+        const result = shape[field].safeParse(value);
+        if (result.success)
+            return { valid: true, data: result.data };
+        const error = result.error.issues[0];
+        return {
+            valid: false,
+            errors: { [String(field)]: error?.message ?? "validation_error" },
+        };
+    };
+};
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,MAAS,EACT,IAAa,EACiB,EAAE;IAChC,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;IAE9D,MAAM,MAAM,GAAQ,EAAE,CAAC;IAEvB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACxC,IAAI,OAAO,GAAG,MAAM,CAAC;QACrB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QAExB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;YACrB,MAAM,MAAM,GAAG,CAAC,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;YAErC,IAAI,MAAM,EAAE,CAAC;gBACX,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS;oBAAE,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC;YAC/D,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,QAAQ;oBACnD,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAE3D,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAClC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAA6B,MAAS,EAAE,EAAE;IAC3E,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAE3B,OAAO,CACL,KAAQ,EACR,KAAc,EACmB,EAAE;QACnC,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAE7C,IAAI,MAAM,CAAC,OAAO;YAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QAE9D,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAErC,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,IAAI,kBAAkB,EAAE;SAClE,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { createValidator } from "./createValidators.js";
+export type { ValidationResult, ValidationErrors, ValidationMessages, } from "./types.js";
+export { resolveValidationMessages } from "./messages.js";
+//# 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,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { createValidator } from "./createValidators.js";
+export { resolveValidationMessages } from "./messages.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAMxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC"}

package/dist/messages.d.ts

@@ -0,0 +1,3 @@
+import type { ValidationErrors, ValidationMessages } from "./types.js";
+export declare const resolveValidationMessages: (errors: ValidationErrors, messages: ValidationMessages, locale?: string) => ValidationErrors;
+//# sourceMappingURL=messages.d.ts.map

package/dist/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAEhB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAqHpB,eAAO,MAAM,yBAAyB,WAC5B,gBAAgB,YACd,kBAAkB,WACnB,MAAM,KACd,gBAGF,CAAC"}

package/dist/messages.js

@@ -0,0 +1,77 @@
+const getMessageMap = (messages, locale) => {
+    const isPlain = isPlainMessageMap(messages);
+    const isLocalized = isLocaleMessageMap(messages);
+    if (!isPlain && !isLocalized) {
+        const localeError = getLocaleMessageMapError(messages);
+        if (localeError)
+            throw new Error(localeError);
+        throw new Error("Invalid validation messages. Messages must be either a plain message map or a locale-based message map.");
+    }
+    if (isPlain) {
+        if (locale)
+            throw new Error(`Locale "${locale}" was provided, but the validation messages are not localized.`);
+        return messages;
+    }
+    const locales = Object.keys(messages);
+    if (locales.length === 0)
+        throw new Error("No validation message locales have been defined.");
+    const selectedLocale = locale ?? (locales.includes("en") ? "en" : locales[0]);
+    if (!selectedLocale)
+        throw new Error("No validation message locale has been defined.");
+    const messageMap = messages[selectedLocale];
+    if (!messageMap)
+        throw new Error(`Validation messages for locale "${selectedLocale}" are not defined.`);
+    return messageMap;
+};
+const isPlainMessageMap = (value) => {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return false;
+    }
+    const values = Object.values(value);
+    return (values.length > 0 && values.every((message) => typeof message === "string"));
+};
+const isLocaleMessageMap = (value) => {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return false;
+    }
+    const localeMaps = Object.values(value);
+    return (localeMaps.length > 0 &&
+        localeMaps.every((messageMap) => isPlainMessageMap(messageMap)));
+};
+const getLocaleMessageMapError = (value) => {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return undefined;
+    for (const [locale, messageMap] of Object.entries(value)) {
+        if (typeof messageMap !== "object" ||
+            messageMap === null ||
+            Array.isArray(messageMap))
+            return `Validation messages for locale "${locale}" must be a message map.`;
+        for (const [code, message] of Object.entries(messageMap)) {
+            if (typeof message !== "string")
+                return `Validation message for locale "${locale}" and code "${code}" must be a string. Received ${typeof message}.`;
+        }
+    }
+    return undefined;
+};
+const resolveErrors = (errors, messageMap) => {
+    const resolved = {};
+    for (const key of Object.keys(errors)) {
+        const value = errors[key];
+        if (typeof value === "string") {
+            resolved[key] = messageMap[value] ?? value;
+            continue;
+        }
+        if (Array.isArray(value)) {
+            resolved[key] = value.map((item) => resolveErrors(item, messageMap));
+            continue;
+        }
+        if (value !== undefined)
+            resolved[key] = resolveErrors(value, messageMap);
+    }
+    return resolved;
+};
+export const resolveValidationMessages = (errors, messages, locale) => {
+    const messageMap = getMessageMap(messages, locale);
+    return resolveErrors(errors, messageMap);
+};
+//# sourceMappingURL=messages.js.map

package/dist/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "zod-validate",
+  "version": "1.0.0",
+  "description": "Reusable validation utilities built on top of Zod for frontend and backend applications.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest",
+    "dev:test": "tsx test.ts"
+  },
+  "keywords": [
+    "zod",
+    "validation",
+    "typescript",
+    "frontend",
+    "backend"
+  ],
+  "author": "Bibek Bhattarai",
+  "license": "MIT",
+  "peerDependencies": {
+    "zod": "^4.6.2"
+  },
+  "devDependencies": {
+    "zod": "^4.6.2",
+    "tsx": "^4.23.13",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.0"
+  }
+}