@valkyrjaio/valkyrja 26.0.0

package/src/Valkyrja/Http/Server/Middleware/ThrowableCaught/LogThrowableCaughtMiddleware.ts

@@ -0,0 +1,32 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import type { LoggerContract } from '../../../../Log/Logger/Contract/LoggerContract.js';
+import type { ServerRequestContract } from '../../../Message/Request/Contract/ServerRequestContract.js';
+import type { ResponseContract } from '../../../Message/Response/Contract/ResponseContract.js';
+import type { ThrowableCaughtMiddlewareContract } from '../../../Middleware/Contract/ThrowableCaughtMiddlewareContract.js';
+import type { ThrowableCaughtHandlerContract } from '../../../Middleware/Handler/Contract/ThrowableCaughtHandlerContract.js';
+
+export class LogThrowableCaughtMiddleware implements ThrowableCaughtMiddlewareContract {
+    constructor(protected readonly logger: LoggerContract) {}
+
+    throwableCaught(
+        request: ServerRequestContract,
+        response: ResponseContract,
+        throwable: Error,
+        handler: ThrowableCaughtHandlerContract,
+    ): ResponseContract {
+        const url = request.getUri().getPath();
+        const logMessage = `Http Server Error\nUrl: ${url}`;
+
+        this.logger.throwable(throwable, logMessage);
+
+        return handler.throwableCaught(request, response, throwable);
+    }
+}

package/src/Valkyrja/Http/Server/Throwable/Contract/HttpServerThrowable.ts

@@ -0,0 +1,12 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import type { HttpThrowable } from '../../../Throwable/Contract/HttpThrowable.js';
+
+export type HttpServerThrowable = HttpThrowable;

package/src/Valkyrja/Http/Server/Throwable/Exception/Abstract/HttpServerInvalidArgumentException.ts

@@ -0,0 +1,16 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import { HttpInvalidArgumentException } from '../../../../Throwable/Exception/Abstract/HttpInvalidArgumentException.js';
+
+import type { HttpServerThrowable } from '../../Contract/HttpServerThrowable.js';
+
+export abstract class HttpServerInvalidArgumentException
+    extends HttpInvalidArgumentException
+    implements HttpServerThrowable {}

package/src/Valkyrja/Http/Server/Throwable/Exception/Abstract/HttpServerRuntimeException.ts

@@ -0,0 +1,14 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import { HttpRuntimeException } from '../../../../Throwable/Exception/Abstract/HttpRuntimeException.js';
+
+import type { HttpServerThrowable } from '../../Contract/HttpServerThrowable.js';
+
+export abstract class HttpServerRuntimeException extends HttpRuntimeException implements HttpServerThrowable {}

package/src/Valkyrja/Http/Struct/Contract/StructContract.ts

@@ -0,0 +1,13 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+export interface StructContract {
+    readonly name: string;
+    readonly value: unknown;
+}

package/src/Valkyrja/Http/Struct/Request/Abstract/JsonRequestStruct.ts

@@ -0,0 +1,33 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import type { JsonServerRequestContract } from '../../../Message/Request/Contract/JsonServerRequestContract.js';
+import type { ServerRequestContract } from '../../../Message/Request/Contract/ServerRequestContract.js';
+import { HttpStructJsonServerRequestExpectedException } from '../../Throwable/Exception/HttpStructJsonServerRequestExpectedException.js';
+import { RequestStruct } from './RequestStruct.js';
+
+export abstract class JsonRequestStruct extends RequestStruct {
+    protected getOnlyParamsFromRequest(request: ServerRequestContract, ...keys: string[]): Record<string, unknown> {
+        this.ensureJsonRequest(request);
+
+        return request.getParsedJson().getOnly(...keys);
+    }
+
+    protected getExceptParamsFromRequest(request: ServerRequestContract, ...keys: string[]): Record<string, unknown> {
+        this.ensureJsonRequest(request);
+
+        return request.getParsedJson().getAllExcept(...keys);
+    }
+
+    protected ensureJsonRequest(request: ServerRequestContract): asserts request is JsonServerRequestContract {
+        if (!('getParsedJson' in request)) {
+            throw new HttpStructJsonServerRequestExpectedException('JsonServerRequest is required for this to work.');
+        }
+    }
+}

package/src/Valkyrja/Http/Struct/Request/Abstract/ParsedBodyRequestStruct.ts

@@ -0,0 +1,21 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import type { ServerRequestContract } from '../../../Message/Request/Contract/ServerRequestContract.js';
+import { RequestStruct } from './RequestStruct.js';
+
+export abstract class ParsedBodyRequestStruct extends RequestStruct {
+    protected getOnlyParamsFromRequest(request: ServerRequestContract, ...keys: string[]): Record<string, unknown> {
+        return request.getParsedBody().getOnly(...keys);
+    }
+
+    protected getExceptParamsFromRequest(request: ServerRequestContract, ...keys: string[]): Record<string, unknown> {
+        return request.getParsedBody().getAllExcept(...keys);
+    }
+}

package/src/Valkyrja/Http/Struct/Request/Abstract/QueryRequestStruct.ts

@@ -0,0 +1,21 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import type { ServerRequestContract } from '../../../Message/Request/Contract/ServerRequestContract.js';
+import { RequestStruct } from './RequestStruct.js';
+
+export abstract class QueryRequestStruct extends RequestStruct {
+    protected getOnlyParamsFromRequest(request: ServerRequestContract, ...keys: string[]): Record<string, unknown> {
+        return request.getQueryParams().getOnly(...keys);
+    }
+
+    protected getExceptParamsFromRequest(request: ServerRequestContract, ...keys: string[]): Record<string, unknown> {
+        return request.getQueryParams().getAllExcept(...keys);
+    }
+}

package/src/Valkyrja/Http/Struct/Request/Abstract/RequestStruct.ts

@@ -0,0 +1,36 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import type { ServerRequestContract } from '../../../Message/Request/Contract/ServerRequestContract.js';
+import type { RequestStructContract } from '../Contract/RequestStructContract.js';
+
+export abstract class RequestStruct implements RequestStructContract {
+    abstract readonly name: string;
+    abstract readonly value: unknown;
+
+    constructor(protected readonly fields: string[]) {}
+
+    getDataFromRequest(request: ServerRequestContract): Record<string, unknown> {
+        return this.getOnlyParamsFromRequest(request, ...this.fields);
+    }
+
+    determineIfRequestContainsExtraData(request: ServerRequestContract): boolean {
+        return Object.keys(this.getExceptParamsFromRequest(request, ...this.fields)).length > 0;
+    }
+
+    protected abstract getOnlyParamsFromRequest(
+        request: ServerRequestContract,
+        ...keys: string[]
+    ): Record<string, unknown>;
+
+    protected abstract getExceptParamsFromRequest(
+        request: ServerRequestContract,
+        ...keys: string[]
+    ): Record<string, unknown>;
+}

package/src/Valkyrja/Http/Struct/Request/Contract/RequestStructContract.ts

@@ -0,0 +1,16 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import type { ServerRequestContract } from '../../../Message/Request/Contract/ServerRequestContract.js';
+import type { StructContract } from '../../Contract/StructContract.js';
+
+export interface RequestStructContract extends StructContract {
+    getDataFromRequest(request: ServerRequestContract): Record<string, unknown>;
+    determineIfRequestContainsExtraData(request: ServerRequestContract): boolean;
+}

package/src/Valkyrja/Http/Struct/Response/Abstract/ResponseStruct.ts

@@ -0,0 +1,31 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import type { ResponseStructContract } from '../Contract/ResponseStructContract.js';
+
+export abstract class ResponseStruct implements ResponseStructContract {
+    abstract readonly name: string;
+    abstract readonly value: unknown;
+
+    constructor(protected readonly fields: Record<string, string | number>) {}
+
+    getStructuredData(data: Record<string, unknown>, includeAll: boolean = true): Record<string | number, unknown> {
+        const structured: Record<string | number, unknown> = {};
+
+        for (const [key, value] of Object.entries(this.fields)) {
+            if (!includeAll && !(key in data)) {
+                continue;
+            }
+
+            structured[value] = data[key] ?? null;
+        }
+
+        return structured;
+    }
+}

package/src/Valkyrja/Http/Struct/Response/Contract/ResponseStructContract.ts

@@ -0,0 +1,14 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import type { StructContract } from '../../Contract/StructContract.js';
+
+export interface ResponseStructContract extends StructContract {
+    getStructuredData(data: Record<string, unknown>, includeAll?: boolean): Record<string | number, unknown>;
+}

package/src/Valkyrja/Http/Struct/Throwable/Contract/HttpStructThrowable.ts

@@ -0,0 +1,12 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import type { HttpThrowable } from '../../../Throwable/Contract/HttpThrowable.js';
+
+export type HttpStructThrowable = HttpThrowable;

package/src/Valkyrja/Http/Struct/Throwable/Exception/Abstract/HttpStructInvalidArgumentException.ts

@@ -0,0 +1,15 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import type { HttpStructThrowable } from '../../Contract/HttpStructThrowable.js';
+import { HttpInvalidArgumentException } from '../../../../Throwable/Exception/Abstract/HttpInvalidArgumentException.js';
+
+export abstract class HttpStructInvalidArgumentException
+    extends HttpInvalidArgumentException
+    implements HttpStructThrowable {}

package/src/Valkyrja/Http/Struct/Throwable/Exception/Abstract/HttpStructRuntimeException.ts

@@ -0,0 +1,13 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import type { HttpStructThrowable } from '../../Contract/HttpStructThrowable.js';
+import { HttpRuntimeException } from '../../../../Throwable/Exception/Abstract/HttpRuntimeException.js';
+
+export abstract class HttpStructRuntimeException extends HttpRuntimeException implements HttpStructThrowable {}

package/src/Valkyrja/Http/Struct/Throwable/Exception/HttpStructJsonServerRequestExpectedException.ts

@@ -0,0 +1,12 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import { HttpStructInvalidArgumentException } from './Abstract/HttpStructInvalidArgumentException.js';
+
+export class HttpStructJsonServerRequestExpectedException extends HttpStructInvalidArgumentException {}

package/src/Valkyrja/Http/Throwable/Contract/HttpThrowable.ts

@@ -0,0 +1,12 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import type { ValkyrjaThrowable } from '../../../Throwable/Contract/ValkyrjaThrowable.js';
+
+export type HttpThrowable = ValkyrjaThrowable;

package/src/Valkyrja/Http/Throwable/Exception/Abstract/HttpInvalidArgumentException.ts

@@ -0,0 +1,13 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import type { HttpThrowable } from '../../Contract/HttpThrowable.js';
+import { ValkyrjaInvalidArgumentException } from '../../../../Throwable/Exception/Abstract/ValkyrjaInvalidArgumentException.js';
+
+export abstract class HttpInvalidArgumentException extends ValkyrjaInvalidArgumentException implements HttpThrowable {}

package/src/Valkyrja/Http/Throwable/Exception/Abstract/HttpRuntimeException.ts

@@ -0,0 +1,13 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import type { HttpThrowable } from '../../Contract/HttpThrowable.js';
+import { ValkyrjaRuntimeException } from '../../../../Throwable/Exception/Abstract/ValkyrjaRuntimeException.js';
+
+export abstract class HttpRuntimeException extends ValkyrjaRuntimeException implements HttpThrowable {}

package/src/Valkyrja/Log/Logger/Contract/LoggerContract.ts

@@ -0,0 +1,22 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+export const LoggerContractId = 'Valkyrja.Log.Logger.LoggerContract' as const;
+
+export interface LoggerContract {
+    throwable(throwable: Error, message: string): void;
+    debug(message: string, context?: Record<string, unknown>): void;
+    info(message: string, context?: Record<string, unknown>): void;
+    notice(message: string, context?: Record<string, unknown>): void;
+    warning(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+    critical(message: string, context?: Record<string, unknown>): void;
+    alert(message: string, context?: Record<string, unknown>): void;
+    emergency(message: string, context?: Record<string, unknown>): void;
+}

package/src/Valkyrja/Throwable/Constant/ThrowableServiceId.ts

@@ -0,0 +1,12 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+export class ThrowableServiceId {
+    static readonly HandlerContract = 'Valkyrja.Throwable.Handler.ThrowableHandlerContract' as const;
+}

package/src/Valkyrja/Throwable/Contract/ValkyrjaThrowable.ts

@@ -0,0 +1,12 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+export interface ValkyrjaThrowable extends Error {
+    getTraceCode(): string;
+}

package/src/Valkyrja/Throwable/Exception/Abstract/ValkyrjaInvalidArgumentException.ts

@@ -0,0 +1,18 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import { ThrowableHandler } from '../../Handler/Abstract/ThrowableHandler.js';
+
+import { type ValkyrjaThrowable } from '../../Contract/ValkyrjaThrowable.js';
+
+export abstract class ValkyrjaInvalidArgumentException extends Error implements ValkyrjaThrowable {
+    getTraceCode(): string {
+        return ThrowableHandler.getTraceCode(this);
+    }
+}

package/src/Valkyrja/Throwable/Exception/Abstract/ValkyrjaRuntimeException.ts

@@ -0,0 +1,18 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import { ThrowableHandler } from '../../Handler/Abstract/ThrowableHandler.js';
+
+import { type ValkyrjaThrowable } from '../../Contract/ValkyrjaThrowable.js';
+
+export abstract class ValkyrjaRuntimeException extends Error implements ValkyrjaThrowable {
+    getTraceCode(): string {
+        return ThrowableHandler.getTraceCode(this);
+    }
+}

package/src/Valkyrja/Throwable/Handler/Abstract/ThrowableHandler.ts

@@ -0,0 +1,22 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import { createHash } from 'node:crypto';
+
+import { type ThrowableHandlerContract } from '../Contract/ThrowableHandlerContract.js';
+
+export abstract class ThrowableHandler implements ThrowableHandlerContract {
+    static getTraceCode(error: Error): string {
+        return createHash('md5')
+            .update(error.constructor.name + (error.stack ?? ''))
+            .digest('hex');
+    }
+
+    abstract enable(options?: { displayErrors?: boolean }): void;
+}

package/src/Valkyrja/Throwable/Handler/Contract/ThrowableHandlerContract.ts

@@ -0,0 +1,18 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+export interface ThrowableHandlerContract {
+    enable(options?: { displayErrors?: boolean }): void;
+}
+
+export namespace ThrowableHandlerContract {
+    export function instanceOf(value: unknown): value is ThrowableHandlerContract {
+        return typeof value === 'object' && value !== null && 'enable' in value;
+    }
+}

package/src/Valkyrja/Type/Data/Cast.ts

@@ -0,0 +1,16 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+export class Cast {
+    constructor(
+        public readonly type: string,
+        public readonly convert: boolean = true,
+        public readonly isArray: boolean = false,
+    ) {}
+}

package/src/Valkyrja/Type/Object/Factory/ObjectFactory.ts

@@ -0,0 +1,14 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+export class ObjectFactory {
+    static clone<T extends object>(object: T): T {
+        return Object.assign(Object.create(Object.getPrototypeOf(object) as object | null) as T, object);
+    }
+}

package/src/Valkyrja/Validation/Constant/ErrorMessage.ts

@@ -0,0 +1,33 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+export class ErrorMessage {
+    static readonly REQUIRED = 'This field is required.';
+    static readonly INT_GREATER_THAN = 'This field value is too low.';
+    static readonly INT_LESS_THAN = 'This field value is too high.';
+    static readonly IS_EMAIL = 'This field must be a valid email.';
+    static readonly IS_EQUAL = 'This field must be the same.';
+    static readonly IS_BOOL = 'This field must be a boolean.';
+    static readonly IS_EMPTY = 'This field must be empty.';
+    static readonly IS_NUMERIC = 'This field must be numeric.';
+    static readonly IS_STRING = 'This field must be a string.';
+    static readonly IS_NOT_EMPTY = 'This field must not be empty.';
+    static readonly IS_NOT_EQUAL = 'This field must not be the same.';
+    static readonly ENTITY_EXISTS = 'This field must match an existing entity.';
+    static readonly ENTITY_NOT_EXISTS = 'This field must not match an existing entity.';
+    static readonly STRING_ALPHA = 'This field must be alphanumeric.';
+    static readonly STRING_CONTAINS = 'This field must contain another string.';
+    static readonly STRING_ENDS_WITH = 'This field must end with another string.';
+    static readonly STRING_LOWERCASE = 'This field must be lowercase.';
+    static readonly STRING_MAX = 'This field is too long.';
+    static readonly STRING_MIN = 'This field is too short.';
+    static readonly STRING_REGEX = 'This field must match the regex.';
+    static readonly STRING_STARTS_WITH = 'This field must start with another string.';
+    static readonly STRING_UPPERCASE = 'This field must be uppercase.';
+}

package/src/Valkyrja/Validation/Rule/Abstract/Rule.ts

@@ -0,0 +1,30 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import { ValidationRuleFailureException } from '../../Throwable/Exception/ValidationRuleFailureException.js';
+import type { RuleContract } from '../Contract/RuleContract.js';
+
+export abstract class Rule implements RuleContract {
+    constructor(
+        protected subject: unknown,
+        protected errorMessage: string,
+    ) {}
+
+    getSubject(): unknown {
+        return this.subject;
+    }
+
+    abstract isValid(): boolean;
+
+    validate(): void {
+        if (!this.isValid()) {
+            throw new ValidationRuleFailureException(this.errorMessage);
+        }
+    }
+}

package/src/Valkyrja/Validation/Rule/Contract/RuleContract.ts

@@ -0,0 +1,14 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+export interface RuleContract {
+    getSubject(): unknown;
+    isValid(): boolean;
+    validate(): void;
+}

package/src/Valkyrja/Validation/Rule/Int/GreaterThan.ts

@@ -0,0 +1,24 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import { Rule } from '../Abstract/Rule.js';
+
+export class GreaterThan extends Rule {
+    constructor(
+        subject: unknown,
+        protected readonly min: number,
+        errorMessage: string,
+    ) {
+        super(subject, errorMessage);
+    }
+
+    isValid(): boolean {
+        return typeof this.subject === 'number' && this.subject > this.min;
+    }
+}