@local901/validator 0.0.3

package/Validator.d.ts

@@ -0,0 +1,35 @@
+import type { ErrorValue } from "./errors/ErrorType";
+import { ErrorFields, ValidationError } from "./errors/ValidationError";
+export declare abstract class Validator<T = unknown> {
+    abstract type: string;
+    protected createError(error: ErrorValue, message: string, fields?: ErrorFields<T>): ValidationError<T>;
+    /**
+     * Validate input.
+     *
+     * @param input Input value to validate.
+     * @returns An error if validation failed. Null when type is correct.
+     */
+    abstract validateReturn(input: unknown): ValidationError<T> | null;
+    /**
+     * Validate input.
+     *
+     * @param input Input value to validate.
+     * @returns True when input is valid, else False.
+     */
+    validate(input: unknown): input is T;
+    /**
+     * Validate input.
+     *
+     * @param input Input value to validate.
+     * @throws ValidationError When input is invalid.
+     */
+    validateOrThrow(input: unknown): asserts input is T;
+    /**
+     * Type narrow input using the validation result.
+     *
+     * @param _input Input that was validated.
+     * @param result Result from the validation.
+     * @returns True if the result says the input was valid.
+     */
+    validateResult(_input: unknown, result: ValidationError<T> | null): _input is T;
+}

package/Validator.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Validator = void 0;
+const ValidationError_1 = require("./errors/ValidationError");
+class Validator {
+    createError(error, message, fields) {
+        return new ValidationError_1.ValidationError(this.type, error, message, fields);
+    }
+    /**
+     * Validate input.
+     *
+     * @param input Input value to validate.
+     * @returns True when input is valid, else False.
+     */
+    validate(input) {
+        return !this.validateReturn(input);
+    }
+    /**
+     * Validate input.
+     *
+     * @param input Input value to validate.
+     * @throws ValidationError When input is invalid.
+     */
+    validateOrThrow(input) {
+        const response = this.validateReturn(input);
+        if (response) {
+            throw response;
+        }
+        return;
+    }
+    /**
+     * Type narrow input using the validation result.
+     *
+     * @param _input Input that was validated.
+     * @param result Result from the validation.
+     * @returns True if the result says the input was valid.
+     */
+    validateResult(_input, result) {
+        return !result;
+    }
+}
+exports.Validator = Validator;
+//# sourceMappingURL=Validator.js.map

package/Validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Validator.js","sourceRoot":"","sources":["../src/Validator.ts"],"names":[],"mappings":";;;AACA,8DAAwE;AAExE,MAAsB,SAAS;IAGjB,WAAW,CAAC,KAAiB,EAAE,OAAe,EAAE,MAAuB;QAC7E,OAAO,IAAI,iCAAe,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAClE,CAAC;IAUD;;;;;OAKG;IACI,QAAQ,CAAC,KAAc;QAC1B,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IACD;;;;;OAKG;IACI,eAAe,CAAC,KAAc;QACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAC5C,IAAI,QAAQ,EAAE,CAAC;YACX,MAAM,QAAQ,CAAC;QACnB,CAAC;QACD,OAAO;IACX,CAAC;IAED;;;;;;OAMG;IACI,cAAc,CAAC,MAAe,EAAE,MAAiC;QACpE,OAAO,CAAC,MAAM,CAAC;IACnB,CAAC;CACJ;AAhDD,8BAgDC"}

package/errors/ErrorType.d.ts

@@ -0,0 +1,14 @@
+export declare const ErrorType: {
+    readonly INCORRECT_TYPE: "INCORRECT_TYPE";
+    readonly INCORRECT_FORMAT: "INCORRECT_FORMAT";
+    readonly UNKNOWN_FIELD: "UNKNOWN_FIELD";
+    readonly NO_MATCH: "NO_MATCH";
+    readonly VALUE_BELOW: "VALUE_BELOW";
+    readonly VALUE_ABOVE: "VALUE_ABOVE";
+    readonly VALUE_BELOW_EXCLUSIVE: "VALUE_BELOW_EXCLUSIVE";
+    readonly VALUE_ABOVE_EXCLUSIVE: "VALUE_ABOVE_EXCLUSIVE";
+    readonly VALUE_SHORT: "VALUE_SHORT";
+    readonly VALUE_LONG: "VALUE_LONG";
+};
+export type ErrorType = typeof ErrorType;
+export type ErrorValue = ErrorType[keyof ErrorType];

package/errors/ErrorType.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorType = void 0;
+exports.ErrorType = {
+    INCORRECT_TYPE: "INCORRECT_TYPE",
+    INCORRECT_FORMAT: "INCORRECT_FORMAT",
+    UNKNOWN_FIELD: "UNKNOWN_FIELD",
+    NO_MATCH: "NO_MATCH",
+    VALUE_BELOW: "VALUE_BELOW",
+    VALUE_ABOVE: "VALUE_ABOVE",
+    VALUE_BELOW_EXCLUSIVE: "VALUE_BELOW_EXCLUSIVE",
+    VALUE_ABOVE_EXCLUSIVE: "VALUE_ABOVE_EXCLUSIVE",
+    VALUE_SHORT: "VALUE_SHORT",
+    VALUE_LONG: "VALUE_LONG",
+};
+//# sourceMappingURL=ErrorType.js.map

package/errors/ErrorType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorType.js","sourceRoot":"","sources":["../../src/errors/ErrorType.ts"],"names":[],"mappings":";;;AACa,QAAA,SAAS,GAAG;IACrB,cAAc,EAAE,gBAAgB;IAChC,gBAAgB,EAAE,kBAAkB;IAEpC,aAAa,EAAE,eAAe;IAE9B,QAAQ,EAAE,UAAU;IAEpB,WAAW,EAAE,aAAa;IAC1B,WAAW,EAAE,aAAa;IAC1B,qBAAqB,EAAE,uBAAuB;IAC9C,qBAAqB,EAAE,uBAAuB;IAC9C,WAAW,EAAE,aAAa;IAC1B,UAAU,EAAE,YAAY;CAClB,CAAC"}

package/errors/ValidationError.d.ts

@@ -0,0 +1,10 @@
+import type { ErrorValue } from "./ErrorType";
+export type ErrorFields<T> = (T extends object ? {
+    [K in keyof T]: ValidationError<T[K]> | undefined;
+} : never) | Record<number, ValidationError<T>>;
+export declare class ValidationError<T extends unknown = unknown> extends Error {
+    readonly type: string;
+    readonly error: ErrorValue;
+    readonly fields?: ErrorFields<T>;
+    constructor(type: string, error: ErrorValue, message: string, fields?: ErrorFields<T>);
+}

package/errors/ValidationError.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidationError = void 0;
+class ValidationError extends Error {
+    type;
+    error;
+    fields;
+    constructor(type, error, message, fields) {
+        super(message);
+        this.type = type;
+        this.error = error;
+        this.fields = fields;
+    }
+}
+exports.ValidationError = ValidationError;
+//# sourceMappingURL=ValidationError.js.map

package/errors/ValidationError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationError.js","sourceRoot":"","sources":["../../src/errors/ValidationError.ts"],"names":[],"mappings":";;;AAMA,MAAa,eAEX,SAAQ,KAAK;IACK,IAAI,CAAS;IACb,KAAK,CAAa;IAClB,MAAM,CAAiB;IAEvC,YAAmB,IAAY,EAAE,KAAiB,EAAE,OAAe,EAAE,MAAuB;QACxF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;CACJ;AAbD,0CAaC"}

package/index.d.ts

@@ -0,0 +1,19 @@
+import { BooleanValidator } from "./types/bool/BooleanValidator";
+import { IntValidator, type IntValidationOptions } from "./types/number/IntValidator";
+import { NumberValidator, type NumberValidationOptions } from "./types/number/NumberValidator";
+import { ObjectValidator, type FieldValidators } from "./types/object/ObjectValidator";
+import { OptionalValidator } from "./types/util/OptionalValidator";
+import { stringValidator, type StringValidationOptions } from "./types/string/StringValidator";
+import { Validator } from "./Validator";
+import { AnyValidator } from "./types/util/AnyValidator";
+import { AnyOfValidator, type AnyOfValidators } from "./types/util/AnyOfValidator";
+export declare namespace v {
+    const boolean: () => BooleanValidator;
+    const int: (options?: IntValidationOptions) => IntValidator;
+    const number: (options?: NumberValidationOptions) => NumberValidator;
+    const object: <T extends object>(fields: FieldValidators<T>) => ObjectValidator<T>;
+    const string: (options?: StringValidationOptions) => stringValidator;
+    const anyOf: <T>(validators: AnyOfValidators<T>) => AnyOfValidator<T>;
+    const any: <T>() => AnyValidator<T>;
+    const optional: <T>(val: Validator<Exclude<T, undefined | null>>) => OptionalValidator<T>;
+}

package/index.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.v = void 0;
+const BooleanValidator_1 = require("./types/bool/BooleanValidator");
+const IntValidator_1 = require("./types/number/IntValidator");
+const NumberValidator_1 = require("./types/number/NumberValidator");
+const ObjectValidator_1 = require("./types/object/ObjectValidator");
+const OptionalValidator_1 = require("./types/util/OptionalValidator");
+const StringValidator_1 = require("./types/string/StringValidator");
+const AnyValidator_1 = require("./types/util/AnyValidator");
+const AnyOfValidator_1 = require("./types/util/AnyOfValidator");
+var v;
+(function (v) {
+    v.boolean = () => new BooleanValidator_1.BooleanValidator();
+    v.int = (options) => new IntValidator_1.IntValidator(options);
+    v.number = (options) => new NumberValidator_1.NumberValidator(options);
+    v.object = (fields) => new ObjectValidator_1.ObjectValidator(fields);
+    v.string = (options) => new StringValidator_1.stringValidator(options);
+    v.anyOf = (validators) => new AnyOfValidator_1.AnyOfValidator(validators);
+    v.any = () => new AnyValidator_1.AnyValidator();
+    v.optional = (val) => new OptionalValidator_1.OptionalValidator(val);
+})(v || (exports.v = v = {}));
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,oEAAiE;AACjE,8DAAsF;AACtF,oEAA+F;AAC/F,oEAAuF;AACvF,sEAAmE;AACnE,oEAA+F;AAE/F,4DAAyD;AACzD,gEAAmF;AAEnF,IAAiB,CAAC,CAajB;AAbD,WAAiB,CAAC;IACD,SAAO,GAAG,GAAG,EAAE,CAAC,IAAI,mCAAgB,EAAE,CAAC;IAEvC,KAAG,GAAG,CAAC,OAA8B,EAAE,EAAE,CAAC,IAAI,2BAAY,CAAC,OAAO,CAAC,CAAC;IACpE,QAAM,GAAG,CAAC,OAAiC,EAAE,EAAE,CAAC,IAAI,iCAAe,CAAC,OAAO,CAAC,CAAC;IAE7E,QAAM,GAAG,CAAmB,MAA0B,EAAE,EAAE,CAAC,IAAI,iCAAe,CAAC,MAAM,CAAC,CAAC;IAEvF,QAAM,GAAG,CAAC,OAAiC,EAAE,EAAE,CAAC,IAAI,iCAAe,CAAC,OAAO,CAAC,CAAC;IAE7E,OAAK,GAAG,CAAI,UAA8B,EAAE,EAAE,CAAC,IAAI,+BAAc,CAAC,UAAU,CAAC,CAAC;IAC9E,KAAG,GAAG,GAAM,EAAE,CAAC,IAAI,2BAAY,EAAK,CAAC;IACrC,UAAQ,GAAG,CAAI,GAA4C,EAAE,EAAE,CAAC,IAAI,qCAAiB,CAAC,GAAG,CAAC,CAAC;AAC5G,CAAC,EAbgB,CAAC,iBAAD,CAAC,QAajB"}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@local901/validator",
+  "version": "0.0.3",
+  "description": "Type validator for javascript and typescript",
+  "main": "index.js",
+  "scripts": {
+    "build": "tsc",
+    "test": "test"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/Local901/js-validator.git"
+  },
+  "keywords": [
+    "validate",
+    "validator"
+  ],
+  "author": "Local901",
+  "license": "ISC",
+  "bugs": {
+    "url": "https://github.com/Local901/js-validator/issues"
+  },
+  "homepage": "https://github.com/Local901/js-validator#readme",
+  "devDependencies": {
+    "@types/node": "^24.0.12",
+    "typescript": "^5.8.3"
+  }
+}

package/types/bool/BooleanValidator.d.ts

@@ -0,0 +1,9 @@
+import { ErrorType } from "../../errors/ErrorType";
+import { ValidationError } from "../../errors/ValidationError";
+import { Validator } from "../../Validator";
+export type BooleanValidationError = ErrorType;
+export declare class BooleanValidator extends Validator<boolean> {
+    type: string;
+    /** @inheritdoc */
+    validateReturn(input: unknown): ValidationError<boolean> | null;
+}

package/types/bool/BooleanValidator.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BooleanValidator = void 0;
+const ErrorType_1 = require("../../errors/ErrorType");
+const Validator_1 = require("../../Validator");
+class BooleanValidator extends Validator_1.Validator {
+    type = "boolean";
+    /** @inheritdoc */
+    validateReturn(input) {
+        if (typeof input !== "boolean") {
+            return this.createError(ErrorType_1.ErrorType.INCORRECT_TYPE, "Has to be a boolean.");
+        }
+        return null;
+    }
+}
+exports.BooleanValidator = BooleanValidator;
+//# sourceMappingURL=BooleanValidator.js.map

package/types/bool/BooleanValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BooleanValidator.js","sourceRoot":"","sources":["../../../src/types/bool/BooleanValidator.ts"],"names":[],"mappings":";;;AAAA,sDAAmD;AAEnD,+CAA4C;AAI5C,MAAa,gBAAiB,SAAQ,qBAAkB;IACpC,IAAI,GAAG,SAAS,CAAC;IAEjC,kBAAkB;IACF,cAAc,CAAC,KAAc;QACzC,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC,WAAW,CAAC,qBAAS,CAAC,cAAc,EAAE,sBAAsB,CAAC,CAAC;QAC9E,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ;AAVD,4CAUC"}

package/types/number/IntValidator.d.ts

@@ -0,0 +1,15 @@
+import { ValidationError } from "../../errors/ValidationError";
+import { Validator } from "../../Validator";
+export interface IntValidationOptions {
+    /** Minimum value of the int. */
+    min?: number;
+    /** Maximum value of the int. */
+    max?: number;
+}
+export declare class IntValidator extends Validator<number> {
+    private readonly options;
+    type: string;
+    constructor(options?: IntValidationOptions);
+    /** @inheritdoc */
+    validateReturn(input: unknown): ValidationError<number> | null;
+}

package/types/number/IntValidator.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IntValidator = void 0;
+const ErrorType_1 = require("../../errors/ErrorType");
+const Validator_1 = require("../../Validator");
+class IntValidator extends Validator_1.Validator {
+    options;
+    type = "ïnt";
+    constructor(options = {}) {
+        super();
+        this.options = options;
+    }
+    /** @inheritdoc */
+    validateReturn(input) {
+        // Type check.
+        if (typeof input !== "number" || Math.floor(input) !== input) {
+            return this.createError(ErrorType_1.ErrorType.INCORRECT_TYPE, "Has to be a int.");
+        }
+        // Minimum value check
+        if (this.options.min !== undefined && input < this.options.min) {
+            return this.createError(ErrorType_1.ErrorType.VALUE_BELOW, `Has to be a minimum value of ${this.options.min}`);
+        }
+        // Maximum value check
+        if (this.options.max !== undefined && this.options.max < input) {
+            return this.createError(ErrorType_1.ErrorType.VALUE_ABOVE, `Has to be a maximum value of ${this.options.max}`);
+        }
+        return null;
+    }
+}
+exports.IntValidator = IntValidator;
+//# sourceMappingURL=IntValidator.js.map

package/types/number/IntValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntValidator.js","sourceRoot":"","sources":["../../../src/types/number/IntValidator.ts"],"names":[],"mappings":";;;AAAA,sDAAmD;AAEnD,+CAA4C;AAS5C,MAAa,YAAa,SAAQ,qBAAiB;IAGX;IAFpB,IAAI,GAAG,KAAK,CAAC;IAE7B,YAAoC,UAAgC,EAAE;QAClE,KAAK,EAAE,CAAC;QADwB,YAAO,GAAP,OAAO,CAA2B;IAEtE,CAAC;IAED,kBAAkB;IACF,cAAc,CAAC,KAAc;QACzC,cAAc;QACd,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,KAAK,EAAE,CAAC;YAC3D,OAAO,IAAI,CAAC,WAAW,CAAC,qBAAS,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;QAC1E,CAAC;QAED,sBAAsB;QACtB,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;YAC7D,OAAO,IAAI,CAAC,WAAW,CAAC,qBAAS,CAAC,WAAW,EAAE,gCAAgC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;QACtG,CAAC;QAED,sBAAsB;QACtB,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,GAAG,KAAK,EAAE,CAAC;YAC7D,OAAO,IAAI,CAAC,WAAW,CAAC,qBAAS,CAAC,WAAW,EAAE,gCAAgC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;QACtG,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ;AAzBD,oCAyBC"}

package/types/number/NumberValidator.d.ts

@@ -0,0 +1,19 @@
+import { ValidationError } from "../../errors/ValidationError";
+import { Validator } from "../../Validator";
+export interface NumberValidationOptions {
+    /** Minimum value of the number. */
+    min?: number;
+    /** Is the minimum value exclusive. */
+    minExclusive?: boolean;
+    /** Maximum value of the number. */
+    max?: number;
+    /** Is the maximin value exclusive. */
+    maxExclusive?: boolean;
+}
+export declare class NumberValidator extends Validator<number> {
+    private readonly options;
+    type: string;
+    constructor(options?: NumberValidationOptions);
+    /** @inheritdoc */
+    validateReturn(input: unknown): ValidationError<number> | null;
+}

package/types/number/NumberValidator.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NumberValidator = void 0;
+const ErrorType_1 = require("../../errors/ErrorType");
+const Validator_1 = require("../../Validator");
+class NumberValidator extends Validator_1.Validator {
+    options;
+    type = "number";
+    constructor(options = {}) {
+        super();
+        this.options = options;
+    }
+    /** @inheritdoc */
+    validateReturn(input) {
+        // Type check.
+        if (typeof input !== "number") {
+            return this.createError(ErrorType_1.ErrorType.INCORRECT_TYPE, "Has to be a number.");
+        }
+        // Minimum value check.
+        if (this.options.min !== undefined && (this.options.minExclusive ? input <= this.options.min : input < this.options.min)) {
+            return this.createError(this.options.minExclusive ? ErrorType_1.ErrorType.VALUE_BELOW_EXCLUSIVE : ErrorType_1.ErrorType.VALUE_BELOW, `Has to be a minimum value of ${this.options.min}${this.options.minExclusive ? " (exclusive)" : ""}`);
+        }
+        // Maximum value check.
+        if (this.options.max !== undefined && (this.options.maxExclusive ? this.options.max <= input : this.options.max < input)) {
+            return this.createError(this.options.maxExclusive ? ErrorType_1.ErrorType.VALUE_ABOVE_EXCLUSIVE : ErrorType_1.ErrorType.VALUE_ABOVE, `Has to be a maximum value of ${this.options.max}${this.options.minExclusive ? " (exclusive)" : ""}`);
+        }
+        return null;
+    }
+}
+exports.NumberValidator = NumberValidator;
+//# sourceMappingURL=NumberValidator.js.map

package/types/number/NumberValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NumberValidator.js","sourceRoot":"","sources":["../../../src/types/number/NumberValidator.ts"],"names":[],"mappings":";;;AAAA,sDAAmD;AAEnD,+CAA4C;AAa5C,MAAa,eAAgB,SAAQ,qBAAiB;IAGd;IAFpB,IAAI,GAAG,QAAQ,CAAC;IAEhC,YAAoC,UAAmC,EAAE;QACrE,KAAK,EAAE,CAAC;QADwB,YAAO,GAAP,OAAO,CAA8B;IAEzE,CAAC;IAED,kBAAkB;IACF,cAAc,CAAC,KAAc;QACzC,cAAc;QACd,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,OAAO,IAAI,CAAC,WAAW,CAAC,qBAAS,CAAC,cAAc,EAAE,qBAAqB,CAAC,CAAC;QAC7E,CAAC;QAED,uBAAuB;QACvB,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACvH,OAAO,IAAI,CAAC,WAAW,CACnB,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,qBAAS,CAAC,qBAAqB,CAAC,CAAC,CAAC,qBAAS,CAAC,WAAW,EACnF,gCAAgC,IAAI,CAAC,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE,CACvG,CAAC;QACN,CAAC;QAED,uBAAuB;QACvB,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,GAAG,KAAK,CAAC,EAAE,CAAC;YACvH,OAAO,IAAI,CAAC,WAAW,CACnB,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,qBAAS,CAAC,qBAAqB,CAAC,CAAC,CAAC,qBAAS,CAAC,WAAW,EACnF,gCAAgC,IAAI,CAAC,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE,CACvG,CAAC;QACN,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ;AA/BD,0CA+BC"}

package/types/object/ObjectValidator.d.ts

@@ -0,0 +1,12 @@
+import type { ValidationError } from "../../errors/ValidationError";
+import { Validator } from "../../Validator";
+export type FieldValidators<T extends object> = {
+    [K in keyof T]: Validator<T[K]>;
+};
+export declare class ObjectValidator<T extends object> extends Validator<T> {
+    readonly fields: FieldValidators<T>;
+    type: string;
+    constructor(fields: FieldValidators<T>);
+    /** @inheritdoc */
+    validateReturn(input: unknown): ValidationError<T> | null;
+}

package/types/object/ObjectValidator.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObjectValidator = void 0;
+const ErrorType_1 = require("../../errors/ErrorType");
+const Validator_1 = require("../../Validator");
+class ObjectValidator extends Validator_1.Validator {
+    fields;
+    type = "object";
+    constructor(fields) {
+        super();
+        this.fields = fields;
+    }
+    /** @inheritdoc */
+    validateReturn(input) {
+        // Check type
+        if (typeof input !== "object" || input === null) {
+            return this.createError(ErrorType_1.ErrorType.INCORRECT_TYPE, "Has to be an object.");
+        }
+        // Check for excess keys.
+        const fieldKeys = Object.keys(this.fields);
+        const inputKeys = Object.keys(input);
+        const extraKeys = inputKeys.filter((k) => !fieldKeys.includes(k));
+        // Check field types
+        let hasError = false;
+        const fields = Object.fromEntries(Object.entries(this.fields).map(([key, validator]) => {
+            const result = validator.validateReturn(input[key]);
+            if (result !== null) {
+                hasError = true;
+            }
+            return [key, result ?? undefined];
+        }));
+        if (hasError || extraKeys.length) {
+            if (extraKeys.length) {
+                return this.createError(ErrorType_1.ErrorType.UNKNOWN_FIELD, `No extra keys allowed. Found [${extraKeys.join(", ")}]`, hasError ? fields : undefined);
+            }
+            return this.createError(ErrorType_1.ErrorType.INCORRECT_TYPE, "One or more fields are incorrect.", fields);
+        }
+        return null;
+    }
+}
+exports.ObjectValidator = ObjectValidator;
+//# sourceMappingURL=ObjectValidator.js.map

package/types/object/ObjectValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectValidator.js","sourceRoot":"","sources":["../../../src/types/object/ObjectValidator.ts"],"names":[],"mappings":";;;AAAA,sDAAmD;AAEnD,+CAA4C;AAM5C,MAAa,eAAkC,SAAQ,qBAAY;IAG5B;IAFnB,IAAI,GAAG,QAAQ,CAAC;IAEhC,YAAmC,MAA0B;QACzD,KAAK,EAAE,CAAC;QADuB,WAAM,GAAN,MAAM,CAAoB;IAE7D,CAAC;IAED,kBAAkB;IACF,cAAc,CAAC,KAAc;QACzC,aAAa;QACb,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC9C,OAAO,IAAI,CAAC,WAAW,CAAC,qBAAS,CAAC,cAAc,EAAE,sBAAsB,CAAC,CAAC;QAC9E,CAAC;QAED,yBAAyB;QACzB,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrC,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAElE,oBAAoB;QACpB,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,EAAE;YACnF,MAAM,MAAM,GAAI,SAAuB,CAAC,cAAc,CAAE,KAAmD,CAAC,GAAG,CAAC,CAAC,CAAC;YAClH,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBAClB,QAAQ,GAAG,IAAI,CAAC;YACpB,CAAC;YACD,OAAO,CAAC,GAAG,EAAE,MAAM,IAAI,SAAS,CAAC,CAAC;QACtC,CAAC,CAAC,CAAmB,CAAC;QAEtB,IAAI,QAAQ,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;YAC/B,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;gBACnB,OAAO,IAAI,CAAC,WAAW,CACnB,qBAAS,CAAC,aAAa,EACvB,iCAAiC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EACxD,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAChC,CAAC;YACN,CAAC;YACD,OAAO,IAAI,CAAC,WAAW,CAAC,qBAAS,CAAC,cAAc,EAAE,mCAAmC,EAAE,MAAM,CAAC,CAAC;QACnG,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;CAEJ;AA1CD,0CA0CC"}

package/types/string/StringValidator.d.ts

@@ -0,0 +1,19 @@
+import { ValidationError } from "../../errors/ValidationError";
+import { Validator } from "../../Validator";
+export interface StringValidationOptions {
+    /** Minimum length of the string. */
+    min?: number;
+    /** Maximum length of the string. */
+    max?: number;
+    /** The regex the value has to match. */
+    regex?: RegExp;
+    /** Allowed values. (Will ignore all other options.) */
+    enum?: string[];
+}
+export declare class stringValidator extends Validator<string> {
+    private readonly options;
+    type: string;
+    constructor(options?: StringValidationOptions);
+    /** @inheritdoc */
+    validateReturn(input: unknown): ValidationError<string> | null;
+}

package/types/string/StringValidator.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stringValidator = void 0;
+const ErrorType_1 = require("../../errors/ErrorType");
+const Validator_1 = require("../../Validator");
+class stringValidator extends Validator_1.Validator {
+    options;
+    type = "string";
+    constructor(options = {}) {
+        super();
+        this.options = options;
+    }
+    /** @inheritdoc */
+    validateReturn(input) {
+        // Type check.
+        if (typeof input !== "string") {
+            return this.createError(ErrorType_1.ErrorType.INCORRECT_TYPE, "Has to be a string.");
+        }
+        // Enum Check.
+        if (this.options.enum) {
+            if (!this.options.enum.includes(input)) {
+                return null;
+            }
+            return this.createError(ErrorType_1.ErrorType.NO_MATCH, `Has to match one of the known values [${this.options.enum.join(", ")}]`);
+        }
+        // Minimum length check.
+        if (this.options.min !== undefined && input.length < this.options.min) {
+            return this.createError(ErrorType_1.ErrorType.VALUE_SHORT, `Has to have a minimum length of ${this.options.min}`);
+        }
+        // Maximum length check.
+        if (this.options.max !== undefined && this.options.max < input.length) {
+            return this.createError(ErrorType_1.ErrorType.VALUE_LONG, `Has to have a maximum length of ${this.options.max}`);
+        }
+        // Regex format check.
+        if (this.options.regex && !this.options.regex.test(input)) {
+            return this.createError(ErrorType_1.ErrorType.INCORRECT_FORMAT, `Has to match format '${this.options.regex.source}'`);
+        }
+        return null;
+    }
+}
+exports.stringValidator = stringValidator;
+//# sourceMappingURL=StringValidator.js.map

package/types/string/StringValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StringValidator.js","sourceRoot":"","sources":["../../../src/types/string/StringValidator.ts"],"names":[],"mappings":";;;AAAA,sDAAmD;AAEnD,+CAA4C;AAa5C,MAAa,eAAgB,SAAQ,qBAAiB;IAGd;IAFpB,IAAI,GAAG,QAAQ,CAAC;IAEhC,YAAoC,UAAmC,EAAE;QACrE,KAAK,EAAE,CAAC;QADwB,YAAO,GAAP,OAAO,CAA8B;IAEzE,CAAC;IAED,kBAAkB;IACF,cAAc,CAAC,KAAc;QACzC,cAAc;QACd,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,OAAO,IAAI,CAAC,WAAW,CAAC,qBAAS,CAAC,cAAc,EAAE,qBAAqB,CAAC,CAAC;QAC7E,CAAC;QAED,cAAc;QACd,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACpB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACrC,OAAO,IAAI,CAAC;YAChB,CAAC;YACD,OAAO,IAAI,CAAC,WAAW,CACnB,qBAAS,CAAC,QAAQ,EAClB,yCAAyC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC3E,CAAC;QACN,CAAC;QAED,wBAAwB;QACxB,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;YACpE,OAAO,IAAI,CAAC,WAAW,CAAC,qBAAS,CAAC,WAAW,EAAE,mCAAmC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC1G,CAAC;QAED,wBAAwB;QACxB,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YACpE,OAAO,IAAI,CAAC,WAAW,CAAC,qBAAS,CAAC,UAAU,EAAE,mCAAmC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACzG,CAAC;QAED,sBAAsB;QACtB,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACxD,OAAO,IAAI,CAAC,WAAW,CAAC,qBAAS,CAAC,gBAAgB,EAAE,wBAAwB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QAC9G,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ;AAzCD,0CAyCC"}

package/types/util/AnyOfValidator.d.ts

@@ -0,0 +1,9 @@
+import type { ValidationError } from "../../errors/ValidationError";
+import { Validator } from "../../Validator";
+export type AnyOfValidators<T> = ReadonlyArray<T extends unknown ? Validator<T> : never>;
+export declare class AnyOfValidator<T> extends Validator<T> {
+    readonly validators: AnyOfValidators<T>;
+    type: string;
+    constructor(validators: AnyOfValidators<T>);
+    validateReturn(input: unknown): ValidationError<T> | null;
+}

package/types/util/AnyOfValidator.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnyOfValidator = void 0;
+const ErrorType_1 = require("../../errors/ErrorType");
+const Validator_1 = require("../../Validator");
+class AnyOfValidator extends Validator_1.Validator {
+    validators;
+    type = "anyof";
+    constructor(validators) {
+        super();
+        this.validators = validators;
+    }
+    validateReturn(input) {
+        const errors = {};
+        let i = 0;
+        for (const validator of this.validators) {
+            const result = validator.validateReturn(input);
+            if (result === null) {
+                return null;
+            }
+            errors[i++] = result;
+        }
+        return this.createError(ErrorType_1.ErrorType.INCORRECT_TYPE, "Has to match at least one of the types.", errors);
+    }
+}
+exports.AnyOfValidator = AnyOfValidator;
+//# sourceMappingURL=AnyOfValidator.js.map

package/types/util/AnyOfValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnyOfValidator.js","sourceRoot":"","sources":["../../../src/types/util/AnyOfValidator.ts"],"names":[],"mappings":";;;AAAA,sDAAmD;AAEnD,+CAA4C;AAI5C,MAAa,cAAkB,SAAQ,qBAAY;IAGZ;IAFnB,IAAI,GAAG,OAAO,CAAC;IAE/B,YAAmC,UAA8B;QAC7D,KAAK,EAAE,CAAC;QADuB,eAAU,GAAV,UAAU,CAAoB;IAEjE,CAAC;IAEe,cAAc,CAAC,KAAc;QACzC,MAAM,MAAM,GAAuC,EAAE,CAAC;QACtD,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACtC,MAAM,MAAM,GAAG,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;YAC/C,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBAClB,OAAO,IAAI,CAAC;YAChB,CAAC;YACD,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC;QACzB,CAAC;QACD,OAAO,IAAI,CAAC,WAAW,CAAC,qBAAS,CAAC,cAAc,EAAE,yCAAyC,EAAE,MAAM,CAAC,CAAC;IACzG,CAAC;CAEJ;AApBD,wCAoBC"}

package/types/util/AnyValidator.d.ts

@@ -0,0 +1,7 @@
+import type { ValidationError } from "../../errors/ValidationError";
+import { Validator } from "../../Validator";
+export declare class AnyValidator<T> extends Validator<T> {
+    type: string;
+    /** @inheritdoc */
+    validateReturn(_input: unknown): ValidationError<T> | null;
+}

package/types/util/AnyValidator.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnyValidator = void 0;
+const Validator_1 = require("../../Validator");
+class AnyValidator extends Validator_1.Validator {
+    type = "any";
+    /** @inheritdoc */
+    validateReturn(_input) {
+        return null;
+    }
+}
+exports.AnyValidator = AnyValidator;
+//# sourceMappingURL=AnyValidator.js.map

package/types/util/AnyValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnyValidator.js","sourceRoot":"","sources":["../../../src/types/util/AnyValidator.ts"],"names":[],"mappings":";;;AACA,+CAA4C;AAE5C,MAAa,YAAgB,SAAQ,qBAAY;IAC7B,IAAI,GAAG,KAAK,CAAC;IAE7B,kBAAkB;IACF,cAAc,CAAC,MAAe;QAC1C,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ;AAPD,oCAOC"}

package/types/util/OptionalValidator.d.ts

@@ -0,0 +1,9 @@
+import type { ValidationError } from "../../errors/ValidationError";
+import { Validator } from "../../Validator";
+export declare class OptionalValidator<T> extends Validator<T> {
+    readonly child: Validator<Exclude<T, undefined | null>>;
+    type: string;
+    constructor(child: Validator<Exclude<T, undefined | null>>);
+    /** @inheritdoc */
+    validateReturn(input: unknown): ValidationError<T> | null;
+}

package/types/util/OptionalValidator.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OptionalValidator = void 0;
+const Validator_1 = require("../../Validator");
+class OptionalValidator extends Validator_1.Validator {
+    child;
+    type = "optional";
+    constructor(child) {
+        super();
+        this.child = child;
+    }
+    /** @inheritdoc */
+    validateReturn(input) {
+        if (input === undefined || input === null) {
+            return null;
+        }
+        return this.child.validateReturn(input);
+    }
+}
+exports.OptionalValidator = OptionalValidator;
+//# sourceMappingURL=OptionalValidator.js.map

package/types/util/OptionalValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OptionalValidator.js","sourceRoot":"","sources":["../../../src/types/util/OptionalValidator.ts"],"names":[],"mappings":";;;AACA,+CAA4C;AAE5C,MAAa,iBAAqB,SAAQ,qBAAY;IAGf;IAFnB,IAAI,GAAG,UAAU,CAAC;IAElC,YAAmC,KAA8C;QAC7E,KAAK,EAAE,CAAA;QADwB,UAAK,GAAL,KAAK,CAAyC;IAEjF,CAAC;IAED,kBAAkB;IACF,cAAc,CAAC,KAAc;QACzC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACxC,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC;CAEJ;AAfD,8CAeC"}