unischema 1.1.0 → 1.2.0

package/dist/{schema-DYU1zGVm.d.mts → schema-DYE8Wz8X.d.mts}

@@ -1,4 +1,4 @@
-import { f as FieldDefinition, e as ValidationRule, V as ValidatorContext, S as SchemaDefinition } from './index-BQR7OrY7.mjs';
+import { F as FieldDefinition, c as ValidationRule, V as ValidatorContext, A as AsyncRefineFn, d as AsyncValidationOptions, S as SchemaDefinition } from './index-C17xs-fU.mjs';
 
 /**
  * Fluent field builder for schema definitions
@@ -10,6 +10,10 @@ declare class BaseFieldBuilder<T> {
     protected _required: boolean;
     protected _defaultValue?: T;
     protected _meta: Record<string, unknown>;
+    protected _transforms: Array<(value: unknown) => unknown>;
+    protected _preprocess?: (value: unknown) => unknown;
+    protected _nullable: boolean;
+    protected _nullish: boolean;
     constructor(type: FieldDefinition['type']);
     /**
      * Mark field as required
@@ -37,6 +41,31 @@ declare class BaseFieldBuilder<T> {
         valid: boolean;
         message?: string;
     } | boolean, message?: string): this;
+    /**
+     * Add async custom validation
+     */
+    refineAsync(validate: AsyncRefineFn<T>, options?: AsyncValidationOptions | string): this;
+    /**
+     * Add async soft validation (warning only)
+     */
+    refineAsyncSoft(validate: AsyncRefineFn<T>, options?: Omit<AsyncValidationOptions, 'soft'> | string): this;
+    /**
+     * Transform value before validation (applied after preprocessing)
+     */
+    transform<U = T>(transformer: (value: T) => U): BaseFieldBuilder<U>;
+    /**
+     * Preprocess value before transformations and validation
+     * Useful for handling null/undefined values
+     */
+    preprocess(preprocessor: (value: unknown) => unknown): this;
+    /**
+     * Allow null values
+     */
+    nullable(): this;
+    /**
+     * Allow null or undefined values
+     */
+    nullish(): this;
     /**
      * Add field metadata
      */
@@ -385,6 +414,31 @@ declare class ObjectFieldBuilder<T extends Record<string, unknown>> extends Base
     constructor(schemaFields: Record<string, BaseFieldBuilder<unknown>>);
     build(): FieldDefinition<T>;
 }
+/**
+ * Coercion namespace for automatic type conversion
+ */
+declare const coerce: {
+    /**
+     * Coerce value to string
+     */
+    string(): StringFieldBuilder;
+    /**
+     * Coerce value to number
+     */
+    number(): NumberFieldBuilder;
+    /**
+     * Coerce value to boolean
+     */
+    boolean(): BooleanFieldBuilder;
+    /**
+     * Coerce value to date
+     */
+    date(): DateFieldBuilder;
+    /**
+     * Coerce value to array
+     */
+    array<T>(itemBuilder?: BaseFieldBuilder<T>): ArrayFieldBuilder<T>;
+};
 
 /**
  * Schema builder and type inference
@@ -418,6 +472,30 @@ declare function omit<T extends Record<string, unknown>, K extends keyof T>(base
  * Make all fields optional
  */
 declare function partial<T extends Record<string, unknown>>(baseSchema: SchemaBuilder<T>): SchemaBuilder<Partial<T>>;
+/**
+ * Make all fields optional recursively (deep partial)
+ */
+declare function deepPartial<T extends Record<string, unknown>>(baseSchema: SchemaBuilder<T>): SchemaBuilder<DeepPartial<T>>;
+/**
+ * Allow unknown keys to pass through
+ */
+declare function passthrough<T extends Record<string, unknown>>(baseSchema: SchemaBuilder<T>): SchemaBuilder<T>;
+/**
+ * Strict mode - reject unknown keys
+ */
+declare function strict<T extends Record<string, unknown>>(baseSchema: SchemaBuilder<T>): SchemaBuilder<T>;
+/**
+ * Default handler for unknown keys (catchall)
+ */
+declare function catchall<T extends Record<string, unknown>>(baseSchema: SchemaBuilder<T>, fieldBuilder: BaseFieldBuilder<unknown>): SchemaBuilder<T>;
+/**
+ * Make specific fields required
+ */
+declare function required<T extends Record<string, unknown>, K extends keyof T>(baseSchema: SchemaBuilder<T>, keys: K[]): SchemaBuilder<T>;
+/**
+ * Make specific fields optional
+ */
+declare function optional<T extends Record<string, unknown>, K extends keyof T>(baseSchema: SchemaBuilder<T>, keys: K[]): SchemaBuilder<T>;
 /**
  * Merge multiple schemas
  */
@@ -432,6 +510,10 @@ type InferFields<F extends Record<string, BaseFieldBuilder<unknown>>> = {
 type InferInput<S> = S extends SchemaBuilder<infer T> ? T : never;
 /** Infer output type from a schema (validated data) */
 type InferOutput<S> = S extends SchemaBuilder<infer T> ? T : never;
+/** Deep partial type helper */
+type DeepPartial<T> = T extends object ? {
+    [P in keyof T]?: DeepPartial<T[P]>;
+} : T;
 /**
  * Field factory for creating typed field builders
  */
@@ -466,4 +548,4 @@ declare const field: {
     enum<E extends string>(values: readonly E[]): StringFieldBuilder;
 };
 
-export { ArrayFieldBuilder as A, BaseFieldBuilder as B, DateFieldBuilder as D, EnumFieldBuilder as E, type InferInput as I, NumberFieldBuilder as N, ObjectFieldBuilder as O, type SchemaBuilder as S, partial as a, type InferOutput as b, StringFieldBuilder as c, BooleanFieldBuilder as d, extend as e, field as f, merge as m, omit as o, pick as p, schema as s };
+export { ArrayFieldBuilder as A, BaseFieldBuilder as B, type DeepPartial as D, EnumFieldBuilder as E, type InferInput as I, NumberFieldBuilder as N, ObjectFieldBuilder as O, type SchemaBuilder as S, partial as a, passthrough as b, strict as c, deepPartial as d, extend as e, catchall as f, optional as g, field as h, coerce as i, type InferOutput as j, StringFieldBuilder as k, BooleanFieldBuilder as l, merge as m, DateFieldBuilder as n, omit as o, pick as p, required as r, schema as s };

package/dist/{schema-CpAjXgEF.d.ts → schema-Dtp-joeT.d.ts}

@@ -1,4 +1,4 @@
-import { f as FieldDefinition, e as ValidationRule, V as ValidatorContext, S as SchemaDefinition } from './index-BQR7OrY7.js';
+import { F as FieldDefinition, c as ValidationRule, V as ValidatorContext, A as AsyncRefineFn, d as AsyncValidationOptions, S as SchemaDefinition } from './index-C17xs-fU.js';
 
 /**
  * Fluent field builder for schema definitions
@@ -10,6 +10,10 @@ declare class BaseFieldBuilder<T> {
     protected _required: boolean;
     protected _defaultValue?: T;
     protected _meta: Record<string, unknown>;
+    protected _transforms: Array<(value: unknown) => unknown>;
+    protected _preprocess?: (value: unknown) => unknown;
+    protected _nullable: boolean;
+    protected _nullish: boolean;
     constructor(type: FieldDefinition['type']);
     /**
      * Mark field as required
@@ -37,6 +41,31 @@ declare class BaseFieldBuilder<T> {
         valid: boolean;
         message?: string;
     } | boolean, message?: string): this;
+    /**
+     * Add async custom validation
+     */
+    refineAsync(validate: AsyncRefineFn<T>, options?: AsyncValidationOptions | string): this;
+    /**
+     * Add async soft validation (warning only)
+     */
+    refineAsyncSoft(validate: AsyncRefineFn<T>, options?: Omit<AsyncValidationOptions, 'soft'> | string): this;
+    /**
+     * Transform value before validation (applied after preprocessing)
+     */
+    transform<U = T>(transformer: (value: T) => U): BaseFieldBuilder<U>;
+    /**
+     * Preprocess value before transformations and validation
+     * Useful for handling null/undefined values
+     */
+    preprocess(preprocessor: (value: unknown) => unknown): this;
+    /**
+     * Allow null values
+     */
+    nullable(): this;
+    /**
+     * Allow null or undefined values
+     */
+    nullish(): this;
     /**
      * Add field metadata
      */
@@ -385,6 +414,31 @@ declare class ObjectFieldBuilder<T extends Record<string, unknown>> extends Base
     constructor(schemaFields: Record<string, BaseFieldBuilder<unknown>>);
     build(): FieldDefinition<T>;
 }
+/**
+ * Coercion namespace for automatic type conversion
+ */
+declare const coerce: {
+    /**
+     * Coerce value to string
+     */
+    string(): StringFieldBuilder;
+    /**
+     * Coerce value to number
+     */
+    number(): NumberFieldBuilder;
+    /**
+     * Coerce value to boolean
+     */
+    boolean(): BooleanFieldBuilder;
+    /**
+     * Coerce value to date
+     */
+    date(): DateFieldBuilder;
+    /**
+     * Coerce value to array
+     */
+    array<T>(itemBuilder?: BaseFieldBuilder<T>): ArrayFieldBuilder<T>;
+};
 
 /**
  * Schema builder and type inference
@@ -418,6 +472,30 @@ declare function omit<T extends Record<string, unknown>, K extends keyof T>(base
  * Make all fields optional
  */
 declare function partial<T extends Record<string, unknown>>(baseSchema: SchemaBuilder<T>): SchemaBuilder<Partial<T>>;
+/**
+ * Make all fields optional recursively (deep partial)
+ */
+declare function deepPartial<T extends Record<string, unknown>>(baseSchema: SchemaBuilder<T>): SchemaBuilder<DeepPartial<T>>;
+/**
+ * Allow unknown keys to pass through
+ */
+declare function passthrough<T extends Record<string, unknown>>(baseSchema: SchemaBuilder<T>): SchemaBuilder<T>;
+/**
+ * Strict mode - reject unknown keys
+ */
+declare function strict<T extends Record<string, unknown>>(baseSchema: SchemaBuilder<T>): SchemaBuilder<T>;
+/**
+ * Default handler for unknown keys (catchall)
+ */
+declare function catchall<T extends Record<string, unknown>>(baseSchema: SchemaBuilder<T>, fieldBuilder: BaseFieldBuilder<unknown>): SchemaBuilder<T>;
+/**
+ * Make specific fields required
+ */
+declare function required<T extends Record<string, unknown>, K extends keyof T>(baseSchema: SchemaBuilder<T>, keys: K[]): SchemaBuilder<T>;
+/**
+ * Make specific fields optional
+ */
+declare function optional<T extends Record<string, unknown>, K extends keyof T>(baseSchema: SchemaBuilder<T>, keys: K[]): SchemaBuilder<T>;
 /**
  * Merge multiple schemas
  */
@@ -432,6 +510,10 @@ type InferFields<F extends Record<string, BaseFieldBuilder<unknown>>> = {
 type InferInput<S> = S extends SchemaBuilder<infer T> ? T : never;
 /** Infer output type from a schema (validated data) */
 type InferOutput<S> = S extends SchemaBuilder<infer T> ? T : never;
+/** Deep partial type helper */
+type DeepPartial<T> = T extends object ? {
+    [P in keyof T]?: DeepPartial<T[P]>;
+} : T;
 /**
  * Field factory for creating typed field builders
  */
@@ -466,4 +548,4 @@ declare const field: {
     enum<E extends string>(values: readonly E[]): StringFieldBuilder;
 };
 
-export { ArrayFieldBuilder as A, BaseFieldBuilder as B, DateFieldBuilder as D, EnumFieldBuilder as E, type InferInput as I, NumberFieldBuilder as N, ObjectFieldBuilder as O, type SchemaBuilder as S, partial as a, type InferOutput as b, StringFieldBuilder as c, BooleanFieldBuilder as d, extend as e, field as f, merge as m, omit as o, pick as p, schema as s };
+export { ArrayFieldBuilder as A, BaseFieldBuilder as B, type DeepPartial as D, EnumFieldBuilder as E, type InferInput as I, NumberFieldBuilder as N, ObjectFieldBuilder as O, type SchemaBuilder as S, partial as a, passthrough as b, strict as c, deepPartial as d, extend as e, catchall as f, optional as g, field as h, coerce as i, type InferOutput as j, StringFieldBuilder as k, BooleanFieldBuilder as l, merge as m, DateFieldBuilder as n, omit as o, pick as p, required as r, schema as s };

package/dist/validators/array.d.mts

@@ -1,4 +1,4 @@
-import { c as ValidatorFn } from '../index-BQR7OrY7.mjs';
+import { f as ValidatorFn } from '../index-C17xs-fU.mjs';
 
 declare const includesValidator: ValidatorFn;
 

package/dist/validators/array.d.ts

@@ -1,4 +1,4 @@
-import { c as ValidatorFn } from '../index-BQR7OrY7.js';
+import { f as ValidatorFn } from '../index-C17xs-fU.js';
 
 declare const includesValidator: ValidatorFn;
 

package/dist/validators/array.js

@@ -1,31 +1,31 @@
 'use strict';
 
-var chunkASKTY6EG_js = require('../chunk-ASKTY6EG.js');
-require('../chunk-NUW55QTO.js');
+var chunk66RFUBVU_js = require('../chunk-66RFUBVU.js');
+require('../chunk-OIYG5D2I.js');
 
 
 
 Object.defineProperty(exports, "compactValidator", {
   enumerable: true,
-  get: function () { return chunkASKTY6EG_js.compactValidator; }
+  get: function () { return chunk66RFUBVU_js.compactValidator; }
 });
 Object.defineProperty(exports, "emptyValidator", {
   enumerable: true,
-  get: function () { return chunkASKTY6EG_js.emptyValidator; }
+  get: function () { return chunk66RFUBVU_js.emptyValidator; }
 });
 Object.defineProperty(exports, "excludesValidator", {
   enumerable: true,
-  get: function () { return chunkASKTY6EG_js.excludesValidator; }
+  get: function () { return chunk66RFUBVU_js.excludesValidator; }
 });
 Object.defineProperty(exports, "includesValidator", {
   enumerable: true,
-  get: function () { return chunkASKTY6EG_js.includesValidator; }
+  get: function () { return chunk66RFUBVU_js.includesValidator; }
 });
 Object.defineProperty(exports, "notEmptyValidator", {
   enumerable: true,
-  get: function () { return chunkASKTY6EG_js.notEmptyValidator; }
+  get: function () { return chunk66RFUBVU_js.notEmptyValidator; }
 });
 Object.defineProperty(exports, "sortedValidator", {
   enumerable: true,
-  get: function () { return chunkASKTY6EG_js.sortedValidator; }
+  get: function () { return chunk66RFUBVU_js.sortedValidator; }
 });

package/dist/validators/array.mjs

@@ -1,2 +1,2 @@
-export { compactValidator, emptyValidator, excludesValidator, includesValidator, notEmptyValidator, sortedValidator } from '../chunk-XGTUU27F.mjs';
-import '../chunk-FKDWSZIV.mjs';
+export { compactValidator, emptyValidator, excludesValidator, includesValidator, notEmptyValidator, sortedValidator } from '../chunk-5A4ITJVD.mjs';
+import '../chunk-KZZ7NVU3.mjs';

package/dist/validators/common.d.mts

@@ -1,4 +1,4 @@
-import { c as ValidatorFn } from '../index-BQR7OrY7.mjs';
+import { f as ValidatorFn } from '../index-C17xs-fU.mjs';
 
 declare const notMatchesValidator: ValidatorFn;
 

package/dist/validators/common.d.ts

@@ -1,4 +1,4 @@
-import { c as ValidatorFn } from '../index-BQR7OrY7.js';
+import { f as ValidatorFn } from '../index-C17xs-fU.js';
 
 declare const notMatchesValidator: ValidatorFn;
 

package/dist/validators/common.js

@@ -1,27 +1,27 @@
 'use strict';
 
-var chunk2JYFKT3R_js = require('../chunk-2JYFKT3R.js');
-require('../chunk-NUW55QTO.js');
+var chunkFPCCH55A_js = require('../chunk-FPCCH55A.js');
+require('../chunk-OIYG5D2I.js');
 
 
 
 Object.defineProperty(exports, "dependsOnValidator", {
   enumerable: true,
-  get: function () { return chunk2JYFKT3R_js.dependsOnValidator; }
+  get: function () { return chunkFPCCH55A_js.dependsOnValidator; }
 });
 Object.defineProperty(exports, "greaterThanValidator", {
   enumerable: true,
-  get: function () { return chunk2JYFKT3R_js.greaterThanValidator; }
+  get: function () { return chunkFPCCH55A_js.greaterThanValidator; }
 });
 Object.defineProperty(exports, "lessThanValidator", {
   enumerable: true,
-  get: function () { return chunk2JYFKT3R_js.lessThanValidator; }
+  get: function () { return chunkFPCCH55A_js.lessThanValidator; }
 });
 Object.defineProperty(exports, "notMatchesValidator", {
   enumerable: true,
-  get: function () { return chunk2JYFKT3R_js.notMatchesValidator; }
+  get: function () { return chunkFPCCH55A_js.notMatchesValidator; }
 });
 Object.defineProperty(exports, "whenValidator", {
   enumerable: true,
-  get: function () { return chunk2JYFKT3R_js.whenValidator; }
+  get: function () { return chunkFPCCH55A_js.whenValidator; }
 });

package/dist/validators/common.mjs

@@ -1,2 +1,2 @@
-export { dependsOnValidator, greaterThanValidator, lessThanValidator, notMatchesValidator, whenValidator } from '../chunk-XC4DKEXP.mjs';
-import '../chunk-FKDWSZIV.mjs';
+export { dependsOnValidator, greaterThanValidator, lessThanValidator, notMatchesValidator, whenValidator } from '../chunk-KZCV5IW4.mjs';
+import '../chunk-KZZ7NVU3.mjs';

package/dist/validators/date.d.mts

@@ -1,4 +1,4 @@
-import { c as ValidatorFn } from '../index-BQR7OrY7.mjs';
+import { f as ValidatorFn } from '../index-C17xs-fU.mjs';
 
 declare const todayValidator: ValidatorFn;
 

package/dist/validators/date.d.ts

@@ -1,4 +1,4 @@
-import { c as ValidatorFn } from '../index-BQR7OrY7.js';
+import { f as ValidatorFn } from '../index-C17xs-fU.js';
 
 declare const todayValidator: ValidatorFn;
 

package/dist/validators/date.js

@@ -1,47 +1,47 @@
 'use strict';
 
-var chunkFZ7K2PC7_js = require('../chunk-FZ7K2PC7.js');
-require('../chunk-NUW55QTO.js');
+var chunkTXT36BCE_js = require('../chunk-TXT36BCE.js');
+require('../chunk-OIYG5D2I.js');
 
 
 
 Object.defineProperty(exports, "ageValidator", {
   enumerable: true,
-  get: function () { return chunkFZ7K2PC7_js.ageValidator; }
+  get: function () { return chunkTXT36BCE_js.ageValidator; }
 });
 Object.defineProperty(exports, "betweenValidator", {
   enumerable: true,
-  get: function () { return chunkFZ7K2PC7_js.betweenValidator; }
+  get: function () { return chunkTXT36BCE_js.betweenValidator; }
 });
 Object.defineProperty(exports, "thisMonthValidator", {
   enumerable: true,
-  get: function () { return chunkFZ7K2PC7_js.thisMonthValidator; }
+  get: function () { return chunkTXT36BCE_js.thisMonthValidator; }
 });
 Object.defineProperty(exports, "thisWeekValidator", {
   enumerable: true,
-  get: function () { return chunkFZ7K2PC7_js.thisWeekValidator; }
+  get: function () { return chunkTXT36BCE_js.thisWeekValidator; }
 });
 Object.defineProperty(exports, "thisYearValidator", {
   enumerable: true,
-  get: function () { return chunkFZ7K2PC7_js.thisYearValidator; }
+  get: function () { return chunkTXT36BCE_js.thisYearValidator; }
 });
 Object.defineProperty(exports, "todayValidator", {
   enumerable: true,
-  get: function () { return chunkFZ7K2PC7_js.todayValidator; }
+  get: function () { return chunkTXT36BCE_js.todayValidator; }
 });
 Object.defineProperty(exports, "tomorrowValidator", {
   enumerable: true,
-  get: function () { return chunkFZ7K2PC7_js.tomorrowValidator; }
+  get: function () { return chunkTXT36BCE_js.tomorrowValidator; }
 });
 Object.defineProperty(exports, "weekdayValidator", {
   enumerable: true,
-  get: function () { return chunkFZ7K2PC7_js.weekdayValidator; }
+  get: function () { return chunkTXT36BCE_js.weekdayValidator; }
 });
 Object.defineProperty(exports, "weekendValidator", {
   enumerable: true,
-  get: function () { return chunkFZ7K2PC7_js.weekendValidator; }
+  get: function () { return chunkTXT36BCE_js.weekendValidator; }
 });
 Object.defineProperty(exports, "yesterdayValidator", {
   enumerable: true,
-  get: function () { return chunkFZ7K2PC7_js.yesterdayValidator; }
+  get: function () { return chunkTXT36BCE_js.yesterdayValidator; }
 });

package/dist/validators/date.mjs

@@ -1,2 +1,2 @@
-export { ageValidator, betweenValidator, thisMonthValidator, thisWeekValidator, thisYearValidator, todayValidator, tomorrowValidator, weekdayValidator, weekendValidator, yesterdayValidator } from '../chunk-ELL7U7IC.mjs';
-import '../chunk-FKDWSZIV.mjs';
+export { ageValidator, betweenValidator, thisMonthValidator, thisWeekValidator, thisYearValidator, todayValidator, tomorrowValidator, weekdayValidator, weekendValidator, yesterdayValidator } from '../chunk-7XES4A3M.mjs';
+import '../chunk-KZZ7NVU3.mjs';

package/dist/validators/index.d.mts

@@ -4,7 +4,7 @@ export { ageValidator, betweenValidator as dateBetweenValidator, thisMonthValida
 export { compactValidator, emptyValidator, excludesValidator, includesValidator, notEmptyValidator, sortedValidator } from './array.mjs';
 export { keysValidator, omitValidator, pickValidator, strictValidator } from './object.mjs';
 export { dependsOnValidator, greaterThanValidator, lessThanValidator, notMatchesValidator, whenValidator } from './common.mjs';
-import { V as ValidatorContext, a as ValidationError } from '../index-BQR7OrY7.mjs';
+import { V as ValidatorContext, a as ValidationError } from '../index-C17xs-fU.mjs';
 
 /**
  * Shared utilities for validators
@@ -13,7 +13,7 @@ import { V as ValidatorContext, a as ValidationError } from '../index-BQR7OrY7.m
 /**
  * Create a validation error
  */
-declare function createError(context: ValidatorContext, code: string, message: string, soft?: boolean): ValidationError;
+declare function createError(context: ValidatorContext, code: string, message: string, soft?: boolean, received?: unknown, expected?: unknown): ValidationError;
 /**
  * Check if value is empty (null, undefined, or empty string)
  */

package/dist/validators/index.d.ts

@@ -4,7 +4,7 @@ export { ageValidator, betweenValidator as dateBetweenValidator, thisMonthValida
 export { compactValidator, emptyValidator, excludesValidator, includesValidator, notEmptyValidator, sortedValidator } from './array.js';
 export { keysValidator, omitValidator, pickValidator, strictValidator } from './object.js';
 export { dependsOnValidator, greaterThanValidator, lessThanValidator, notMatchesValidator, whenValidator } from './common.js';
-import { V as ValidatorContext, a as ValidationError } from '../index-BQR7OrY7.js';
+import { V as ValidatorContext, a as ValidationError } from '../index-C17xs-fU.js';
 
 /**
  * Shared utilities for validators
@@ -13,7 +13,7 @@ import { V as ValidatorContext, a as ValidationError } from '../index-BQR7OrY7.j
 /**
  * Create a validation error
  */
-declare function createError(context: ValidatorContext, code: string, message: string, soft?: boolean): ValidationError;
+declare function createError(context: ValidatorContext, code: string, message: string, soft?: boolean, received?: unknown, expected?: unknown): ValidationError;
 /**
  * Check if value is empty (null, undefined, or empty string)
  */