zibri 2.2.0 → 2.3.0

package/src/open-api/open-api.service.ts

@@ -1,23 +1,44 @@
-import path from 'path';
-
 import swaggerUi from 'swagger-ui-express';
 
 import { ZibriApplication } from '../application';
-import { AssetServiceInterface } from '../assets';
-import { AuthServiceInterface, BelongsToMetadata, HasRoleMetadata, IsLoggedInMetadata } from '../auth';
-import { inject, ZIBRI_DI_TOKENS } from '../di';
-import { ManyToManyPropertyMetadata, ManyToOnePropertyMetadata, OmitClass, OneToManyPropertyMetadata, OneToOnePropertyMetadata, PropertyMetadata, Relation } from '../entity';
-import { BaseEntity } from '../entity/base-entity.model';
-import { GlobalRegistry } from '../global';
-import { HttpMethod, HttpStatus, KnownHeader, MimeType } from '../http';
-import { LoggerInterface } from '../logging';
-import { BodyMetadata, ControllerRouteConfiguration, HeaderParamMetadata, PathParamMetadata, QueryParamMetadata, Route, RouteHandler } from '../routing';
 import { OpenApiServiceInterface } from './open-api-service.interface';
-import { OpenApiContentObject, OpenApiDefinition, OpenApiOperation, OpenApiParameter, OpenApiParameterLocation, OpenApiPaths, OpenApiRequestBodyObject, OpenApiResponse, OpenApiResponseObject, OpenApiResponsesObject, OpenApiSchemaObject, OpenApiSecurityRequirementObject, OpenApiSecuritySchemeObject, OpenApiTagObject } from './open-api.model';
-import { FileResponse } from '../parsing';
+import { OpenApiDefinition, OpenApiTagObject, OpenApiSecuritySchemeObject, OpenApiPaths, OpenApiResponse, OpenApiOperation, OpenApiResponsesObject, OpenApiResponseObject, OpenApiContentObject, OpenApiSchemaObject, OpenApiSecurityRequirementObject, OpenApiRequestBodyObject, OpenApiParameterLocation, OpenApiParameter } from './open-api.model';
+import { type AssetServiceInterface } from '../assets/asset-service.interface';
+import { type AuthServiceInterface } from '../auth/auth-service.interface';
+import { BelongsToMetadata } from '../auth/models/belongs-to-metadata.model';
+import { HasRoleMetadata } from '../auth/models/has-role-metadata.model';
+import { IsLoggedInMetadata } from '../auth/models/is-logged-in-metadata.model';
+import { Inject } from '../di/decorators/inject.decorator';
+import { Injectable } from '../di/decorators/injectable.decorator';
+import { ZIBRI_DI_TOKENS } from '../di/default/zibri-di-tokens.default';
+import { inject } from '../di/inject.function';
+import { BaseEntity } from '../entity/base-entity.model';
+import { PropertyMetadata } from '../entity/decorators/property.decorator';
+import { ManyToManyPropertyMetadata } from '../entity/models/many-to-many-property-metadata.model';
+import { ManyToOnePropertyMetadata } from '../entity/models/many-to-one-property-metadata.model';
+import { OneToManyPropertyMetadata } from '../entity/models/one-to-many-property-metadata.model';
+import { OneToOnePropertyMetadata } from '../entity/models/one-to-one-property-metadata.model';
+import { Relation } from '../entity/models/relation.enum';
+import { OmitClass } from '../entity/omit-class.model';
+import { GlobalRegistry } from '../global/global-registry';
+import { OnAppInit } from '../global/on-app-init.interface';
+import { HttpMethod } from '../http/http-method.enum';
+import { HttpStatus } from '../http/http-status.enum';
+import { KnownHeader } from '../http/known-header.enum';
+import { MimeType } from '../http/mime-type.enum';
+import { type LoggerInterface } from '../logging/logger.interface';
+import { FileResponse } from '../parsing/form-data/file-response.model';
+import { Route, ControllerRouteConfiguration } from '../routing/controller-route-configuration.model';
+import { BodyMetadata } from '../routing/decorators/body.decorator';
+import { ControllerData } from '../routing/decorators/controller.decorator';
+import { PathParamMetadata, QueryParamMetadata, HeaderParamMetadata } from '../routing/decorators/param.decorator';
 import { MissingBaseRouteError } from '../routing/missing-base-route.error';
-import { Newable } from '../types';
-import { MetadataUtilities, ObjectUtilities } from '../utilities';
+import { RouteHandler } from '../routing/route-configuration.model';
+import { type RouterInterface } from '../routing/router.interface';
+import { Newable } from '../types/newable.type';
+import { FsUtilities, FsPath } from '../utilities/fs.utilities';
+import { MetadataUtilities } from '../utilities/metadata.utilities';
+import { ObjectUtilities } from '../utilities/object.utilities';
 
 const defaultDescriptionForHttpStatus: Record<HttpStatus | 'default', string> = {
     default: 'Response',
@@ -63,49 +84,56 @@ const defaultDescriptionForHttpStatus: Record<HttpStatus | 'default', string> =
 /**
  * Default open api service implementation of Zibri.
  */
-export class OpenApiService implements OpenApiServiceInterface {
+@Injectable({ register: 'onUse' })
+export class OpenApiService implements OpenApiServiceInterface, OnAppInit {
     // eslint-disable-next-line jsdoc/require-jsdoc
     readonly openApiRoute: Route = '/explorer';
-    private readonly logger: LoggerInterface;
-    private readonly assetService: AssetServiceInterface;
-    private readonly authService: AuthServiceInterface;
-
-    constructor() {
-        this.logger = inject(ZIBRI_DI_TOKENS.LOGGER);
-        this.assetService = inject(ZIBRI_DI_TOKENS.ASSET_SERVICE);
-        this.authService = inject(ZIBRI_DI_TOKENS.AUTH_SERVICE);
-    }
+
+    constructor(
+        @Inject(ZIBRI_DI_TOKENS.LOGGER)
+        private readonly logger: LoggerInterface,
+        @Inject(ZIBRI_DI_TOKENS.ASSET_SERVICE)
+        private readonly assetService: AssetServiceInterface,
+        @Inject(ZIBRI_DI_TOKENS.AUTH_SERVICE)
+        private readonly authService: AuthServiceInterface,
+        @Inject(ZIBRI_DI_TOKENS.ROUTER)
+        private readonly router: RouterInterface
+    ) { }
 
     // eslint-disable-next-line jsdoc/require-jsdoc
-    async attachTo(app: ZibriApplication): Promise<void> {
+    async onAppInit(app: ZibriApplication): Promise<void> {
         const definition: OpenApiDefinition = await this.createOpenApiDefinition(app);
         await this.logger.info(`registers the OpenAPI Explorer at ${this.openApiRoute}`);
 
-        await app.router.register({
+        await this.router.registerRoute({
             httpMethod: HttpMethod.GET,
             route: `${this.openApiRoute}/swagger-ui.css`,
             handler: () => {
-                const filePath: string = path.join(this.assetService.publicAssetsPath, 'open-api', 'swagger-ui.css');
+                const filePath: FsPath = FsUtilities.getPath(this.assetService.publicAssetsPath, 'open-api', 'swagger-ui.css');
                 return FileResponse.fromPath(filePath);
             }
         });
-        await app.router.register({
+        await this.router.registerRoute({
             httpMethod: HttpMethod.GET,
             route: `${this.openApiRoute}/swagger-ui-bundle.js`,
             handler: () => {
-                const filePath: string = path.join(this.assetService.publicAssetsPath, 'open-api', 'swagger-ui-bundle.js');
+                const filePath: FsPath = FsUtilities.getPath(this.assetService.publicAssetsPath, 'open-api', 'swagger-ui-bundle.js');
                 return FileResponse.fromPath(filePath);
             }
         });
-        await app.router.register({
+        await this.router.registerRoute({
             httpMethod: HttpMethod.GET,
             route: `${this.openApiRoute}/swagger-ui-standalone-preset.js`,
             handler: () => {
-                const filePath: string = path.join(this.assetService.publicAssetsPath, 'open-api', 'swagger-ui-standalone-preset.js');
+                const filePath: FsPath = FsUtilities.getPath(
+                    this.assetService.publicAssetsPath,
+                    'open-api',
+                    'swagger-ui-standalone-preset.js'
+                );
                 return FileResponse.fromPath(filePath);
             }
         });
-        await app.router.register({
+        await this.router.registerRoute({
             httpMethod: HttpMethod.GET,
             route: `${this.openApiRoute}/swagger-ui-init.js`,
             handler: (_, res) => {
@@ -132,7 +160,7 @@ export class OpenApiService implements OpenApiServiceInterface {
             }
         });
 
-        await app.router.register({
+        await this.router.registerRoute({
             httpMethod: HttpMethod.GET,
             route: `${this.openApiRoute}/custom.js`,
             handler: (_, res) => {
@@ -238,7 +266,7 @@ export class OpenApiService implements OpenApiServiceInterface {
         });
 
         app.use(this.openApiRoute, swaggerUi.serve);
-        await app.router.register({
+        await this.router.registerRoute({
             httpMethod: HttpMethod.GET,
             route: this.openApiRoute,
             handler: swaggerUi.setup(
@@ -284,8 +312,8 @@ export class OpenApiService implements OpenApiServiceInterface {
         const res: OpenApiPaths = {};
 
         for (const controllerClass of app.options.controllers) {
-            const baseRoute: Route | undefined = MetadataUtilities.getControllerBaseRoute(controllerClass);
-            if (!baseRoute) {
+            const controllerData: ControllerData | undefined = MetadataUtilities.getControllerData(controllerClass);
+            if (!controllerData) {
                 throw new MissingBaseRouteError(controllerClass);
             }
 
@@ -308,7 +336,8 @@ export class OpenApiService implements OpenApiServiceInterface {
 
                 const bodyMetadata: BodyMetadata | undefined = MetadataUtilities.getRouteBody(controllerClass, route.controllerMethod);
                 // Ensure an entry exists
-                const fullPath: string = `${baseRoute}${route.route}`.replaceAll(/:([^/]+)/g, '{$1}');
+                const finalRoute: string = controllerData.baseRoute === '/' ? route.route : `${controllerData.baseRoute}${route.route}`;
+                const fullPath: string = finalRoute.replaceAll(/:([^/]+)/g, '{$1}');
                 res[fullPath] ??= {};
 
                 const responses: OpenApiResponse[] = MetadataUtilities.getRouteResponses(controllerClass, route.controllerMethod);
@@ -334,7 +363,7 @@ export class OpenApiService implements OpenApiServiceInterface {
             }
         }
 
-        for (const route of app.router.manuallyRegisteredRoutes.filter(r => r.openApi.useInOpenApi)) {
+        for (const route of this.router.manuallyRegisteredRoutes.filter(r => r.openApi.useInOpenApi)) {
             // Ensure an entry exists
             const fullPath: string = `${route.route}`.replaceAll(/:([^/]+)/g, '{$1}');
             res[fullPath] ??= {};

package/src/open-api/pagination-result.model.ts

@@ -1,5 +1,5 @@
-import { Property } from '../entity';
-import { Newable } from '../types';
+import { Property } from '../entity/decorators/property.decorator';
+import { Newable } from '../types/newable.type';
 
 /**
  * Type of a pagination result, consisting of the items from the current page and the total amount of items.

package/src/parsing/body-parser.interface.ts

@@ -1,8 +1,8 @@
-import { ZibriApplication } from '../application';
-import { HttpRequest, MimeType } from '../http';
-import { HttpClientResponse } from '../http-client';
-import { BodyMetadata } from '../routing';
-import { WebsocketRequest } from '../websocket';
+import { HttpRequest } from '../http/http-request.model';
+import { MimeType } from '../http/mime-type.enum';
+import { HttpClientResponse } from '../http-client/http-client-response.model';
+import { BodyMetadata } from '../routing/decorators/body.decorator';
+import { WebsocketRequest } from '../websocket/models/websocket-request.model';
 
 /**
  * Interface for a body parser.
@@ -12,10 +12,6 @@ export interface BodyParserInterface {
      * The content type that can be handled by this parser.
      */
     readonly contentType: MimeType,
-    /**
-     * Attaches the body parser to the Zibri application.
-     */
-    attachTo?: (app: ZibriApplication) => Promise<void> | void,
     /**
      * Parses the body of the http request.
      */

package/src/parsing/decorators/body-parser.decorator.ts

@@ -1,9 +1,8 @@
-import { GlobalRegistry } from '../../global';
-import { Newable } from '../../types';
-import { MetadataUtilities } from '../../utilities';
+import { GlobalRegistry } from '../../global/global-registry';
+import { Newable } from '../../types/newable.type';
+import { MetadataUtilities } from '../../utilities/metadata.utilities';
 import { BodyParserInterface } from '../body-parser.interface';
 
-// eslint-disable-next-line jsdoc/require-returns
 /**
  * Marks a request body parser.
  */

package/src/parsing/form-data/file-response.model.ts

@@ -1,12 +1,12 @@
-import { stat } from 'fs/promises';
-import path from 'path';
 import { Readable } from 'stream';
 
-import { inject, ZIBRI_DI_TOKENS } from '../../di';
-import { LooseFileMimeType, resolveMimeType } from '../../http';
-import { LoggerInterface } from '../../logging';
-import { OmitStrict } from '../../types';
-import { pathExists } from '../../utilities';
+import { ZIBRI_DI_TOKENS } from '../../di/default/zibri-di-tokens.default';
+import { inject } from '../../di/inject.function';
+import { LooseFileMimeType } from '../../http/mime-type.enum';
+import { resolveMimeType } from '../../http/mime-type.helpers';
+import { LoggerInterface } from '../../logging/logger.interface';
+import { OmitStrict } from '../../types/omit-strict.type';
+import { FsUtilities, FsPath } from '../../utilities/fs.utilities';
 
 /**
  * Data shared by all FileResponses.
@@ -70,12 +70,12 @@ export class FileResponse {
      * @param options - Additional options like file size.
      * @returns A new FileResponse.
      */
-    static async fromPath(p: string, options?: OmitStrict<PathFileResponseData, 'path'>): Promise<FileResponse> {
-        const fullPath: string = path.resolve(p);
-        const fileName: string = options?.filename ?? path.basename(fullPath);
+    static async fromPath(p: FsPath, options?: OmitStrict<PathFileResponseData, 'path'>): Promise<FileResponse> {
+        const fullPath: FsPath = FsUtilities.resolve(p);
+        const fileName: string = options?.filename ?? FsUtilities.baseName(fullPath);
         const mimeType: string = options?.mimeType ?? resolveMimeType(fileName);
 
-        if (!await pathExists(p)) {
+        if (!await FsUtilities.exists(p)) {
             throw new Error(`the file at path "${p}" does not exist.`);
         }
         if (!fileName.includes('.') && options?.mimeType == undefined) {
@@ -83,7 +83,7 @@ export class FileResponse {
             await logger.warn('the file name does not include a extension and no mimetype was provided.');
         }
 
-        const size: number = options?.size ?? (await stat(fullPath)).size;
+        const size: number = options?.size ?? (await FsUtilities.stat(fullPath)).size;
 
         return new this(fullPath, fileName, mimeType, size);
     }

package/src/parsing/form-data/file.model.ts

@@ -1,4 +1,5 @@
-import { Property } from '../../entity';
+import { Property } from '../../entity/decorators/property.decorator';
+import { type FsPath } from '../../utilities/fs.utilities';
 
 /**
  * A resolved file from a multipart/form-data request.
@@ -30,7 +31,7 @@ export class File {
 
     // eslint-disable-next-line jsdoc/require-jsdoc
     @Property.string()
-    path: string;
+    path: FsPath;
 
     constructor(file: File) {
         this.destination = file.destination;

package/src/parsing/form-data/form-data-body-parser-cleanup.cron-job.ts

@@ -1,14 +1,14 @@
-import { readdir, rm, readFile } from 'fs/promises';
-import path from 'path';
+import { Dirent } from 'node:fs';
 
 import { CLEANUP_AT_FILE_NAME } from './form-data.model';
-import { CronJob, InitialCronConfig } from '../../cron';
-import { inject, Injectable, ZIBRI_DI_TOKENS } from '../../di';
+import { CronJob, InitialCronConfig } from '../../cron/cron-job.model';
+import { Inject } from '../../di/decorators/inject.decorator';
+import { ZIBRI_DI_TOKENS } from '../../di/default/zibri-di-tokens.default';
+import { FsUtilities, type FsPath } from '../../utilities/fs.utilities';
 
 /**
  * CronJob that cleans up the temp folder of the form data body parser.
  */
-@Injectable()
 export class FormDataBodyParserCleanupCronJob extends CronJob {
     // eslint-disable-next-line jsdoc/require-jsdoc
     initialConfig: InitialCronConfig = {
@@ -17,23 +17,28 @@ export class FormDataBodyParserCleanupCronJob extends CronJob {
         runOnInit: false
     };
 
+    constructor(
+        @Inject(ZIBRI_DI_TOKENS.FILE_UPLOAD_TEMP_FOLDER)
+        private readonly tempPath: FsPath
+    ) {
+        super();
+    }
+
     // eslint-disable-next-line jsdoc/require-jsdoc
     async onTick(): Promise<void> {
-        const tempPath: string = inject(ZIBRI_DI_TOKENS.FILE_UPLOAD_TEMP_FOLDER);
-
-        await this.logger.info(`cleans up temp folder ${tempPath}`);
+        await this.logger.info(`cleans up temp folder ${this.tempPath}`);
 
         try {
-            const folders: string[] = await readdir(tempPath);
+            const folders: Dirent[] = await FsUtilities.readdir(this.tempPath);
 
             let foldersToPreserve: number = 0;
             for (const folder of folders) {
                 try {
-                    const folderPath: string = path.join(tempPath, folder);
+                    const folderPath: FsPath = FsUtilities.getPath(this.tempPath, folder.parentPath, folder.name);
                     const shouldBePreserved: boolean = await this.hasRecentlyBeenCreated(folderPath);
 
                     if (!shouldBePreserved) {
-                        await rm(folderPath, { recursive: true });
+                        await FsUtilities.rm(folderPath);
                     }
                     else {
                         foldersToPreserve++;
@@ -51,11 +56,11 @@ export class FormDataBodyParserCleanupCronJob extends CronJob {
         }
     }
 
-    private async hasRecentlyBeenCreated(folderPath: string): Promise<boolean> {
-        const cleanupAtPath: string = path.join(folderPath, CLEANUP_AT_FILE_NAME);
+    private async hasRecentlyBeenCreated(folderPath: FsPath): Promise<boolean> {
+        const cleanupAtPath: FsPath = FsUtilities.getPath(folderPath, CLEANUP_AT_FILE_NAME);
         try {
             // Check if the file/folder has been modified within the last 24 hours
-            const cleanupAtMs: number = Number(await readFile(cleanupAtPath, 'utf8'));
+            const cleanupAtMs: number = Number(await FsUtilities.readFile(cleanupAtPath));
             return Date.now() > cleanupAtMs;
         }
         catch {

package/src/parsing/form-data/form-data.body-parser.ts

@@ -1,25 +1,37 @@
-import { createWriteStream, WriteStream } from 'fs';
-import { mkdir, rm } from 'fs/promises';
-import path from 'path';
+import { WriteStream } from 'node:fs';
 import { Readable } from 'stream';
 import { pipeline } from 'stream/promises';
 
 import { Busboy, BusboyFileStream } from '@fastify/busboy';
 
-import { File } from './file.model';
-import { ZibriApplication } from '../../application';
-import { inject, ZIBRI_DI_TOKENS } from '../../di';
-import { ContentTooLargeError } from '../../error-handling';
-import { FileExtension, HttpRequest, KnownHeader, MimeType, resolveFileExtension } from '../../http';
-import { HttpClientResponse } from '../../http-client';
-import { BodyMetadata } from '../../routing';
-import { BodyParserInterface } from '../body-parser.interface';
-import { BodyParser } from '../decorators';
 import { FormDataBodyParserCleanupCronJob } from './form-data-body-parser-cleanup.cron-job';
 import { FormData, FormDataValue } from './form-data.model';
-import { PropertyMetadata, Relation } from '../../entity';
-import { BigNumberUtilities, MetadataUtilities, UUIDUtilities } from '../../utilities';
-import { parseArray, parseBoolean, parseDate, parseNumber, parseObject, parseString } from '../functions';
+import { ZibriApplication } from '../../application';
+import { inject } from '../../di/inject.function';
+import { OnAppInit } from '../../global/on-app-init.interface';
+import { HttpRequest } from '../../http/http-request.model';
+import { MimeType } from '../../http/mime-type.enum';
+import { BodyMetadata } from '../../routing/decorators/body.decorator';
+import { BodyParserInterface } from '../body-parser.interface';
+import { File } from './file.model';
+import { ZIBRI_DI_TOKENS } from '../../di/default/zibri-di-tokens.default';
+import { PropertyMetadata } from '../../entity/decorators/property.decorator';
+import { Relation } from '../../entity/models/relation.enum';
+import { ContentTooLargeError } from '../../error-handling/errors/content-too-large.error';
+import { KnownHeader } from '../../http/known-header.enum';
+import { FileExtension, resolveFileExtension } from '../../http/mime-type.helpers';
+import { HttpClientResponse } from '../../http-client/http-client-response.model';
+import { BigNumberUtilities } from '../../utilities/big-number.utilities';
+import { FsUtilities, FsPath } from '../../utilities/fs.utilities';
+import { MetadataUtilities } from '../../utilities/metadata.utilities';
+import { UUIDUtilities } from '../../utilities/uuid.utilities';
+import { BodyParser } from '../decorators/body-parser.decorator';
+import { parseArray } from '../functions/parse-array.function';
+import { parseBoolean } from '../functions/parse-boolean.function';
+import { parseDate } from '../functions/parse-date.function';
+import { parseNumber } from '../functions/parse-number.function';
+import { parseObject } from '../functions/parse-object.function';
+import { parseString } from '../functions/parse-string.function';
 
 // eslint-disable-next-line jsdoc/require-jsdoc
 type ParsedForm = {
@@ -33,12 +45,12 @@ type ParsedForm = {
  * Body parser for form data.
  */
 @BodyParser()
-export class FormDataBodyParser implements BodyParserInterface {
+export class FormDataBodyParser implements BodyParserInterface, OnAppInit {
     // eslint-disable-next-line jsdoc/require-jsdoc
     readonly contentType: MimeType = MimeType.FORM_DATA;
 
     // eslint-disable-next-line jsdoc/require-jsdoc
-    attachTo(app: ZibriApplication): void {
+    onAppInit(app: ZibriApplication): void {
         app.options.cronJobs.push(FormDataBodyParserCleanupCronJob);
     }
 
@@ -77,7 +89,7 @@ export class FormDataBodyParser implements BodyParserInterface {
             throw new ContentTooLargeError();
         }
 
-        const tempFolder: string = this.getTempFolder();
+        const tempFolder: FsPath = this.getTempFolder();
 
         try {
             const parsed: ParsedForm = await this.parseMultipartStreamToDisk(stream, headers, tempFolder, metadata);
@@ -96,9 +108,9 @@ export class FormDataBodyParser implements BodyParserInterface {
         }
     }
 
-    private getTempFolder(): string {
-        const tempPath: string = inject(ZIBRI_DI_TOKENS.FILE_UPLOAD_TEMP_FOLDER);
-        return path.join(tempPath, `temp-${UUIDUtilities.generate()}`);
+    private getTempFolder(): FsPath {
+        const tempPath: FsPath = inject(ZIBRI_DI_TOKENS.FILE_UPLOAD_TEMP_FOLDER);
+        return FsUtilities.getPath(tempPath, `temp-${UUIDUtilities.generate()}`);
     }
 
     private getTempFileName(mimetype: string): string {
@@ -110,9 +122,9 @@ export class FormDataBodyParser implements BodyParserInterface {
         return id;
     }
 
-    private async removeTempFolder(tempFolder: string): Promise<void> {
+    private async removeTempFolder(tempFolder: FsPath): Promise<void> {
         try {
-            await rm(tempFolder, { recursive: true });
+            await FsUtilities.rm(tempFolder);
         }
         catch {
             // Do nothing
@@ -231,13 +243,13 @@ export class FormDataBodyParser implements BodyParserInterface {
     private async parseMultipartStreamToDisk(
         stream: Readable,
         headers: Partial<Record<string, string | undefined>>,
-        tempFolder: string,
+        tempFolder: FsPath,
         metadata: BodyMetadata
     ): Promise<ParsedForm> {
         const contentType: string | undefined = headers[KnownHeader.CONTENT_TYPE]
             ?? headers[KnownHeader.CONTENT_TYPE.toLowerCase()];
 
-        await mkdir(tempFolder, { recursive: true });
+        await FsUtilities.mkdir(tempFolder);
 
         return await new Promise<ParsedForm>((resolve, reject) => {
             const bb: Busboy = Busboy({ headers: { 'content-type': contentType ?? 'string' } });
@@ -282,8 +294,8 @@ export class FormDataBodyParser implements BodyParserInterface {
 
             bb.on('file', (fieldname: string, fileStream: BusboyFileStream, originalname: string, _: string, mimetype: string) => {
                 const filename: string = this.getTempFileName(mimetype);
-                const destination: string = path.join(tempFolder, filename);
-                const writeStream: WriteStream = createWriteStream(destination);
+                const destination: FsPath = FsUtilities.getPath(tempFolder, filename);
+                const writeStream: WriteStream = FsUtilities.createWriteStream(destination);
                 let size: number = 0;
 
                 fileStream.on('data', (chunk: Buffer) => {
@@ -343,11 +355,9 @@ export class FormDataBodyParser implements BodyParserInterface {
                 }));
             });
 
-            // eslint-disable-next-line typescript/no-misused-promises
-            bb.on('finish', async () => {
+            bb.on('finish', () => {
                 try {
-                    await Promise.all(filePromises);
-                    resolve({ fields, filesMap });
+                    void Promise.all(filePromises).then(() => resolve({ fields, filesMap }));
                 }
                 catch (error) {
                     reject(error);

package/src/parsing/form-data/form-data.model.ts

@@ -1,7 +1,5 @@
-import { rm, writeFile } from 'fs/promises';
-import path from 'path';
-
 import { File } from './file.model';
+import { FsUtilities, FsPath } from '../../utilities/fs.utilities';
 
 /**
  * The raw value that a form-data property has.
@@ -28,9 +26,9 @@ export class FormData<FormDataType extends object> {
      * The temporary folder where all files are cached.
      * Should be deleted after you handled the form data with the cleanup method.
      */
-    readonly tempFolder: string;
+    readonly tempFolder: FsPath;
 
-    private constructor(value: FormDataType, tempFolder: string) {
+    private constructor(value: FormDataType, tempFolder: FsPath) {
         this.value = value;
         this.tempFolder = tempFolder;
     }
@@ -44,14 +42,13 @@ export class FormData<FormDataType extends object> {
      */
     static async create<FormDataType extends object>(
         value: FormDataType,
-        tempFolder: string,
+        tempFolder: FsPath,
         cleanupAfterMs: number
     ): Promise<FormData<FormDataType>> {
         const res: FormData<FormDataType> = new this(value, tempFolder);
-        await writeFile(
-            path.join(res.tempFolder, CLEANUP_AT_FILE_NAME),
-            `${Date.now() + cleanupAfterMs}`,
-            { encoding: 'utf8' }
+        await FsUtilities.createFile(
+            FsUtilities.getPath(res.tempFolder, CLEANUP_AT_FILE_NAME),
+            `${Date.now() + cleanupAfterMs}`
         );
         return res;
     }
@@ -61,7 +58,7 @@ export class FormData<FormDataType extends object> {
      */
     async cleanup(): Promise<void> {
         try {
-            await rm(this.tempFolder, { recursive: true });
+            await FsUtilities.rm(this.tempFolder);
         }
         catch {
             // do nothing

package/src/parsing/functions/parse-array.function.ts

@@ -3,8 +3,8 @@ import { parseDate } from './parse-date.function';
 import { parseNumber } from './parse-number.function';
 import { parseObject } from './parse-object.function';
 import { parseString } from './parse-string.function';
-import { ArrayPropertyItemMetadata } from '../../entity';
-import { ArrayParamItemMetadata } from '../../routing';
+import { ArrayPropertyItemMetadata } from '../../entity/models/array-property-metadata.model';
+import { ArrayParamItemMetadata } from '../../routing/models/array-param-metadata.model';
 
 // eslint-disable-next-line jsdoc/require-jsdoc
 export function parseArray(

package/src/parsing/functions/parse-array.test.ts

@@ -2,7 +2,7 @@
 import { describe, expect, it } from '@jest/globals';
 
 import { parseArray } from './parse-array.function';
-import { ArrayParamMetadata } from '../../routing';
+import { ArrayParamMetadata } from '../../routing/models/array-param-metadata.model';
 
 describe('parseArray', () => {
     const meta: ArrayParamMetadata = {

package/src/parsing/functions/parse-date.function.ts

@@ -1,4 +1,4 @@
-import { isDate } from '../../utilities';
+import { isDate } from '../../utilities/is-date.function';
 
 // eslint-disable-next-line jsdoc/require-jsdoc
 export function parseDate(rawValue: unknown): unknown {

package/src/parsing/functions/parse-number.function.ts

@@ -1,4 +1,4 @@
-import { isNumeric } from '../../utilities';
+import { isNumeric } from '../../utilities/is-numeric.function';
 
 // eslint-disable-next-line jsdoc/require-jsdoc
 export function parseNumber(rawValue: unknown): unknown {

package/src/parsing/functions/parse-object.function.ts

@@ -1,12 +1,13 @@
-
 import { parseArray } from './parse-array.function';
 import { parseBoolean } from './parse-boolean.function';
 import { parseDate } from './parse-date.function';
 import { parseNumber } from './parse-number.function';
 import { parseString } from './parse-string.function';
-import { PropertyMetadata, Relation } from '../../entity';
-import { Newable } from '../../types';
-import { MetadataUtilities, ObjectUtilities } from '../../utilities';
+import { PropertyMetadata } from '../../entity/decorators/property.decorator';
+import { Relation } from '../../entity/models/relation.enum';
+import { Newable } from '../../types/newable.type';
+import { MetadataUtilities } from '../../utilities/metadata.utilities';
+import { ObjectUtilities } from '../../utilities/object.utilities';
 
 // eslint-disable-next-line jsdoc/require-jsdoc
 export function parseObject(

package/src/parsing/functions/parse-object.test.ts

@@ -2,7 +2,7 @@
 import { describe, expect, it } from '@jest/globals';
 
 import { parseObject } from './parse-object.function';
-import { Property } from '../../entity';
+import { Property } from '../../entity/decorators/property.decorator';
 
 class Dummy {}