zibri 2.2.1 → 2.4.0

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

@@ -3,11 +3,13 @@ import swaggerUi from 'swagger-ui-express';
 import { ZibriApplication } from '../application';
 import { OpenApiServiceInterface } from './open-api-service.interface';
 import { OpenApiDefinition, OpenApiTagObject, OpenApiSecuritySchemeObject, OpenApiPaths, OpenApiResponse, OpenApiOperation, OpenApiResponsesObject, OpenApiResponseObject, OpenApiContentObject, OpenApiSchemaObject, OpenApiSecurityRequirementObject, OpenApiRequestBodyObject, OpenApiParameterLocation, OpenApiParameter } from './open-api.model';
-import { AssetServiceInterface } from '../assets/asset-service.interface';
-import { AuthServiceInterface } from '../auth/auth-service.interface';
+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';
@@ -19,19 +21,23 @@ import { OneToOnePropertyMetadata } from '../entity/models/one-to-one-property-m
 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 { LoggerInterface } from '../logging/logger.interface';
+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 { RouteHandler } from '../routing/route-configuration.model';
+import { type RouterInterface } from '../routing/router.interface';
 import { Newable } from '../types/newable.type';
-import { FsUtilities, Path } from '../utilities/fs.utilities';
+import { FsUtilities, FsPath } from '../utilities/fs.utilities';
+import { JsonUtilities } from '../utilities/json.utilities';
 import { MetadataUtilities } from '../utilities/metadata.utilities';
 import { ObjectUtilities } from '../utilities/object.utilities';
 
@@ -79,45 +85,48 @@ 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: Path = FsUtilities.getPath(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: Path = FsUtilities.getPath(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: Path = FsUtilities.getPath(
+                const filePath: FsPath = FsUtilities.getPath(
                     this.assetService.publicAssetsPath,
                     'open-api',
                     'swagger-ui-standalone-preset.js'
@@ -125,14 +134,14 @@ export class OpenApiService implements OpenApiServiceInterface {
                 return FileResponse.fromPath(filePath);
             }
         });
-        await app.router.register({
+        await this.router.registerRoute({
             httpMethod: HttpMethod.GET,
             route: `${this.openApiRoute}/swagger-ui-init.js`,
             handler: (_, res) => {
                 res.type('.js').send([
                     'window.onload = function() {',
                     '    SwaggerUIBundle({',
-                    `        spec: ${JSON.stringify(definition)},`,
+                    `        spec: ${JsonUtilities.stringify(definition)},`,
                     '        dom_id: \'#swagger-ui\',',
                     '        presets: [',
                     '            SwaggerUIBundle.presets.apis,',
@@ -152,7 +161,7 @@ export class OpenApiService implements OpenApiServiceInterface {
             }
         });
 
-        await app.router.register({
+        await this.router.registerRoute({
             httpMethod: HttpMethod.GET,
             route: `${this.openApiRoute}/custom.js`,
             handler: (_, res) => {
@@ -258,7 +267,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(
@@ -304,8 +313,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);
             }
 
@@ -328,7 +337,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);
@@ -354,7 +364,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] ??= {};
@@ -439,7 +449,7 @@ export class OpenApiService implements OpenApiServiceInterface {
                     return undefined;
                 }
                 const propMeta: Record<string, PropertyMetadata> = MetadataUtilities.getModelProperties(response.cls);
-                const schema: OpenApiSchemaObject = this.buildOpenApiSchemaForProperties(propMeta, response.cls);
+                const schema: OpenApiSchemaObject = this.buildOpenApiSchemaForProperties(propMeta, response.cls, 'response');
 
                 if (response.isArray === true) {
                     return { [MimeType.JSON]: { schema: { type: 'array', items: schema } } };
@@ -481,7 +491,7 @@ export class OpenApiService implements OpenApiServiceInterface {
                         continue;
                     }
                     const propMeta: Record<string, PropertyMetadata> = MetadataUtilities.getModelProperties(response.cls);
-                    const schema: OpenApiSchemaObject = this.buildOpenApiSchemaForProperties(propMeta, response.cls);
+                    const schema: OpenApiSchemaObject = this.buildOpenApiSchemaForProperties(propMeta, response.cls, 'response');
                     if (response.isArray === true) {
                         schemas.push({ type: 'array', items: schema });
                         continue;
@@ -534,7 +544,7 @@ export class OpenApiService implements OpenApiServiceInterface {
             return undefined;
         }
         const propMeta: Record<string, PropertyMetadata> = MetadataUtilities.getModelProperties(metadata.modelClass);
-        const schema: OpenApiSchemaObject = this.buildOpenApiSchemaForProperties(propMeta, metadata.modelClass);
+        const schema: OpenApiSchemaObject = this.buildOpenApiSchemaForProperties(propMeta, metadata.modelClass, 'request');
         return {
             required: typeof metadata.required === 'boolean' ? metadata.required : undefined,
             description: metadata.description,
@@ -543,17 +553,23 @@ export class OpenApiService implements OpenApiServiceInterface {
     }
 
     // eslint-disable-next-line sonar/cognitive-complexity
-    private buildOpenApiSchemaForProperties(propMeta: Record<string, PropertyMetadata>, entity: Newable<unknown>): OpenApiSchemaObject {
+    private buildOpenApiSchemaForProperties(
+        propMeta: Record<string, PropertyMetadata>,
+        entity: Newable<unknown>,
+        context: 'request' | 'response'
+    ): OpenApiSchemaObject {
         const properties: Record<string, OpenApiSchemaObject> = {};
         const required: string[] = [];
 
         for (const [key, meta] of ObjectUtilities.entries(propMeta)) {
+            if (meta.exclude === true && context === 'response') {
+                continue;
+            }
             // mark required
-            if ((
-                typeof meta.required === 'boolean'
-                    ? meta.required
-                    : false)
+            if (
+                (typeof meta.required === 'boolean' ? meta.required : false)
                 && (!('default' in meta) || meta.default == undefined)
+                && (meta.exclude === false || context === 'response')
             ) {
                 required.push(key);
             }
@@ -596,14 +612,20 @@ export class OpenApiService implements OpenApiServiceInterface {
                 }
                 case 'object': {
                     const objectPropMeta: Record<string, PropertyMetadata> = MetadataUtilities.getModelProperties(meta.cls());
-                    properties[key] = { ...this.buildOpenApiSchemaForProperties(objectPropMeta, entity), description: meta.description };
+                    properties[key] = {
+                        ...this.buildOpenApiSchemaForProperties(objectPropMeta, entity, context),
+                        description: meta.description
+                    };
                     continue;
                 }
                 case Relation.ONE_TO_ONE:
                 case Relation.MANY_TO_ONE: {
                     const targetClass: Newable<BaseEntity> = this.getTargetClassForRelation(meta, entity);
                     const objectPropMeta: Record<string, PropertyMetadata> = MetadataUtilities.getModelProperties(targetClass);
-                    properties[key] = { ...this.buildOpenApiSchemaForProperties(objectPropMeta, entity), description: meta.description };
+                    properties[key] = {
+                        ...this.buildOpenApiSchemaForProperties(objectPropMeta, entity, context),
+                        description: meta.description
+                    };
                     continue;
                 }
                 case Relation.MANY_TO_MANY:
@@ -618,10 +640,12 @@ export class OpenApiService implements OpenApiServiceInterface {
                                 required: true,
                                 description: undefined,
                                 excludeFromChangeSets: false,
+                                exclude: false,
                                 allowAdditionalProperties: false
                             }
                         },
-                        entity
+                        entity,
+                        context
                     );
                     properties[key] = {
                         type: 'array',
@@ -634,7 +658,7 @@ export class OpenApiService implements OpenApiServiceInterface {
                     if (meta.items.type === 'object') {
                         entity = meta.items.cls();
                     }
-                    const items: OpenApiSchemaObject = this.buildOpenApiSchemaForProperties({ items: meta.items }, entity);
+                    const items: OpenApiSchemaObject = this.buildOpenApiSchemaForProperties({ items: meta.items }, entity, context);
                     properties[key] = {
                         type: 'array',
                         description: meta.description,
@@ -747,7 +771,7 @@ export class OpenApiService implements OpenApiServiceInterface {
                 const propMeta: Record<string, PropertyMetadata> = MetadataUtilities.getModelProperties(meta.cls());
                 return {
                     description: meta.description,
-                    ...this.buildOpenApiSchemaForProperties(propMeta, meta.cls())
+                    ...this.buildOpenApiSchemaForProperties(propMeta, meta.cls(), 'request')
                 };
             }
             case 'array': {

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

@@ -1,4 +1,3 @@
-import { ZibriApplication } from '../application';
 import { HttpRequest } from '../http/http-request.model';
 import { MimeType } from '../http/mime-type.enum';
 import { HttpClientResponse } from '../http-client/http-client-response.model';
@@ -13,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/form-data/file-response.model.ts

@@ -2,11 +2,13 @@ import { Readable } from 'stream';
 
 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 { LooseFileMimeType, MimeType } from '../../http/mime-type.enum';
 import { resolveMimeType } from '../../http/mime-type.helpers';
 import { LoggerInterface } from '../../logging/logger.interface';
+import { DeepPartial } from '../../types/deep-partial.type';
 import { OmitStrict } from '../../types/omit-strict.type';
-import { FsUtilities, Path } from '../../utilities/fs.utilities';
+import { FsUtilities, FsPath } from '../../utilities/fs.utilities';
+import { buildCspOptions, CspOptions } from '../html/csp-options.model';
 
 /**
  * Data shared by all FileResponses.
@@ -20,7 +22,12 @@ type BaseFileResponseData = {
      * The size of the file to send in bytes.
      * Used to set the Content-Length header.
      */
-    size?: number
+    size?: number,
+    /**
+     * The configuration for CSP headers.
+     * Can either be false to not set any, true to set the default CSP headers or a custom configuration.
+     */
+    csp?: boolean | DeepPartial<CspOptions>
 };
 
 /**
@@ -61,7 +68,8 @@ export class FileResponse {
         readonly data: Readable | string,
         readonly filename: string,
         readonly mimeType: LooseFileMimeType,
-        readonly size: number | undefined
+        readonly size: number | undefined,
+        readonly csp: boolean | CspOptions
     ) {}
 
     /**
@@ -70,8 +78,8 @@ export class FileResponse {
      * @param options - Additional options like file size.
      * @returns A new FileResponse.
      */
-    static async fromPath(p: Path, options?: OmitStrict<PathFileResponseData, 'path'>): Promise<FileResponse> {
-        const fullPath: Path = FsUtilities.resolve(p);
+    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);
 
@@ -84,8 +92,9 @@ export class FileResponse {
         }
 
         const size: number = options?.size ?? (await FsUtilities.stat(fullPath)).size;
+        const csp: boolean | CspOptions = buildCspOptions(options?.csp, this.getDefaultCsp(mimeType));
 
-        return new this(fullPath, fileName, mimeType, size);
+        return new this(fullPath, fileName, mimeType, size, csp);
     }
 
     /**
@@ -95,6 +104,14 @@ export class FileResponse {
      */
     static fromStream(input: StreamFileResponseData): FileResponse {
         const mimeType: string = input.mimeType ?? resolveMimeType(input.filename);
-        return new this(input.stream, input.filename, mimeType, input.size);
+        const csp: boolean | CspOptions = buildCspOptions(input?.csp, this.getDefaultCsp(mimeType));
+        return new this(input.stream, input.filename, mimeType, input.size, csp);
+    }
+
+    private static getDefaultCsp(mimeType: string): boolean | CspOptions {
+        if (mimeType === MimeType.SVG) {
+            return inject(ZIBRI_DI_TOKENS.DEFAULT_CSP_OPTIONS);
+        }
+        return false;
     }
 }

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

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

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

@@ -1,37 +1,41 @@
 import { Dirent } from 'node:fs';
 
 import { CLEANUP_AT_FILE_NAME } from './form-data.model';
+import { CronExpression } from '../../cron/cron-expression.utilities';
 import { CronJob, InitialCronConfig } from '../../cron/cron-job.model';
-import { Injectable } from '../../di/decorators/injectable.decorator';
+import { Inject } from '../../di/decorators/inject.decorator';
 import { ZIBRI_DI_TOKENS } from '../../di/default/zibri-di-tokens.default';
-import { inject } from '../../di/inject.function';
-import { FsUtilities, Path } from '../../utilities/fs.utilities';
+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 = {
         name: 'FormDataBodyParser Cleanup',
-        cron: '0 0 * * *',
+        cron: CronExpression.daily().build(),
         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: Path = 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: Dirent[] = await FsUtilities.readdir(tempPath);
+            const folders: Dirent[] = await FsUtilities.readdir(this.tempPath);
 
             let foldersToPreserve: number = 0;
             for (const folder of folders) {
                 try {
-                    const folderPath: Path = FsUtilities.getPath(tempPath, folder.parentPath, folder.name);
+                    const folderPath: FsPath = FsUtilities.getPath(this.tempPath, folder.parentPath, folder.name);
                     const shouldBePreserved: boolean = await this.hasRecentlyBeenCreated(folderPath);
 
                     if (!shouldBePreserved) {
@@ -53,8 +57,8 @@ export class FormDataBodyParserCleanupCronJob extends CronJob {
         }
     }
 
-    private async hasRecentlyBeenCreated(folderPath: Path): Promise<boolean> {
-        const cleanupAtPath: Path = FsUtilities.getPath(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 FsUtilities.readFile(cleanupAtPath));

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

@@ -8,6 +8,7 @@ import { FormDataBodyParserCleanupCronJob } from './form-data-body-parser-cleanu
 import { FormData, FormDataValue } from './form-data.model';
 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';
@@ -20,9 +21,9 @@ import { ContentTooLargeError } from '../../error-handling/errors/content-too-la
 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, Path } from '../../utilities/fs.utilities';
+import { FsUtilities, FsPath } from '../../utilities/fs.utilities';
 import { MetadataUtilities } from '../../utilities/metadata.utilities';
+import { BigNumber, NumberUtilities } from '../../utilities/number.utilities';
 import { UUIDUtilities } from '../../utilities/uuid.utilities';
 import { BodyParser } from '../decorators/body-parser.decorator';
 import { parseArray } from '../functions/parse-array.function';
@@ -44,13 +45,15 @@ 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 {
-        app.options.cronJobs.push(FormDataBodyParserCleanupCronJob);
+    onAppInit(app: ZibriApplication): void {
+        if (!app.options.cronJobs.includes(FormDataBodyParserCleanupCronJob)) {
+            app.options.cronJobs.push(FormDataBodyParserCleanupCronJob);
+        }
     }
 
     // eslint-disable-next-line jsdoc/require-jsdoc
@@ -83,12 +86,12 @@ export class FormDataBodyParser implements BodyParserInterface {
         if (metadata.type !== MimeType.FORM_DATA) {
             throw new Error(`${metadata.type} is not supported`);
         }
-        const contentLength: string | undefined = headers[KnownHeader.CONTENT_LENGTH] ?? headers[KnownHeader.CONTENT_LENGTH];
-        if (contentLength && BigNumberUtilities.new(Number(contentLength)).isGreaterThan(metadata.maxSize)) {
+        const contentLength: string | undefined = headers[KnownHeader.CONTENT_LENGTH];
+        if (contentLength && NumberUtilities.new(Number(contentLength)).isGreaterThan(metadata.maxSize)) {
             throw new ContentTooLargeError();
         }
 
-        const tempFolder: Path = this.getTempFolder();
+        const tempFolder: FsPath = this.getTempFolder();
 
         try {
             const parsed: ParsedForm = await this.parseMultipartStreamToDisk(stream, headers, tempFolder, metadata);
@@ -107,8 +110,8 @@ export class FormDataBodyParser implements BodyParserInterface {
         }
     }
 
-    private getTempFolder(): Path {
-        const tempPath: Path = inject(ZIBRI_DI_TOKENS.FILE_UPLOAD_TEMP_FOLDER);
+    private getTempFolder(): FsPath {
+        const tempPath: FsPath = inject(ZIBRI_DI_TOKENS.FILE_UPLOAD_TEMP_FOLDER);
         return FsUtilities.getPath(tempPath, `temp-${UUIDUtilities.generate()}`);
     }
 
@@ -121,7 +124,7 @@ export class FormDataBodyParser implements BodyParserInterface {
         return id;
     }
 
-    private async removeTempFolder(tempFolder: Path): Promise<void> {
+    private async removeTempFolder(tempFolder: FsPath): Promise<void> {
         try {
             await FsUtilities.rm(tempFolder);
         }
@@ -132,10 +135,10 @@ export class FormDataBodyParser implements BodyParserInterface {
 
     private requestToDataObject<T extends object>(request: ParsedForm, metadata: BodyMetadata): T {
         const multiPartMap: Map<keyof T, FormDataValue> = new Map();
+        const properties: Record<string, PropertyMetadata> = MetadataUtilities.getModelProperties(metadata.modelClass);
         this.addStringValuesToMap(request, multiPartMap);
-        this.addFilesToMap<T>(request, multiPartMap, metadata);
+        this.addFilesToMap<T>(request, multiPartMap, properties);
 
-        const properties: Record<string, PropertyMetadata> = MetadataUtilities.getModelProperties(metadata.modelClass);
         const res: Partial<Record<keyof T, unknown>> = {};
         for (const [key, value] of multiPartMap) {
             if (typeof value !== 'string') {
@@ -186,11 +189,10 @@ export class FormDataBodyParser implements BodyParserInterface {
     private addFilesToMap<T extends object>(
         request: ParsedForm,
         values: Map<keyof T, FormDataValue>,
-        metadata: BodyMetadata
+        properties: Record<string, PropertyMetadata>
     ): void {
         for (const key in request.filesMap) {
-            const formDataProperties: Record<string, PropertyMetadata> = MetadataUtilities.getModelProperties(metadata.modelClass);
-            const property: PropertyMetadata = formDataProperties[key];
+            const property: PropertyMetadata = properties[key];
             this.addFileArrayToMap(request.filesMap[key], values, property);
         }
     }
@@ -242,7 +244,7 @@ export class FormDataBodyParser implements BodyParserInterface {
     private async parseMultipartStreamToDisk(
         stream: Readable,
         headers: Partial<Record<string, string | undefined>>,
-        tempFolder: Path,
+        tempFolder: FsPath,
         metadata: BodyMetadata
     ): Promise<ParsedForm> {
         const contentType: string | undefined = headers[KnownHeader.CONTENT_TYPE]
@@ -257,7 +259,7 @@ export class FormDataBodyParser implements BodyParserInterface {
             const filesMap: Record<string, File[]> = {};
             const filePromises: Promise<void>[] = [];
 
-            let received: BigNumber = BigNumberUtilities.new(0);
+            let received: BigNumber = NumberUtilities.new(0);
             let aborted: boolean = false;
 
             bb.on('field', (name: string, val: string) => {
@@ -266,7 +268,7 @@ export class FormDataBodyParser implements BodyParserInterface {
                 }
 
                 const bytes: number = Buffer.byteLength(val, 'utf8');
-                received = BigNumberUtilities.add(received, bytes);
+                received = NumberUtilities.add(received, bytes);
                 if (received.isGreaterThan(metadata.maxSize)) {
                     aborted = true;
                     // stop parsing and abort
@@ -293,7 +295,7 @@ 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: Path = FsUtilities.getPath(tempFolder, filename);
+                const destination: FsPath = FsUtilities.getPath(tempFolder, filename);
                 const writeStream: WriteStream = FsUtilities.createWriteStream(destination);
                 let size: number = 0;
 
@@ -302,7 +304,7 @@ export class FormDataBodyParser implements BodyParserInterface {
                         return;
                     }
 
-                    received = BigNumberUtilities.add(received, chunk.length);
+                    received = NumberUtilities.add(received, chunk.length);
                     if (received.isGreaterThan(metadata.maxSize)) {
                         aborted = true;
                         writeStream.destroy();

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

@@ -1,5 +1,5 @@
 import { File } from './file.model';
-import { FsUtilities, Path } from '../../utilities/fs.utilities';
+import { FsUtilities, FsPath } from '../../utilities/fs.utilities';
 
 /**
  * The raw value that a form-data property has.
@@ -26,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: Path;
+    readonly tempFolder: FsPath;
 
-    private constructor(value: FormDataType, tempFolder: Path) {
+    private constructor(value: FormDataType, tempFolder: FsPath) {
         this.value = value;
         this.tempFolder = tempFolder;
     }
@@ -42,7 +42,7 @@ export class FormData<FormDataType extends object> {
      */
     static async create<FormDataType extends object>(
         value: FormDataType,
-        tempFolder: Path,
+        tempFolder: FsPath,
         cleanupAfterMs: number
     ): Promise<FormData<FormDataType>> {
         const res: FormData<FormDataType> = new this(value, tempFolder);

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

@@ -5,6 +5,7 @@ import { parseObject } from './parse-object.function';
 import { parseString } from './parse-string.function';
 import { ArrayPropertyItemMetadata } from '../../entity/models/array-property-metadata.model';
 import { ArrayParamItemMetadata } from '../../routing/models/array-param-metadata.model';
+import { JsonUtilities } from '../../utilities/json.utilities';
 
 // eslint-disable-next-line jsdoc/require-jsdoc
 export function parseArray(
@@ -18,7 +19,7 @@ export function parseArray(
     let simpleParsedValue: unknown = rawValue;
     try {
         if (typeof rawValue === 'string') {
-            simpleParsedValue = JSON.parse(rawValue);
+            simpleParsedValue = JsonUtilities.parse(rawValue);
         }
     }
     catch {