@lowerdeck/validation 1.0.0

package/dist/validators/null.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"null.d.ts","sourceRoot":"","sources":["../../src/validators/null.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGhD,eAAO,IAAI,SAAS,4FAalB,CAAC"}

package/dist/validators/null.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=null.test.d.ts.map

package/dist/validators/null.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"null.test.d.ts","sourceRoot":"","sources":["../../src/validators/null.test.ts"],"names":[],"mappings":""}

package/dist/validators/nullable.d.ts

@@ -0,0 +1,3 @@
+import { ValidationType, ValidationTypeValue } from '../lib/types';
+export declare let nullable: <A extends ValidationType<any>>(validator: A) => ValidationType<ValidationTypeValue<A> | null>;
+//# sourceMappingURL=nullable.d.ts.map

package/dist/validators/nullable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nullable.d.ts","sourceRoot":"","sources":["../../src/validators/nullable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnE,eAAO,IAAI,QAAQ,GAAI,CAAC,SAAS,cAAc,CAAC,GAAG,CAAC,EAClD,WAAW,CAAC,KACX,cAAc,CAAC,mBAAmB,CAAC,CAAC,CAAC,GAAG,IAAI,CAW7C,CAAC"}

package/dist/validators/nullable.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=nullable.test.d.ts.map

package/dist/validators/nullable.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nullable.test.d.ts","sourceRoot":"","sources":["../../src/validators/nullable.test.ts"],"names":[],"mappings":""}

package/dist/validators/number.d.ts

@@ -0,0 +1,3 @@
+import { ValidatorOptions } from '../lib/types';
+export declare let number: (opts?: ValidatorOptions<number> | undefined) => import("../lib/types").ValidationType<number>;
+//# sourceMappingURL=number.d.ts.map

package/dist/validators/number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.d.ts","sourceRoot":"","sources":["../../src/validators/number.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGhD,eAAO,IAAI,MAAM,gGAkBhB,CAAC"}

package/dist/validators/number.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=number.test.d.ts.map

package/dist/validators/number.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.test.d.ts","sourceRoot":"","sources":["../../src/validators/number.test.ts"],"names":[],"mappings":""}

package/dist/validators/object.d.ts

@@ -0,0 +1,12 @@
+import { ValidationType, ValidationTypeValue, ValidatorOptions } from '../lib/types';
+type KeysWhichExtend<T, SelectedType> = {
+    [key in keyof T]: SelectedType extends T[key] ? key : never;
+}[keyof T];
+type Optional<T> = Partial<Pick<T, KeysWhichExtend<T, undefined>>>;
+type Required<T> = Omit<T, KeysWhichExtend<T, undefined>>;
+export type UndefinedIsOptional<T> = Optional<T> & Required<T>;
+export declare let object: <Validator extends {
+    [key: string]: ValidationType<any>;
+}>(shape: Validator, opts?: ValidatorOptions<Record<string, ValidationTypeValue<Validator>>>) => ValidationType<UndefinedIsOptional<{ [key in keyof Validator]: ValidationTypeValue<Validator[key]>; }>>;
+export {};
+//# sourceMappingURL=object.d.ts.map

package/dist/validators/object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../../src/validators/object.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErF,KAAK,eAAe,CAAC,CAAC,EAAE,YAAY,IAAI;KACrC,GAAG,IAAI,MAAM,CAAC,GAAG,YAAY,SAAS,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,KAAK;CAC5D,CAAC,MAAM,CAAC,CAAC,CAAC;AACX,KAAK,QAAQ,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;AACnE,KAAK,QAAQ,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;AAC1D,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;AAE/D,eAAO,IAAI,MAAM,GAAI,SAAS,SAAS;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,CAAA;CAAE,EAC3E,OAAO,SAAS,EAChB,OAAO,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC,KACtE,cAAc,CACf,mBAAmB,CAAC,GACjB,GAAG,IAAI,MAAM,SAAS,GAAG,mBAAmB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAC9D,CAAC,CAiDF,CAAC"}

package/dist/validators/object.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=object.test.d.ts.map

package/dist/validators/object.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.test.d.ts","sourceRoot":"","sources":["../../src/validators/object.test.ts"],"names":[],"mappings":""}

package/dist/validators/optional.d.ts

@@ -0,0 +1,3 @@
+import { ValidationType, ValidationTypeValue } from '../lib/types';
+export declare let optional: <A extends ValidationType<any>>(validator: A) => ValidationType<ValidationTypeValue<A> | undefined>;
+//# sourceMappingURL=optional.d.ts.map

package/dist/validators/optional.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optional.d.ts","sourceRoot":"","sources":["../../src/validators/optional.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnE,eAAO,IAAI,QAAQ,GAAI,CAAC,SAAS,cAAc,CAAC,GAAG,CAAC,EAClD,WAAW,CAAC,KACX,cAAc,CAAC,mBAAmB,CAAC,CAAC,CAAC,GAAG,SAAS,CAWlD,CAAC"}

package/dist/validators/optional.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=optional.test.d.ts.map

package/dist/validators/optional.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optional.test.d.ts","sourceRoot":"","sources":["../../src/validators/optional.test.ts"],"names":[],"mappings":""}

package/dist/validators/record.d.ts

@@ -0,0 +1,3 @@
+import { ValidationType, ValidationTypeValue, ValidatorOptions } from '../lib/types';
+export declare let record: <Validator extends ValidationType<any>>(validator: Validator, opts?: ValidatorOptions<Record<string, ValidationTypeValue<Validator>>>) => ValidationType<Record<string, ValidationTypeValue<Validator>>>;
+//# sourceMappingURL=record.d.ts.map

package/dist/validators/record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../src/validators/record.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErF,eAAO,IAAI,MAAM,GAAI,SAAS,SAAS,cAAc,CAAC,GAAG,CAAC,EACxD,WAAW,SAAS,EACpB,OAAO,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC,KACtE,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAiD9D,CAAC"}

package/dist/validators/record.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=record.test.d.ts.map

package/dist/validators/record.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.test.d.ts","sourceRoot":"","sources":["../../src/validators/record.test.ts"],"names":[],"mappings":""}

package/dist/validators/string.d.ts

@@ -0,0 +1,3 @@
+import { ValidatorOptions } from '../lib/types';
+export declare let string: (opts?: ValidatorOptions<string> | undefined) => import("../lib/types").ValidationType<string>;
+//# sourceMappingURL=string.d.ts.map

package/dist/validators/string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../src/validators/string.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGhD,eAAO,IAAI,MAAM,gGAyBhB,CAAC"}

package/dist/validators/string.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=string.test.d.ts.map

package/dist/validators/string.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.test.d.ts","sourceRoot":"","sources":["../../src/validators/string.test.ts"],"names":[],"mappings":""}

package/dist/validators/union.d.ts

@@ -0,0 +1,3 @@
+import { ValidationType, ValidationTypeValue, ValidatorOptions } from '../lib/types';
+export declare let union: <A extends ValidationType<any>, B extends ValidationType<any>, Rest extends ValidationType<any>[]>(validators: [A, B, ...Rest], opts?: ValidatorOptions<ValidationTypeValue<A> | ValidationTypeValue<B> | ValidationTypeValue<Rest[number]>>) => ValidationType<ValidationTypeValue<A> | ValidationTypeValue<B> | ValidationTypeValue<Rest[number]>>;
+//# sourceMappingURL=union.d.ts.map

package/dist/validators/union.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"union.d.ts","sourceRoot":"","sources":["../../src/validators/union.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,cAAc,CAAC;AAEtB,eAAO,IAAI,KAAK,GACd,CAAC,SAAS,cAAc,CAAC,GAAG,CAAC,EAC7B,CAAC,SAAS,cAAc,CAAC,GAAG,CAAC,EAC7B,IAAI,SAAS,cAAc,CAAC,GAAG,CAAC,EAAE,EAElC,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,EAC3B,OAAO,gBAAgB,CACrB,mBAAmB,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CACpF,KACA,cAAc,CACf,mBAAmB,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAmBnF,CAAC"}

package/dist/validators/union.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=union.test.d.ts.map

package/dist/validators/union.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"union.test.d.ts","sourceRoot":"","sources":["../../src/validators/union.test.ts"],"names":[],"mappings":""}

package/dist/validators/void.d.ts

@@ -0,0 +1,3 @@
+import { ValidatorOptions } from '../lib/types';
+export declare let voidType: (opts?: ValidatorOptions<void> | undefined) => import("../lib/types").ValidationType<void>;
+//# sourceMappingURL=void.d.ts.map

package/dist/validators/void.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"void.d.ts","sourceRoot":"","sources":["../../src/validators/void.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGhD,eAAO,IAAI,QAAQ,4FAEjB,CAAC"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@lowerdeck/validation",
+  "version": "1.0.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "Tobias Herber",
+  "license": "Apache 2",
+  "type": "module",
+  "source": "src/index.ts",
+  "exports": {
+    "require": "./dist/index.cjs",
+    "default": "./dist/index.modern.js"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.module.js",
+  "types": "dist/index.d.ts",
+  "unpkg": "./dist/index.umd.js",
+  "scripts": {
+    "test": "vitest run --passWithNoTests",
+    "lint": "prettier src/**/*.ts --check",
+    "build": "microbundle"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "microbundle": "^0.15.1",
+    "@lowerdeck/tsconfig": "^1.0.0",
+    "typescript": "^5.8.3",
+    "vitest": "^3.1.2"
+  }
+}

package/src/index.ts

@@ -0,0 +1,33 @@
+// export * from './lib/result';
+// export * from './lib/validator';
+// export * from './modifiers';
+// export * from './transformers';
+// export * from './validators';
+
+export * from './lib/introspect';
+export * from './lib/types';
+
+import * as introspect from './lib/introspect';
+import * as result from './lib/result';
+import * as validator from './lib/validator';
+import * as modifiers from './modifiers';
+import * as transformers from './transformers';
+import * as validators from './validators';
+
+// export default {
+//   ...modifiers,
+//   ...introspect,
+//   ...transformers,
+//   ...validators,
+//   ...result,
+//   ...validator
+// };
+
+export let v = {
+  ...modifiers,
+  ...introspect,
+  ...transformers,
+  ...validators,
+  ...result,
+  ...validator
+};

package/src/lib/introspect.ts

@@ -0,0 +1,33 @@
+import { ValidationType } from './types';
+
+export interface IntrospectedType {
+  examples: any[];
+  items?: IntrospectedType[];
+  properties?: Record<string, IntrospectedType>;
+  type: string;
+  name?: string;
+  description?: string;
+  optional: boolean;
+  nullable: boolean;
+}
+
+export let introspectType = (type: ValidationType<any>): IntrospectedType => ({
+  examples: type.examples ?? [],
+  items: type.items
+    ? Array.isArray(type.items)
+      ? type.items.map(introspectType)
+      : [introspectType(type.items)]
+    : undefined,
+  properties: type.properties
+    ? Object.fromEntries(
+        Object.entries(type.properties)
+          .filter(([_, v]) => !v.hidden)
+          .map(([key, value]) => [key, introspectType(value)])
+      )
+    : undefined,
+  type: type.type,
+  name: type.name,
+  description: type.description,
+  optional: !!type.optional,
+  nullable: !!type.nullable
+});

package/src/lib/result.test.ts

@@ -0,0 +1,80 @@
+import { describe, expect, test } from 'vitest';
+import { error, success } from './result';
+
+describe('Result', () => {
+  test('success should return a successful result', () => {
+    let s1 = success({
+      foo: 'bar'
+    });
+
+    expect(s1).toEqual({
+      success: true,
+      value: {
+        foo: 'bar'
+      }
+    });
+
+    let s2 = success(123);
+
+    expect(s2).toEqual({
+      success: true,
+      value: 123
+    });
+  });
+
+  test('error should return an error result', () => {
+    let e1 = error([
+      {
+        code: 'invalid_type',
+        message: 'Invalid type',
+        received: 'string',
+        expected: 'number'
+      }
+    ]);
+
+    expect(e1).toEqual({
+      success: false,
+      errors: [
+        {
+          code: 'invalid_type',
+          message: 'Invalid type',
+          received: 'string',
+          expected: 'number'
+        }
+      ]
+    });
+
+    let e2 = error([
+      {
+        code: 'invalid_type',
+        message: 'Invalid type',
+        received: 'string',
+        expected: 'number'
+      },
+      {
+        code: 'invalid_type',
+        message: 'Invalid type',
+        received: 'string',
+        expected: 'number'
+      }
+    ]);
+
+    expect(e2).toEqual({
+      success: false,
+      errors: [
+        {
+          code: 'invalid_type',
+          message: 'Invalid type',
+          received: 'string',
+          expected: 'number'
+        },
+        {
+          code: 'invalid_type',
+          message: 'Invalid type',
+          received: 'string',
+          expected: 'number'
+        }
+      ]
+    });
+  });
+});

package/src/lib/result.ts

@@ -0,0 +1,11 @@
+import { ValidationError, ValidationResult } from './types';
+
+export let success = <T>(value: T): ValidationResult<T> => ({
+  success: true,
+  value
+});
+
+export let error = (errors: ValidationError[]): ValidationResult<any> => ({
+  success: false,
+  errors
+});

package/src/lib/types.ts

@@ -0,0 +1,57 @@
+export interface ValidationError {
+  code: string;
+  message: string;
+
+  expected?: any;
+  received?: any;
+
+  path?: string[];
+
+  min?: number;
+  max?: number;
+  positive?: boolean;
+  negative?: boolean;
+}
+
+export type ValidationResult<T> =
+  | {
+      success: true;
+      value: T;
+    }
+  | {
+      success: false;
+      errors: ValidationError[];
+    };
+
+export type ValidationType<T> = {
+  validate: (value: any) => ValidationResult<T>;
+  examples?: T[];
+  items?: ValidationType<any> | ValidationType<any>[];
+  properties?: { [key: string]: ValidationType<any> };
+  type: string;
+  name?: string;
+  description?: string;
+  optional?: boolean;
+  nullable?: boolean;
+  hidden?: boolean;
+};
+
+export type ValidationTypeValue<T> = T extends ValidationType<infer U> ? U : never;
+
+export type ValidationModifier<T> = (value: T) => ValidationError[];
+
+export type Preprocessor = (value: any) => any;
+
+export type Transformer<T> = (value: T) => T;
+
+export interface ValidatorOptions<T> {
+  modifiers?: ValidationModifier<T>[];
+  transformers?: Transformer<T>[];
+  message?: string;
+  name?: string;
+  description?: string;
+  examples?: T[];
+  preprocessors?: Preprocessor[];
+  oneOf?: T[];
+  hidden?: boolean;
+}

package/src/lib/validator.test.ts

@@ -0,0 +1,82 @@
+import { describe, expect, test } from 'vitest';
+import { createValidator } from './validator';
+
+describe('createValidator', () => {
+  test('should validate a string', () => {
+    let stringValidator = createValidator<string, any>('string', (opts, value) => {
+      if (typeof value !== 'string') {
+        return {
+          success: false,
+          errors: [{ code: 'invalid_type', message: 'Value must be a string' }]
+        };
+      }
+
+      if (opts.minLength && value.length < opts.minLength) {
+        return {
+          success: false,
+          errors: [
+            {
+              code: 'min_length',
+              message: `Value must be at least ${opts.minLength} characters long`
+            }
+          ]
+        };
+      }
+
+      return { success: true, value };
+    });
+
+    let result: any = stringValidator({ minLength: 5 }).validate('hello');
+    expect(result.success).toBe(true);
+    expect(result.value).toBe('hello');
+
+    let result2: any = stringValidator({ minLength: 5 }).validate('hi');
+    expect(result2.success).toBe(false);
+    expect(result2.errors).toEqual([
+      { code: 'min_length', message: 'Value must be at least 5 characters long' }
+    ]);
+  });
+
+  test('should validate a number', () => {
+    let numberValidator = createValidator<number, any>('number', (opts, value) => {
+      if (typeof value !== 'number') {
+        return {
+          success: false,
+          errors: [{ code: 'invalid_type', message: 'Value must be a number' }]
+        };
+      }
+
+      if (opts.min && value < opts.min) {
+        return {
+          success: false,
+          errors: [{ code: 'min_value', message: `Value must be at least ${opts.min}` }]
+        };
+      }
+
+      return { success: true, value };
+    });
+
+    let result: any = numberValidator({ min: 5 }).validate(10);
+    expect(result.success).toBe(true);
+    expect(result.value).toBe(10);
+
+    let result2: any = numberValidator({ min: 5 }).validate(3);
+    expect(result2.success).toBe(false);
+    expect(result2.errors).toEqual([
+      { code: 'min_value', message: 'Value must be at least 5' }
+    ]);
+  });
+
+  test('should handle throwing errors', () => {
+    let throwingValidator = createValidator<string, any>('throwing', () => {
+      throw new Error('Something went wrong');
+    });
+
+    let result: any = throwingValidator().validate('hello');
+
+    expect(result.success).toBe(false);
+    expect(result.errors).toEqual([
+      { code: 'invalid_type', message: 'Unable to validate value' }
+    ]);
+  });
+});

package/src/lib/validator.ts

@@ -0,0 +1,63 @@
+import { error, success } from './result';
+import {
+  Preprocessor,
+  Transformer,
+  ValidationError,
+  ValidationModifier,
+  ValidationResult,
+  ValidationType,
+  ValidatorOptions
+} from './types';
+
+let preprocess = (preprocessors: Preprocessor[], value: any) => {
+  return preprocessors.reduce((val, fn) => fn(val), value);
+};
+
+let modify = <T>(modifiers: ValidationModifier<T>[], value: T) => {
+  return modifiers.reduce((errors, fn) => errors.concat(fn(value)), [] as ValidationError[]);
+};
+
+let transform = <T>(transformers: Transformer<T>[], value: T) => {
+  return transformers.reduce((val, fn) => fn(val), value);
+};
+
+export let createValidator =
+  <Type, Opts extends ValidatorOptions<Type>>(
+    type: string,
+    handler: (opts: Opts, value: any) => ValidationResult<Type>
+  ) =>
+  (opts?: Opts): ValidationType<Type> => ({
+    validate: rawValue => {
+      try {
+        let value =
+          !opts?.preprocessors || !opts?.preprocessors.length
+            ? rawValue
+            : preprocess(opts?.preprocessors, rawValue);
+
+        let handlerRes = handler(opts ?? ({} as any), value);
+        if (!handlerRes.success) return handlerRes;
+
+        let modifierErrors =
+          !opts?.modifiers || !opts?.modifiers.length ? [] : modify(opts?.modifiers, value);
+        if (modifierErrors.length) return error(modifierErrors);
+
+        return success(
+          !opts?.transformers || !opts?.transformers.length
+            ? handlerRes.value
+            : transform(opts?.transformers, handlerRes.value)
+        );
+      } catch (err) {
+        return error([
+          {
+            code: 'invalid_type',
+            message: opts?.message ?? 'Unable to validate value'
+          }
+        ]);
+      }
+    },
+    examples: opts?.examples ?? [],
+    type,
+    name: opts?.name,
+    description: opts?.description,
+    hidden: !!opts?.hidden
+  });

package/src/modifiers/color.test.ts

@@ -0,0 +1,29 @@
+import { describe, expect, test } from 'vitest';
+import { color } from './color';
+
+describe('color', () => {
+  test('returns an empty array for a valid color', () => {
+    let result = color()('#FF0000');
+    expect(result).toEqual([]);
+  });
+
+  test('returns an error object for an invalid color', () => {
+    let result = color()('not_a_color');
+    expect(result).toEqual([
+      {
+        code: 'invalid_color',
+        message: 'Invalid color'
+      }
+    ]);
+  });
+
+  test('returns a custom error message if provided', () => {
+    let result = color({ message: 'Custom error message' })('not_a_color');
+    expect(result).toEqual([
+      {
+        code: 'invalid_color',
+        message: 'Custom error message'
+      }
+    ]);
+  });
+});

package/src/modifiers/color.ts

@@ -0,0 +1,18 @@
+import { ValidationModifier } from '../lib/types';
+
+let colorRegex = /^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$/;
+
+export let color =
+  (opts?: { message?: string }): ValidationModifier<string> =>
+  value => {
+    if (!colorRegex.test(value)) {
+      return [
+        {
+          code: 'invalid_color',
+          message: opts?.message ?? 'Invalid color'
+        }
+      ];
+    }
+
+    return [];
+  };

package/src/modifiers/email.test.ts

@@ -0,0 +1,29 @@
+import { describe, expect, test } from 'vitest';
+import { email } from './email';
+
+describe('email', () => {
+  test('returns an empty array for a valid email address', () => {
+    let result = email()('test@example.com');
+    expect(result).toEqual([]);
+  });
+
+  test('returns an error object for an invalid email address', () => {
+    let result = email()('not_an_email');
+    expect(result).toEqual([
+      {
+        code: 'invalid_email',
+        message: 'Invalid email address'
+      }
+    ]);
+  });
+
+  test('returns a custom error message if provided', () => {
+    let result = email({ message: 'Custom error message' })('not_an_email');
+    expect(result).toEqual([
+      {
+        code: 'invalid_email',
+        message: 'Custom error message'
+      }
+    ]);
+  });
+});

package/src/modifiers/email.ts

@@ -0,0 +1,18 @@
+import { ValidationModifier } from '../lib/types';
+
+let emailRegex = /^[\w+-]+(?:\.[\w+-]+)*@[A-Z0-9]+(?:(?:\.|-)[A-Z0-9]+)*\.[A-Z]{2,}$/i;
+
+export let email =
+  (opts?: { message?: string }): ValidationModifier<string> =>
+  value => {
+    if (!emailRegex.test(value)) {
+      return [
+        {
+          code: 'invalid_email',
+          message: opts?.message ?? 'Invalid email address'
+        }
+      ];
+    }
+
+    return [];
+  };