@valkyrjaio/valkyrja 26.0.0

package/src/Valkyrja/Http/Message/Constant/ContentTypeValue.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 class ContentTypeValue {
+    static readonly APPLICATION_JSON = 'application/json' as const;
+    static readonly APPLICATION_JAVASCRIPT = 'application/javascript' as const;
+    static readonly APPLICATION_XML = 'application/xml' as const;
+    static readonly APPLICATION_XML_UTF8 = `${ContentTypeValue.APPLICATION_XML}; charset=utf-8` as const;
+    static readonly APPLICATION_X_WWW_FORM = 'application/x-www-form-urlencoded' as const;
+    static readonly MULTIPART_FORM_DATA = 'multipart/form-data' as const;
+    static readonly TEXT_HTML = 'text/html' as const;
+    static readonly TEXT_HTML_UTF8 = `${ContentTypeValue.TEXT_HTML}; charset=utf-8` as const;
+    static readonly TEXT_JAVASCRIPT = 'text/javascript' as const;
+    static readonly TEXT_PLAIN = 'text/plain' as const;
+    static readonly TEXT_PLAIN_UTF8 = `${ContentTypeValue.TEXT_PLAIN}; charset=utf-8` as const;
+}

package/src/Valkyrja/Http/Message/Constant/HeaderName.ts

@@ -0,0 +1,60 @@
+/*
+ * 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 HeaderName {
+    static readonly ACCEPT = 'Accept' as const;
+    static readonly ACCEPT_CHARSET = 'Accept-Charset' as const;
+    static readonly ACCEPT_ENCODING = 'Accept-Encoding' as const;
+    static readonly ACCEPT_LANGUAGE = 'Accept-Language' as const;
+    static readonly ACCEPT_RANGES = 'Accept-Ranges' as const;
+    static readonly AGE = 'Age' as const;
+    static readonly ALLOW = 'Allow' as const;
+    static readonly AUTHORIZATION = 'Authorization' as const;
+    static readonly CACHE_CONTROL = 'Cache-Control' as const;
+    static readonly CONNECTION = 'Connection' as const;
+    static readonly CONTENT_ENCODING = 'Content-Encoding' as const;
+    static readonly CONTENT_LANGUAGE = 'Content-Language' as const;
+    static readonly CONTENT_LENGTH = 'Content-Length' as const;
+    static readonly CONTENT_LOCATION = 'Content-Location' as const;
+    static readonly CONTENT_MD5 = 'Content-MD5' as const;
+    static readonly CONTENT_RANGE = 'Content-Range' as const;
+    static readonly CONTENT_TYPE = 'Content-Type' as const;
+    static readonly DATE = 'Date' as const;
+    static readonly E_TAG = 'ETag' as const;
+    static readonly EXPECT = 'Expect' as const;
+    static readonly EXPIRES = 'Expires' as const;
+    static readonly FROM = 'From' as const;
+    static readonly HOST = 'Host' as const;
+    static readonly IF_MATCH = 'If-Match' as const;
+    static readonly IF_MODIFIED_SINCE = 'If-Modified-Since' as const;
+    static readonly IF_NONE_MATCH = 'If-None-Match' as const;
+    static readonly IF_RANGE = 'If-Range' as const;
+    static readonly IF_UNMODIFIED_SINCE = 'If-Unmodified-Since' as const;
+    static readonly LAST_MODIFIED = 'Last-Modified' as const;
+    static readonly LOCATION = 'Location' as const;
+    static readonly MAX_FORWARDS = 'Max-Forwards' as const;
+    static readonly PRAGMA = 'Pragma' as const;
+    static readonly PROXY_AUTHENTICATE = 'Proxy-Authenticate' as const;
+    static readonly PROXY_AUTHORIZATION = 'Proxy-Authorization' as const;
+    static readonly RANGE = 'Range' as const;
+    static readonly REFERER = 'Referer' as const;
+    static readonly RETRY_AFTER = 'Retry-After' as const;
+    static readonly SERVER = 'Server' as const;
+    static readonly SET_COOKIE = 'Set-Cookie' as const;
+    static readonly TE = 'TE' as const;
+    static readonly TRAILER = 'Trailer' as const;
+    static readonly TRANSFER_ENCODING = 'Transfer-Encoding' as const;
+    static readonly UPGRADE = 'Upgrade' as const;
+    static readonly USER_AGENT = 'User-Agent' as const;
+    static readonly VARY = 'Vary' as const;
+    static readonly VIA = 'Via' as const;
+    static readonly WARNING = 'Warning' as const;
+    static readonly WWW_AUTHENTICATE = 'WWW-Authenticate' as const;
+    static readonly X_REQUESTED_WITH = 'X-Requested-With' as const;
+}

package/src/Valkyrja/Http/Message/Constant/HeaderValue.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 HeaderValue {
+    static readonly BEARER = 'Bearer' as const;
+}

package/src/Valkyrja/Http/Message/Constant/HttpMessageServiceId.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 class HttpMessageServiceId {
+    static readonly ServerRequestContract = 'Valkyrja.Http.Message.Request.ServerRequestContract' as const;
+    static readonly ResponseFactoryContract = 'Valkyrja.Http.Message.Response.Factory.ResponseFactoryContract' as const;
+}

package/src/Valkyrja/Http/Message/Constant/Port.ts

@@ -0,0 +1,19 @@
+/*
+ * 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 Port {
+    static readonly MIN = 1 as const;
+    static readonly MAX = 65535 as const;
+    static readonly HTTP = 80 as const;
+    static readonly HTTPS = 443 as const;
+
+    static isValid(port: number): boolean {
+        return port >= Port.MIN && port <= Port.MAX;
+    }
+}

package/src/Valkyrja/Http/Message/Contract/MessageContract.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 { HeaderCollectionContract } from '../Header/Collection/Contract/HeaderCollectionContract.js';
+import type { StreamContract } from '../Stream/Contract/StreamContract.js';
+import type { ProtocolVersion } from '../Enum/ProtocolVersion.js';
+
+export interface MessageContract {
+    getProtocolVersion(): ProtocolVersion;
+    withProtocolVersion(version: ProtocolVersion): this;
+    getHeaders(): HeaderCollectionContract;
+    withHeaders(headers: HeaderCollectionContract): this;
+    getBody(): StreamContract;
+    withBody(body: StreamContract): this;
+}

package/src/Valkyrja/Http/Message/Enum/ProtocolVersion.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.
+ */
+
+export enum ProtocolVersion {
+    V1 = '1.0',
+    V1_1 = '1.1',
+    V2 = '2',
+    V3 = '3',
+}

package/src/Valkyrja/Http/Message/Enum/RequestMethod.ts

@@ -0,0 +1,35 @@
+/*
+ * 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 enum RequestMethod {
+    GET = 'GET',
+    HEAD = 'HEAD',
+    POST = 'POST',
+    PUT = 'PUT',
+    DELETE = 'DELETE',
+    CONNECT = 'CONNECT',
+    OPTIONS = 'OPTIONS',
+    TRACE = 'TRACE',
+    PATCH = 'PATCH',
+    ANY = 'ANY',
+}
+
+export function allRequestMethods(): RequestMethod[] {
+    return [
+        RequestMethod.GET,
+        RequestMethod.HEAD,
+        RequestMethod.POST,
+        RequestMethod.PUT,
+        RequestMethod.DELETE,
+        RequestMethod.CONNECT,
+        RequestMethod.OPTIONS,
+        RequestMethod.TRACE,
+        RequestMethod.PATCH,
+    ];
+}

package/src/Valkyrja/Http/Message/Enum/SameSite.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 enum SameSite {
+    NONE = 'none',
+    LAX = 'lax',
+    STRICT = 'strict',
+}

package/src/Valkyrja/Http/Message/Enum/StatusCode.ts

@@ -0,0 +1,152 @@
+/*
+ * 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 { StatusText } from './StatusText.js';
+
+export enum StatusCode {
+    CONTINUE = 100,
+    SWITCHING_PROTOCOLS = 101,
+    PROCESSING = 102,
+    EARLY_HINTS = 103,
+    OK = 200,
+    CREATED = 201,
+    ACCEPTED = 202,
+    NON_AUTHORITATIVE_INFORMATION = 203,
+    NO_CONTENT = 204,
+    RESET_CONTENT = 205,
+    PARTIAL_CONTENT = 206,
+    MULTI_STATUS = 207,
+    ALREADY_REPORTED = 208,
+    IM_USED = 226,
+    MULTIPLE_CHOICES = 300,
+    MOVED_PERMANENTLY = 301,
+    FOUND = 302,
+    SEE_OTHER = 303,
+    NOT_MODIFIED = 304,
+    USE_PROXY = 305,
+    TEMPORARY_REDIRECT = 307,
+    PERMANENT_REDIRECT = 308,
+    BAD_REQUEST = 400,
+    UNAUTHORIZED = 401,
+    PAYMENT_REQUIRED = 402,
+    FORBIDDEN = 403,
+    NOT_FOUND = 404,
+    METHOD_NOT_ALLOWED = 405,
+    NOT_ACCEPTABLE = 406,
+    PROXY_AUTHENTICATION_REQUIRED = 407,
+    REQUEST_TIMEOUT = 408,
+    CONFLICT = 409,
+    GONE = 410,
+    LENGTH_REQUIRED = 411,
+    PRECONDITION_FAILED = 412,
+    PAYLOAD_TOO_LARGE = 413,
+    URI_TOO_LONG = 414,
+    UNSUPPORTED_MEDIA_TYPE = 415,
+    RANGE_NOT_SATISFIABLE = 416,
+    EXPECTATION_FAILED = 417,
+    I_AM_A_TEAPOT = 418,
+    MISDIRECTED_REQUEST = 421,
+    UNPROCESSABLE_ENTITY = 422,
+    LOCKED = 423,
+    FAILED_DEPENDENCY = 424,
+    TOO_EARLY = 425,
+    UPGRADE_REQUIRED = 426,
+    PRECONDITION_REQUIRED = 428,
+    TOO_MANY_REQUESTS = 429,
+    REQUEST_HEADER_FIELDS_TOO_LARGE = 431,
+    UNAVAILABLE_FOR_LEGAL_REASONS = 451,
+    INTERNAL_SERVER_ERROR = 500,
+    NOT_IMPLEMENTED = 501,
+    BAD_GATEWAY = 502,
+    SERVICE_UNAVAILABLE = 503,
+    GATEWAY_TIMEOUT = 504,
+    HTTP_VERSION_NOT_SUPPORTED = 505,
+    VARIANT_ALSO_NEGOTIATES = 506,
+    INSUFFICIENT_STORAGE = 507,
+    LOOP_DETECTED = 508,
+    NOT_EXTENDED_OBSOLETED = 510,
+    NETWORK_AUTHENTICATION_REQUIRED = 511,
+}
+
+const statusCodeToText: Record<StatusCode, StatusText> = {
+    [StatusCode.CONTINUE]: StatusText.CONTINUE,
+    [StatusCode.SWITCHING_PROTOCOLS]: StatusText.SWITCHING_PROTOCOLS,
+    [StatusCode.PROCESSING]: StatusText.PROCESSING,
+    [StatusCode.EARLY_HINTS]: StatusText.EARLY_HINTS,
+    [StatusCode.OK]: StatusText.OK,
+    [StatusCode.CREATED]: StatusText.CREATED,
+    [StatusCode.ACCEPTED]: StatusText.ACCEPTED,
+    [StatusCode.NON_AUTHORITATIVE_INFORMATION]: StatusText.NON_AUTHORITATIVE_INFORMATION,
+    [StatusCode.NO_CONTENT]: StatusText.NO_CONTENT,
+    [StatusCode.RESET_CONTENT]: StatusText.RESET_CONTENT,
+    [StatusCode.PARTIAL_CONTENT]: StatusText.PARTIAL_CONTENT,
+    [StatusCode.MULTI_STATUS]: StatusText.MULTI_STATUS,
+    [StatusCode.ALREADY_REPORTED]: StatusText.ALREADY_REPORTED,
+    [StatusCode.IM_USED]: StatusText.IM_USED,
+    [StatusCode.MULTIPLE_CHOICES]: StatusText.MULTIPLE_CHOICES,
+    [StatusCode.MOVED_PERMANENTLY]: StatusText.MOVED_PERMANENTLY,
+    [StatusCode.FOUND]: StatusText.FOUND,
+    [StatusCode.SEE_OTHER]: StatusText.SEE_OTHER,
+    [StatusCode.NOT_MODIFIED]: StatusText.NOT_MODIFIED,
+    [StatusCode.USE_PROXY]: StatusText.USE_PROXY,
+    [StatusCode.TEMPORARY_REDIRECT]: StatusText.TEMPORARY_REDIRECT,
+    [StatusCode.PERMANENT_REDIRECT]: StatusText.PERMANENT_REDIRECT,
+    [StatusCode.BAD_REQUEST]: StatusText.BAD_REQUEST,
+    [StatusCode.UNAUTHORIZED]: StatusText.UNAUTHORIZED,
+    [StatusCode.PAYMENT_REQUIRED]: StatusText.PAYMENT_REQUIRED,
+    [StatusCode.FORBIDDEN]: StatusText.FORBIDDEN,
+    [StatusCode.NOT_FOUND]: StatusText.NOT_FOUND,
+    [StatusCode.METHOD_NOT_ALLOWED]: StatusText.METHOD_NOT_ALLOWED,
+    [StatusCode.NOT_ACCEPTABLE]: StatusText.NOT_ACCEPTABLE,
+    [StatusCode.PROXY_AUTHENTICATION_REQUIRED]: StatusText.PROXY_AUTHENTICATION_REQUIRED,
+    [StatusCode.REQUEST_TIMEOUT]: StatusText.REQUEST_TIMEOUT,
+    [StatusCode.CONFLICT]: StatusText.CONFLICT,
+    [StatusCode.GONE]: StatusText.GONE,
+    [StatusCode.LENGTH_REQUIRED]: StatusText.LENGTH_REQUIRED,
+    [StatusCode.PRECONDITION_FAILED]: StatusText.PRECONDITION_FAILED,
+    [StatusCode.PAYLOAD_TOO_LARGE]: StatusText.PAYLOAD_TOO_LARGE,
+    [StatusCode.URI_TOO_LONG]: StatusText.URI_TOO_LONG,
+    [StatusCode.UNSUPPORTED_MEDIA_TYPE]: StatusText.UNSUPPORTED_MEDIA_TYPE,
+    [StatusCode.RANGE_NOT_SATISFIABLE]: StatusText.RANGE_NOT_SATISFIABLE,
+    [StatusCode.EXPECTATION_FAILED]: StatusText.EXPECTATION_FAILED,
+    [StatusCode.I_AM_A_TEAPOT]: StatusText.I_AM_A_TEAPOT,
+    [StatusCode.MISDIRECTED_REQUEST]: StatusText.MISDIRECTED_REQUEST,
+    [StatusCode.UNPROCESSABLE_ENTITY]: StatusText.UNPROCESSABLE_ENTITY,
+    [StatusCode.LOCKED]: StatusText.LOCKED,
+    [StatusCode.FAILED_DEPENDENCY]: StatusText.FAILED_DEPENDENCY,
+    [StatusCode.TOO_EARLY]: StatusText.TOO_EARLY,
+    [StatusCode.UPGRADE_REQUIRED]: StatusText.UPGRADE_REQUIRED,
+    [StatusCode.PRECONDITION_REQUIRED]: StatusText.PRECONDITION_REQUIRED,
+    [StatusCode.TOO_MANY_REQUESTS]: StatusText.TOO_MANY_REQUESTS,
+    [StatusCode.REQUEST_HEADER_FIELDS_TOO_LARGE]: StatusText.REQUEST_HEADER_FIELDS_TOO_LARGE,
+    [StatusCode.UNAVAILABLE_FOR_LEGAL_REASONS]: StatusText.UNAVAILABLE_FOR_LEGAL_REASONS,
+    [StatusCode.INTERNAL_SERVER_ERROR]: StatusText.INTERNAL_SERVER_ERROR,
+    [StatusCode.NOT_IMPLEMENTED]: StatusText.NOT_IMPLEMENTED,
+    [StatusCode.BAD_GATEWAY]: StatusText.BAD_GATEWAY,
+    [StatusCode.SERVICE_UNAVAILABLE]: StatusText.SERVICE_UNAVAILABLE,
+    [StatusCode.GATEWAY_TIMEOUT]: StatusText.GATEWAY_TIMEOUT,
+    [StatusCode.HTTP_VERSION_NOT_SUPPORTED]: StatusText.HTTP_VERSION_NOT_SUPPORTED,
+    [StatusCode.VARIANT_ALSO_NEGOTIATES]: StatusText.VARIANT_ALSO_NEGOTIATES,
+    [StatusCode.INSUFFICIENT_STORAGE]: StatusText.INSUFFICIENT_STORAGE,
+    [StatusCode.LOOP_DETECTED]: StatusText.LOOP_DETECTED,
+    [StatusCode.NOT_EXTENDED_OBSOLETED]: StatusText.NOT_EXTENDED_OBSOLETED,
+    [StatusCode.NETWORK_AUTHENTICATION_REQUIRED]: StatusText.NETWORK_AUTHENTICATION_REQUIRED,
+};
+
+export function statusCodeIsRedirect(code: StatusCode): boolean {
+    return code >= StatusCode.MULTIPLE_CHOICES && code < StatusCode.BAD_REQUEST;
+}
+
+export function statusCodeIsError(code: StatusCode): boolean {
+    return code >= StatusCode.INTERNAL_SERVER_ERROR;
+}
+
+export function statusCodeAsPhrase(code: StatusCode): StatusText {
+    return statusCodeToText[code];
+}

package/src/Valkyrja/Http/Message/Enum/StatusText.ts

@@ -0,0 +1,73 @@
+/*
+ * 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 enum StatusText {
+    CONTINUE = 'Continue',
+    SWITCHING_PROTOCOLS = 'Switching Protocols',
+    PROCESSING = 'Processing',
+    EARLY_HINTS = 'Early Hints',
+    OK = 'OK',
+    CREATED = 'Created',
+    ACCEPTED = 'Accepted',
+    NON_AUTHORITATIVE_INFORMATION = 'Non-Authoritative Information',
+    NO_CONTENT = 'No Content',
+    RESET_CONTENT = 'Reset Content',
+    PARTIAL_CONTENT = 'Partial Content',
+    MULTI_STATUS = 'Multi-Status',
+    ALREADY_REPORTED = 'Already Reported',
+    IM_USED = 'IM Used',
+    MULTIPLE_CHOICES = 'Multiple Choices',
+    MOVED_PERMANENTLY = 'Moved Permanently',
+    FOUND = 'Found',
+    SEE_OTHER = 'See Other',
+    NOT_MODIFIED = 'Not Modified',
+    USE_PROXY = 'Use Proxy',
+    TEMPORARY_REDIRECT = 'Temporary Redirect',
+    PERMANENT_REDIRECT = 'Permanent Redirect',
+    BAD_REQUEST = 'Bad Request',
+    UNAUTHORIZED = 'Unauthorized',
+    PAYMENT_REQUIRED = 'Payment Required',
+    FORBIDDEN = 'Forbidden',
+    NOT_FOUND = 'Not Found',
+    METHOD_NOT_ALLOWED = 'Method Not Allowed',
+    NOT_ACCEPTABLE = 'Not Acceptable',
+    PROXY_AUTHENTICATION_REQUIRED = 'Proxy Authentication Required',
+    REQUEST_TIMEOUT = 'Request Timeout',
+    CONFLICT = 'Conflict',
+    GONE = 'Gone',
+    LENGTH_REQUIRED = 'Length Required',
+    PRECONDITION_FAILED = 'Precondition Failed',
+    PAYLOAD_TOO_LARGE = 'Payload Too Large',
+    URI_TOO_LONG = 'URI Too Long',
+    UNSUPPORTED_MEDIA_TYPE = 'Unsupported Media Type',
+    RANGE_NOT_SATISFIABLE = 'Range Not Satisfiable',
+    EXPECTATION_FAILED = 'Expectation Failed',
+    I_AM_A_TEAPOT = 'I Am A Teapot',
+    MISDIRECTED_REQUEST = 'Misdirected Request',
+    UNPROCESSABLE_ENTITY = 'Unprocessable Entity',
+    LOCKED = 'Locked',
+    FAILED_DEPENDENCY = 'Failed Dependency',
+    TOO_EARLY = 'Too Early',
+    UPGRADE_REQUIRED = 'Upgrade Required',
+    PRECONDITION_REQUIRED = 'Precondition Required',
+    TOO_MANY_REQUESTS = 'Too Many Requests',
+    REQUEST_HEADER_FIELDS_TOO_LARGE = 'Request Header Fields Too Large',
+    UNAVAILABLE_FOR_LEGAL_REASONS = 'Unavailable For Legal Reasons',
+    INTERNAL_SERVER_ERROR = 'Internal Server Error',
+    NOT_IMPLEMENTED = 'Not Implemented',
+    BAD_GATEWAY = 'Bad Gateway',
+    SERVICE_UNAVAILABLE = 'Service Unavailable',
+    GATEWAY_TIMEOUT = 'Gateway Timeout',
+    HTTP_VERSION_NOT_SUPPORTED = 'HTTP Version Not Supported',
+    VARIANT_ALSO_NEGOTIATES = 'Variant Also Negotiates',
+    INSUFFICIENT_STORAGE = 'Insufficient Storage',
+    LOOP_DETECTED = 'Loop Detected',
+    NOT_EXTENDED_OBSOLETED = 'Not Extended',
+    NETWORK_AUTHENTICATION_REQUIRED = 'Network Authentication Required',
+}

package/src/Valkyrja/Http/Message/File/Collection/Contract/UploadedFileCollectionContract.ts

@@ -0,0 +1,20 @@
+/*
+ * 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 { UploadedFileContract } from '../../Contract/UploadedFileContract.js';
+
+export interface UploadedFileCollectionContract {
+    has(key: string): boolean;
+    get(key: string): UploadedFileContract;
+    getAll(): Record<string, UploadedFileContract>;
+    getOnly(...keys: string[]): Record<string, UploadedFileContract>;
+    getAllExcept(...keys: string[]): Record<string, UploadedFileContract>;
+    with(collection: Record<string, UploadedFileContract>): this;
+    withAdded(collection: Record<string, UploadedFileContract>): this;
+}

package/src/Valkyrja/Http/Message/File/Collection/UploadedFileCollection.ts

@@ -0,0 +1,83 @@
+/*
+ * 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 { UploadedFileCollectionContract } from './Contract/UploadedFileCollectionContract.js';
+import type { UploadedFileContract } from '../Contract/UploadedFileContract.js';
+import { UploadedFileInvalidKeyException } from '../Throwable/Exception/UploadedFileInvalidKeyException.js';
+import { UploadedFileInvalidParamException } from '../Throwable/Exception/UploadedFileInvalidParamException.js';
+import { ObjectFactory } from '../../../../Type/Object/Factory/ObjectFactory.js';
+
+export class UploadedFileCollection implements UploadedFileCollectionContract {
+    protected files: Record<string, UploadedFileContract>;
+
+    constructor(files: Record<string, UploadedFileContract> = {}) {
+        this.validateFiles(files);
+        this.files = files;
+    }
+
+    has(key: string): boolean {
+        return key in this.files;
+    }
+
+    get(key: string): UploadedFileContract {
+        const file = this.files[key];
+        if (file === undefined) {
+            throw new UploadedFileInvalidKeyException(`The provided key '${key}' does not exist in the collection`);
+        }
+        return file;
+    }
+
+    getAll(): Record<string, UploadedFileContract> {
+        return { ...this.files };
+    }
+
+    getOnly(...keys: string[]): Record<string, UploadedFileContract> {
+        const result: Record<string, UploadedFileContract> = {};
+        for (const [k, v] of Object.entries(this.files)) {
+            if (keys.includes(k)) {
+                result[k] = v;
+            }
+        }
+        return result;
+    }
+
+    getAllExcept(...keys: string[]): Record<string, UploadedFileContract> {
+        const result: Record<string, UploadedFileContract> = {};
+        for (const [k, v] of Object.entries(this.files)) {
+            if (!keys.includes(k)) {
+                result[k] = v;
+            }
+        }
+        return result;
+    }
+
+    with(collection: Record<string, UploadedFileContract>): this {
+        this.validateFiles(collection);
+        const clone = ObjectFactory.clone(this);
+        clone.files = collection;
+        return clone;
+    }
+
+    withAdded(collection: Record<string, UploadedFileContract>): this {
+        this.validateFiles(collection);
+        const clone = ObjectFactory.clone(this);
+        clone.files = { ...this.files, ...collection };
+        return clone;
+    }
+
+    protected validateFiles(files: Record<string, unknown>): void {
+        for (const [key, file] of Object.entries(files)) {
+            if (file === null || typeof file !== 'object' || !('getStream' in file)) {
+                throw new UploadedFileInvalidParamException(
+                    `Value for key '${key}' must be an UploadedFileContract instance`,
+                );
+            }
+        }
+    }
+}

package/src/Valkyrja/Http/Message/File/Constant/UploadErrorExceptionMessage.ts

@@ -0,0 +1,20 @@
+/*
+ * 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 UploadErrorExceptionMessage {
+    static readonly FORM_SIZE_MESSAGE = 'The uploaded file exceeds the upload_max_filesize directive in php.ini';
+    static readonly INI_SIZE_MESSAGE =
+        'The uploaded file exceeds the MAX_FILE_SIZE directive that was specified in the HTML form';
+    static readonly PARTIAL_MESSAGE = 'The uploaded file was only partially uploaded';
+    static readonly NO_FILE_MESSAGE = 'No file was uploaded';
+    static readonly NO_TMP_DIR_MESSAGE = 'Missing a temporary folder';
+    static readonly CANT_WRITE_MESSAGE = 'Failed to write file to disk';
+    static readonly EXTENSION_MESSAGE = 'A PHP extension stopped the file upload';
+    static readonly OK_MESSAGE = 'OK is not a valid upload error';
+}

package/src/Valkyrja/Http/Message/File/Contract/UploadedFileContract.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 type { StreamContract } from '../../Stream/Contract/StreamContract.js';
+
+export interface UploadedFileContract {
+    getStream(): StreamContract;
+    moveTo(targetPath: string): Promise<void>;
+    hasSize(): boolean;
+    getSize(): number;
+    getError(): Error | null;
+    hasClientFilename(): boolean;
+    getClientFilename(): string;
+    hasClientMediaType(): boolean;
+    getClientMediaType(): string;
+}

package/src/Valkyrja/Http/Message/File/Enum/UploadError.ts

@@ -0,0 +1,19 @@
+/*
+ * 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 enum UploadError {
+    OK = 0,
+    INI_SIZE = 1,
+    FORM_SIZE = 2,
+    PARTIAL = 3,
+    NO_FILE = 4,
+    NO_TMP_DIR = 6,
+    CANT_WRITE = 7,
+    EXTENSION = 8,
+}

package/src/Valkyrja/Http/Message/File/Factory/UploadedFileFactory.ts

@@ -0,0 +1,34 @@
+/*
+ * 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 { UploadedFileContract } from '../Contract/UploadedFileContract.js';
+import type { StreamContract } from '../../Stream/Contract/StreamContract.js';
+import { UploadedFile } from '../UploadedFile.js';
+
+export interface UploadedFileData {
+    file?: string;
+    stream?: StreamContract;
+    error?: Error;
+    size?: number;
+    fileName?: string;
+    mediaType?: string;
+}
+
+export abstract class UploadedFileFactory {
+    static create(data: UploadedFileData): UploadedFileContract {
+        return new UploadedFile(
+            data.file ?? null,
+            data.stream ?? null,
+            data.error ?? null,
+            data.size ?? 0,
+            data.fileName ?? '',
+            data.mediaType ?? '',
+        );
+    }
+}

package/src/Valkyrja/Http/Message/File/Throwable/Contract/UploadedFileThrowable.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 { HttpMessageThrowable } from '../../../Throwable/Contract/HttpMessageThrowable.js';
+
+export type UploadedFileThrowable = HttpMessageThrowable;