@punks/backend-entity-manager 0.0.349 → 0.0.350

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

@@ -4,6 +4,7 @@ import { IEntitiesDeleteParameters } from "./commands";
 import { SortingType } from "./common";
 import { EntitiesExportInput, EntitiesExportResult, EntitiesSampleDownloadOptions, EntitiesSampleDownloadResult } from "./export";
 import { EntitiesImportInput, EntitiesImportResult } from "./import";
+import { EntitiesParseInput, EntitiesParseResult } from "./parse";
 import { IEntitySearchParameters, ISearchFilters } from "./searchParameters";
 import { IEntityFacets } from "./searchResults";
 export interface IEntityCreateAction<TEntity, TEntityCreateDto, TEntityDto> {
@@ -39,6 +40,9 @@ export interface IEntitiesExportAction<TEntity, TEntitySearchParameters extends
 export interface IEntitiesImportAction<TEntity> {
     execute(input: EntitiesImportInput<unknown>): Promise<EntitiesImportResult>;
 }
+export interface IEntitiesParseAction<TEntity> {
+    execute(input: EntitiesParseInput<unknown>): Promise<EntitiesParseResult<unknown>>;
+}
 export interface IEntitiesSampleDownloadAction<TEntity> {
     execute(input: EntitiesSampleDownloadOptions): Promise<EntitiesSampleDownloadResult>;
 }
@@ -57,6 +61,7 @@ export interface IEntityActions<TEntity, TEntityId, TEntityCreateDto, TEntityUpd
     get deleteItems(): IEntitiesDeleteAction<TEntity, TEntitiesDeleteParameters, TSorting>;
     get export(): IEntitiesExportAction<TEntity, TEntitySearchParameters, TSorting, TCursor>;
     get import(): IEntitiesImportAction<TEntity>;
+    get parse(): IEntitiesParseAction<TEntity>;
     get sampleDownload(): IEntitiesSampleDownloadAction<TEntity>;
     get versions(): IEntityVersionsSearchAction<TEntity, TEntityListItemDto, TCursor>;
 }

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

@@ -2,6 +2,7 @@ import { EntityReference } from "../models";
 import { SortingType } from "./common";
 import { EntitiesExportInput, EntitiesExportResult, EntitiesSampleDownloadOptions, EntitiesSampleDownloadResult } from "./export";
 import { EntitiesImportInput, EntitiesImportResult } from "./import";
+import { EntitiesParseInput, EntitiesParseResult } from "./parse";
 import { IEntitySearchParameters, ISearchFilters, ISearchSorting } from "./searchParameters";
 import { EntityVersionOperation } from "./versioning";
 export interface IEntityCreateCommand<TEntity, TEntityId, TEntityCreateData> {
@@ -40,6 +41,9 @@ export interface IEntitiesExportCommand<TEntity, TEntitySearchParameters extends
 export interface IEntitiesImportCommand<TEntity> {
     execute(input: EntitiesImportInput<unknown>): Promise<EntitiesImportResult>;
 }
+export interface IEntitiesParseCommand<TEntity> {
+    execute(input: EntitiesParseInput<unknown>): Promise<EntitiesParseResult<unknown>>;
+}
 export interface IEntitiesSampleDownloadCommand<TEntity> {
     execute(input: EntitiesSampleDownloadOptions): Promise<EntitiesSampleDownloadResult>;
 }

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

@@ -5,13 +5,21 @@ export type EntitiesImportInputFile = {
     content: Buffer;
     contentType: string;
 };
+export declare enum InvalidEntityHandling {
+    Skip = "skip",
+    Fail = "fail"
+}
 export type EntitiesImportInput<TPayload> = {
     format: EntitySerializationFormat;
     file: EntitiesImportInputFile;
     payload?: TPayload;
+    options?: {
+        invalidEntitiesHandling: InvalidEntityHandling;
+    };
 };
 export type EntitiesImportStatistics = {
     importedCount: number;
+    skippedCount: number;
     updatedCount: number;
     createdCount: number;
     unchangedCount: number;

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

@@ -1,11 +1,11 @@
-export { IEntityCreateAction, IEntityDeleteAction, IEntityGetAction, IEntityUpdateAction, IEntityUpsertAction, IEntitiesSearchAction, IEntityActions, IEntitiesCountAction, IEntitiesDeleteAction, IEntitiesExportAction, IEntitiesImportAction, IEntityExistsAction, IEntitiesSampleDownloadAction, IEntityVersionsSearchAction, } from "./actions";
+export { IEntityCreateAction, IEntityDeleteAction, IEntityGetAction, IEntityUpdateAction, IEntityUpsertAction, IEntitiesSearchAction, IEntityActions, IEntitiesCountAction, IEntitiesDeleteAction, IEntitiesExportAction, IEntitiesImportAction, IEntityExistsAction, IEntitiesSampleDownloadAction, IEntityVersionsSearchAction, IEntitiesParseAction, } from "./actions";
 export { IEntityAdapter } from "./adapters";
 export { IAppInitializer } from "./app";
 export * from "./authentication";
 export * from "./buckets";
-export * from "./cache";
 export { IAuthorizationResult, IEntityAuthorizationMiddleware, } from "./authorization";
-export { IEntityCreateCommand, IEntityUpdateCommand, IEntityUpsertCommand, IEntityDeleteCommand, IEntityVersionCommand, IEntitiesImportCommand, IEntitiesExportCommand, IEntitiesDeleteParameters, IEntitiesDeleteCommand, IEntitiesDeleteResult, IEntitiesSampleDownloadCommand, IEntityUpsertByParameters as IEntitiesUpsertByParameters, IEntityUpsertByResult as IEntitiesUpsertByResult, IEntityUpsertByCommand as IEntitiesUpsertByCommand, } from "./commands";
+export * from "./cache";
+export { IEntityCreateCommand, IEntityUpdateCommand, IEntityUpsertCommand, IEntityDeleteCommand, IEntityVersionCommand, IEntitiesImportCommand, IEntitiesExportCommand, IEntitiesDeleteParameters, IEntitiesDeleteCommand, IEntitiesDeleteResult, IEntitiesParseCommand, IEntitiesSampleDownloadCommand, IEntityUpsertByParameters, IEntityUpsertByResult, IEntityUpsertByCommand, } from "./commands";
 export { SortingType, ClassType, EnumType } from "./common";
 export { IEntityManagerServiceRoot, IEntityManagerServiceCollection, } from "./configuration";
 export { ConnectorMode, ConnectorOptions, IEntityConnector } from "./connectors";
@@ -22,6 +22,7 @@ export { IEntityManager } from "./manager";
 export { IEntityMapper } from "./mappers";
 export * from "./media";
 export * from "./operations";
+export { EntitiesParseError, EntitiesParseInput, EntitiesParseInputFile, EntitiesParseResult, EntitiesParseResultItem, } from "./parse";
 export {} from "./pipelines";
 export { IEntitiesSearchQuery, IEntityGetQuery, IEntitiesQueryBuilder, IEntityExistsQuery, IEntitiesCountQuery, IEntityVersionsSearchQuery, } from "./queries";
 export { IReplicasConfiguration, ReplicationMode, ReplicaOptions, ReplicaConfiguration, IEntityReplicaDeleteManager, IEntityReplicaSyncManager, } from "./replication";

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

@@ -1,4 +1,4 @@
-import { IEntitiesDeleteCommand, IEntitiesDeleteParameters, IEntitiesExportCommand, IEntitiesImportCommand, IEntitiesSampleDownloadCommand, IEntityCreateCommand, IEntityDeleteCommand, IEntityUpdateCommand, IEntityUpsertByCommand, IEntityUpsertCommand, IEntityVersionCommand } from "./commands";
+import { IEntitiesDeleteCommand, IEntitiesDeleteParameters, IEntitiesExportCommand, IEntitiesImportCommand, IEntitiesParseCommand, IEntitiesSampleDownloadCommand, IEntityCreateCommand, IEntityDeleteCommand, IEntityUpdateCommand, IEntityUpsertByCommand, IEntityUpsertCommand, IEntityVersionCommand } from "./commands";
 import { SortingType } from "./common";
 import { IEntitiesCountQuery, IEntitiesFindQuery, IEntitiesSearchQuery, IEntityExistsQuery, IEntityGetQuery, IEntityVersionsSearchQuery } from "./queries";
 import { IEntitySearchParameters } from "./searchParameters";
@@ -17,6 +17,7 @@ export interface IEntityManager<TEntity, TEntityId, TEntityCreateData, TEntityUp
     get delete(): IEntityDeleteCommand<TEntity, TEntityId>;
     get deleteItems(): IEntitiesDeleteCommand<TEntity, TEntitiesDeleteParameters, TSorting>;
     get import(): IEntitiesImportCommand<TEntity>;
+    get parse(): IEntitiesParseCommand<TEntity>;
     get export(): IEntitiesExportCommand<TEntity, TEntitySearchParameters, TSorting, TCursor>;
     get sampleDownload(): IEntitiesSampleDownloadCommand<TEntity>;
     get versions(): IEntityVersionsSearchQuery<TEntity, TCursor>;

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

@@ -0,0 +1,24 @@
+/// <reference types="node" />
+import { EntitySerializationFormat, ImportEntry } from "./serializer";
+export type EntitiesParseInputFile = {
+    fileName: string;
+    content: Buffer;
+    contentType: string;
+};
+export type EntitiesParseError = {
+    fieldName: string;
+    errorType: string;
+};
+export type EntitiesParseResultItem<TItem> = {
+    isValid: boolean;
+    item: TItem;
+    errors: EntitiesParseError[];
+};
+export type EntitiesParseResult<TItem> = {
+    entries: ImportEntry<unknown, unknown>[];
+};
+export type EntitiesParseInput<TPayload> = {
+    format: EntitySerializationFormat;
+    file: EntitiesParseInputFile;
+    payload?: TPayload;
+};

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

@@ -1,12 +1,27 @@
 /// <reference types="node" />
+export type ImportEntryValidationError = {
+    errorCode: string;
+};
+export type ImportEntryValidationResult = {
+    isValid: boolean;
+    validationErrors: ImportEntryValidationError[];
+};
+export type EntitySerializerColumnParser = (value: any) => any;
+export type EntitySerializerColumnParseAction<TSheetItem> = (value: any, item: TSheetItem) => void;
+export type EntitySerializerColumnConverter<TSheetItem> = (value: any, item: TSheetItem) => any;
+export type EntitySerializerColumnValidator<TSheetItem> = {
+    key: string;
+    fn: (selector: (item: TSheetItem) => any) => ImportEntryValidationResult;
+};
 export type EntitySerializerColumnDefinition<TSheetItem> = {
     name: string;
     selector: keyof TSheetItem;
     colSpan?: number;
     sampleValue?: any;
-    parser?: (value: any) => any;
-    parseAction?: (value: any, item: TSheetItem) => void;
-    converter?: (value: any, item: TSheetItem) => any;
+    parser?: EntitySerializerColumnParser;
+    parseAction?: EntitySerializerColumnParseAction<TSheetItem>;
+    converter?: EntitySerializerColumnConverter<TSheetItem>;
+    validators?: EntitySerializerColumnValidator<TSheetItem>[];
     idColumn?: boolean;
 };
 export type EntitySerializerSheetDefinition<TSheetItem> = {
@@ -25,6 +40,8 @@ export declare enum EntitySerializationFormat {
 export type ImportEntry<TSheetItem, TEntityId> = {
     id?: TEntityId;
     item: TSheetItem;
+    rowIndex: number;
+    status: ImportEntryValidationResult;
 };
 export interface IEntitySerializer<TEntity, TEntityId, TEntitySearchParameters, TSheetItem, TPayload = unknown> {
     export(filters?: TEntitySearchParameters): Promise<TSheetItem[]>;

package/dist/esm/types/actions/parse.d.ts

@@ -0,0 +1,9 @@
+import { IEntitiesParseAction } from "../abstractions/actions";
+import { EntityServiceLocator } from "../providers/services";
+import { EntitiesParseInput } from "../abstractions/parse";
+export declare class EntitiesParseAction<TEntity> implements IEntitiesParseAction<TEntity> {
+    private readonly services;
+    private readonly logger;
+    constructor(services: EntityServiceLocator<TEntity, unknown>);
+    execute(input: EntitiesParseInput<unknown>): Promise<import("../abstractions/parse").EntitiesParseResult<unknown>>;
+}

package/dist/esm/types/base/serializer.d.ts

@@ -21,6 +21,7 @@ export declare abstract class EntitySerializer<TEntity, TEntityId, TEntitySearch
     protected abstract getDefinition(context: TContext): Promise<EntitySerializerSheetDefinition<TSheetItem>>;
     protected abstract loadEntities(filters?: TEntitySearchParameters): Promise<TEntity[]>;
     protected abstract convertToSheetItems(entities: TEntity[]): Promise<TSheetItem[]>;
+    protected validateSheetItem(item: TSheetItem, allItems: TSheetItem[], context: TContext): void;
     protected abstract importItem(item: TSheetItem, context: TContext, payload?: TPayload): Promise<EntityReference<TEntityId>>;
     protected getContext(): Promise<TContext>;
     private buildExportFile;

package/dist/esm/types/commands/parse.d.ts

@@ -0,0 +1,14 @@
+import { IEntitiesParseCommand } from "../abstractions/commands";
+import { EntityServiceLocator } from "../providers/services";
+import { EntitiesImportExportSettings } from "../abstractions";
+import { EntitiesParseInput, EntitiesParseResult } from "../abstractions/parse";
+export declare class EntitiesParseCommand<TEntity> implements IEntitiesParseCommand<TEntity> {
+    private readonly services;
+    private readonly settings;
+    constructor(services: EntityServiceLocator<TEntity, unknown>, settings: EntitiesImportExportSettings);
+    execute(input: EntitiesParseInput<unknown>): Promise<EntitiesParseResult<unknown>>;
+    private parseImportFile;
+    private uploadImportFile;
+    private buildAbsoluteBucketPath;
+    private get bucket();
+}

package/dist/esm/types/concrete/index.d.ts

@@ -1,5 +1,5 @@
-import { IEntitiesCountAction, IEntitiesDeleteAction, IEntitiesExportAction, IEntitiesImportAction, IEntitiesSampleDownloadAction, IEntitiesSearchAction, IEntityActions, IEntityCreateAction, IEntityDeleteAction, IEntityExistsAction, IEntityGetAction, IEntityUpdateAction, IEntityUpsertAction, IEntityVersionsSearchAction } from "../abstractions/actions";
-import { IEntitiesDeleteCommand, IEntitiesDeleteParameters, IEntitiesExportCommand, IEntitiesImportCommand, IEntitiesSampleDownloadCommand, IEntityUpsertByCommand, IEntityCreateCommand, IEntityDeleteCommand, IEntityUpdateCommand, IEntityUpsertCommand, IEntityVersionCommand } from "../abstractions/commands";
+import { IEntitiesCountAction, IEntitiesDeleteAction, IEntitiesExportAction, IEntitiesImportAction, IEntitiesParseAction, IEntitiesSampleDownloadAction, IEntitiesSearchAction, IEntityActions, IEntityCreateAction, IEntityDeleteAction, IEntityExistsAction, IEntityGetAction, IEntityUpdateAction, IEntityUpsertAction, IEntityVersionsSearchAction } from "../abstractions/actions";
+import { IEntitiesDeleteCommand, IEntitiesDeleteParameters, IEntitiesExportCommand, IEntitiesImportCommand, IEntitiesSampleDownloadCommand, IEntityUpsertByCommand, IEntityCreateCommand, IEntityDeleteCommand, IEntityUpdateCommand, IEntityUpsertCommand, IEntityVersionCommand, IEntitiesParseCommand } from "../abstractions/commands";
 import { SortingType } from "../abstractions/common";
 import { IEntityManager } from "../abstractions/manager";
 import { IEntitiesCountQuery, IEntitiesFindQuery, IEntitiesSearchQuery, IEntityExistsQuery, IEntityGetQuery, IEntityVersionsSearchQuery } from "../abstractions/queries";
@@ -23,6 +23,7 @@ export declare class EntityManager<TEntity, TEntityId, TEntityCreateData, TEntit
     get delete(): IEntityDeleteCommand<TEntity, TEntityId>;
     get export(): IEntitiesExportCommand<TEntity, TEntitySearchParameters, TSorting, TCursor>;
     get import(): IEntitiesImportCommand<TEntity>;
+    get parse(): IEntitiesParseCommand<TEntity>;
     get sampleDownload(): IEntitiesSampleDownloadCommand<TEntity>;
     get versions(): IEntityVersionsSearchQuery<TEntity, TCursor>;
 }
@@ -40,6 +41,7 @@ export declare class EntityActions<TEntity, TEntityId, TEntityCreateDto, TEntity
     get delete(): IEntityDeleteAction<TEntity, TEntityId>;
     get export(): IEntitiesExportAction<TEntity, TEntitySearchParameters, TSorting, TCursor>;
     get import(): IEntitiesImportAction<TEntity>;
+    get parse(): IEntitiesParseAction<TEntity>;
     get sampleDownload(): IEntitiesSampleDownloadAction<TEntity>;
     get versions(): IEntityVersionsSearchAction<TEntity, TEntityListItemDto, TCursor>;
 }

package/dist/esm/types/platforms/nest/__test__/server/app/foos/foo.controller.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="multer" />
 import { FooActions } from "./foo.actions";
-import { FooCreateDto, FooDto, FooExportRequest, FooExportResponse, FooImportRequest, FooSampleDownloadRequest, FooSampleDownloadResponse, FooSearchRequest, FooSearchResponse, FooUpdateDto, FooVersionsSearchRequest, FooVersionsSearchResponse } from "./foo.dto";
+import { FooCreateDto, FooDto, FooExportRequest, FooExportResponse, FooImportRequest, FooParseRequest, FooParseResponse, FooSampleDownloadRequest, FooSampleDownloadResponse, FooSearchRequest, FooSearchResponse, FooUpdateDto, FooVersionsSearchRequest, FooVersionsSearchResponse } from "./foo.dto";
 export declare class FooController {
     private readonly actions;
     constructor(actions: FooActions);
@@ -9,6 +9,7 @@ export declare class FooController {
     update(id: string, item: FooUpdateDto): Promise<FooDto>;
     delete(id: string): Promise<void>;
     search(request: FooSearchRequest): Promise<FooSearchResponse>;
+    parse(file: Express.Multer.File, request: FooParseRequest): Promise<FooParseResponse>;
     import(file: Express.Multer.File, request: FooImportRequest): Promise<void>;
     export(request: FooExportRequest): Promise<FooExportResponse>;
     sampleDownload(request: FooSampleDownloadRequest): Promise<FooSampleDownloadResponse>;

package/dist/esm/types/platforms/nest/__test__/server/app/foos/foo.dto.d.ts

@@ -1,5 +1,6 @@
 import { EntitySerializationFormat } from "../../../../../../abstractions";
 import { FooSearchParameters, FooSearchResults, FooVersionsSearchParameters, FooVersionsSearchResults } from "../../entities/foos/foo.types";
+import { EntityParseResult } from "../../../../models/parsing";
 export declare class FooProfile {
     name: string;
     age?: number;
@@ -29,6 +30,12 @@ export declare class FooSearchResponse extends FooSearchResults<FooListItemDto>
 export declare class FooImportRequest {
     format: EntitySerializationFormat;
 }
+export declare class FooParseRequest {
+    format: EntitySerializationFormat;
+}
+export declare class FooParseResponse {
+    entries: EntityParseResult[];
+}
 export declare class EntitiesExportOptions {
     format: EntitySerializationFormat;
 }

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

@@ -6,6 +6,7 @@ export * from "./infrastructure";
 export * from "./integrations";
 export * from "./ioc";
 export * from "./middlewares";
+export * from "./models";
 export * from "./pipelines";
 export * from "./plugins";
 export * from "./processors";

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

@@ -0,0 +1 @@
+export { EntityParseResult, EntityParseValidationError } from "./parsing";

package/dist/esm/types/platforms/nest/models/parsing.d.ts

@@ -0,0 +1,12 @@
+export declare class EntityParseValidationError {
+    errorCode: string;
+}
+export declare class EntityParseStatus {
+    isValid: boolean;
+    validationErrors: EntityParseValidationError[];
+}
+export declare class EntityParseResult {
+    rowIndex: number;
+    item: any;
+    status: EntityParseStatus;
+}

package/dist/esm/types/providers/{services.d.ts → services/entities-locator.d.ts}

@@ -1,75 +1,32 @@
-import { IAuthenticationContext, IAuthenticationContextProvider, IAuthenticationMiddleware, IBucketProvider, ICacheInstance, IEmailLogger, IEmailProvider, IEmailTemplateMiddleware, IEmailTemplatesCollection, IEntityFacets, IEntitySerializer, IEntitySnapshotService, IEntityVersioningProvider, IEventLog, IEventsTracker, IFileProvider, IFilesReferenceRepository, IMediaFolderRepository, IMediaProvider, IMediaReferenceRepository, IOperationLockService, ISecretsProvider } from "../abstractions";
-import { IEntitiesCountAction, IEntitiesDeleteAction, IEntitiesExportAction, IEntitiesImportAction, IEntitiesSampleDownloadAction, IEntitiesSearchAction, IEntityActions, IEntityCreateAction, IEntityDeleteAction, IEntityExistsAction, IEntityGetAction, IEntityUpdateAction, IEntityUpsertAction, IEntityVersionsSearchAction } from "../abstractions/actions";
-import { IEntityAdapter } from "../abstractions/adapters";
-import { IEntityAuthorizationMiddleware } from "../abstractions/authorization";
-import { IEntitiesDeleteCommand, IEntitiesDeleteParameters, IEntitiesExportCommand, IEntitiesImportCommand, IEntitiesSampleDownloadCommand, IEntityUpsertByCommand, IEntityCreateCommand, IEntityDeleteCommand, IEntityUpdateCommand, IEntityUpsertCommand, IEntityVersionCommand } from "../abstractions/commands";
-import { SortingType } from "../abstractions/common";
-import { IConnectorsConfiguration, IEntityConnectorDeleteManager, IEntityConnectorSyncManager } from "../abstractions/connectors";
-import { IEntityConverter } from "../abstractions/converters";
-import { IEntityEventsManager, IEventEmitter } from "../abstractions/events";
-import { IEntityManager } from "../abstractions/manager";
-import { IPipelinesController } from "../abstractions/pipelines";
-import { IEntitiesCountQuery, IEntitiesFindQuery, IEntitiesQueryBuilder, IEntitiesSearchQuery, IEntityExistsQuery, IEntityGetQuery, IEntityVersionsSearchQuery } from "../abstractions/queries";
-import { IEntityReplicaDeleteManager, IEntityReplicaSyncManager, IReplicasConfiguration } from "../abstractions/replication";
-import { IEntityRepository } from "../abstractions/repository";
-import { IEntitySearchParameters, ISearchFilters } from "../abstractions/searchParameters";
-import { EntityManagerSettings, IEntityConfiguration } from "../abstractions/settings";
-import { ServiceLocator } from "../ioc";
-export declare class EntityServiceLocator<TEntity, TEntityId> {
-    private readonly services;
-    private readonly entityName;
-    constructor(services: EntitiesServiceLocator, entityName: string);
-    getRootServices(): EntitiesServiceLocator;
-    resolveAuthenticationContextProvider<TAuthenticationContextProvider extends IAuthenticationContextProvider<TUserContext>, TUserContext>(): TAuthenticationContextProvider;
-    resolveEntityManager(): IEntityManager<TEntity, unknown, unknown, unknown, any, any, any, unknown, any>;
-    resolveEntityActions(): IEntityActions<TEntity, TEntityId, unknown, unknown, unknown, unknown, any, any, any, unknown, any>;
-    resolveRepository<TGetConditions, TFindCondition, TUpdateCondition, TDeleteCondition>(): IEntityRepository<TEntity, TEntityId, TGetConditions, TFindCondition, TUpdateCondition, TDeleteCondition>;
-    resolveEventsManager(): IEntityEventsManager<TEntity, TEntityId>;
-    resolveVersioningProvider(): IEntityVersioningProvider;
-    resolveEntityConfiguration(): IEntityConfiguration;
-    resolveReplicaSyncManager(): IEntityReplicaSyncManager<TEntity>;
-    resolveReplicaConfiguration(): IReplicasConfiguration<TEntity, TEntityId>;
-    resolveReplicaDeleteManager<TEntityId>(): IEntityReplicaDeleteManager<TEntity, TEntityId>;
-    resolveConnectorSyncManager(): IEntityConnectorSyncManager<TEntity>;
-    resolveConnectorDeleteManager<TEntityId>(): IEntityConnectorDeleteManager<TEntity, TEntityId>;
-    resolveConnectorsConfiguration(): IConnectorsConfiguration<TEntity>;
-    resolveConverter<TEntityDto, TListItemDto, TEntityCreateDto, TEntityUpdateDto>(): IEntityConverter<TEntity, TEntityDto, TListItemDto, TEntityCreateDto, TEntityUpdateDto> | undefined;
-    resolveSerializer(): IEntitySerializer<TEntity, TEntityId, unknown, unknown>;
-    resolveSnapshotService<TEntity, TEntityId>(): IEntitySnapshotService<TEntityId, unknown> | undefined;
-    resolveAdapter<TEntityCreateData, TEntityUpdateData>(): IEntityAdapter<TEntity, TEntityCreateData, TEntityUpdateData> | undefined;
-    resolveAuthorizationMiddleware<TAuthenticationContext extends IAuthenticationContext<TUserContext>, TUserContext>(): IEntityAuthorizationMiddleware<TEntity, TAuthenticationContext, TUserContext> | undefined;
-    resolveGetQuery<TEntityId>(): IEntityGetQuery<TEntity, TEntityId>;
-    resolveExistsQuery<TEntityFilters extends ISearchFilters>(): IEntityExistsQuery<TEntity, TEntityFilters>;
-    resolveCountQuery<TEntityFilters extends ISearchFilters>(): IEntitiesCountQuery<TEntity, TEntityFilters>;
-    resolveVersionsSearchQuery<TCursor>(): IEntityVersionsSearchQuery<TEntity, TCursor>;
-    resolveSearchQuery<TEntitySearchParameters extends IEntitySearchParameters<TEntity, TSorting, TCursor>, TSorting extends SortingType, TCursor, TFacets extends IEntityFacets>(): IEntitiesSearchQuery<TEntity, TEntitySearchParameters, TSorting, TCursor, TFacets>;
-    resolveFindQuery<TEntitySearchParameters extends IEntitySearchParameters<TEntity, TSorting, TCursor>, TSorting extends SortingType, TCursor>(): IEntitiesFindQuery<TEntity, TEntitySearchParameters, TSorting, TCursor>;
-    resolveCreateCommand<TEntityCreateData>(): IEntityCreateCommand<TEntity, TEntityId, TEntityCreateData>;
-    resolveUpdateCommand<TEntityUpdateData>(): IEntityUpdateCommand<TEntity, TEntityId, TEntityUpdateData>;
-    resolveUpsertCommand<TEntityUpdateData>(): IEntityUpsertCommand<TEntity, TEntityId, TEntityUpdateData>;
-    resolveUpsertByCommand<TEntityFilters extends ISearchFilters>(): IEntityUpsertByCommand<TEntity, TEntityFilters>;
-    resolveDeleteCommand<TEntityId>(): IEntityDeleteCommand<TEntity, TEntityId>;
-    resolveDeleteItemsCommand<TEntitiesDeleteParameters extends IEntitiesDeleteParameters<TSorting>, TSorting>(): IEntitiesDeleteCommand<TEntity, TEntitiesDeleteParameters, TSorting>;
-    resolveVersionCommand(): IEntityVersionCommand<TEntity, TEntityId>;
-    resolveSampleDownloadCommand(): IEntitiesSampleDownloadCommand<TEntity>;
-    resolveImportCommand(): IEntitiesImportCommand<TEntity>;
-    resolveExportCommand<TEntitySearchParameters extends IEntitySearchParameters<TEntity, TSorting, TCursor>, TSorting extends SortingType, TCursor>(): IEntitiesExportCommand<TEntity, TEntitySearchParameters, TSorting, TCursor>;
-    resolveGetAction<TEntityId, TEntityDto>(): IEntityGetAction<TEntity, TEntityId, TEntityDto>;
-    resolveExistsAction<TEntityFilters extends ISearchFilters>(): IEntityExistsAction<TEntity, TEntityFilters>;
-    resolveCountAction<TEntityFilters extends ISearchFilters>(): IEntitiesCountAction<TEntity, TEntityFilters>;
-    resolveSearchAction<TEntitySearchParameters extends IEntitySearchParameters<TEntity, TSorting, TCursor>, TEntityListItemDto, TSorting extends SortingType, TCursor, TFacets extends IEntityFacets>(): IEntitiesSearchAction<TEntity, TEntitySearchParameters, TEntityListItemDto, TSorting, TCursor, TFacets>;
-    resolveVersionsSearchAction<TEntityListItemDto, TCursor>(): IEntityVersionsSearchAction<TEntity, TEntityListItemDto, TCursor>;
-    resolveCreateAction<TEntityCreateData, TEntityDto>(): IEntityCreateAction<TEntity, TEntityCreateData, TEntityDto>;
-    resolveUpdateAction<TEntityUpdateData, TEntityDto>(): IEntityUpdateAction<TEntity, TEntityId, TEntityUpdateData, TEntityDto>;
-    resolveUpsertAction<TEntityUpdateData, TEntityDto>(): IEntityUpsertAction<TEntity, TEntityId, TEntityUpdateData, TEntityDto>;
-    resolveDeleteAction(): IEntityDeleteAction<TEntity, TEntityId>;
-    resolveDeleteItemsAction<TEntitiesDeleteParameters extends IEntitiesDeleteParameters<TSorting>, TSorting>(): IEntitiesDeleteAction<TEntity, TEntitiesDeleteParameters, TSorting>;
-    resolveImportAction(): IEntitiesImportAction<TEntity>;
-    resolveSampleDownloadAction(): IEntitiesSampleDownloadAction<TEntity>;
-    resolveExportAction<TEntitySearchParameters extends IEntitySearchParameters<TEntity, TSorting, TCursor>, TSorting extends SortingType, TCursor>(): IEntitiesExportAction<TEntity, TEntitySearchParameters, TSorting, TCursor>;
-    resolveQueryBuilder<TEntityId, TEntitySearchParameters extends IEntitySearchParameters<TEntity, TSorting, TCursor>, TSorting extends SortingType, TCursor, TFacets extends IEntityFacets, TUserContext>(): IEntitiesQueryBuilder<TEntity, TEntityId, TEntitySearchParameters, TSorting, TCursor, TFacets, TUserContext>;
-    getEntityName(): string;
-}
+import { IEntitiesCountAction, IEntitiesDeleteAction, IEntitiesExportAction, IEntitiesImportAction, IEntitiesParseAction, IEntitiesSampleDownloadAction, IEntitiesSearchAction, IEntityActions, IEntityCreateAction, IEntityDeleteAction, IEntityExistsAction, IEntityGetAction, IEntityUpdateAction, IEntityUpsertAction, IEntityVersionsSearchAction } from "../../abstractions/actions";
+import { IEntityAdapter } from "../../abstractions/adapters";
+import { IAuthenticationContext, IAuthenticationContextProvider, IAuthenticationMiddleware } from "../../abstractions/authentication";
+import { IEntityAuthorizationMiddleware } from "../../abstractions/authorization";
+import { IBucketProvider } from "../../abstractions/buckets";
+import { ICacheInstance } from "../../abstractions/cache";
+import { IEntitiesDeleteCommand, IEntitiesDeleteParameters, IEntitiesExportCommand, IEntitiesImportCommand, IEntitiesParseCommand, IEntitiesSampleDownloadCommand, IEntityCreateCommand, IEntityDeleteCommand, IEntityUpdateCommand, IEntityUpsertByCommand, IEntityUpsertCommand, IEntityVersionCommand } from "../../abstractions/commands";
+import { SortingType } from "../../abstractions/common";
+import { IConnectorsConfiguration, IEntityConnectorDeleteManager, IEntityConnectorSyncManager } from "../../abstractions/connectors";
+import { IEntityConverter } from "../../abstractions/converters";
+import { IEmailLogger, IEmailProvider, IEmailTemplateMiddleware, IEmailTemplatesCollection } from "../../abstractions/email";
+import { IEntityEventsManager, IEventEmitter } from "../../abstractions/events";
+import { IFileProvider, IFilesReferenceRepository } from "../../abstractions/files";
+import { IEntityManager } from "../../abstractions/manager";
+import { IMediaFolderRepository, IMediaProvider, IMediaReferenceRepository } from "../../abstractions/media";
+import { IOperationLockService } from "../../abstractions/operations";
+import { IPipelinesController } from "../../abstractions/pipelines";
+import { IEntitiesCountQuery, IEntitiesFindQuery, IEntitiesQueryBuilder, IEntitiesSearchQuery, IEntityExistsQuery, IEntityGetQuery, IEntityVersionsSearchQuery } from "../../abstractions/queries";
+import { IEntityReplicaDeleteManager, IEntityReplicaSyncManager, IReplicasConfiguration } from "../../abstractions/replication";
+import { IEntityRepository } from "../../abstractions/repository";
+import { IEntitySearchParameters, ISearchFilters } from "../../abstractions/searchParameters";
+import { IEntityFacets } from "../../abstractions/searchResults";
+import { ISecretsProvider } from "../../abstractions/secrets";
+import { IEntitySerializer } from "../../abstractions/serializer";
+import { EntityManagerSettings, IEntityConfiguration } from "../../abstractions/settings";
+import { IEntitySnapshotService } from "../../abstractions/snapshot";
+import { IEventLog, IEventsTracker } from "../../abstractions/tracking";
+import { IEntityVersioningProvider } from "../../abstractions/versioning";
+import { ServiceLocator } from "../../ioc";
 export declare class EntitiesServiceLocator {
     private readonly provider;
     constructor(provider: ServiceLocator);
@@ -180,6 +137,8 @@ export declare class EntitiesServiceLocator {
     registerExportCommand<TEntity, TEntitySearchParameters extends IEntitySearchParameters<TEntity, TSorting, TCursor>, TSorting extends SortingType, TCursor>(entityName: string, instance: IEntitiesExportCommand<TEntity, TEntitySearchParameters, TSorting, TCursor>): void;
     resolveImportCommand<TEntity>(entityName: string): IEntitiesImportCommand<TEntity>;
     registerImportCommand<TEntity>(entityName: string, instance: IEntitiesImportCommand<TEntity>): void;
+    resolveParseCommand<TEntity>(entityName: string): IEntitiesParseCommand<TEntity>;
+    registerParseCommand<TEntity>(entityName: string, instance: IEntitiesParseCommand<TEntity>): void;
     resolveSampleDownloadCommand<TEntity>(entityName: string): IEntitiesSampleDownloadCommand<TEntity>;
     registerSampleDownloadCommand<TEntity>(entityName: string, instance: IEntitiesSampleDownloadCommand<TEntity>): void;
     resolveGetAction<TEntity, TEntityId, TEntityDto>(entityName: string): IEntityGetAction<TEntity, TEntityId, TEntityDto>;
@@ -208,6 +167,8 @@ export declare class EntitiesServiceLocator {
     registerSampleDownloadAction<TEntity>(entityName: string, instance: IEntitiesSampleDownloadAction<TEntity>): void;
     resolveImportAction<TEntity>(entityName: string): IEntitiesImportAction<TEntity>;
     registerImportAction<TEntity>(entityName: string, instance: IEntitiesImportAction<TEntity>): void;
+    resolveParseAction<TEntity>(entityName: string): IEntitiesParseAction<TEntity>;
+    registerParseAction<TEntity>(entityName: string, instance: IEntitiesParseAction<TEntity>): void;
     resolveQueryBuilder<TEntity, TEntityId, TEntitySearchParameters extends IEntitySearchParameters<TEntity, TSorting, TCursor>, TSorting extends SortingType, TCursor, TFacets extends IEntityFacets, TUserContext>(entityName: string): IEntitiesQueryBuilder<TEntity, TEntityId, TEntitySearchParameters, TSorting, TCursor, TFacets, TUserContext>;
     registerQueryBuilder<TEntity, TEntityId, TEntitySearchParameters extends IEntitySearchParameters<TEntity, TSorting, TCursor>, TSorting extends SortingType, TCursor, TFacets extends IEntityFacets, TUserContext>(entityName: string, instance: IEntitiesQueryBuilder<TEntity, TEntityId, TEntitySearchParameters, TSorting, TCursor, TFacets, TUserContext>): void;
 }

package/dist/esm/types/providers/services/entity-locator.d.ts

@@ -0,0 +1,73 @@
+import { IAuthenticationContext, IAuthenticationContextProvider, IEntityFacets, IEntitySerializer, IEntitySnapshotService, IEntityVersioningProvider } from "../../abstractions";
+import { IEntitiesCountAction, IEntitiesDeleteAction, IEntitiesExportAction, IEntitiesImportAction, IEntitiesParseAction, IEntitiesSampleDownloadAction, IEntitiesSearchAction, IEntityActions, IEntityCreateAction, IEntityDeleteAction, IEntityExistsAction, IEntityGetAction, IEntityUpdateAction, IEntityUpsertAction } from "../../abstractions/actions";
+import { IEntityAdapter } from "../../abstractions/adapters";
+import { IEntityAuthorizationMiddleware } from "../../abstractions/authorization";
+import { IEntitiesDeleteCommand, IEntitiesDeleteParameters, IEntitiesExportCommand, IEntitiesImportCommand, IEntitiesSampleDownloadCommand, IEntityUpsertByCommand, IEntityCreateCommand, IEntityDeleteCommand, IEntityUpdateCommand, IEntityUpsertCommand, IEntityVersionCommand, IEntitiesParseCommand } from "../../abstractions/commands";
+import { SortingType } from "../../abstractions/common";
+import { IConnectorsConfiguration, IEntityConnectorDeleteManager, IEntityConnectorSyncManager } from "../../abstractions/connectors";
+import { IEntityConverter } from "../../abstractions/converters";
+import { IEntityEventsManager } from "../../abstractions/events";
+import { IEntityManager } from "../../abstractions/manager";
+import { IEntitiesCountQuery, IEntitiesFindQuery, IEntitiesQueryBuilder, IEntitiesSearchQuery, IEntityExistsQuery, IEntityGetQuery, IEntityVersionsSearchQuery } from "../../abstractions/queries";
+import { IEntityReplicaDeleteManager, IEntityReplicaSyncManager, IReplicasConfiguration } from "../../abstractions/replication";
+import { IEntityRepository } from "../../abstractions/repository";
+import { IEntitySearchParameters, ISearchFilters } from "../../abstractions/searchParameters";
+import { IEntityConfiguration } from "../../abstractions/settings";
+import { EntitiesServiceLocator } from "./entities-locator";
+export declare class EntityServiceLocator<TEntity, TEntityId> {
+    private readonly services;
+    private readonly entityName;
+    constructor(services: EntitiesServiceLocator, entityName: string);
+    getRootServices(): EntitiesServiceLocator;
+    resolveAuthenticationContextProvider<TAuthenticationContextProvider extends IAuthenticationContextProvider<TUserContext>, TUserContext>(): TAuthenticationContextProvider;
+    resolveEntityManager(): IEntityManager<TEntity, unknown, unknown, unknown, any, any, any, unknown, any>;
+    resolveEntityActions(): IEntityActions<TEntity, TEntityId, unknown, unknown, unknown, unknown, any, any, any, unknown, any>;
+    resolveRepository<TGetConditions, TFindCondition, TUpdateCondition, TDeleteCondition>(): IEntityRepository<TEntity, TEntityId, TGetConditions, TFindCondition, TUpdateCondition, TDeleteCondition>;
+    resolveEventsManager(): IEntityEventsManager<TEntity, TEntityId>;
+    resolveVersioningProvider(): IEntityVersioningProvider;
+    resolveEntityConfiguration(): IEntityConfiguration;
+    resolveReplicaSyncManager(): IEntityReplicaSyncManager<TEntity>;
+    resolveReplicaConfiguration(): IReplicasConfiguration<TEntity, TEntityId>;
+    resolveReplicaDeleteManager<TEntityId>(): IEntityReplicaDeleteManager<TEntity, TEntityId>;
+    resolveConnectorSyncManager(): IEntityConnectorSyncManager<TEntity>;
+    resolveConnectorDeleteManager<TEntityId>(): IEntityConnectorDeleteManager<TEntity, TEntityId>;
+    resolveConnectorsConfiguration(): IConnectorsConfiguration<TEntity>;
+    resolveConverter<TEntityDto, TListItemDto, TEntityCreateDto, TEntityUpdateDto>(): IEntityConverter<TEntity, TEntityDto, TListItemDto, TEntityCreateDto, TEntityUpdateDto> | undefined;
+    resolveSerializer(): IEntitySerializer<TEntity, TEntityId, unknown, unknown>;
+    resolveSnapshotService<TEntity, TEntityId>(): IEntitySnapshotService<TEntityId, unknown> | undefined;
+    resolveAdapter<TEntityCreateData, TEntityUpdateData>(): IEntityAdapter<TEntity, TEntityCreateData, TEntityUpdateData> | undefined;
+    resolveAuthorizationMiddleware<TAuthenticationContext extends IAuthenticationContext<TUserContext>, TUserContext>(): IEntityAuthorizationMiddleware<TEntity, TAuthenticationContext, TUserContext> | undefined;
+    resolveGetQuery<TEntityId>(): IEntityGetQuery<TEntity, TEntityId>;
+    resolveExistsQuery<TEntityFilters extends ISearchFilters>(): IEntityExistsQuery<TEntity, TEntityFilters>;
+    resolveCountQuery<TEntityFilters extends ISearchFilters>(): IEntitiesCountQuery<TEntity, TEntityFilters>;
+    resolveVersionsSearchQuery<TCursor>(): IEntityVersionsSearchQuery<TEntity, TCursor>;
+    resolveSearchQuery<TEntitySearchParameters extends IEntitySearchParameters<TEntity, TSorting, TCursor>, TSorting extends SortingType, TCursor, TFacets extends IEntityFacets>(): IEntitiesSearchQuery<TEntity, TEntitySearchParameters, TSorting, TCursor, TFacets>;
+    resolveFindQuery<TEntitySearchParameters extends IEntitySearchParameters<TEntity, TSorting, TCursor>, TSorting extends SortingType, TCursor>(): IEntitiesFindQuery<TEntity, TEntitySearchParameters, TSorting, TCursor>;
+    resolveCreateCommand<TEntityCreateData>(): IEntityCreateCommand<TEntity, TEntityId, TEntityCreateData>;
+    resolveUpdateCommand<TEntityUpdateData>(): IEntityUpdateCommand<TEntity, TEntityId, TEntityUpdateData>;
+    resolveUpsertCommand<TEntityUpdateData>(): IEntityUpsertCommand<TEntity, TEntityId, TEntityUpdateData>;
+    resolveUpsertByCommand<TEntityFilters extends ISearchFilters>(): IEntityUpsertByCommand<TEntity, TEntityFilters>;
+    resolveDeleteCommand<TEntityId>(): IEntityDeleteCommand<TEntity, TEntityId>;
+    resolveDeleteItemsCommand<TEntitiesDeleteParameters extends IEntitiesDeleteParameters<TSorting>, TSorting>(): IEntitiesDeleteCommand<TEntity, TEntitiesDeleteParameters, TSorting>;
+    resolveVersionCommand(): IEntityVersionCommand<TEntity, TEntityId>;
+    resolveSampleDownloadCommand(): IEntitiesSampleDownloadCommand<TEntity>;
+    resolveImportCommand(): IEntitiesImportCommand<TEntity>;
+    resolveParseCommand(): IEntitiesParseCommand<TEntity>;
+    resolveExportCommand<TEntitySearchParameters extends IEntitySearchParameters<TEntity, TSorting, TCursor>, TSorting extends SortingType, TCursor>(): IEntitiesExportCommand<TEntity, TEntitySearchParameters, TSorting, TCursor>;
+    resolveGetAction<TEntityId, TEntityDto>(): IEntityGetAction<TEntity, TEntityId, TEntityDto>;
+    resolveExistsAction<TEntityFilters extends ISearchFilters>(): IEntityExistsAction<TEntity, TEntityFilters>;
+    resolveCountAction<TEntityFilters extends ISearchFilters>(): IEntitiesCountAction<TEntity, TEntityFilters>;
+    resolveSearchAction<TEntitySearchParameters extends IEntitySearchParameters<TEntity, TSorting, TCursor>, TEntityListItemDto, TSorting extends SortingType, TCursor, TFacets extends IEntityFacets>(): IEntitiesSearchAction<TEntity, TEntitySearchParameters, TEntityListItemDto, TSorting, TCursor, TFacets>;
+    resolveVersionsSearchAction<TEntityListItemDto, TCursor>(): import("../../abstractions").IEntityVersionsSearchAction<TEntity, TEntityListItemDto, TCursor>;
+    resolveCreateAction<TEntityCreateData, TEntityDto>(): IEntityCreateAction<TEntity, TEntityCreateData, TEntityDto>;
+    resolveUpdateAction<TEntityUpdateData, TEntityDto>(): IEntityUpdateAction<TEntity, TEntityId, TEntityUpdateData, TEntityDto>;
+    resolveUpsertAction<TEntityUpdateData, TEntityDto>(): IEntityUpsertAction<TEntity, TEntityId, TEntityUpdateData, TEntityDto>;
+    resolveDeleteAction(): IEntityDeleteAction<TEntity, TEntityId>;
+    resolveDeleteItemsAction<TEntitiesDeleteParameters extends IEntitiesDeleteParameters<TSorting>, TSorting>(): IEntitiesDeleteAction<TEntity, TEntitiesDeleteParameters, TSorting>;
+    resolveImportAction(): IEntitiesImportAction<TEntity>;
+    resolveParseAction(): IEntitiesParseAction<TEntity>;
+    resolveSampleDownloadAction(): IEntitiesSampleDownloadAction<TEntity>;
+    resolveExportAction<TEntitySearchParameters extends IEntitySearchParameters<TEntity, TSorting, TCursor>, TSorting extends SortingType, TCursor>(): IEntitiesExportAction<TEntity, TEntitySearchParameters, TSorting, TCursor>;
+    resolveQueryBuilder<TEntityId, TEntitySearchParameters extends IEntitySearchParameters<TEntity, TSorting, TCursor>, TSorting extends SortingType, TCursor, TFacets extends IEntityFacets, TUserContext>(): IEntitiesQueryBuilder<TEntity, TEntityId, TEntitySearchParameters, TSorting, TCursor, TFacets, TUserContext>;
+    getEntityName(): string;
+}

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

@@ -0,0 +1,2 @@
+export { EntitiesServiceLocator } from "./entities-locator";
+export { EntityServiceLocator } from "./entity-locator";

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

@@ -11,6 +11,7 @@ export declare const EntityServices: {
         IEntityDeleteAction: string;
         IEntityMergeAction: string;
         IEntitiesExportAction: string;
+        IEntitiesParseAction: string;
         IEntitiesImportAction: string;
         IEntitiesSampleDownloadAction: string;
         IEntityVersionsSearchAction: string;
@@ -29,6 +30,7 @@ export declare const EntityServices: {
         IEntitiesDeleteCommand: string;
         IEntitiesExportCommand: string;
         IEntitiesImportCommand: string;
+        IEntitiesParseCommand: string;
         IEntitiesSampleDownloadCommand: string;
     };
     Converters: {