@punks/backend-entity-manager 0.0.245 → 0.0.247

package/dist/cjs/types/abstractions/index.d.ts

@@ -1,5 +1,6 @@
 export { IEntityCreateAction, IEntityDeleteAction, IEntityGetAction, IEntityUpdateAction, IEntityUpsertAction, IEntitiesSearchAction, IEntityActions, IEntitiesCountAction, IEntitiesDeleteAction, IEntitiesExportAction, IEntitiesImportAction, IEntityExistsAction, IEntitiesSampleDownloadAction, IEntityVersionsSearchAction, } from "./actions";
 export { IEntityAdapter } from "./adapters";
+export { IAppInitializer } from "./app";
 export * from "./authentication";
 export * from "./buckets";
 export * from "./cache";

package/dist/cjs/types/platforms/nest/decorators/connector.d.ts

@@ -1,4 +1,6 @@
-export interface EntityConnectorProps {
+import { ConnectorOptions } from "../../../abstractions/connectors";
+export interface EntityConnectorProps extends ConnectorOptions {
     entityName: string;
+    connectorName: string;
 }
-export declare const WpEntityConnector: (entityName: string, props?: Omit<EntityConnectorProps, "entityName">) => <TFunction extends Function, Y>(target: object | TFunction, propertyKey?: string | symbol | undefined, descriptor?: TypedPropertyDescriptor<Y> | undefined) => void;
+export declare const WpEntityConnector: (entityName: string, props: Omit<EntityConnectorProps, "entityName">) => <TFunction extends Function, Y>(target: object | TFunction, propertyKey?: string | symbol | undefined, descriptor?: TypedPropertyDescriptor<Y> | undefined) => void;

package/dist/cjs/types/platforms/nest/decorators/connectorMapper.d.ts

@@ -0,0 +1,5 @@
+export interface EntityConnectorMapperProps {
+    entityName: string;
+    connectorName: string;
+}
+export declare const WpEntityConnectorMapper: (entityName: string, props: Omit<EntityConnectorMapperProps, "entityName">) => <TFunction extends Function, Y>(target: object | TFunction, propertyKey?: string | symbol | undefined, descriptor?: TypedPropertyDescriptor<Y> | undefined) => void;

package/dist/cjs/types/platforms/nest/decorators/index.d.ts

@@ -5,6 +5,7 @@ export { WpCacheInstance, CacheInstanceProps } from "./cache";
 export { WpEntityActions, EntityActionsProps } from "./actions";
 export { WpEntityAdapter, EntityAdapterProps } from "./adapter";
 export { WpEntityConnector, EntityConnectorProps } from "./connector";
+export { WpEntityConnectorMapper, EntityConnectorMapperProps, } from "./connectorMapper";
 export { WpEntityConverter, EntityConverterProps } from "./converter";
 export { WpEmailTemplate, EmailTemplateProps, WpEmailLogger, EmailLoggerProps, WpEmailProvider, EmailProviderProps, } from "./email";
 export { WpEntity, EntityProps } from "./entity";

package/dist/cjs/types/platforms/nest/decorators/symbols.d.ts

@@ -8,6 +8,7 @@ export declare const EntityManagerSymbols: {
     EntityAuthMiddleware: symbol;
     EntityRepository: symbol;
     EntityConnector: symbol;
+    EntityConnectorMapper: symbol;
     EntityConverter: symbol;
     EntitySerializer: symbol;
     EntitySnapshotService: symbol;

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

@@ -1,5 +1,5 @@
 import { INestApplicationContext } from "@nestjs/common";
-import { EntityAuthMiddlewareProps, EntityConverterProps, EntityProps, EntityQueryBuilderProps, EntityRepositoryProps, EntitySerializerProps, EntitySnapshotServiceProps } from "../../decorators";
+import { EntityAuthMiddlewareProps, EntityConnectorMapperProps, EntityConnectorProps, EntityConverterProps, EntityProps, EntityQueryBuilderProps, EntityRepositoryProps, EntitySerializerProps, EntitySnapshotServiceProps } from "../../decorators";
 import { EntityManagerSettings } from "../../../../abstractions";
 import { EntityServiceLocator } from "../../../../providers/services";
 import { DiscoveredClassWithMeta } from "../discovery";
@@ -11,7 +11,7 @@ export declare class EntityManagerRegistry {
     registerGlobalServices({ eventEmitter, }: {
         eventEmitter?: IEventEmitter;
     }): Promise<void>;
-    registerDiscoveredEntity(app: INestApplicationContext, { adapter, entityName, entity, converter, queryBuilder, repository, authMiddleware, serializer, snapshotService, settings, }: {
+    registerDiscoveredEntity(app: INestApplicationContext, { adapter, entityName, entity, converter, queryBuilder, repository, authMiddleware, serializer, snapshotService, connectors, connectorMappers, settings, }: {
         entityName: string;
         entity: DiscoveredClassWithMeta<EntityProps>;
         repository: DiscoveredClassWithMeta<EntityRepositoryProps>;
@@ -21,6 +21,8 @@ export declare class EntityManagerRegistry {
         serializer: DiscoveredClassWithMeta<EntitySerializerProps>;
         snapshotService?: DiscoveredClassWithMeta<EntitySnapshotServiceProps>;
         authMiddleware?: DiscoveredClassWithMeta<EntityAuthMiddlewareProps>;
+        connectors?: DiscoveredClassWithMeta<EntityConnectorProps>[];
+        connectorMappers?: DiscoveredClassWithMeta<EntityConnectorMapperProps>[];
         settings: EntityManagerSettings;
     }): Promise<void>;
     resolveEntityServicesCollection<TEntity>(entityName: string): EntityServiceLocator<TEntity, unknown>;

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

@@ -46,6 +46,8 @@ export declare class EntityManagerInitializer {
     private discoverAdapters;
     private discoverAuthMiddlewares;
     private discoverGlobalAuthenticationMiddlewares;
+    private discoverEntityConnectors;
+    private discoverEntityConnectorMappers;
     private discoverAppInitializers;
     private discoverEntitySeeders;
     private discoverEmailTemplates;

package/dist/cjs/types/services/connectors.d.ts

@@ -2,6 +2,7 @@ import { IEntityConnectorDeleteManager, IEntityConnectorSyncManager } from "../a
 import { EntityServiceLocator } from "../providers/services";
 export declare class EntityConnectorsManager<TEntity, TEntityId> implements IEntityConnectorSyncManager<TEntity>, IEntityConnectorDeleteManager<TEntity, TEntityId> {
     private readonly services;
+    private readonly logger;
     constructor(services: EntityServiceLocator<TEntity, TEntityId>);
     syncEntity(entity: TEntity): Promise<void>;
     private processSync;

package/dist/esm/index.js

@@ -1,4 +1,4 @@
-import { Log, csvParse, excelParse, excelBuild, csvBuild, isNullOrUndefined, addTime, newUuid as newUuid$1, buildObject, sort, byField, toDict, ensureTailingSlash, ensureStartSlash, removeUndefinedProps } from '@punks/backend-core';
+import { Log, csvParse, excelParse, excelBuild, csvBuild, isNullOrUndefined, addTime, newUuid as newUuid$1, buildObject, toDict, sort, byField, toArrayDict, ensureTailingSlash, ensureStartSlash, removeUndefinedProps } from '@punks/backend-core';
 import { MoreThanOrEqual, In, Equal, Not, IsNull, And, MoreThan, LessThanOrEqual, LessThan, ILike } from 'typeorm';
 import { applyDecorators, Injectable, SetMetadata, createParamDecorator, Global, Module, Scope, Logger, StreamableFile, HttpException, HttpStatus } from '@nestjs/common';
 import { Reflector } from '@nestjs/core';
@@ -2097,15 +2097,33 @@ var ConnectorMode;
 class EntityConnectorsManager {
     constructor(services) {
         this.services = services;
+        this.logger = Log.getLogger(`[${services.getEntityName()}]: ${EntityConnectorsManager.name}`);
     }
     async syncEntity(entity) {
         for (const connector of this.getEnabledConnectors()) {
+            this.logger.debug(`Entity sync started - connector: ${connector.name}`, {
+                entity,
+            });
             switch (connector.options.mode) {
                 case ConnectorMode.Sync:
                     await this.processSync(connector, entity);
+                    this.logger.debug(`Entity sync completed - connector: ${connector.name}`, {
+                        connector: connector.name,
+                        entity,
+                    });
                     break;
                 case ConnectorMode.Async:
-                    this.processSync(connector, entity).catch((error) => { });
+                    this.processSync(connector, entity)
+                        .then(() => this.logger.debug(`Entity sync completed - connector: ${connector.name}`, {
+                        connector: connector.name,
+                        entity,
+                    }))
+                        .catch((error) => {
+                        this.logger.exception(`Entity sync error - connector: ${connector.name}`, error, {
+                            connector: connector.name,
+                            entity,
+                        });
+                    });
                     break;
                 default:
                     throw new Error("Invalid connector mode found");
@@ -2120,12 +2138,28 @@ class EntityConnectorsManager {
     }
     async deleteEntity(entityId) {
         for (const connector of this.getEnabledConnectors()) {
+            this.logger.debug(`Entity sync delete started - connector: ${connector.name}`, {
+                entityId,
+            });
             switch (connector.options.mode) {
                 case ConnectorMode.Sync:
                     await this.processDelete(connector, entityId);
+                    this.logger.debug(`Entity sync delete completed - connector: ${connector.name}`, {
+                        entityId,
+                    });
                     break;
                 case ConnectorMode.Async:
-                    this.processDelete(connector, entityId);
+                    this.processDelete(connector, entityId)
+                        .then(() => this.logger.debug(`Entity sync delete completed - connector: ${connector.name}`, {
+                        connector: connector.name,
+                        entityId,
+                    }))
+                        .catch((error) => {
+                        this.logger.exception(`Entity sync delete error - connector: ${connector.name}`, error, {
+                            connector: connector.name,
+                            entityId,
+                        });
+                    });
                     break;
                 default:
                     throw new Error("Invalid connector mode");
@@ -2157,15 +2191,15 @@ class EntityEventsManager {
         this.logger = Log.getLogger("EntityEventsManager");
     }
     async processEntityCreatedEvent(entity) {
-        this.services.resolveReplicaSyncManager().syncReplicas(entity);
-        this.services.resolveConnectorSyncManager().syncEntity(entity);
+        await this.services.resolveReplicaSyncManager().syncReplicas(entity);
+        await this.services.resolveConnectorSyncManager().syncEntity(entity);
         await this.emitEntityEvent("created", {
             entity,
         });
     }
     async processEntityUpdatedEvent(entity) {
-        this.services.resolveReplicaSyncManager().syncReplicas(entity);
-        this.services.resolveConnectorSyncManager().syncEntity(entity);
+        await this.services.resolveReplicaSyncManager().syncReplicas(entity);
+        await this.services.resolveConnectorSyncManager().syncEntity(entity);
         await this.emitEntityEvent("updated", {
             entity,
         });
@@ -3465,6 +3499,7 @@ const EntityManagerSymbols = {
     EntityAuthMiddleware: Symbol.for("WP:ENTITY_AUTH_MIDDLEWARE"),
     EntityRepository: Symbol.for("WP:ENTITY_REPOSITORY"),
     EntityConnector: Symbol.for("WP:ENTITY_CONNECTOR"),
+    EntityConnectorMapper: Symbol.for("WP:ENTITY_CONNECTOR_MAPPER"),
     EntityConverter: Symbol.for("WP:ENTITY_CONVERTER"),
     EntitySerializer: Symbol.for("WP:ENTITY_SERIALIZER"),
     EntitySnapshotService: Symbol.for("WP:ENTITY_SNAPSHOT_SERVICE"),
@@ -3514,7 +3549,12 @@ const WpEntityAdapter = (entityName, props = {}) => applyDecorators(Injectable()
     ...props,
 }));
 
-const WpEntityConnector = (entityName, props = {}) => applyDecorators(Injectable(), SetMetadata(EntityManagerSymbols.EntityConnector, {
+const WpEntityConnector = (entityName, props) => applyDecorators(Injectable(), SetMetadata(EntityManagerSymbols.EntityConnector, {
+    entityName,
+    ...props,
+}));
+
+const WpEntityConnectorMapper = (entityName, props) => applyDecorators(Injectable(), SetMetadata(EntityManagerSymbols.EntityConnectorMapper, {
     entityName,
     ...props,
 }));
@@ -3937,7 +3977,7 @@ let EntityManagerRegistry = class EntityManagerRegistry {
                 .registerEventEmitter(eventEmitter);
         }
     }
-    async registerDiscoveredEntity(app, { adapter, entityName, entity, converter, queryBuilder, repository, authMiddleware, serializer, snapshotService, settings, }) {
+    async registerDiscoveredEntity(app, { adapter, entityName, entity, converter, queryBuilder, repository, authMiddleware, serializer, snapshotService, connectors, connectorMappers, settings, }) {
         if (!repository.discoveredClass.injectType) {
             throw new Error(`No inject type found for entity repository: ${entityName}`);
         }
@@ -3981,7 +4021,31 @@ let EntityManagerRegistry = class EntityManagerRegistry {
                 middleware: authMiddlewareInstance,
             });
         }
-        // todo: configure mappers and replica
+        const mappers = toDict(connectorMappers ?? [], (x) => x.meta.connectorName);
+        for (const connector of connectors ?? []) {
+            if (!connector.discoveredClass.injectType) {
+                throw new Error(`No inject type found for entity connector: ${entityName}`);
+            }
+            const mapper = mappers[connector.meta.connectorName];
+            if (!mapper) {
+                throw new Error(`No connector mapper found for entity connector: entityName:${entityName} - connectorName:${connector.meta.connectorName}`);
+            }
+            if (!mapper.discoveredClass.injectType) {
+                throw new Error(`No inject type found for entity connector mapper: ${entityName} - ${connector.meta.connectorName}`);
+            }
+            const connectorInstance = (await app.resolve(connector.discoveredClass.injectType));
+            const mapperInstance = (await app.resolve(connector.discoveredClass.injectType));
+            registration.withSynchronization({
+                name: connector.meta.connectorName,
+                mapper: mapperInstance,
+                connector: connectorInstance,
+                options: {
+                    mode: connector.meta.mode,
+                    enabled: connector.meta.enabled,
+                },
+            });
+        }
+        // todo: configure replica
     }
     resolveEntityServicesCollection(entityName) {
         return this.container.getEntityServicesLocator(entityName);
@@ -22614,6 +22678,8 @@ let EntityManagerInitializer = EntityManagerInitializer_1 = class EntityManagerI
         const snapshotServices = await this.discoverSnapshotService();
         const adapters = await this.discoverAdapters();
         const auth = await this.discoverAuthMiddlewares();
+        const connectors = await this.discoverEntityConnectors();
+        const connectorMappers = await this.discoverEntityConnectorMappers();
         const repositoriesDict = toDict(repositories, (q) => q.meta.entityName);
         const queryBuilderDict = toDict(queryBuilders, (q) => q.meta.entityName);
         const converterDict = toDict(converters, (c) => c.meta.entityName);
@@ -22621,6 +22687,8 @@ let EntityManagerInitializer = EntityManagerInitializer_1 = class EntityManagerI
         const snapshotServicesDict = toDict(snapshotServices, (s) => s.meta.entityName);
         const adapterDict = toDict(adapters, (a) => a.meta.entityName);
         const authDict = toDict(auth, (a) => a.meta.entityName);
+        const connectorsDict = toArrayDict(connectors, (c) => c.meta.entityName);
+        const connectorMappersDict = toArrayDict(connectorMappers, (c) => c.meta.entityName);
         const sortedEntities = lodash.exports.orderBy(entities, (x) => x.meta.name);
         this.logger.log(`Discovered entities: \n${sortedEntities
             .map((x) => x.discoveredClass.name)
@@ -22644,6 +22712,8 @@ let EntityManagerInitializer = EntityManagerInitializer_1 = class EntityManagerI
             const authMiddleware = authDict[entityName];
             const serializer = serializerDict[entityName];
             const snapshotService = snapshotServicesDict[entityName];
+            const connectors = connectorsDict[entityName];
+            const connectorMappers = connectorMappersDict[entityName];
             await this.registry.registerDiscoveredEntity(app, {
                 entityName,
                 entity,
@@ -22655,6 +22725,8 @@ let EntityManagerInitializer = EntityManagerInitializer_1 = class EntityManagerI
                 snapshotService,
                 authMiddleware,
                 settings: staticProviders.settings,
+                connectorMappers,
+                connectors,
             });
             this.logger.log(`Entity ${entityName} registered:
   - Repository: ${repository.discoveredClass.injectType?.name ?? ""}
@@ -22901,6 +22973,12 @@ let EntityManagerInitializer = EntityManagerInitializer_1 = class EntityManagerI
     async discoverGlobalAuthenticationMiddlewares() {
         return await this.discover.providersWithMetaAtKey(EntityManagerSymbols.GlobalAuthenticationMiddleware);
     }
+    async discoverEntityConnectors() {
+        return await this.discover.providersWithMetaAtKey(EntityManagerSymbols.EntityConnector);
+    }
+    async discoverEntityConnectorMappers() {
+        return await this.discover.providersWithMetaAtKey(EntityManagerSymbols.EntityConnectorMapper);
+    }
     async discoverAppInitializers() {
         return await this.discover.providersWithMetaAtKey(EntityManagerSymbols.AppInitializer);
     }
@@ -32530,5 +32608,5 @@ AwsSecretsModule = AwsSecretsModule_1 = __decorate([
     })
 ], AwsSecretsModule);
 
-export { AUTHENTICATION_EVENTS_NAMESPACE, ApiKeyAccess, AppExceptionsFilterBase, AppHashingService, AppInMemorySettings, AppSessionMiddleware, AppSessionService, AuthGuard, Authenticated, AuthenticationEmailTemplates, AuthenticationError, AuthenticationEvents, AuthenticationExtensionSymbols, AuthenticationModule, AuthenticationService, AwsBucketModule, AwsEmailModule, AwsS3BucketError, AwsS3BucketProvider, AwsS3MediaError, AwsS3MediaModule, AwsS3MediaProvider, AwsSecretsModule, AwsSecretsProvider, AwsSesEmailTemplate, BucketItemType, CacheService, CurrentUser, CustomDiscoveryModule, CustomDiscoveryService, EmailService, EntityManagerConfigurationError, EntityManagerException, EntityManagerInitializer, EntityManagerModule, EntityManagerRegistry, EntityManagerService, EntityManagerSymbols, EntityManagerUnauthorizedException, EntityNotFoundException, EntityOperationType, EntityOperationUnauthorizedException, EntitySeeder, EntitySerializationFormat, EntitySerializer, EntitySnapshotService, EntityVersionOperation, EventsService, FilesManager, IEntityVersionsCursor, InMemoryBucketProvider, InMemoryEmailProvider, InMemoryMediaProvider, InvalidCredentialsError, MediaLibraryService, MemberOf, MissingEntityIdError, ModulesContainerProvider, MultiTenancyModule, MultipleEntitiesFoundException, NestEntityActions, NestEntityAuthorizationMiddleware, NestEntityManager, NestEntitySerializer, NestEntitySnapshotService, NestPipelineTemplate, NestTypeOrmEntitySeeder, NestTypeOrmQueryBuilder, NestTypeOrmRepository, OperationTokenMismatchError, PLATFORM_EVENT_NAMESPACE, Permissions, PipelineController, PipelineErrorType, PipelineInvocationError, PipelineStatus, PipelineStepErrorType, PipelinesBuilder, PipelinesRunner, PlatformEvents, Public, QueryBuilderBase, QueryBuilderOperation, ReplicationMode, Roles, SanityMediaError, SanityMediaModule, SanityMediaProvider, SecretsService, SendgridEmailModule, SendgridEmailTemplate, SortDirection, TrackingService, TypeOrmQueryBuilder, TypeOrmRepository, TypeormCacheInstance, UserCreationError, UserRegistrationError, WpApiKeysService, WpAppInitializer, WpAwsSesEmailTemplate, WpBucketProvider, WpCacheInstance, WpEmailLogger, WpEmailProvider, WpEmailTemplate, WpEntity, WpEntityActions, WpEntityAdapter, WpEntityAuthMiddleware, WpEntityConnector, WpEntityConverter, WpEntityManager, WpEntityQueryBuilder, WpEntityRepository, WpEntitySeeder, WpEntitySerializer, WpEntitySnapshotService, WpEntityVersioningProvider, WpEventsTracker, WpFileProvider, WpFileReferenceRepository, WpGlobalAuthenticationMiddleware, WpMediaFolderRepository, WpMediaProvider, WpMediaReferenceRepository, WpPermissionsService, WpPipeline, WpRolesService, WpSendgridEmailTemplate, WpUserRolesService, WpUserService, buildPermissionsGuard, buildRolesGuard, createContainer, createExpressFileResponse, getLocalizedText, newUuid, renderHandlebarsTemplate, toEntitiesImportInput };
+export { AUTHENTICATION_EVENTS_NAMESPACE, ApiKeyAccess, AppExceptionsFilterBase, AppHashingService, AppInMemorySettings, AppSessionMiddleware, AppSessionService, AuthGuard, Authenticated, AuthenticationEmailTemplates, AuthenticationError, AuthenticationEvents, AuthenticationExtensionSymbols, AuthenticationModule, AuthenticationService, AwsBucketModule, AwsEmailModule, AwsS3BucketError, AwsS3BucketProvider, AwsS3MediaError, AwsS3MediaModule, AwsS3MediaProvider, AwsSecretsModule, AwsSecretsProvider, AwsSesEmailTemplate, BucketItemType, CacheService, CurrentUser, CustomDiscoveryModule, CustomDiscoveryService, EmailService, EntityManagerConfigurationError, EntityManagerException, EntityManagerInitializer, EntityManagerModule, EntityManagerRegistry, EntityManagerService, EntityManagerSymbols, EntityManagerUnauthorizedException, EntityNotFoundException, EntityOperationType, EntityOperationUnauthorizedException, EntitySeeder, EntitySerializationFormat, EntitySerializer, EntitySnapshotService, EntityVersionOperation, EventsService, FilesManager, IEntityVersionsCursor, InMemoryBucketProvider, InMemoryEmailProvider, InMemoryMediaProvider, InvalidCredentialsError, MediaLibraryService, MemberOf, MissingEntityIdError, ModulesContainerProvider, MultiTenancyModule, MultipleEntitiesFoundException, NestEntityActions, NestEntityAuthorizationMiddleware, NestEntityManager, NestEntitySerializer, NestEntitySnapshotService, NestPipelineTemplate, NestTypeOrmEntitySeeder, NestTypeOrmQueryBuilder, NestTypeOrmRepository, OperationTokenMismatchError, PLATFORM_EVENT_NAMESPACE, Permissions, PipelineController, PipelineErrorType, PipelineInvocationError, PipelineStatus, PipelineStepErrorType, PipelinesBuilder, PipelinesRunner, PlatformEvents, Public, QueryBuilderBase, QueryBuilderOperation, ReplicationMode, Roles, SanityMediaError, SanityMediaModule, SanityMediaProvider, SecretsService, SendgridEmailModule, SendgridEmailTemplate, SortDirection, TrackingService, TypeOrmQueryBuilder, TypeOrmRepository, TypeormCacheInstance, UserCreationError, UserRegistrationError, WpApiKeysService, WpAppInitializer, WpAwsSesEmailTemplate, WpBucketProvider, WpCacheInstance, WpEmailLogger, WpEmailProvider, WpEmailTemplate, WpEntity, WpEntityActions, WpEntityAdapter, WpEntityAuthMiddleware, WpEntityConnector, WpEntityConnectorMapper, WpEntityConverter, WpEntityManager, WpEntityQueryBuilder, WpEntityRepository, WpEntitySeeder, WpEntitySerializer, WpEntitySnapshotService, WpEntityVersioningProvider, WpEventsTracker, WpFileProvider, WpFileReferenceRepository, WpGlobalAuthenticationMiddleware, WpMediaFolderRepository, WpMediaProvider, WpMediaReferenceRepository, WpPermissionsService, WpPipeline, WpRolesService, WpSendgridEmailTemplate, WpUserRolesService, WpUserService, buildPermissionsGuard, buildRolesGuard, createContainer, createExpressFileResponse, getLocalizedText, newUuid, renderHandlebarsTemplate, toEntitiesImportInput };
 //# sourceMappingURL=index.js.map