zibri 2.4.0 → 2.4.1

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

@@ -14,10 +14,11 @@ import { ZIBRI_DI_TOKENS } from '../di/default/zibri-di-tokens.default';
 import { inject } from '../di/inject.function';
 import { BaseEntity } from '../entity/base-entity.model';
 import { PropertyMetadata } from '../entity/decorators/property.decorator';
+import { BelongsToOnePropertyMetadata } from '../entity/models/belongs-to-one-property-metadata.model';
+import { HasOnePropertyMetadata } from '../entity/models/has-one-property-metadata.model';
 import { ManyToManyPropertyMetadata } from '../entity/models/many-to-many-property-metadata.model';
 import { ManyToOnePropertyMetadata } from '../entity/models/many-to-one-property-metadata.model';
 import { OneToManyPropertyMetadata } from '../entity/models/one-to-many-property-metadata.model';
-import { OneToOnePropertyMetadata } from '../entity/models/one-to-one-property-metadata.model';
 import { Relation } from '../entity/models/relation.enum';
 import { OmitClass } from '../entity/omit-class.model';
 import { GlobalRegistry } from '../global/global-registry';
@@ -449,7 +450,7 @@ export class OpenApiService implements OpenApiServiceInterface, OnAppInit {
                     return undefined;
                 }
                 const propMeta: Record<string, PropertyMetadata> = MetadataUtilities.getModelProperties(response.cls);
-                const schema: OpenApiSchemaObject = this.buildOpenApiSchemaForProperties(propMeta, response.cls, 'response');
+                const schema: OpenApiSchemaObject = this.buildOpenApiSchemaForProperties(propMeta, response.cls, 'response', new Set());
 
                 if (response.isArray === true) {
                     return { [MimeType.JSON]: { schema: { type: 'array', items: schema } } };
@@ -491,7 +492,7 @@ export class OpenApiService implements OpenApiServiceInterface, OnAppInit {
                         continue;
                     }
                     const propMeta: Record<string, PropertyMetadata> = MetadataUtilities.getModelProperties(response.cls);
-                    const schema: OpenApiSchemaObject = this.buildOpenApiSchemaForProperties(propMeta, response.cls, 'response');
+                    const schema: OpenApiSchemaObject = this.buildOpenApiSchemaForProperties(propMeta, response.cls, 'response', new Set());
                     if (response.isArray === true) {
                         schemas.push({ type: 'array', items: schema });
                         continue;
@@ -544,7 +545,7 @@ export class OpenApiService implements OpenApiServiceInterface, OnAppInit {
             return undefined;
         }
         const propMeta: Record<string, PropertyMetadata> = MetadataUtilities.getModelProperties(metadata.modelClass);
-        const schema: OpenApiSchemaObject = this.buildOpenApiSchemaForProperties(propMeta, metadata.modelClass, 'request');
+        const schema: OpenApiSchemaObject = this.buildOpenApiSchemaForProperties(propMeta, metadata.modelClass, 'request', new Set());
         return {
             required: typeof metadata.required === 'boolean' ? metadata.required : undefined,
             description: metadata.description,
@@ -556,8 +557,17 @@ export class OpenApiService implements OpenApiServiceInterface, OnAppInit {
     private buildOpenApiSchemaForProperties(
         propMeta: Record<string, PropertyMetadata>,
         entity: Newable<unknown>,
-        context: 'request' | 'response'
+        context: 'request' | 'response',
+        visited: Set<Newable<unknown>>
     ): OpenApiSchemaObject {
+        // ---- cycle guard ----
+        if (visited.has(entity)) {
+        // Return a stub schema (or a ref if you later extract components).
+        // Returning an empty object is safe, but a description helps debugging.
+            return { type: 'object', description: 'Circular reference omitted' };
+        }
+        visited.add(entity);
+
         const properties: Record<string, OpenApiSchemaObject> = {};
         const required: string[] = [];
 
@@ -613,17 +623,18 @@ export class OpenApiService implements OpenApiServiceInterface, OnAppInit {
                 case 'object': {
                     const objectPropMeta: Record<string, PropertyMetadata> = MetadataUtilities.getModelProperties(meta.cls());
                     properties[key] = {
-                        ...this.buildOpenApiSchemaForProperties(objectPropMeta, entity, context),
+                        ...this.buildOpenApiSchemaForProperties(objectPropMeta, entity, context, visited),
                         description: meta.description
                     };
                     continue;
                 }
-                case Relation.ONE_TO_ONE:
+                case Relation.HAS_ONE:
+                case Relation.BELONGS_TO_ONE:
                 case Relation.MANY_TO_ONE: {
                     const targetClass: Newable<BaseEntity> = this.getTargetClassForRelation(meta, entity);
                     const objectPropMeta: Record<string, PropertyMetadata> = MetadataUtilities.getModelProperties(targetClass);
                     properties[key] = {
-                        ...this.buildOpenApiSchemaForProperties(objectPropMeta, entity, context),
+                        ...this.buildOpenApiSchemaForProperties(objectPropMeta, entity, context, visited),
                         description: meta.description
                     };
                     continue;
@@ -645,7 +656,8 @@ export class OpenApiService implements OpenApiServiceInterface, OnAppInit {
                             }
                         },
                         entity,
-                        context
+                        context,
+                        visited
                     );
                     properties[key] = {
                         type: 'array',
@@ -658,7 +670,12 @@ export class OpenApiService implements OpenApiServiceInterface, OnAppInit {
                     if (meta.items.type === 'object') {
                         entity = meta.items.cls();
                     }
-                    const items: OpenApiSchemaObject = this.buildOpenApiSchemaForProperties({ items: meta.items }, entity, context);
+                    const items: OpenApiSchemaObject = this.buildOpenApiSchemaForProperties(
+                        { items: meta.items },
+                        entity,
+                        context,
+                        visited
+                    );
                     properties[key] = {
                         type: 'array',
                         description: meta.description,
@@ -692,7 +709,8 @@ export class OpenApiService implements OpenApiServiceInterface, OnAppInit {
         meta: OneToManyPropertyMetadata<BaseEntity>
             | ManyToManyPropertyMetadata<BaseEntity>
             | ManyToOnePropertyMetadata<BaseEntity>
-            | OneToOnePropertyMetadata<BaseEntity>,
+            | BelongsToOnePropertyMetadata<BaseEntity>
+            | HasOnePropertyMetadata<BaseEntity>,
         entity: Newable<unknown>
     ): Newable<BaseEntity> {
         const fullTargetClass: Newable<BaseEntity> = meta.target();
@@ -702,7 +720,8 @@ export class OpenApiService implements OpenApiServiceInterface, OnAppInit {
         for (const key in properties) {
             const property: PropertyMetadata = properties[key];
             if (
-                property.type !== Relation.ONE_TO_ONE
+                property.type !== Relation.BELONGS_TO_ONE
+                && property.type !== Relation.HAS_ONE
                 && property.type !== Relation.ONE_TO_MANY
                 && property.type !== Relation.MANY_TO_ONE
                 && property.type !== Relation.MANY_TO_MANY
@@ -771,7 +790,7 @@ export class OpenApiService implements OpenApiServiceInterface, OnAppInit {
                 const propMeta: Record<string, PropertyMetadata> = MetadataUtilities.getModelProperties(meta.cls());
                 return {
                     description: meta.description,
-                    ...this.buildOpenApiSchemaForProperties(propMeta, meta.cls(), 'request')
+                    ...this.buildOpenApiSchemaForProperties(propMeta, meta.cls(), 'request', new Set())
                 };
             }
             case 'array': {

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

@@ -172,7 +172,8 @@ export class FormDataBodyParser implements BodyParserInterface, OnAppInit {
                     res[key] = parseDate(value);
                     break;
                 }
-                case Relation.ONE_TO_ONE:
+                case Relation.HAS_ONE:
+                case Relation.BELONGS_TO_ONE:
                 case Relation.ONE_TO_MANY:
                 case Relation.MANY_TO_ONE:
                 case Relation.MANY_TO_MANY:

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

@@ -1,4 +1,3 @@
-
 // eslint-disable-next-line jsdoc/require-jsdoc
 export function parseBoolean(rawValue: unknown): unknown {
     if (typeof rawValue === 'boolean') {

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

@@ -62,7 +62,8 @@ export function parseObject(
                 res[propertyKey] = parseArray(res[propertyKey], m);
                 break;
             }
-            case Relation.ONE_TO_ONE:
+            case Relation.HAS_ONE:
+            case Relation.BELONGS_TO_ONE:
             case Relation.ONE_TO_MANY:
             case Relation.MANY_TO_ONE:
             case Relation.MANY_TO_MANY:

package/src/parsing/parser.ts

@@ -100,7 +100,8 @@ export class Parser implements ParserInterface, OnAppInit {
     // eslint-disable-next-line jsdoc/require-jsdoc
     parseQueryParam(req: HttpRequest | WebsocketRequest, metadata: QueryParamMetadata): unknown {
         const rawValue: string | undefined = req.query?.[metadata.name];
-        return this.queryParamParseFunctions[metadata.type](rawValue, metadata);
+        const res: unknown = this.queryParamParseFunctions[metadata.type](rawValue, metadata);
+        return res;
     }
 
     // eslint-disable-next-line jsdoc/require-jsdoc

package/src/routing/decorators/body.decorator.ts

@@ -135,7 +135,8 @@ function resolveMaxSize(bytes: BigNumber, properties: Record<string, PropertyMet
                 bytes = bytes.plus(resolveMaxSize(bytes, objectProperties));
                 break;
             }
-            case Relation.ONE_TO_ONE:
+            case Relation.HAS_ONE:
+            case Relation.BELONGS_TO_ONE:
             case Relation.ONE_TO_MANY:
             case Relation.MANY_TO_ONE:
             case Relation.MANY_TO_MANY:

package/src/routing/resolve-route-params.function.ts

@@ -88,7 +88,7 @@ async function parseRouteParams(
     for (const [indexStr, metadata] of ObjectUtilities.entries(headerParams)) {
         const idx: number = Number(indexStr);
         context.request.headers[metadata.name as KnownHeader] = parser.parseHeaderParam(context.request, metadata) as string | undefined;
-        params[idx] = parser.parseHeaderParam(context.request, metadata);
+        params[idx] = context.request.headers[metadata.name as KnownHeader];
     }
     resolvedParamCount += ObjectUtilities.keys(headerParams).length;
 

package/src/routing/router.ts

@@ -228,11 +228,26 @@ export class Router implements RouterInterface, OnAppInit, OnAppStart {
         QueryMetaObject extends Record<string, QueryParamMetadata>,
         HeaderMetaObject extends Record<string, HeaderParamMetadata>
     >(route: RouteConfiguration<BodyMetaObject, PathMetaObject, QueryMetaObject, HeaderMetaObject>): RequestHandler {
-        const handler: RequestHandler = (async (
-            request: HttpRequest,
-            res: HttpResponse,
-            next: NextFunction
-        ) => {
+        const handler: RequestHandler = (async (request: HttpRequest, res, next) => {
+            Object.defineProperty(request, 'params', {
+                value: { ...request.params },
+                writable: true,
+                configurable: true,
+                enumerable: true
+            });
+            Object.defineProperty(request, 'query', {
+                value: { ...request.query },
+                writable: true,
+                configurable: true,
+                enumerable: true
+            });
+            Object.defineProperty(request, 'headers', {
+                value: { ...request.headers },
+                writable: true,
+                configurable: true,
+                enumerable: true
+            });
+
             const context: HttpRequestContext = new HttpRequestContext(request, res, undefined, undefined);
             await AlsUtilities.runWithHttpRequestContext(context, async () => {
                 try {
@@ -289,9 +304,28 @@ export class Router implements RouterInterface, OnAppInit, OnAppStart {
         if (!responses.length) {
             await this.logger.warn(`No responses defined on route ${controllerClass.name}.${route.controllerMethod}`);
         }
-        const handler: RequestHandler = (async (req: HttpRequest, res: HttpResponse, next: NextFunction) => {
+        const handler: RequestHandler = (async (request: HttpRequest, res, next) => {
+            Object.defineProperty(request, 'params', {
+                value: { ...request.params },
+                writable: true,
+                configurable: true,
+                enumerable: true
+            });
+            Object.defineProperty(request, 'query', {
+                value: { ...request.query },
+                writable: true,
+                configurable: true,
+                enumerable: true
+            });
+            Object.defineProperty(request, 'headers', {
+                value: { ...request.headers },
+                writable: true,
+                configurable: true,
+                enumerable: true
+            });
+
             const context: HttpRequestContext = new HttpRequestContext(
-                req,
+                request,
                 res,
                 controllerClass,
                 route.controllerMethod

package/src/utilities/metadata-injection-keys.enum.ts

@@ -5,6 +5,7 @@ export enum MetadataInjectionKeys {
     FILE_LOCATION = 'file:location',
     // eslint-disable-next-line cspell/spellchecker
     PARAM_TYPES = 'design:paramtypes',
+    TYPE = 'design:type',
     DI_TOKEN = 'di:token',
     DI_INJECT_PARAM_TOKENS = 'di:inject_param_tokens',
     DI_INJECT_PARAM_OPTIONS = 'di:inject_param_options',

package/src/utilities/typeorm.utilities.ts

@@ -0,0 +1,75 @@
+import { DataSource, EntityTarget, EntityMetadata as TOEntityMetadata } from 'typeorm';
+import { ColumnMetadata } from 'typeorm/metadata/ColumnMetadata.js';
+
+import { ColumnType } from '../data-source/models/column-type.model';
+import { Transaction } from '../data-source/transaction/transaction.model';
+import { BaseEntity } from '../entity/base-entity.model';
+
+/**
+ * Utilities for dealing with typeorm.
+ */
+export abstract class TypeOrmUtilities {
+    /**
+     * Gets the metadata for a typeorm column.
+     * @param target - The entity.
+     * @param propertyName - The name of the property to get the column metadata for.
+     * @param transaction - The transaction to use to get the column metadata.
+     * @returns The typeorm column metadata.
+     * @throws When the provided propertyName could not be found as a column.
+     */
+    static getColumnMetadata<T extends BaseEntity>(
+        target: EntityTarget<T>,
+        propertyName: keyof T | string & {},
+        transaction: Transaction
+    ): ColumnMetadata {
+        const metadata: TOEntityMetadata = this.getEntityMetadata(target, transaction);
+        const column: ColumnMetadata | undefined = metadata.columns.find(
+            (col) => col.propertyName === propertyName
+        );
+
+        if (!column) {
+            throw new Error(
+                `Column ${propertyName.toString()} not found in model`
+            );
+        }
+
+        return column;
+    }
+
+    /**
+     * Gets the typeorm metadata for a given entity.
+     * @param target - The target entity.
+     * @param transaction - The transaction to run this command with.
+     * @returns The typeorm metadata.
+     */
+    static getEntityMetadata<T extends BaseEntity>(target: EntityTarget<T>, transaction: Transaction): TOEntityMetadata {
+        return transaction.queryRunner.connection.getMetadata(target);
+    }
+
+    // eslint-disable-next-line jsdoc/require-param
+    /**
+     * Normalizes the type of the given column using the provided dataSource.
+     * @returns The normalized column type as a string.
+     * @throws When no dataSource has been provided.
+     */
+    static normalizeColumnType(
+        dataSource: DataSource | undefined,
+        column: {
+            // eslint-disable-next-line jsdoc/require-jsdoc
+            type?: ColumnType | string & {},
+            // eslint-disable-next-line jsdoc/require-jsdoc
+            length?: number | string,
+            // eslint-disable-next-line jsdoc/require-jsdoc
+            precision?: number | null,
+            // eslint-disable-next-line jsdoc/require-jsdoc
+            scale?: number,
+            // eslint-disable-next-line jsdoc/require-jsdoc
+            isArray?: boolean
+        }
+    ): string {
+        if (!dataSource) {
+            throw new Error('The data source needs to be initialized before it can be used.');
+        }
+        return dataSource.driver.normalizeType(column);
+    }
+}

package/src/validation/validation-problem.model.ts

@@ -1,10 +1,11 @@
 import { BaseEntity } from '../entity/base-entity.model';
 import { RelationMetadata } from '../entity/decorators/property.decorator';
+import { BelongsToOnePropertyMetadata } from '../entity/models/belongs-to-one-property-metadata.model';
 import { FileSize } from '../entity/models/file-property-metadata.model';
+import { HasOnePropertyMetadata } from '../entity/models/has-one-property-metadata.model';
 import { ManyToManyPropertyMetadata } from '../entity/models/many-to-many-property-metadata.model';
 import { ManyToOnePropertyMetadata } from '../entity/models/many-to-one-property-metadata.model';
 import { OneToManyPropertyMetadata } from '../entity/models/one-to-many-property-metadata.model';
-import { OneToOnePropertyMetadata } from '../entity/models/one-to-one-property-metadata.model';
 import { Relation } from '../entity/models/relation.enum';
 import { MimeType } from '../http/mime-type.enum';
 
@@ -82,15 +83,12 @@ export class RelationsNotAllowedValidationProblem implements ValidationProblem {
 
     private getExample(metadata: RelationMetadata<BaseEntity>, relationKey: string): string {
         switch (metadata.type) {
-            case Relation.MANY_TO_ONE: {
-                return this.getObjectExample(metadata, relationKey);
-            }
-            case Relation.ONE_TO_MANY: {
-                return this.getArrayExample(metadata, relationKey);
-            }
-            case Relation.ONE_TO_ONE: {
+            case Relation.MANY_TO_ONE:
+            case Relation.HAS_ONE:
+            case Relation.BELONGS_TO_ONE: {
                 return this.getObjectExample(metadata, relationKey);
             }
+            case Relation.ONE_TO_MANY:
             case Relation.MANY_TO_MANY: {
                 return this.getArrayExample(metadata, relationKey);
             }
@@ -110,7 +108,7 @@ export class RelationsNotAllowedValidationProblem implements ValidationProblem {
     }
 
     private getObjectExample(
-        metadata: OneToOnePropertyMetadata<BaseEntity> | ManyToOnePropertyMetadata<BaseEntity>,
+        metadata: BelongsToOnePropertyMetadata<BaseEntity> | HasOnePropertyMetadata<BaseEntity> | ManyToOnePropertyMetadata<BaseEntity>,
         relationKey: string
     ): string {
         return [

package/src/validation/validation.service.ts

@@ -10,6 +10,7 @@ import { Injectable } from '../di/decorators/injectable.decorator';
 import { ZIBRI_DI_TOKENS } from '../di/default/zibri-di-tokens.default';
 import { inject } from '../di/inject.function';
 import { PropertyMetadata, Property, RelationMetadata } from '../entity/decorators/property.decorator';
+import { Relation } from '../entity/models/relation.enum';
 import { ValidationError } from '../error-handling/errors/validation.error';
 import { MimeType } from '../http/mime-type.enum';
 import { FormData } from '../parsing/form-data/form-data.model';
@@ -224,10 +225,11 @@ export class ValidationService implements ValidationServiceInterface {
         const fullKey: string = parentKey ? `${parentKey}.${key}` : key;
 
         if (
-            metadata.type === 'many-to-one'
-            || metadata.type === 'one-to-many'
-            || metadata.type === 'one-to-one'
-            || metadata.type === 'many-to-many'
+            metadata.type === Relation.MANY_TO_ONE
+            || metadata.type === Relation.ONE_TO_MANY
+            || metadata.type === Relation.HAS_ONE
+            || metadata.type === Relation.BELONGS_TO_ONE
+            || metadata.type === Relation.MANY_TO_MANY
         ) {
             return [new RelationsNotAllowedValidationProblem(fullKey, metadata, key)];
         }

package/src/websocket/models/websocket-message.model.ts

@@ -21,7 +21,7 @@ export enum WebsocketRecipientType {
 /**
  * Definition of a message sent via websocket connection.
  */
-@Entity()
+@Entity({ defaultOrder: { seq: 'ASC' } })
 export class WebsocketMessage extends BaseEntity {
     /**
      * The date at which the message was created.

package/src/websocket/models/websocket-request.model.ts

@@ -4,37 +4,45 @@ import { HttpRequest } from '../../http/http-request.model';
 import { KnownHeader } from '../../http/known-header.enum';
 
 // eslint-disable-next-line jsdoc/require-jsdoc
-class QueryObject implements Record<string, string | undefined> {
-    [key: string]: string | undefined
+class QueryObject implements Record<string, unknown> {
+    [key: string]: unknown
 }
 
 // eslint-disable-next-line jsdoc/require-jsdoc
 class ParamsObject extends QueryObject {}
 
 // eslint-disable-next-line jsdoc/require-jsdoc
-class HeadersObject implements Partial<Record<KnownHeader, string | undefined>> {
-    [key: string]: string | undefined
+class HeadersObject implements Partial<Record<KnownHeader, unknown>> {
+    [key: string]: unknown
 }
 
 /**
  * A websocket request sent from a client.
  */
-export class WebsocketRequest implements Partial<Pick<HttpRequest, 'headers' | 'body' | 'query' | 'params'>> {
+export class WebsocketRequest<
+    T = unknown,
+    PathParamsObject extends Record<string, unknown> = Record<string, string | undefined>,
+    QueryParamsObject extends Record<string, unknown> = Record<string, string | undefined>,
+    HeaderParamsObject extends Record<string, unknown> = Partial<Record<KnownHeader, string | undefined>>
+> implements Partial<Pick<
+    HttpRequest<T, PathParamsObject, QueryParamsObject, HeaderParamsObject>,
+    'headers' | 'body' | 'query' | 'params'>
+> {
     // eslint-disable-next-line jsdoc/require-jsdoc
     @Property.object({ cls: () => QueryObject, required: false, allowAdditionalProperties: true })
-    query: QueryObject | undefined;
+    query: QueryParamsObject | undefined;
 
     // eslint-disable-next-line jsdoc/require-jsdoc
     @Property.object({ cls: () => HeadersObject, allowAdditionalProperties: true })
-    headers!: Partial<Record<KnownHeader, string | undefined>>;
+    headers!: HeaderParamsObject;
 
     // eslint-disable-next-line jsdoc/require-jsdoc
     @Property.object({ cls: () => ParamsObject, required: false, allowAdditionalProperties: true })
-    params: ParamsObject | undefined;
+    params: PathParamsObject | undefined;
 
     // eslint-disable-next-line jsdoc/require-jsdoc
     @Property.unknown({ required: false })
-    body: unknown | undefined;
+    body: T | undefined;
 }
 
 /**

package/src/websocket/services/websocket.service.ts

@@ -256,8 +256,7 @@ export class WebsocketService implements WebsocketServiceInterface<SocketIOWebso
         }
 
         const messages: WebsocketMessage[] = await this.messageRepository.findAll({
-            where: whereFilters,
-            order: { seq: 'ASC' }
+            where: whereFilters
         });
 
         for (const m of messages) {

package/dist/cjs/data-source/data-sources/postgres-data-source.model.d.ts

@@ -1,129 +0,0 @@
-import { Readable } from 'node:stream';
-import { DataSource as TODataSource, EntityMetadata as TOEntityMetadata, EntitySchema, EntitySchemaColumnOptions, QueryRunner, EntitySchemaRelationOptions, TableColumnOptions, EntityTarget } from 'typeorm';
-import { PostgresConnectionOptions } from 'typeorm/driver/postgres/PostgresConnectionOptions.js';
-import { ColumnMetadata } from 'typeorm/metadata/ColumnMetadata.js';
-import { DataSourceInterface, IsolationLevel } from './data-source.interface';
-import { BaseEntity } from '../../entity/base-entity.model';
-import { PropertyMetadata, PropertyMetadataInput, RelationMetadata } from '../../entity/decorators/property.decorator';
-import { FilePropertyMetadata } from '../../entity/models/file-property-metadata.model';
-import { type LoggerInterface } from '../../logging/logger.interface';
-import { ExcludeStrict } from '../../types/exclude-strict.type';
-import { Newable } from '../../types/newable.type';
-import { OmitStrict } from '../../types/omit-strict.type';
-import { Migration } from '../migration/migration.model';
-import { ColumnType } from '../models/column-type.model';
-import { Repository } from '../repository';
-import { Transaction } from '../transaction/transaction.model';
-type ToColumnMappableTypes = ExcludeStrict<PropertyMetadata, RelationMetadata<BaseEntity>>['type'];
-/**
- * Postgres-specific connection options.
- */
-export type PostgresOptions = OmitStrict<PostgresConnectionOptions, 'entities' | 'type'>;
-/**
- * A base postgres data source definition.
- */
-export declare abstract class PostgresDataSource implements DataSourceInterface {
-    private readonly logger;
-    /**
-     * Mapping from a Zibri property type to a typeorm column type.
-     */
-    protected readonly columnTypeMappingOverride: Partial<Record<ToColumnMappableTypes, ColumnType>>;
-    private get columnTypeMapping();
-    abstract readonly options: PostgresOptions;
-    abstract readonly entities: Newable<BaseEntity>[];
-    /**
-     * The optional root password.
-     */
-    readonly rootPw: string | undefined;
-    /**
-     * The optional root username.
-     */
-    readonly rootUsername: string | undefined;
-    readonly migrations: Newable<Migration>[];
-    /**
-     * The internal typeorm data source.
-     */
-    protected ds?: TODataSource;
-    constructor(logger: LoggerInterface);
-    createBackupData(): Readable;
-    restoreBackup(backupData: Readable): Promise<void>;
-    init(): Promise<void>;
-    shutDown(): Promise<void>;
-    /**
-     * Gets entity schemas for the entities of this data source.
-     * @returns Typeorm entity schemas.
-     */
-    protected getEntitySchemas(): EntitySchema[];
-    /**
-     * Creates a typeorm entity schema for a single entity.
-     * @param cls - The entity class to create the schema for.
-     * @returns A typeorm entity schema.
-     * @throws When the provided entity was configured incorrectly.
-     */
-    protected createSchemaForEntity(cls: Newable<BaseEntity>): EntitySchema;
-    /**
-     * Transforms the given relation metadata to typeorm relation options.
-     * @param metadata - The relation metadata to transform.
-     * @returns Typeorm relation options.
-     */
-    protected propertyToRelationOptions<T extends BaseEntity>(metadata: RelationMetadata<T>): EntitySchemaRelationOptions;
-    private hasCascadeFlag;
-    /**
-     * Transforms the given property metadata to typeorm column options.
-     * @param metadata - The property metadata to transform.
-     * @returns Typeorm column options.
-     * @throws When the metadata is incorrect.
-     */
-    protected propertyToColumnOptions(metadata: ExcludeStrict<PropertyMetadata, RelationMetadata<BaseEntity>>): EntitySchemaColumnOptions;
-    getRepository<T extends BaseEntity>(cls: Newable<T>): Repository<T>;
-    startTransaction(isolationLevel?: IsolationLevel): Promise<Transaction>;
-    /**
-     * Creates a query runner.
-     * @returns A query runner.
-     * @throws When the data source has not been initialized yet.
-     */
-    createQueryRunner(): QueryRunner;
-    runMigrations(): Promise<void>;
-    addPropertyToEntity<T extends BaseEntity>(entity: Newable<T>, key: keyof T, transaction: Transaction): Promise<void>;
-    changePropertyOfEntity<T extends BaseEntity>(entity: Newable<T>, oldColumn: keyof T | string & {}, newColumn: PropertyMetadataInput & {
-        /**
-         * The name of the new column.
-         */
-        name?: keyof T;
-        /**
-         * The type of the new column.
-         */
-        type: ExcludeStrict<PropertyMetadata, RelationMetadata<BaseEntity> | FilePropertyMetadata>['type'];
-    }, transaction: Transaction): Promise<void>;
-    /**
-     * Gets the typeorm metadata for a given entity.
-     * @param target - The target entity.
-     * @param transaction - The transaction to run this command with.
-     * @returns The typeorm metadata.
-     */
-    protected getEntityMetadata<T extends BaseEntity>(target: EntityTarget<T>, transaction: Transaction): TOEntityMetadata;
-    /**
-     * Gets the metadata for a typeorm column.
-     * @param target - The entity.
-     * @param propertyName - The name of the property to get the column metadata for.
-     * @param transaction - The transaction to use to get the column metadata.
-     * @returns The typeorm column metadata.
-     * @throws When the provided propertyName could not be found as a column.
-     */
-    protected getColumnMetadata<T extends BaseEntity>(target: EntityTarget<T>, propertyName: keyof T | string & {}, transaction: Transaction): ColumnMetadata;
-    /**
-     * Creates a table for migrations if it does not exist already.
-     */
-    protected createMigrationTableIfNotExists(): Promise<void>;
-    /**
-     * Transforms the property on the given entity class to typeorm column options.
-     * @param entity - The entity class which property should be transformed.
-     * @param property - The key of the actual property that should be transformed.
-     * @returns Typeorm column options.
-     * @throws When no data source has been provided or no column metadata could be found.
-     */
-    protected propertyToTableColumnOptions<T extends BaseEntity>(entity: Newable<T>, property: keyof T): TableColumnOptions;
-    private normalizeColumnType;
-}
-export {};
-//# sourceMappingURL=postgres-data-source.model.d.ts.map

package/dist/cjs/data-source/data-sources/postgres-data-source.model.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"postgres-data-source.model.d.ts","sourceRoot":"","sources":["../../../../src/data-source/data-sources/postgres-data-source.model.ts"],"names":[],"mappings":"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"}