@punks/backend-entity-manager 0.0.100 → 0.0.102

package/dist/esm/index.js

@@ -101,6 +101,14 @@ var EntitySerializationFormat;
     EntitySerializationFormat["Xlsx"] = "xlsx";
 })(EntitySerializationFormat || (EntitySerializationFormat = {}));
 
+var EntityVersionOperation;
+(function (EntityVersionOperation) {
+    EntityVersionOperation["Create"] = "create";
+    EntityVersionOperation["Update"] = "update";
+    EntityVersionOperation["Upsert"] = "upsert";
+    EntityVersionOperation["Delete"] = "delete";
+})(EntityVersionOperation || (EntityVersionOperation = {}));
+
 class EntitySeeder {
     constructor() {
         this.logger = Log.getLogger(EntitySeeder.name);
@@ -450,9 +458,11 @@ class EntityCreateCommand {
         this.services = services;
     }
     async execute(input) {
-        var entity = this.adaptEntity(input);
+        const entity = this.adaptEntity(input);
         await this.authorize(entity);
-        var createdItem = await this.services.resolveRepository().create(entity);
+        const createdItem = await this.services.resolveRepository().create(entity);
+        // todo: parametrize id field
+        await this.versionEntity(createdItem.id, createdItem);
         await this.services
             .resolveEventsManager()
             .processEntityCreatedEvent(createdItem);
@@ -478,6 +488,27 @@ class EntityCreateCommand {
         if (!authorizationResult.isAuthorized)
             throw new EntityOperationUnauthorizedException(EntityOperationType.Create, this.services.getEntityName(), entity);
     }
+    async versionEntity(id, entity) {
+        if (!this.isVersioningEnabled()) {
+            return;
+        }
+        const versioning = this.services.resolveVersioningProvider();
+        if (!versioning) {
+            return;
+        }
+        const contextService = this.services.resolveAuthenticationContextProvider();
+        const context = await contextService?.getContext();
+        await versioning.versionEntity({
+            operationType: EntityVersionOperation.Create,
+            entityId: id,
+            entityType: this.services.getEntityName(),
+            data: entity,
+            modifiedByUserId: context?.userId,
+        });
+    }
+    isVersioningEnabled() {
+        return (this.services.resolveEntityConfiguration().versioning?.enabled ?? false);
+    }
 }
 
 class EntityDeleteCommand {
@@ -490,6 +521,7 @@ class EntityDeleteCommand {
         }
         await this.authorize(id);
         await this.services.resolveRepository().delete(id);
+        await this.versionEntity(id);
         await this.services.resolveEventsManager().processEntityDeletedEvent(id);
     }
     async authorize(id) {
@@ -510,6 +542,26 @@ class EntityDeleteCommand {
         if (!authorizationResult.isAuthorized)
             throw new EntityOperationUnauthorizedException(EntityOperationType.Delete, this.services.getEntityName(), entity);
     }
+    async versionEntity(id) {
+        if (!this.isVersioningEnabled()) {
+            return;
+        }
+        const versioning = this.services.resolveVersioningProvider();
+        if (!versioning) {
+            return;
+        }
+        const contextService = this.services.resolveAuthenticationContextProvider();
+        const context = await contextService?.getContext();
+        await versioning.versionEntity({
+            operationType: EntityVersionOperation.Delete,
+            entityId: id,
+            entityType: this.services.getEntityName(),
+            modifiedByUserId: context?.userId,
+        });
+    }
+    isVersioningEnabled() {
+        return (this.services.resolveEntityConfiguration().versioning?.enabled ?? false);
+    }
 }
 
 class EntitiesDeleteCommand {
@@ -522,6 +574,7 @@ class EntitiesDeleteCommand {
         const deleteResult = await this.services
             .resolveQueryBuilder()
             .delete(params.filters, context);
+        // todo: version deleted entities
         // todo: add entities deleted event
         return deleteResult;
     }
@@ -702,6 +755,7 @@ class EntityUpdateCommand {
         const updatedEntity = await this.services
             .resolveRepository()
             .update(id, entity);
+        await this.versionEntity(id, updatedEntity);
         await this.services
             .resolveEventsManager()
             .processEntityUpdatedEvent(updatedEntity);
@@ -731,6 +785,27 @@ class EntityUpdateCommand {
         if (!authorizationResult.isAuthorized)
             throw new EntityOperationUnauthorizedException(EntityOperationType.Create, this.services.getEntityName(), currentEntity);
     }
+    async versionEntity(id, entity) {
+        if (!this.isVersioningEnabled()) {
+            return;
+        }
+        const versioning = this.services.resolveVersioningProvider();
+        if (!versioning) {
+            return;
+        }
+        const contextService = this.services.resolveAuthenticationContextProvider();
+        const context = await contextService?.getContext();
+        await versioning.versionEntity({
+            operationType: EntityVersionOperation.Update,
+            entityId: id,
+            entityType: this.services.getEntityName(),
+            data: entity,
+            modifiedByUserId: context?.userId,
+        });
+    }
+    isVersioningEnabled() {
+        return (this.services.resolveEntityConfiguration().versioning?.enabled ?? false);
+    }
 }
 
 class EntityUpsertCommand {
@@ -741,6 +816,7 @@ class EntityUpsertCommand {
         const entity = this.adaptEntity(data);
         await this.authorize(id, entity);
         const updatedEntity = await this.upsertEntity(id, entity);
+        await this.versionEntity(id, updatedEntity);
         await this.services
             .resolveEventsManager()
             .processEntityUpdatedEvent(updatedEntity);
@@ -776,6 +852,27 @@ class EntityUpsertCommand {
         if (!authorizationResult.isAuthorized)
             throw new EntityOperationUnauthorizedException(EntityOperationType.Create, this.services.getEntityName(), entity);
     }
+    async versionEntity(id, entity) {
+        if (!this.isVersioningEnabled()) {
+            return;
+        }
+        const versioning = this.services.resolveVersioningProvider();
+        if (!versioning) {
+            return;
+        }
+        const contextService = this.services.resolveAuthenticationContextProvider();
+        const context = await contextService?.getContext();
+        await versioning.versionEntity({
+            operationType: EntityVersionOperation.Upsert,
+            entityId: id,
+            entityType: this.services.getEntityName(),
+            data: entity,
+            modifiedByUserId: context?.userId,
+        });
+    }
+    isVersioningEnabled() {
+        return (this.services.resolveEntityConfiguration().versioning?.enabled ?? false);
+    }
 }
 
 class EntityManager {
@@ -961,6 +1058,9 @@ const EntityServices = {
     Storage: {
         IEntityRepository: "IEntityRepository",
     },
+    Settings: {
+        IEntityConfiguration: "IEntityConfiguration",
+    },
 };
 const GlobalServices = {
     Events: {
@@ -978,6 +1078,9 @@ const GlobalServices = {
         IEmailTemplatesCollection: "IEmailTemplatesCollection",
         IBucketProvider: "IBucketProvider",
     },
+    Versioning: {
+        IEntityVersioningProvider: "IEntityVersioningProvider",
+    },
 };
 
 class EntityServiceLocator {
@@ -1003,6 +1106,12 @@ class EntityServiceLocator {
     resolveEventsManager() {
         return this.services.resolveEventsManager(this.entityName);
     }
+    resolveVersioningProvider() {
+        return this.services.resolveEntityVersioningProvider();
+    }
+    resolveEntityConfiguration() {
+        return this.services.resolveEntityConfiguration(this.entityName);
+    }
     resolveReplicaSyncManager() {
         return this.services.resolveReplicaSyncManager(this.entityName);
     }
@@ -1133,6 +1242,12 @@ class EntitiesServiceLocator {
     registerEmailProvider(instance) {
         this.provider.register(GlobalServices.Plugins.IEmailProvider, instance);
     }
+    resolveEntityVersioningProvider() {
+        return this.provider.resolve(GlobalServices.Versioning.IEntityVersioningProvider);
+    }
+    registerEntityVersioningProvider(instance) {
+        this.provider.register(GlobalServices.Versioning.IEntityVersioningProvider, instance);
+    }
     resolveBucketProvider() {
         return this.provider.resolve(GlobalServices.Plugins.IBucketProvider);
     }
@@ -1165,6 +1280,12 @@ class EntitiesServiceLocator {
     registerAuthenticationContextProvider(instance) {
         this.provider.register(GlobalServices.Authentication.IAuthenticationContextProvider, instance);
     }
+    resolveEntityConfiguration(entityName) {
+        return this.provider.resolveEntityService(EntityServices.Settings.IEntityConfiguration, entityName);
+    }
+    registerEntityConfiguration(entityName, instance) {
+        return this.provider.registerEntityService(EntityServices.Settings.IEntityConfiguration, entityName, instance);
+    }
     resolveEntityManager(entityName) {
         return this.provider.resolveEntityService(EntityServices.Services.IEntityManager, entityName);
     }
@@ -1763,11 +1884,13 @@ class EntityManagerServiceRoot {
     addAuthentication({ provider }) {
         this.getEntitiesServicesLocator().registerAuthenticationContextProvider(provider);
     }
-    registerEntity(entityName, repository) {
+    registerEntity(entity, repository) {
+        const { name: entityName } = entity;
         const collection = new EntityManagerServiceCollection(entityName, this.getEntitiesServicesLocator());
         const services = this.getEntityServicesLocator(entityName);
         collection.locator.registerEntityManager(entityName, new EntityManager(services));
         collection.locator.registerEntityActions(entityName, new EntityActions(services));
+        collection.locator.registerEntityConfiguration(entityName, entity);
         collection.locator.registerRepository(entityName, repository);
         const replicaManager = new EntityReplicaManager(services);
         collection.locator.registerReplicaSyncManager(entityName, replicaManager);
@@ -1949,6 +2072,7 @@ const EntityManagerSymbols = {
     EntityManager: Symbol.for("WP:ENTITY_MANAGER"),
     EntityQueryBuilder: Symbol.for("WP:ENTITY_QUERY_BUILDER"),
     EntitySeeder: Symbol.for("WP:ENTITY_SEEDER"),
+    EntityVersioningProvider: Symbol.for("WP:ENTITY_VERSIONING_PROVIDER"),
     EmailProvider: Symbol.for("WP:EMAIL_PROVIDER"),
     EmailTemplate: Symbol.for("WP:EMAIL_TEMPLATE"),
     BucketProvider: Symbol.for("WP:BUCKET_PROVIDER"),
@@ -2032,6 +2156,10 @@ const WpEventsTracker = (props = {}) => applyDecorators(Injectable(), SetMetadat
     ...props,
 }));
 
+const WpEntityVersioningProvider = (props = {}) => applyDecorators(Injectable(), SetMetadata(EntityManagerSymbols.EntityVersioningProvider, {
+    ...props,
+}));
+
 /******************************************************************************
 Copyright (c) Microsoft Corporation.
 
@@ -2300,7 +2428,7 @@ let EntityManagerRegistry = class EntityManagerRegistry {
             throw new Error(`No inject type found for entity repository: ${entityName}`);
         }
         const repositoryInstance = (await app.resolve(repository.discoveredClass.injectType));
-        const registration = this.container.registerEntity(entityName, repositoryInstance);
+        const registration = this.container.registerEntity(entity.meta, repositoryInstance);
         if (!serializer?.discoveredClass?.injectType) {
             throw new Error(`No inject type found for entity serializer: ${entityName}`);
         }
@@ -20859,6 +20987,7 @@ let EntityManagerInitializer = EntityManagerInitializer_1 = class EntityManagerI
         await this.registerEmailTemplates();
         await this.registerEmailProviders();
         await this.registerEventTrackingProviders();
+        await this.registerVersioningProviders();
         await this.registerBucketProviders();
         await this.executeInitializers(app);
         await this.executeSeeders();
@@ -20964,6 +21093,19 @@ let EntityManagerInitializer = EntityManagerInitializer_1 = class EntityManagerI
             .registerEventsTracker(providers[0].discoveredClass.instance);
         this.logger.log(`Events tracker ${providers[0].discoveredClass.name} registered 🚜`);
     }
+    async registerVersioningProviders() {
+        const providers = await this.discoverVersioningProviders();
+        if (!providers.length) {
+            return;
+        }
+        for (const provider of providers) {
+            this.registry
+                .getContainer()
+                .getEntitiesServicesLocator()
+                .registerEntityVersioningProvider(provider.discoveredClass.instance);
+            this.logger.log(`Versioning provider ${provider.discoveredClass.name} registered 🚜`);
+        }
+    }
     async registerEmailProviders() {
         const providers = await this.discoverEmailProviders();
         if (!providers.length) {
@@ -21006,6 +21148,9 @@ let EntityManagerInitializer = EntityManagerInitializer_1 = class EntityManagerI
     async discoverRepositories() {
         return await this.discover.providersWithMetaAtKey(EntityManagerSymbols.EntityRepository);
     }
+    async discoverVersioningProviders() {
+        return await this.discover.providersWithMetaAtKey(EntityManagerSymbols.EntityVersioningProvider);
+    }
     async discoverQueryBuilders() {
         return await this.discover.providersWithMetaAtKey(EntityManagerSymbols.EntityQueryBuilder);
     }
@@ -27396,5 +27541,5 @@ InMemoryEmailProvider = __decorate([
     WpEmailProvider("in-memory")
 ], InMemoryEmailProvider);
 
-export { AUTHENTICATION_EVENTS_NAMESPACE, AppExceptionsFilterBase, AppHashingService, AppInMemorySettings, AppSessionMiddleware, AppSessionService, AuthGuard, Authenticated, AuthenticationEmailTemplates, AuthenticationError, AuthenticationEvents, AuthenticationExtensionSymbols, AuthenticationModule, AuthenticationService, AwsBucketModule, AwsEmailModule, AwsS2BucketError, AwsS3BucketProvider, AwsSesEmailTemplate, BooleanFacet, BooleanFacetItem, BucketItemType, EmailService, EntityManagerConfigurationError, EntityManagerException, EntityManagerInitializer, EntityManagerModule, EntityManagerRegistry, EntityManagerService, EntityManagerSymbols, EntityManagerUnauthorizedException, EntityNotFoundException, EntityOperationType, EntityOperationUnauthorizedException, EntitySeeder, EntitySerializationFormat, EntitySerializer, EventsService, InMemoryBucketProvider, InMemoryEmailProvider, InvalidCredentialsError, MemberOf, MissingEntityIdError, ModulesContainerProvider, MultiTenancyModule, MultipleEntitiesFoundException, NestEntityActions, NestEntityAuthorizationMiddleware, NestEntityManager, NestEntitySerializer, NestPipelineTemplate, NestTypeOrmEntitySeeder, NestTypeOrmQueryBuilder, NestTypeOrmRepository, NumericFacet, NumericFacetItem, OperationTokenMismatchError, PLATFORM_EVENT_NAMESPACE, PipelineController, PipelineErrorType, PipelineStatus, PipelineStepErrorType, PipelinesBuilder, PipelinesRunner, PlatformEvents, Public, QueryBuilderBase, ReplicationMode, Roles, SendgridEmailModule, SendgridEmailTemplate, SortDirection, StringFacet, StringFacetItem, TrackingService, UserCreationError, UserRegistrationError, WpAppInitializer, WpAwsSesEmailTemplate, WpBucketProvider, WpEmailTemplate, WpEntity, WpEntityActions, WpEntityAdapter, WpEntityAuthMiddleware, WpEntityConnector, WpEntityConverter, WpEntityManager, WpEntityQueryBuilder, WpEntityRepository, WpEntitySeeder, WpEntitySerializer, WpEventsTracker, WpPipeline, WpRolesService, WpSendgridEmailTemplate, WpUserRolesService, WpUserService, buildRolesGuard, createContainer, createExpressFileResponse, getLocalizedText, newUuid, renderHandlebarsTemplate, toEntitiesImportInput };
+export { AUTHENTICATION_EVENTS_NAMESPACE, AppExceptionsFilterBase, AppHashingService, AppInMemorySettings, AppSessionMiddleware, AppSessionService, AuthGuard, Authenticated, AuthenticationEmailTemplates, AuthenticationError, AuthenticationEvents, AuthenticationExtensionSymbols, AuthenticationModule, AuthenticationService, AwsBucketModule, AwsEmailModule, AwsS2BucketError, AwsS3BucketProvider, AwsSesEmailTemplate, BooleanFacet, BooleanFacetItem, BucketItemType, EmailService, EntityManagerConfigurationError, EntityManagerException, EntityManagerInitializer, EntityManagerModule, EntityManagerRegistry, EntityManagerService, EntityManagerSymbols, EntityManagerUnauthorizedException, EntityNotFoundException, EntityOperationType, EntityOperationUnauthorizedException, EntitySeeder, EntitySerializationFormat, EntitySerializer, EntityVersionOperation, EventsService, InMemoryBucketProvider, InMemoryEmailProvider, InvalidCredentialsError, MemberOf, MissingEntityIdError, ModulesContainerProvider, MultiTenancyModule, MultipleEntitiesFoundException, NestEntityActions, NestEntityAuthorizationMiddleware, NestEntityManager, NestEntitySerializer, NestPipelineTemplate, NestTypeOrmEntitySeeder, NestTypeOrmQueryBuilder, NestTypeOrmRepository, NumericFacet, NumericFacetItem, OperationTokenMismatchError, PLATFORM_EVENT_NAMESPACE, PipelineController, PipelineErrorType, PipelineStatus, PipelineStepErrorType, PipelinesBuilder, PipelinesRunner, PlatformEvents, Public, QueryBuilderBase, ReplicationMode, Roles, SendgridEmailModule, SendgridEmailTemplate, SortDirection, StringFacet, StringFacetItem, TrackingService, UserCreationError, UserRegistrationError, WpAppInitializer, WpAwsSesEmailTemplate, WpBucketProvider, WpEmailTemplate, WpEntity, WpEntityActions, WpEntityAdapter, WpEntityAuthMiddleware, WpEntityConnector, WpEntityConverter, WpEntityManager, WpEntityQueryBuilder, WpEntityRepository, WpEntitySeeder, WpEntitySerializer, WpEntityVersioningProvider, WpEventsTracker, WpPipeline, WpRolesService, WpSendgridEmailTemplate, WpUserRolesService, WpUserService, buildRolesGuard, createContainer, createExpressFileResponse, getLocalizedText, newUuid, renderHandlebarsTemplate, toEntitiesImportInput };
 //# sourceMappingURL=index.js.map