nicot 1.2.12 → 1.3.0

package/dist/index.mjs

@@ -1,5 +1,34 @@
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+var __commonJS = (cb, mod) => function __require2() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __decorateClass = (decorators, target, key, kind) => {
   var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
   for (var i = decorators.length - 1, decorator; i >= 0; i--)
@@ -9,6 +38,539 @@ var __decorateClass = (decorators, target, key, kind) => {
   return result;
 };
 
+// node_modules/@nestjs/typeorm/dist/typeorm.constants.js
+var require_typeorm_constants = __commonJS({
+  "node_modules/@nestjs/typeorm/dist/typeorm.constants.js"(exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.DEFAULT_DATA_SOURCE_NAME = exports.TYPEORM_MODULE_ID = exports.TYPEORM_MODULE_OPTIONS = void 0;
+    exports.TYPEORM_MODULE_OPTIONS = "TypeOrmModuleOptions";
+    exports.TYPEORM_MODULE_ID = "TypeOrmModuleId";
+    exports.DEFAULT_DATA_SOURCE_NAME = "default";
+  }
+});
+
+// node_modules/@nestjs/typeorm/dist/exceptions/circular-dependency.exception.js
+var require_circular_dependency_exception = __commonJS({
+  "node_modules/@nestjs/typeorm/dist/exceptions/circular-dependency.exception.js"(exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.CircularDependencyException = void 0;
+    var CircularDependencyException = class extends Error {
+      constructor(context) {
+        const ctx = context ? ` inside ${context}` : ``;
+        super(`A circular dependency has been detected${ctx}. Please, make sure that each side of a bidirectional relationships are decorated with "forwardRef()". Also, try to eliminate barrel files because they can lead to an unexpected behavior too.`);
+      }
+    };
+    exports.CircularDependencyException = CircularDependencyException;
+  }
+});
+
+// node_modules/@nestjs/typeorm/dist/common/typeorm.utils.js
+var require_typeorm_utils = __commonJS({
+  "node_modules/@nestjs/typeorm/dist/common/typeorm.utils.js"(exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.generateString = exports.getConnectionToken = void 0;
+    exports.getRepositoryToken = getRepositoryToken;
+    exports.getCustomRepositoryToken = getCustomRepositoryToken;
+    exports.getDataSourceToken = getDataSourceToken;
+    exports.getDataSourcePrefix = getDataSourcePrefix;
+    exports.getEntityManagerToken = getEntityManagerToken2;
+    exports.handleRetry = handleRetry;
+    exports.getDataSourceName = getDataSourceName;
+    var common_1 = __require("@nestjs/common");
+    var operators_1 = __require("rxjs/operators");
+    var typeorm_1 = __require("typeorm");
+    var circular_dependency_exception_1 = require_circular_dependency_exception();
+    var typeorm_constants_1 = require_typeorm_constants();
+    var logger = new common_1.Logger("TypeOrmModule");
+    function getRepositoryToken(entity, dataSource = typeorm_constants_1.DEFAULT_DATA_SOURCE_NAME) {
+      if (entity === null || entity === void 0) {
+        throw new circular_dependency_exception_1.CircularDependencyException("@InjectRepository()");
+      }
+      const dataSourcePrefix = getDataSourcePrefix(dataSource);
+      if (entity instanceof Function && (entity.prototype instanceof typeorm_1.Repository || entity.prototype instanceof typeorm_1.AbstractRepository)) {
+        if (!dataSourcePrefix) {
+          return entity;
+        }
+        return `${dataSourcePrefix}${getCustomRepositoryToken(entity)}`;
+      }
+      if (entity instanceof typeorm_1.EntitySchema) {
+        return `${dataSourcePrefix}${entity.options.target ? entity.options.target.name : entity.options.name}Repository`;
+      }
+      return `${dataSourcePrefix}${entity.name}Repository`;
+    }
+    function getCustomRepositoryToken(repository) {
+      if (repository === null || repository === void 0) {
+        throw new circular_dependency_exception_1.CircularDependencyException("@InjectRepository()");
+      }
+      return repository.name;
+    }
+    function getDataSourceToken(dataSource = typeorm_constants_1.DEFAULT_DATA_SOURCE_NAME) {
+      return typeorm_constants_1.DEFAULT_DATA_SOURCE_NAME === dataSource ? typeorm_1.DataSource ?? typeorm_1.Connection : "string" === typeof dataSource ? `${dataSource}DataSource` : typeorm_constants_1.DEFAULT_DATA_SOURCE_NAME === dataSource.name || !dataSource.name ? typeorm_1.DataSource ?? typeorm_1.Connection : `${dataSource.name}DataSource`;
+    }
+    exports.getConnectionToken = getDataSourceToken;
+    function getDataSourcePrefix(dataSource = typeorm_constants_1.DEFAULT_DATA_SOURCE_NAME) {
+      if (dataSource === typeorm_constants_1.DEFAULT_DATA_SOURCE_NAME) {
+        return "";
+      }
+      if (typeof dataSource === "string") {
+        return dataSource + "_";
+      }
+      if (dataSource.name === typeorm_constants_1.DEFAULT_DATA_SOURCE_NAME || !dataSource.name) {
+        return "";
+      }
+      return dataSource.name + "_";
+    }
+    function getEntityManagerToken2(dataSource = typeorm_constants_1.DEFAULT_DATA_SOURCE_NAME) {
+      return typeorm_constants_1.DEFAULT_DATA_SOURCE_NAME === dataSource ? typeorm_1.EntityManager : "string" === typeof dataSource ? `${dataSource}EntityManager` : typeorm_constants_1.DEFAULT_DATA_SOURCE_NAME === dataSource.name || !dataSource.name ? typeorm_1.EntityManager : `${dataSource.name}EntityManager`;
+    }
+    function handleRetry(retryAttempts = 9, retryDelay = 3e3, dataSourceName = typeorm_constants_1.DEFAULT_DATA_SOURCE_NAME, verboseRetryLog = false, toRetry) {
+      return (source) => source.pipe((0, operators_1.retryWhen)((e) => e.pipe((0, operators_1.scan)((errorCount, error) => {
+        if (toRetry && !toRetry(error)) {
+          throw error;
+        }
+        const dataSourceInfo = dataSourceName === typeorm_constants_1.DEFAULT_DATA_SOURCE_NAME ? "" : ` (${dataSourceName})`;
+        const verboseMessage = verboseRetryLog ? ` Message: ${error.message}.` : "";
+        logger.error(`Unable to connect to the database${dataSourceInfo}.${verboseMessage} Retrying (${errorCount + 1})...`, error.stack);
+        if (errorCount + 1 >= retryAttempts) {
+          throw error;
+        }
+        return errorCount + 1;
+      }, 0), (0, operators_1.delay)(retryDelay))));
+    }
+    function getDataSourceName(options) {
+      return options && options.name ? options.name : typeorm_constants_1.DEFAULT_DATA_SOURCE_NAME;
+    }
+    var generateString = () => crypto.randomUUID();
+    exports.generateString = generateString;
+  }
+});
+
+// node_modules/@nestjs/typeorm/dist/common/typeorm.decorators.js
+var require_typeorm_decorators = __commonJS({
+  "node_modules/@nestjs/typeorm/dist/common/typeorm.decorators.js"(exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.InjectEntityManager = exports.InjectConnection = exports.InjectDataSource = exports.InjectRepository = void 0;
+    var common_1 = __require("@nestjs/common");
+    var typeorm_constants_1 = require_typeorm_constants();
+    var typeorm_utils_1 = require_typeorm_utils();
+    var InjectRepository = (entity, dataSource = typeorm_constants_1.DEFAULT_DATA_SOURCE_NAME) => (0, common_1.Inject)((0, typeorm_utils_1.getRepositoryToken)(entity, dataSource));
+    exports.InjectRepository = InjectRepository;
+    var InjectDataSource = (dataSource) => (0, common_1.Inject)((0, typeorm_utils_1.getDataSourceToken)(dataSource));
+    exports.InjectDataSource = InjectDataSource;
+    exports.InjectConnection = exports.InjectDataSource;
+    var InjectEntityManager = (dataSource) => (0, common_1.Inject)((0, typeorm_utils_1.getEntityManagerToken)(dataSource));
+    exports.InjectEntityManager = InjectEntityManager;
+  }
+});
+
+// node_modules/@nestjs/typeorm/dist/common/index.js
+var require_common = __commonJS({
+  "node_modules/@nestjs/typeorm/dist/common/index.js"(exports) {
+    "use strict";
+    var __createBinding = exports && exports.__createBinding || (Object.create ? (function(o, m, k, k2) {
+      if (k2 === void 0) 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 === void 0) k2 = k;
+      o[k2] = m[k];
+    }));
+    var __exportStar = exports && exports.__exportStar || function(m, exports2) {
+      for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports2, p)) __createBinding(exports2, m, p);
+    };
+    Object.defineProperty(exports, "__esModule", { value: true });
+    __exportStar(require_typeorm_decorators(), exports);
+    __exportStar(require_typeorm_utils(), exports);
+  }
+});
+
+// node_modules/@nestjs/typeorm/dist/interfaces/typeorm-options.interface.js
+var require_typeorm_options_interface = __commonJS({
+  "node_modules/@nestjs/typeorm/dist/interfaces/typeorm-options.interface.js"(exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+  }
+});
+
+// node_modules/@nestjs/typeorm/dist/interfaces/index.js
+var require_interfaces = __commonJS({
+  "node_modules/@nestjs/typeorm/dist/interfaces/index.js"(exports) {
+    "use strict";
+    var __createBinding = exports && exports.__createBinding || (Object.create ? (function(o, m, k, k2) {
+      if (k2 === void 0) 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 === void 0) k2 = k;
+      o[k2] = m[k];
+    }));
+    var __exportStar = exports && exports.__exportStar || function(m, exports2) {
+      for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports2, p)) __createBinding(exports2, m, p);
+    };
+    Object.defineProperty(exports, "__esModule", { value: true });
+    __exportStar(require_typeorm_options_interface(), exports);
+  }
+});
+
+// node_modules/@nestjs/typeorm/dist/entities-metadata.storage.js
+var require_entities_metadata_storage = __commonJS({
+  "node_modules/@nestjs/typeorm/dist/entities-metadata.storage.js"(exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.EntitiesMetadataStorage = void 0;
+    var EntitiesMetadataStorage = class {
+      static addEntitiesByDataSource(dataSource, entities) {
+        const dataSourceToken = typeof dataSource === "string" ? dataSource : dataSource.name;
+        if (!dataSourceToken) {
+          return;
+        }
+        let collection = this.storage.get(dataSourceToken);
+        if (!collection) {
+          collection = [];
+          this.storage.set(dataSourceToken, collection);
+        }
+        entities.forEach((entity) => {
+          if (collection.includes(entity)) {
+            return;
+          }
+          collection.push(entity);
+        });
+      }
+      static getEntitiesByDataSource(dataSource) {
+        const dataSourceToken = typeof dataSource === "string" ? dataSource : dataSource.name;
+        if (!dataSourceToken) {
+          return [];
+        }
+        return this.storage.get(dataSourceToken) || [];
+      }
+    };
+    exports.EntitiesMetadataStorage = EntitiesMetadataStorage;
+    EntitiesMetadataStorage.storage = /* @__PURE__ */ new Map();
+  }
+});
+
+// node_modules/@nestjs/typeorm/dist/typeorm-core.module.js
+var require_typeorm_core_module = __commonJS({
+  "node_modules/@nestjs/typeorm/dist/typeorm-core.module.js"(exports) {
+    "use strict";
+    var __decorate = exports && exports.__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 = exports && exports.__metadata || function(k, v) {
+      if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+    };
+    var __param = exports && exports.__param || function(paramIndex, decorator) {
+      return function(target, key) {
+        decorator(target, key, paramIndex);
+      };
+    };
+    var TypeOrmCoreModule_1;
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.TypeOrmCoreModule = void 0;
+    var common_1 = __require("@nestjs/common");
+    var core_1 = __require("@nestjs/core");
+    var rxjs_1 = __require("rxjs");
+    var typeorm_1 = __require("typeorm");
+    var typeorm_utils_1 = require_typeorm_utils();
+    var entities_metadata_storage_1 = require_entities_metadata_storage();
+    var typeorm_constants_1 = require_typeorm_constants();
+    var TypeOrmCoreModule = TypeOrmCoreModule_1 = class TypeOrmCoreModule {
+      constructor(options, moduleRef) {
+        this.options = options;
+        this.moduleRef = moduleRef;
+        this.logger = new common_1.Logger("TypeOrmModule");
+      }
+      static forRoot(options = {}) {
+        const typeOrmModuleOptions = {
+          provide: typeorm_constants_1.TYPEORM_MODULE_OPTIONS,
+          useValue: options
+        };
+        const dataSourceProvider = {
+          provide: (0, typeorm_utils_1.getDataSourceToken)(options),
+          useFactory: async () => await this.createDataSourceFactory(options)
+        };
+        const entityManagerProvider = this.createEntityManagerProvider(options);
+        const providers = [
+          entityManagerProvider,
+          dataSourceProvider,
+          typeOrmModuleOptions
+        ];
+        const exports2 = [entityManagerProvider, dataSourceProvider];
+        if (dataSourceProvider.provide === typeorm_1.DataSource) {
+          providers.push({
+            provide: typeorm_1.Connection,
+            useExisting: typeorm_1.DataSource
+          });
+          exports2.push(typeorm_1.Connection);
+        }
+        return {
+          module: TypeOrmCoreModule_1,
+          providers,
+          exports: exports2
+        };
+      }
+      static forRootAsync(options) {
+        const dataSourceProvider = {
+          provide: (0, typeorm_utils_1.getDataSourceToken)(options),
+          useFactory: async (typeOrmOptions) => {
+            if (options.name) {
+              return await this.createDataSourceFactory({
+                ...typeOrmOptions,
+                name: options.name
+              }, options.dataSourceFactory);
+            }
+            return await this.createDataSourceFactory(typeOrmOptions, options.dataSourceFactory);
+          },
+          inject: [typeorm_constants_1.TYPEORM_MODULE_OPTIONS]
+        };
+        const entityManagerProvider = {
+          provide: (0, typeorm_utils_1.getEntityManagerToken)(options),
+          useFactory: (dataSource) => dataSource.manager,
+          inject: [(0, typeorm_utils_1.getDataSourceToken)(options)]
+        };
+        const asyncProviders = this.createAsyncProviders(options);
+        const providers = [
+          ...asyncProviders,
+          entityManagerProvider,
+          dataSourceProvider,
+          {
+            provide: typeorm_constants_1.TYPEORM_MODULE_ID,
+            useValue: (0, typeorm_utils_1.generateString)()
+          },
+          ...options.extraProviders || []
+        ];
+        const exports2 = [
+          entityManagerProvider,
+          dataSourceProvider
+        ];
+        if (dataSourceProvider.provide === typeorm_1.DataSource) {
+          providers.push({
+            provide: typeorm_1.Connection,
+            useExisting: typeorm_1.DataSource
+          });
+          exports2.push(typeorm_1.Connection);
+        }
+        return {
+          module: TypeOrmCoreModule_1,
+          imports: options.imports,
+          providers,
+          exports: exports2
+        };
+      }
+      async onApplicationShutdown() {
+        const dataSource = this.moduleRef.get((0, typeorm_utils_1.getDataSourceToken)(this.options));
+        try {
+          if (dataSource && dataSource.isInitialized) {
+            await dataSource.destroy();
+          }
+        } catch (e) {
+          this.logger.error(e?.message);
+        }
+      }
+      static createAsyncProviders(options) {
+        if (options.useExisting || options.useFactory) {
+          return [this.createAsyncOptionsProvider(options)];
+        }
+        const useClass = options.useClass;
+        return [
+          this.createAsyncOptionsProvider(options),
+          {
+            provide: useClass,
+            useClass
+          }
+        ];
+      }
+      static createAsyncOptionsProvider(options) {
+        if (options.useFactory) {
+          return {
+            provide: typeorm_constants_1.TYPEORM_MODULE_OPTIONS,
+            useFactory: options.useFactory,
+            inject: options.inject || []
+          };
+        }
+        const inject = [
+          options.useClass || options.useExisting
+        ];
+        return {
+          provide: typeorm_constants_1.TYPEORM_MODULE_OPTIONS,
+          useFactory: async (optionsFactory) => await optionsFactory.createTypeOrmOptions(options.name),
+          inject
+        };
+      }
+      static createEntityManagerProvider(options) {
+        return {
+          provide: (0, typeorm_utils_1.getEntityManagerToken)(options),
+          useFactory: (dataSource) => dataSource.manager,
+          inject: [(0, typeorm_utils_1.getDataSourceToken)(options)]
+        };
+      }
+      static async createDataSourceFactory(options, dataSourceFactory) {
+        const dataSourceToken = (0, typeorm_utils_1.getDataSourceName)(options);
+        const createTypeormDataSource = dataSourceFactory ?? ((options2) => {
+          return typeorm_1.DataSource === void 0 ? (0, typeorm_1.createConnection)(options2) : new typeorm_1.DataSource(options2);
+        });
+        return await (0, rxjs_1.lastValueFrom)((0, rxjs_1.defer)(async () => {
+          let dataSource;
+          if (!options.autoLoadEntities) {
+            dataSource = await createTypeormDataSource(options);
+          } else {
+            let entities = options.entities;
+            if (Array.isArray(entities)) {
+              entities = entities.concat(entities_metadata_storage_1.EntitiesMetadataStorage.getEntitiesByDataSource(dataSourceToken));
+            } else {
+              entities = entities_metadata_storage_1.EntitiesMetadataStorage.getEntitiesByDataSource(dataSourceToken);
+            }
+            dataSource = await createTypeormDataSource({
+              ...options,
+              entities
+            });
+          }
+          return dataSource.initialize && !dataSource.isInitialized && !options.manualInitialization ? dataSource.initialize() : dataSource;
+        }).pipe((0, typeorm_utils_1.handleRetry)(options.retryAttempts, options.retryDelay, dataSourceToken, options.verboseRetryLog, options.toRetry)));
+      }
+    };
+    exports.TypeOrmCoreModule = TypeOrmCoreModule;
+    exports.TypeOrmCoreModule = TypeOrmCoreModule = TypeOrmCoreModule_1 = __decorate([
+      (0, common_1.Global)(),
+      (0, common_1.Module)({}),
+      __param(0, (0, common_1.Inject)(typeorm_constants_1.TYPEORM_MODULE_OPTIONS)),
+      __metadata("design:paramtypes", [Object, core_1.ModuleRef])
+    ], TypeOrmCoreModule);
+  }
+});
+
+// node_modules/@nestjs/typeorm/dist/typeorm.providers.js
+var require_typeorm_providers = __commonJS({
+  "node_modules/@nestjs/typeorm/dist/typeorm.providers.js"(exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.createTypeOrmProviders = createTypeOrmProviders;
+    var typeorm_1 = __require("typeorm");
+    var typeorm_utils_1 = require_typeorm_utils();
+    function createTypeOrmProviders(entities, dataSource) {
+      return (entities || []).map((entity) => ({
+        provide: (0, typeorm_utils_1.getRepositoryToken)(entity, dataSource),
+        useFactory: (dataSource2) => {
+          const entityMetadata = dataSource2.entityMetadatas.find((meta) => meta.target === entity);
+          const isTreeEntity = typeof entityMetadata?.treeType !== "undefined";
+          return isTreeEntity ? dataSource2.getTreeRepository(entity) : dataSource2.options.type === "mongodb" ? dataSource2.getMongoRepository(entity) : dataSource2.getRepository(entity);
+        },
+        inject: [(0, typeorm_utils_1.getDataSourceToken)(dataSource)],
+        /**
+         * Extra property to workaround dynamic modules serialisation issue
+         * that occurs when "TypeOrm#forFeature()" method is called with the same number
+         * of arguments and all entities share the same class names.
+         */
+        targetEntitySchema: (0, typeorm_1.getMetadataArgsStorage)().tables.find((item) => item.target === entity)
+      }));
+    }
+  }
+});
+
+// node_modules/@nestjs/typeorm/dist/typeorm.module.js
+var require_typeorm_module = __commonJS({
+  "node_modules/@nestjs/typeorm/dist/typeorm.module.js"(exports) {
+    "use strict";
+    var __decorate = exports && exports.__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 TypeOrmModule_1;
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.TypeOrmModule = void 0;
+    var common_1 = __require("@nestjs/common");
+    var entities_metadata_storage_1 = require_entities_metadata_storage();
+    var typeorm_core_module_1 = require_typeorm_core_module();
+    var typeorm_constants_1 = require_typeorm_constants();
+    var typeorm_providers_1 = require_typeorm_providers();
+    var TypeOrmModule2 = TypeOrmModule_1 = class TypeOrmModule {
+      static forRoot(options) {
+        return {
+          module: TypeOrmModule_1,
+          imports: [typeorm_core_module_1.TypeOrmCoreModule.forRoot(options)]
+        };
+      }
+      static forFeature(entities = [], dataSource = typeorm_constants_1.DEFAULT_DATA_SOURCE_NAME) {
+        const providers = (0, typeorm_providers_1.createTypeOrmProviders)(entities, dataSource);
+        entities_metadata_storage_1.EntitiesMetadataStorage.addEntitiesByDataSource(dataSource, [...entities]);
+        return {
+          module: TypeOrmModule_1,
+          providers,
+          exports: providers
+        };
+      }
+      static forRootAsync(options) {
+        return {
+          module: TypeOrmModule_1,
+          imports: [typeorm_core_module_1.TypeOrmCoreModule.forRootAsync(options)]
+        };
+      }
+    };
+    exports.TypeOrmModule = TypeOrmModule2;
+    exports.TypeOrmModule = TypeOrmModule2 = TypeOrmModule_1 = __decorate([
+      (0, common_1.Module)({})
+    ], TypeOrmModule2);
+  }
+});
+
+// node_modules/@nestjs/typeorm/dist/index.js
+var require_dist = __commonJS({
+  "node_modules/@nestjs/typeorm/dist/index.js"(exports) {
+    "use strict";
+    var __createBinding = exports && exports.__createBinding || (Object.create ? (function(o, m, k, k2) {
+      if (k2 === void 0) 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 === void 0) k2 = k;
+      o[k2] = m[k];
+    }));
+    var __exportStar = exports && exports.__exportStar || function(m, exports2) {
+      for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports2, p)) __createBinding(exports2, m, p);
+    };
+    Object.defineProperty(exports, "__esModule", { value: true });
+    __exportStar(require_common(), exports);
+    __exportStar(require_interfaces(), exports);
+    __exportStar(require_typeorm_module(), exports);
+  }
+});
+
+// node_modules/@nestjs/typeorm/index.js
+var require_typeorm = __commonJS({
+  "node_modules/@nestjs/typeorm/index.js"(exports) {
+    "use strict";
+    function __export(m) {
+      for (var p in m) if (!exports.hasOwnProperty(p)) exports[p] = m[p];
+    }
+    exports.__esModule = true;
+    __export(require_dist());
+  }
+});
+
 // index.ts
 export * from "nesties";
 
@@ -71,6 +633,7 @@ import { IsOptional } from "class-validator";
 
 // src/utility/metadata.ts
 import { MetadataSetter, Reflector } from "typed-reflector";
+import _ from "lodash";
 var Metadata = new MetadataSetter();
 var reflector = new Reflector();
 function getSpecificFields(obj, type, filter = () => true) {
@@ -83,11 +646,11 @@ function getSpecificFields(obj, type, filter = () => true) {
   });
 }
 function getNotInResultFields(obj, keepEntityVersioningDates = false) {
-  return getSpecificFields(
-    obj,
-    "notInResult",
-    (meta) => !keepEntityVersioningDates || !meta.entityVersioningDate
-  );
+  const res = getSpecificFields(obj, "notInResult");
+  if (keepEntityVersioningDates) {
+    return _.difference(res, getSpecificFields(obj, "entityVersioningDate"));
+  }
+  return res;
 }
 
 // src/decorators/access.ts
@@ -103,8 +666,12 @@ var NotCreatable = () => MergePropertyDecorators([
 var NotChangeable = () => MergePropertyDecorators([
   Metadata.set("notChangeable", true, "notChangeableFields")
 ]);
+var NotUpsertable = () => MergePropertyDecorators([
+  IsOptional(),
+  Metadata.set("notUpsertable", true, "notUpsertableFields")
+]);
 var NotQueryable = () => Metadata.set("notQueryable", true, "notQueryableFields");
-var NotInResult = (options = {}) => Metadata.set("notInResult", options, "notInResultFields");
+var NotInResult = () => Metadata.set("notInResult", true, "notInResultFields");
 
 // src/decorators/property.ts
 import { ApiProperty as ApiProperty2 } from "@nestjs/swagger";
@@ -798,6 +1365,24 @@ var BindingValue = (bindingKey = DefaultBindingKey) => (obj, key, des) => {
   )(obj, key);
 };
 
+// src/decorators/upsert.ts
+import { Unique } from "typeorm";
+var UpsertColumn = () => Metadata.set("upsertColumn", true, "upsertColumnFields");
+var UpsertableEntity = () => (cls) => {
+  const upsertColumns = getSpecificFields(cls, "upsertColumn");
+  const bindingColumns = getSpecificFields(cls, "bindingColumn");
+  if (!upsertColumns.length && !bindingColumns.length) {
+    throw new Error(
+      `UpsertableEntity ${cls.name} must have at least one UpsertColumn or BindingColumn defined.`
+    );
+  }
+  Metadata.set("upsertableEntity", true)(cls);
+  if (!bindingColumns.length && upsertColumns.length === 1 && upsertColumns[0] === "id") {
+    return;
+  }
+  Unique([.../* @__PURE__ */ new Set([...bindingColumns, ...upsertColumns])])(cls);
+};
+
 // src/dto/cursor-pagination.ts
 var CursorPaginationDto = class {
 };
@@ -935,6 +1520,7 @@ __decorateClass([
 ], PageSettingsDto.prototype, "recordsPerPage", 2);
 
 // src/bases/time-base.ts
+var EntityVersioningDate = () => Metadata.set("entityVersioningDate", true, "entityVersioningDateFields");
 var TimeBase = class extends PageSettingsDto {
   isValidInCreate() {
     return;
@@ -957,23 +1543,35 @@ var TimeBase = class extends PageSettingsDto {
   // eslint-disable-next-line @typescript-eslint/no-empty-function
   async beforeUpdate() {
   }
+  isValidInUpsert() {
+    return;
+  }
+  // eslint-disable-next-line @typescript-eslint/no-empty-function
+  async beforeUpsert() {
+  }
+  // eslint-disable-next-line @typescript-eslint/no-empty-function
+  async afterUpsert() {
+  }
 };
 __decorateClass([
   CreateDateColumn({ select: false }),
   NotColumn(),
-  NotInResult({ entityVersioningDate: true }),
+  NotInResult(),
+  EntityVersioningDate(),
   Reflect.metadata("design:type", Date)
 ], TimeBase.prototype, "createTime", 2);
 __decorateClass([
   UpdateDateColumn({ select: false }),
   NotColumn(),
-  NotInResult({ entityVersioningDate: true }),
+  NotInResult(),
+  EntityVersioningDate(),
   Reflect.metadata("design:type", Date)
 ], TimeBase.prototype, "updateTime", 2);
 __decorateClass([
   DeleteDateColumn({ select: false }),
   NotColumn(),
-  NotInResult({ entityVersioningDate: true }),
+  NotInResult(),
+  EntityVersioningDate(),
   Reflect.metadata("design:type", Date)
 ], TimeBase.prototype, "deleteTime", 2);
 
@@ -1034,7 +1632,8 @@ function StringIdBase(idOptions) {
     ...idOptions.uuid ? [UuidColumn({ ...columnOptions, generated: true }), NotWritable()] : [
       StringColumn(idOptions.length || 255, columnOptions),
       IsNotEmpty2(),
-      NotChangeable()
+      NotChangeable(),
+      UpsertColumn()
     ]
   ];
   const dec = MergePropertyDecorators4(decs);
@@ -1043,9 +1642,9 @@ function StringIdBase(idOptions) {
 }
 
 // src/crud-base.ts
-import { ConsoleLogger } from "@nestjs/common";
+import { ConsoleLogger, HttpException } from "@nestjs/common";
 import { camelCase } from "typeorm/util/StringUtils";
-import _3, { omit } from "lodash";
+import _4, { omit } from "lodash";
 import {
   BlankReturnMessageDto as BlankReturnMessageDto2,
   GenericReturnMessageDto,
@@ -1055,7 +1654,7 @@ import {
 
 // src/utility/get-typeorm-relations.ts
 import { getMetadataArgsStorage } from "typeorm";
-import _ from "lodash";
+import _2 from "lodash";
 function getTypeormRelations(cl) {
   const relations = getMetadataArgsStorage().relations.filter(
     (r) => r.target === cl
@@ -1096,7 +1695,7 @@ function getTypeormRelations(cl) {
       };
     }
   );
-  return _.uniqBy(
+  return _2.uniqBy(
     [...typeormRelations, ...computedRelations],
     // Merge typeorm relations and computed relations
     (r) => r.propertyName
@@ -1105,7 +1704,7 @@ function getTypeormRelations(cl) {
 
 // src/utility/cursor-pagination-utils.ts
 import { Brackets as Brackets2 } from "typeorm";
-import _2 from "lodash";
+import _3 from "lodash";
 import SJSON from "superjson";
 
 // src/utility/filter-relations.ts
@@ -1273,7 +1872,7 @@ async function getPaginatedResult(qb, entityClass, entityAliasName, take, cursor
     );
     if (keys.length) {
       const staircasedKeys = keys.map(
-        (key, i) => _2.range(i + 1).map((j) => keys[j])
+        (key, i) => _3.range(i + 1).map((j) => keys[j])
       );
       const cursorKey = (key) => `_cursor_${key.replace(/\./g, "__").replace(/"/g, "")}`;
       const expressionMatrix = staircasedKeys.map(
@@ -1577,15 +2176,23 @@ var CrudBase = class {
     this._restoreBindings(snap);
     return res;
   }
+  async _mayBeTransaction(cb, manager = this.repo.manager) {
+    const hasActiveTx = !!manager.queryRunner?.isTransactionActive;
+    const getRepo = (m) => m.getRepository(this.entityClass);
+    if (hasActiveTx) {
+      return cb(manager, getRepo(manager));
+    } else {
+      return manager.transaction(async (tdb) => await cb(tdb, getRepo(tdb)));
+    }
+  }
   async _batchCreate(ents, beforeCreate, skipErrors = false) {
     const entsWithId = ents.filter((ent) => ent.id != null);
-    return this.repo.manager.transaction(async (mdb) => {
+    return this._mayBeTransaction(async (mdb, repo) => {
       let skipped = [];
-      const repo = mdb.getRepository(this.entityClass);
       let entsToSave = ents;
       if (entsWithId.length) {
         const entIds = entsWithId.map((ent) => ent.id);
-        const entIdChunks = _3.chunk(entIds, 65535);
+        const entIdChunks = _4.chunk(entIds, 65535);
         const existingEnts = (await Promise.all(
           entIdChunks.map(
             (chunk) => repo.find({
@@ -1656,7 +2263,7 @@ var CrudBase = class {
         await beforeCreate(repo);
       }
       try {
-        const entChunksToSave = _3.chunk(
+        const entChunksToSave = _4.chunk(
           entsToSave,
           Math.floor(
             65535 / Math.max(1, Object.keys(entsToSave[0] || {}).length)
@@ -1695,13 +2302,16 @@ var CrudBase = class {
     if (invalidReason) {
       throw new BlankReturnMessageDto2(400, invalidReason).toException();
     }
-    const savedEnt = await this.repo.manager.transaction(async (mdb) => {
-      const repo = mdb.getRepository(this.entityClass);
+    const savedEnt = await this._mayBeTransaction(async (mdb, repo) => {
       if (ent.id != null) {
         const existingEnt = await repo.findOne({
           where: { id: ent.id },
           select: this.crudOptions.createOrUpdate ? void 0 : ["id", "deleteTime"],
-          withDeleted: true
+          withDeleted: true,
+          lock: {
+            mode: "pessimistic_write",
+            tables: [repo.metadata.tableName]
+          }
         });
         if (existingEnt) {
           if (existingEnt.deleteTime) {
@@ -1791,12 +2401,24 @@ var CrudBase = class {
       });
     }
   }
+  _applyQueryKeepEntityVersioningDates(qb) {
+    if (this.crudOptions.keepEntityVersioningDates) {
+      const versioningDateFields = getSpecificFields(
+        this.entityClass,
+        "entityVersioningDate"
+      );
+      for (const field of versioningDateFields) {
+        qb.addSelect(`${this.entityAliasName}.${field}`);
+      }
+    }
+  }
   async findOne(id, extraQuery = () => {
   }) {
     const bindingEnt = await this.getBindingPartialEntity();
     const query = this.queryBuilder().where(`${this.entityAliasName}.id = :id`, { id }).take(1);
     this._applyQueryRelations(query);
     this._applyQueryFromBinding(bindingEnt, query);
+    this._applyQueryKeepEntityVersioningDates(query);
     this.extraGetQuery(query);
     extraQuery(query);
     query.take(1);
@@ -1838,6 +2460,7 @@ var CrudBase = class {
     this._applyQueryRelations(query);
     this._applyQueryFilters(query, newEnt);
     this._applyQueryFromBinding(bindingEnt, query);
+    this._applyQueryKeepEntityVersioningDates(query);
     const pageSettings = newEnt instanceof PageSettingsDto ? newEnt : Object.assign(new PageSettingsDto(), newEnt);
     this.extraGetQuery(query);
     extraQuery(query);
@@ -1930,6 +2553,116 @@ var CrudBase = class {
     }
     return new BlankReturnMessageDto2(200, "success");
   }
+  async upsert(_ent) {
+    const bindingEnt = await this.getBindingPartialEntity();
+    if (!_ent) {
+      throw new BlankReturnMessageDto2(400, "Invalid entity").toException();
+    }
+    const ent = new this.entityClass();
+    Object.assign(
+      ent,
+      omit(_ent, ...this._typeormRelations.map((r) => r.propertyName))
+    );
+    const invalidReason = ent.isValidInUpsert();
+    if (invalidReason) {
+      throw new BlankReturnMessageDto2(400, invalidReason).toException();
+    }
+    const upsertColumns = getSpecificFields(this.entityClass, "upsertColumn");
+    const conditions = {
+      ..._4.pick(ent, upsertColumns),
+      ...bindingEnt
+    };
+    const conditionKeys = [
+      .../* @__PURE__ */ new Set([
+        ...getSpecificFields(this.entityClass, "bindingColumn"),
+        ...upsertColumns
+      ])
+    ];
+    Object.assign(ent, conditions);
+    let deleteColumnProperty = "";
+    if (!this.crudOptions.hardDelete) {
+      const deleteColumn = this.repo.manager.connection.getMetadata(
+        this.entityClass
+      ).deleteDateColumn;
+      if (deleteColumn) {
+        ent[deleteColumn.propertyName] = null;
+        deleteColumnProperty = deleteColumn.propertyName;
+      }
+    }
+    await ent.beforeUpsert?.();
+    try {
+      const savedEnt = await this._mayBeTransaction(async (mdb, repo) => {
+        const res = await repo.upsert(ent, {
+          conflictPaths: conditionKeys
+        });
+        const insertedId = res.identifiers[0]?.id;
+        const fetchSaved = () => {
+          const qb = repo.createQueryBuilder(this.entityAliasName);
+          if (insertedId != null) {
+            qb.where(`${this.entityAliasName}.id = :id`, { id: insertedId });
+          } else {
+            conditionKeys.forEach((key, i) => {
+              const paramKey = `_cond_${key}`;
+              qb[i === 0 ? "where" : "andWhere"](
+                `${this.entityAliasName}.${key} = :${paramKey}`,
+                {
+                  [paramKey]: conditions[key]
+                }
+              );
+            });
+          }
+          qb.take(1);
+          if (deleteColumnProperty) {
+            if (!this.crudOptions.keepEntityVersioningDates) {
+              qb.addSelect(`${this.entityAliasName}.${deleteColumnProperty}`);
+            }
+            qb.withDeleted();
+          }
+          this._applyQueryKeepEntityVersioningDates(qb);
+          if (this.crudOptions.upsertIncludeRelations) {
+            this._applyQueryRelations(qb);
+          }
+          return qb.getOne();
+        };
+        let saved = await fetchSaved();
+        if (!saved) {
+          this.log.error(
+            `Failed to upsert entity ${JSON.stringify(
+              ent
+            )}: cannot find saved entity after upsert.`
+          );
+          throw new BlankReturnMessageDto2(500, "Internal error").toException();
+        }
+        if (deleteColumnProperty && saved[deleteColumnProperty]) {
+          await repo.restore(insertedId ? { id: insertedId } : conditions);
+          saved = await fetchSaved();
+          if (!saved || saved[deleteColumnProperty]) {
+            this.log.error(
+              `Failed to upsert entity ${JSON.stringify(
+                ent
+              )}: cannot restore soft-deleted entity after upsert.`
+            );
+            throw new BlankReturnMessageDto2(
+              500,
+              "Internal error"
+            ).toException();
+          }
+        }
+        return saved;
+      });
+      await savedEnt.afterUpsert?.();
+      this.cleanEntityNotInResultFields(savedEnt);
+      return new this.entityReturnMessageDto(200, "success", savedEnt);
+    } catch (e) {
+      if (e instanceof HttpException) {
+        throw e;
+      }
+      this.log.error(
+        `Failed to upsert entity ${JSON.stringify(ent)}: ${e.toString()}`
+      );
+      throw new BlankReturnMessageDto2(500, "Internal error").toException();
+    }
+  }
   async delete(id, cond = {}) {
     const bindingEnt = await this.getBindingPartialEntity();
     let result;
@@ -1962,7 +2695,7 @@ var CrudBase = class {
       );
       return newEnt;
     });
-    const invalidResults = _3.compact(
+    const invalidResults = _4.compact(
       await Promise.all(
         ents.map(async (ent) => {
           const reason = ent.isValidInCreate();
@@ -2135,9 +2868,10 @@ var CrudBase = class {
       await flush();
       return result;
     };
-    const res = await (options.repo ? op(options.repo) : this.repo.manager.transaction(
-      (tdb) => op(tdb.getRepository(this.entityClass))
-    ));
+    const res = await this._mayBeTransaction(
+      (tdb, repo) => op(repo),
+      options.repo?.manager || this.repo.manager
+    );
     return res == null ? new BlankReturnMessageDto2(200, "success") : new GenericReturnMessageDto(200, "success", res);
   }
   async _loadFullTextIndex() {
@@ -2197,6 +2931,7 @@ import {
   ParseIntPipe,
   Patch,
   Post,
+  Put,
   Query
 } from "@nestjs/common";
 import {
@@ -2219,7 +2954,7 @@ import {
   OmitType as OmitType2,
   PartialType
 } from "@nestjs/swagger";
-import _5, { upperFirst } from "lodash";
+import _6, { upperFirst } from "lodash";
 import { RenameClass } from "nesties";
 
 // src/bases/base-restful-controller.ts
@@ -2228,6 +2963,7 @@ var RestfulMethods = [
   "findAll",
   "create",
   "update",
+  "upsert",
   "delete",
   "import"
 ];
@@ -2262,6 +2998,9 @@ var BaseRestfulController = class {
   update(id, dto) {
     return this._service.update(id, dto);
   }
+  upsert(dto) {
+    return this._service.upsert(dto);
+  }
   delete(id) {
     return this._service.delete(id);
   }
@@ -2293,7 +3032,7 @@ var PickTypeExpose = (cl, keys) => {
 
 // src/utility/patch-column-in-get.ts
 import { getApiProperty } from "nesties";
-import _4 from "lodash";
+import _5 from "lodash";
 import { DECORATORS } from "@nestjs/swagger/dist/constants";
 var PatchColumnsInGet = (cl, originalCl = cl, fieldsToOmit = []) => {
   const omit2 = new Set(fieldsToOmit);
@@ -2319,7 +3058,7 @@ var PatchColumnsInGet = (cl, originalCl = cl, fieldsToOmit = []) => {
       field
     );
   }
-  const queryableFieldsRemaining = _4.difference(
+  const queryableFieldsRemaining = _5.difference(
     getSpecificFields(useCl, "queryCondition"),
     mutateFields
   );
@@ -2380,7 +3119,7 @@ var _RestfulFactory = class _RestfulFactory {
       this.entityClass,
       {
         ...this.options,
-        fieldsToOmit: _5.uniq([...this.options.fieldsToOmit || [], ...fields])
+        fieldsToOmit: _6.uniq([...this.options.fieldsToOmit || [], ...fields])
       },
       this.__resolveVisited
     );
@@ -2390,7 +3129,7 @@ var _RestfulFactory = class _RestfulFactory {
       this.entityClass,
       {
         ...this.options,
-        writeFieldsToOmit: _5.uniq([
+        writeFieldsToOmit: _6.uniq([
           ...this.options.writeFieldsToOmit || [],
           ...fields
         ])
@@ -2403,7 +3142,7 @@ var _RestfulFactory = class _RestfulFactory {
       this.entityClass,
       {
         ...this.options,
-        createFieldsToOmit: _5.uniq([
+        createFieldsToOmit: _6.uniq([
           ...this.options.createFieldsToOmit || [],
           ...fields
         ])
@@ -2416,7 +3155,7 @@ var _RestfulFactory = class _RestfulFactory {
       this.entityClass,
       {
         ...this.options,
-        updateFieldsToOmit: _5.uniq([
+        updateFieldsToOmit: _6.uniq([
           ...this.options.updateFieldsToOmit || [],
           ...fields
         ])
@@ -2424,12 +3163,25 @@ var _RestfulFactory = class _RestfulFactory {
       this.__resolveVisited
     );
   }
+  omitUpsert(...fields) {
+    return new _RestfulFactory(
+      this.entityClass,
+      {
+        ...this.options,
+        upsertFieldsToOmit: _6.uniq([
+          ...this.options.upsertFieldsToOmit || [],
+          ...fields
+        ])
+      },
+      this.__resolveVisited
+    );
+  }
   omitFindAll(...fields) {
     return new _RestfulFactory(
       this.entityClass,
       {
         ...this.options,
-        findAllFieldsToOmit: _5.uniq([
+        findAllFieldsToOmit: _6.uniq([
           ...this.options.findAllFieldsToOmit || [],
           ...fields
         ])
@@ -2442,7 +3194,7 @@ var _RestfulFactory = class _RestfulFactory {
       this.entityClass,
       {
         ...this.options,
-        outputFieldsToOmit: _5.uniq([
+        outputFieldsToOmit: _6.uniq([
           ...this.options.outputFieldsToOmit || [],
           ...fields
         ])
@@ -2504,7 +3256,7 @@ var _RestfulFactory = class _RestfulFactory {
     return this.options.entityClassName || this.entityClass.name;
   }
   get fieldsToOmit() {
-    return _5.uniq([
+    return _6.uniq([
       ...getSpecificFields(this.entityClass, "notColumn"),
       ...this.options.fieldsToOmit || [],
       ...getTypeormRelations(this.entityClass).map(
@@ -2513,7 +3265,7 @@ var _RestfulFactory = class _RestfulFactory {
     ]);
   }
   get fieldsInCreateToOmit() {
-    return _5.uniq([
+    return _6.uniq([
       ...this.fieldsToOmit,
       ...this.options.writeFieldsToOmit || [],
       ...this.options.createFieldsToOmit || [],
@@ -2528,7 +3280,7 @@ var _RestfulFactory = class _RestfulFactory {
     );
   }
   get fieldsInUpdateToOmit() {
-    return _5.uniq([
+    return _6.uniq([
       ...this.fieldsToOmit,
       ...this.options.writeFieldsToOmit || [],
       ...this.options.updateFieldsToOmit || [],
@@ -2542,21 +3294,36 @@ var _RestfulFactory = class _RestfulFactory {
       `Update${this.entityClassName}Dto`
     );
   }
+  get fieldsInUpsertToOmit() {
+    return _6.uniq([
+      ...this.fieldsToOmit,
+      ...this.options.writeFieldsToOmit || [],
+      ...this.options.upsertFieldsToOmit || [],
+      ...getSpecificFields(this.entityClass, "notWritable"),
+      ...getSpecificFields(this.entityClass, "notUpsertable")
+    ]);
+  }
+  get upsertDto() {
+    return RenameClass(
+      OmitTypeExclude(this.entityClass, this.fieldsInUpsertToOmit),
+      `Upsert${this.entityClassName}Dto`
+    );
+  }
   get importDto() {
     return ImportDataDto(this.createDto);
   }
   get fieldsInGetToOmit() {
-    return _5.uniq([
+    return _6.uniq([
       ...this.fieldsToOmit,
       ...getSpecificFields(this.entityClass, "notQueryable"),
-      ..._5.difference(
+      ..._6.difference(
         getSpecificFields(this.entityClass, "requireGetMutator"),
         getSpecificFields(this.entityClass, "getMutator")
       )
     ]);
   }
   get queryableFields() {
-    return _5.difference(
+    return _6.difference(
       [
         ...getSpecificFields(this.entityClass, "queryCondition"),
         "pageCount",
@@ -2688,6 +3455,21 @@ var _RestfulFactory = class _RestfulFactory {
       `${this.entityClassName}CreateResultDto`
     );
   }
+  get entityUpsertResultDto() {
+    return RenameClass(
+      OmitType2(this.entityResultDto, [
+        ...this.options.upsertIncludeRelations ? [] : getTypeormRelations(this.entityClass).map(
+          (r) => r.propertyName
+        ),
+        ...getSpecificFields(
+          this.entityClass,
+          "notColumn",
+          (m) => m.hideInUpsert
+        )
+      ]),
+      `${this.entityClassName}UpsertResultDto`
+    );
+  }
   get entityReturnMessageDto() {
     return ReturnMessageDto2(this.entityResultDto);
   }
@@ -2723,7 +3505,7 @@ var _RestfulFactory = class _RestfulFactory {
       HttpCode(200),
       ApiOperation({
         summary: `Create a new ${this.entityClassName}`,
-        ..._5.omit(extras, "prefix")
+        ..._6.omit(extras, "prefix")
       }),
       ApiBody({ type: this.createDto }),
       ApiOkResponse({ type: this.entityCreateReturnMessageDto }),
@@ -2733,12 +3515,36 @@ var _RestfulFactory = class _RestfulFactory {
   createParam() {
     return Body(DataPipe(), OmitPipe(this.fieldsInCreateToOmit));
   }
+  isUpsertable() {
+    return !!reflector.get("upsertableEntity", this.entityClass);
+  }
+  upsert(extras = {}) {
+    if (!this.isUpsertable()) {
+      throw new Error(
+        `Entity ${this.entityClass.name} is not upsertable. Please define at least one UpsertColumn or BindingColumn, and set @UpsertableEntity() decorator.`
+      );
+    }
+    return MergeMethodDecorators([
+      this.usePrefix(Put, extras.prefix),
+      HttpCode(200),
+      ApiOperation({
+        summary: `Upsert a ${this.entityClassName}`,
+        ..._6.omit(extras, "prefix")
+      }),
+      ApiBody({ type: this.upsertDto }),
+      ApiOkResponse({ type: this.entityUpsertResultDto }),
+      ApiError(400, `The ${this.entityClassName} is not valid`)
+    ]);
+  }
+  upsertParam() {
+    return Body(DataPipe(), OmitPipe(this.fieldsInUpsertToOmit));
+  }
   findOne(extras = {}) {
     return MergeMethodDecorators([
       this.usePrefix(Get, extras.prefix, ":id"),
       ApiOperation({
         summary: `Find a ${this.entityClassName} by id`,
-        ..._5.omit(extras, "prefix")
+        ..._6.omit(extras, "prefix")
       }),
       ApiParam({ name: "id", type: this.idType, required: true }),
       ApiOkResponse({ type: this.entityReturnMessageDto }),
@@ -2760,7 +3566,7 @@ var _RestfulFactory = class _RestfulFactory {
       this.usePrefix(Get, extras.prefix),
       ApiOperation({
         summary: `Find all ${this.entityClassName}`,
-        ..._5.omit(extras, "prefix")
+        ..._6.omit(extras, "prefix")
       }),
       ApiOkResponse({ type: this.entityArrayReturnMessageDto })
     ]);
@@ -2770,14 +3576,14 @@ var _RestfulFactory = class _RestfulFactory {
       this.usePrefix(Get, extras.prefix),
       ApiOperation({
         summary: `Find all ${this.entityClassName}`,
-        ..._5.omit(extras, "prefix")
+        ..._6.omit(extras, "prefix")
       }),
       ApiOkResponse({ type: this.entityCursorPaginationReturnMessageDto })
     ]);
   }
   getMutatorColumns() {
     const mutatorColumns = getSpecificFields(this.entityClass, "getMutator");
-    return _5.difference(mutatorColumns, this.fieldsInGetToOmit);
+    return _6.difference(mutatorColumns, this.fieldsInGetToOmit);
   }
   findAllParam() {
     const mutatorColumns = this.getMutatorColumns();
@@ -2797,7 +3603,7 @@ var _RestfulFactory = class _RestfulFactory {
       HttpCode(200),
       ApiOperation({
         summary: `Update a ${this.entityClassName} by id`,
-        ..._5.omit(extras, "prefix")
+        ..._6.omit(extras, "prefix")
       }),
       ApiParam({ name: "id", type: this.idType, required: true }),
       ApiBody({ type: this.updateDto }),
@@ -2819,7 +3625,7 @@ var _RestfulFactory = class _RestfulFactory {
       HttpCode(200),
       ApiOperation({
         summary: `Delete a ${this.entityClassName} by id`,
-        ..._5.omit(extras, "prefix")
+        ..._6.omit(extras, "prefix")
       }),
       ApiParam({ name: "id", type: this.idType, required: true }),
       ApiBlankResponse(),
@@ -2836,7 +3642,7 @@ var _RestfulFactory = class _RestfulFactory {
       HttpCode(200),
       ApiOperation({
         summary: `Import ${this.entityClassName}`,
-        ..._5.omit(extras, "prefix")
+        ..._6.omit(extras, "prefix")
       }),
       ApiBody({ type: this.importDto }),
       ApiOkResponse({ type: this.importReturnMessageDto }),
@@ -2849,7 +3655,7 @@ var _RestfulFactory = class _RestfulFactory {
       HttpCode(200),
       ApiOperation({
         summary: `${upperFirst(operationName)} a ${this.entityClassName} by id`,
-        ..._5.omit(options, "prefix", "returnType")
+        ..._6.omit(options, "prefix", "returnType")
       }),
       options.returnType ? ApiTypeResponse(options.returnType) : ApiBlankResponse(),
       ApiError(
@@ -2873,6 +3679,7 @@ var _RestfulFactory = class _RestfulFactory {
       (m) => routeOptions?.routes?.[m]?.enabled === true
     );
     const validMethods = RestfulMethods.filter((m) => {
+      if (m === "upsert" && !this.isUpsertable()) return false;
       const value = routeOptions?.routes?.[m]?.enabled;
       if (value === false) return false;
       if (value === true) return true;
@@ -2906,6 +3713,11 @@ var _RestfulFactory = class _RestfulFactory {
         paramDecorators: () => [this.idParam(), this.updateParam()],
         methodDecorators: () => [this.update()]
       },
+      upsert: {
+        paramTypes: [this.upsertDto],
+        paramDecorators: () => [this.upsertParam()],
+        methodDecorators: () => [this.upsert()]
+      },
       delete: {
         paramTypes: [this.idType],
         paramDecorators: () => [this.idParam()],
@@ -2972,9 +3784,14 @@ var _RestfulFactory = class _RestfulFactory {
     return RenameClass(cl, `${this.entityClassName}Controller`);
   }
   crudService(options = {}) {
+    const keysToMigrate = [
+      "relations",
+      "outputFieldsToOmit",
+      "upsertIncludeRelations",
+      "keepEntityVersioningDates"
+    ];
     return CrudService(this.entityClass, {
-      relations: this.options.relations,
-      outputFieldsToOmit: this.options.outputFieldsToOmit,
+      ..._6.pick(this.options, keysToMigrate),
       ...options
     });
   }
@@ -2994,6 +3811,12 @@ __decorateClass([
 __decorateClass([
   Memorize()
 ], _RestfulFactory.prototype, "updateDto", 1);
+__decorateClass([
+  Memorize()
+], _RestfulFactory.prototype, "fieldsInUpsertToOmit", 1);
+__decorateClass([
+  Memorize()
+], _RestfulFactory.prototype, "upsertDto", 1);
 __decorateClass([
   Memorize()
 ], _RestfulFactory.prototype, "importDto", 1);
@@ -3015,6 +3838,9 @@ __decorateClass([
 __decorateClass([
   Memorize()
 ], _RestfulFactory.prototype, "entityCreateResultDto", 1);
+__decorateClass([
+  Memorize()
+], _RestfulFactory.prototype, "entityUpsertResultDto", 1);
 __decorateClass([
   Memorize()
 ], _RestfulFactory.prototype, "entityReturnMessageDto", 1);
@@ -3099,6 +3925,195 @@ var applyQueryMatchBooleanMySQL = createQueryCondition(
     }
   }
 );
+
+// src/transactional-typeorm.module.ts
+var import_typeorm9 = __toESM(require_typeorm());
+import { EntityManager as EntityManager2 } from "typeorm";
+import {
+  Inject as Inject2,
+  Injectable,
+  Module,
+  Scope
+} from "@nestjs/common";
+import { createProvider } from "nesties";
+import { REQUEST } from "@nestjs/core";
+
+// src/utility/create-dynamic-fetcher-proxy.ts
+var createDynamicFetcherProxy = (initial, fetcher) => {
+  return new Proxy(initial, {
+    get(_target, prop, receiver) {
+      const current = fetcher();
+      const value = Reflect.get(current, prop, receiver);
+      if (typeof value === "function") {
+        return value.bind(current);
+      }
+      return value;
+    },
+    set(_target, prop, value, receiver) {
+      const current = fetcher();
+      return Reflect.set(current, prop, value, receiver);
+    },
+    has(_target, prop) {
+      const current = fetcher();
+      return Reflect.has(current, prop);
+    },
+    ownKeys(_target) {
+      const current = fetcher();
+      return Reflect.ownKeys(current);
+    },
+    getOwnPropertyDescriptor(_target, prop) {
+      const current = fetcher();
+      return Reflect.getOwnPropertyDescriptor(current, prop);
+    },
+    defineProperty(_target, prop, descriptor) {
+      const current = fetcher();
+      return Reflect.defineProperty(current, prop, descriptor);
+    },
+    deleteProperty(_target, prop) {
+      const current = fetcher();
+      return Reflect.deleteProperty(current, prop);
+    }
+  });
+};
+
+// src/utility/create-inject-from-token-factory.ts
+import { Inject } from "@nestjs/common";
+var createInjectFromTokenFactory = (factory) => (...params) => Inject(factory(...params));
+
+// src/transactional-typeorm.module.ts
+import { Observable } from "rxjs";
+var requestWeakMap = /* @__PURE__ */ new WeakMap();
+var normalizeDataSourceToken = (token) => typeof token === "string" ? token : token.name || token.toString();
+var TransactionalTypeOrmInterceptor = (dataSource) => {
+  const token = (0, import_typeorm9.getEntityManagerToken)(dataSource);
+  const interceptorClass = class SpecificTransactionalTypeOrmInterceptor {
+    constructor(entityManager) {
+      this.entityManager = entityManager;
+    }
+    intercept(context, next) {
+      const request = context.switchToHttp().getRequest();
+      return new Observable((observer) => {
+        let innerSub = null;
+        let finished = false;
+        let abort;
+        const aborted = new Promise((_7, reject) => {
+          abort = reject;
+        });
+        const run = this.entityManager.transaction(async (txEm) => {
+          requestWeakMap.set(request, txEm);
+          const completion = new Promise((resolve, reject) => {
+            innerSub = next.handle().subscribe({
+              next: (v) => observer.next(v),
+              error: (err) => {
+                finished = true;
+                observer.error(err);
+                reject(err);
+              },
+              complete: () => {
+                finished = true;
+                observer.complete();
+                resolve();
+              }
+            });
+          });
+          await Promise.race([completion, aborted]);
+        }).finally(() => {
+          requestWeakMap.delete(request);
+        }).catch((err) => {
+          if (!finished) observer.error(err);
+        });
+        return () => {
+          try {
+            innerSub?.unsubscribe();
+          } finally {
+            if (!finished) {
+              abort(new Error("Request aborted / subscription unsubscribed"));
+            }
+          }
+        };
+      });
+    }
+  };
+  Object.defineProperty(interceptorClass, "name", {
+    value: `TransactionalTypeOrmInterceptor_${normalizeDataSourceToken(token)}`
+  });
+  Reflect.defineMetadata(
+    "design:paramtypes",
+    [EntityManager2],
+    interceptorClass
+  );
+  Inject2(token)(interceptorClass.prototype, void 0, 0);
+  Injectable()(interceptorClass);
+  return interceptorClass;
+};
+var getTransactionalEntityManagerToken = (dataSource) => `Transactional${normalizeDataSourceToken((0, import_typeorm9.getEntityManagerToken)(dataSource))}`;
+var getTransactionalEntityManagerProvider = (dataSource) => createProvider(
+  {
+    provide: getTransactionalEntityManagerToken(dataSource),
+    inject: [(0, import_typeorm9.getEntityManagerToken)(dataSource), REQUEST],
+    scope: Scope.REQUEST
+  },
+  (entityManager, request) => {
+    if (requestWeakMap.has(request)) {
+      return requestWeakMap.get(request);
+    }
+    return createDynamicFetcherProxy(
+      entityManager,
+      () => requestWeakMap.get(request) || entityManager
+    );
+  }
+);
+var InjectTransactionalEntityManager = createInjectFromTokenFactory(
+  getTransactionalEntityManagerToken
+);
+var getTransactionalRepositoryToken = (entity, dataSource) => `Transactional${normalizeDataSourceToken(
+  (0, import_typeorm9.getEntityManagerToken)(dataSource)
+)}Repository_${entity.name || entity.toString()}`;
+var getTransactionalRepositoryProvider = (entity, dataSource) => createProvider(
+  {
+    provide: getTransactionalRepositoryToken(entity, dataSource),
+    inject: [(0, import_typeorm9.getEntityManagerToken)(dataSource), REQUEST],
+    scope: Scope.REQUEST
+  },
+  (entityManager, req) => {
+    if (requestWeakMap.has(req)) {
+      const transactionalEntityManager = requestWeakMap.get(req);
+      return transactionalEntityManager.getRepository(entity);
+    }
+    return createDynamicFetcherProxy(
+      entityManager.getRepository(entity),
+      () => {
+        const transactionalEntityManager = requestWeakMap.get(req) || entityManager;
+        return transactionalEntityManager.getRepository(entity);
+      }
+    );
+  }
+);
+var InjectTransactionalRepository = createInjectFromTokenFactory(
+  getTransactionalRepositoryToken
+);
+var TransactionalTypeOrmModule = class {
+  static forFeature(entities, dataSource) {
+    const entityArray = Array.isArray(entities) ? entities : [entities];
+    const providers = [
+      getTransactionalEntityManagerProvider(dataSource),
+      ...entityArray.map(
+        (entity) => getTransactionalRepositoryProvider(entity, dataSource)
+      )
+    ];
+    const moduleImports = entityArray.length ? [import_typeorm9.TypeOrmModule.forFeature(entityArray, dataSource)] : [];
+    const moduleExports = [...providers, ...moduleImports];
+    return {
+      module: TransactionalTypeOrmModule,
+      imports: moduleImports,
+      providers,
+      exports: moduleExports
+    };
+  }
+};
+TransactionalTypeOrmModule = __decorateClass([
+  Module({})
+], TransactionalTypeOrmModule);
 export {
   BindingColumn,
   BindingValue,
@@ -3127,6 +4142,8 @@ export {
   ImportDataDto,
   ImportEntryBaseDto,
   ImportEntryDto,
+  InjectTransactionalEntityManager,
+  InjectTransactionalRepository,
   Inner,
   IntColumn,
   InternalColumn,
@@ -3136,6 +4153,7 @@ export {
   NotCreatable,
   NotInResult,
   NotQueryable,
+  NotUpsertable,
   NotWritable,
   OmitPipe,
   OptionalDataPipe,
@@ -3174,6 +4192,10 @@ export {
   StringJsonColumn,
   TextColumn,
   TimeBase,
+  TransactionalTypeOrmInterceptor,
+  TransactionalTypeOrmModule,
+  UpsertColumn,
+  UpsertableEntity,
   UuidColumn,
   applyQueryMatchBoolean,
   applyQueryMatchBooleanMySQL,
@@ -3186,6 +4208,10 @@ export {
   createQueryCondition,
   createQueryOperator,
   createQueryOperatorArrayify,
-  createQueryWrap
+  createQueryWrap,
+  getTransactionalEntityManagerProvider,
+  getTransactionalEntityManagerToken,
+  getTransactionalRepositoryProvider,
+  getTransactionalRepositoryToken
 };
 //# sourceMappingURL=index.mjs.map