nicot 1.2.12 → 1.3.0

package/dist/src/bases/base-restful-controller.d.ts

@@ -2,7 +2,7 @@ import { CrudBase } from '../crud-base';
 import { Repository } from 'typeorm';
 import { ClassType } from 'nesties';
 import { RelationDef } from '../utility/relation-def';
-export declare const RestfulMethods: readonly ["findOne", "findAll", "create", "update", "delete", "import"];
+export declare const RestfulMethods: readonly ["findOne", "findAll", "create", "update", "upsert", "delete", "import"];
 export type RestfulMethods = typeof RestfulMethods[number];
 export type RestfulPaginateType = 'offset' | 'cursor' | 'none';
 export declare class BaseRestfulController<T extends {
@@ -23,6 +23,7 @@ export declare class BaseRestfulController<T extends {
     findAll(dto: Partial<T>): Promise<import("nesties").GenericPaginatedReturnMessageDto<T>> | Promise<import("../dto").GenericCursorPaginationReturnMessageDto<T>>;
     create(dto: T): Promise<import("nesties").GenericReturnMessageDto<T>>;
     update(id: number, dto: Partial<T>): Promise<import("nesties").BlankReturnMessageDto>;
+    upsert(dto: T): Promise<import("nesties").GenericReturnMessageDto<T>>;
     delete(id: number): Promise<import("nesties").BlankReturnMessageDto>;
     import(data: {
         data: T[];

package/dist/src/bases/id-base.d.ts

@@ -17,6 +17,9 @@ export declare function IdBase(idOptions?: IdOptions): {
         afterGet(): Promise<void>;
         isValidInUpdate(): string | undefined;
         beforeUpdate(): Promise<void>;
+        isValidInUpsert(): string | undefined;
+        beforeUpsert(): Promise<void>;
+        afterUpsert(): Promise<void>;
         pageCount: number;
         recordsPerPage: number;
         getActualPageSettings(): import("nesties").PageSettingsWise;
@@ -44,6 +47,9 @@ export declare function StringIdBase(idOptions: StringIdOptions): {
         afterGet(): Promise<void>;
         isValidInUpdate(): string | undefined;
         beforeUpdate(): Promise<void>;
+        isValidInUpsert(): string | undefined;
+        beforeUpsert(): Promise<void>;
+        afterUpsert(): Promise<void>;
         pageCount: number;
         recordsPerPage: number;
         getActualPageSettings(): import("nesties").PageSettingsWise;

package/dist/src/bases/time-base.d.ts

@@ -10,6 +10,9 @@ export interface EntityHooks {
     afterGet(): Promise<void>;
     isValidInUpdate(): string | undefined;
     beforeUpdate(): Promise<void>;
+    isValidInUpsert(): string | undefined;
+    beforeUpsert(): Promise<void>;
+    afterUpsert(): Promise<void>;
 }
 export declare class TimeBase extends PageSettingsDto implements DeletionWise, EntityHooks {
     createTime: Date;
@@ -22,4 +25,7 @@ export declare class TimeBase extends PageSettingsDto implements DeletionWise, E
     afterGet(): Promise<void>;
     isValidInUpdate(): string | undefined;
     beforeUpdate(): Promise<void>;
+    isValidInUpsert(): string | undefined;
+    beforeUpsert(): Promise<void>;
+    afterUpsert(): Promise<void>;
 }

package/dist/src/crud-base.d.ts

@@ -1,5 +1,5 @@
 import { CursorPaginationDto } from './dto';
-import { FindOneOptions, FindOptionsWhere, Repository, SelectQueryBuilder } from 'typeorm';
+import { EntityManager, FindOneOptions, FindOptionsWhere, Repository, SelectQueryBuilder } from 'typeorm';
 import { EntityHooks, PageSettingsDto, PageSettingsFactory, QueryWise } from './bases';
 import { ConsoleLogger } from '@nestjs/common';
 import { Awaitable, BlankReturnMessageDto, ClassType, GenericReturnMessageDto } from 'nesties';
@@ -21,6 +21,7 @@ export interface CrudOptions<T extends ValidCrudEntity<T>> {
     createOrUpdate?: boolean;
     keepEntityVersioningDates?: boolean;
     outputFieldsToOmit?: (keyof T)[];
+    upsertIncludeRelations?: boolean;
 }
 export declare class CrudBase<T extends ValidCrudEntity<T>> {
     entityClass: ClassType<T>;
@@ -61,6 +62,7 @@ export declare class CrudBase<T extends ValidCrudEntity<T>> {
     _freezeBindings(): BindingSnapshot;
     _restoreBindings(frozen: BindingSnapshot): this;
     beforeSuper<R>(fn: () => Promise<R>): Promise<R>;
+    _mayBeTransaction<R>(cb: (tdb: EntityManager, repo: Repository<T>) => Awaitable<R>, manager?: EntityManager): Promise<R>;
     _batchCreate(ents: T[], beforeCreate?: (repo: Repository<T>) => Promise<void>, skipErrors?: boolean): Promise<{
         results: T[];
         skipped: {
@@ -68,13 +70,14 @@ export declare class CrudBase<T extends ValidCrudEntity<T>> {
             entry: T;
         }[];
     }>;
-    create(_ent: T, beforeCreate?: (repo: Repository<T>) => Promise<void>): Promise<GenericReturnMessageDto<T>>;
+    create(_ent: Partial<T>, beforeCreate?: (repo: Repository<T>) => Promise<void>): Promise<GenericReturnMessageDto<T>>;
     get entityAliasName(): string;
     _applyQueryRelation(qb: SelectQueryBuilder<T>, relation: RelationDef): void;
     _applyQueryRelations(qb: SelectQueryBuilder<T>): void;
     _applyQueryFilters(qb: SelectQueryBuilder<T>, ent: T): void;
     queryBuilder(): SelectQueryBuilder<T>;
     _applyQueryFromBinding(bindingEnt: Partial<T>, qb: SelectQueryBuilder<T>): void;
+    _applyQueryKeepEntityVersioningDates(qb: SelectQueryBuilder<T>): void;
     findOne(id: EntityId<T>, extraQuery?: (qb: SelectQueryBuilder<T>) => void): Promise<GenericReturnMessageDto<T>>;
     _preFindAll(ent?: Partial<T>, extraQuery?: (qb: SelectQueryBuilder<T>) => void): Promise<{
         query: SelectQueryBuilder<T>;
@@ -84,8 +87,9 @@ export declare class CrudBase<T extends ValidCrudEntity<T>> {
     findAll(ent?: Partial<T>, extraQuery?: (qb: SelectQueryBuilder<T>) => void): Promise<import("nesties").GenericPaginatedReturnMessageDto<T>>;
     findAllCursorPaginated(ent?: Partial<T & Partial<CursorPaginationDto>>, extraQuery?: (qb: SelectQueryBuilder<T>) => void): Promise<import("./dto").GenericCursorPaginationReturnMessageDto<T>>;
     update(id: EntityId<T>, entPart: Partial<T>, cond?: FindOptionsWhere<T>): Promise<BlankReturnMessageDto>;
+    upsert(_ent: Partial<T>): Promise<GenericReturnMessageDto<T>>;
     delete(id: EntityId<T>, cond?: FindOptionsWhere<T>): Promise<BlankReturnMessageDto>;
-    importEntities(_ents: T[], extraChecking?: (ent: T) => string | Promise<string>): Promise<GenericReturnMessageDto<{
+    importEntities(_ents: Partial<T>[], extraChecking?: (ent: T) => string | Promise<string>): Promise<GenericReturnMessageDto<{
         result: string;
         entry: T;
     }[]>>;
@@ -139,6 +143,7 @@ export declare function CrudService<T extends ValidCrudEntity<T>>(entityClass: C
         _freezeBindings(): BindingSnapshot;
         _restoreBindings(frozen: BindingSnapshot): /*elided*/ any;
         beforeSuper<R>(fn: () => Promise<R>): Promise<R>;
+        _mayBeTransaction<R>(cb: (tdb: EntityManager, repo: Repository<T>) => Awaitable<R>, manager?: EntityManager): Promise<R>;
         _batchCreate(ents: T[], beforeCreate?: (repo: Repository<T>) => Promise<void>, skipErrors?: boolean): Promise<{
             results: T[];
             skipped: {
@@ -146,13 +151,14 @@ export declare function CrudService<T extends ValidCrudEntity<T>>(entityClass: C
                 entry: T;
             }[];
         }>;
-        create(_ent: T, beforeCreate?: (repo: Repository<T>) => Promise<void>): Promise<GenericReturnMessageDto<T>>;
+        create(_ent: Partial<T>, beforeCreate?: (repo: Repository<T>) => Promise<void>): Promise<GenericReturnMessageDto<T>>;
         readonly entityAliasName: string;
         _applyQueryRelation(qb: SelectQueryBuilder<T>, relation: RelationDef): void;
         _applyQueryRelations(qb: SelectQueryBuilder<T>): void;
         _applyQueryFilters(qb: SelectQueryBuilder<T>, ent: T): void;
         queryBuilder(): SelectQueryBuilder<T>;
         _applyQueryFromBinding(bindingEnt: Partial<T>, qb: SelectQueryBuilder<T>): void;
+        _applyQueryKeepEntityVersioningDates(qb: SelectQueryBuilder<T>): void;
         findOne(id: EntityId<T>, extraQuery?: (qb: SelectQueryBuilder<T>) => void): Promise<GenericReturnMessageDto<T>>;
         _preFindAll(ent?: Partial<T>, extraQuery?: (qb: SelectQueryBuilder<T>) => void): Promise<{
             query: SelectQueryBuilder<T>;
@@ -162,8 +168,9 @@ export declare function CrudService<T extends ValidCrudEntity<T>>(entityClass: C
         findAll(ent?: Partial<T>, extraQuery?: (qb: SelectQueryBuilder<T>) => void): Promise<import("nesties").GenericPaginatedReturnMessageDto<T>>;
         findAllCursorPaginated(ent?: Partial<T & Partial<CursorPaginationDto>>, extraQuery?: (qb: SelectQueryBuilder<T>) => void): Promise<import("./dto").GenericCursorPaginationReturnMessageDto<T>>;
         update(id: EntityId<T>, entPart: Partial<T>, cond?: FindOptionsWhere<T>): Promise<BlankReturnMessageDto>;
+        upsert(_ent: Partial<T>): Promise<GenericReturnMessageDto<T>>;
         delete(id: EntityId<T>, cond?: FindOptionsWhere<T>): Promise<BlankReturnMessageDto>;
-        importEntities(_ents: T[], extraChecking?: (ent: T) => string | Promise<string>): Promise<GenericReturnMessageDto<{
+        importEntities(_ents: Partial<T>[], extraChecking?: (ent: T) => string | Promise<string>): Promise<GenericReturnMessageDto<{
             result: string;
             entry: T;
         }[]>>;

package/dist/src/decorators/access.d.ts

@@ -1,7 +1,6 @@
 export declare const NotWritable: () => PropertyDecorator;
 export declare const NotCreatable: () => PropertyDecorator;
 export declare const NotChangeable: () => PropertyDecorator;
+export declare const NotUpsertable: () => PropertyDecorator;
 export declare const NotQueryable: () => import("typed-reflector").AllDecorators;
-export declare const NotInResult: (options?: {
-    entityVersioningDate?: boolean;
-}) => import("typed-reflector").AllDecorators;
+export declare const NotInResult: () => import("typed-reflector").AllDecorators;

package/dist/src/decorators/index.d.ts

@@ -4,3 +4,4 @@ export * from './pipes';
 export * from './query';
 export * from './get-mutator';
 export * from './binding';
+export * from './upsert';

package/dist/src/decorators/property.d.ts

@@ -54,6 +54,7 @@ export declare const StringJsonColumn: <C extends ClassOrArray>(definition: C, o
 }) => PropertyDecorator;
 export declare const NotColumn: (options?: OpenAPIOptions<any>, specials?: {
     keepInCreate?: boolean;
+    hideInUpsert?: boolean;
 }) => PropertyDecorator;
 export declare const QueryColumn: (options?: OpenAPIOptions<any>) => PropertyDecorator;
 export declare const InternalColumn: () => PropertyDecorator;

package/dist/src/decorators/upsert.d.ts

@@ -0,0 +1,5 @@
+import { ClassType } from 'nesties';
+export declare const UpsertColumn: () => PropertyDecorator;
+export declare const UpsertableEntity: () => (cls: ClassType<{
+    id: string | number;
+}>) => void;

package/dist/src/restful.d.ts

@@ -6,11 +6,12 @@ import { CursorPaginationDto } from './dto';
 import { BaseRestfulController, RestfulMethods, RestfulPaginateType } from './bases/base-restful-controller';
 import { Repository } from 'typeorm';
 import { RelationDef } from './utility/relation-def';
-export interface RestfulFactoryOptions<T, O extends keyof T = never, W extends keyof T = never, C extends keyof T = never, U extends keyof T = never, F extends keyof T = never, R extends keyof T = never> {
+export interface RestfulFactoryOptions<T, O extends keyof T = never, W extends keyof T = never, C extends keyof T = never, U extends keyof T = never, US extends keyof T = never, F extends keyof T = never, R extends keyof T = never> {
     fieldsToOmit?: O[];
     writeFieldsToOmit?: W[];
     createFieldsToOmit?: C[];
     updateFieldsToOmit?: U[];
+    upsertFieldsToOmit?: US[];
     findAllFieldsToOmit?: F[];
     outputFieldsToOmit?: R[];
     prefix?: string;
@@ -18,34 +19,38 @@ export interface RestfulFactoryOptions<T, O extends keyof T = never, W extends k
     entityClassName?: string;
     relations?: (string | RelationDef)[];
     skipNonQueryableFields?: boolean;
+    upsertIncludeRelations?: boolean;
 }
 export interface ResourceOptions extends Partial<OperationObject> {
     prefix?: string;
 }
 export declare class RestfulFactory<T extends {
     id: any;
-}, O extends keyof T = never, W extends keyof T = never, C extends keyof T = never, U extends keyof T = never, F extends keyof T = never, R extends keyof T = never> {
+}, O extends keyof T = never, W extends keyof T = never, C extends keyof T = never, U extends keyof T = never, US extends keyof T = never, F extends keyof T = never, R extends keyof T = never> {
     readonly entityClass: ClassType<T>;
     private options;
     private __resolveVisited;
-    constructor(entityClass: ClassType<T>, options?: RestfulFactoryOptions<T, O, W, C, U, F, R>, __resolveVisited?: Map<AnyClass, [AnyClass]>);
-    omitInput<K extends keyof T>(...fields: K[]): RestfulFactory<T, O | K, W, C, U, F, R>;
-    omitWrite<K extends keyof T>(...fields: K[]): RestfulFactory<T, O, W | K, C, U, F, R>;
-    omitCreate<K extends keyof T>(...fields: K[]): RestfulFactory<T, O, W, C | K, U, F, R>;
-    omitUpdate<K extends keyof T>(...fields: K[]): RestfulFactory<T, O, W, C, U | K, F, R>;
-    omitFindAll<K extends keyof T>(...fields: K[]): RestfulFactory<T, O, W, C, U, F | K, R>;
-    omitOutput<K extends keyof T>(...fields: K[]): RestfulFactory<T, O, W, C, U, F, R | K>;
-    pathPrefix(prefix: string): RestfulFactory<T, O, W, C, U, F, R>;
-    keepEntityVersioningDates(enable?: boolean): RestfulFactory<T, O, W, C, U, F, R>;
-    skipNonQueryableFields(enable?: boolean): RestfulFactory<T, O, W, C, U, F, R>;
-    renameEntityClass(name: string): RestfulFactory<T, O, W, C, U, F, R>;
-    useRelations(...relations: (string | RelationDef)[]): RestfulFactory<T, O, W, C, U, F, R>;
+    constructor(entityClass: ClassType<T>, options?: RestfulFactoryOptions<T, O, W, C, U, US, F, R>, __resolveVisited?: Map<AnyClass, [AnyClass]>);
+    omitInput<K extends keyof T>(...fields: K[]): RestfulFactory<T, O | K, W, C, U, US, F, R>;
+    omitWrite<K extends keyof T>(...fields: K[]): RestfulFactory<T, O, W | K, C, U, US, F, R>;
+    omitCreate<K extends keyof T>(...fields: K[]): RestfulFactory<T, O, W, C | K, U, US, F, R>;
+    omitUpdate<K extends keyof T>(...fields: K[]): RestfulFactory<T, O, W, C, U | K, US, F, R>;
+    omitUpsert<K extends keyof T>(...fields: K[]): RestfulFactory<T, O, W, C, U, US | K, F, R>;
+    omitFindAll<K extends keyof T>(...fields: K[]): RestfulFactory<T, O, W, C, U, US, F | K, R>;
+    omitOutput<K extends keyof T>(...fields: K[]): RestfulFactory<T, O, W, C, U, US, F, R | K>;
+    pathPrefix(prefix: string): RestfulFactory<T, O, W, C, U, US, F, R>;
+    keepEntityVersioningDates(enable?: boolean): RestfulFactory<T, O, W, C, U, US, F, R>;
+    skipNonQueryableFields(enable?: boolean): RestfulFactory<T, O, W, C, U, US, F, R>;
+    renameEntityClass(name: string): RestfulFactory<T, O, W, C, U, US, F, R>;
+    useRelations(...relations: (string | RelationDef)[]): RestfulFactory<T, O, W, C, U, US, F, R>;
     get entityClassName(): string;
     get fieldsToOmit(): (keyof T)[];
     get fieldsInCreateToOmit(): (keyof T)[];
     get createDto(): ClassType<Omit<T, O | W | C>>;
     get fieldsInUpdateToOmit(): (keyof T)[];
     get updateDto(): ClassType<Omit<T, O | W | U>>;
+    get fieldsInUpsertToOmit(): (keyof T)[];
+    get upsertDto(): ClassType<Omit<T, O | W | US>>;
     get importDto(): new () => {
         data: Omit<T, O | W | C>[];
     };
@@ -55,6 +60,7 @@ export declare class RestfulFactory<T extends {
     get findAllCursorPaginatedDto(): ClassType<T>;
     get entityResultDto(): ClassType<Omit<T, R>>;
     get entityCreateResultDto(): ClassType<Omit<T, R>>;
+    get entityUpsertResultDto(): ClassType<Omit<T, R>>;
     get entityReturnMessageDto(): new (statusCode: number, message: string, data: Omit<T, R>) => import("nesties").GenericReturnMessageDto<Omit<T, R>>;
     get entityCreateReturnMessageDto(): new (statusCode: number, message: string, data: Omit<T, R>) => import("nesties").GenericReturnMessageDto<Omit<T, R>>;
     get entityArrayReturnMessageDto(): new (statusCode: number, message: string, data: Omit<T, R>[], total: number, pageSettings: import("nesties").PageSettingsWise) => import("nesties").GenericPaginatedReturnMessageDto<Omit<T, R>>;
@@ -70,6 +76,9 @@ export declare class RestfulFactory<T extends {
     private usePrefix;
     create(extras?: ResourceOptions): MethodDecorator;
     createParam(): ParameterDecorator;
+    isUpsertable(): boolean;
+    upsert(extras?: ResourceOptions): MethodDecorator;
+    upsertParam(): ParameterDecorator;
     findOne(extras?: ResourceOptions): MethodDecorator;
     idParam(): ParameterDecorator;
     findAll(extras?: ResourceOptions): MethodDecorator;
@@ -92,11 +101,11 @@ export declare class RestfulFactory<T extends {
         }>>>;
     }> = {}>(routeOptions?: Options): new (service: CrudBase<T> | Repository<T>) => ([{ [M in keyof NonNullable<Options["routes"]>]: NonNullable<Options["routes"]>[M] extends {
         enabled: true;
-    } ? M : never; }[keyof NonNullable<Options["routes"]>] & ("update" | "create" | "delete" | "findOne" | "findAll" | "import")] extends [never] ? Omit<BaseRestfulController<T>, { [M_1 in keyof NonNullable<Options["routes"]>]: NonNullable<Options["routes"]>[M_1] extends {
+    } ? M : never; }[keyof NonNullable<Options["routes"]>] & ("update" | "create" | "delete" | "upsert" | "findOne" | "findAll" | "import")] extends [never] ? Omit<BaseRestfulController<T>, { [M_1 in keyof NonNullable<Options["routes"]>]: NonNullable<Options["routes"]>[M_1] extends {
         enabled: false;
-    } ? M_1 : never; }[keyof NonNullable<Options["routes"]>] & ("update" | "create" | "delete" | "findOne" | "findAll" | "import")> : Pick<BaseRestfulController<T>, { [M in keyof NonNullable<Options["routes"]>]: NonNullable<Options["routes"]>[M] extends {
+    } ? M_1 : never; }[keyof NonNullable<Options["routes"]>] & ("update" | "create" | "delete" | "upsert" | "findOne" | "findAll" | "import")> : Pick<BaseRestfulController<T>, { [M in keyof NonNullable<Options["routes"]>]: NonNullable<Options["routes"]>[M] extends {
         enabled: true;
-    } ? M : never; }[keyof NonNullable<Options["routes"]>] & ("update" | "create" | "delete" | "findOne" | "findAll" | "import")>) & {
+    } ? M : never; }[keyof NonNullable<Options["routes"]>] & ("update" | "create" | "delete" | "upsert" | "findOne" | "findAll" | "import")>) & {
         _service: CrudBase<T>;
     };
     crudService(options?: CrudOptions<T>): {
@@ -142,6 +151,7 @@ export declare class RestfulFactory<T extends {
                 [x: string]: any;
             }): /*elided*/ any;
             beforeSuper<R_1>(fn: () => Promise<R_1>): Promise<R_1>;
+            _mayBeTransaction<R_1>(cb: (tdb: import("typeorm").EntityManager, repo: Repository<T>) => import("nesties").Awaitable<R_1>, manager?: import("typeorm").EntityManager): Promise<R_1>;
             _batchCreate(ents: T[], beforeCreate?: (repo: Repository<T>) => Promise<void>, skipErrors?: boolean): Promise<{
                 results: T[];
                 skipped: {
@@ -149,13 +159,14 @@ export declare class RestfulFactory<T extends {
                     entry: T;
                 }[];
             }>;
-            create(_ent: T, beforeCreate?: (repo: Repository<T>) => Promise<void>): Promise<import("nesties").GenericReturnMessageDto<T>>;
+            create(_ent: Partial<T>, beforeCreate?: (repo: Repository<T>) => Promise<void>): Promise<import("nesties").GenericReturnMessageDto<T>>;
             readonly entityAliasName: string;
             _applyQueryRelation(qb: import("typeorm").SelectQueryBuilder<T>, relation: RelationDef): void;
             _applyQueryRelations(qb: import("typeorm").SelectQueryBuilder<T>): void;
             _applyQueryFilters(qb: import("typeorm").SelectQueryBuilder<T>, ent: T): void;
             queryBuilder(): import("typeorm").SelectQueryBuilder<T>;
             _applyQueryFromBinding(bindingEnt: Partial<T>, qb: import("typeorm").SelectQueryBuilder<T>): void;
+            _applyQueryKeepEntityVersioningDates(qb: import("typeorm").SelectQueryBuilder<T>): void;
             findOne(id: import("./crud-base").EntityId<T>, extraQuery?: (qb: import("typeorm").SelectQueryBuilder<T>) => void): Promise<import("nesties").GenericReturnMessageDto<T>>;
             _preFindAll(ent?: Partial<T>, extraQuery?: (qb: import("typeorm").SelectQueryBuilder<T>) => void): Promise<{
                 query: import("typeorm").SelectQueryBuilder<T>;
@@ -165,8 +176,9 @@ export declare class RestfulFactory<T extends {
             findAll(ent?: Partial<T>, extraQuery?: (qb: import("typeorm").SelectQueryBuilder<T>) => void): Promise<import("nesties").GenericPaginatedReturnMessageDto<T>>;
             findAllCursorPaginated(ent?: Partial<T & Partial<CursorPaginationDto>>, extraQuery?: (qb: import("typeorm").SelectQueryBuilder<T>) => void): Promise<import("./dto").GenericCursorPaginationReturnMessageDto<T>>;
             update(id: import("./crud-base").EntityId<T>, entPart: Partial<T>, cond?: import("typeorm").FindOptionsWhere<T>): Promise<import("nesties").BlankReturnMessageDto>;
+            upsert(_ent: Partial<T>): Promise<import("nesties").GenericReturnMessageDto<T>>;
             delete(id: import("./crud-base").EntityId<T>, cond?: import("typeorm").FindOptionsWhere<T>): Promise<import("nesties").BlankReturnMessageDto>;
-            importEntities(_ents: T[], extraChecking?: (ent: T) => string | Promise<string>): Promise<import("nesties").GenericReturnMessageDto<{
+            importEntities(_ents: Partial<T>[], extraChecking?: (ent: T) => string | Promise<string>): Promise<import("nesties").GenericReturnMessageDto<{
                 result: string;
                 entry: T;
             }[]>>;

package/dist/src/transactional-typeorm.module.d.ts

@@ -0,0 +1,20 @@
+import { DataSource, DataSourceOptions, EntityManager } from 'typeorm';
+import { DynamicModule } from '@nestjs/common';
+import { CallHandler } from '@nestjs/common/interfaces/features/nest-interceptor.interface';
+import { ExecutionContext } from '@nestjs/common/interfaces/features/execution-context.interface';
+import { Observable } from 'rxjs';
+export declare const TransactionalTypeOrmInterceptor: (dataSource?: DataSource | DataSourceOptions | string) => {
+    new (entityManager: EntityManager): {
+        entityManager: EntityManager;
+        intercept(context: ExecutionContext, next: CallHandler): Observable<any>;
+    };
+};
+export declare const getTransactionalEntityManagerToken: (dataSource?: DataSource | DataSourceOptions | string) => string;
+export declare const getTransactionalEntityManagerProvider: (dataSource?: DataSource | DataSourceOptions | string) => import("nesties").TypedFactoryProvider<[string | Function, "REQUEST"], EntityManager>;
+export declare const InjectTransactionalEntityManager: (dataSource?: string | DataSource | DataSourceOptions) => PropertyDecorator & ParameterDecorator;
+export declare const getTransactionalRepositoryToken: (entity: Function, dataSource?: DataSource | DataSourceOptions | string) => string;
+export declare const getTransactionalRepositoryProvider: (entity: Function, dataSource?: DataSource | DataSourceOptions | string) => import("nesties").TypedFactoryProvider<[string | Function, "REQUEST"], import("typeorm").Repository<import("typeorm").ObjectLiteral>>;
+export declare const InjectTransactionalRepository: (entity: Function, dataSource?: string | DataSource | DataSourceOptions) => PropertyDecorator & ParameterDecorator;
+export declare class TransactionalTypeOrmModule {
+    static forFeature(entities: Function | Function[], dataSource?: DataSource | DataSourceOptions | string): DynamicModule;
+}

package/dist/src/utility/create-dynamic-fetcher-proxy.d.ts

@@ -0,0 +1 @@
+export declare const createDynamicFetcherProxy: <T extends object>(initial: T, fetcher: () => T) => T;

package/dist/src/utility/create-inject-from-token-factory.d.ts

@@ -0,0 +1,4 @@
+import { Inject } from '@nestjs/common';
+type InjectToken = Parameters<typeof Inject>[0];
+export declare const createInjectFromTokenFactory: <P extends any[]>(factory: (...params: P) => InjectToken) => (...params: P) => PropertyDecorator & ParameterDecorator;
+export {};

package/dist/src/utility/metadata.d.ts

@@ -7,14 +7,15 @@ import { BindingValueMetadata } from '../decorators/binding';
 interface SpecificFields {
     notColumn: {
         keepInCreate?: boolean;
+        hideInUpsert?: boolean;
     };
     notWritable: boolean;
     notCreatable: boolean;
     notChangeable: boolean;
+    notUpsertable: boolean;
     notQueryable: boolean;
-    notInResult: {
-        entityVersioningDate?: boolean;
-    };
+    notInResult: boolean;
+    entityVersioningDate: boolean;
     relationComputed: () => {
         entityClass: AnyClass;
         isArray: boolean;
@@ -26,13 +27,16 @@ interface SpecificFields {
     getMutator: GetMutatorOptions;
     bindingColumn: string;
     bindingValue: BindingValueMetadata;
+    upsertColumn: boolean;
+}
+interface MetadataMap extends SpecificFields {
+    upsertableEntity: boolean;
 }
-type MetadataMap = SpecificFields;
 type FieldsMap = {
     [K in keyof MetadataMap as `${K}Fields`]: string;
 };
-export declare const Metadata: MetadataSetter<SpecificFields, FieldsMap>;
-export declare const reflector: Reflector<SpecificFields, FieldsMap>;
+export declare const Metadata: MetadataSetter<MetadataMap, FieldsMap>;
+export declare const reflector: Reflector<MetadataMap, FieldsMap>;
 export declare function getSpecificFields<K extends keyof SpecificFields>(obj: any, type: K, filter?: (meta: SpecificFields[K], obj: any) => boolean): FieldsMap[`${K}Fields`][];
 export declare function getNotInResultFields(obj: any, keepEntityVersioningDates?: boolean): string[];
 export {};

package/index.ts

@@ -5,3 +5,4 @@ export * from './src/bases';
 export * from './src/decorators';
 export * from './src/dto';
 export * from './src/utility';
+export * from './src/transactional-typeorm.module';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "nicot",
   "description": "Nest.js interacting with class-validator + OpenAPI + TypeORM for Nest.js Restful API development.",
-  "version": "1.2.12",
+  "version": "1.3.0",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
@@ -81,6 +81,7 @@
     "jest": "^29.7.0",
     "pg": "^8.7.3",
     "prettier": "^2.7.1",
+    "rxjs": "^7.8.2",
     "supertest": "^6.2.4",
     "ts-jest": "^29.3.2",
     "typescript": "^5.8.3"
@@ -88,14 +89,16 @@
   "peerDependencies": {
     "@nestjs/common": "^11.0.0 || ^9.4.0 || ^10.0.0",
     "@nestjs/config": "^4.0.0 || ^3.0.0",
+    "@nestjs/core": "^11.0.0 || ^9.4.0 || ^10.0.0",
     "@nestjs/swagger": "^11.0.0 || ^7.1.8 || ^6.3.0",
     "class-transformer": "^0.5.1",
     "class-validator": "^0.14.0",
+    "rxjs": ">=7.0.0",
     "typeorm": "^0.3.27"
   },
   "dependencies": {
     "lodash": "^4.17.21",
-    "nesties": "^1.1.16",
+    "nesties": "^1.1.23",
     "nfkit": "^1.0.13",
     "p-queue": "6.6.2",
     "superjson": "1.13.3",