zibri 1.7.1 → 2.0.0

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import express, { Request, Response as Response$1, NextFunction, RequestHandler } from 'express';
-import { EntitySchemaRelationOptions, DataSourceOptions as DataSourceOptions$1, ColumnType as ColumnType$1, QueryRunner, FindManyOptions, FindOneOptions as FindOneOptions$1, Repository as Repository$1, EntityTarget, EntityMetadata as EntityMetadata$1, DataSource as DataSource$1, EntitySchema, EntitySchemaColumnOptions, TableColumnOptions } from 'typeorm';
 import { oas31 } from 'openapi3-ts';
 import { ScheduledTask } from 'node-cron';
+import { EntitySchemaRelationOptions, DataSourceOptions as DataSourceOptions$1, ColumnType as ColumnType$1, QueryRunner, FindManyOptions, FindOneOptions as FindOneOptions$1, Repository as Repository$1, EntityTarget, EntityMetadata as EntityMetadata$1, DataSource as DataSource$1, EntitySchema, EntitySchemaColumnOptions, TableColumnOptions } from 'typeorm';
 import { IsolationLevel } from 'typeorm/driver/types/IsolationLevel';
 import { ColumnMetadata } from 'typeorm/metadata/ColumnMetadata';
 import { SecuritySchemeObject } from 'openapi3-ts/dist/oas31';
@@ -10,6 +10,36 @@ import { Readable } from 'stream';
 import { Transporter } from 'nodemailer';
 import SMTPTransport from 'nodemailer/lib/smtp-transport';
 import { Counter, Gauge, Histogram } from 'prom-client';
+import { ImageDefinition, TDocumentDefinitions, Content, Column } from 'pdfmake/interfaces';
+import BigNumberJs from 'bignumber.js';
+import { XMLBuilder } from 'xmlbuilder2/lib/interfaces';
+import { BehaviorSubject } from 'rxjs';
+import { Worker } from 'node:worker_threads';
+
+/**
+ * Metadata for an Entity.
+ */
+type EntityMetadata = {
+    /**
+     * The name of the table in the db.
+     */
+    tableName: string;
+};
+/**
+ * Marks an entity.
+ * @param tableName - The name of the table to generate for the entity.
+ */
+declare function Entity(tableName?: string): ClassDecorator;
+
+/**
+ * The base entity that all db entities need to extend from.
+ */
+declare class BaseEntity {
+    /**
+     * The uuid (universal unique identifier) of the entity.
+     */
+    id: string;
+}
 
 /**
  * Metadata shared by all properties.
@@ -38,6 +68,13 @@ type WithDefaultMetadata<T extends string | number | boolean | Date> = {
     default: T | (<X extends Object>(createData: X) => T | Promise<T>) | undefined;
 };
 
+type Enumerate<N extends number, Acc extends number[] = []> = Acc['length'] extends N ? Acc[number] : Enumerate<N, [...Acc, Acc['length']]>;
+type IntRange<F extends number, T extends number> = Exclude<Enumerate<T>, Enumerate<F>>;
+/**
+ * A number from 0 to 100.
+ */
+type Percentage = IntRange<0, 101>;
+
 type Newable<T> = new (...args: any[]) => T;
 
 type DeepPartial<T> = T | (T extends (infer U)[] ? DeepPartial<U>[] : T extends Map<infer K, infer V> ? Map<DeepPartial<K>, DeepPartial<V>> : T extends Set<infer M> ? Set<DeepPartial<M>> : T extends object ? {
@@ -228,7 +265,7 @@ declare enum HttpStatus {
     UNAUTHORIZED = 401,
     PAYMENT_REQUIRED = 402,
     FORBIDDEN = 403,
-    NOT_FOUND_ERROR = 404,
+    NOT_FOUND = 404,
     METHOD_NOT_ALLOWED = 405,
     NOT_ACCEPTABLE = 406,
     CONFLICT = 409,
@@ -251,6 +288,7 @@ declare enum HttpStatus {
  */
 declare enum MimeType {
     JSON = "application/json",
+    XML = "application/xml",
     HTML = "text/html",
     FORM_DATA = "multipart/form-data",
     OCTET_STREAM = "application/octet-stream",
@@ -358,6 +396,7 @@ declare const mimeTypeToExtension: {
     "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": ".xlsx";
     "application/vnd.openxmlformats-officedocument.wordprocessingml.document": ".docx";
     "text/plain": ".txt";
+    "application/xml": ".xml";
 };
 /**
  * Resolves the mime type of the file at the given path.
@@ -674,12 +713,6 @@ declare namespace Property {
      */
     function manyToMany<T extends BaseEntity>(metadata: ManyToManyPropertyMetadataInput<T>): PropertyDecorator;
 }
-/**
- * The base entity that all db entities need to extend from.
- */
-declare class BaseEntity {
-    id: string;
-}
 /**
  * Creates full metadata for an array property item.
  * @param data - The array item input data.
@@ -689,19 +722,11 @@ declare class BaseEntity {
 declare function createArrayItemPropertyMetadata(data: ArrayPropertyItemMetadataInput, fullPropertyKey: string): ArrayPropertyItemMetadata;
 
 /**
- * Metadata for an Entity.
- */
-type EntityMetadata = {
-    /**
-     * The name of the table in the db.
-     */
-    tableName: string;
-};
-/**
- * Marks an entity.
- * @param tableName - The name of the table to generate for the entity.
+ * Defines a omit class based on the provided class.
+ * @param Base - The base class that should be made into a omit class.
+ * @param keys - The keys that should be omitted.
  */
-declare function Entity(tableName?: string): ClassDecorator;
+declare function OmitClass<T, K extends keyof T>(Base: Newable<T>, keys: readonly K[]): Newable<Omit<T, K>>;
 
 type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
 type IntersectionInstances<T extends Newable<unknown>[]> = UnionToIntersection<InstanceType<T[number]>>;
@@ -709,27 +734,20 @@ type IntersectionInstances<T extends Newable<unknown>[]> = UnionToIntersection<I
  * Defines an combined class based on the provided classes.
  * @param bases - The base classes that should be made into a single combined class.
  */
-declare function CombinedType<Bases extends Newable<unknown>[]>(...bases: Bases): Newable<IntersectionInstances<Bases>>;
+declare function IntersectionClass<Bases extends Newable<unknown>[]>(...bases: Bases): Newable<IntersectionInstances<Bases>>;
 
 /**
  * Defines a partial class based on the provided class.
  * @param Base - The base class that should be made into a partial.
  */
-declare function PartialType<T>(Base: Newable<T>): Newable<Partial<T>>;
+declare function PartialClass<T>(Base: Newable<T>): Newable<Partial<T>>;
 
 /**
  * Defines a pick class based on the provided class.
  * @param Base - The base class that should be made into a pick class.
  * @param keys - The keys that should be picked from the base class.
  */
-declare function PickType<T, K extends keyof T>(Base: Newable<T>, keys: readonly K[]): Newable<Pick<T, K>>;
-
-/**
- * Defines a omit class based on the provided class.
- * @param Base - The base class that should be made into a omit class.
- * @param keys - The keys that should be omitted.
- */
-declare function OmitType<T, K extends keyof T>(Base: Newable<T>, keys: readonly K[]): Newable<Omit<T, K>>;
+declare function PickClass<T, K extends keyof T>(Base: Newable<T>, keys: readonly K[]): Newable<Pick<T, K>>;
 
 /**
  * Definition for a route used eg. By controllers.
@@ -866,6 +884,36 @@ type ArrayParamMetadataInput = Partial<OmitStrict<ArrayParamMetadata, 'type' | '
     items: ArrayParamItemMetadataInput;
 };
 
+/**
+ * Interface for a CRUD (create, read, update, delete) controller.
+ */
+interface CrudControllerInterface<T extends BaseEntity, CreateData extends DeepPartial<T> = DeepPartial<T>, UpdateData extends DeepPartial<T> = DeepPartial<T>> {
+    /**
+     * Creates a new entity with the given data.
+     */
+    create: (data: CreateData) => Promise<T>;
+    /**
+     * Gets paginated data from the given page.
+     */
+    findAll: (page: number, limit: number) => Promise<PaginationResult<T>>;
+    /**
+     * Finds an entity with the given id.
+     */
+    findById: (id: T['id']) => Promise<T>;
+    /**
+     * Updates the entity with the given id by the given data.
+     */
+    updateById: (id: T['id'], data: UpdateData) => Promise<T>;
+    /**
+     * Deletes the entity with the given id.
+     */
+    deleteById: (id: T['id']) => Promise<void>;
+}
+/**
+ * Defines a CRUD controller for the specified entity.
+ */
+declare function CrudController<T extends BaseEntity, CreateData extends DeepPartial<T> = DeepPartial<T>, UpdateData extends DeepPartial<T> = DeepPartial<T>>(entityClass: Newable<T>, createDataClass: Newable<CreateData>, updateDataClass: Newable<UpdateData>): Newable<CrudControllerInterface<T, CreateData, UpdateData>>;
+
 /**
  * Metadata of path parameters.
  */
@@ -1138,6 +1186,8 @@ declare class Router implements RouterInterface {
     private readonly validationService;
     private readonly authService;
     private readonly allowedOrphans;
+    private readonly allBaseRoutes;
+    private readonly allFinalRoutes;
     readonly manuallyRegisteredRoutes: RouteConfiguration<BodyMetadata, Record<string, PathParamMetadata>, Record<string, QueryParamMetadata>, Record<string, HeaderParamMetadata>>[];
     constructor();
     init(app: ZibriApplication): Promise<void>;
@@ -2118,7 +2168,6 @@ declare class DataSourceService implements DataSourceServiceInterface {
     private readonly allowedOrphans;
     constructor();
     init(): Promise<void>;
-    private checkForOrphanedEntities;
 }
 
 /**
@@ -2585,7 +2634,7 @@ declare abstract class Migration {
     protected getEntityMetadata<T extends BaseEntity>(target: EntityTarget<T>, transaction: Transaction): EntityMetadata$1;
 }
 
-type ToColumnMappableTypes = ExcludeStrict<PropertyMetadata, RelationMetadata<BaseEntity> | FilePropertyMetadata>['type'];
+type ToColumnMappableTypes = ExcludeStrict<PropertyMetadata, RelationMetadata<BaseEntity>>['type'];
 /**
  * A base data source definition.
  * Configured for postgres by default.
@@ -2637,12 +2686,10 @@ declare abstract class BaseDataSource {
     /**
      * Transforms the given property metadata to typeorm column options.
      * @param metadata - The property metadata to transform.
-     * @param cls - The entity class.
-     * @param key - The key of the property on the entity class.
      * @returns Typeorm column options.
      * @throws When the metadata is incorrect.
      */
-    protected propertyToColumnOptions(metadata: ExcludeStrict<PropertyMetadata, RelationMetadata<BaseEntity> | FilePropertyMetadata>, cls: Newable<BaseEntity>, key: string): EntitySchemaColumnOptions;
+    protected propertyToColumnOptions(metadata: ExcludeStrict<PropertyMetadata, RelationMetadata<BaseEntity>>): EntitySchemaColumnOptions;
     /**
      * Gets a repository to access the table of the provided entity class.
      * @param cls - The entity class to get the repository for.
@@ -3128,7 +3175,7 @@ declare class AssetService implements AssetServiceInterface {
     readonly pageTemplatePath: string;
     readonly emailTemplatePath: string;
     readonly assetsRoute: Route;
-    constructor();
+    constructor(logger: LoggerInterface);
     attachTo(app: ZibriApplication): Promise<void>;
     private buildFileTree;
     private mapToTree;
@@ -3157,7 +3204,6 @@ declare class MailingListService implements MailingListServiceInterface {
     protected get confirmationTokenRepository(): Repository<MailingListSubscriptionConfirmationToken, MailingListSubscriptionConfirmationTokenCreateData>;
     constructor();
     attachTo(): void;
-    private validate;
     queueEmailForList<T extends BaseMailingListEmailTemplateData>(listId: string, data: MailingListQueueEmailData<T>): Promise<void>;
     requestSubscribeToList<T extends BaseMailingListEmailTemplateData>(listId: string, subscriber: MailingListSubscriberCreateData, emailData: MailingListQueueEmailData<T>): Promise<void>;
     confirmSubscribeToList(confirmationTokenValue: string): Promise<void>;
@@ -3215,7 +3261,7 @@ declare class LoggerTransport<T extends BaseLoggerTransportConfig> {
      */
     static create<X extends BaseLoggerTransportConfig>(config: X, send: LoggerTransportSend<X>): LoggerTransport<X>;
     /**
-     * Creates a new logger transport that prints the log to the console.
+     * Creates a new logger transport that prints the log to the terminal.
      * @param level - The log level at which the transport should be active.
      * @returns The newly created transport.
      */
@@ -3274,7 +3320,7 @@ interface LoggerInterface {
 declare class Logger implements LoggerInterface {
     readonly transports: LoggerTransport<BaseLoggerTransportConfig>[];
     protected readonly cleanupAfterMs: Record<LogLevel, number>;
-    constructor();
+    constructor(transports: LoggerTransport<BaseLoggerTransportConfig>[], cleanupAfterMs: Record<LogLevel, number>);
     attachTo(app: ZibriApplication): void;
     debug(message: string, context?: LogContextInput): Promise<void>;
     info(message: string, context?: LogContextInput): Promise<void>;
@@ -3384,8 +3430,7 @@ declare class JwtConfirmPasswordResetData {
 /**
  * The credentials used by the jwt auth strategy.
  */
-declare class JwtCredentials implements Pick<BaseUser<string>, 'id' | 'email'> {
-    id: string;
+declare class JwtCredentials extends BaseEntity implements Pick<BaseUser<string>, 'id' | 'email'> {
     /**
      * The id of the user that this credentials belong to.
      */
@@ -3460,7 +3505,6 @@ declare class JwtAuthStrategy<RoleType extends string, UserType extends BaseUser
     private get credentialsRepository();
     constructor();
     init(): void;
-    private checkForEntities;
     login(credentials: JwtCredentialsDto): Promise<JwtAuthData<RoleType>>;
     logout(data: JwtRefreshLoginData): Promise<void>;
     private createRefreshToken;
@@ -3617,9 +3661,8 @@ declare class JwtVerifyPasswordResetTokenResponse {
 declare class JwtAuthController implements AuthControllerInterface<JwtCredentialsDto, JwtAuthData<string>, JwtRefreshLoginData, JwtRequestPasswordResetInput, JwtConfirmPasswordResetData> {
     private readonly authService;
     private readonly userService;
-    private readonly refreshTokenRepository;
     private readonly passwordResetTokenRepository;
-    constructor(authService: AuthServiceInterface, userService: UserServiceInterface, refreshTokenRepository: Repository<JwtRefreshToken>, passwordResetTokenRepository: Repository<PasswordResetToken>);
+    constructor(authService: AuthServiceInterface, userService: UserServiceInterface, passwordResetTokenRepository: Repository<PasswordResetToken>);
     login(credentials: JwtCredentialsDto): Promise<JwtAuthData<string>>;
     refreshLogin(data: JwtRefreshLoginData): Promise<JwtAuthData<string>>;
     requestPasswordReset(data: JwtRequestPasswordResetInput): Promise<void>;
@@ -3930,11 +3973,17 @@ declare const ZIBRI_DI_TOKENS: {
     readonly USER_SERVICE: "zi.user_service";
     readonly CRON_SERVICE: "zi.cron_service";
     readonly FILE_UPLOAD_TEMP_FOLDER: "zi.file_upload_temp_folder";
+    readonly LOCALIZE_OPTIONS_INPUT: "zi.localize_options_input";
+    readonly LOCALIZE_OPTIONS: "zi.localize_options";
     readonly FORMAT_DATE: "zi.format_date";
+    readonly FORMAT_PRICE: "zi.format_price";
+    readonly FORMAT_PERCENT: "zi.format_percent";
     readonly EMAIL_SERVICE: "zi.email_service";
     readonly EMAIL_CONFIG: "zi.email_config";
     readonly MAILING_LIST_SERVICE: "zi.mailing_list_service";
     readonly CURRENT_REQUEST: "zi.current_request";
+    readonly MULTITHREADING_SERVICE: "zi.multithreading_service";
+    readonly MULTITHREADING_OPTIONS: "zi.multithreading_options";
 };
 
 /**
@@ -4177,237 +4226,1291 @@ declare class HtmlResponse {
 /**
  * A bundle of providers, controllers, cronJobs, bodyParsers and authStrategies.
  */
-type ZibriPlugin = {
+declare abstract class ZibriPlugin {
     /**
      * The DI providers to register/override.
      */
-    providers?: DiProvider<unknown>[];
+    providers: DiProvider<unknown>[];
     /**
      * The controllers to register in the app.
      */
-    controllers?: Newable<unknown>[];
+    controllers: Newable<unknown>[];
     /**
      * The cron jobs to register in the app.
      */
-    cronJobs?: Newable<CronJob>[];
+    cronJobs: Newable<CronJob>[];
     /**
      * The body parsers to register.
      *
      * If nothing is provided, the Zibri default parsers will be used.
      */
-    bodyParsers?: Newable<BodyParserInterface>[];
+    bodyParsers: Newable<BodyParserInterface>[];
     /**
      * The auth strategies to register.
      *
      * If nothing is provided, the Zibri default jwt auth strategy will be used.
      */
-    authStrategies?: AuthStrategies;
-};
+    authStrategies: AuthStrategies;
+    /**
+     * Validates that the plugin can work correctly. This should check that all entities exist,
+     * all required providers exist etc.
+     *
+     * It's called after the initialization of the app, so that data sources etc. Should all be available.
+     */
+    abstract validate(app: ZibriApplication): void | Promise<void>;
+}
 
 /**
- * All options for a Zibri application.
+ * Plugin that includes everything for handling invoices.
  */
-type ZibriApplicationOptions = {
+declare class ZibriInvoicingPlugin extends ZibriPlugin {
+    private readonly defaultDiProviders;
+    providers: DiProvider<unknown>[];
+    private getProviders;
+    validate(): void;
+}
+
+/**
+ * Contains base information about a company.
+ */
+type CompanyInfo = {
     /**
-     * The name of the app.
+     * The name of the company.
      */
-    name: string;
+    readonly name: string;
     /**
-     * The base url of the app.
-     * Eg. Http://localhost:3000.
+     * The full name of the company, including the company addendum.
      */
-    baseUrl: string;
+    readonly fullName: string;
     /**
-     * The SemVer version of the app.
-     *
-     * Is also used by migrations by default.
+     * The email of the company.
      */
-    version: Version;
+    readonly email: string;
     /**
-     * The controllers to register in the app.
+     * The phone number of the company.
      */
-    controllers: Newable<unknown>[];
+    readonly phone: string;
     /**
-     * The data sources to register in the app.
+     * The tax number.
      */
-    dataSources?: Newable<BaseDataSource>[];
+    readonly taxNumber?: string;
     /**
-     * The DI providers to register/override.
+     * The vat number.
      */
-    providers?: DiProvider<unknown>[];
+    readonly vatNumber?: string;
     /**
-     * The body parsers to register.
-     *
-     * If nothing is provided, the Zibri default parsers will be used.
+     * The ceo of the company to display in the footer.
+     * Can be omitted.
      */
-    bodyParsers?: Newable<BodyParserInterface>[];
+    readonly ceo?: string;
     /**
-     * The auth strategies to register.
-     *
-     * If nothing is provided, the Zibri default jwt auth strategy will be used.
+     * The IBAN of the company.
+     * Can be omitted.
      */
-    authStrategies?: AuthStrategies;
+    readonly iban?: string;
     /**
-     * The cron jobs to register in the app.
+     * The BIC/SWIFT of the company.
+     * Can be omitted.
      */
-    cronJobs?: Newable<CronJob>[];
+    readonly bic?: string;
     /**
-     * The plugins to be used.
+     * The address of the company.
      */
-    plugins?: ZibriPlugin[];
+    readonly address: {
+        /**
+         * The street of the address.
+         */
+        readonly street: string;
+        /**
+         * The number of the address.
+         */
+        readonly number: string;
+        /**
+         * The 5 digit postcode of the address.
+         */
+        readonly postcode: string;
+        /**
+         * The city of the address.
+         */
+        readonly city: string;
+        /**
+         * The ISO 3166-1 country id.
+         */
+        readonly countryId: string;
+    };
 };
 
-type FullZibriApplicationOptions = Required<OmitStrict<ZibriApplicationOptions, 'plugins'>>;
 /**
- * A Zibri application.
+ * Complete definition of a PDF document.
  */
-declare class ZibriApplication {
-    private readonly providedOptions;
-    /**
-     * The internal express app.
-     */
-    private readonly express;
-    private _router;
-    /**
-     * The router used by the application.
-     */
-    get router(): RouterInterface;
-    private logger;
-    private metricsService;
-    private assetService;
-    private openApiService;
-    private parser;
-    private dataSourceService;
-    private authService;
-    private cronService;
-    private emailService;
-    private mailingListService?;
-    /**
-     * The options of which the application was build.
-     */
-    readonly options: FullZibriApplicationOptions;
-    constructor(providedOptions: ZibriApplicationOptions);
-    use(handler: RequestHandler): express.Express;
-    use(...handlers: RequestHandler[]): void;
-    use(path: Route, ...handlers: RequestHandler[]): void;
-    use(path: Route, handlers: RequestHandler[]): void;
-    /**
-     * Initializes the app.
-     * @param H - The global handlebars instance, needed to provide some helpers used in templating.
-     */
-    init(H: typeof Handlebars): Promise<void>;
+type PdfDocumentDefinition = TDocumentDefinitions & {
     /**
-     * Starts on the given port.
-     * @param port - The port to start on.
-     * @throws When the app has already been started.
+     * Attachments of the pdf file.
      */
-    start(port: number): Promise<void>;
-    private createFullOptions;
-}
-
-/**
- * A global error handler function.
- */
-type GlobalErrorHandler = (err: unknown, req: HttpRequest, res: HttpResponse, next: NextFunction) => void | Promise<void>;
-
-/**
- * The default error handler implementation of Zibri.
- * @param error - The error that was caught.
- * @param req - The http request.
- * @param res - The http response.
- * @param next - The express next function.
- */
-declare const errorHandler: GlobalErrorHandler;
-
+    attachments: PdfAttachmentDefinition[];
+};
 /**
- * A base http error.
+ * Definition for an attachment of a pdf file.
  */
-declare abstract class HttpError extends Error {
-    /**
-     * The status of the error.
-     */
-    status: HttpStatus;
+type PdfAttachmentDefinition = {
     /**
-     * The title of the error.
+     * The file content of the attachment. A string value is interpreted as a file path.
      */
-    title: string;
+    src: string | ArrayBuffer | Buffer<ArrayBufferLike>;
     /**
-     * A paragraphs error with the error message.
+     * Metadata about the attachment.
      */
-    paragraphs: string[];
-    constructor(message: string | string[], status: HttpStatus, title: string, options?: ErrorOptions);
-}
+    options: PDFKit.Mixins.PDFAttachmentOptions & Required<Pick<PDFKit.Mixins.PDFAttachmentOptions, 'name'>>;
+};
 /**
- * Check whether or not the given value is a http error.
- * @param value - The value to check.
- * @returns True when value is an instance of HttpError, false otherwise.
+ * Definition of an image to be embedded into the document.
  */
-declare function isHttpError(value: unknown): value is HttpError;
-
+type PdfImageDefinition = ImageDefinition;
 /**
- * An error to throw when something unexpected happened inside the server.
+ * Common type for all available pdf content elements.
  */
-declare class InternalServerError extends HttpError {
-    constructor(message: string | string[], options?: ErrorOptions);
-}
-
+type PdfContentDefinition = Content;
 /**
- * An error to throw when the requested resource could not be found.
- *
- * In contrast to the UnmatchedRouteError, this should be thrown when the endpoint actually exists (eg. /items/:id), but the resource was not found.
- * Eg. Because the id of the item is incorrect.
+ * Definition of a pdf column.
  */
-declare class NotFoundError extends HttpError {
-    constructor(message: string | string[], options?: ErrorOptions);
-}
-
+type PdfColumnDefinition = Column;
 /**
- * An error to throw when a route requested by a user does not exist at all.
- *
- * In contrast to NotFoundError, this should only be thrown the route itself does not exist at all.
- * Eg. /does-not-exist and not when the route itself (eg. Items/:id) exists, but it could not find a value for eg. /items/42.
+ * Definition of a pdf table cell.
  */
-declare class UnmatchedRouteError extends NotFoundError {
-    constructor(originalUrl: string, options?: ErrorOptions);
-}
+type PdfTableCellDefinition = Content;
+/**
+ * A created pdf document.
+ */
+type PdfDocument = PDFKit.PDFDocument;
 
 /**
- * An error to throw when the user send some invalid data to the server.
+ * Represents a wrapper around XML nodes to implement easy to use and chainable document builder methods.
  */
-declare class BadRequestError extends HttpError {
-    constructor(message: string | string[], options?: ErrorOptions);
-}
+type XML = XMLBuilder;
 
 /**
- * A validation problem, consisting of the key where the problem is located and a description of the problem.
+ * Options used throughout the plugin.
  */
-type ValidationProblem = {
+type InvoicingOptions = {
     /**
-     * The key where the problem is located.
+     * The font size that should be used for the footer.
+     * @default 10
      */
-    key: string;
+    readonly footerFontSize: number;
     /**
-     * The validation problem message.
+     * Globally defined images which can be referenced by name inside the document definition.
+     * @default undefined
      */
-    message: string;
-};
-/**
- * The validation problem that the property is required and no value has been provided.
- */
-declare class IsRequiredValidationProblem implements ValidationProblem {
-    readonly key: string;
-    readonly message: string;
-    constructor(key: string);
-}
-/**
- * The validation problem that the provided value has an incorrect type.
- */
-declare class TypeMismatchValidationProblem implements ValidationProblem {
-    readonly key: string;
-    readonly message: string;
-    constructor(key: string, type: string);
-}
-/**
+    readonly images: Record<string, PdfImageDefinition> | undefined;
+    /**
+     * Available options:
+     *
+     * - A reference by name to an image defined in PdfMakeDocumentDefinition.images
+     * - A data URL
+     * - A remote URL via http:// or https://.
+     *
+     * Supported image formats: JPEG, PNG.
+     * @default undefined
+     */
+    readonly logo: string | undefined;
+    /**
+     * The label for the phone number on the invoice.
+     * @default 'Phone'
+     */
+    readonly phoneLabel: string;
+    /**
+     * The label for the email on the invoice.
+     * @default 'E-Mail'
+     */
+    readonly emailLabel: string;
+    /**
+     * The headline of the invoice.
+     * @default 'Invoice'
+     */
+    readonly headline: string;
+    /**
+     * The font size of the headline.
+     * @default 20
+     */
+    readonly headlineFontSize: number;
+    /**
+     * The label for the invoice number on the invoice.
+     * @default 'Invoice No.'
+     */
+    readonly invoiceNumberLabel: string;
+    /**
+     * The notice below the invoice number.
+     * @default 'Please specify when making payments and invoicing!'
+     */
+    readonly invoiceNumberNotice: string;
+    /**
+     * The label for the date on the invoice.
+     * @default 'Date'
+     */
+    readonly dateLabel: string;
+    /**
+     * The label for the date of performance on the invoice.
+     * @default 'Date of performance'
+     */
+    readonly performanceDateLabel: string;
+    /**
+     * Whether or not a performance date should be displayed on the invoice.
+     * @default false
+     */
+    readonly showPerformanceDate: boolean;
+    /**
+     * Whether or not a due date should be displayed on the invoice.
+     * @default true
+     */
+    readonly showDueDate: boolean;
+    /**
+     * The label for the due date on the invoice.
+     * @default 'Due date'
+     */
+    readonly dueDateLabel: string;
+    /**
+     * The font size that should be used inside the tables.
+     * @default 12
+     */
+    readonly tableFontSize: number;
+    /**
+     * The label for item name on the invoice.
+     * @default 'Name'
+     */
+    readonly itemNameLabel: string;
+    /**
+     * The label for the total when no taxes exist on the invoice.
+     * @default 'Total'
+     */
+    readonly totalLabel: string;
+    /**
+     * The label for the total before tax value on the invoice.
+     * @default 'Total (excl. tax)'
+     */
+    readonly totalBeforeTaxLabel: string;
+    /**
+     * The label for the total after tax value on the invoice.
+     * @default 'Total (incl. tax)'
+     */
+    readonly totalAfterTaxLabel: string;
+    /**
+     * The label for tax value on the invoice.
+     * @default 'VAT'
+     */
+    readonly taxLabel: string;
+    /**
+     * The label for tax number on the invoice.
+     * @default 'Tax number:'
+     */
+    readonly taxNumberLabel: string;
+    /**
+     * The label for the ceo on the invoice.
+     * @default 'CEO:'
+     */
+    readonly ceoLabel: string;
+    /**
+     * The label for item amount on the invoice.
+     * @default 'Amount'
+     */
+    readonly itemAmountLabel: string;
+    /**
+     * The label for single price of an item on the invoice.
+     * @default 'Price'
+     */
+    readonly itemSinglePriceLabel: string;
+    /**
+     * The label for total price of an item on the invoice.
+     * @default 'Total'
+     */
+    readonly itemTotalPriceLabel: string;
+    /**
+     * The tax office to display in the footer.
+     * Can be omitted.
+     */
+    readonly taxOffice: string | undefined;
+    /**
+     * The label for the bank details in the footer.
+     * @default 'Bank details:'
+     */
+    readonly bankDetailsLabel: string;
+    /**
+     * The label for the iban to display in the footer.
+     * @default 'IBAN:'
+     */
+    readonly ibanLabel: string;
+    /**
+     * The label for the bic to display in the footer.
+     * @default 'BIC/SWIFT:'
+     */
+    readonly bicLabel: string;
+    /**
+     * The bank name to display in the footer.
+     * Can be omitted.
+     */
+    readonly bankName: string | undefined;
+    /**
+     * The information about the company sending out the invoice.
+     */
+    readonly companyInfo: CompanyInfo;
+    /**
+     * The number of digits used to generate the consecutive number.
+     * @default 4
+     */
+    readonly numberOfDigits: number;
+    /**
+     * The separator for the parts of the invoice number.
+     * @default '-'
+     */
+    readonly separator: string;
+    /**
+     * How many characters of the company name should be used in the invoice number.
+     * @default 6
+     */
+    readonly numberCompanyAbbreviationCharacters: number;
+    /**
+     * How many characters of the private customer first and last name should be used in the invoice number.
+     * @default 3
+     */
+    readonly numberPrivateCustomerAbbreviationCharacters: number;
+};
+
+/**
+ * The invoice address, which can be either a private or a company address.
+ */
+declare class InvoiceAddress {
+    /**
+     * The form of address of the customer.
+     */
+    formOfAddress: string;
+    /**
+     * The first name of the customer.
+     */
+    firstName: string;
+    /**
+     * The last name of the customer.
+     */
+    lastName: string;
+    /**
+     * The email of the customer.
+     * This does NOT have to be the same email where the invoice is sent.
+     * It is required for factur-x or x-rechnung compliant invoices.
+     */
+    email?: string;
+    /**
+     * The street of the address.
+     */
+    street: string;
+    /**
+     * The number of the address.
+     */
+    number: string;
+    /**
+     * The postcode of the address.
+     */
+    postcode: string;
+    /**
+     * The city of the address.
+     */
+    city: string;
+    /**
+     * The country id of the address.
+     * Eg. 'US'.
+     */
+    countryId: string;
+    /**
+     * Whether or not the address is of a company.
+     */
+    company: boolean;
+    /**
+     * The name of the company.
+     */
+    companyName?: string;
+}
+
+/**
+ * Information about the unit of the amount value.
+ * Consists of a display name like "Hours" and a code like "HUR".
+ */
+declare class AmountUnit {
+    /**
+     * The display name for invoices.
+     */
+    displayName: string;
+    /**
+     * The common code for the unit, based on rec20
+     * https://unece.org/trade/uncefact/cl-recommendations.
+     * Used for x-rechnung.
+     */
+    code: string;
+}
+
+/**
+ * Contains the information about how many invoices have been created in a specific year.
+ */
+declare class NumberInvoices extends BaseEntity {
+    /**
+     * The id of the recipient of the invoice.
+     */
+    recipientId: string;
+    /**
+     * The amount of invoices of that year.
+     */
+    number: number;
+    /**
+     * The year for which this entity hold the amount of invoices.
+     */
+    year: number;
+}
+
+/**
+ * S = standard rate
+ * Z = zero rated
+ * E = tax-exempt
+ * AE = VAT reverse charge
+ * K = VAT exempt for EEA intra-community supply of goods and services
+ * G = Free export item, tax not charged
+ * O = Services outside scope of tax
+ * L = Canary Islands general indirect tax
+ * M = Tax for production, services and importation in Ceuta and Melilla.
+ */
+type VatCategoryCode = 'S' | 'Z' | 'E' | 'AE' | 'K' | 'G' | 'O' | 'L' | 'M';
+/**
+ * Contains tax information.
+ * Consists of the tax rate in percent and a Category Code used for x-rechnung.
+ */
+declare class Vat {
+    /**
+     * The tax rate in percent.
+     */
+    rate: number;
+    /**
+     * The category code used for x-rechnung.
+     */
+    categoryCode: VatCategoryCode | string & {};
+    /**
+     * A description for why this is tax exempt.
+     * Is required when categoryCode is set to 'E'.
+     */
+    exemptionReason?: string;
+}
+
+/**
+ * Contains information about a single item of an invoice.
+ */
+declare class InvoiceItem {
+    /**
+     * The name of the item.
+     */
+    name: string;
+    /**
+     * The amount of the item.
+     */
+    amount: number;
+    /**
+     * The unit, eg. Pieces or meter.
+     * Is either a free string or an object containing a display name and a code.
+     * (This is required for factur-x/x-rechnung conformance).
+     */
+    amountUnit: AmountUnit;
+    /**
+     * The tax on the item.
+     * Is either a percentage number (eg. 20 means 20%) or an object containing a percentage number and a code.
+     * (This is required for factur-x/x-rechnung conformance).
+     */
+    vat: Vat;
+    /**
+     * The price of the item.
+     */
+    price: number;
+}
+
+/**
+ * Codes for the different currencies of the world.
+ * Is loosely typed to support custom string values.
+ */
+type CurrencyCode = 'USD' | 'EUR' | string & {};
+
+/**
+ * Codes for the different languages of the world.
+ * Is loosely typed to support custom string values.
+ */
+type LanguageCode = 'de' | 'en' | string & {};
+
+/**
+ * The options for handling localization, eg. In date or currency formatting.
+ */
+type LocalizeOptions = {
+    /**
+     * The language code to use by default.
+     */
+    readonly language: LanguageCode;
+    /**
+     * The currency code to use by default.
+     */
+    readonly currency: CurrencyCode;
+};
+/**
+ * Input for modifying the localize options.
+ */
+type LocalizeOptionsInput = Partial<LocalizeOptions>;
+
+/**
+ * Function for formatting dates.
+ */
+type FormatDateFn = (date: Date, includeTime?: boolean, language?: LanguageCode) => string;
+
+/**
+ * Function for formatting percentages.
+ */
+type FormatPercentFn = (percentage: number) => string;
+
+/**
+ * Numbers with increased precision. (No rounding errors).
+ */
+type BigNumber = BigNumberJs;
+/**
+ * Provides functionality around calculating with high precision.
+ */
+declare abstract class BigNumberUtilities {
+    /**
+     * Creates a BigNumber from the provided input.
+     * @param value - The number value to create from.
+     * @returns A new BigNumber.
+     */
+    static new(value: number): BigNumber;
+    /**
+     * Precisely multiplies the given values.
+     * @param value1 - The first number to multiply.
+     * @param value2 - The second number to multiply.
+     * @returns The precise result as BigNumber.
+     */
+    static multiply(value1: number | BigNumber, value2: number | BigNumber): BigNumber;
+    /**
+     * Precisely divides the first value by the second value.
+     * @param dividend - The value that will be divided.
+     * @param divisor - The value that divides the first value.
+     * @returns The precise result as BigNumber.
+     */
+    static divide(dividend: number | BigNumber, divisor: number | BigNumber): BigNumber;
+    /**
+     * Precisely adds the given values.
+     * @param value1 - The first number for the addition.
+     * @param value2 - The second number for the addition.
+     * @returns The precise result as BigNumber.
+     */
+    static add(value1: number | BigNumber, value2: number | BigNumber): BigNumber;
+}
+
+/**
+ * Options for chunking.
+ */
+type ChunkingOptions = {
+    /**
+     * The size of a single chunk.
+     */
+    chunkSize: number;
+};
+/**
+ * Like Promise.all, but chunked.
+ * @param promises - The promises to resolve.
+ * @param options - Options for chunking, like the size of chunks etc.
+ * @returns The resolved promises after all chunks have been resolved.
+ */
+declare function chunkedPromiseAll<T>(promises: Promise<T>[], options?: ChunkingOptions): Promise<T[]>;
+
+/**
+ * Compares the given versions and check if the first one is bigger, equal or smaller than the second one.
+ * @param v1 - The first version.
+ * @param v2 - The second version to compare against.
+ * @returns 'bigger', 'equal' or 'smaller'.
+ */
+declare function compareVersion(v1: Version, v2: Version): 'bigger' | 'equal' | 'smaller';
+
+/**
+ * Checks whether the given value is a valid SemVer Version.
+ * @param value - The value to check.
+ */
+declare function isVersion(value: string): value is Version;
+
+declare abstract class Ms {
+    /**
+     * The amount of ms in a second.
+     */
+    static SECOND: 1000;
+    /**
+     * The amount of ms in a minute.
+     */
+    static MINUTE: 60000;
+    /**
+     * The amount of ms in an hour.
+     */
+    static HOUR: 3600000;
+    /**
+     * The amount of ms in a day.
+     */
+    static DAY: 86400000;
+    /**
+     * The amount of ms in a week.
+     */
+    static WEEK: 604800000;
+}
+
+/**
+ * Validates that the given entities are registered in a data source somewhere.
+ * @param context - The name of the class where this function was called. Is needed to provide information about who expects the entities to exist.
+ * @param entities - The entities that should be validated to be registered.
+ * @throws When one of the entities is not registered in a data source.
+ */
+declare function validateEntitiesRegistered(context: string, ...entities: Newable<BaseEntity>[]): void;
+
+/**
+ * Utilities for dealing with uuid.
+ */
+declare abstract class UUIDUtilities {
+    /**
+     * Generate a new uuid.
+     * @returns A v4 uuid string.
+     */
+    static generate(): string;
+}
+
+/**
+ * Function for formatting prices.
+ */
+type FormatPriceFn = (price: number | BigNumber, currency?: CurrencyCode, language?: LanguageCode) => string;
+
+/**
+ * Contains information about an invoice.
+ */
+declare class Invoice extends BaseEntity {
+    /**
+     * The unique invoice number for this invoice.
+     */
+    number: string;
+    /**
+     * The actual content of the invoice.
+     */
+    items: InvoiceItem[];
+    /**
+     * The date at which the invoice was created.
+     * Defaults to now.
+     */
+    date: Date;
+    /**
+     * The date at which the invoice items were/will be done.
+     */
+    performanceDate: Date;
+    /**
+     * The date at which the invoice has to be paid.
+     */
+    dueDate: Date;
+    /**
+     * The address data to which the invoice gets sent.
+     * Contains information about the customer and the actual address.
+     */
+    customerAddressData: InvoiceAddress;
+    /**
+     * The text that is displayed before the invoice items.
+     * Is an array of strings that represent paragraphs.
+     */
+    textBeforeItems: string[];
+    /**
+     * The text that is displayed after the invoice items.
+     * Is an array of strings that represent paragraphs.
+     */
+    textAfterItems: string[];
+    /**
+     * The currency code of the invoice.
+     */
+    currency: CurrencyCode;
+}
+
+/**
+ * Input for creating invoicing options.
+ */
+type InvoicingOptionsInput = Partial<InvoicingOptions> & Pick<InvoicingOptions, 'companyInfo'>;
+
+/**
+ * Handles generating unique and consecutive numbers for invoices.
+ */
+interface InvoiceNumberServiceInterface<AddressData extends InvoiceAddress> {
+    /**
+     * Generates a new invoice number.
+     * @param recipientId - The id of the recipient of the invoice.
+     * @param invoiceAddress - The address data of the recipient of the invoice.
+     * @param transaction - An optional transaction from outside to make sure any changes only apply when the transaction is committed.
+     * @param nameAbbreviation - An optional name abbreviation if you don't want to generate one.
+     * @returns A promise of the new invoice number.
+     */
+    generateInvoiceNumber: (recipientId: string, invoiceAddress: AddressData, transaction?: Transaction, nameAbbreviation?: string) => string | Promise<string>;
+    /**
+     * Generates a temporary invoice number with the prefix "TEMP".
+     * This does not increase the number of invoices which can be helpful if you create an invoice that might not be sent out.
+     * @param recipientId - The id of the recipient of the invoice.
+     * @param invoiceAddress - The address data of the customer.
+     * @param nameAbbreviation - An optional name abbreviation if you don't want to generate one.
+     * @returns A promise of the new temporary invoice number.
+     */
+    generateTemporaryInvoiceNumber: (recipientId: string, invoiceAddress: InvoiceAddress, nameAbbreviation?: string) => string | Promise<string>;
+}
+
+/**
+ * Default implementation of the invoice number service.
+ */
+declare class InvoiceNumberService implements InvoiceNumberServiceInterface<InvoiceAddress> {
+    private readonly invoiceRepository;
+    private readonly numberInvoicesRepository;
+    protected readonly options: InvoicingOptions;
+    constructor(invoiceRepository: Repository<Invoice>, numberInvoicesRepository: Repository<NumberInvoices, OmitStrict<NumberInvoices, 'id'>, OmitStrict<NumberInvoices, 'id'>>, options: InvoicingOptions);
+    generateInvoiceNumber(recipientId: string, invoiceAddress: InvoiceAddress, transaction: Transaction | undefined, nameAbbreviation?: string): Promise<string>;
+    generateTemporaryInvoiceNumber(recipientId: string, invoiceAddress: InvoiceAddress, nameAbbreviation?: string): Promise<string>;
+    /**
+     * Gets the temporary consecutive number of the invoices in this year and for the provided recipientId.
+     * Prefixes it with zeroes until the result has the same length as this.options.numberOfDigits.
+     * @param recipientId - The id of the recipient of the invoice.
+     * @returns The number of invoices over a year filled up with zeroes to match this.options.numberOfDigits.
+     */
+    protected getTemporaryConsecutiveNumber(recipientId: string): Promise<string>;
+    /**
+     * Gets the consecutive number of the invoices in this year.
+     * Prefixes it with zeroes until the result has the same length as this.options.numberOfDigits.
+     * @param recipientId - The id of the recipient of the invoice.
+     * @param transaction - An optional transaction from outside to make sure any changes only apply when the transaction is committed.
+     * @returns The number of invoices over a year filled up with zeroes to match this.options.numberOfDigits.
+     */
+    protected getConsecutiveNumber(recipientId: string, transaction: Transaction | undefined): Promise<string>;
+    /**
+     * Gets the customer name abbreviation.
+     * @param invoiceAddress - The address data to get the name abbreviation from.
+     * @returns The first char of first and last name for private customers
+     * and the first two chars of the company name for company customers.
+     */
+    protected getCustomerNameAbbreviation(invoiceAddress: InvoiceAddress): string;
+    private getPrivateCustomerAbbreviation;
+    private getCompanyNameAbbreviation;
+    /**
+     * Validates the given invoice number.
+     * @param invoiceNumber - The invoice number to validate.
+     */
+    protected validateInvoiceNumber(invoiceNumber: string): Promise<void>;
+}
+
+/**
+ * Defines the different conformance types.
+ * Is loosely typed so that a custom string can be provided.
+ */
+type InvoiceConformance = 'x-rechnung' | 'peppol' | string & {};
+/**
+ * Interface for a service that handles updating an invoice pdf in a way that it conforms to a certain standard like X-Rechnung.
+ */
+interface InvoiceConformanceServiceInterface<Invoice extends Invoice> {
+    /**
+     * The name of the conformance that is handled by this service.
+     */
+    readonly name: InvoiceConformance;
+    /**
+     * Updates the given pdf document definition.
+     */
+    updateDocumentDefinition: (invoice: Invoice, definition: PdfDocumentDefinition) => void | Promise<void>;
+    /**
+     * Updates the given finished pdf document.
+     */
+    updateDocument: (doc: PdfDocument) => void | Promise<void>;
+}
+
+/**
+ * Handles calculating anything regarding invoices.
+ */
+interface InvoiceCalcServiceInterface<Invoice extends Invoice> {
+    /**
+     * Gets the total price of an item before tax.
+     * @param item - The invoice item to get the price from.
+     * @returns The amount of the item times its price.
+     */
+    getItemTotalPriceBeforeTax: (item: InvoiceItem) => BigNumber | Promise<BigNumber>;
+    /**
+     * Gets the total price of an item after tax.
+     * @param item - The invoice item to get the price from.
+     * @returns The total price before tax times 1 + tax/100.
+     */
+    getItemTotalPriceAfterTax: (item: InvoiceItem) => BigNumber | Promise<BigNumber>;
+    /**
+     * Gets the total tax for the given item.
+     * @param item - The item to get the total tax from.
+     * @returns The total price before tax times tax/100.
+     */
+    getItemTotalTax: (item: InvoiceItem) => BigNumber | Promise<BigNumber>;
+    /**
+     * Gets the total price of an invoice before tax.
+     * @param invoice - The invoice to get the price from.
+     * @returns The addition of the total price before tax of all items in the invoice. If this would be negative this returns 0.
+     */
+    getTotalBeforeTax: (invoice: Invoice) => BigNumber | Promise<BigNumber>;
+    /**
+     * Gets the total price of an invoice after tax.
+     * @param invoice - The invoice to get the price from.
+     * @returns The addition of the total price before tax and the total tax of the invoice.
+     */
+    getTotalAfterTax: (invoice: Invoice) => BigNumber | Promise<BigNumber>;
+    /**
+     * Gets the total tax of the invoice.
+     * @param invoice - The invoice to get the total tax from.
+     * @returns The addition of the tax of all items of the invoice.
+     */
+    getTotalTax: (invoice: Invoice) => BigNumber | Promise<BigNumber>;
+    /**
+     * Gets the total tax for a specific tax group (eg. 19%).
+     * @param invoice - The invoice to get the total tax from.
+     * @param group - The tax group for which the total tax should be calculated.
+     * @param groupOnlyByRate - Whether or not VAT groups are only determined by rate and not by category code.
+     * @returns The addition of the tax of all items that are in the provided tax group.
+     */
+    getTotalTaxForTaxGroup: (invoice: Invoice, group: Vat, groupOnlyByRate: boolean) => BigNumber | Promise<BigNumber>;
+    /**
+     * Gets the total price of an invoice before tax.
+     * @param invoice - The invoice to get the price from.
+     * @param group - The tax group to get the total before from.
+     * @param groupOnlyByRate - Whether or not VAT groups are only determined by rate and not by category code.
+     * @returns The addition of the total price before tax of all items in the invoice. If this would be negative this returns 0.
+     */
+    getTotalBeforeTaxForTaxGroup: (invoice: Invoice, group: Vat, groupOnlyByRate: boolean) => BigNumber | Promise<BigNumber>;
+}
+
+/**
+ * The different possible document context ids.
+ */
+type EN16931DocumentContextId = 'urn:cen.eu:en16931:2017#compliant#urn:xrechnung:3.0' | 'urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0';
+/**
+ * Base service shared by all the specific standards that conform to EN16931.
+ */
+declare abstract class EN16931ConformanceService implements InvoiceConformanceServiceInterface<Invoice> {
+    protected readonly options: InvoicingOptions;
+    private readonly invoiceCalcService;
+    abstract readonly name: InvoiceConformance;
+    abstract readonly documentContextId: EN16931DocumentContextId;
+    constructor(options: InvoicingOptions, invoiceCalcService: InvoiceCalcServiceInterface<Invoice>);
+    updateDocumentDefinition(invoice: Invoice, definition: PdfDocumentDefinition): Promise<void>;
+    updateDocument(doc: PdfDocument): void;
+    generateXml(invoice: Invoice): Promise<XML>;
+    private createCrossIndustryInvoiceXml;
+    private buildBuyerParty;
+    private buildSellerParty;
+    private buildTradeLineItems;
+    private getCustomerName;
+    private dateTo102;
+    /**
+     * Gets all relevant tax groups for the xml file.
+     * @param invoice - The invoice to get the tax groups for.
+     * @returns The tax groups for the xml.
+     */
+    protected getTaxGroups(invoice: Invoice): Vat[];
+}
+
+/**
+ * Handles conforming to the X-Rechnung standard.
+ */
+declare class XRechnungConformanceService extends EN16931ConformanceService {
+    readonly name: InvoiceConformance;
+    readonly documentContextId: EN16931DocumentContextId;
+}
+
+/**
+ * Handles conforming to the peppol standard.
+ */
+declare class PeppolConformanceService extends EN16931ConformanceService {
+    readonly name: InvoiceConformance;
+    readonly documentContextId: EN16931DocumentContextId;
+}
+
+/**
+ * Handles generating pdf invoice files.
+ */
+interface InvoicePdfServiceInterface<Invoice extends Invoice> {
+    /**
+     * Creates a pdf for the provided invoice.
+     * @param invoice - The invoice to create the pdf for.
+     */
+    generateInvoicePdf: (invoice: Invoice, conformance: InvoiceConformance, ...args: any[]) => PdfDocument | Promise<PdfDocument>;
+}
+
+/**
+ * Default implementation of the invoice pdf service.
+ */
+declare class InvoicePdfService implements InvoicePdfServiceInterface<Invoice> {
+    protected readonly options: InvoicingOptions;
+    private readonly invoiceCalcService;
+    private readonly invoiceConformanceServices;
+    private readonly formatDate;
+    private readonly formatPrice;
+    private readonly formatPercent;
+    /**
+     * The definition of the header of the pdf.
+     */
+    protected readonly header: PdfContentDefinition;
+    /**
+     * The definition of the footer of the pdf.
+     */
+    protected readonly footer: PdfContentDefinition;
+    /**
+     * The definition of the column in the letterhead that displays the information about the company that is sending out the invoice.
+     */
+    protected readonly companyLetterheadColumn: PdfColumnDefinition;
+    constructor(options: InvoicingOptions, invoiceCalcService: InvoiceCalcServiceInterface<Invoice>, invoiceConformanceServices: InvoiceConformanceServiceInterface<Invoice>[], formatDate: FormatDateFn, formatPrice: FormatPriceFn, formatPercent: FormatPercentFn);
+    generateInvoicePdf(invoice: Invoice, conformance?: InvoiceConformance): Promise<PdfDocument>;
+    /**
+     * Generates a pdf document definition for the given invoice.
+     * @param invoice - The invoice to generate the document definition for.
+     * @param conformance - The legal conformance that the invoice should conform to.
+     * @returns The invoice document definition.
+     */
+    protected generateInvoiceDocumentDefinition(invoice: Invoice, conformance: InvoiceConformance | undefined): Promise<PdfDocumentDefinition>;
+    /**
+     * Gets the conformance service for the given name.
+     * @param conformance - The name of the conformance to get the service for.
+     * @returns The found conformance service.
+     * @throws When no conformance service has been found.
+     */
+    protected getConformanceService(conformance: InvoiceConformance): InvoiceConformanceServiceInterface<Invoice>;
+    /**
+     * Gets the table that displays the total price of all items.
+     * @param invoice - The invoice to get the table from.
+     * @param taxGroups - The different tax groups that need to be taken into consideration.
+     * @returns The total price of all items and the tax groups.
+     */
+    protected getTotalTable(invoice: Invoice, taxGroups: Vat[]): Promise<PdfContentDefinition>;
+    /**
+     * Gets the body of the total table.
+     * @param invoice - The invoice to build the body from.
+     * @param taxGroups - The different tax groups that need to be taken into consideration.
+     * @returns The body of the total table.
+     */
+    protected getTotalBody(invoice: Invoice, taxGroups: Vat[]): Promise<PdfTableCellDefinition[][]>;
+    /**
+     * Gets the table that displays all invoice items.
+     * @param invoice - The invoice to build the table from.
+     * @param taxGroups - The different tax groups that need to be taken into consideration.
+     * @returns The table with all invoice items.
+     */
+    protected getInvoiceItemsTable(invoice: Invoice, taxGroups: Vat[]): Promise<PdfContentDefinition>;
+    /**
+     * Gets the body of the invoice items table.
+     * @param invoice - The invoice to build the body from.
+     * @param taxGroups - The different tax groups that need to be taken into consideration.
+     * @returns The body of the invoice items table.
+     */
+    protected getInvoiceItemsBody(invoice: Invoice, taxGroups: Vat[]): Promise<PdfTableCellDefinition[][]>;
+    /**
+     * Gets the headers for the invoice items table. If the only tax group is 0, the tax column is removed.
+     * @param taxGroups - The different tax groups that need to be taken into consideration.
+     * @returns The headers of the invoice items table.
+     */
+    protected getInvoiceItemsHeaders(taxGroups: Vat[]): PdfTableCellDefinition[];
+    /**
+     * Gets the text that should be displayed before the actual invoice items start.
+     * @param paragraphs - The paragraphs to get the text from.
+     * @returns The text that should be displayed before the actual invoice items.
+     */
+    protected getContentFromParagraphs(paragraphs: string[]): PdfContentDefinition[];
+    /**
+     * Gets the invoice number and the dates.
+     * @param invoice - The invoice to build the content from.
+     * @returns The content containing the invoice number and the date, performance date and due date.
+     */
+    protected getNumberAndDates(invoice: Invoice): PdfContentDefinition;
+    /**
+     * Gets the letterhead.
+     * @param invoice - The invoice to get the letterhead from.
+     * @returns The letterhead of the customer and the company.
+     */
+    protected getLetterhead(invoice: Invoice): PdfContentDefinition;
+    /**
+     * Gets the letterhead of the customer.
+     * @param invoice - The invoice to get the customer letterhead from.
+     * @returns The letterhead of the customer, containing the name and address.
+     */
+    protected getCustomerLetterheadColumn(invoice: Invoice): PdfColumnDefinition;
+    private getCustomerName;
+    /**
+     * Gets the font size for the provided company address line.
+     * Checks if the address line is too big and makes the font smaller accordingly.
+     * @param companyAddressLine - The company address line of the invoice.
+     * @returns The font size to use for the letter head.
+     */
+    protected getFontSizeForLetterhead(companyAddressLine: string): number;
+    /**
+     * Gets the letterhead of the company.
+     * @returns The letterhead of the company, containing full name, address and contact information.
+     */
+    protected getCompanyLetterheadColumn(): PdfColumnDefinition;
+    /**
+     * Gets all relevant tax groups for the pdf file.
+     * @param invoice - The invoice to get the tax groups for.
+     * @returns The tax groups for the pdf.
+     */
+    protected getTaxGroups(invoice: Invoice): Vat[];
+    /**
+     * Gets the Content of the header.
+     * @returns A row with the logo or an empty array if no logo has been specified.
+     */
+    protected getHeader(): PdfContentDefinition;
+    /**
+     * Gets the Content of the footer.
+     * @returns Multiple rows containing information about the company and payment data.
+     */
+    protected getFooter(): PdfContentDefinition;
+    /**
+     * Gets the first column of the footer.
+     * @returns The column definition.
+     */
+    protected getFirstFooterColumn(): PdfColumnDefinition;
+    /**
+     * Gets the second column of the footer.
+     * @returns The column definition.
+     */
+    protected getSecondFooterColumn(): PdfColumnDefinition;
+}
+
+/**
+ * Default implementation of the invoice calculation service.
+ */
+declare class InvoiceCalcService implements InvoiceCalcServiceInterface<Invoice> {
+    getItemTotalPriceBeforeTax(item: InvoiceItem): BigNumber;
+    getItemTotalPriceAfterTax(item: InvoiceItem): BigNumber;
+    getItemTotalTax(item: InvoiceItem): BigNumber;
+    getTotalBeforeTax<Invoice extends Invoice>(invoice: Invoice): BigNumber;
+    getTotalAfterTax<Invoice extends Invoice>(invoice: Invoice): BigNumber;
+    getTotalTax<Invoice extends Invoice>(invoice: Invoice): BigNumber;
+    getTotalTaxForTaxGroup<Invoice extends Invoice>(invoice: Invoice, group: Vat, groupOnlyByRate: boolean): BigNumber;
+    getTotalBeforeTaxForTaxGroup<Invoice extends Invoice>(invoice: Invoice, group: Vat, groupOnlyByRate: boolean): BigNumber;
+    private getItemsForTaxGroup;
+}
+
+/**
+ * The dependency injection tokens used by the ZibriInvoicingPlugin.
+ */
+declare const ZIBRI_INVOICING_DI_TOKENS: {
+    readonly INVOICE_NUMBER_SERVICE: "zi.invoicing.invoice_number_service";
+    readonly OPTIONS_INPUT: "zi.invoicing.options_input";
+    readonly OPTIONS: "zi.invoicing.options";
+    readonly INVOICE_CALC_SERVICE: "zi.invoicing.invoice_calc_service";
+    readonly INVOICE_PDF_SERVICE: "zi.invoicing.invoice_pdf_service";
+    readonly INVOICE_CONFORMANCE_SERVICES: "zi.invoicing.invoice_conformance_services";
+};
+type ZibriInvoicingPluginDiProvider<T> = OmitStrict<DiProvider<T>, 'token'>;
+type ZibriInvoicingPluginDiProviders = {
+    [ZIBRI_INVOICING_DI_TOKENS.INVOICE_NUMBER_SERVICE]: ZibriInvoicingPluginDiProvider<InvoiceNumberServiceInterface<any>>;
+    [ZIBRI_INVOICING_DI_TOKENS.OPTIONS]: ZibriInvoicingPluginDiProvider<InvoicingOptions>;
+    [ZIBRI_INVOICING_DI_TOKENS.OPTIONS_INPUT]: ZibriInvoicingPluginDiProvider<InvoicingOptionsInput>;
+    [ZIBRI_INVOICING_DI_TOKENS.INVOICE_PDF_SERVICE]: ZibriInvoicingPluginDiProvider<InvoicePdfServiceInterface<any>>;
+    [ZIBRI_INVOICING_DI_TOKENS.INVOICE_CALC_SERVICE]: ZibriInvoicingPluginDiProvider<InvoiceCalcServiceInterface<any>>;
+    [ZIBRI_INVOICING_DI_TOKENS.INVOICE_CONFORMANCE_SERVICES]: ZibriInvoicingPluginDiProvider<InvoiceConformanceServiceInterface<any>[]>;
+};
+
+/**
+ * All options for a Zibri application.
+ */
+type ZibriApplicationOptions = {
+    /**
+     * The name of the app.
+     */
+    name: string;
+    /**
+     * The base url of the app.
+     * Eg. Http://localhost:3000.
+     */
+    baseUrl: string;
+    /**
+     * The SemVer version of the app.
+     *
+     * Is also used by migrations by default.
+     */
+    version: Version;
+    /**
+     * The controllers to register in the app.
+     */
+    controllers: Newable<unknown>[];
+    /**
+     * The data sources to register in the app.
+     */
+    dataSources?: Newable<BaseDataSource>[];
+    /**
+     * The DI providers to register/override.
+     */
+    providers?: DiProvider<unknown>[];
+    /**
+     * The body parsers to register.
+     *
+     * If nothing is provided, the Zibri default parsers will be used.
+     */
+    bodyParsers?: Newable<BodyParserInterface>[];
+    /**
+     * The auth strategies to register.
+     *
+     * If nothing is provided, the Zibri default jwt auth strategy will be used.
+     */
+    authStrategies?: AuthStrategies;
+    /**
+     * The cron jobs to register in the app.
+     */
+    cronJobs?: Newable<CronJob>[];
+    /**
+     * The plugins to be used.
+     */
+    plugins?: Newable<ZibriPlugin>[];
+};
+
+type FullZibriApplicationOptions = Required<OmitStrict<ZibriApplicationOptions, 'plugins'>>;
+/**
+ * A Zibri application.
+ */
+declare class ZibriApplication {
+    private readonly providedOptions;
+    /**
+     * The internal express app.
+     */
+    private readonly express;
+    private _router;
+    /**
+     * The router used by the application.
+     */
+    get router(): RouterInterface;
+    private logger;
+    private metricsService;
+    private assetService;
+    private openApiService;
+    private parser;
+    private dataSourceService;
+    private authService;
+    private cronService;
+    private multithreadingService;
+    private emailService;
+    private mailingListService?;
+    /**
+     * The options of which the application was build.
+     */
+    readonly options: FullZibriApplicationOptions;
+    constructor(providedOptions: ZibriApplicationOptions);
+    use(handler: RequestHandler): express.Express;
+    use(...handlers: RequestHandler[]): void;
+    use(path: Route, ...handlers: RequestHandler[]): void;
+    use(path: Route, handlers: RequestHandler[]): void;
+    /**
+     * Initializes the app.
+     * @param H - The global handlebars instance, needed to provide some helpers used in templating.
+     */
+    init(H: typeof Handlebars): Promise<void>;
+    /**
+     * Starts on the given port.
+     * @param port - The port to start on.
+     * @throws When the app has already been started.
+     */
+    start(port: number): Promise<void>;
+    private createFullOptions;
+}
+
+/**
+ * A global error handler function.
+ */
+type GlobalErrorHandler = (err: unknown, req: HttpRequest, res: HttpResponse, next: NextFunction) => void | Promise<void>;
+
+/**
+ * The default error handler implementation of Zibri.
+ * @param error - The error that was caught.
+ * @param req - The http request.
+ * @param res - The http response.
+ * @param next - The express next function.
+ */
+declare const errorHandler: GlobalErrorHandler;
+
+/**
+ * A base http error.
+ */
+declare abstract class HttpError extends Error {
+    /**
+     * The status of the error.
+     */
+    status: HttpStatus;
+    /**
+     * The title of the error.
+     */
+    title: string;
+    /**
+     * A paragraphs error with the error message.
+     */
+    paragraphs: string[];
+    constructor(message: string | string[], status: HttpStatus, title: string, options?: ErrorOptions);
+}
+/**
+ * Check whether or not the given value is a http error.
+ * @param value - The value to check.
+ * @returns True when value is an instance of HttpError, false otherwise.
+ */
+declare function isHttpError(value: unknown): value is HttpError;
+
+/**
+ * An error to throw when something unexpected happened inside the server.
+ */
+declare class InternalServerError extends HttpError {
+    constructor(message: string | string[], options?: ErrorOptions);
+}
+
+/**
+ * An error to throw when the requested resource could not be found.
+ *
+ * In contrast to the UnmatchedRouteError, this should be thrown when the endpoint actually exists (eg. /items/:id), but the resource was not found.
+ * Eg. Because the id of the item is incorrect.
+ */
+declare class NotFoundError extends HttpError {
+    constructor(message: string | string[], options?: ErrorOptions);
+}
+
+/**
+ * An error to throw when a route requested by a user does not exist at all.
+ *
+ * In contrast to NotFoundError, this should only be thrown the route itself does not exist at all.
+ * Eg. /does-not-exist and not when the route itself (eg. Items/:id) exists, but it could not find a value for eg. /items/42.
+ */
+declare class UnmatchedRouteError extends NotFoundError {
+    constructor(originalUrl: string, options?: ErrorOptions);
+}
+
+/**
+ * An error to throw when the user send some invalid data to the server.
+ */
+declare class BadRequestError extends HttpError {
+    constructor(message: string | string[], options?: ErrorOptions);
+}
+
+/**
+ * A validation problem, consisting of the key where the problem is located and a description of the problem.
+ */
+type ValidationProblem = {
+    /**
+     * The key where the problem is located.
+     */
+    key: string;
+    /**
+     * The validation problem message.
+     */
+    message: string;
+};
+/**
+ * The validation problem that the property is required and no value has been provided.
+ */
+declare class IsRequiredValidationProblem implements ValidationProblem {
+    readonly key: string;
+    readonly message: string;
+    constructor(key: string);
+}
+/**
+ * The validation problem that the provided value has an incorrect type.
+ */
+declare class TypeMismatchValidationProblem implements ValidationProblem {
+    readonly key: string;
+    readonly message: string;
+    constructor(key: string, type: string);
+}
+/**
  * The validation problem that the provided file is too big.
  */
 declare class MaxFileSizeValidationProblem implements ValidationProblem {
@@ -4497,6 +5600,20 @@ declare class TooManyRequestsError extends HttpError {
     constructor(message: string | string[], options?: ErrorOptions);
 }
 
+/**
+ * An error to throw when the user send some invalid data to the server.
+ */
+declare class ConflictError extends HttpError {
+    constructor(message: string | string[], options?: ErrorOptions);
+}
+
+/**
+ * An error to throw when there are entities that are not registered in a data source.
+ */
+declare class MissingEntitiesError extends Error {
+    constructor(context: string, orphanedEntities: Newable<BaseEntity>[]);
+}
+
 /**
  * The possible state that the app can be in.
  */
@@ -5187,39 +6304,428 @@ declare class SoftDeleteRepository<T extends SoftDeleteEntity, CreateData extend
 }
 
 /**
- * Compares the given versions and check if the first one is bigger, equal or smaller than the second one.
- * @param v1 - The first version.
- * @param v2 - The second version to compare against.
- * @returns 'bigger', 'equal' or 'smaller'.
+ * Options for handling multithreading.
  */
-declare function compareVersion(v1: Version, v2: Version): 'bigger' | 'equal' | 'smaller';
+type MultithreadingOptions = {
+    /**
+     * The number of threads that can be used.
+     * Please notice that there is also **maxPriorityThreads** for the number of threads that should be reserved for priority jobs.
+     * Both these values added up need to be smaller than your current machines available threads.
+     * @default os.availableParallelism() - Number(process.env.UV_THREADPOOL_SIZE ?? '4') - 1 (the -1 is reserved for a priority thread)
+     */
+    maxThreads: number;
+    /**
+     * The number of threads that can be used by priority jobs.
+     * Please notice that there is also **maxThreads** for the number of threads that can be used by normal and priority jobs.
+     * Both these values added up need to be smaller than your current machines available threads.
+     * @default 1
+     */
+    maxPriorityThreads: number;
+    /**
+     * The default timeout for a thread job.
+     * @default 1 hour.
+     */
+    defaultTimeoutMs: number;
+    /**
+     * The default timeout for a priority thread job.
+     * @default 5 minutes.
+     */
+    defaultTimeoutPriorityMs: number;
+};
 
 /**
- * Checks whether the given value is a valid SemVer Version.
- * @param value - The value to check.
+ * The status that a thread job can have.
  */
-declare function isVersion(value: string): value is Version;
+declare enum ThreadJobStatus {
+    IN_QUEUE = "IN_QUEUE",
+    IN_PROGRESS = "IN_PROGRESS",
+    COMPLETED = "COMPLETED",
+    FAILED = "FAILED",
+    CANCELLED = "CANCELLED"
+}
 
 /**
- * Function for formatting dates.
+ * The internal thread job message types.
+ */
+type ThreadJobMessage<T = unknown> = StatusMessage | ProgressMessage | CompletionMessage<T> | InitializationMessage | ErrorMessage;
+/**
+ * The message that is sent once on initialization.
+ */
+type InitializationMessage = {
+    /**
+     * The type of the message.
+     */
+    type: 'initialization';
+};
+/**
+ * A message to change the status of the thread job.
+ */
+type StatusMessage = {
+    /**
+     * The type of the message.
+     */
+    type: 'status';
+    /**
+     * The status that should be set.
+     */
+    status: ThreadJobStatus;
+};
+/**
+ * A message to indicate that the thread job has failed.
+ */
+type ErrorMessage<ErrorType extends Error = Error> = {
+    /**
+     * The type of the message.
+     */
+    type: 'error';
+    /**
+     * The error that the thread job failed with.
+     */
+    error: ErrorType;
+};
+/**
+ * A message to update the progress of the job.
+ */
+type ProgressMessage = {
+    /**
+     * The type of the message.
+     */
+    type: 'progress';
+    /**
+     * The progress as a percentage number.
+     * Cannot be set to 100 as the CompletionMessage should be used for that.
+     */
+    progress: Percentage;
+};
+/**
+ * A message to indicate that the thread job was completed successfully.
+ */
+type CompletionMessage<T> = {
+    /**
+     * The type of the message.
+     */
+    type: 'completion';
+    /**
+     * The result of the thread job.
+     */
+    result: T;
+};
+
+/**
+ * The base data for a thread job worker.
+ */
+type BaseThreadJobWorkerData = {
+    /**
+     * The path to the worker file.
+     * **This can either be a ts or a js file**.
+     */
+    filePath: string;
+};
+/**
+ * The data to run a function in the thread worker.
+ *
+ * **IMPORTANT**: This uses "eval" in the thread worker, so make sure that the data passed is not malicious.
  */
-type FormatDateFn = (date: Date, includeTime?: boolean) => string;
+type BaseFunctionThreadJobWorkerData<I> = BaseThreadJobWorkerData & {
+    /**
+     * A stringified function to call in the worker.
+     */
+    func: string;
+    /**
+     * The input parameter of the function.
+     */
+    input: I;
+};
 
 /**
- * Options for chunking.
+ * The function values of the thread job data.
+ * This is separated because this cannot be persisted in a database.
  */
-type ChunkingOptions = {
+type ThreadJobDataFunctions = {
     /**
-     * The size of a single chunk.
+     * What should happen when a message is received from the thread job.
      */
-    chunkSize: number;
+    onMessage?: (message: unknown) => void;
+    /**
+     * What should happen when the thread job completes.
+     */
+    onComplete?: () => void;
+    /**
+     * What should happen when the thread job was cancelled.
+     */
+    onCancel?: () => void;
+    /**
+     * What should happen when an error occurs inside the thread job.
+     */
+    onError?: (error: Error) => void;
 };
 /**
- * Like Promise.all, but chunked.
- * @param promises - The promises to resolve.
- * @param options - Options for chunking, like the size of chunks etc.
- * @returns The resolved promises after all chunks have been resolved.
+ * Data that is needed to start a thread job.
  */
-declare function chunkedPromiseAll<T>(promises: Promise<T>[], options?: ChunkingOptions): Promise<T[]>;
+type ThreadJobData<T extends BaseThreadJobWorkerData> = ThreadJobDataFunctions & {
+    /**
+     * Data that should be passed to the worker.
+     */
+    workerData: T;
+    /**
+     * Wether or not the job should use priority workers.
+     * @default false
+     */
+    priority?: boolean;
+    /**
+     * The timeout after which the job should exit with an error.
+     * @default one hour in ms.
+     */
+    timeout?: number;
+};
+
+/**
+ * The type of a function that can be run on a separate thread.
+ */
+type ThreadJobFunction<InputType, ResultType> = ((data: InputType) => ResultType) | ((data: InputType) => Promise<ResultType>);
+
+/**
+ * Definition for a service that handles multithreading.
+ */
+interface MultithreadingServiceInterface {
+    /**
+     * Initializes the service.
+     */
+    init: () => void | Promise<void>;
+    /**
+     * Creates and queues a thread job with the given data.
+     * @param threadJobData - The data to create the thread job from.
+     * @returns The id of the created thread job in the database and queue.
+     *
+     * **This differs from the threadId, which is created by the os and set when the thread actually starts.**.
+     */
+    queueThreadJob: <WorkerData extends BaseThreadJobWorkerData>(threadJobData: ThreadJobData<WorkerData>) => Promise<string> | string;
+    /**
+     * Queues a thread job for the given data and waits for its completion.
+     * @param threadJobData - The data of the job to queue.
+     * @returns The thread job.
+     */
+    runThreadJob: <WorkerData extends BaseThreadJobWorkerData, ResultType>(threadJobData: ThreadJobData<WorkerData>) => Promise<ThreadJobEntity<WorkerData, ResultType>> | ThreadJobEntity<WorkerData, ResultType>;
+    /**
+     * Runs the given function on a separate thread. This will not persist the state in the database.
+     *
+     ***IMPORTANT**: This uses "eval" in the thread worker, so make sure that the data passed is not malicious.
+     * @param func - The function that should be run in a separate thread.
+     * @param input - The input value of the function.
+     * @param timeout - A custom timeout for the task. Defaults to 5 minutes or an hour, depending on the priority.
+     * @param priority - Whether or not the function should make use of priority workers or not. Defaults to **true**.
+     * @returns The result value of the function passed.
+     * @throws When either the function itself throws an error or something didn't work during parsing/evaluation.
+     */
+    run: <InputType, ResultType>(func: ThreadJobFunction<InputType, ResultType>, input: InputType, timeout?: number, priority?: boolean) => Promise<ResultType> | ResultType;
+    /**
+     * Requeues a thread job that was already completed.
+     * @param jobId - The id of the job to requeue.
+     * @param data - Additional data for the job.
+     */
+    requeueThreadJob: (jobId: string, data?: ThreadJobDataFunctions) => Promise<void> | void;
+    /**
+     * Reruns a thread job that was already completed.
+     * @param jobId - The id of the job to rerun.
+     * @param data - Additional data for the job.
+     * @returns The thread job.
+     */
+    rerunThreadJob: <WorkerData extends BaseThreadJobWorkerData, ResultType>(jobId: string, data?: ThreadJobDataFunctions) => Promise<ThreadJobEntity<WorkerData, ResultType>> | ThreadJobEntity<WorkerData, ResultType>;
+    /**
+     * Waits for the thread job with the given id to complete.
+     * @param jobId - The id of the thread job to wait for.
+     * @returns The thread job.
+     */
+    waitForThreadJob: <ResultType, WorkerData extends BaseThreadJobWorkerData = BaseThreadJobWorkerData>(jobId: string) => Promise<ThreadJobEntity<WorkerData, ResultType>> | ThreadJobEntity<WorkerData, ResultType>;
+    /**
+     * Terminates all the workers.
+     */
+    shutdown: () => Promise<void> | void;
+}
+
+/**
+ * A service that handles multithreading.
+ */
+declare class MultithreadingService implements MultithreadingServiceInterface {
+    private readonly options;
+    private readonly threadJobEntityRepository;
+    private readonly assetService;
+    private readonly logger;
+    /**
+     * All thread jobs.
+     */
+    private queue;
+    /**
+     * The workers that are currently running.
+     */
+    private workers;
+    /**
+     * The workers that are currently idle.
+     */
+    private idleWorkers;
+    private readonly threadJobWorkerFilePath;
+    constructor(options: MultithreadingOptions, threadJobEntityRepository: Repository<ThreadJobEntity<BaseThreadJobWorkerData, unknown>>, assetService: AssetServiceInterface, logger: LoggerInterface);
+    init(): Promise<void>;
+    private initWorker;
+    private validateInputs;
+    queueThreadJob<WorkerData extends BaseThreadJobWorkerData, ResultType>(threadJobData: ThreadJobData<WorkerData>): Promise<string>;
+    runThreadJob<WorkerData extends BaseThreadJobWorkerData, ResultType>(threadJobData: ThreadJobData<WorkerData>): Promise<ThreadJobEntity<WorkerData, ResultType>>;
+    run<InputType, ResultType>(func: ThreadJobFunction<InputType, ResultType>, input: InputType, timeout?: number, priority?: boolean): Promise<ResultType>;
+    requeueThreadJob(jobId: string, data?: ThreadJobDataFunctions): Promise<void>;
+    rerunThreadJob<WorkerData extends BaseThreadJobWorkerData, ResultType>(jobId: string, data?: ThreadJobDataFunctions): Promise<ThreadJobEntity<WorkerData, ResultType>>;
+    waitForThreadJob<ResultType, WorkerData extends BaseThreadJobWorkerData = BaseThreadJobWorkerData>(jobId: string): Promise<ThreadJobEntity<WorkerData, ResultType>>;
+    shutdown(): Promise<void>;
+    private getDefaultTimeout;
+    private startJobs;
+    private startJob;
+    private handleWorkerMessage;
+    private handleJobCompletion;
+    private handleInitializationMessage;
+    private freeWorker;
+    private getJobByThreadId;
+    private getWorkerByThreadId;
+    /**
+     * This should only happen on shutdown.
+     * To see where an error from the thread job is actually handled take a look at "handleWorkerMessage".
+     * @param exitCode - The code that the worker exited with.
+     * @param threadId - The thread id of the worker.
+     */
+    private handleWorkerExit;
+    /**
+     * This should actually never happen, as the whole worker crashes and not just the current task.
+     * That's why the provided "onError"-method from the threadJob data is not called.
+     * To see where an error from the thread job is actually handled take a look at "handleWorkerMessage".
+     * @param error - The error that crashed the worker.
+     * @param threadId - The threadId of the worker that crashed.
+     */
+    private handleWorkerError;
+    private updateThreadJobById;
+    private isThreadJobMessage;
+}
+
+/**
+ * A thread job.
+ */
+declare class ThreadJob<WorkerData extends BaseThreadJobWorkerData, ResultType> implements ThreadJobData<WorkerData> {
+    /**
+     * Timestamp of when the job was queued in milliseconds.
+     */
+    readonly queuedAtMs: number;
+    /**
+     * The type of the job. (whether it's a real job with db persistence or just a simple function call).
+     */
+    readonly type: 'job' | 'function';
+    /**
+     * Timestamp of when the job was started in milliseconds.
+     */
+    startedAtMs?: number;
+    /**
+     * Timestamp of when the job was stopped in milliseconds.
+     */
+    stoppedAtMs?: number;
+    /**
+     * A unique identifier of the job.
+     * **This differs from the threadId, which is created by the os and set when the thread actually starts.**.
+     */
+    readonly id: string;
+    /**
+     * The status of the job.
+     */
+    status: ThreadJobStatus;
+    /**
+     * The id of the thread that the job is running in.
+     * Set by the os.
+     */
+    threadId?: number;
+    /**
+     * The progress of the job in a percentage.
+     */
+    progress: Percentage;
+    /**
+     * The error that the job failed with.
+     */
+    error?: Error;
+    /**
+     * The result that the job finished with.
+     */
+    result?: ResultType;
+    /**
+     * A subject that contains whether or not the job was completed.
+     */
+    readonly completedSubject: BehaviorSubject<boolean>;
+    timeout: number;
+    priority: boolean;
+    readonly workerData: WorkerData;
+    onMessage?: (message: unknown) => void;
+    onComplete?: () => void;
+    onError?: (error: Error) => void;
+    onCancel?: () => void;
+    constructor(entity: ThreadJobEntity<WorkerData, ResultType>, type: 'job' | 'function', functions?: ThreadJobDataFunctions);
+}
+
+/**
+ * A worker for handling thread job.
+ * Consists of the actual worker, whether or not it is a priority worker. And the information of whether the worker is still initializing.
+ */
+declare class ThreadJobWorker {
+    /**
+     * A persisted thread id.
+     * This is needed because the internal worker sets its threadId to -1 when it crashes
+     * => There is no way to check which thread job was affected by the crash.
+     */
+    readonly threadId: number;
+    /**
+     * The actual worker.
+     */
+    readonly worker: Worker;
+    /**
+     * Whether or not this is a priority worker.
+     */
+    readonly priority: boolean;
+    /**
+     * The timeout object after which this thread should be terminated.
+     */
+    timeout?: NodeJS.Timeout;
+    /**
+     * Subject that contains whether or not the worker is still initializing.
+     */
+    readonly isInitializingSubject: BehaviorSubject<boolean>;
+    constructor(worker: Worker, priority: boolean, threadId: number);
+}
+
+/**
+ * Reports the given progress to the thread job service.
+ * @param progress - The progress to report.
+ */
+declare function reportProgress(progress: Percentage): void;
+/**
+ * Reports the completion of a thread job.
+ * @param result - The result of the job.
+ */
+declare function reportCompletion<T>(result?: T): void;
+/**
+ * Reports an error inside a thread job.
+ * @param error - The error to report.
+ */
+declare function reportError(error: Error): void;
+
+declare const omitValues: (keyof ThreadJob<BaseThreadJobWorkerData, unknown>)[];
+type OmitValues = typeof omitValues[number];
+/**
+ * Contains information about an invoice.
+ */
+declare class ThreadJobEntity<WorkerData extends BaseThreadJobWorkerData, ResultType> extends BaseEntity implements OmitStrict<ThreadJob<WorkerData, ResultType>, OmitValues> {
+    queuedAtMs: number;
+    startedAtMs?: number;
+    stoppedAtMs?: number;
+    status: ThreadJobStatus;
+    threadId?: number;
+    progress: Percentage;
+    priority: boolean;
+    timeout: number;
+    error?: Error;
+    workerData: WorkerData;
+    result?: ResultType;
+}
 
-export { type AppData, AppState, type ArrayParamItemMetadata, type ArrayParamItemMetadataInput, type ArrayParamMetadata, type ArrayParamMetadataInput, type ArrayPropertyItemMetadata, type ArrayPropertyItemMetadataInput, type ArrayPropertyMetadata, type ArrayPropertyMetadataInput, type ArrayWhereFilter, AssetService, type AssetServiceInterface, Auth, type AuthControllerInterface, AuthService, type AuthServiceInterface, type AuthStrategies, type AuthStrategyInterface, BadRequestError, BaseDataSource, type BaseEmailTemplateData, type BaseEmailTemplateDataInput, BaseEntity, type BaseLoggerTransportConfig, type BaseMailingListEmailTemplateData, type BasePageTemplateData, type BasePageTemplateDataInput, type BaseRepositoryOptions, type BaseUser, BaseUserEntity, type BelongsToMetadata, type BelongsToOnePropertyMetadataInput, Body, type BodyMetadata, type BodyMetadataInput, BodyParser, type BodyParserInterface, type BooleanParamMetadata, type BooleanParamMetadataInput, type BooleanPropertyMetadata, type BooleanPropertyMetadataInput, type BooleanWhereFilter, CLEANUP_AT_FILE_NAME, Change, ChangeSet, type ChangeSetEntity, ChangeSetRepository, ChangeSetType, type ChunkingOptions, type ColumnType, CombinedType, Controller, type ControllerRouteConfiguration, type CounterInterface, type CounterMetricName, type CreateAllOptions, type CreateChangeData, type CreateChangeSetData, type CreateCronJobEntityData, CreateEmailData, type CreateOptions, type CronConfig, CronJob, CronJobEntity, CronService, type CronServiceInterface, type CronUpdateData, CurrentUser, type CurrentUserMetadata, DataSource, type DataSourceOptions, DataSourceService, type DataSourceServiceInterface, type DateParamMetadata, type DateParamMetadataInput, type DatePropertyMetadata, type DatePropertyMetadataInput, type DateWhereFilter, Delete, type DeleteAllOptions, type DeleteByIdOptions, type DiProvider, type DiToken, Email, EmailAttachment, type EmailConfig, type EmailConfigInput, EmailPriority, EmailService, type EmailServiceInterface, EmailStatus, type EncodedJwtAccessToken, Entity, type EntityMetadata, type ErrorOpenApiResponse, File, type FileExtension, type FileMimeType, type FileOpenApiResponse, type FilePropertyMetadata, type FilePropertyMetadataInput, FileResponse, type FileSize, type FindAllOptions, type FindAllPaginatedOptions, type FindByIdOptions, type FindOneOptions, FormData, type FormDataBodyMetadata, FormDataBodyParser, type FormDataValue, type FormatDateFn, type GaugeInterface, type GaugeMetricName, Get, type GlobalErrorHandler, GlobalRegistry, HandlebarUtilities, type HasOnePropertyMetadataInput, type HasRoleMetadata, HashUtilities, type Header, type HeaderParamMetadata, type HeaderParamMetadataInput, type HistogramInterface, type HistogramMetricName, type HtmlOpenApiResponse, HtmlResponse, HttpError, HttpMethod, type HttpRequest, type HttpResponse, HttpStatus, type InitialCronConfig, Inject, InjectRepository, Injectable, InternalServerError, type IsLoggedInMetadata, type IsNotLoggedInMetadata, IsRequiredValidationProblem, type JsonBodyMetadata, JsonBodyParser, type JsonOpenApiResponse, Jwt, type JwtAccessTokenPayload, JwtAuthController, JwtAuthData, JwtAuthStrategy, JwtConfirmPasswordResetData, JwtCredentials, JwtCredentialsCreateData, JwtCredentialsDto, JwtRefreshToken, JwtRefreshTokenCreateDto, type JwtRefreshTokenPayload, type JwtRequestPasswordResetData, JwtUtilities, KnownHeader, Log, LogLevel, LoggedError, Logger, type LoggerInterface, LoggerTransport, type LoggerTransportSend, type LooseFileMimeType, MailingList, type MailingListQueueEmailData, MailingListService, type MailingListServiceInterface, MailingListSubscriber, MailingListSubscriberCreateData, MailingListSubscriptionConfirmationToken, MailingListSubscriptionConfirmationTokenCreateData, type ManyToManyPropertyMetadata, type ManyToManyPropertyMetadataInput, type ManyToOnePropertyMetadata, type ManyToOnePropertyMetadataInput, MaxFileSizeValidationProblem, Metric, MetricType, type MetricsServiceInterface, type MetricsSnapshot, Migration, MigrationEntity, MimeType, MimeTypeMismatchValidationProblem, type MulterFile, NO_USER_REPOSITORIES_PROVIDED_ERROR_MESSAGE, type NewChange, type Newable, NotFoundError, type NumberParamMetadata, type NumberParamMetadataInput, type NumberPropertyMetadata, type NumberPropertyMetadataInput, type NumberWhereFilter, type ObjectParamMetadata, type ObjectParamMetadataInput, type ObjectPropertyMetadata, type ObjectPropertyMetadataInput, type ObjectWhereFilter, OmitType, type OneToManyPropertyMetadata, type OneToManyPropertyMetadataInput, type OneToOnePropertyMetadata, type OneToOnePropertyMetadataInput, type OpenApiDefinition, type OpenApiOperation, type OpenApiParameter, type OpenApiPaths, type OpenApiRequestBodyObject, type OpenApiResponse, type OpenApiRouteConfiguration, type OpenApiSchemaObject, type OpenApiSecurityRequirementObject, type OpenApiSecuritySchemeObject, OpenApiService, type OpenApiServiceInterface, type PaginationResult, Param, Parser, type ParserInterface, PartialType, PasswordResetToken, PasswordResetTokenCreateData, Patch, type PathParamMetadata, type PathParamMetadataInput, type PathTree, PickType, Post, PrometheusMetricsService, Property, type PropertyMetadata, type PropertyMetadataInput, type QueryParamMetadata, type QueryParamMetadataInput, QueueEmailData, RateLimiter, Relation, type RelationMetadata, type RelationMetadataInput, RelationsNotAllowedValidationProblem, Repository, type ResetChangeSetResult, Response, type Route, type RouteConfiguration, type RouteConfigurationInput, type RouteHandler, Router, type RouterInterface, type SkipAuthMetadata, type SkipBelongsToMetadata, type SkipHasRoleMetadata, type SkipIsLoggedInMetadata, type SkipIsNotLoggedInMetadata, type SoftDeleteAllOptions, type SoftDeleteByIdOptions, type SoftDeleteEntity, type SoftDeleteFindAllOptions, type SoftDeleteFindAllPaginatedOptions, type SoftDeleteFindByIdOptions, type SoftDeleteFindOneOptions, SoftDeleteRepository, type SoftDeleteUpdateAllOptions, type SoftDeleteUpdateByIdOptions, type SoftDeleteWhere, type SoftDeleteWhereFilter, type StringFormat, type StringParamMetadata, type StringParamMetadataInput, type StringPropertyMetadata, type StringPropertyMetadataInput, type StringWhereFilter, TooManyRequestsError, type Transaction, type TreeNode, TypeMismatchValidationProblem, UnauthorizedError, type UnknownPropertyMetadata, type UnknownPropertyMetadataInput, UnmatchedRouteError, type UpdateAllOptions, type UpdateByIdOptions, UpdateMailingListPreferences, UserRepo, type UserRepositories, type UserRepositoryInterface, UserService, type UserServiceInterface, ValidationError, type ValidationProblem, ValidationService, type ValidationServiceInterface, type Version, type Where, type WhereFilter, type WhereFilterProperty, ZIBRI_DI_TOKENS, ZibriApplication, type ZibriApplicationOptions, type ZibriPlugin, chunkedPromiseAll, compareVersion, createArrayItemPropertyMetadata, errorHandler, errorToLoggedError, fileSizeToBytes, generateHandlebarType, generateHandlebarTypeFiles, getCurrentRequest, inject, isBaseUser, isChangeSetEntityNewable, isHttpError, isMimeType, isSoftDeleteEntityNewable, isVersion, renderEmailTemplate, renderPageTemplate, renderTemplate, renderTemplateString, repositoryTokenFor, resolveFileExtension, resolveMimeType, runWithRequest };
+export { AmountUnit, type AppData, AppState, type ArrayParamItemMetadata, type ArrayParamItemMetadataInput, type ArrayParamMetadata, type ArrayParamMetadataInput, type ArrayPropertyItemMetadata, type ArrayPropertyItemMetadataInput, type ArrayPropertyMetadata, type ArrayPropertyMetadataInput, type ArrayWhereFilter, AssetService, type AssetServiceInterface, Auth, type AuthControllerInterface, AuthService, type AuthServiceInterface, type AuthStrategies, type AuthStrategyInterface, BadRequestError, BaseDataSource, type BaseEmailTemplateData, type BaseEmailTemplateDataInput, BaseEntity, type BaseFunctionThreadJobWorkerData, type BaseLoggerTransportConfig, type BaseMailingListEmailTemplateData, type BasePageTemplateData, type BasePageTemplateDataInput, type BaseRepositoryOptions, type BaseThreadJobWorkerData, type BaseUser, BaseUserEntity, type BelongsToMetadata, type BelongsToOnePropertyMetadataInput, type BigNumber, BigNumberUtilities, Body, type BodyMetadata, type BodyMetadataInput, BodyParser, type BodyParserInterface, type BooleanParamMetadata, type BooleanParamMetadataInput, type BooleanPropertyMetadata, type BooleanPropertyMetadataInput, type BooleanWhereFilter, CLEANUP_AT_FILE_NAME, Change, ChangeSet, type ChangeSetEntity, ChangeSetRepository, ChangeSetType, type ChunkingOptions, type ColumnType, type CompanyInfo, ConflictError, Controller, type ControllerRouteConfiguration, type CounterInterface, type CounterMetricName, type CreateAllOptions, type CreateChangeData, type CreateChangeSetData, type CreateCronJobEntityData, CreateEmailData, type CreateOptions, type CronConfig, CronJob, CronJobEntity, CronService, type CronServiceInterface, type CronUpdateData, CrudController, type CrudControllerInterface, type CurrencyCode, CurrentUser, type CurrentUserMetadata, DataSource, type DataSourceOptions, DataSourceService, type DataSourceServiceInterface, type DateParamMetadata, type DateParamMetadataInput, type DatePropertyMetadata, type DatePropertyMetadataInput, type DateWhereFilter, Delete, type DeleteAllOptions, type DeleteByIdOptions, type DiProvider, type DiToken, EN16931ConformanceService, type EN16931DocumentContextId, Email, EmailAttachment, type EmailConfig, type EmailConfigInput, EmailPriority, EmailService, type EmailServiceInterface, EmailStatus, type EncodedJwtAccessToken, Entity, type EntityMetadata, type ErrorOpenApiResponse, File, type FileExtension, type FileMimeType, type FileOpenApiResponse, type FilePropertyMetadata, type FilePropertyMetadataInput, FileResponse, type FileSize, type FindAllOptions, type FindAllPaginatedOptions, type FindByIdOptions, type FindOneOptions, FormData, type FormDataBodyMetadata, FormDataBodyParser, type FormDataValue, type FormatDateFn, type FormatPercentFn, type FormatPriceFn, type GaugeInterface, type GaugeMetricName, Get, type GlobalErrorHandler, GlobalRegistry, HandlebarUtilities, type HasOnePropertyMetadataInput, type HasRoleMetadata, HashUtilities, type Header, type HeaderParamMetadata, type HeaderParamMetadataInput, type HistogramInterface, type HistogramMetricName, type HtmlOpenApiResponse, HtmlResponse, HttpError, HttpMethod, type HttpRequest, type HttpResponse, HttpStatus, type InitialCronConfig, Inject, InjectRepository, Injectable, InternalServerError, IntersectionClass, Invoice, InvoiceAddress, InvoiceCalcService, type InvoiceCalcServiceInterface, type InvoiceConformance, type InvoiceConformanceServiceInterface, InvoiceItem, InvoiceNumberService, type InvoiceNumberServiceInterface, InvoicePdfService, type InvoicePdfServiceInterface, type InvoicingOptions, type InvoicingOptionsInput, type IsLoggedInMetadata, type IsNotLoggedInMetadata, IsRequiredValidationProblem, type JsonBodyMetadata, JsonBodyParser, type JsonOpenApiResponse, Jwt, type JwtAccessTokenPayload, JwtAuthController, JwtAuthData, JwtAuthStrategy, JwtConfirmPasswordResetData, JwtCredentials, JwtCredentialsCreateData, JwtCredentialsDto, JwtRefreshToken, JwtRefreshTokenCreateDto, type JwtRefreshTokenPayload, type JwtRequestPasswordResetData, JwtUtilities, KnownHeader, type LanguageCode, type LocalizeOptions, type LocalizeOptionsInput, Log, LogLevel, LoggedError, Logger, type LoggerInterface, LoggerTransport, type LoggerTransportSend, type LooseFileMimeType, MailingList, type MailingListQueueEmailData, MailingListService, type MailingListServiceInterface, MailingListSubscriber, MailingListSubscriberCreateData, MailingListSubscriptionConfirmationToken, MailingListSubscriptionConfirmationTokenCreateData, type ManyToManyPropertyMetadata, type ManyToManyPropertyMetadataInput, type ManyToOnePropertyMetadata, type ManyToOnePropertyMetadataInput, MaxFileSizeValidationProblem, Metric, MetricType, type MetricsServiceInterface, type MetricsSnapshot, Migration, MigrationEntity, MimeType, MimeTypeMismatchValidationProblem, MissingEntitiesError, Ms, type MulterFile, type MultithreadingOptions, MultithreadingService, type MultithreadingServiceInterface, NO_USER_REPOSITORIES_PROVIDED_ERROR_MESSAGE, type NewChange, type Newable, NotFoundError, NumberInvoices, type NumberParamMetadata, type NumberParamMetadataInput, type NumberPropertyMetadata, type NumberPropertyMetadataInput, type NumberWhereFilter, type ObjectParamMetadata, type ObjectParamMetadataInput, type ObjectPropertyMetadata, type ObjectPropertyMetadataInput, type ObjectWhereFilter, OmitClass, type OneToManyPropertyMetadata, type OneToManyPropertyMetadataInput, type OneToOnePropertyMetadata, type OneToOnePropertyMetadataInput, type OpenApiDefinition, type OpenApiOperation, type OpenApiParameter, type OpenApiPaths, type OpenApiRequestBodyObject, type OpenApiResponse, type OpenApiRouteConfiguration, type OpenApiSchemaObject, type OpenApiSecurityRequirementObject, type OpenApiSecuritySchemeObject, OpenApiService, type OpenApiServiceInterface, type PaginationResult, Param, Parser, type ParserInterface, PartialClass, PasswordResetToken, PasswordResetTokenCreateData, Patch, type PathParamMetadata, type PathParamMetadataInput, type PathTree, PeppolConformanceService, PickClass, Post, PrometheusMetricsService, Property, type PropertyMetadata, type PropertyMetadataInput, type QueryParamMetadata, type QueryParamMetadataInput, QueueEmailData, RateLimiter, Relation, type RelationMetadata, type RelationMetadataInput, RelationsNotAllowedValidationProblem, Repository, type ResetChangeSetResult, Response, type Route, type RouteConfiguration, type RouteConfigurationInput, type RouteHandler, Router, type RouterInterface, type SkipAuthMetadata, type SkipBelongsToMetadata, type SkipHasRoleMetadata, type SkipIsLoggedInMetadata, type SkipIsNotLoggedInMetadata, type SoftDeleteAllOptions, type SoftDeleteByIdOptions, type SoftDeleteEntity, type SoftDeleteFindAllOptions, type SoftDeleteFindAllPaginatedOptions, type SoftDeleteFindByIdOptions, type SoftDeleteFindOneOptions, SoftDeleteRepository, type SoftDeleteUpdateAllOptions, type SoftDeleteUpdateByIdOptions, type SoftDeleteWhere, type SoftDeleteWhereFilter, type StringFormat, type StringParamMetadata, type StringParamMetadataInput, type StringPropertyMetadata, type StringPropertyMetadataInput, type StringWhereFilter, ThreadJob, type ThreadJobData, type ThreadJobDataFunctions, ThreadJobEntity, type ThreadJobFunction, type ThreadJobMessage, ThreadJobStatus, ThreadJobWorker, TooManyRequestsError, type Transaction, type TreeNode, TypeMismatchValidationProblem, UUIDUtilities, UnauthorizedError, type UnknownPropertyMetadata, type UnknownPropertyMetadataInput, UnmatchedRouteError, type UpdateAllOptions, type UpdateByIdOptions, UpdateMailingListPreferences, UserRepo, type UserRepositories, type UserRepositoryInterface, UserService, type UserServiceInterface, ValidationError, type ValidationProblem, ValidationService, type ValidationServiceInterface, Vat, type VatCategoryCode, type Version, type Where, type WhereFilter, type WhereFilterProperty, XRechnungConformanceService, ZIBRI_DI_TOKENS, ZIBRI_INVOICING_DI_TOKENS, ZibriApplication, type ZibriApplicationOptions, ZibriInvoicingPlugin, type ZibriInvoicingPluginDiProvider, type ZibriInvoicingPluginDiProviders, ZibriPlugin, chunkedPromiseAll, compareVersion, createArrayItemPropertyMetadata, errorHandler, errorToLoggedError, fileSizeToBytes, generateHandlebarType, generateHandlebarTypeFiles, getCurrentRequest, inject, isBaseUser, isChangeSetEntityNewable, isHttpError, isMimeType, isSoftDeleteEntityNewable, isVersion, renderEmailTemplate, renderPageTemplate, renderTemplate, renderTemplateString, reportCompletion, reportError, reportProgress, repositoryTokenFor, resolveFileExtension, resolveMimeType, runWithRequest, validateEntitiesRegistered };