@spinajs/orm 2.0.179 → 2.0.181

package/lib/cjs/decorators.js

@@ -1,450 +1,450 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Set = exports.UniversalConverter = exports.Json = exports.DateTime = exports.HasManyToMany = exports.Historical = exports.HasMany = exports.ForwardBelongsTo = exports.BelongsTo = exports.forwardRef = exports.Recursive = exports.DiscriminationMap = exports.JunctionTable = exports.Uuid = exports.Ignore = exports.Primary = exports.Archived = exports.SoftDelete = exports.UpdatedAt = exports.CreatedAt = exports.Model = exports.Connection = exports.Migration = exports.extractDecoratorDescriptor = exports.MIGRATION_DESCRIPTION_SYMBOL = exports.MODEL_DESCTRIPTION_SYMBOL = void 0;
-/* eslint-disable prettier/prettier */
-const converters_js_1 = require("./converters.js");
-const di_1 = require("@spinajs/di");
-const interfaces_js_1 = require("./interfaces.js");
-require("reflect-metadata");
-const model_js_1 = require("./model.js");
-const exceptions_1 = require("@spinajs/exceptions");
-exports.MODEL_DESCTRIPTION_SYMBOL = Symbol.for('MODEL_DESCRIPTOR');
-exports.MIGRATION_DESCRIPTION_SYMBOL = Symbol.for('MIGRATION_DESCRIPTOR');
-/**
- * Helper func to create model metadata
- */
-function extractDecoratorDescriptor(callback, base = false) {
-    return (target, propertyKey, indexOrDescriptor) => {
-        let metadata = null;
-        if (!base) {
-            metadata = target.constructor[exports.MODEL_DESCTRIPTION_SYMBOL];
-        }
-        else {
-            metadata = target[exports.MODEL_DESCTRIPTION_SYMBOL];
-        }
-        if (!metadata) {
-            metadata = {
-                Driver: null,
-                Converters: new Map(),
-                Columns: [],
-                Connection: null,
-                PrimaryKey: '',
-                SoftDelete: {
-                    DeletedAt: '',
-                },
-                Archived: {
-                    ArchivedAt: '',
-                },
-                TableName: '',
-                Timestamps: {
-                    CreatedAt: '',
-                    UpdatedAt: '',
-                },
-                Relations: new Map(),
-                Name: target.constructor.name,
-                JunctionModelProperties: [],
-                DiscriminationMap: {
-                    Field: '',
-                    Models: null,
-                },
-                Schema: {},
-            };
-            if (!base) {
-                target.constructor[exports.MODEL_DESCTRIPTION_SYMBOL] = metadata;
-            }
-            else {
-                target[exports.MODEL_DESCTRIPTION_SYMBOL] = metadata;
-            }
-        }
-        if (callback) {
-            callback(metadata, target, propertyKey, indexOrDescriptor);
-        }
-    };
-}
-exports.extractDecoratorDescriptor = extractDecoratorDescriptor;
-/**
- * Sets migration option
- *
- * @param connection - connection name, must exists in configuration file
- */
-function Migration(connection) {
-    return (target) => {
-        let metadata = target[exports.MIGRATION_DESCRIPTION_SYMBOL];
-        if (!metadata) {
-            metadata = {
-                Connection: '',
-            };
-            target[exports.MIGRATION_DESCRIPTION_SYMBOL] = metadata;
-        }
-        metadata.Connection = connection;
-        di_1.DI.register(target).as('__migrations__');
-    };
-}
-exports.Migration = Migration;
-/**
- * Connection model decorator, assigns connection to model
- *
- * @param name - connection name, must be avaible in db config
- */
-function Connection(name) {
-    return extractDecoratorDescriptor((model) => {
-        model.Connection = name;
-    }, true);
-}
-exports.Connection = Connection;
-/**
- * TableName model decorator, assigns table from database to model
- *
- * @param name - table name in database that is referred by this model
- */
-function Model(tableName) {
-    return extractDecoratorDescriptor((model, target) => {
-        di_1.DI.register(target).as('__models__');
-        model.TableName = tableName;
-        model.Name = target.name;
-    }, true);
-}
-exports.Model = Model;
-/**
- * Set create timestamps feature to model. Proper columns must be avaible in database table.
- * It allow to track creation times & changes to model
- */
-function CreatedAt() {
-    return extractDecoratorDescriptor((model, target, propertyKey) => {
-        const type = Reflect.getMetadata('design:type', target, propertyKey);
-        if (type.name !== 'DateTime') {
-            throw Error(`Proprety ${propertyKey} marked as CreatedAt must be DateTime type, but is ${type.name}. Type: ${target.name}`);
-        }
-        model.Timestamps.CreatedAt = propertyKey;
-        // add converter for this field
-        model.Converters.set(propertyKey, {
-            Class: interfaces_js_1.DatetimeValueConverter,
-        });
-    });
-}
-exports.CreatedAt = CreatedAt;
-/**
- * Set update timestamps feature to model. Proper columns must be avaible in database table.
- * It allow to track creation times & changes to model
- */
-function UpdatedAt() {
-    return extractDecoratorDescriptor((model, target, propertyKey) => {
-        const type = Reflect.getMetadata('design:type', target, propertyKey);
-        if (type.name !== 'DateTime') {
-            throw Error(`Proprety ${propertyKey} marked as UpdatedAt must be DateTime type, but is ${type.name}. Type: ${target.name}`);
-        }
-        model.Timestamps.UpdatedAt = propertyKey;
-        // add converter for this field
-        model.Converters.set(propertyKey, {
-            Class: interfaces_js_1.DatetimeValueConverter,
-        });
-    });
-}
-exports.UpdatedAt = UpdatedAt;
-/**
- * Sets soft delete feature to model. Soft delete dont delete model, but sets deletion date and hides from
- * select result by default.
- */
-function SoftDelete() {
-    return extractDecoratorDescriptor((model, target, propertyKey) => {
-        const type = Reflect.getMetadata('design:type', target, propertyKey);
-        if (type.name !== 'DateTime') {
-            throw Error(`Proprety ${propertyKey} marked as DeletedAt must be DateTime type, but is ${type.name}. Type: ${target.name}`);
-        }
-        model.SoftDelete.DeletedAt = propertyKey;
-        // add converter for this field
-        model.Converters.set(propertyKey, {
-            Class: interfaces_js_1.DatetimeValueConverter,
-        });
-    });
-}
-exports.SoftDelete = SoftDelete;
-/**
- * Enable archive mode for model. If enabled all changes creates new instance in DB and old have set archived field
- * and gets attached to new model. It enabled to track changes to model in DB and also preserve data in relations.
- *
- */
-function Archived() {
-    return extractDecoratorDescriptor((model, target, propertyKey) => {
-        const type = Reflect.getMetadata('design:type', target, propertyKey);
-        if (type.name !== 'DateTime') {
-            throw Error(`Proprety ${propertyKey} marked as ArchivedAt must be DateTime type, but is ${type.name}. Type: ${target.name}`);
-        }
-        model.Archived.ArchivedAt = propertyKey;
-        // add converter for this field
-        model.Converters.set(propertyKey, {
-            Class: interfaces_js_1.DatetimeValueConverter,
-        });
-    });
-}
-exports.Archived = Archived;
-/**
- * Makrs field as primary key
- */
-function Primary() {
-    return extractDecoratorDescriptor((model, _target, propertyKey) => {
-        model.PrimaryKey = propertyKey;
-    });
-}
-exports.Primary = Primary;
-/**
- * Marks columns as UUID. Column will be generated ad creation
- */
-function Ignore() {
-    return extractDecoratorDescriptor((model, _target, propertyKey) => {
-        const columnDesc = model.Columns.find((c) => c.Name === propertyKey);
-        if (!columnDesc) {
-            // we dont want to fill all props, they will be loaded from db and mergeg with this
-            model.Columns.push({ Name: propertyKey, Ignore: true });
-        }
-        else {
-            columnDesc.Ignore = true;
-        }
-    }, true);
-}
-exports.Ignore = Ignore;
-/**
- * Marks columns as UUID. Column will be generated ad creation
- */
-function Uuid() {
-    return extractDecoratorDescriptor((model, _target, propertyKey) => {
-        const columnDesc = model.Columns.find((c) => c.Name === propertyKey);
-        if (!columnDesc) {
-            // we dont want to fill all props, they will be loaded from db and mergeg with this
-            model.Columns.push({ Name: propertyKey, Uuid: true });
-        }
-        else {
-            columnDesc.Uuid = true;
-        }
-        model.Converters.set(propertyKey, {
-            Class: converters_js_1.UuidConverter,
-        });
-    }, true);
-}
-exports.Uuid = Uuid;
-function JunctionTable() {
-    return extractDecoratorDescriptor((model, target, propertyKey) => {
-        model.JunctionModelProperties.push({
-            Name: propertyKey,
-            Model: Reflect.getMetadata('design:type', target, propertyKey),
-        });
-    });
-}
-exports.JunctionTable = JunctionTable;
-/**
- *
- * Marks model to have discrimination map.
- *
- * @param fieldName - db field name to look for
- * @param discriminationMap - field - model mapping
- */
-function DiscriminationMap(fieldName, discriminationMap) {
-    return extractDecoratorDescriptor((model, _target, _propertyKey) => {
-        model.DiscriminationMap.Field = fieldName;
-        model.DiscriminationMap.Models = new Map();
-        discriminationMap.forEach((d) => {
-            model.DiscriminationMap.Models.set(d.Key, d.Value);
-        });
-    }, true);
-}
-exports.DiscriminationMap = DiscriminationMap;
-/**
- * Marks relation as recursive. When relation is populated it loads all to the top
- *
- */
-function Recursive() {
-    return extractDecoratorDescriptor((model, _target, propertyKey) => {
-        if (!model.Relations.has(propertyKey)) {
-            throw new exceptions_1.InvalidOperation(`cannot set recursive on not existing relation ( relation ${propertyKey} on model ${model.Name} )`);
-        }
-        const relation = model.Relations.get(propertyKey);
-        relation.Recursive = true;
-    });
-}
-exports.Recursive = Recursive;
-const forwardRef = (fn) => ({
-    forwardRef: fn,
-});
-exports.forwardRef = forwardRef;
-/**
- * Creates one to one relation with target model.
- *
- * @param foreignKey - foreign key name in db, defaults to lowercase property name with _id suffix eg. owner_id
- * @param primaryKey - primary key in related model, defaults to primary key taken from db
- */
-function BelongsTo(targetModel, foreignKey, primaryKey) {
-    return extractDecoratorDescriptor((model, target, propertyKey) => {
-        model.Relations.set(propertyKey, {
-            Name: propertyKey,
-            Type: interfaces_js_1.RelationType.One,
-            SourceModel: target.constructor,
-            TargetModelType: targetModel,
-            TargetModel: null,
-            ForeignKey: foreignKey ?? `${propertyKey.toLowerCase()}_id`,
-            PrimaryKey: primaryKey ?? model.PrimaryKey,
-            Recursive: false,
-        });
-    });
-}
-exports.BelongsTo = BelongsTo;
-/**
- * Creates one to one relation with target model.
- *
- * @param foreignKey - foreign key name in db, defaults to lowercase property name with _id suffix eg. owner_id
- * @param primaryKey - primary key in related model, defaults to primary key taken from db
- */
-function ForwardBelongsTo(forwardRef, foreignKey, primaryKey) {
-    return extractDecoratorDescriptor((model, target, propertyKey) => {
-        model.Relations.set(propertyKey, {
-            Name: propertyKey,
-            Type: interfaces_js_1.RelationType.One,
-            SourceModel: target.constructor,
-            TargetModelType: forwardRef.forwardRef,
-            TargetModel: null,
-            ForeignKey: foreignKey ?? `${propertyKey.toLowerCase()}_id`,
-            PrimaryKey: primaryKey ?? model.PrimaryKey,
-            Recursive: false,
-        });
-    });
-}
-exports.ForwardBelongsTo = ForwardBelongsTo;
-/**
- * Creates one to many relation with target model.
- *
- * @param targetModel - due to limitations of metadata reflection api in typescript target model mus be set explicitly
- * @param foreignKey - foreign key name in db, defaults to lowercase property name with _id suffix eg. owner_id
- * @param primaryKey - primary key in source table defaults to lowercase property name with _id suffix eg. owner_id
- *
- */
-function HasMany(targetModel, options) {
-    return extractDecoratorDescriptor((model, target, propertyKey) => {
-        model.Relations.set(propertyKey, {
-            Name: propertyKey,
-            Type: interfaces_js_1.RelationType.Many,
-            SourceModel: target.constructor,
-            TargetModelType: targetModel,
-            TargetModel: null,
-            ForeignKey: options ? options.foreignKey ?? `${model.Name.toLowerCase()}_id` : `${model.Name.toLowerCase()}_id`,
-            PrimaryKey: options ? options.primaryKey ?? model.PrimaryKey : model.PrimaryKey,
-            Recursive: false,
-            Factory: options ? options.factory : null,
-            RelationClass: options ? options.type : null,
-        });
-    });
-}
-exports.HasMany = HasMany;
-function Historical(targetModel) {
-    return extractDecoratorDescriptor((model, target, propertyKey) => {
-        model.Relations.set(propertyKey, {
-            Name: propertyKey,
-            Type: interfaces_js_1.RelationType.Many,
-            SourceModel: target.constructor,
-            TargetModelType: targetModel,
-            TargetModel: null,
-            ForeignKey: model.PrimaryKey,
-            PrimaryKey: model.PrimaryKey,
-            Recursive: false,
-        });
-    });
-}
-exports.Historical = Historical;
-/**
- * Creates many to many relation with separate join table
- *
- * @param junctionModel - model for junction table
- * @param targetModel - model for related data
- * @param targetModelPKey - target model primary key name
- * @param sourceModelPKey - source model primary key name
- * @param junctionModelTargetPk - junction table target primary key name ( foreign key for target model )
- * @param junctionModelSourcePk - junction table source primary key name ( foreign key for source model )
- */
-function HasManyToMany(junctionModel, targetModel, targetModelPKey, sourceModelPKey, junctionModelTargetPk, junctionModelSourcePk) {
-    return extractDecoratorDescriptor((model, target, propertyKey) => {
-        const targetModelDescriptor = (0, model_js_1.extractModelDescriptor)(targetModel);
-        model.Relations.set(propertyKey, {
-            Name: propertyKey,
-            Recursive: false,
-            Type: interfaces_js_1.RelationType.ManyToMany,
-            SourceModel: target.constructor,
-            TargetModelType: targetModel,
-            TargetModel: null,
-            ForeignKey: targetModelPKey ?? targetModelDescriptor.PrimaryKey,
-            PrimaryKey: sourceModelPKey ?? model.PrimaryKey,
-            JunctionModel: junctionModel,
-            JunctionModelTargetModelFKey_Name: junctionModelTargetPk ?? `${targetModelDescriptor.Name.toLowerCase()}_id`,
-            JunctionModelSourceModelFKey_Name: junctionModelSourcePk ?? `${model.Name.toLowerCase()}_id`,
-        });
-    });
-}
-exports.HasManyToMany = HasManyToMany;
-/**
- * Mark field as datetime type. It will ensure that conversion to & from DB is valid, eg. sqlite DB
- * saves datetime as TEXT and ISO8601 strings
- */
-function DateTime() {
-    return extractDecoratorDescriptor((model, target, propertyKey) => {
-        const type = Reflect.getMetadata('design:type', target, propertyKey);
-        if (type.name !== 'DateTime') {
-            throw Error(`Proprety  ${propertyKey} must be DateTime type`);
-        }
-        if (model.Converters.has(propertyKey)) {
-            throw new exceptions_1.InvalidArgument(`property ${propertyKey} already have data converter attached`);
-        }
-        model.Converters.set(propertyKey, {
-            Class: interfaces_js_1.DatetimeValueConverter,
-        });
-    });
-}
-exports.DateTime = DateTime;
-/**
- * Converts data in db to json object. Column type in DB should be STRING.
- * DO not use this decorator for use of native DB JSON implementation.
- * ORM will detect automatically if field is native JSON DB type.
- */
-function Json() {
-    return extractDecoratorDescriptor((model, _, propertyKey) => {
-        // add converter for this field
-        model.Converters.set(propertyKey, {
-            Class: converters_js_1.JsonValueConverter,
-        });
-    });
-}
-exports.Json = Json;
-/**
- *
- * Universal converter that guess whitch type to return. Usefull in tables that holds as text different values
- * eg. metadata table
- *
- * @param typeColumn - type column that defines final type of value
- */
-function UniversalConverter(typeColumn) {
-    return extractDecoratorDescriptor((model, _, propertyKey) => {
-        // add converter for this field
-        model.Converters.set(propertyKey, {
-            Class: converters_js_1.JsonValueConverter,
-            Options: {
-                TypeColumn: typeColumn,
-            },
-        });
-    });
-}
-exports.UniversalConverter = UniversalConverter;
-/**
- * Mark field as SET type. It will ensure that conversion to & from DB is valid, eg. to emulate field type SET in sqlite
- */
-function Set() {
-    return extractDecoratorDescriptor((model, target, propertyKey) => {
-        const type = Reflect.getMetadata('design:type', target, propertyKey);
-        if (type.name !== 'Array') {
-            throw Error(`Proprety  ${propertyKey} must be an array type`);
-        }
-        if (model.Converters.has(propertyKey)) {
-            throw new exceptions_1.InvalidArgument(`property ${propertyKey} already have data converter attached`);
-        }
-        model.Converters.set(propertyKey, {
-            Class: interfaces_js_1.SetValueConverter,
-        });
-    });
-}
-exports.Set = Set;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Set = exports.UniversalConverter = exports.Json = exports.DateTime = exports.HasManyToMany = exports.Historical = exports.HasMany = exports.ForwardBelongsTo = exports.BelongsTo = exports.forwardRef = exports.Recursive = exports.DiscriminationMap = exports.JunctionTable = exports.Uuid = exports.Ignore = exports.Primary = exports.Archived = exports.SoftDelete = exports.UpdatedAt = exports.CreatedAt = exports.Model = exports.Connection = exports.Migration = exports.extractDecoratorDescriptor = exports.MIGRATION_DESCRIPTION_SYMBOL = exports.MODEL_DESCTRIPTION_SYMBOL = void 0;
+/* eslint-disable prettier/prettier */
+const converters_js_1 = require("./converters.js");
+const di_1 = require("@spinajs/di");
+const interfaces_js_1 = require("./interfaces.js");
+require("reflect-metadata");
+const model_js_1 = require("./model.js");
+const exceptions_1 = require("@spinajs/exceptions");
+exports.MODEL_DESCTRIPTION_SYMBOL = Symbol.for('MODEL_DESCRIPTOR');
+exports.MIGRATION_DESCRIPTION_SYMBOL = Symbol.for('MIGRATION_DESCRIPTOR');
+/**
+ * Helper func to create model metadata
+ */
+function extractDecoratorDescriptor(callback, base = false) {
+    return (target, propertyKey, indexOrDescriptor) => {
+        let metadata = null;
+        if (!base) {
+            metadata = target.constructor[exports.MODEL_DESCTRIPTION_SYMBOL];
+        }
+        else {
+            metadata = target[exports.MODEL_DESCTRIPTION_SYMBOL];
+        }
+        if (!metadata) {
+            metadata = {
+                Driver: null,
+                Converters: new Map(),
+                Columns: [],
+                Connection: null,
+                PrimaryKey: '',
+                SoftDelete: {
+                    DeletedAt: '',
+                },
+                Archived: {
+                    ArchivedAt: '',
+                },
+                TableName: '',
+                Timestamps: {
+                    CreatedAt: '',
+                    UpdatedAt: '',
+                },
+                Relations: new Map(),
+                Name: target.constructor.name,
+                JunctionModelProperties: [],
+                DiscriminationMap: {
+                    Field: '',
+                    Models: null,
+                },
+                Schema: {},
+            };
+            if (!base) {
+                target.constructor[exports.MODEL_DESCTRIPTION_SYMBOL] = metadata;
+            }
+            else {
+                target[exports.MODEL_DESCTRIPTION_SYMBOL] = metadata;
+            }
+        }
+        if (callback) {
+            callback(metadata, target, propertyKey, indexOrDescriptor);
+        }
+    };
+}
+exports.extractDecoratorDescriptor = extractDecoratorDescriptor;
+/**
+ * Sets migration option
+ *
+ * @param connection - connection name, must exists in configuration file
+ */
+function Migration(connection) {
+    return (target) => {
+        let metadata = target[exports.MIGRATION_DESCRIPTION_SYMBOL];
+        if (!metadata) {
+            metadata = {
+                Connection: '',
+            };
+            target[exports.MIGRATION_DESCRIPTION_SYMBOL] = metadata;
+        }
+        metadata.Connection = connection;
+        di_1.DI.register(target).as('__migrations__');
+    };
+}
+exports.Migration = Migration;
+/**
+ * Connection model decorator, assigns connection to model
+ *
+ * @param name - connection name, must be avaible in db config
+ */
+function Connection(name) {
+    return extractDecoratorDescriptor((model) => {
+        model.Connection = name;
+    }, true);
+}
+exports.Connection = Connection;
+/**
+ * TableName model decorator, assigns table from database to model
+ *
+ * @param name - table name in database that is referred by this model
+ */
+function Model(tableName) {
+    return extractDecoratorDescriptor((model, target) => {
+        di_1.DI.register(target).as('__models__');
+        model.TableName = tableName;
+        model.Name = target.name;
+    }, true);
+}
+exports.Model = Model;
+/**
+ * Set create timestamps feature to model. Proper columns must be avaible in database table.
+ * It allow to track creation times & changes to model
+ */
+function CreatedAt() {
+    return extractDecoratorDescriptor((model, target, propertyKey) => {
+        const type = Reflect.getMetadata('design:type', target, propertyKey);
+        if (type.name !== 'DateTime') {
+            throw Error(`Proprety ${propertyKey} marked as CreatedAt must be DateTime type, but is ${type.name}. Type: ${target.name}`);
+        }
+        model.Timestamps.CreatedAt = propertyKey;
+        // add converter for this field
+        model.Converters.set(propertyKey, {
+            Class: interfaces_js_1.DatetimeValueConverter,
+        });
+    });
+}
+exports.CreatedAt = CreatedAt;
+/**
+ * Set update timestamps feature to model. Proper columns must be avaible in database table.
+ * It allow to track creation times & changes to model
+ */
+function UpdatedAt() {
+    return extractDecoratorDescriptor((model, target, propertyKey) => {
+        const type = Reflect.getMetadata('design:type', target, propertyKey);
+        if (type.name !== 'DateTime') {
+            throw Error(`Proprety ${propertyKey} marked as UpdatedAt must be DateTime type, but is ${type.name}. Type: ${target.name}`);
+        }
+        model.Timestamps.UpdatedAt = propertyKey;
+        // add converter for this field
+        model.Converters.set(propertyKey, {
+            Class: interfaces_js_1.DatetimeValueConverter,
+        });
+    });
+}
+exports.UpdatedAt = UpdatedAt;
+/**
+ * Sets soft delete feature to model. Soft delete dont delete model, but sets deletion date and hides from
+ * select result by default.
+ */
+function SoftDelete() {
+    return extractDecoratorDescriptor((model, target, propertyKey) => {
+        const type = Reflect.getMetadata('design:type', target, propertyKey);
+        if (type.name !== 'DateTime') {
+            throw Error(`Proprety ${propertyKey} marked as DeletedAt must be DateTime type, but is ${type.name}. Type: ${target.name}`);
+        }
+        model.SoftDelete.DeletedAt = propertyKey;
+        // add converter for this field
+        model.Converters.set(propertyKey, {
+            Class: interfaces_js_1.DatetimeValueConverter,
+        });
+    });
+}
+exports.SoftDelete = SoftDelete;
+/**
+ * Enable archive mode for model. If enabled all changes creates new instance in DB and old have set archived field
+ * and gets attached to new model. It enabled to track changes to model in DB and also preserve data in relations.
+ *
+ */
+function Archived() {
+    return extractDecoratorDescriptor((model, target, propertyKey) => {
+        const type = Reflect.getMetadata('design:type', target, propertyKey);
+        if (type.name !== 'DateTime') {
+            throw Error(`Proprety ${propertyKey} marked as ArchivedAt must be DateTime type, but is ${type.name}. Type: ${target.name}`);
+        }
+        model.Archived.ArchivedAt = propertyKey;
+        // add converter for this field
+        model.Converters.set(propertyKey, {
+            Class: interfaces_js_1.DatetimeValueConverter,
+        });
+    });
+}
+exports.Archived = Archived;
+/**
+ * Makrs field as primary key
+ */
+function Primary() {
+    return extractDecoratorDescriptor((model, _target, propertyKey) => {
+        model.PrimaryKey = propertyKey;
+    });
+}
+exports.Primary = Primary;
+/**
+ * Marks columns as UUID. Column will be generated ad creation
+ */
+function Ignore() {
+    return extractDecoratorDescriptor((model, _target, propertyKey) => {
+        const columnDesc = model.Columns.find((c) => c.Name === propertyKey);
+        if (!columnDesc) {
+            // we dont want to fill all props, they will be loaded from db and mergeg with this
+            model.Columns.push({ Name: propertyKey, Ignore: true });
+        }
+        else {
+            columnDesc.Ignore = true;
+        }
+    }, true);
+}
+exports.Ignore = Ignore;
+/**
+ * Marks columns as UUID. Column will be generated ad creation
+ */
+function Uuid() {
+    return extractDecoratorDescriptor((model, _target, propertyKey) => {
+        const columnDesc = model.Columns.find((c) => c.Name === propertyKey);
+        if (!columnDesc) {
+            // we dont want to fill all props, they will be loaded from db and mergeg with this
+            model.Columns.push({ Name: propertyKey, Uuid: true });
+        }
+        else {
+            columnDesc.Uuid = true;
+        }
+        model.Converters.set(propertyKey, {
+            Class: converters_js_1.UuidConverter,
+        });
+    }, true);
+}
+exports.Uuid = Uuid;
+function JunctionTable() {
+    return extractDecoratorDescriptor((model, target, propertyKey) => {
+        model.JunctionModelProperties.push({
+            Name: propertyKey,
+            Model: Reflect.getMetadata('design:type', target, propertyKey),
+        });
+    });
+}
+exports.JunctionTable = JunctionTable;
+/**
+ *
+ * Marks model to have discrimination map.
+ *
+ * @param fieldName - db field name to look for
+ * @param discriminationMap - field - model mapping
+ */
+function DiscriminationMap(fieldName, discriminationMap) {
+    return extractDecoratorDescriptor((model, _target, _propertyKey) => {
+        model.DiscriminationMap.Field = fieldName;
+        model.DiscriminationMap.Models = new Map();
+        discriminationMap.forEach((d) => {
+            model.DiscriminationMap.Models.set(d.Key, d.Value);
+        });
+    }, true);
+}
+exports.DiscriminationMap = DiscriminationMap;
+/**
+ * Marks relation as recursive. When relation is populated it loads all to the top
+ *
+ */
+function Recursive() {
+    return extractDecoratorDescriptor((model, _target, propertyKey) => {
+        if (!model.Relations.has(propertyKey)) {
+            throw new exceptions_1.InvalidOperation(`cannot set recursive on not existing relation ( relation ${propertyKey} on model ${model.Name} )`);
+        }
+        const relation = model.Relations.get(propertyKey);
+        relation.Recursive = true;
+    });
+}
+exports.Recursive = Recursive;
+const forwardRef = (fn) => ({
+    forwardRef: fn,
+});
+exports.forwardRef = forwardRef;
+/**
+ * Creates one to one relation with target model.
+ *
+ * @param foreignKey - foreign key name in db, defaults to lowercase property name with _id suffix eg. owner_id
+ * @param primaryKey - primary key in related model, defaults to primary key taken from db
+ */
+function BelongsTo(targetModel, foreignKey, primaryKey) {
+    return extractDecoratorDescriptor((model, target, propertyKey) => {
+        model.Relations.set(propertyKey, {
+            Name: propertyKey,
+            Type: interfaces_js_1.RelationType.One,
+            SourceModel: target.constructor,
+            TargetModelType: targetModel,
+            TargetModel: null,
+            ForeignKey: foreignKey ?? `${propertyKey.toLowerCase()}_id`,
+            PrimaryKey: primaryKey ?? model.PrimaryKey,
+            Recursive: false,
+        });
+    });
+}
+exports.BelongsTo = BelongsTo;
+/**
+ * Creates one to one relation with target model.
+ *
+ * @param foreignKey - foreign key name in db, defaults to lowercase property name with _id suffix eg. owner_id
+ * @param primaryKey - primary key in related model, defaults to primary key taken from db
+ */
+function ForwardBelongsTo(forwardRef, foreignKey, primaryKey) {
+    return extractDecoratorDescriptor((model, target, propertyKey) => {
+        model.Relations.set(propertyKey, {
+            Name: propertyKey,
+            Type: interfaces_js_1.RelationType.One,
+            SourceModel: target.constructor,
+            TargetModelType: forwardRef.forwardRef,
+            TargetModel: null,
+            ForeignKey: foreignKey ?? `${propertyKey.toLowerCase()}_id`,
+            PrimaryKey: primaryKey ?? model.PrimaryKey,
+            Recursive: false,
+        });
+    });
+}
+exports.ForwardBelongsTo = ForwardBelongsTo;
+/**
+ * Creates one to many relation with target model.
+ *
+ * @param targetModel - due to limitations of metadata reflection api in typescript target model mus be set explicitly
+ * @param foreignKey - foreign key name in db, defaults to lowercase property name with _id suffix eg. owner_id
+ * @param primaryKey - primary key in source table defaults to lowercase property name with _id suffix eg. owner_id
+ *
+ */
+function HasMany(targetModel, options) {
+    return extractDecoratorDescriptor((model, target, propertyKey) => {
+        model.Relations.set(propertyKey, {
+            Name: propertyKey,
+            Type: interfaces_js_1.RelationType.Many,
+            SourceModel: target.constructor,
+            TargetModelType: targetModel,
+            TargetModel: null,
+            ForeignKey: options ? options.foreignKey ?? `${model.Name.toLowerCase()}_id` : `${model.Name.toLowerCase()}_id`,
+            PrimaryKey: options ? options.primaryKey ?? model.PrimaryKey : model.PrimaryKey,
+            Recursive: false,
+            Factory: options ? options.factory : null,
+            RelationClass: options ? options.type : null,
+        });
+    });
+}
+exports.HasMany = HasMany;
+function Historical(targetModel) {
+    return extractDecoratorDescriptor((model, target, propertyKey) => {
+        model.Relations.set(propertyKey, {
+            Name: propertyKey,
+            Type: interfaces_js_1.RelationType.Many,
+            SourceModel: target.constructor,
+            TargetModelType: targetModel,
+            TargetModel: null,
+            ForeignKey: model.PrimaryKey,
+            PrimaryKey: model.PrimaryKey,
+            Recursive: false,
+        });
+    });
+}
+exports.Historical = Historical;
+/**
+ * Creates many to many relation with separate join table
+ *
+ * @param junctionModel - model for junction table
+ * @param targetModel - model for related data
+ * @param targetModelPKey - target model primary key name
+ * @param sourceModelPKey - source model primary key name
+ * @param junctionModelTargetPk - junction table target primary key name ( foreign key for target model )
+ * @param junctionModelSourcePk - junction table source primary key name ( foreign key for source model )
+ */
+function HasManyToMany(junctionModel, targetModel, targetModelPKey, sourceModelPKey, junctionModelTargetPk, junctionModelSourcePk) {
+    return extractDecoratorDescriptor((model, target, propertyKey) => {
+        const targetModelDescriptor = (0, model_js_1.extractModelDescriptor)(targetModel);
+        model.Relations.set(propertyKey, {
+            Name: propertyKey,
+            Recursive: false,
+            Type: interfaces_js_1.RelationType.ManyToMany,
+            SourceModel: target.constructor,
+            TargetModelType: targetModel,
+            TargetModel: null,
+            ForeignKey: targetModelPKey ?? targetModelDescriptor.PrimaryKey,
+            PrimaryKey: sourceModelPKey ?? model.PrimaryKey,
+            JunctionModel: junctionModel,
+            JunctionModelTargetModelFKey_Name: junctionModelTargetPk ?? `${targetModelDescriptor.Name.toLowerCase()}_id`,
+            JunctionModelSourceModelFKey_Name: junctionModelSourcePk ?? `${model.Name.toLowerCase()}_id`,
+        });
+    });
+}
+exports.HasManyToMany = HasManyToMany;
+/**
+ * Mark field as datetime type. It will ensure that conversion to & from DB is valid, eg. sqlite DB
+ * saves datetime as TEXT and ISO8601 strings
+ */
+function DateTime() {
+    return extractDecoratorDescriptor((model, target, propertyKey) => {
+        const type = Reflect.getMetadata('design:type', target, propertyKey);
+        if (type.name !== 'DateTime') {
+            throw Error(`Proprety  ${propertyKey} must be DateTime type`);
+        }
+        if (model.Converters.has(propertyKey)) {
+            throw new exceptions_1.InvalidArgument(`property ${propertyKey} already have data converter attached`);
+        }
+        model.Converters.set(propertyKey, {
+            Class: interfaces_js_1.DatetimeValueConverter,
+        });
+    });
+}
+exports.DateTime = DateTime;
+/**
+ * Converts data in db to json object. Column type in DB should be STRING.
+ * DO not use this decorator for use of native DB JSON implementation.
+ * ORM will detect automatically if field is native JSON DB type.
+ */
+function Json() {
+    return extractDecoratorDescriptor((model, _, propertyKey) => {
+        // add converter for this field
+        model.Converters.set(propertyKey, {
+            Class: converters_js_1.JsonValueConverter,
+        });
+    });
+}
+exports.Json = Json;
+/**
+ *
+ * Universal converter that guess whitch type to return. Usefull in tables that holds as text different values
+ * eg. metadata table
+ *
+ * @param typeColumn - type column that defines final type of value
+ */
+function UniversalConverter(typeColumn) {
+    return extractDecoratorDescriptor((model, _, propertyKey) => {
+        // add converter for this field
+        model.Converters.set(propertyKey, {
+            Class: converters_js_1.JsonValueConverter,
+            Options: {
+                TypeColumn: typeColumn,
+            },
+        });
+    });
+}
+exports.UniversalConverter = UniversalConverter;
+/**
+ * Mark field as SET type. It will ensure that conversion to & from DB is valid, eg. to emulate field type SET in sqlite
+ */
+function Set() {
+    return extractDecoratorDescriptor((model, target, propertyKey) => {
+        const type = Reflect.getMetadata('design:type', target, propertyKey);
+        if (type.name !== 'Array') {
+            throw Error(`Proprety  ${propertyKey} must be an array type`);
+        }
+        if (model.Converters.has(propertyKey)) {
+            throw new exceptions_1.InvalidArgument(`property ${propertyKey} already have data converter attached`);
+        }
+        model.Converters.set(propertyKey, {
+            Class: interfaces_js_1.SetValueConverter,
+        });
+    });
+}
+exports.Set = Set;
 //# sourceMappingURL=decorators.js.map