@esmj/schema 0.1.1 → 0.2.0

package/README.md

@@ -25,10 +25,47 @@ When choosing a schema validation library, bundle size can be an important facto
 | Library         | Bundle Size (minified + gzipped) |
 |------------------|---------------------------------|
 | `@esmj/schema`   | ~1 KB                           |
-| Superstruct      | ~3,2 KB                         |
-| Yup              | ~12,2 KB                        |
-| Zod              | ~14 KB                          |
-| Joi              | ~40 KB                          |
+| Superstruct      | ~3.2 KB                         |
+| Yup              | ~12.2 KB                        |
+| Zod@3            | ~13 KB                          |
+| @zod/mini        | ~20,5 KB                        |
+| Joi              | ~40,4 KB                        |
+| Zod@4            | ~40,8 KB                        |
+
+### Performance Comparison
+
+#### Schema Creation Performance
+
+| Library         | 1 Iteration | 1,000 Iterations | 1,000,000 Iterations |
+|-----------------|-------------|------------------|----------------------|
+| `@esmj/schema`  | 0.02 ms     | 4.93 ms          | 399.62 ms            |
+| zod@3           | 0.08 ms     | 9.68 ms          | 8.53 s               |
+| @zod/mini       | 0.22 ms     | 39.77 ms         | 34.51 s              |
+| Yup             | 0.54 ms     | 14.03 ms         | 12.34 s              |
+| Superstruct     | 0.13 ms     | 1.04 ms          | 487.94 ms            |
+| Joi             | 0.62 ms     | 31.60 ms         | 23.06 s              |
+
+#### Parsing Performance
+
+| Library         | 1 Iteration | 1,000 Iterations | 1,000,000 Iterations |
+|-----------------|-------------|------------------|----------------------|
+| `@esmj/schema`  | 0.05 ms     | 0.46 ms          | 267.93 ms            |
+| zod@3           | 0.14 ms     | 1.44 ms          | 897.89 ms            |
+| @zod/mini       | 0.23 ms     | 0.42 ms          | 199.08 ms            |
+| Yup             | 0.30 ms     | 9.49 ms          | 8.69 s               |
+| Superstruct     | 0.08 ms     | 4.18 ms          | 3.71 s               |
+| Joi             | 0.33 ms     | 3.35 ms          | 2.69 s               |
+
+#### Error Handling Performance
+
+| Library         | 1 Iteration | 1,000 Iterations | 1,000,000 Iterations |
+|-----------------|-------------|------------------|----------------------|
+| `@esmj/schema`  | 0.03 ms     | 0.59 ms          | 365.32 ms            |
+| zod3            | 0.05 ms     | 2.09 ms          | 1.26 s               |
+| @zod/mini       | 0.07 ms     | 0.99 ms          | 545.12 ms            |
+| Yup             | 0.27 ms     | 19.28 ms         | 18.87 s              |
+| Superstruct     | 0.04 ms     | 8.62 ms          | 6.24 s               |
+| Joi             | 0.15 ms     | 4.13 ms          | 2.57 s               |
 
 ## Usage
 
@@ -180,9 +217,26 @@ const result = stringSchema.parse('hello');
 Safely parses the given value according to the schema, returning a success or error result.
 
 ```typescript
-const result = stringSchema.safeParse('hello'); // { success: true, data: 'hello' }
+const result = stringSchema.safeParse('hello'); 
+// { success: true, data: 'hello' }
+
+const errorResult = stringSchema.safeParse(123); 
+// { success: false, error: { message: 'The value "123" must be type of string but is type of "number".' } }
 ```
 
+**Note:** The `error` returned by `safeParse` is not a native `Error` instance. Instead, it is a plain object with the following structure:
+
+```typescript
+type ErrorStructure = {
+  message: string;
+  cause?: {
+    key?: string;
+  };
+};
+```
+
+This allows for easier serialization and debugging but may require additional handling if you expect a native `Error` instance.
+
 #### `optional()`
 
 Makes the schema optional.

package/benchmark/benchmark.ts

@@ -0,0 +1,585 @@
+import { performance } from 'node:perf_hooks';
+import { z as zodMini } from '@zod/mini'; // Import Zod Mini
+import Joi from 'joi'; // Import Joi
+import superStruct from 'superstruct'; // Import Superstruct
+import * as yup from 'yup'; // Import Yup
+import { z } from 'zod'; // Import Zod
+import { s } from '../src/index.ts'; // Import @esmj/schema
+
+function formatTime(time: number) {
+  // Convert time to milliseconds
+  if (time < 1000) {
+    return `${time.toFixed(2)} ms`;
+  }
+  // Convert to seconds
+  const seconds = time / 1000;
+  return `${seconds.toFixed(2)} s`;
+}
+
+function benchmark(label: string, fn: () => void) {
+  const REPEAT = 10;
+  let sum = 0;
+  let min = Number.POSITIVE_INFINITY;
+  let max = Number.NEGATIVE_INFINITY;
+  for (let i = 0; i < REPEAT; i++) {
+    const start = performance.now();
+    fn();
+    const end = performance.now();
+
+    const time = end - start;
+
+    min = Math.min(min, time);
+    max = Math.max(max, time);
+    sum += time;
+  }
+
+  const average = sum / REPEAT;
+
+  console.log(
+    `${label} took an average of ${formatTime(average)} over ${REPEAT} iterations. Min: ${formatTime(min)}, Max: ${formatTime(max)}`,
+  );
+
+  return formatTime(average);
+}
+
+function scenarioParseSchema(testData) {
+  // Define a schema using @esmj/schema
+  const esmjSchema = s.object({
+    username: s.string(),
+    password: s.string(),
+    age: s.number().optional(),
+    address: s.object({
+      street: s.string().nullish(),
+      city: s.string().nullable(),
+      date: s.date().optional(), // Optional date field
+    }),
+    tags: s.array(s.string()),
+  });
+
+  // Define a schema using Zod
+  const zodSchema = z.object({
+    username: z.string(),
+    password: z.string(),
+    age: z.number().optional(),
+    address: z.object({
+      street: z.string().nullish(),
+      city: z.string().nullable(),
+      date: z.date().optional(), // Optional date field
+    }),
+    tags: z.array(z.string()),
+  });
+
+  // Define a schema using Zod Mini
+  const zodMiniSchema = zodMini.object({
+    username: zodMini.string(),
+    password: zodMini.string(),
+    age: zodMini.optional(zodMini.number()),
+    address: zodMini.object({
+      street: zodMini.nullish(zodMini.string()),
+      city: zodMini.nullable(zodMini.string()),
+      date: zodMini.optional(zodMini.date()), // Optional date field
+    }),
+    tags: zodMini.array(zodMini.string()),
+  });
+
+  // Define a schema using Yup
+  const yupSchema = yup.object({
+    username: yup.string().required(),
+    password: yup.string().required(),
+    age: yup.number().optional(),
+    address: yup.object({
+      street: yup.string().nullable(),
+      city: yup.string().nullable(),
+      date: yup.date().optional(), // Optional date field
+    }),
+    tags: yup.array().of(yup.string().required()).required(),
+  });
+
+  // Define a schema using Superstruct
+  const superStructSchema = superStruct.object({
+    username: superStruct.string(),
+    password: superStruct.string(),
+    age: superStruct.number(),
+    address: superStruct.object({
+      street: superStruct.optional(superStruct.string()),
+      city: superStruct.optional(superStruct.string()),
+      date: superStruct.optional(superStruct.date()), // Optional date field
+    }),
+    tags: superStruct.array(superStruct.string()),
+  });
+
+  // Define a schema using Joi
+  const joiSchema = Joi.object({
+    username: Joi.string().required(),
+    password: Joi.string().required(),
+    age: Joi.number().required(),
+    address: Joi.object({
+      street: Joi.string().optional(), // Allow null for street
+      city: Joi.string().optional(),
+      date: Joi.date().optional(), // Optional date field
+    }),
+    tags: Joi.array().items(Joi.string().required()).required(),
+  });
+
+  const result = {} as Record<string, object>;
+
+  const esmjSchemaResult = {};
+  esmjSchemaResult['1'] = benchmark('@esmj/schema 1', () => {
+    for (let i = 0; i < 1; i++) {
+      esmjSchema.safeParse(testData);
+    }
+  });
+
+  esmjSchemaResult['1_000'] = benchmark('@esmj/schema 1_000', () => {
+    for (let i = 0; i < 1_000; i++) {
+      esmjSchema.safeParse(testData);
+    }
+  });
+
+  esmjSchemaResult['1_000_000'] = benchmark('@esmj/schema 1_000_000', () => {
+    for (let i = 0; i < 1_000_000; i++) {
+      esmjSchema.safeParse(testData);
+    }
+  });
+  result.esmjSchema = esmjSchemaResult;
+
+  const zod = {};
+  zod['1'] = benchmark('zod 1', () => {
+    for (let i = 0; i < 1; i++) {
+      zodSchema.safeParse(testData);
+    }
+  });
+
+  zod['1_000'] = benchmark('zod 1_000', () => {
+    for (let i = 0; i < 1_000; i++) {
+      zodSchema.safeParse(testData);
+    }
+  });
+
+  zod['1_000_000'] = benchmark('zod 1_000_000', () => {
+    for (let i = 0; i < 1_000_000; i++) {
+      zodSchema.safeParse(testData);
+    }
+  });
+  result.zod = zod;
+
+  const zodMiniResult = {};
+  zodMiniResult['1'] = benchmark('@zod/mini 1', () => {
+    for (let i = 0; i < 1; i++) {
+      zodMiniSchema.safeParse(testData);
+    }
+  });
+
+  zodMiniResult['1_000'] = benchmark('@zod/mini 1_000', () => {
+    for (let i = 0; i < 1_000; i++) {
+      zodMiniSchema.safeParse(testData);
+    }
+  });
+
+  zodMiniResult['1_000_000'] = benchmark('@zod/mini 1_000_000', () => {
+    for (let i = 0; i < 1_000_000; i++) {
+      zodMiniSchema.safeParse(testData);
+    }
+  });
+  result.zodMini = zodMiniResult;
+
+  const yupResult = {};
+  yupResult['1'] = benchmark('yup 1', () => {
+    for (let i = 0; i < 1; i++) {
+      yupSchema.isValidSync(testData);
+    }
+  });
+
+  yupResult['1_000'] = benchmark('yup 1_000', () => {
+    for (let i = 0; i < 1_000; i++) {
+      yupSchema.isValidSync(testData);
+    }
+  });
+
+  yupResult['1_000_000'] = benchmark('yup 1_000_000', () => {
+    for (let i = 0; i < 1_000_000; i++) {
+      yupSchema.isValidSync(testData);
+    }
+  });
+  result.yup = yupResult;
+
+  const superStructResult = {};
+  superStructResult['1'] = benchmark('superStruct 1', () => {
+    for (let i = 0; i < 1; i++) {
+      superStruct.is(testData, superStructSchema);
+    }
+  });
+
+  superStructResult['1_000'] = benchmark('superStruct 1_000', () => {
+    for (let i = 0; i < 1_000; i++) {
+      superStruct.is(testData, superStructSchema);
+    }
+  });
+
+  superStructResult['1_000_000'] = benchmark('superStruct 1_000_000', () => {
+    for (let i = 0; i < 1_000_000; i++) {
+      superStruct.is(testData, superStructSchema);
+    }
+  });
+  result.superStruct = superStructResult;
+
+  const joiResult = {};
+  joiResult['1'] = benchmark('joi 1', () => {
+    for (let i = 0; i < 1; i++) {
+      try {
+        joiSchema.validate(testData);
+      } catch (e) {}
+    }
+  });
+
+  joiResult['1_000'] = benchmark('joi 1_000', () => {
+    for (let i = 0; i < 1_000; i++) {
+      try {
+        joiSchema.validate(testData);
+      } catch (e) {}
+    }
+  });
+
+  joiResult['1_000_000'] = benchmark('joi 1_000_000', () => {
+    for (let i = 0; i < 1_000_000; i++) {
+      try {
+        joiSchema.validate(testData);
+      } catch (e) {}
+    }
+  });
+  result.joi = joiResult;
+
+  return result;
+}
+
+function scenarioCreatingSchema() {
+  const result = {} as Record<string, object>;
+  const esmjSchemaResult = {};
+  esmjSchemaResult['1'] = benchmark('@esmj/schema 1', () => {
+    for (let i = 0; i < 1; i++) {
+      const esmjSchema = s.object({
+        username: s.string(),
+        password: s.string(),
+        age: s.number().optional(),
+        address: s.object({
+          street: s.string().nullish(),
+          city: s.string().nullable(),
+          date: s.date().optional(), // Optional date field
+        }),
+        tags: s.array(s.string()),
+      });
+    }
+  });
+
+  esmjSchemaResult['1_000'] = benchmark('@esmj/schema 1_000', () => {
+    for (let i = 0; i < 1_000; i++) {
+      const esmjSchema = s.object({
+        username: s.string(),
+        password: s.string(),
+        age: s.number().optional(),
+        address: s.object({
+          street: s.string().nullish(),
+          city: s.string().nullable(),
+          date: s.date().optional(), // Optional date field
+        }),
+        tags: s.array(s.string()),
+      });
+    }
+  });
+
+  esmjSchemaResult['1_000_000'] = benchmark('@esmj/schema 1_000_000', () => {
+    for (let i = 0; i < 1_000_000; i++) {
+      const esmjSchema = s.object({
+        username: s.string(),
+        password: s.string(),
+        age: s.number().optional(),
+        address: s.object({
+          street: s.string().nullish(),
+          city: s.string().nullable(),
+          date: s.date().optional(), // Optional date field
+        }),
+        tags: s.array(s.string()),
+      });
+    }
+  });
+  result.esmjSchema = esmjSchemaResult;
+
+  const zod = {};
+  zod['1'] = benchmark('zod 1', () => {
+    for (let i = 0; i < 1; i++) {
+      const zodSchema = z.object({
+        username: z.string(),
+        password: z.string(),
+        age: z.number().optional(),
+        address: z.object({
+          street: z.string().nullish(),
+          city: z.string().nullable(),
+          date: z.date().optional(), // Optional date field
+        }),
+        tags: z.array(z.string()),
+      });
+    }
+  });
+
+  zod['1_000'] = benchmark('zod 1_000', () => {
+    for (let i = 0; i < 1_000; i++) {
+      const zodSchema = z.object({
+        username: z.string(),
+        password: z.string(),
+        age: z.number().optional(),
+        address: z.object({
+          street: z.string().nullish(),
+          city: z.string().nullable(),
+          date: z.date().optional(), // Optional date field
+        }),
+        tags: z.array(z.string()),
+      });
+    }
+  });
+
+  zod['1_000_000'] = benchmark('zod 1_000_000', () => {
+    for (let i = 0; i < 1_000_000; i++) {
+      const zodSchema = z.object({
+        username: z.string(),
+        password: z.string(),
+        age: z.number().optional(),
+        address: z.object({
+          street: z.string().nullish(),
+          city: z.string().nullable(),
+          date: z.date().optional(), // Optional date field
+        }),
+        tags: z.array(z.string()),
+      });
+    }
+  });
+  result.zod = zod;
+
+  const zodMiniResult = {};
+  zodMiniResult['1'] = benchmark('@zod/mini 1', () => {
+    for (let i = 0; i < 1; i++) {
+      const zodMiniSchema = zodMini.object({
+        username: zodMini.string(),
+        password: zodMini.string(),
+        age: zodMini.optional(zodMini.number()),
+        address: zodMini.object({
+          street: zodMini.nullish(zodMini.string()),
+          city: zodMini.nullable(zodMini.string()),
+          date: zodMini.optional(zodMini.date()), // Optional date field
+        }),
+        tags: zodMini.array(zodMini.string()),
+      });
+    }
+  });
+
+  zodMiniResult['1_000'] = benchmark('@zod/mini 1_000', () => {
+    for (let i = 0; i < 1_000; i++) {
+      const zodMiniSchema = zodMini.object({
+        username: zodMini.string(),
+        password: zodMini.string(),
+        age: zodMini.optional(zodMini.number()),
+        address: zodMini.object({
+          street: zodMini.nullish(zodMini.string()),
+          city: zodMini.nullable(zodMini.string()),
+          date: zodMini.optional(zodMini.date()), // Optional date field
+        }),
+        tags: zodMini.array(zodMini.string()),
+      });
+    }
+  });
+
+  zodMiniResult['1_000_000'] = benchmark('@zod/mini 1_000_000', () => {
+    for (let i = 0; i < 1_000_000; i++) {
+      const zodMiniSchema = zodMini.object({
+        username: zodMini.string(),
+        password: zodMini.string(),
+        age: zodMini.optional(zodMini.number()),
+        address: zodMini.object({
+          street: zodMini.nullish(zodMini.string()),
+          city: zodMini.nullable(zodMini.string()),
+          date: zodMini.optional(zodMini.date()), // Optional date field
+        }),
+        tags: zodMini.array(zodMini.string()),
+      });
+    }
+  });
+  result.zodMini = zodMiniResult;
+
+  const yupResult = {};
+  yupResult['1'] = benchmark('yup 1', () => {
+    for (let i = 0; i < 1; i++) {
+      const yupSchema = yup.object({
+        username: yup.string().required(),
+        password: yup.string().required(),
+        age: yup.number().optional(),
+        address: yup.object({
+          street: yup.string().nullable(),
+          city: yup.string().nullable(),
+          date: yup.date().optional(), // Optional date field
+        }),
+        tags: yup.array().of(yup.string().required()).required(),
+      });
+    }
+  });
+
+  yupResult['1_000'] = benchmark('yup 1_000', () => {
+    for (let i = 0; i < 1_000; i++) {
+      const yupSchema = yup.object({
+        username: yup.string().required(),
+        password: yup.string().required(),
+        age: yup.number().optional(),
+        address: yup.object({
+          street: yup.string().nullable(),
+          city: yup.string().nullable(),
+          date: yup.date().optional(), // Optional date field
+        }),
+        tags: yup.array().of(yup.string().required()).required(),
+      });
+    }
+  });
+
+  yupResult['1_000_000'] = benchmark('yup 1_000_000', () => {
+    for (let i = 0; i < 1_000_000; i++) {
+      const yupSchema = yup.object({
+        username: yup.string().required(),
+        password: yup.string().required(),
+        age: yup.number().optional(),
+        address: yup.object({
+          street: yup.string().nullable(),
+          city: yup.string().nullable(),
+          date: yup.date().optional(), // Optional date field
+        }),
+        tags: yup.array().of(yup.string().required()).required(),
+      });
+    }
+  });
+  result.yup = yupResult;
+
+  const superStructResult = {};
+  superStructResult['1'] = benchmark('superStruct 1', () => {
+    for (let i = 0; i < 1; i++) {
+      const superStructSchema = superStruct.object({
+        username: superStruct.string(),
+        password: superStruct.string(),
+        age: superStruct.number(),
+        address: superStruct.object({
+          street: superStruct.optional(superStruct.string()),
+          city: superStruct.optional(superStruct.string()),
+          date: superStruct.optional(superStruct.date()), // Optional date field
+        }),
+        tags: superStruct.array(superStruct.string()),
+      });
+    }
+  });
+
+  superStructResult['1_000'] = benchmark('superStruct 1_000', () => {
+    for (let i = 0; i < 1_000; i++) {
+      const superStructSchema = superStruct.object({
+        username: superStruct.string(),
+        password: superStruct.string(),
+        age: superStruct.number(),
+        address: superStruct.object({
+          street: superStruct.optional(superStruct.string()),
+          city: superStruct.optional(superStruct.string()),
+          date: superStruct.optional(superStruct.date()), // Optional date field
+        }),
+        tags: superStruct.array(superStruct.string()),
+      });
+    }
+  });
+
+  superStructResult['1_000_000'] = benchmark('superStruct 1_000_000', () => {
+    for (let i = 0; i < 1_000_000; i++) {
+      const superStructSchema = superStruct.object({
+        username: superStruct.string(),
+        password: superStruct.string(),
+        age: superStruct.number(),
+        address: superStruct.object({
+          street: superStruct.optional(superStruct.string()),
+          city: superStruct.optional(superStruct.string()),
+          date: superStruct.optional(superStruct.date()), // Optional date field
+        }),
+        tags: superStruct.array(superStruct.string()),
+      });
+    }
+  });
+  result.superStruct = superStructResult;
+
+  const joiResult = {};
+  joiResult['1'] = benchmark('joi 1', () => {
+    for (let i = 0; i < 1; i++) {
+      const joiSchema = Joi.object({
+        username: Joi.string().required(),
+        password: Joi.string().required(),
+        age: Joi.number().required(),
+        address: Joi.object({
+          street: Joi.string().optional(), // Allow null for street
+          city: Joi.string().optional(),
+          date: Joi.date().optional(), // Optional date field
+        }),
+        tags: Joi.array().items(Joi.string().required()).required(),
+      });
+    }
+  });
+
+  joiResult['1_000'] = benchmark('joi 1_000', () => {
+    for (let i = 0; i < 1_000; i++) {
+      const joiSchema = Joi.object({
+        username: Joi.string().required(),
+        password: Joi.string().required(),
+        age: Joi.number().required(),
+        address: Joi.object({
+          street: Joi.string().optional(), // Allow null for street
+          city: Joi.string().optional(),
+          date: Joi.date().optional(), // Optional date field
+        }),
+        tags: Joi.array().items(Joi.string().required()).required(),
+      });
+    }
+  });
+
+  joiResult['1_000_000'] = benchmark('joi 1_000_000', () => {
+    for (let i = 0; i < 1_000_000; i++) {
+      const joiSchema = Joi.object({
+        username: Joi.string().required(),
+        password: Joi.string().required(),
+        age: Joi.number().required(),
+        address: Joi.object({
+          street: Joi.string().optional(), // Allow null for street
+          city: Joi.string().optional(),
+          date: Joi.date().optional(), // Optional date field
+        }),
+        tags: Joi.array().items(Joi.string().required()).required(),
+      });
+    }
+  });
+  result.joi = joiResult;
+
+  return result;
+}
+
+const testDataGood = {
+  username: 'john_doe',
+  password: 'securepassword',
+  age: 30,
+  address: {
+    street: '123 Main St',
+    city: 'New York',
+    date: new Date(),
+  },
+  tags: ['developer', 'typescript'],
+};
+
+const testDataBad = {
+  username: 'john_doe',
+  password: 'securepassword',
+  age: 30,
+  address: {
+    street: '123 Main St',
+    city: 'New York',
+    date: new Date(),
+  },
+};
+
+console.table(scenarioCreatingSchema());
+console.table(scenarioParseSchema(testDataGood));
+console.table(scenarioParseSchema(testDataBad));

package/dist/index.d.mts

@@ -1,12 +1,22 @@
+type ErrorStructure = {
+    message: string;
+    cause?: {
+        key?: string;
+    };
+};
+type Valid<Output> = {
+    success: true;
+    data: Output;
+};
+type Invalid = {
+    success: false;
+    error: ErrorStructure;
+};
+type InternalParseOutput<Output> = Valid<Output> | Invalid;
 interface SchemaInterface<Input, Output> {
+    _parse(value: Input | Partial<Input> | unknown): InternalParseOutput<Output>;
     parse(value: Input | Partial<Input> | unknown): Output;
-    safeParse(value: Input | Partial<Input> | unknown): {
-        success: true;
-        data: Output;
-    } | {
-        success: false;
-        error: Error;
-    };
+    safeParse(value: Input | Partial<Input> | unknown): InternalParseOutput<Output>;
     optional(): SchemaInterface<Input, Partial<Output> | undefined>;
     transform<NewOutput>(callback: (value: Input) => NewOutput): SchemaInterface<Input, NewOutput>;
     nullable(): SchemaInterface<Input, Output | null>;

package/dist/index.d.ts

@@ -1,12 +1,22 @@
+type ErrorStructure = {
+    message: string;
+    cause?: {
+        key?: string;
+    };
+};
+type Valid<Output> = {
+    success: true;
+    data: Output;
+};
+type Invalid = {
+    success: false;
+    error: ErrorStructure;
+};
+type InternalParseOutput<Output> = Valid<Output> | Invalid;
 interface SchemaInterface<Input, Output> {
+    _parse(value: Input | Partial<Input> | unknown): InternalParseOutput<Output>;
     parse(value: Input | Partial<Input> | unknown): Output;
-    safeParse(value: Input | Partial<Input> | unknown): {
-        success: true;
-        data: Output;
-    } | {
-        success: false;
-        error: Error;
-    };
+    safeParse(value: Input | Partial<Input> | unknown): InternalParseOutput<Output>;
     optional(): SchemaInterface<Input, Partial<Output> | undefined>;
     transform<NewOutput>(callback: (value: Input) => NewOutput): SchemaInterface<Input, NewOutput>;
     nullable(): SchemaInterface<Input, Output | null>;

package/dist/index.js

@@ -1 +1 @@
-'use strict';var y={object(n){let u=i(c=>typeof c=="object"&&c!==null&&!Array.isArray(c),{type:"object"});return s(u,"parse",(c,...o)=>{let e=c(...o);return n&&typeof e=="object"?Object.keys(n).reduce((r,t)=>{if(typeof n[t]?.parse=="function")try{r[t]=n[t].parse(e[t]);}catch(p){throw t=p.cause?.key?`${t}.${p.cause.key}`:t,new Error(`Error parsing key "${t}": ${p.message}`,{cause:{key:t}})}return r},{}):e}),u},string(){return i(a=>typeof a=="string",{type:"string"})},number(){return i(a=>typeof a=="number",{type:"number"})},boolean(){return i(a=>a===true||a===false,{type:"boolean"})},date(){return i(a=>a instanceof Date&&!Number.isNaN(a.getTime()),{type:"date"})},enum(n){let a=e=>n.includes(e),u=e=>`Invalid ${c} value. Expected ${n.map(r=>`"${r}"`).join(" | ")}, received "${e}".`,c="enum";return i(a,{type:c,message:u})},array(n){let u=i(c=>Array.isArray(c),{type:"array"});return s(u,"parse",(c,o)=>(o=c(o),n&&Array.isArray(o)?o.map((e,r)=>{try{return n.parse(e)}catch(t){let p=t.cause?.key?`${r}.${t.cause.key}`:r;throw new Error(`Error parsing index "${r}": ${t.message}`,{cause:{key:p}})}}):o)),u},any(){return i(()=>true)},preprocess(n,a){return s(a,"parse",(u,c)=>(c=n(c),u(c))),a}};function h(n){return a=>`The value "${a}" must be type of ${n} but is type of "${typeof a}".`}function s(n,a,u){let c=n[a];n[a]=(...o)=>u(c,...o);}function i(n,{type:a="any",message:u}={}){u=u||h(a);let c={message:u,type:a},o={parse(e){if(!n(e))throw new Error(u(e));return e},safeParse(e){try{return {success:!0,data:this.parse(e)}}catch(r){return {success:false,error:r}}},transform(e){return s(this,"parse",(r,t)=>e(r(t))),this},optional(){return s(this,"parse",(e,r)=>{try{return e(r)}catch{return}}),this},nullable(){return s(this,"parse",(e,r)=>{try{return e(r)}catch{return null}}),this},nullish(){return s(this,"parse",(e,r)=>{try{return e(r)}catch{return r==null?r:null}}),this},default(e){return s(this,"parse",(r,t)=>(t===void 0&&(t=e,t=typeof e=="function"?e():e),t=r(t),t)),this},pipe(e){return s(this,"parse",(r,t)=>e.parse(r(t))),this},refine(e,{message:r}){return s(this,"parse",(t,p)=>{let f=t(p);if(!e(f))throw new Error(r);return f}),this}};return m.reduce((e,r)=>r(e,n,c)??e,o)}var m=[];function I(n){m.push(n);}exports.extend=I;exports.s=y;
+'use strict';var h=r=>typeof r=="string"||r instanceof String,I=r=>typeof r=="number"||r instanceof Number,l=r=>r===true||r===false,y=r=>r instanceof Date&&!Number.isNaN(r.getTime()),d=r=>Array.isArray(r),S=r=>typeof r=="object"&&r!==null&&!Array.isArray(r),g={object(r){let a=p(S,{type:"object"});return i(a,"_parse",(u,...o)=>{let c=u(...o);if(c.success===false)return c;let n={};for(let t in r){let e=r[t]._parse(c.data[t]);if(e.success)n[t]=e.data;else {e=e;let s=e?.error?.cause?.key?`${t}.${e?.error?.cause?.key}`:t;return e.error.message=`Error parsing key "${s}": ${e.error.message}`,e.error.cause={key:s},e}}return {success:true,data:n}}),a},string(){return p(h,{type:"string"})},number(){return p(I,{type:"number"})},boolean(){return p(l,{type:"boolean"})},date(){return p(y,{type:"date"})},enum(r){let a=n=>r.includes(n),u=n=>`Invalid ${o} value. Expected ${r.map(t=>`"${t}"`).join(" | ")}, received "${n}".`,o="enum";return p(a,{type:o,message:u})},array(r){let a=p(d,{type:"array"});return i(a,"_parse",(u,...o)=>{let c=u(...o);if(c.success===false)return c;let n=[];for(let t=0;t<c.data.length;t++){let e=r._parse(c.data[t]);if(e.success)n.push(e.data);else {e=e;let s=e.error?.cause?.key?`${t}.${e.error.cause.key}`:`${t}`;return e.error.message=`Error parsing index "${t}": ${e.error.message}`,e.error.cause={key:s},e}}return {success:true,data:n}}),a},any(){return p(()=>true)},preprocess(r,a){return i(a,"_parse",(u,o)=>(o=r(o),u(o))),a}};function b(r){return a=>`The value "${a}" must be type of ${r} but is type of "${typeof a}".`}function i(r,a,u){let o=r[a];r[a]=(...c)=>u(o,...c);}function p(r,{type:a="any",message:u}={}){u=u||b(a);let o={message:u,type:a},c={_parse(n){return r(n)?{success:true,data:n}:{success:false,error:{message:u(n)}}},parse(n){let t=c._parse(n);if(!t.success)throw t=t,new Error(t.error.message,{cause:t.error.cause});return t.data},safeParse(n){return c._parse(n)},transform(n){return i(this,"_parse",(t,e)=>{let s=t(e);return s.success&&(s.data=n(s.data)),s}),this},optional(){return i(this,"_parse",(n,t)=>{let e=n(t);return e.success||(e.data=void 0,e.success=true),e}),this},nullable(){return i(this,"_parse",(n,t)=>{let e=n(t);return e.success||(e.data=null,e.success=true),e}),this},nullish(){return i(this,"_parse",(n,t)=>{let e=n(t);return !e.success&&t==null&&(e.success=true,e.data=t),e}),this},default(n){return i(this,"_parse",(t,e)=>(e===void 0&&(e=n,e=typeof n=="function"?n():n),t(e))),this},pipe(n){return i(this,"_parse",(t,e)=>{let s=t(e);return s.success?n._parse(s.data):s}),this},refine(n,{message:t}){return i(this,"_parse",(e,s)=>{let m=e(s);return n(m.data)?m:{success:false,error:{message:t}}}),this}};return f.length>0?f.reduce((n,t)=>t(n,r,o)??n,c):c}var f=[];function T(r){f.push(r);}exports.extend=T;exports.s=g;

package/dist/index.mjs

@@ -1 +1 @@
-var y={object(n){let u=i(c=>typeof c=="object"&&c!==null&&!Array.isArray(c),{type:"object"});return s(u,"parse",(c,...o)=>{let e=c(...o);return n&&typeof e=="object"?Object.keys(n).reduce((r,t)=>{if(typeof n[t]?.parse=="function")try{r[t]=n[t].parse(e[t]);}catch(p){throw t=p.cause?.key?`${t}.${p.cause.key}`:t,new Error(`Error parsing key "${t}": ${p.message}`,{cause:{key:t}})}return r},{}):e}),u},string(){return i(a=>typeof a=="string",{type:"string"})},number(){return i(a=>typeof a=="number",{type:"number"})},boolean(){return i(a=>a===true||a===false,{type:"boolean"})},date(){return i(a=>a instanceof Date&&!Number.isNaN(a.getTime()),{type:"date"})},enum(n){let a=e=>n.includes(e),u=e=>`Invalid ${c} value. Expected ${n.map(r=>`"${r}"`).join(" | ")}, received "${e}".`,c="enum";return i(a,{type:c,message:u})},array(n){let u=i(c=>Array.isArray(c),{type:"array"});return s(u,"parse",(c,o)=>(o=c(o),n&&Array.isArray(o)?o.map((e,r)=>{try{return n.parse(e)}catch(t){let p=t.cause?.key?`${r}.${t.cause.key}`:r;throw new Error(`Error parsing index "${r}": ${t.message}`,{cause:{key:p}})}}):o)),u},any(){return i(()=>true)},preprocess(n,a){return s(a,"parse",(u,c)=>(c=n(c),u(c))),a}};function h(n){return a=>`The value "${a}" must be type of ${n} but is type of "${typeof a}".`}function s(n,a,u){let c=n[a];n[a]=(...o)=>u(c,...o);}function i(n,{type:a="any",message:u}={}){u=u||h(a);let c={message:u,type:a},o={parse(e){if(!n(e))throw new Error(u(e));return e},safeParse(e){try{return {success:!0,data:this.parse(e)}}catch(r){return {success:false,error:r}}},transform(e){return s(this,"parse",(r,t)=>e(r(t))),this},optional(){return s(this,"parse",(e,r)=>{try{return e(r)}catch{return}}),this},nullable(){return s(this,"parse",(e,r)=>{try{return e(r)}catch{return null}}),this},nullish(){return s(this,"parse",(e,r)=>{try{return e(r)}catch{return r==null?r:null}}),this},default(e){return s(this,"parse",(r,t)=>(t===void 0&&(t=e,t=typeof e=="function"?e():e),t=r(t),t)),this},pipe(e){return s(this,"parse",(r,t)=>e.parse(r(t))),this},refine(e,{message:r}){return s(this,"parse",(t,p)=>{let f=t(p);if(!e(f))throw new Error(r);return f}),this}};return m.reduce((e,r)=>r(e,n,c)??e,o)}var m=[];function I(n){m.push(n);}export{I as extend,y as s};
+var h=r=>typeof r=="string"||r instanceof String,I=r=>typeof r=="number"||r instanceof Number,l=r=>r===true||r===false,y=r=>r instanceof Date&&!Number.isNaN(r.getTime()),d=r=>Array.isArray(r),S=r=>typeof r=="object"&&r!==null&&!Array.isArray(r),g={object(r){let a=p(S,{type:"object"});return i(a,"_parse",(u,...o)=>{let c=u(...o);if(c.success===false)return c;let n={};for(let t in r){let e=r[t]._parse(c.data[t]);if(e.success)n[t]=e.data;else {e=e;let s=e?.error?.cause?.key?`${t}.${e?.error?.cause?.key}`:t;return e.error.message=`Error parsing key "${s}": ${e.error.message}`,e.error.cause={key:s},e}}return {success:true,data:n}}),a},string(){return p(h,{type:"string"})},number(){return p(I,{type:"number"})},boolean(){return p(l,{type:"boolean"})},date(){return p(y,{type:"date"})},enum(r){let a=n=>r.includes(n),u=n=>`Invalid ${o} value. Expected ${r.map(t=>`"${t}"`).join(" | ")}, received "${n}".`,o="enum";return p(a,{type:o,message:u})},array(r){let a=p(d,{type:"array"});return i(a,"_parse",(u,...o)=>{let c=u(...o);if(c.success===false)return c;let n=[];for(let t=0;t<c.data.length;t++){let e=r._parse(c.data[t]);if(e.success)n.push(e.data);else {e=e;let s=e.error?.cause?.key?`${t}.${e.error.cause.key}`:`${t}`;return e.error.message=`Error parsing index "${t}": ${e.error.message}`,e.error.cause={key:s},e}}return {success:true,data:n}}),a},any(){return p(()=>true)},preprocess(r,a){return i(a,"_parse",(u,o)=>(o=r(o),u(o))),a}};function b(r){return a=>`The value "${a}" must be type of ${r} but is type of "${typeof a}".`}function i(r,a,u){let o=r[a];r[a]=(...c)=>u(o,...c);}function p(r,{type:a="any",message:u}={}){u=u||b(a);let o={message:u,type:a},c={_parse(n){return r(n)?{success:true,data:n}:{success:false,error:{message:u(n)}}},parse(n){let t=c._parse(n);if(!t.success)throw t=t,new Error(t.error.message,{cause:t.error.cause});return t.data},safeParse(n){return c._parse(n)},transform(n){return i(this,"_parse",(t,e)=>{let s=t(e);return s.success&&(s.data=n(s.data)),s}),this},optional(){return i(this,"_parse",(n,t)=>{let e=n(t);return e.success||(e.data=void 0,e.success=true),e}),this},nullable(){return i(this,"_parse",(n,t)=>{let e=n(t);return e.success||(e.data=null,e.success=true),e}),this},nullish(){return i(this,"_parse",(n,t)=>{let e=n(t);return !e.success&&t==null&&(e.success=true,e.data=t),e}),this},default(n){return i(this,"_parse",(t,e)=>(e===void 0&&(e=n,e=typeof n=="function"?n():n),t(e))),this},pipe(n){return i(this,"_parse",(t,e)=>{let s=t(e);return s.success?n._parse(s.data):s}),this},refine(n,{message:t}){return i(this,"_parse",(e,s)=>{let m=e(s);return n(m.data)?m:{success:false,error:{message:t}}}),this}};return f.length>0?f.reduce((n,t)=>t(n,r,o)??n,c):c}var f=[];function T(r){f.push(r);}export{T as extend,g as s};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esmj/schema",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Tiny extendable package for schema validation.",
   "keywords": [
     "schema",
@@ -22,6 +22,7 @@
   "scripts": {
     "lint": "biome check --no-errors-on-unmatched",
     "lint:fix": "npm run lint -- --fix --unsafe",
+    "benchmark": "node benchmark/index.ts",
     "dev": "node_modules/.bin/tsup --dts --watch --onSuccess 'node ./dist/index.mjs'",
     "test": "node --test --experimental-strip-types",
     "test:watch": "npm run test -- --watch",
@@ -62,17 +63,22 @@
   "homepage": "https://github.com/mjancarik/esmj-schema#readme",
   "devDependencies": {
     "@biomejs/biome": "1.9.4",
-    "@commitlint/cli": "^19.8.0",
-    "@commitlint/config-conventional": "^19.8.0",
-    "@typescript-eslint/eslint-plugin": "^8.31.0",
-    "@typescript-eslint/parser": "^8.31.0",
+    "@commitlint/cli": "^19.8.1",
+    "@commitlint/config-conventional": "^19.8.1",
+    "@typescript-eslint/eslint-plugin": "^8.33.0",
+    "@typescript-eslint/parser": "^8.33.0",
+    "@zod/mini": "^4.0.0-beta.0",
     "commitizen": "^4.3.1",
     "conventional-changelog-cli": "^5.0.0",
     "cz-conventional-changelog": "^3.3.0",
     "git-cz": "^4.9.0",
     "husky": "^9.1.7",
-    "lint-staged": "^15.5.1",
+    "joi": "^17.13.3",
+    "lint-staged": "^16.1.0",
     "prettier": "^3.5.3",
-    "tsup": "^8.4.0"
+    "superstruct": "^2.0.2",
+    "tsup": "^8.5.0",
+    "yup": "^1.6.1",
+    "zod": "^3.25.42"
   }
 }