@esmj/schema 0.4.0 → 0.5.0

package/dist/number.cjs

@@ -0,0 +1 @@
+'use strict';var P={abortEarly:true};function S(e,o){if(!o)return e;let i=e?.cause?.key?`${o}.${e.cause.key}`:`${o}`;return {message:`Error parsing key "${i}": ${e.message}`,cause:{key:i}}}function g(e,o,i){!e.errors||e.errors.length===0||e.errors.forEach(u=>{let c=S(u,i);o.push(c);});}function d(e){return {...P,...e}}var N=e=>typeof e=="string"||e instanceof String,k=e=>typeof e=="number"||e instanceof Number,w=e=>e===true||e===false,E=e=>e instanceof Date&&!Number.isNaN(e.getTime()),_=e=>Array.isArray(e),O=e=>typeof e=="object"&&e!==null&&!Array.isArray(e),A={object(e,o){let i=I(O,{...o,type:"object"});return i._getDescription=()=>`object({ ${Object.entries(e).map(([c,r])=>`${c}: ${r._getDescription()}`).join(", ")} })`,h(i,"_parse",(u,c,r)=>{let t=u(c,r),{abortEarly:n}=d(r);if(t.success===false)return t;let s={},a=[];for(let p in e){let f=e[p]._parse(t.data[p],r);if(f.success)s[p]=f.data;else {if(f=f,n!==false){let m=S(f.error,p);return {success:false,error:m,errors:[m]}}g(f,a,p);}}return a.length>0?{success:false,error:a[0],errors:a}:{success:true,data:s}}),i},string(e){return I(N,{...e,type:"string"})},number(e){return I(k,{...e,type:"number"})},boolean(e){return I(w,{...e,type:"boolean"})},date(e){return I(E,{...e,type:"date"})},enum(e,o){let i=t=>e.includes(t),u=t=>`Invalid ${c} value. Expected ${e.map(n=>`"${n}"`).join(" | ")}, received "${t}".`,c="enum",r=I(i,{message:u,...o,type:c});return r._getDescription=()=>`enum(${e.map(t=>`"${t}"`).join(" | ")})`,r},array(e,o){let i=I(_,{...o,type:"array"});return i._getDescription=()=>`array(${e._getDescription()})`,h(i,"_parse",(u,c,r)=>{let t=u(c,r),{abortEarly:n}=d(r);if(t.success===false)return t;let s=[],a=[];for(let p=0;p<t.data.length;p++){let f=e._parse(t.data[p],r);if(f.success)s.push(f.data);else {if(f=f,n!==false){let m=S(f.error,p);return {success:false,error:m,errors:[m]}}g(f,a,p);}}return a.length>0?{success:false,error:a[0],errors:a}:{success:true,data:s}}),i},any(){return I(()=>true)},preprocess(e,o){return h(o,"_parse",(i,u)=>(u=e(u),i(u))),o},union(e,o){return I(r=>{for(let t=0;t<e.length;t++){let n=e[t]._parse(r);if(n.success)return n}return  false},{message:r=>`Invalid union value. Expected the value to match one of the schemas:${e.map((t,n)=>` ${n+1}. ${t._getDescription()}`).join(",")} but received "${typeof r}" with value: ${O(r)?JSON.stringify(r):`"${r}"`}`,...o,type:"union"})}};function T(e){return o=>`The value "${o}" must be type of ${e} but is type of "${typeof o}".`}function h(e,o,i){let u=e[o];e[o]=(...c)=>i(u,...c);}function I(e,{type:o="any",name:i,message:u}={}){u=u||T(o);let c={name:i,message:u,type:o},r={_getName(){return i},_getType(){return o},_getDescription(){return this._getName()??this._getType()},_parse(t,n){let s=e(t);if(s===true)return {success:true,data:t};if(typeof s=="object"&&s?.success===true)return s;let a={message:typeof u=="function"?u(t):u};return {success:false,error:a,errors:[a]}},parse(t,n){let s=r._parse(t,n);if(!s.success)throw s=s,new Error(s.error.message,{cause:s.error.cause});return s.data},safeParse(t,n){return r._parse(t,n)},transform(t){return h(this,"_parse",(n,s,a)=>{let p=n(s,a);return p.success&&(p.data=t(p.data)),p}),this},optional(){return h(this,"_parse",(t,n,s)=>{let a=t(n,s);return !a.success&&n===void 0&&(a.data=void 0,a.success=true),a}),this},nullable(){return h(this,"_parse",(t,n,s)=>{let a=t(n,s);return !a.success&&n===null&&(a.data=null,a.success=true),a}),this},nullish(){return h(this,"_parse",(t,n,s)=>{let a=t(n,s);return !a.success&&n==null&&(a.success=true,a.data=n),a}),this},default(t){return h(this,"_parse",(n,s,a)=>(s===void 0&&(s=t,s=typeof t=="function"?t():t),n(s,a))),this},pipe(t){return h(this,"_parse",(n,s,a)=>{let p=n(s,a);return p.success?t._parse(p.data,a):p}),this},refine(t,{message:n,type:s}={}){return s&&(n=n||T(s),o=s),h(this,"_parse",(a,p,f)=>{let m=a(p,f);d(f);if(!m.success)return m;let l=t(m.data);if(l===true||typeof l=="object"&&l?.success===true)return m;let b={message:typeof n=="function"?n(p):n};return {success:false,error:b,errors:[b]}}),this}};return y.length>0?y.reduce((t,n)=>n(t,e,c)??t,r):r}var y=[];function x(e){y.push(e);}x((e,o,i)=>{if(i?.type==="number"){let u=e;u.min=function(c,{message:r}={}){return this.refine(t=>t>=c,{message:r||`Number must be greater than or equal to ${c}.`})},u.max=function(c,{message:r}={}){return this.refine(t=>t<=c,{message:r||`Number must be less than or equal to ${c}.`})},u.positive=function({message:c}={}){return this.refine(r=>r>0,{message:c||"Number must be positive."})},u.negative=function({message:c}={}){return this.refine(r=>r<0,{message:c||"Number must be negative."})},u.int=function({message:c}={}){return this.refine(r=>Number.isInteger(r),{message:c||"Number must be an integer."})},u.float=function({message:c}={}){return this.refine(r=>Number.isFinite(r)&&!Number.isInteger(r),{message:c||"Number must be a floating point (non-integer)."})},u.multipleOf=function(c,{message:r}={}){return this.refine(t=>t%c===0,{message:r||`Number must be a multiple of ${c}.`})},u.finite=function({message:c}={}){return this.refine(r=>Number.isFinite(r),{message:c||"Number must be finite."})};}return e});exports.extend=x;exports.hookOriginal=h;exports.s=A;

package/dist/number.d.cts

@@ -0,0 +1,14 @@
+export { ArraySchemaInterface, BooleanSchemaInterface, DateSchemaInterface, EnumSchemaInterface, ErrorStructure, ExtenderType, Infer, Invalid, NumberSchemaInterface, ObjectSchemaInterface, SchemaInterface, SchemaInterfaceOptions, SchemaType, StringSchemaInterface, UnionSchemaInterface, Valid, extend, hookOriginal, s } from './index.cjs';
+
+declare module './index.ts' {
+    interface NumberSchemaInterface {
+        min(value: number, options?: SchemaInterfaceOptions): NumberSchemaInterface;
+        max(value: number, options?: SchemaInterfaceOptions): NumberSchemaInterface;
+        positive(options?: SchemaInterfaceOptions): NumberSchemaInterface;
+        negative(options?: SchemaInterfaceOptions): NumberSchemaInterface;
+        int(options?: SchemaInterfaceOptions): NumberSchemaInterface;
+        float(options?: SchemaInterfaceOptions): NumberSchemaInterface;
+        multipleOf(value: number, options?: SchemaInterfaceOptions): NumberSchemaInterface;
+        finite(options?: SchemaInterfaceOptions): NumberSchemaInterface;
+    }
+}

package/dist/number.d.ts

@@ -0,0 +1,14 @@
+export { ArraySchemaInterface, BooleanSchemaInterface, DateSchemaInterface, EnumSchemaInterface, ErrorStructure, ExtenderType, Infer, Invalid, NumberSchemaInterface, ObjectSchemaInterface, SchemaInterface, SchemaInterfaceOptions, SchemaType, StringSchemaInterface, UnionSchemaInterface, Valid, extend, hookOriginal, s } from './index.js';
+
+declare module './index.ts' {
+    interface NumberSchemaInterface {
+        min(value: number, options?: SchemaInterfaceOptions): NumberSchemaInterface;
+        max(value: number, options?: SchemaInterfaceOptions): NumberSchemaInterface;
+        positive(options?: SchemaInterfaceOptions): NumberSchemaInterface;
+        negative(options?: SchemaInterfaceOptions): NumberSchemaInterface;
+        int(options?: SchemaInterfaceOptions): NumberSchemaInterface;
+        float(options?: SchemaInterfaceOptions): NumberSchemaInterface;
+        multipleOf(value: number, options?: SchemaInterfaceOptions): NumberSchemaInterface;
+        finite(options?: SchemaInterfaceOptions): NumberSchemaInterface;
+    }
+}

package/dist/number.js

@@ -0,0 +1 @@
+import'./chunk-QEBUM44M.js';export{c as extend,b as hookOriginal,a as s}from'./chunk-5ARMWSHU.js';

package/dist/string.cjs

@@ -0,0 +1 @@
+'use strict';var P={abortEarly:true};function I(t,o){if(!o)return t;let i=t?.cause?.key?`${o}.${t.cause.key}`:`${o}`;return {message:`Error parsing key "${i}": ${t.message}`,cause:{key:i}}}function O(t,o,i){!t.errors||t.errors.length===0||t.errors.forEach(c=>{let r=I(c,i);o.push(r);});}function d(t){return {...P,...t}}var k=t=>typeof t=="string"||t instanceof String,w=t=>typeof t=="number"||t instanceof Number,E=t=>t===true||t===false,$=t=>t instanceof Date&&!Number.isNaN(t.getTime()),_=t=>Array.isArray(t),b=t=>typeof t=="object"&&t!==null&&!Array.isArray(t),A={object(t,o){let i=S(b,{...o,type:"object"});return i._getDescription=()=>`object({ ${Object.entries(t).map(([r,n])=>`${r}: ${n._getDescription()}`).join(", ")} })`,h(i,"_parse",(c,r,n)=>{let e=c(r,n),{abortEarly:a}=d(n);if(e.success===false)return e;let u={},s=[];for(let p in t){let f=t[p]._parse(e.data[p],n);if(f.success)u[p]=f.data;else {if(f=f,a!==false){let m=I(f.error,p);return {success:false,error:m,errors:[m]}}O(f,s,p);}}return s.length>0?{success:false,error:s[0],errors:s}:{success:true,data:u}}),i},string(t){return S(k,{...t,type:"string"})},number(t){return S(w,{...t,type:"number"})},boolean(t){return S(E,{...t,type:"boolean"})},date(t){return S($,{...t,type:"date"})},enum(t,o){let i=e=>t.includes(e),c=e=>`Invalid ${r} value. Expected ${t.map(a=>`"${a}"`).join(" | ")}, received "${e}".`,r="enum",n=S(i,{message:c,...o,type:r});return n._getDescription=()=>`enum(${t.map(e=>`"${e}"`).join(" | ")})`,n},array(t,o){let i=S(_,{...o,type:"array"});return i._getDescription=()=>`array(${t._getDescription()})`,h(i,"_parse",(c,r,n)=>{let e=c(r,n),{abortEarly:a}=d(n);if(e.success===false)return e;let u=[],s=[];for(let p=0;p<e.data.length;p++){let f=t._parse(e.data[p],n);if(f.success)u.push(f.data);else {if(f=f,a!==false){let m=I(f.error,p);return {success:false,error:m,errors:[m]}}O(f,s,p);}}return s.length>0?{success:false,error:s[0],errors:s}:{success:true,data:u}}),i},any(){return S(()=>true)},preprocess(t,o){return h(o,"_parse",(i,c)=>(c=t(c),i(c))),o},union(t,o){return S(n=>{for(let e=0;e<t.length;e++){let a=t[e]._parse(n);if(a.success)return a}return  false},{message:n=>`Invalid union value. Expected the value to match one of the schemas:${t.map((e,a)=>` ${a+1}. ${e._getDescription()}`).join(",")} but received "${typeof n}" with value: ${b(n)?JSON.stringify(n):`"${n}"`}`,...o,type:"union"})}};function T(t){return o=>`The value "${o}" must be type of ${t} but is type of "${typeof o}".`}function h(t,o,i){let c=t[o];t[o]=(...r)=>i(c,...r);}function S(t,{type:o="any",name:i,message:c}={}){c=c||T(o);let r={name:i,message:c,type:o},n={_getName(){return i},_getType(){return o},_getDescription(){return this._getName()??this._getType()},_parse(e,a){let u=t(e);if(u===true)return {success:true,data:e};if(typeof u=="object"&&u?.success===true)return u;let s={message:typeof c=="function"?c(e):c};return {success:false,error:s,errors:[s]}},parse(e,a){let u=n._parse(e,a);if(!u.success)throw u=u,new Error(u.error.message,{cause:u.error.cause});return u.data},safeParse(e,a){return n._parse(e,a)},transform(e){return h(this,"_parse",(a,u,s)=>{let p=a(u,s);return p.success&&(p.data=e(p.data)),p}),this},optional(){return h(this,"_parse",(e,a,u)=>{let s=e(a,u);return !s.success&&a===void 0&&(s.data=void 0,s.success=true),s}),this},nullable(){return h(this,"_parse",(e,a,u)=>{let s=e(a,u);return !s.success&&a===null&&(s.data=null,s.success=true),s}),this},nullish(){return h(this,"_parse",(e,a,u)=>{let s=e(a,u);return !s.success&&a==null&&(s.success=true,s.data=a),s}),this},default(e){return h(this,"_parse",(a,u,s)=>(u===void 0&&(u=e,u=typeof e=="function"?e():e),a(u,s))),this},pipe(e){return h(this,"_parse",(a,u,s)=>{let p=a(u,s);return p.success?e._parse(p.data,s):p}),this},refine(e,{message:a,type:u}={}){return u&&(a=a||T(u),o=u),h(this,"_parse",(s,p,f)=>{let m=s(p,f);d(f);if(!m.success)return m;let l=e(m.data);if(l===true||typeof l=="object"&&l?.success===true)return m;let g={message:typeof a=="function"?a(p):a};return {success:false,error:g,errors:[g]}}),this}};return y.length>0?y.reduce((e,a)=>a(e,t,r)??e,n):n}var y=[];function x(t){y.push(t);}x((t,o,i)=>{if(i?.type==="string"){let c=t;c.min=function(r,{message:n}={}){return this.refine(e=>e.length>=r,{message:n||(e=>`String must be at least ${r} characters long (received ${e.length} characters: "${e}")`)})},c.max=function(r,{message:n}={}){return this.refine(e=>e.length<=r,{message:n||(e=>`String must be at most ${r} characters long (received ${e.length} characters: "${e}")`)})},c.length=function(r,{message:n}={}){return this.refine(e=>e.length===r,{message:n||(e=>`String must be exactly ${r} characters long (received ${e.length} characters: "${e}")`)})},c.nonEmpty=function({message:r}={}){return this.refine(n=>n.length>0,{message:r||"String must not be empty (received empty string)"})},c.startsWith=function(r,{message:n}={}){return this.refine(e=>e.startsWith(r),{message:n||(e=>`String must start with "${r}" (received: "${e}")`)})},c.endsWith=function(r,{message:n}={}){return this.refine(e=>e.endsWith(r),{message:n||(e=>`String must end with "${r}" (received: "${e}")`)})},c.includes=function(r,{message:n}={}){return this.refine(e=>e.includes(r),{message:n||(e=>`String must include "${r}" (received: "${e}")`)})},c.toLowerCase=function(){return this.transform(r=>r.toLowerCase())},c.toUpperCase=function(){return this.transform(r=>r.toUpperCase())},c.trim=function(){return this.transform(r=>r.trim())},c.padStart=function(r,n=" "){return this.transform(e=>e.padStart(r,n))},c.padEnd=function(r,n=" "){return this.transform(e=>e.padEnd(r,n))},c.replace=function(r,n){return this.transform(e=>e.replace(r,n))};}return t});exports.extend=x;exports.hookOriginal=h;exports.s=A;

package/dist/string.d.cts

@@ -0,0 +1,19 @@
+export { ArraySchemaInterface, BooleanSchemaInterface, DateSchemaInterface, EnumSchemaInterface, ErrorStructure, ExtenderType, Infer, Invalid, NumberSchemaInterface, ObjectSchemaInterface, SchemaInterface, SchemaInterfaceOptions, SchemaType, StringSchemaInterface, UnionSchemaInterface, Valid, extend, hookOriginal, s } from './index.cjs';
+
+declare module './index.ts' {
+    interface StringSchemaInterface {
+        min(length: number, options?: SchemaInterfaceOptions): StringSchemaInterface;
+        max(length: number, options?: SchemaInterfaceOptions): StringSchemaInterface;
+        length(length: number, options?: SchemaInterfaceOptions): StringSchemaInterface;
+        nonEmpty(options?: SchemaInterfaceOptions): StringSchemaInterface;
+        startsWith(prefix: string, options?: SchemaInterfaceOptions): StringSchemaInterface;
+        endsWith(suffix: string, options?: SchemaInterfaceOptions): StringSchemaInterface;
+        includes(substring: string, options?: SchemaInterfaceOptions): StringSchemaInterface;
+        trim(): StringSchemaInterface;
+        toLowerCase(): StringSchemaInterface;
+        toUpperCase(): StringSchemaInterface;
+        padStart(length: number, fillChar?: string): StringSchemaInterface;
+        padEnd(length: number, fillChar?: string): StringSchemaInterface;
+        replace(search: string | RegExp, replace: string): StringSchemaInterface;
+    }
+}

package/dist/string.d.ts

@@ -0,0 +1,19 @@
+export { ArraySchemaInterface, BooleanSchemaInterface, DateSchemaInterface, EnumSchemaInterface, ErrorStructure, ExtenderType, Infer, Invalid, NumberSchemaInterface, ObjectSchemaInterface, SchemaInterface, SchemaInterfaceOptions, SchemaType, StringSchemaInterface, UnionSchemaInterface, Valid, extend, hookOriginal, s } from './index.js';
+
+declare module './index.ts' {
+    interface StringSchemaInterface {
+        min(length: number, options?: SchemaInterfaceOptions): StringSchemaInterface;
+        max(length: number, options?: SchemaInterfaceOptions): StringSchemaInterface;
+        length(length: number, options?: SchemaInterfaceOptions): StringSchemaInterface;
+        nonEmpty(options?: SchemaInterfaceOptions): StringSchemaInterface;
+        startsWith(prefix: string, options?: SchemaInterfaceOptions): StringSchemaInterface;
+        endsWith(suffix: string, options?: SchemaInterfaceOptions): StringSchemaInterface;
+        includes(substring: string, options?: SchemaInterfaceOptions): StringSchemaInterface;
+        trim(): StringSchemaInterface;
+        toLowerCase(): StringSchemaInterface;
+        toUpperCase(): StringSchemaInterface;
+        padStart(length: number, fillChar?: string): StringSchemaInterface;
+        padEnd(length: number, fillChar?: string): StringSchemaInterface;
+        replace(search: string | RegExp, replace: string): StringSchemaInterface;
+    }
+}

package/dist/string.js

@@ -0,0 +1 @@
+import'./chunk-6ABUMTDR.js';export{c as extend,b as hookOriginal,a as s}from'./chunk-5ARMWSHU.js';

package/examples/advanced-forms.ts

@@ -0,0 +1,138 @@
+import { s } from '../src/full.ts';
+
+// Advanced form validation example
+const addressSchema = s.object({
+  street: s.string().min(3).max(100),
+  city: s.string().min(2).max(50),
+  zipCode: s.string().length(5).refine((val) => /^\d{5}$/.test(val), {
+    message: 'ZIP code must be 5 digits',
+  }),
+  country: s.enum(['US', 'CA', 'MX', 'UK']),
+});
+
+const userProfileSchema = s.object({
+  // Personal info
+  firstName: s.string().trim().min(2).max(50),
+  lastName: s.string().trim().min(2).max(50),
+  email: s
+    .string()
+    .trim()
+    .toLowerCase()
+    .refine((value) => /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value), {
+      message: 'Invalid email address',
+    }),
+
+  // Contact
+  phone: s
+    .string()
+    .optional()
+    .transform((val) => val?.replace(/\D/g, ''))
+    .refine((val) => !val || val.length === 10, {
+      message: 'Phone number must be 10 digits',
+    }),
+
+  // Address
+  address: addressSchema.optional(),
+
+  // Preferences
+  role: s.enum(['admin', 'editor', 'viewer']).default('viewer'),
+  tags: s.array(s.string()).min(1).max(5).unique(),
+  isActive: s.boolean().default(true),
+
+  // Metadata
+  createdAt: s.date(),
+  updatedAt: s.date().optional(),
+});
+
+console.log('=== Valid User Profile ===');
+const validProfile = {
+  firstName: '  John  ',
+  lastName: 'Doe',
+  email: ' JOHN.DOE@EXAMPLE.COM ',
+  phone: '(555) 123-4567',
+  address: {
+    street: '123 Main St',
+    city: 'New York',
+    zipCode: '10001',
+    country: 'US' as const,
+  },
+  role: 'admin' as const,
+  tags: ['developer', 'typescript', 'node'],
+  isActive: true,
+  createdAt: new Date(),
+};
+
+console.log('Input:', validProfile);
+console.log('Parsed:', userProfileSchema.parse(validProfile));
+
+console.log('\n=== Invalid User Profile (missing required fields) ===');
+const invalidProfile = {
+  firstName: 'John',
+  // lastName missing
+  email: 'invalid-email',
+  tags: [],
+  createdAt: new Date(),
+};
+
+console.log('Result:', userProfileSchema.safeParse(invalidProfile));
+
+console.log('\n=== Invalid ZIP Code ===');
+const invalidZipProfile = {
+  ...validProfile,
+  address: {
+    street: '123 Main St',
+    city: 'New York',
+    zipCode: 'ABC12', // Invalid: not digits
+    country: 'US' as const,
+  },
+};
+
+console.log('Result:', userProfileSchema.safeParse(invalidZipProfile));
+
+// API response validation
+const apiResponseSchema = s.object({
+  status: s.enum(['success', 'error']),
+  data: s
+    .object({
+      users: s.array(
+        s.object({
+          id: s.number().positive().int(),
+          name: s.string(),
+          email: s.string(),
+        }),
+      ),
+      total: s.number().positive().int(),
+    })
+    .optional(),
+  error: s
+    .object({
+      code: s.string(),
+      message: s.string(),
+    })
+    .optional(),
+});
+
+console.log('\n=== API Response Validation (Success) ===');
+const successResponse = {
+  status: 'success' as const,
+  data: {
+    users: [
+      { id: 1, name: 'John', email: 'john@example.com' },
+      { id: 2, name: 'Jane', email: 'jane@example.com' },
+    ],
+    total: 2,
+  },
+};
+
+console.log('Result:', apiResponseSchema.parse(successResponse));
+
+console.log('\n=== API Response Validation (Error) ===');
+const errorResponse = {
+  status: 'error' as const,
+  error: {
+    code: 'NOT_FOUND',
+    message: 'User not found',
+  },
+};
+
+console.log('Result:', apiResponseSchema.parse(errorResponse));

package/examples/basic-usage.ts

@@ -0,0 +1,41 @@
+import { s } from '../src/full.ts';
+
+// String validations with transformations
+console.log('=== String Validations ===');
+console.log(
+  'trim + startsWith + endsWith:',
+  s
+    .string()
+    .trim()
+    .startsWith('Hello')
+    .endsWith('World')
+    .safeParse(' Hello, World '),
+);
+console.log(
+  'startsWith + endsWith (without trim):',
+  s.string().startsWith('Hello').endsWith('World').safeParse(' Hello, World '),
+);
+
+// Array validations
+console.log('\n=== Array Validations ===');
+console.log(
+  'Array with min/max:',
+  s.array(s.string()).min(2).max(5).safeParse(['Hello', 'World']),
+);
+
+// Number validations
+console.log('\n=== Number Validations ===');
+console.log('Integer + positive:', s.number().int().positive().safeParse(42));
+console.log('Float validation:', s.number().float().safeParse(3.14));
+
+// Union with extended methods
+console.log('\n=== Union Validations ===');
+console.log(
+  'Union with string validation:',
+  s
+    .union([
+      s.string({ message: 'stringSchema' }).startsWith('Hello'),
+      s.number(),
+    ])
+    .safeParse('World'),
+);

package/examples/custom-extensions.ts

@@ -0,0 +1,120 @@
+import { s, extend, type StringSchemaInterface } from '../src/index.ts';
+
+// Extend StringSchemaInterface to add custom methods
+declare module '../src/index.ts' {
+  interface StringSchemaInterface {
+    email(options?: { message?: string }): StringSchemaInterface;
+    url(options?: { message?: string }): StringSchemaInterface;
+    uuid(options?: { message?: string }): StringSchemaInterface;
+  }
+}
+
+// Implement the extensions
+extend((schema, _, options) => {
+  if (options?.type === 'string') {
+    const stringSchema = schema as StringSchemaInterface;
+
+    // Email validation
+    stringSchema.email = function ({ message } = {}) {
+      return this.refine(
+        (value) => /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value),
+        {
+          message: message || ((value: string) => `"${value}" is not a valid email address`),
+        },
+      );
+    };
+
+    // URL validation
+    stringSchema.url = function ({ message } = {}) {
+      return this.refine(
+        (value) => {
+          try {
+            new URL(value);
+            return true;
+          } catch {
+            return false;
+          }
+        },
+        {
+          message: message || ((value: string) => `"${value}" is not a valid URL`),
+        },
+      );
+    };
+
+    // UUID validation
+    stringSchema.uuid = function ({ message } = {}) {
+      return this.refine(
+        (value) =>
+          /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(
+            value,
+          ),
+        {
+          message: message || ((value: string) => `"${value}" is not a valid UUID`),
+        },
+      );
+    };
+  }
+
+  return schema;
+});
+
+// Now use the extended schema
+console.log('=== Email Validation ===');
+const emailSchema = s.string().email();
+console.log('Valid email:', emailSchema.safeParse('user@example.com'));
+console.log('Invalid email:', emailSchema.safeParse('not-an-email'));
+console.log('Empty string:', emailSchema.safeParse(''));
+
+console.log('\n=== URL Validation ===');
+const urlSchema = s.string().url();
+console.log('Valid URL:', urlSchema.safeParse('https://example.com'));
+console.log('Valid URL with path:', urlSchema.safeParse('https://example.com/path'));
+console.log('Invalid URL:', urlSchema.safeParse('not a url'));
+
+console.log('\n=== UUID Validation ===');
+const uuidSchema = s.string().uuid();
+console.log(
+  'Valid UUID:',
+  uuidSchema.safeParse('550e8400-e29b-41d4-a716-446655440000'),
+);
+console.log('Invalid UUID:', uuidSchema.safeParse('not-a-uuid'));
+console.log(
+  'Invalid UUID format:',
+  uuidSchema.safeParse('550e8400-e29b-41d4-a716'),
+);
+
+// Combine extensions in a schema
+console.log('\n=== Combined Schema ===');
+const userSchema = s.object({
+  id: s.string().uuid(),
+  email: s.string().trim().toLowerCase().email(),
+  website: s.string().url().optional(),
+});
+
+console.log(
+  'Valid user:',
+  userSchema.parse({
+    id: '550e8400-e29b-41d4-a716-446655440000',
+    email: '  USER@EXAMPLE.COM  ',
+    website: 'https://example.com',
+  }),
+);
+
+console.log(
+  '\nInvalid user (bad email):',
+  userSchema.safeParse({
+    id: '550e8400-e29b-41d4-a716-446655440000',
+    email: 'not-an-email',
+  }),
+);
+
+// Custom error messages
+console.log('\n=== Custom Error Messages ===');
+const customEmailSchema = s
+  .string()
+  .email({ message: 'Please enter a valid email address' });
+
+console.log(
+  'Custom error:',
+  customEmailSchema.safeParse('invalid'),
+);

package/examples/custom-validation.ts

@@ -0,0 +1,110 @@
+import { s } from '../src/full.ts';
+
+// Custom email validation using refine
+const emailSchema = s
+  .string()
+  .trim()
+  .toLowerCase()
+  .refine((value) => /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value), {
+    message: 'Invalid email address format',
+  });
+
+console.log('=== Custom Email Validation ===');
+console.log('Valid email:', emailSchema.safeParse('user@example.com'));
+console.log('Invalid email:', emailSchema.safeParse('not-an-email'));
+console.log(
+  'Email with whitespace:',
+  emailSchema.safeParse('  User@Example.COM  '),
+);
+
+// Custom URL validation
+const urlSchema = s.string().refine(
+  (value) => {
+    try {
+      new URL(value);
+      return true;
+    } catch {
+      return false;
+    }
+  },
+  {
+    message: (value) => `"${value}" is not a valid URL`,
+  },
+);
+
+console.log('\n=== Custom URL Validation ===');
+console.log('Valid URL:', urlSchema.safeParse('https://example.com'));
+console.log('Invalid URL:', urlSchema.safeParse('not a url'));
+
+// Custom age validation
+const ageSchema = s
+  .number()
+  .int()
+  .positive()
+  .refine((value) => value >= 18, {
+    message: (value) =>
+      `Age must be at least 18 (received ${value} years old)`,
+  })
+  .refine((value) => value <= 120, {
+    message: (value) => `Age seems unrealistic (received ${value} years old)`,
+  });
+
+console.log('\n=== Custom Age Validation ===');
+console.log('Valid age:', ageSchema.safeParse(25));
+console.log('Too young:', ageSchema.safeParse(15));
+console.log('Too old:', ageSchema.safeParse(150));
+
+// Custom password validation
+const passwordSchema = s
+  .string()
+  .min(8, { message: 'Password must be at least 8 characters' })
+  .refine((value) => /[A-Z]/.test(value), {
+    message: 'Password must contain at least one uppercase letter',
+  })
+  .refine((value) => /[a-z]/.test(value), {
+    message: 'Password must contain at least one lowercase letter',
+  })
+  .refine((value) => /[0-9]/.test(value), {
+    message: 'Password must contain at least one number',
+  })
+  .refine((value) => /[^A-Za-z0-9]/.test(value), {
+    message: 'Password must contain at least one special character',
+  });
+
+console.log('\n=== Custom Password Validation ===');
+console.log('Valid password:', passwordSchema.safeParse('MyP@ssw0rd'));
+console.log('Too short:', passwordSchema.safeParse('Pass1!'));
+console.log('No uppercase:', passwordSchema.safeParse('myp@ssw0rd'));
+console.log('No special char:', passwordSchema.safeParse('MyPassw0rd'));
+
+// Custom object validation with cross-field checks
+const registrationSchema = s
+  .object({
+    password: s.string().min(8),
+    confirmPassword: s.string(),
+    email: emailSchema,
+    age: ageSchema,
+  })
+  .refine((data) => data.password === data.confirmPassword, {
+    message: 'Passwords do not match',
+  });
+
+console.log('\n=== Cross-Field Validation ===');
+console.log(
+  'Valid registration:',
+  registrationSchema.safeParse({
+    password: 'MyP@ssw0rd',
+    confirmPassword: 'MyP@ssw0rd',
+    email: 'user@example.com',
+    age: 25,
+  }),
+);
+console.log(
+  'Password mismatch:',
+  registrationSchema.safeParse({
+    password: 'MyP@ssw0rd',
+    confirmPassword: 'Different123!',
+    email: 'user@example.com',
+    age: 25,
+  }),
+);

package/package.json

@@ -1,15 +1,21 @@
 {
   "name": "@esmj/schema",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Tiny extendable package for schema validation.",
+  "type": "module",
   "keywords": [
     "schema",
     "validation",
     "type",
+    "typescript",
+    "type-safe",
+    "validator",
+    "parse",
+    "transform",
     "inference",
     "zod",
-    "@sinclair/typebox",
     "yup",
+    "@sinclair/typebox",
     "superstruct",
     "joi",
     "arktype"
@@ -18,11 +24,37 @@
   "module": "dist/index",
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.mjs",
       "require": "./dist/index.js"
+    },
+    "./full": {
+      "types": "./dist/full.d.ts",
+      "import": "./dist/full.mjs",
+      "require": "./dist/full.js"
+    },
+    "./string": {
+      "types": "./dist/string.d.ts",
+      "import": "./dist/string.mjs",
+      "require": "./dist/string.js"
+    },
+    "./number": {
+      "types": "./dist/number.d.ts",
+      "import": "./dist/number.mjs",
+      "require": "./dist/number.js"
+    },
+    "./array": {
+      "types": "./dist/array.d.ts",
+      "import": "./dist/array.mjs",
+      "require": "./dist/array.js"
     }
   },
-  "sideEffects": false,
+  "sideEffects": [
+    "src/string.ts",
+    "src/number.ts",
+    "src/array.ts",
+    "src/full.ts"
+  ],
   "typings": "dist/index.d.ts",
   "scripts": {
     "lint": "biome check --no-errors-on-unmatched",
@@ -70,22 +102,20 @@
     "@biomejs/biome": "1.9.4",
     "@commitlint/cli": "^19.8.1",
     "@commitlint/config-conventional": "^19.8.1",
-    "@sinclair/typebox": "^0.34.38",
-    "@typescript-eslint/eslint-plugin": "^8.33.0",
-    "@typescript-eslint/parser": "^8.33.0",
+    "@sinclair/typebox": "^0.34.41",
     "@zod/mini": "^4.0.0-beta.0",
-    "arktype": "^2.1.20",
+    "arktype": "^2.1.22",
     "commitizen": "^4.3.1",
     "conventional-changelog-cli": "^5.0.0",
     "cz-conventional-changelog": "^3.3.0",
-    "effect": "^3.17.6",
+    "effect": "^3.17.13",
     "git-cz": "^4.9.0",
     "husky": "^9.1.7",
     "joi": "^17.13.3",
-    "lint-staged": "^16.1.0",
+    "lint-staged": "^16.1.6",
     "superstruct": "^2.0.2",
     "tsup": "^8.5.0",
-    "yup": "^1.6.1",
+    "yup": "^1.7.0",
     "zod": "^3.25.42"
   }
 }

package/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "compilerOptions": {
+    "target": "es2022",
+    "module": "es2022",
+    "moduleResolution": "node",
+    "esModuleInterop": true,
+    "allowImportingTsExtensions": true,
+    "resolveJsonModule": true,
+    "noEmit": true
+  },
+  "include": ["src/**/*"]
+}