@punks/backend-entity-manager 0.0.14 → 0.0.16

package/dist/esm/types/abstractions/events.d.ts

@@ -3,3 +3,6 @@ export interface IEntityEventsManager<TEntity, TEntityId> {
     processEntityUpdatedEvent(entity: TEntity): Promise<void>;
     processEntityDeletedEvent(id: TEntityId): Promise<void>;
 }
+export interface IEventEmitter {
+    emit(event: string, ...args: any[]): Promise<void>;
+}

package/dist/esm/types/platforms/nest/ioc/registry/index.d.ts

@@ -3,9 +3,13 @@ import { EntityAuthMiddlewareProps, EntityConverterProps, EntityQueryBuilderProp
 import { EntityServiceLocator } from "../../../../providers/services";
 import { DiscoveredClassWithMeta } from "../discovery";
 import { EntityAdapterProps } from "../../decorators/adapter";
+import { IEventEmitter } from "../../../../abstractions/events";
 export declare class EntityManagerRegistry {
     private readonly container;
     getContainer(): import("../../../../abstractions").IEntityManagerServiceRoot;
+    resisterGlobalServices({ eventEmitter, }: {
+        eventEmitter?: IEventEmitter;
+    }): Promise<void>;
     registerDiscoveredEntity(app: INestApplicationContext, { adapter, entityName, converter, queryBuilder, repository, authMiddleware, }: {
         entityName: string;
         repository: DiscoveredClassWithMeta<EntityRepositoryProps>;

package/dist/esm/types/platforms/nest/processors/index.d.ts

@@ -1,2 +1 @@
-import { EntityManagerInitializer } from "./initializer";
-export declare const Processors: (typeof EntityManagerInitializer)[];
+export { EntityManagerInitializer } from "./initializer";

package/dist/esm/types/platforms/nest/processors/initializer/index.d.ts

@@ -1,11 +1,13 @@
 import { INestApplicationContext } from "@nestjs/common";
 import { EntityManagerRegistry } from "../../ioc/registry";
 import { CustomDiscoveryService } from "../../ioc/discovery";
+import { NestEventEmitter } from "../../providers/events";
 export declare class EntityManagerInitializer {
     private readonly discover;
     private readonly registry;
+    private readonly eventEmitter;
     private readonly logger;
-    constructor(discover: CustomDiscoveryService, registry: EntityManagerRegistry);
+    constructor(discover: CustomDiscoveryService, registry: EntityManagerRegistry, eventEmitter: NestEventEmitter);
     initialize(app: INestApplicationContext): Promise<void>;
     private discoverEntities;
     private discoverRepositories;

package/dist/esm/types/platforms/nest/processors/providers.d.ts

@@ -0,0 +1,2 @@
+import { EntityManagerInitializer } from "./initializer";
+export declare const Processors: (typeof EntityManagerInitializer)[];

package/dist/esm/types/platforms/nest/providers/events/index.d.ts

@@ -0,0 +1,7 @@
+import { EventEmitter2 } from "@nestjs/event-emitter";
+import { IEventEmitter } from "../../../../abstractions/events";
+export declare class NestEventEmitter implements IEventEmitter {
+    private readonly eventEmitter;
+    constructor(eventEmitter: EventEmitter2);
+    emit(event: string, ...args: any[]): Promise<void>;
+}

package/dist/esm/types/platforms/nest/providers/index.d.ts

@@ -0,0 +1,2 @@
+import { NestEventEmitter } from "./events";
+export declare const Providers: (typeof NestEventEmitter)[];

package/dist/esm/types/providers/services.d.ts

@@ -5,7 +5,7 @@ import { IEntityCreateCommand, IEntityDeleteCommand, IEntityUpdateCommand, IEnti
 import { SortingType } from "../abstractions/common";
 import { IConnectorsConfiguration, IEntityConnectorDeleteManager, IEntityConnectorSyncManager } from "../abstractions/connectors";
 import { IEntityConverter } from "../abstractions/converters";
-import { IEntityEventsManager } from "../abstractions/events";
+import { IEntityEventsManager, IEventEmitter } from "../abstractions/events";
 import { IEntityManager } from "../abstractions/manager";
 import { IEntitiesQueryBuilder, IEntitiesSearchQuery, IEntityGetQuery } from "../abstractions/queries";
 import { IEntityReplicaDeleteManager, IEntityReplicaSyncManager, IReplicasConfiguration } from "../abstractions/replication";
@@ -16,6 +16,7 @@ export declare class EntityServiceLocator<TEntity, TEntityId> {
     private readonly services;
     private readonly entityName;
     constructor(services: EntitiesServiceLocator, entityName: string);
+    getRootServices(): EntitiesServiceLocator;
     resolveEntityManager(): IEntityManager<TEntity, unknown, unknown, unknown, any, any, unknown, unknown>;
     resolveEntityActions(): IEntityActions<TEntity, TEntityId, unknown, unknown, unknown, unknown, any, any, unknown, unknown>;
     resolveRepository<TGetConditions, TFindCondition, TUpdateCondition, TDeleteCondition>(): IEntityRepository<TEntity, TEntityId, TGetConditions, TFindCondition, TUpdateCondition, TDeleteCondition>;
@@ -48,6 +49,8 @@ export declare class EntitiesServiceLocator {
     private readonly provider;
     constructor(provider: ServiceLocator);
     getProvider(): ServiceLocator;
+    resolveEventEmitter<TEventEmitter extends IEventEmitter>(): TEventEmitter;
+    registerEventEmitter<TEventEmitter extends IEventEmitter>(instance: TEventEmitter): void;
     resolveEntityManager<TEntity>(entityName: string): IEntityManager<TEntity, unknown, unknown, unknown, any, any, unknown, unknown>;
     registerEntityManager<TEntity>(entityName: string, instance: IEntityManager<TEntity, unknown, unknown, unknown, any, any, unknown, unknown>): void;
     resolveEntityActions<TEntity>(entityName: string): IEntityActions<TEntity, unknown, unknown, unknown, unknown, unknown, any, any, unknown, unknown>;

package/dist/esm/types/services/events.d.ts

@@ -1,9 +1,11 @@
 import { IEntityEventsManager } from "../abstractions/events";
 import { EntityServiceLocator } from "../providers/services";
 export declare class EntityEventsManager<TEntity, TEntityId> implements IEntityEventsManager<TEntity, TEntityId> {
+    private readonly entityName;
     private readonly services;
-    constructor(services: EntityServiceLocator<TEntity, TEntityId>);
+    constructor(entityName: string, services: EntityServiceLocator<TEntity, TEntityId>);
     processEntityCreatedEvent(entity: TEntity): Promise<void>;
     processEntityUpdatedEvent(entity: TEntity): Promise<void>;
     processEntityDeletedEvent(id: TEntityId): Promise<void>;
+    private emitEntityEvent;
 }

package/dist/esm/types/services/types.d.ts

@@ -0,0 +1,9 @@
+export type EntityCreatedPayload<TEntity> = {
+    entity: TEntity;
+};
+export type EntityUpdatedPayload<TEntity> = {
+    entity: TEntity;
+};
+export type EntityDeletedPayload<TEntityId> = {
+    id: TEntityId;
+};

package/dist/esm/types/symbols/ioc.d.ts

@@ -1,4 +1,4 @@
-export declare const Services: {
+export declare const EntityServices: {
     Actions: {
         IEntityGetAction: string;
         IEntitiesSearchAction: string;
@@ -48,3 +48,8 @@ export declare const Services: {
         IEntityRepository: string;
     };
 };
+export declare const GlobalServices: {
+    Events: {
+        IEventEmitter: string;
+    };
+};

package/dist/index.d.ts

@@ -3,6 +3,7 @@ import { Module } from '@nestjs/core/injector/module';
 import { ModulesContainer } from '@nestjs/core/injector/modules-container';
 import { MetadataScanner } from '@nestjs/core/metadata-scanner';
 import { ObjectLiteral, FindOneOptions, FindManyOptions, Repository, ObjectId, FindOptionsWhere, FindOptionsRelations } from 'typeorm';
+import { EventEmitter2 } from '@nestjs/event-emitter';
 
 type EnumType = string | number | symbol;
 type SortingType = EnumType;
@@ -202,6 +203,9 @@ interface IEntityEventsManager<TEntity, TEntityId> {
     processEntityUpdatedEvent(entity: TEntity): Promise<void>;
     processEntityDeletedEvent(id: TEntityId): Promise<void>;
 }
+interface IEventEmitter {
+    emit(event: string, ...args: any[]): Promise<void>;
+}
 
 interface IEntitiesSearchQuery<TEntity, TEntitySearchParameters extends IEntitySearchParameters<TSorting, TCursor>, TSorting extends SortingType, TCursor, TFacets> {
     execute(request: TEntitySearchParameters): Promise<EntitiesSearchResults<TEntitySearchParameters, TEntity, TSorting, TCursor, TFacets>>;
@@ -268,6 +272,7 @@ declare class EntityServiceLocator<TEntity, TEntityId> {
     private readonly services;
     private readonly entityName;
     constructor(services: EntitiesServiceLocator, entityName: string);
+    getRootServices(): EntitiesServiceLocator;
     resolveEntityManager(): IEntityManager<TEntity, unknown, unknown, unknown, any, any, unknown, unknown>;
     resolveEntityActions(): IEntityActions<TEntity, TEntityId, unknown, unknown, unknown, unknown, any, any, unknown, unknown>;
     resolveRepository<TGetConditions, TFindCondition, TUpdateCondition, TDeleteCondition>(): IEntityRepository<TEntity, TEntityId, TGetConditions, TFindCondition, TUpdateCondition, TDeleteCondition>;
@@ -300,6 +305,8 @@ declare class EntitiesServiceLocator {
     private readonly provider;
     constructor(provider: ServiceLocator);
     getProvider(): ServiceLocator;
+    resolveEventEmitter<TEventEmitter extends IEventEmitter>(): TEventEmitter;
+    registerEventEmitter<TEventEmitter extends IEventEmitter>(instance: TEventEmitter): void;
     resolveEntityManager<TEntity>(entityName: string): IEntityManager<TEntity, unknown, unknown, unknown, any, any, unknown, unknown>;
     registerEntityManager<TEntity>(entityName: string, instance: IEntityManager<TEntity, unknown, unknown, unknown, any, any, unknown, unknown>): void;
     resolveEntityActions<TEntity>(entityName: string): IEntityActions<TEntity, unknown, unknown, unknown, unknown, unknown, any, any, unknown, unknown>;
@@ -570,6 +577,9 @@ interface EntityAdapterProps {
 declare class EntityManagerRegistry {
     private readonly container;
     getContainer(): IEntityManagerServiceRoot;
+    resisterGlobalServices({ eventEmitter, }: {
+        eventEmitter?: IEventEmitter;
+    }): Promise<void>;
     registerDiscoveredEntity(app: INestApplicationContext, { adapter, entityName, converter, queryBuilder, repository, authMiddleware, }: {
         entityName: string;
         repository: DiscoveredClassWithMeta<EntityRepositoryProps>;
@@ -650,11 +660,18 @@ declare class NestTypeOrmRepository<TEntity extends ObjectLiteral, TEntityId> ex
     constructor(repository: Repository<TEntity>);
 }
 
+declare class NestEventEmitter implements IEventEmitter {
+    private readonly eventEmitter;
+    constructor(eventEmitter: EventEmitter2);
+    emit(event: string, ...args: any[]): Promise<void>;
+}
+
 declare class EntityManagerInitializer {
     private readonly discover;
     private readonly registry;
+    private readonly eventEmitter;
     private readonly logger;
-    constructor(discover: CustomDiscoveryService, registry: EntityManagerRegistry);
+    constructor(discover: CustomDiscoveryService, registry: EntityManagerRegistry, eventEmitter: NestEventEmitter);
     initialize(app: INestApplicationContext): Promise<void>;
     private discoverEntities;
     private discoverRepositories;
@@ -664,9 +681,7 @@ declare class EntityManagerInitializer {
     private discoverAuthMiddlewares;
 }
 
-declare const Processors: (typeof EntityManagerInitializer)[];
-
 declare class EntityManagerModule {
 }
 
-export { EntityActionsProps, EntityAuthMiddlewareProps, EntityConnectorProps, EntityConverterProps, EntityManagerException, EntityManagerModule, EntityManagerProps, EntityManagerRegistry, EntityManagerSymbols, EntityNotFoundException, EntityOperationType, EntityOperationUnauthorizedException, EntityProps, EntityQueryBuilderProps, EntityRepositoryProps, FilterExpression, IAuthorizationResult, IEntitiesQueryBuilder, IEntitiesSearchAction, IEntitiesSearchQuery, IEntityActions, IEntityAdapter, IEntityAuthorizationMiddleware, IEntityConverter, IEntityCreateAction, IEntityCreateCommand, IEntityDeleteAction, IEntityDeleteCommand, IEntityEventsManager, IEntityGetAction, IEntityGetQuery, IEntityManager, IEntityManagerServiceCollection, IEntityManagerServiceRoot, IEntityMapper, IEntityReplicaDeleteManager, IEntityReplicaSyncManager, IEntityRepository, IEntitySearchParameters, IEntitySearchResults, IEntityUpdateAction, IEntityUpdateCommand, IEntityUpsertAction, IEntityUpsertCommand, IReplicasConfiguration, ISearchFilters, ISearchOptions, ISearchRequestPaging, ISearchResultsPaging, ISearchSorting, ISearchSortingField, ModulesContainerProvider, MultipleEntitiesFoundException, NestEntityActions, NestEntityManager, NestTypeOrmQueryBuilder, NestTypeOrmRepository, Processors, QueryBuilderBase, ReplicaConfiguration, ReplicaOptions, ReplicationMode, SortDirection, SortingType, WpEntity, WpEntityActions, WpEntityAuthMiddleware, WpEntityConnector, WpEntityConverter, WpEntityManager, WpEntityQueryBuilder, WpEntityRepository };
+export { EntityActionsProps, EntityAuthMiddlewareProps, EntityConnectorProps, EntityConverterProps, EntityManagerException, EntityManagerInitializer, EntityManagerModule, EntityManagerProps, EntityManagerRegistry, EntityManagerSymbols, EntityNotFoundException, EntityOperationType, EntityOperationUnauthorizedException, EntityProps, EntityQueryBuilderProps, EntityRepositoryProps, FilterExpression, IAuthorizationResult, IEntitiesQueryBuilder, IEntitiesSearchAction, IEntitiesSearchQuery, IEntityActions, IEntityAdapter, IEntityAuthorizationMiddleware, IEntityConverter, IEntityCreateAction, IEntityCreateCommand, IEntityDeleteAction, IEntityDeleteCommand, IEntityEventsManager, IEntityGetAction, IEntityGetQuery, IEntityManager, IEntityManagerServiceCollection, IEntityManagerServiceRoot, IEntityMapper, IEntityReplicaDeleteManager, IEntityReplicaSyncManager, IEntityRepository, IEntitySearchParameters, IEntitySearchResults, IEntityUpdateAction, IEntityUpdateCommand, IEntityUpsertAction, IEntityUpsertCommand, IReplicasConfiguration, ISearchFilters, ISearchOptions, ISearchRequestPaging, ISearchResultsPaging, ISearchSorting, ISearchSortingField, ModulesContainerProvider, MultipleEntitiesFoundException, NestEntityActions, NestEntityManager, NestTypeOrmQueryBuilder, NestTypeOrmRepository, QueryBuilderBase, ReplicaConfiguration, ReplicaOptions, ReplicationMode, SortDirection, SortingType, WpEntity, WpEntityActions, WpEntityAuthMiddleware, WpEntityConnector, WpEntityConverter, WpEntityManager, WpEntityQueryBuilder, WpEntityRepository };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@punks/backend-entity-manager",
-  "version": "0.0.14",
+  "version": "0.0.16",
   "description": "",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -28,6 +28,7 @@
     "@babel/core": "^7.21.0",
     "@nestjs/common": "^10.0.5",
     "@nestjs/core": "^10.0.5",
+    "@nestjs/event-emitter": "^2.0.0",
     "@nestjs/swagger": "^7.1.1",
     "@nestjs/testing": "^10.0.5",
     "@nestjs/typeorm": "^10.0.0",

package/readme.md

@@ -22,5 +22,5 @@ npm install typeorm
 
 ```bash
 # NestJS with TypeORM
-npm install @nestjs/core @nestjs/common @nestjs/typeorm @nestjs/swagger
+npm install @nestjs/core @nestjs/common @nestjs/event-emitter @nestjs/typeorm @nestjs/swagger
 ```