kool-koala 1.3.0 → 1.4.0

package/README.md

@@ -69,3 +69,129 @@ const configuration = new Configuration({
   ]
 });
 ```
+
+## Database connection
+
+You can also setup a database connection with kool-koala, by setting a few parameters for the configuration.
+
+```
+const configuration = new Configuration({
+  ...
+  database: {,
+    dataSource: new DataSource({
+      type: 'postgres',
+      host: 'localhost',
+      port: 5432,
+      username: 'username',
+      password: 'passwor',
+      database: 'database',
+      entities: [
+        // List of classes what you want to manage within the application.
+      ]
+    })
+    shouldRunMigrations
+  }
+});
+```
+
+> **Note:** For every database connection configuration what you can pass to the DataSource object, please see the documentation of [TypeORM](https://typeorm.io/data-source-options).
+
+## Database entities
+
+The package provides multiple classes what you can extend to create database entities what already implement some functionalities so you don't have to implement it yourself.
+
+> **Note:** About how you can declare the attributes of the entities, please see the documentation of [TypeORM](https://typeorm.io/entities).
+
+### EntityBase
+
+This class contains an `id` attribute, which will be an auto increment id for the entities which extends this class.
+
+### AuditedEntityBase
+
+Extending the `EntityBase` class, it inherits all its functionalities.
+
+This class contains a `createdAt` attribute which will be set to the current date and time when an entity is being saved into the database.
+
+This class also contains an `updatedAt` attribute which will be set to the current date and time when an entity is modified and saved into the database. After the entity creation it's value will be the same as the `createdAt` field's value.
+
+### SoftDeletableEntityBase
+
+Extending the `EntityBase` class, it inherits all its functionalities.
+
+This class provides the possibility to mark the entities in the database as deleted and exempt them from the query results.
+
+It contains a `deletedAt` attribute which remains null until the entity is being deleted. After that the value of the attribute will store the date and time of deletion of the entity.
+
+> **Note:** These functionalities only work if the entity is being manipulated with a repository which extends `SoftDeletableRepositoryBase` class.
+
+### SoftDeletableAuditedEntityBase
+
+Extending the `AuditedEntityBase` class, it inherits all its functionalities.
+
+This class combines the functionalities of the `EntityBase`, `AuditedEntityBase` and the `SoftDeletableEntityBase` classes.
+
+## Repositories
+
+The package provides repository classes which help the user to manipulate entities in the database.
+
+### RepositoryBase
+
+This class provides methods which implements basic manipulative and query methods for the entities.
+
+To use this class you have to create a class which extends it and implements the abstract methods.
+
+The class requires a generic type which have to be a class which implements the `IdentifiableEntity` interface. For example if you provide a class which extends the `EntityBase` class, that would be correct.
+
+> **Note:** All of the methods described below mainly manipulates the entities of the type provided in the `T` generic type for the class.
+
+> **Note:** You can find information about the following classes in the documentation of TypeORM: `FindManyOptions`, `FindOneOptions`, `FindOptionsWhere`, `FindOptionsRelations`, `DeepPartial`, `DeleteResult`
+
+**getAll(): Promise<T[]>**
+
+Returns a Promise which will resolve all entities from the database.
+
+**getWhere(options: FindManyOptions<T>): Promise<T[]>**
+
+Returns a Promise which will resolve those entities which matches the provided where criterias in the `options` parameter.
+
+**getOneWhere(options: FindOneOptions<T>): Promise<T>**
+
+Returns a Promise which will resolve the first entity which matches the provided where criterias in the `options` parameter.
+
+**getById(id: number, relations?: FindOptionsRelations<T>): Promise<T>**
+
+Returns a Promise which will resolve the entity with the provided `id`. It can also load related entities which is provided in the `relations` parameter.
+
+**save(entity: T | DeepPartial<T>): Promise<DeepPartial<T> & T>**
+
+Saves the provided entity into the database. If the primary key attribute is set, it will update the already existing entity, if it isn't, then it will insert the entity into the database.
+
+Returns a Promise which will resolve the saved entity.
+
+**delete(entity: T): Promise<DeleteResult>**
+
+Deletes the specified entity from the database.
+
+Returns a Promise which will resolve an object which contain information about the deletion.
+
+**deleteWhere(where?: FindOptionsWhere<T>): Promise<DeleteResult>**
+
+Deletes those entities which matches the provided where criterias.
+
+Returns a Promise which will resolve an object which contain information about the deletion.
+
+**deleteAll(): Promise<DeleteResult>**
+
+Deletes all entities from the database.
+
+Returns a Promise which will resolve an object which contain information about the deletion.
+
+### SoftDeletableRepositoryBase
+
+This class extends the `RepositoryBase` class.
+
+The class requires a generic type which have to be a class which implements the `IdentifiableEntity` and the `SoftDeletable` interfaces. For example if you provide a class which extends the `SoftDeletableEntityBase` class or the `SoftDeletableAuditedEntityBase`, that would be correct.
+
+The `getAll`, `getWhere`, `getOneWhere` and the `getById` methods works the same way as in the `RepositoryBase` class they just have an optional `boolean` typed `withDeleted` parameter at the end of the parameters list, which is `false` by default and it handles if the entities which is marked as deleted have to be returned by the query or not. If it is true, it will returns the entities which is marked as deleted.
+
+The `delete`, `deleteWhere` and the `deleteAll` methods works the same way as in the `RepositoryBase` class they just have an optional `boolean` typed `hardDelete` parameter at the end of the parameters list, which is `false` by default and if it is true, it will not only marks the entities as deleted but literally delete them from the database.

package/common/configuration-parameters.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/../src/common/configuration-parameters.ts"],"names":[],"mappings":"","file":"configuration-parameters.js","sourcesContent":["import { ControllerConstructor } from \"../controllers\";\nimport { AuthenticableEntity } from \"../types\";\nimport { StringEnum } from \"../types/common/string-enum\";\nimport { JwtConfigurationParameters } from \"./jwt-configuration-parameters\";\nimport { DatabaseConfigurationParamters } from \"./database-configuration-paramters\";\nimport { RepositoryBase } from \"../database\";\n\nexport interface ConfigurationParameters<\n  U extends AuthenticableEntity = AuthenticableEntity,\n  P extends StringEnum = {}\n> {\n  port: number,\n  controllers?: (ControllerConstructor)[],\n  database?: DatabaseConfigurationParamters,\n  jwt?: JwtConfigurationParameters,\n  userRepository?: RepositoryBase<U>,\n  permissionType?: P,\n  restPrefix?: string,\n}"]}
+{"version":3,"sources":["../src/../src/common/configuration-parameters.ts"],"names":[],"mappings":"","file":"configuration-parameters.js","sourcesContent":["import { ControllerConstructor } from \"../controllers\";\nimport { AuthenticableEntity } from \"../types\";\nimport { StringEnum } from \"../types/common/string-enum\";\nimport { JwtConfigurationParameters } from \"./jwt-configuration-parameters\";\nimport { DatabaseConfigurationParamters } from \"./database-configuration-paramters\";\nimport { RepositoryBase } from \"../database\";\n\nexport interface ConfigurationParameters<\n  U extends AuthenticableEntity = AuthenticableEntity,\n  P extends StringEnum = {}\n> {\n  port: number,\n  controllers?: (ControllerConstructor)[],\n  database?: DatabaseConfigurationParamters,\n  jwt?: JwtConfigurationParameters,\n  userRepository?: RepositoryBase<U>,\n  permissionType?: P,\n  restPrefix?: string,\n}\n"]}

package/common/koalapp.d.ts

@@ -11,17 +11,22 @@ export declare class KoalApp<U extends AuthenticableEntity, P extends StringEnum
     private koa;
     private routerService;
     private databaseConnection;
+    private server;
     private authorizationService;
     private constructor();
     static getInstance<T extends AuthenticableEntity, Q extends StringEnum>(configuration?: Configuration<T, Q>): KoalApp<T, Q>;
-    static resetInstance(): void;
+    static resetInstance(): Promise<void>;
     getConfiguration(): Configuration<U, P>;
     getRouterService(): RouterService;
     getDatabaseConnection(): DataSource;
     initialize(): Promise<void>;
+    setupDatabaseConnection(): Promise<void>;
+    setupErrorHandler(): void;
+    setupTransaction(): void;
     registerStaticFileServerMiddleware(): void;
     registerEndpoints(): void;
     start(callback?: (configuration: Configuration<U, P>) => void): Promise<void>;
+    stop(): void;
     authorizationHeaderParser(context: ParameterizedContext, next: Next): Promise<void>;
     errorHandler(context: ParameterizedContext, next: Next): Promise<void>;
     getAuthorizationService(): AuthorizationService<U, P>;

package/common/koalapp.js

@@ -22,6 +22,8 @@ const types_1 = require("../types");
 const koa_static_1 = __importDefault(require("koa-static"));
 const path_1 = __importDefault(require("path"));
 const fs_1 = __importDefault(require("fs"));
+const error_handler_middleware_1 = require("../middlewares/error-handler-middleware");
+const transaction_middleware_1 = require("../middlewares/transaction-middleware");
 class KoalApp {
     constructor(configuration) {
         this.configuration = configuration;
@@ -37,7 +39,10 @@ class KoalApp {
         return KoalApp.instance;
     }
     static resetInstance() {
-        KoalApp.instance = undefined;
+        return __awaiter(this, void 0, void 0, function* () {
+            yield KoalApp.getInstance().getDatabaseConnection().destroy();
+            KoalApp.instance = undefined;
+        });
     }
     getConfiguration() {
         return this.configuration;
@@ -51,21 +56,16 @@ class KoalApp {
     initialize() {
         return __awaiter(this, void 0, void 0, function* () {
             try {
-                if (this.configuration.getDatabase()) {
-                    this.databaseConnection = yield this.configuration.getDatabase().dataSource.initialize();
-                    if (this.configuration.getDatabase().shouldRunMigrations) {
-                        console.log("Executing database migrations...");
-                        yield this.databaseConnection.runMigrations();
-                        console.log("Database migrations executed.");
-                    }
-                    console.log("Database connection initialized.");
-                }
+                yield this.setupDatabaseConnection();
+                console.log("Database connection initialized.");
+                this.setupErrorHandler();
+                console.log("Error handler initialized.");
+                this.setupTransaction();
+                console.log("Transaction starter middleware initialized.");
                 this.koa.use(this.authorizationHeaderParser.bind(this));
                 console.log("Authorization header parser initialized.");
                 this.koa.use((0, koa_bodyparser_1.default)());
                 console.log("Body parser initialized.");
-                this.koa.use(this.errorHandler.bind(this));
-                console.log("Error handler initialized.");
                 this.registerStaticFileServerMiddleware();
                 console.log("Static file server initialized.");
                 this.registerEndpoints();
@@ -77,6 +77,20 @@ class KoalApp {
             }
         });
     }
+    setupDatabaseConnection() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.configuration.getDatabase()) {
+                this.databaseConnection = yield this.configuration.getDatabase().dataSource.initialize();
+                yield this.databaseConnection.runMigrations();
+            }
+        });
+    }
+    setupErrorHandler() {
+        this.koa.use(error_handler_middleware_1.errorHandlerMiddleware);
+    }
+    setupTransaction() {
+        this.koa.use(transaction_middleware_1.transactionMiddleware);
+    }
     registerStaticFileServerMiddleware() {
         this.koa.use((0, koa_static_1.default)(path_1.default.join(__dirname, '../client', 'browser')));
         this.koa.use((0, koa_static_1.default)(path_1.default.join(__dirname, '../../static')));
@@ -99,13 +113,19 @@ class KoalApp {
     }
     start(callback) {
         return __awaiter(this, void 0, void 0, function* () {
-            this.koa.listen(this.configuration.getPort(), () => {
+            this.server = this.koa.listen(this.configuration.getPort(), () => {
                 if (callback) {
                     callback(this.configuration);
                 }
             });
         });
     }
+    stop() {
+        if (this.server) {
+            this.server.close();
+            this.server = undefined;
+        }
+    }
     authorizationHeaderParser(context, next) {
         return __awaiter(this, void 0, void 0, function* () {
             const authHeader = context.headers.authorization;

package/common/koalapp.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/../src/common/koalapp.ts"],"names":[],"mappings":"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","file":"koalapp.js","sourcesContent":["import Koa, { Next, ParameterizedContext } from 'koa';\nimport { Configuration } from './configuration';\nimport { RouterService } from '../services/router-service';\nimport { AuthenticableEntity } from '../types/entities/authenticable-entity';\nimport { DataSource } from 'typeorm';\nimport { StatusCode } from './status-code';\nimport jwt from 'jsonwebtoken';\nimport bodyParser from 'koa-bodyparser';\nimport { BaseResponse, ErrorBase } from '../types';\nimport serve from \"koa-static\";\nimport path from \"path\";\nimport fs from \"fs\";\nimport { AuthorizationService } from '../services';\nimport { StringEnum } from '../types/common/string-enum';\n\nexport class KoalApp<\n  U extends AuthenticableEntity,\n  P extends StringEnum\n> {\n  private static instance: KoalApp<any, any>;\n\n  private koa = new Koa();\n  private routerService: RouterService;\n  private databaseConnection: DataSource;\n\n  private authorizationService: AuthorizationService<U, P>;\n\n  private constructor(private configuration: Configuration<U, P>) {\n  }\n\n  public static getInstance<\n    T extends AuthenticableEntity,\n    Q extends StringEnum\n  >(configuration?: Configuration<T, Q>): KoalApp<T, Q> {\n    if (!KoalApp.instance) {\n      if (!configuration) {\n        throw new Error(\"Configuration is required\");\n      }\n      KoalApp.instance = new KoalApp(configuration!);\n    }\n    return KoalApp.instance;\n  }\n\n  public static resetInstance() {\n    KoalApp.instance = undefined;\n  }\n\n  public getConfiguration(): Configuration<U, P> {\n    return this.configuration;\n  }\n\n  public getRouterService(): RouterService {\n    return this.routerService;\n  }\n\n  public getDatabaseConnection(): DataSource {\n    return this.databaseConnection;\n  }\n\n  async initialize() {\n    try {\n      if (this.configuration.getDatabase()) {\n        this.databaseConnection = await this.configuration.getDatabase().dataSource.initialize();\n        if (this.configuration.getDatabase().shouldRunMigrations) {\n          console.log(\"Executing database migrations...\");\n          await this.databaseConnection.runMigrations();\n          console.log(\"Database migrations executed.\");\n        }\n        console.log(\"Database connection initialized.\");\n      }\n      this.koa.use(this.authorizationHeaderParser.bind(this));\n      console.log(\"Authorization header parser initialized.\");\n      this.koa.use(bodyParser());\n      console.log(\"Body parser initialized.\");\n      this.koa.use(this.errorHandler.bind(this));\n      console.log(\"Error handler initialized.\");\n      this.registerStaticFileServerMiddleware();\n      console.log(\"Static file server initialized.\");\n      this.registerEndpoints();\n      console.log(\"Endpoints registered.\");\n    } catch (error) {\n      console.log(\"Error during database initialization...\", error);\n      throw new Error('Error during application intialization...');\n    }\n  }\n\n  registerStaticFileServerMiddleware() {\n    this.koa.use(serve(path.join(__dirname, '../client', 'browser')));\n    this.koa.use(serve(path.join(__dirname, '../../static')));\n    this.koa.use(async (ctx, next) => {\n      const requestPath = ctx.request.path;\n\n      if (!requestPath.startsWith(this.configuration.getRestPrefix()) && !/\\.[a-z]+$/.test(requestPath)) {\n        ctx.type = 'html';\n        ctx.body = fs.createReadStream(path.join(__dirname, '../client', 'browser', 'index.html'));\n      } else {\n        await next();\n      }\n    });\n  }\n\n  registerEndpoints() {\n    this.routerService = new RouterService(\n      this.configuration.getControllers()\n    );\n    this.koa\n      .use(this.routerService.getRoutes())\n      .use(this.routerService.allowedMethods());\n  }\n\n  async start(callback?: (configuration: Configuration<U, P>) => void) {\n    this.koa.listen(this.configuration.getPort(), () => {\n      if (callback) {\n        callback(this.configuration);\n      }\n    });\n  }\n\n  async authorizationHeaderParser(context: ParameterizedContext, next: Next) {\n    const authHeader = context.headers.authorization;\n    if (authHeader) {\n      const token = authHeader.split(' ')[1];\n      try {\n        context.state.user = jwt.verify(token, this.configuration.getJwtParameters().secretKey);\n        await next();\n      } catch (error) {\n        context.status = StatusCode.UNAUTHORIZED;\n        context.body = {\n          success: false,\n          message: 'Invalid token'\n        }\n      }\n    }\n    else {\n      await next();\n    }\n  }\n\n  async errorHandler(context: ParameterizedContext, next: Next) {\n    try {\n      await next();\n    } catch (error) {\n      if (error instanceof ErrorBase) {\n        context.status = error.getStatusCode();\n        context.body = <BaseResponse>{\n          success: false,\n          message: error.message\n        };\n      }\n      else {\n        console.log(error);\n        context.status = StatusCode.INTERNAL_SERVER_ERROR;\n        context.body = <BaseResponse>{\n          success: false\n        };\n      }\n    }\n  }\n\n  getAuthorizationService() {\n    return this.authorizationService;\n  }\n}"]}
+{"version":3,"sources":["../src/../src/common/koalapp.ts"],"names":[],"mappings":"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","file":"koalapp.js","sourcesContent":["import Koa, { Next, ParameterizedContext } from 'koa';\nimport { Configuration } from './configuration';\nimport { RouterService } from '../services/router-service';\nimport { AuthenticableEntity } from '../types/entities/authenticable-entity';\nimport { DataSource } from 'typeorm';\nimport { StatusCode } from './status-code';\nimport jwt from 'jsonwebtoken';\nimport bodyParser from 'koa-bodyparser';\nimport { BaseResponse, ErrorBase } from '../types';\nimport serve from \"koa-static\";\nimport path from \"path\";\nimport fs from \"fs\";\nimport { AuthorizationService } from '../services';\nimport { StringEnum } from '../types/common/string-enum';\nimport { errorHandlerMiddleware } from '../middlewares/error-handler-middleware';\nimport { transactionMiddleware } from '../middlewares/transaction-middleware';\nimport { Server } from 'http';\n\nexport class KoalApp<\n  U extends AuthenticableEntity,\n  P extends StringEnum\n> {\n  private static instance: KoalApp<any, any>;\n\n  private koa = new Koa();\n  private routerService: RouterService;\n  private databaseConnection: DataSource;\n\n  private server: Server;\n\n  private authorizationService: AuthorizationService<U, P>;\n\n  private constructor(private configuration: Configuration<U, P>) {\n  }\n\n  public static getInstance<\n    T extends AuthenticableEntity,\n    Q extends StringEnum\n  >(configuration?: Configuration<T, Q>): KoalApp<T, Q> {\n    if (!KoalApp.instance) {\n      if (!configuration) {\n        throw new Error(\"Configuration is required\");\n      }\n      KoalApp.instance = new KoalApp(configuration!);\n    }\n    return KoalApp.instance;\n  }\n\n  public static async resetInstance() {\n    await KoalApp.getInstance().getDatabaseConnection().destroy();\n    KoalApp.instance = undefined;\n  }\n\n  public getConfiguration(): Configuration<U, P> {\n    return this.configuration;\n  }\n\n  public getRouterService(): RouterService {\n    return this.routerService;\n  }\n\n  public getDatabaseConnection(): DataSource {\n    return this.databaseConnection;\n  }\n  async initialize() {\n    try {\n      await this.setupDatabaseConnection();\n      console.log(\"Database connection initialized.\");\n      this.setupErrorHandler();\n      console.log(\"Error handler initialized.\");\n      this.setupTransaction();\n      console.log(\"Transaction starter middleware initialized.\");\n      this.koa.use(this.authorizationHeaderParser.bind(this));\n      console.log(\"Authorization header parser initialized.\");\n      this.koa.use(bodyParser());\n      console.log(\"Body parser initialized.\");\n      this.registerStaticFileServerMiddleware();\n      console.log(\"Static file server initialized.\");\n      this.registerEndpoints();\n      console.log(\"Endpoints registered.\");\n    } catch (error) {\n      console.log(\"Error during database initialization...\", error);\n      throw new Error('Error during application intialization...');\n    }\n  }\n  async setupDatabaseConnection() {\n    if (this.configuration.getDatabase()) {\n      this.databaseConnection = await this.configuration.getDatabase().dataSource.initialize();\n      await this.databaseConnection.runMigrations();\n    }\n  }\n  setupErrorHandler() {\n    this.koa.use(errorHandlerMiddleware);\n  }\n  setupTransaction() {\n    this.koa.use(transactionMiddleware);\n  }\n\n  registerStaticFileServerMiddleware() {\n    this.koa.use(serve(path.join(__dirname, '../client', 'browser')));\n    this.koa.use(serve(path.join(__dirname, '../../static')));\n    this.koa.use(async (ctx, next) => {\n      const requestPath = ctx.request.path;\n\n      if (!requestPath.startsWith(this.configuration.getRestPrefix()) && !/\\.[a-z]+$/.test(requestPath)) {\n        ctx.type = 'html';\n        ctx.body = fs.createReadStream(path.join(__dirname, '../client', 'browser', 'index.html'));\n      } else {\n        await next();\n      }\n    });\n  }\n\n  registerEndpoints() {\n    this.routerService = new RouterService(\n      this.configuration.getControllers()\n    );\n    this.koa\n      .use(this.routerService.getRoutes())\n      .use(this.routerService.allowedMethods());\n  }\n\n  async start(callback?: (configuration: Configuration<U, P>) => void) {\n    this.server = this.koa.listen(this.configuration.getPort(), () => {\n      if (callback) {\n        callback(this.configuration);\n      }\n    });\n  }\n\n  stop() {\n    if (this.server) {\n      this.server.close();\n      this.server = undefined;\n    }\n  }\n\n  async authorizationHeaderParser(context: ParameterizedContext, next: Next) {\n    const authHeader = context.headers.authorization;\n    if (authHeader) {\n      const token = authHeader.split(' ')[1];\n      try {\n        context.state.user = jwt.verify(token, this.configuration.getJwtParameters().secretKey);\n        await next();\n      } catch (error) {\n        context.status = StatusCode.UNAUTHORIZED;\n        context.body = {\n          success: false,\n          message: 'Invalid token'\n        }\n      }\n    }\n    else {\n      await next();\n    }\n  }\n\n  async errorHandler(context: ParameterizedContext, next: Next) {\n    try {\n      await next();\n    } catch (error) {\n      if (error instanceof ErrorBase) {\n        context.status = error.getStatusCode();\n        context.body = <BaseResponse>{\n          success: false,\n          message: error.message\n        };\n      }\n      else {\n        console.log(error);\n        context.status = StatusCode.INTERNAL_SERVER_ERROR;\n        context.body = <BaseResponse>{\n          success: false\n        };\n      }\n    }\n  }\n\n  getAuthorizationService() {\n    return this.authorizationService;\n  }\n}"]}

package/database/entities/audited-entity-base.d.ts

@@ -0,0 +1,6 @@
+import { EntityBase } from "./entity-base";
+import { Audited } from "./interfaces/audited";
+export declare abstract class AuditedEntityBase extends EntityBase implements Audited {
+    createdAt: Date;
+    updatedAt: Date;
+}

package/database/entities/audited-entity-base.js

@@ -0,0 +1,27 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuditedEntityBase = void 0;
+const typeorm_1 = require("typeorm");
+const entity_base_1 = require("./entity-base");
+class AuditedEntityBase extends entity_base_1.EntityBase {
+}
+exports.AuditedEntityBase = AuditedEntityBase;
+__decorate([
+    (0, typeorm_1.CreateDateColumn)(),
+    __metadata("design:type", Date)
+], AuditedEntityBase.prototype, "createdAt", void 0);
+__decorate([
+    (0, typeorm_1.UpdateDateColumn)(),
+    __metadata("design:type", Date)
+], AuditedEntityBase.prototype, "updatedAt", void 0);
+
+//# sourceMappingURL=audited-entity-base.js.map

package/database/entities/audited-entity-base.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/../src/database/entities/audited-entity-base.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qCAA6D;AAC7D,+CAA2C;AAG3C,MAAsB,iBAAkB,SAAQ,wBAAU;CAMzD;AAND,8CAMC;AAJC;IADC,IAAA,0BAAgB,GAAE;8BACR,IAAI;oDAAC;AAGhB;IADC,IAAA,0BAAgB,GAAE;8BACR,IAAI;oDAAC","file":"audited-entity-base.js","sourcesContent":["import { CreateDateColumn, UpdateDateColumn } from \"typeorm\";\nimport { EntityBase } from \"./entity-base\";\nimport { Audited } from \"./interfaces/audited\";\n\nexport abstract class AuditedEntityBase extends EntityBase implements Audited {\n  @CreateDateColumn()\n  createdAt: Date;\n\n  @UpdateDateColumn()\n  updatedAt: Date;\n}"]}

package/database/entities/entity-base.d.ts

@@ -0,0 +1,4 @@
+import { IdentifiableEntity } from "../../types";
+export declare abstract class EntityBase implements IdentifiableEntity {
+    id: number;
+}

package/database/entities/entity-base.js

@@ -0,0 +1,22 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntityBase = void 0;
+const typeorm_1 = require("typeorm");
+class EntityBase {
+}
+exports.EntityBase = EntityBase;
+__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)(),
+    __metadata("design:type", Number)
+], EntityBase.prototype, "id", void 0);
+
+//# sourceMappingURL=entity-base.js.map

package/database/entities/entity-base.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/../src/database/entities/entity-base.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qCAAiD;AAGjD,MAAsB,UAAU;CAG/B;AAHD,gCAGC;AADC;IADC,IAAA,gCAAsB,GAAE;;sCACd","file":"entity-base.js","sourcesContent":["import { PrimaryGeneratedColumn } from \"typeorm\";\nimport { IdentifiableEntity } from \"../../types\";\n\nexport abstract class EntityBase implements IdentifiableEntity {\n  @PrimaryGeneratedColumn()\n  id: number;\n}\n"]}

package/database/entities/index.d.ts

@@ -0,0 +1,5 @@
+export * from './interfaces';
+export * from './audited-entity-base';
+export * from './soft-deletable-audited-entity-base';
+export * from './entity-base';
+export * from './soft-deletable-entity-base';

package/database/entities/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./interfaces"), exports);
+__exportStar(require("./audited-entity-base"), exports);
+__exportStar(require("./soft-deletable-audited-entity-base"), exports);
+__exportStar(require("./entity-base"), exports);
+__exportStar(require("./soft-deletable-entity-base"), exports);
+
+//# sourceMappingURL=index.js.map

package/database/entities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/../src/database/entities/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,wDAAsC;AACtC,uEAAqD;AACrD,gDAA8B;AAC9B,+DAA6C","file":"index.js","sourcesContent":["export * from './interfaces';\nexport * from './audited-entity-base';\nexport * from './soft-deletable-audited-entity-base';\nexport * from './entity-base';\nexport * from './soft-deletable-entity-base';\n"]}

package/database/entities/interfaces/audited.d.ts

@@ -0,0 +1,4 @@
+export interface Audited {
+    createdAt: Date;
+    updatedAt: Date;
+}

package/database/entities/interfaces/audited.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+
+//# sourceMappingURL=audited.js.map

package/database/entities/interfaces/audited.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/../src/database/entities/interfaces/audited.ts"],"names":[],"mappings":"","file":"audited.js","sourcesContent":["export interface Audited {\n  createdAt: Date;\n  updatedAt: Date;\n}\n"]}

package/database/entities/interfaces/index.d.ts

@@ -0,0 +1,2 @@
+export * from './audited';
+export * from './soft-deletable';

package/database/entities/interfaces/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./audited"), exports);
+__exportStar(require("./soft-deletable"), exports);
+
+//# sourceMappingURL=index.js.map

package/database/entities/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/../src/database/entities/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,mDAAiC","file":"index.js","sourcesContent":["export * from './audited';\nexport * from './soft-deletable';\n"]}

package/database/entities/interfaces/soft-deletable.d.ts

@@ -0,0 +1,3 @@
+export interface SoftDeletable {
+    deletedAt: Date;
+}

package/database/entities/interfaces/soft-deletable.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+
+//# sourceMappingURL=soft-deletable.js.map

package/database/entities/interfaces/soft-deletable.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/../src/database/entities/interfaces/soft-deletable.ts"],"names":[],"mappings":"","file":"soft-deletable.js","sourcesContent":["export interface SoftDeletable {\n  deletedAt: Date;\n}\n"]}

package/database/entities/soft-deletable-audited-entity-base.d.ts

@@ -0,0 +1,5 @@
+import { SoftDeletable } from "./interfaces/soft-deletable";
+import { AuditedEntityBase } from "./audited-entity-base";
+export declare abstract class SoftDeletableAuditedEntityBase extends AuditedEntityBase implements SoftDeletable {
+    deletedAt: Date;
+}

package/database/entities/soft-deletable-audited-entity-base.js

@@ -0,0 +1,23 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SoftDeletableAuditedEntityBase = void 0;
+const typeorm_1 = require("typeorm");
+const audited_entity_base_1 = require("./audited-entity-base");
+class SoftDeletableAuditedEntityBase extends audited_entity_base_1.AuditedEntityBase {
+}
+exports.SoftDeletableAuditedEntityBase = SoftDeletableAuditedEntityBase;
+__decorate([
+    (0, typeorm_1.DeleteDateColumn)(),
+    __metadata("design:type", Date)
+], SoftDeletableAuditedEntityBase.prototype, "deletedAt", void 0);
+
+//# sourceMappingURL=soft-deletable-audited-entity-base.js.map

package/database/entities/soft-deletable-audited-entity-base.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/../src/database/entities/soft-deletable-audited-entity-base.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qCAA2C;AAE3C,+DAA0D;AAE1D,MAAsB,8BAA+B,SAAQ,uCAAiB;CAG7E;AAHD,wEAGC;AADC;IADC,IAAA,0BAAgB,GAAE;8BACR,IAAI;iEAAC","file":"soft-deletable-audited-entity-base.js","sourcesContent":["import { DeleteDateColumn } from \"typeorm\";\nimport { SoftDeletable } from \"./interfaces/soft-deletable\";\nimport { AuditedEntityBase } from \"./audited-entity-base\";\n\nexport abstract class SoftDeletableAuditedEntityBase extends AuditedEntityBase implements SoftDeletable {\n  @DeleteDateColumn()\n  deletedAt: Date;\n}\n"]}

package/database/entities/soft-deletable-entity-base.d.ts

@@ -0,0 +1,5 @@
+import { EntityBase } from "./entity-base";
+import { SoftDeletable } from "./interfaces/soft-deletable";
+export declare abstract class SoftDeletableEntityBase extends EntityBase implements SoftDeletable {
+    deletedAt: Date;
+}

package/database/entities/soft-deletable-entity-base.js

@@ -0,0 +1,23 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SoftDeletableEntityBase = void 0;
+const typeorm_1 = require("typeorm");
+const entity_base_1 = require("./entity-base");
+class SoftDeletableEntityBase extends entity_base_1.EntityBase {
+}
+exports.SoftDeletableEntityBase = SoftDeletableEntityBase;
+__decorate([
+    (0, typeorm_1.DeleteDateColumn)(),
+    __metadata("design:type", Date)
+], SoftDeletableEntityBase.prototype, "deletedAt", void 0);
+
+//# sourceMappingURL=soft-deletable-entity-base.js.map

package/database/entities/soft-deletable-entity-base.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/../src/database/entities/soft-deletable-entity-base.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qCAAmD;AACnD,+CAA2C;AAG3C,MAAsB,uBAAwB,SAAQ,wBAAU;CAG/D;AAHD,0DAGC;AADC;IADC,IAAA,0BAAgB,GAAE;8BACR,IAAI;0DAAC","file":"soft-deletable-entity-base.js","sourcesContent":["import { Column, DeleteDateColumn } from \"typeorm\";\nimport { EntityBase } from \"./entity-base\";\nimport { SoftDeletable } from \"./interfaces/soft-deletable\";\n\nexport abstract class SoftDeletableEntityBase extends EntityBase implements SoftDeletable {\n  @DeleteDateColumn()\n  deletedAt: Date;\n}\n"]}

package/database/index.d.ts

@@ -1 +1,2 @@
+export * from './entities';
 export * from './repositories';

package/database/index.js

@@ -14,6 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./entities"), exports);
 __exportStar(require("./repositories"), exports);
 
 //# sourceMappingURL=index.js.map

package/database/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/../src/database/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B","file":"index.js","sourcesContent":["export * from './repositories';\n"]}
+{"version":3,"sources":["../src/../src/database/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,iDAA+B","file":"index.js","sourcesContent":["export * from './entities';\nexport * from './repositories';\n"]}

package/database/repositories/index.d.ts

@@ -1 +1,2 @@
 export * from './repository-base';
+export * from './soft-deletable-repository-base';

package/database/repositories/index.js

@@ -15,5 +15,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./repository-base"), exports);
+__exportStar(require("./soft-deletable-repository-base"), exports);
 
 //# sourceMappingURL=index.js.map

package/database/repositories/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/../src/database/repositories/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC","file":"index.js","sourcesContent":["export * from './repository-base';\n"]}
+{"version":3,"sources":["../src/../src/database/repositories/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC;AAClC,mEAAiD","file":"index.js","sourcesContent":["export * from './repository-base';\nexport * from './soft-deletable-repository-base';\n"]}

package/database/repositories/repository-base.d.ts

@@ -1,8 +1,8 @@
-import { DataSource, DeepPartial, FindManyOptions, FindOneOptions, FindOptionsRelations, Repository } from "typeorm";
+import { DeepPartial, FindManyOptions, FindOneOptions, FindOptionsRelations, FindOptionsWhere, QueryRunner, Repository } from "typeorm";
 import { IdentifiableEntity } from "../../types";
 export declare abstract class RepositoryBase<T extends IdentifiableEntity> {
     private _repository;
-    constructor(databaseConnection?: DataSource);
+    constructor(queryRunner?: QueryRunner);
     getRepository(): Repository<T>;
     abstract getEntityType(): new () => T;
     getAll(): Promise<T[]>;
@@ -10,7 +10,7 @@ export declare abstract class RepositoryBase<T extends IdentifiableEntity> {
     getOneWhere(options: FindOneOptions<T>): Promise<T>;
     getById(id: number, relations?: FindOptionsRelations<T>): Promise<T>;
     save(entity: T | DeepPartial<T>): Promise<DeepPartial<T> & T>;
-    find(where: FindManyOptions<T>): Promise<T[]>;
-    findOne(where: FindOneOptions<T>): Promise<T>;
     delete(entity: T): Promise<import("typeorm").DeleteResult>;
+    deleteWhere(where?: FindOptionsWhere<T>): Promise<import("typeorm").DeleteResult>;
+    deleteAll(): Promise<import("typeorm").DeleteResult>;
 }

package/database/repositories/repository-base.js

@@ -3,8 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.RepositoryBase = void 0;
 const common_1 = require("../../common");
 class RepositoryBase {
-    constructor(databaseConnection) {
-        this._repository = (databaseConnection !== null && databaseConnection !== void 0 ? databaseConnection : common_1.KoalApp.getInstance().getDatabaseConnection()).getRepository(this.getEntityType());
+    constructor(queryRunner) {
+        if (queryRunner === undefined) {
+            this._repository = common_1.KoalApp.getInstance().getDatabaseConnection().getRepository(this.getEntityType());
+        }
+        else {
+            this._repository = queryRunner.manager.getRepository(this.getEntityType());
+        }
     }
     getRepository() {
         return this._repository;
@@ -29,15 +34,15 @@ class RepositoryBase {
     save(entity) {
         return this.getRepository().save(entity);
     }
-    find(where) {
-        return this.getRepository().find(where);
-    }
-    findOne(where) {
-        return this.getRepository().findOne(where);
-    }
     delete(entity) {
         return this.getRepository().delete(entity.id);
     }
+    deleteWhere(where) {
+        return this.getRepository().delete(where);
+    }
+    deleteAll() {
+        return this.deleteWhere({});
+    }
 }
 exports.RepositoryBase = RepositoryBase;
 

package/database/repositories/repository-base.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/../src/database/repositories/repository-base.ts"],"names":[],"mappings":";;;AAEA,yCAAuC;AAEvC,MAAsB,cAAc;IAElC,YAAY,kBAA+B;QACzC,IAAI,CAAC,WAAW,GAAG,CAAC,kBAAkB,aAAlB,kBAAkB,cAAlB,kBAAkB,GAAI,gBAAO,CAAC,WAAW,EAAE,CAAC,qBAAqB,EAAE,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;IAC/H,CAAC;IACD,aAAa;QACX,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;IACjC,CAAC;IACD,QAAQ,CAAC,OAA2B;QAClC,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IACD,WAAW,CAAC,OAA0B;QACpC,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,CAAC,EAAU,EAAE,SAAmC;QACrD,OAAO,IAAI,CAAC,aAAa,EAAE,CAAC,OAAO,CAAoB;YACrD,KAAK,EAAE;gBACL,EAAE;aACH;YACD,SAAS;SACV,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC,MAA0B;QAC7B,OAAO,IAAI,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,CAAC,KAAyB;QAC5B,OAAO,IAAI,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,CAAC,KAAwB;QAC9B,OAAO,IAAI,CAAC,aAAa,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;IACD,MAAM,CAAC,MAAS;QACd,OAAO,IAAI,CAAC,aAAa,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAChD,CAAC;CACF;AAtCD,wCAsCC","file":"repository-base.js","sourcesContent":["import { DataSource, DeepPartial, FindManyOptions, FindOneOptions, FindOptionsRelations, Repository } from \"typeorm\";\nimport { IdentifiableEntity } from \"../../types\";\nimport { KoalApp } from \"../../common\";\n\nexport abstract class RepositoryBase<T extends IdentifiableEntity> {\n  private _repository: Repository<T>;\n  constructor(databaseConnection?: DataSource) {\n    this._repository = (databaseConnection ?? KoalApp.getInstance().getDatabaseConnection()).getRepository(this.getEntityType());\n  }\n  getRepository() {\n    return this._repository;\n  }\n  abstract getEntityType(): new () => T;\n  getAll() {\n    return this._repository.find();\n  }\n  getWhere(options: FindManyOptions<T>) {\n    return this._repository.find(options);\n  }\n  getOneWhere(options: FindOneOptions<T>) {\n    return this._repository.findOne(options);\n  }\n  getById(id: number, relations?: FindOptionsRelations<T>) {\n    return this.getRepository().findOne(<FindOneOptions<T>>{\n      where: {\n        id\n      },\n      relations\n    });\n  }\n  save(entity: T | DeepPartial<T>) {\n    return this.getRepository().save(entity);\n  }\n  find(where: FindManyOptions<T>) {\n    return this.getRepository().find(where);\n  }\n  findOne(where: FindOneOptions<T>) {\n    return this.getRepository().findOne(where);\n  }\n  delete(entity: T) {\n    return this.getRepository().delete(entity.id);\n  }\n}\n"]}
+{"version":3,"sources":["../src/../src/database/repositories/repository-base.ts"],"names":[],"mappings":";;;AAEA,yCAAuC;AAEvC,MAAsB,cAAc;IAElC,YAAY,WAAyB;QACnC,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,IAAI,CAAC,WAAW,GAAG,gBAAO,CAAC,WAAW,EAAE,CAAC,qBAAqB,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;QACvG,CAAC;aACI,CAAC;YACJ,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;IACD,aAAa;QACX,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;IACjC,CAAC;IACD,QAAQ,CAAC,OAA2B;QAClC,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IACD,WAAW,CAAC,OAA0B;QACpC,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,CAAC,EAAU,EAAE,SAAmC;QACrD,OAAO,IAAI,CAAC,aAAa,EAAE,CAAC,OAAO,CAAoB;YACrD,KAAK,EAAE;gBACL,EAAE;aACH;YACD,SAAS;SACV,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC,MAA0B;QAC7B,OAAO,IAAI,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;IACD,MAAM,CAAC,MAAS;QACd,OAAO,IAAI,CAAC,aAAa,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAChD,CAAC;IACD,WAAW,CAAC,KAA2B;QACrC,OAAO,IAAI,CAAC,aAAa,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC;IACD,SAAS;QACP,OAAO,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;CACF;AA3CD,wCA2CC","file":"repository-base.js","sourcesContent":["import { DeepPartial, FindManyOptions, FindOneOptions, FindOptionsRelations, FindOptionsWhere, QueryRunner, Repository } from \"typeorm\";\nimport { IdentifiableEntity } from \"../../types\";\nimport { KoalApp } from \"../../common\";\n\nexport abstract class RepositoryBase<T extends IdentifiableEntity> {\n  private _repository: Repository<T>;\n  constructor(queryRunner?: QueryRunner) {\n    if (queryRunner === undefined) {\n      this._repository = KoalApp.getInstance().getDatabaseConnection().getRepository(this.getEntityType());\n    }\n    else {\n      this._repository = queryRunner.manager.getRepository(this.getEntityType());\n    }\n  }\n  getRepository() {\n    return this._repository;\n  }\n  abstract getEntityType(): new () => T;\n  getAll() {\n    return this._repository.find();\n  }\n  getWhere(options: FindManyOptions<T>) {\n    return this._repository.find(options);\n  }\n  getOneWhere(options: FindOneOptions<T>) {\n    return this._repository.findOne(options);\n  }\n  getById(id: number, relations?: FindOptionsRelations<T>) {\n    return this.getRepository().findOne(<FindOneOptions<T>>{\n      where: {\n        id\n      },\n      relations\n    });\n  }\n  save(entity: T | DeepPartial<T>) {\n    return this.getRepository().save(entity);\n  }\n  delete(entity: T) {\n    return this.getRepository().delete(entity.id);\n  }\n  deleteWhere(where?: FindOptionsWhere<T>) {\n    return this.getRepository().delete(where);\n  }\n  deleteAll() {\n    return this.deleteWhere({});\n  }\n}\n"]}

package/database/repositories/soft-deletable-repository-base.d.ts

@@ -0,0 +1,13 @@
+import { DeleteResult, FindManyOptions, FindOneOptions, FindOptionsRelations, FindOptionsWhere } from "typeorm";
+import { RepositoryBase } from "./repository-base";
+import { SoftDeletable } from "../entities";
+import { IdentifiableEntity } from "../../types";
+export declare abstract class SoftDeletableRepositoryBase<T extends IdentifiableEntity & SoftDeletable> extends RepositoryBase<T> {
+    getAll(withDeleted?: boolean): Promise<T[]>;
+    getWhere(options: FindManyOptions<T>, withDeleted?: boolean): Promise<T[]>;
+    getOneWhere(options: FindOneOptions<T>, withDeleted?: boolean): Promise<T>;
+    getById(id: number, relations?: FindOptionsRelations<T>, withDeleted?: boolean): Promise<T>;
+    delete(entity: T, hardDelete?: boolean): Promise<DeleteResult>;
+    deleteWhere(where?: FindOptionsWhere<T>, hardDelete?: boolean): Promise<DeleteResult>;
+    deleteAll(hardDelete?: boolean): Promise<DeleteResult>;
+}

package/database/repositories/soft-deletable-repository-base.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SoftDeletableRepositoryBase = void 0;
+const repository_base_1 = require("./repository-base");
+class SoftDeletableRepositoryBase extends repository_base_1.RepositoryBase {
+    getAll(withDeleted = false) {
+        return this.getRepository().find({
+            withDeleted
+        });
+    }
+    getWhere(options, withDeleted = false) {
+        options.withDeleted = withDeleted;
+        return super.getWhere(options);
+    }
+    getOneWhere(options, withDeleted = false) {
+        options.withDeleted = withDeleted;
+        return super.getOneWhere(options);
+    }
+    getById(id, relations, withDeleted = false) {
+        return this.getRepository().findOne({
+            where: {
+                id
+            },
+            relations,
+            withDeleted
+        });
+    }
+    delete(entity, hardDelete = false) {
+        if (!hardDelete) {
+            return this.getRepository().softDelete(entity.id);
+        }
+        else {
+            return this.getRepository().delete(entity.id);
+        }
+    }
+    deleteWhere(where, hardDelete = false) {
+        if (!hardDelete) {
+            return this.getRepository().softDelete(where);
+        }
+        else {
+            return this.getRepository().delete(where);
+        }
+    }
+    deleteAll(hardDelete = false) {
+        return this.deleteWhere({}, hardDelete);
+    }
+}
+exports.SoftDeletableRepositoryBase = SoftDeletableRepositoryBase;
+
+//# sourceMappingURL=soft-deletable-repository-base.js.map

package/database/repositories/soft-deletable-repository-base.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/../src/database/repositories/soft-deletable-repository-base.ts"],"names":[],"mappings":";;;AACA,uDAAmD;AAInD,MAAsB,2BAA0E,SAAQ,gCAAiB;IAC9G,MAAM,CAAC,cAAuB,KAAK;QAC1C,OAAO,IAAI,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC;YAC/B,WAAW;SACZ,CAAC,CAAC;IACL,CAAC;IAEQ,QAAQ,CAAC,OAA2B,EAAE,cAAuB,KAAK;QACzE,OAAO,CAAC,WAAW,GAAG,WAAW,CAAC;QAClC,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAEQ,WAAW,CAAC,OAA0B,EAAE,cAAuB,KAAK;QAC3E,OAAO,CAAC,WAAW,GAAG,WAAW,CAAC;QAClC,OAAO,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAEQ,OAAO,CAAC,EAAU,EAAE,SAAmC,EAAE,cAAuB,KAAK;QAC5F,OAAO,IAAI,CAAC,aAAa,EAAE,CAAC,OAAO,CAAoB;YACrD,KAAK,EAAE;gBACL,EAAE;aACH;YACD,SAAS;YACT,WAAW;SACZ,CAAC,CAAC;IACL,CAAC;IAEQ,MAAM,CAAC,MAAS,EAAE,aAAsB,KAAK;QACpD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC,aAAa,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACpD,CAAC;aACI,CAAC;YACJ,OAAO,IAAI,CAAC,aAAa,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAEQ,WAAW,CAAC,KAA2B,EAAE,aAAsB,KAAK;QAC3E,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC,aAAa,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAChD,CAAC;aACI,CAAC;YACJ,OAAO,IAAI,CAAC,aAAa,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAEQ,SAAS,CAAC,aAAsB,KAAK;QAC5C,OAAO,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IAC1C,CAAC;CACF;AAhDD,kEAgDC","file":"soft-deletable-repository-base.js","sourcesContent":["import { DeleteResult, FindManyOptions, FindOneOptions, FindOptionsRelations, FindOptionsWhere } from \"typeorm\";\nimport { RepositoryBase } from \"./repository-base\";\nimport { SoftDeletable } from \"../entities\";\nimport { IdentifiableEntity } from \"../../types\";\n\nexport abstract class SoftDeletableRepositoryBase<T extends IdentifiableEntity & SoftDeletable> extends RepositoryBase<T> {\n  override getAll(withDeleted: boolean = false) {\n    return this.getRepository().find({\n      withDeleted\n    });\n  }\n\n  override getWhere(options: FindManyOptions<T>, withDeleted: boolean = false) {\n    options.withDeleted = withDeleted;\n    return super.getWhere(options);\n  }\n\n  override getOneWhere(options: FindOneOptions<T>, withDeleted: boolean = false) {\n    options.withDeleted = withDeleted;\n    return super.getOneWhere(options);\n  }\n\n  override getById(id: number, relations?: FindOptionsRelations<T>, withDeleted: boolean = false) {\n    return this.getRepository().findOne(<FindOneOptions<T>>{\n      where: {\n        id\n      },\n      relations,\n      withDeleted\n    });\n  }\n\n  override delete(entity: T, hardDelete: boolean = false) {\n    if (!hardDelete) {\n      return this.getRepository().softDelete(entity.id);\n    }\n    else {\n      return this.getRepository().delete(entity.id);\n    }\n  }\n\n  override deleteWhere(where?: FindOptionsWhere<T>, hardDelete: boolean = false) {\n    if (!hardDelete) {\n      return this.getRepository().softDelete(where);\n    }\n    else {\n      return this.getRepository().delete(where);\n    }\n  }\n\n  override deleteAll(hardDelete: boolean = false): Promise<DeleteResult> {\n    return this.deleteWhere({}, hardDelete);\n  }\n}"]}

package/middlewares/error-handler-middleware.d.ts

@@ -0,0 +1,2 @@
+import { Context } from "../types/common/context";
+export declare const errorHandlerMiddleware: (context: Context, next: () => Promise<any>) => Promise<void>;

package/middlewares/error-handler-middleware.js

@@ -0,0 +1,38 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.errorHandlerMiddleware = void 0;
+const common_1 = require("../common");
+const types_1 = require("../types");
+const errorHandlerMiddleware = (context, next) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        yield next();
+    }
+    catch (error) {
+        console.log(error);
+        if (error instanceof types_1.ErrorBase) {
+            context.status = error.getStatusCode();
+            context.body = {
+                success: false,
+                message: error.message
+            };
+        }
+        else {
+            context.status = common_1.StatusCode.INTERNAL_SERVER_ERROR;
+            context.body = {
+                success: false
+            };
+        }
+    }
+});
+exports.errorHandlerMiddleware = errorHandlerMiddleware;
+
+//# sourceMappingURL=error-handler-middleware.js.map

package/middlewares/error-handler-middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/../src/middlewares/error-handler-middleware.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,sCAAuC;AACvC,oCAAmD;AAG5C,MAAM,sBAAsB,GAAG,CAAO,OAAgB,EAAE,IAAwB,EAAE,EAAE;IACzF,IAAI,CAAC;QACH,MAAM,IAAI,EAAE,CAAC;IACf,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnB,IAAI,KAAK,YAAY,iBAAS,EAAE,CAAC;YAC/B,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,aAAa,EAAE,CAAC;YACvC,OAAO,CAAC,IAAI,GAAiB;gBAC3B,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB,CAAC;QACJ,CAAC;aACI,CAAC;YACJ,OAAO,CAAC,MAAM,GAAG,mBAAU,CAAC,qBAAqB,CAAC;YAClD,OAAO,CAAC,IAAI,GAAiB;gBAC3B,OAAO,EAAE,KAAK;aACf,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC,CAAA,CAAA;AAnBY,QAAA,sBAAsB,0BAmBlC","file":"error-handler-middleware.js","sourcesContent":["import { StatusCode } from \"../common\";\nimport { BaseResponse, ErrorBase } from \"../types\";\nimport { Context } from \"../types/common/context\";\n\nexport const errorHandlerMiddleware = async (context: Context, next: () => Promise<any>) => {\n  try {\n    await next();\n  } catch (error) {\n    console.log(error);\n    if (error instanceof ErrorBase) {\n      context.status = error.getStatusCode();\n      context.body = <BaseResponse>{\n        success: false,\n        message: error.message\n      };\n    }\n    else {\n      context.status = StatusCode.INTERNAL_SERVER_ERROR;\n      context.body = <BaseResponse>{\n        success: false\n      };\n    }\n  }\n}\n"]}

package/middlewares/transaction-middleware.d.ts

@@ -0,0 +1,3 @@
+import { Middleware } from "koa";
+import { State } from "../types/common/state";
+export declare const transactionMiddleware: Middleware<State>;

package/middlewares/transaction-middleware.js

@@ -0,0 +1,32 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transactionMiddleware = void 0;
+const common_1 = require("../common");
+const transactionMiddleware = (context, next) => __awaiter(void 0, void 0, void 0, function* () {
+    const queryRunner = common_1.KoalApp.getInstance().getDatabaseConnection().createQueryRunner();
+    context.state.queryRunner = queryRunner;
+    queryRunner.startTransaction();
+    try {
+        yield next();
+        yield queryRunner.commitTransaction();
+    }
+    catch (error) {
+        yield queryRunner.rollbackTransaction();
+        throw error;
+    }
+    finally {
+        yield queryRunner.release();
+    }
+});
+exports.transactionMiddleware = transactionMiddleware;
+
+//# sourceMappingURL=transaction-middleware.js.map

package/middlewares/transaction-middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/../src/middlewares/transaction-middleware.ts"],"names":[],"mappings":";;;;;;;;;;;;AAEA,sCAAoC;AAE7B,MAAM,qBAAqB,GAAsB,CAAO,OAAO,EAAE,IAAI,EAAE,EAAE;IAC9E,MAAM,WAAW,GAAG,gBAAO,CAAC,WAAW,EAAE,CAAC,qBAAqB,EAAE,CAAC,iBAAiB,EAAE,CAAC;IACtF,OAAO,CAAC,KAAK,CAAC,WAAW,GAAG,WAAW,CAAC;IACxC,WAAW,CAAC,gBAAgB,EAAE,CAAC;IAC/B,IAAI,CAAC;QACH,MAAM,IAAI,EAAE,CAAC;QACb,MAAM,WAAW,CAAC,iBAAiB,EAAE,CAAC;IACxC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,WAAW,CAAC,mBAAmB,EAAE,CAAC;QACxC,MAAM,KAAK,CAAC;IACd,CAAC;YAAS,CAAC;QACT,MAAM,WAAW,CAAC,OAAO,EAAE,CAAC;IAC9B,CAAC;AACH,CAAC,CAAA,CAAC;AAbW,QAAA,qBAAqB,yBAahC","file":"transaction-middleware.js","sourcesContent":["import { Middleware } from \"koa\";\nimport { State } from \"../types/common/state\";\nimport { KoalApp } from \"../common\";\n\nexport const transactionMiddleware: Middleware<State> = async (context, next) => {\n  const queryRunner = KoalApp.getInstance().getDatabaseConnection().createQueryRunner();\n  context.state.queryRunner = queryRunner;\n  queryRunner.startTransaction();\n  try {\n    await next();\n    await queryRunner.commitTransaction();\n  } catch (error) {\n    await queryRunner.rollbackTransaction();\n    throw error;\n  } finally {\n    await queryRunner.release();\n  }\n};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kool-koala",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Full-stack framework to create NodeJS applications on server side and Angular applications on the client side with ease.",
   "main": "index.js",
   "types": "index.d.ts",
@@ -12,7 +12,7 @@
     "dev": "gulp --gulpfile build/gulpfile.ts dev",
     "compile": "gulp --gulpfile build/gulpfile.ts compile",
     "compile-release": "gulp --gulpfile build/gulpfile.ts compile-release",
-    "test": "mocha --config tests/.mocharc.json",
+    "test": "TS_NODE_PROJECT=tsconfig.test.json mocha --config tests/.mocharc.json",
     "prepare": "husky",
     "postversion": "cp -r package.json .."
   },
@@ -43,6 +43,7 @@
     "@types/jsonwebtoken": "^9.0.9",
     "@types/mocha": "^10.0.10",
     "@types/yargs": "^17.0.33",
+    "axios": "^1.8.4",
     "chai": "^5.2.0",
     "commitizen": "^4.3.1",
     "cz-git": "^1.11.1",
@@ -74,6 +75,7 @@
     "koa-bodyparser": "^4.4.1",
     "koa-router": "^13.0.1",
     "koa-static": "^5.0.0",
+    "reflect-metadata": "^0.2.2",
     "typeorm": "^0.3.22"
   }
 }

package/services/authorization-service.js

@@ -17,7 +17,7 @@ class AuthorizationService {
     }
     userHasRight(user, permission) {
         return __awaiter(this, void 0, void 0, function* () {
-            user = (yield common_1.KoalApp.getInstance().getConfiguration().getUserRepository().findOne({
+            user = (yield common_1.KoalApp.getInstance().getConfiguration().getUserRepository().getOneWhere({
                 where: {
                     id: user.id
                 },

package/services/authorization-service.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/../src/services/authorization-service.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,6EAAyE;AAEzE,sCAAoC;AAEpC,MAAa,oBAAoB;IAI/B;IACA,CAAC;IACK,YAAY,CAAC,IAAO,EAAE,UAAa;;YACvC,IAAI,IAAM,MAAM,gBAAO,CAAC,WAAW,EAAE,CAAC,gBAAgB,EAAE,CAAC,iBAAiB,EAAE,CAAC,OAAO,CAAC;gBACnF,KAAK,EAAuB;oBAC1B,EAAE,EAAE,IAAI,CAAC,EAAE;iBACZ;gBACD,SAAS,EAA2B;oBAClC,WAAW,EAAE,IAAI;iBAClB;aACF,CAAC,CAAA,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,EAAE,CAAC;gBAC3D,MAAM,IAAI,wCAAkB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;KAAA;CACF;AAnBD,oDAmBC","file":"authorization-service.js","sourcesContent":["import { FindOptionsRelations, FindOptionsWhere, Repository } from 'typeorm';\nimport { AuthorizationError } from '../types/errors/authorization-error';\nimport { AuthenticableEntity } from '../types';\nimport { KoalApp } from '../common';\n\nexport class AuthorizationService<\n  U extends AuthenticableEntity,\n  P\n> {\n  constructor() {\n  }\n  async userHasRight(user: U, permission: P) {\n    user = <U>await KoalApp.getInstance().getConfiguration().getUserRepository().findOne({\n      where: <FindOptionsWhere<U>>{\n        id: user.id\n      },\n      relations: <FindOptionsRelations<U>>{\n        permissions: true\n      }\n    });\n    if (!user.permissions.some((p) => p.textId === permission)) {\n      throw new AuthorizationError(user, permission);\n    }\n  }\n}"]}
+{"version":3,"sources":["../src/../src/services/authorization-service.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,6EAAyE;AAEzE,sCAAoC;AAEpC,MAAa,oBAAoB;IAI/B;IACA,CAAC;IACK,YAAY,CAAC,IAAO,EAAE,UAAa;;YACvC,IAAI,IAAM,MAAM,gBAAO,CAAC,WAAW,EAAE,CAAC,gBAAgB,EAAE,CAAC,iBAAiB,EAAE,CAAC,WAAW,CAAC;gBACvF,KAAK,EAAuB;oBAC1B,EAAE,EAAE,IAAI,CAAC,EAAE;iBACZ;gBACD,SAAS,EAA2B;oBAClC,WAAW,EAAE,IAAI;iBAClB;aACF,CAAC,CAAA,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,EAAE,CAAC;gBAC3D,MAAM,IAAI,wCAAkB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;KAAA;CACF;AAnBD,oDAmBC","file":"authorization-service.js","sourcesContent":["import { FindOptionsRelations, FindOptionsWhere, Repository } from 'typeorm';\nimport { AuthorizationError } from '../types/errors/authorization-error';\nimport { AuthenticableEntity } from '../types';\nimport { KoalApp } from '../common';\n\nexport class AuthorizationService<\n  U extends AuthenticableEntity,\n  P\n> {\n  constructor() {\n  }\n  async userHasRight(user: U, permission: P) {\n    user = <U>await KoalApp.getInstance().getConfiguration().getUserRepository().getOneWhere({\n      where: <FindOptionsWhere<U>>{\n        id: user.id\n      },\n      relations: <FindOptionsRelations<U>>{\n        permissions: true\n      }\n    });\n    if (!user.permissions.some((p) => p.textId === permission)) {\n      throw new AuthorizationError(user, permission);\n    }\n  }\n}"]}

package/types/common/context.d.ts

@@ -0,0 +1,3 @@
+import { ParameterizedContext } from "koa";
+import { State } from "./state";
+export type Context = ParameterizedContext<State>;

package/types/common/context.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+
+//# sourceMappingURL=context.js.map

package/types/common/context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/../src/types/common/context.ts"],"names":[],"mappings":"","file":"context.js","sourcesContent":["import { ParameterizedContext } from \"koa\";\nimport { State } from \"./state\";\n\nexport type Context = ParameterizedContext<State>;"]}

package/types/common/state.d.ts

@@ -0,0 +1,6 @@
+import { QueryRunner } from "typeorm";
+import { AuthenticableEntity } from "../entities";
+export interface State {
+    user?: AuthenticableEntity;
+    queryRunner: QueryRunner;
+}

package/types/common/state.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+
+//# sourceMappingURL=state.js.map

package/types/common/state.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/../src/types/common/state.ts"],"names":[],"mappings":"","file":"state.js","sourcesContent":["import { QueryRunner } from \"typeorm\";\nimport { AuthenticableEntity } from \"../entities\";\n\nexport interface State {\n  user?: AuthenticableEntity;\n  queryRunner: QueryRunner;\n}"]}