@punks/backend-entity-manager 0.0.255 → 0.0.257

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

@@ -43,3 +43,13 @@ export interface IEntitiesImportCommand<TEntity> {
 export interface IEntitiesSampleDownloadCommand<TEntity> {
     execute(input: EntitiesSampleDownloadOptions): Promise<EntitiesSampleDownloadResult>;
 }
+export interface IEntityUpsertByParameters<TEntity, TEntityFilters extends ISearchFilters> {
+    filter: TEntityFilters;
+    data: Partial<Omit<TEntity, "id">>;
+}
+export interface IEntityUpsertByResult {
+    id: string;
+}
+export interface IEntityUpsertByCommand<TEntity, TEntityFilters extends ISearchFilters> {
+    execute(params: IEntityUpsertByParameters<TEntity, TEntityFilters>): Promise<IEntityUpsertByResult>;
+}

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

@@ -5,7 +5,7 @@ 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, } from "./commands";
+export { IEntityCreateCommand, IEntityUpdateCommand, IEntityUpsertCommand, IEntityDeleteCommand, IEntityVersionCommand, IEntitiesImportCommand, IEntitiesExportCommand, IEntitiesDeleteParameters, IEntitiesDeleteCommand, IEntitiesDeleteResult, IEntitiesSampleDownloadCommand, IEntityUpsertByParameters as IEntitiesUpsertByParameters, IEntityUpsertByResult as IEntitiesUpsertByResult, IEntityUpsertByCommand as IEntitiesUpsertByCommand, } from "./commands";
 export { SortingType, ClassType, EnumType } from "./common";
 export { IEntityManagerServiceRoot, IEntityManagerServiceCollection, } from "./configuration";
 export { ConnectorMode, ConnectorOptions, IEntityConnector } from "./connectors";

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

@@ -1,4 +1,4 @@
-import { IEntitiesDeleteCommand, IEntitiesDeleteParameters, IEntitiesExportCommand, IEntitiesImportCommand, IEntitiesSampleDownloadCommand, IEntityCreateCommand, IEntityDeleteCommand, IEntityUpdateCommand, IEntityUpsertCommand, IEntityVersionCommand } from "./commands";
+import { IEntitiesDeleteCommand, IEntitiesDeleteParameters, IEntitiesExportCommand, IEntitiesImportCommand, 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";
@@ -13,6 +13,7 @@ export interface IEntityManager<TEntity, TEntityId, TEntityCreateData, TEntityUp
     get create(): IEntityCreateCommand<TEntity, TEntityId, TEntityCreateData>;
     get update(): IEntityUpdateCommand<TEntity, TEntityId, TEntityUpdateData>;
     get upsert(): IEntityUpsertCommand<TEntity, TEntityId, TEntityUpdateData>;
+    get upsertBy(): IEntityUpsertByCommand<TEntity, TEntitySearchParameters>;
     get delete(): IEntityDeleteCommand<TEntity, TEntityId>;
     get deleteItems(): IEntitiesDeleteCommand<TEntity, TEntitiesDeleteParameters, TSorting>;
     get import(): IEntitiesImportCommand<TEntity>;

package/dist/cjs/types/commands/upsertBy.d.ts

@@ -0,0 +1,8 @@
+import { ISearchFilters } from "../abstractions";
+import { IEntityUpsertByCommand, IEntityUpsertByParameters, IEntityUpsertByResult } from "../abstractions/commands";
+import { EntityServiceLocator } from "../providers/services";
+export declare class EntitiesUpsertByCommand<TEntity, TEntityFilters extends ISearchFilters> implements IEntityUpsertByCommand<TEntity, TEntityFilters> {
+    private readonly services;
+    constructor(services: EntityServiceLocator<TEntity, unknown>);
+    execute(params: IEntityUpsertByParameters<TEntity, TEntityFilters>): Promise<IEntityUpsertByResult>;
+}

package/dist/cjs/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, IEntityCreateCommand, IEntityDeleteCommand, IEntityUpdateCommand, IEntityUpsertCommand, IEntityVersionCommand } from "../abstractions/commands";
+import { IEntitiesDeleteCommand, IEntitiesDeleteParameters, IEntitiesExportCommand, IEntitiesImportCommand, IEntitiesSampleDownloadCommand, IEntityUpsertByCommand, IEntityCreateCommand, IEntityDeleteCommand, IEntityUpdateCommand, IEntityUpsertCommand, IEntityVersionCommand } from "../abstractions/commands";
 import { SortingType } from "../abstractions/common";
 import { IEntityManager } from "../abstractions/manager";
 import { IEntitiesCountQuery, IEntitiesFindQuery, IEntitiesSearchQuery, IEntityExistsQuery, IEntityGetQuery, IEntityVersionsSearchQuery } from "../abstractions/queries";
@@ -19,6 +19,7 @@ export declare class EntityManager<TEntity, TEntityId, TEntityCreateData, TEntit
     get create(): IEntityCreateCommand<TEntity, TEntityId, TEntityCreateData>;
     get update(): IEntityUpdateCommand<TEntity, TEntityId, TEntityUpdateData>;
     get upsert(): IEntityUpsertCommand<TEntity, TEntityId, TEntityUpdateData>;
+    get upsertBy(): IEntityUpsertByCommand<TEntity, TEntitySearchParameters>;
     get delete(): IEntityDeleteCommand<TEntity, TEntityId>;
     get export(): IEntitiesExportCommand<TEntity, TEntitySearchParameters, TSorting, TCursor>;
     get import(): IEntitiesImportCommand<TEntity>;

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

@@ -2,7 +2,7 @@ import { IAuthenticationContext, IAuthenticationContextProvider, IAuthentication
 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, IEntityCreateCommand, IEntityDeleteCommand, IEntityUpdateCommand, IEntityUpsertCommand, IEntityVersionCommand } from "../abstractions/commands";
+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";
@@ -47,6 +47,7 @@ export declare class EntityServiceLocator<TEntity, TEntityId> {
     resolveCreateCommand<TEntityCreateData>(): IEntityCreateCommand<TEntity, TEntityId, TEntityCreateData>;
     resolveUpdateCommand<TEntityUpdateData>(): IEntityUpdateCommand<TEntity, TEntityId, TEntityUpdateData>;
     resolveUpsertCommand<TEntityUpdateData>(): IEntityUpsertCommand<TEntity, TEntityId, TEntityUpdateData>;
+    resolveUpsertByCommand<TEntitySearchParameters extends IEntitySearchParameters<TEntity, unknown, unknown>>(): IEntityUpsertByCommand<TEntity, TEntitySearchParameters>;
     resolveDeleteCommand<TEntityId>(): IEntityDeleteCommand<TEntity, TEntityId>;
     resolveDeleteItemsCommand<TEntitiesDeleteParameters extends IEntitiesDeleteParameters<TSorting>, TSorting>(): IEntitiesDeleteCommand<TEntity, TEntitiesDeleteParameters, TSorting>;
     resolveVersionCommand(): IEntityVersionCommand<TEntity, TEntityId>;
@@ -163,6 +164,8 @@ export declare class EntitiesServiceLocator {
     registerUpdateCommand<TEntity, TEntityId, TEntityUpdateData>(entityName: string, instance: IEntityUpdateCommand<TEntity, TEntityId, TEntityUpdateData>): void;
     resolveUpsertCommand<TEntity, TEntityId, TEntityUpdateData>(entityName: string): IEntityUpsertCommand<TEntity, TEntityId, TEntityUpdateData>;
     registerUpsertCommand<TEntity, TEntityId, TEntityUpdateData>(entityName: string, instance: IEntityUpsertCommand<TEntity, TEntityId, TEntityUpdateData>): void;
+    registerUpsertByCommand<TEntity, TEntitySearchParameters extends IEntitySearchParameters<TEntity, unknown, unknown>>(entityName: string, instance: IEntityUpsertByCommand<TEntity, TEntitySearchParameters>): void;
+    resolveUpsertByCommand<TEntity, TEntitySearchParameters extends IEntitySearchParameters<TEntity, unknown, unknown>>(entityName: string): IEntityUpsertByCommand<TEntity, TEntitySearchParameters>;
     resolveDeleteItemsCommand<TEntity, TEntitiesDeleteParameters extends IEntitiesDeleteParameters<TSorting>, TSorting>(entityName: string): IEntitiesDeleteCommand<TEntity, TEntitiesDeleteParameters, TSorting>;
     registerDeleteItemsCommand<TEntity, TEntitiesDeleteParameters extends IEntitiesDeleteParameters<TSorting>, TSorting>(entityName: string, instance: IEntitiesDeleteCommand<TEntity, TEntitiesDeleteParameters, TSorting>): void;
     resolveDeleteCommand<TEntity, TEntityId>(entityName: string): IEntityDeleteCommand<TEntity, TEntityId>;

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

@@ -22,6 +22,7 @@ export declare const EntityServices: {
         IEntityCreateCommand: string;
         IEntityUpdateCommand: string;
         IEntityUpsertCommand: string;
+        IEntityUpsertByCommand: string;
         IEntityMergeCommand: string;
         IEntityDeleteCommand: string;
         IEntityVersionCommand: string;

package/dist/esm/index.js

@@ -992,6 +992,36 @@ class EntityUpsertCommand {
     }
 }
 
+class EntitiesUpsertByCommand {
+    constructor(services) {
+        this.services = services;
+    }
+    async execute(params) {
+        const { items } = await this.services.resolveSearchQuery().execute({
+            filters: params.filter,
+        });
+        if (items.length === 0) {
+            const createdItem = await this.services
+                .resolveCreateCommand()
+                .execute(params.data);
+            // todo: parametrize id field
+            const id = createdItem.id;
+            return {
+                id,
+            };
+        }
+        if (items.length > 1) {
+            throw new Error("Multiple items found");
+        }
+        // todo: parametrize id field
+        const id = items[0].id;
+        await this.services.resolveUpdateCommand().execute(id, params.data);
+        return {
+            id,
+        };
+    }
+}
+
 class EntityVersionCommand {
     constructor(services) {
         this.services = services;
@@ -1049,6 +1079,9 @@ class EntityManager {
     get upsert() {
         return this.services.resolveUpsertCommand();
     }
+    get upsertBy() {
+        return this.services.resolveUpsertByCommand();
+    }
     get delete() {
         return this.services.resolveDeleteCommand();
     }
@@ -1200,6 +1233,7 @@ const EntityServices = {
         IEntityCreateCommand: "IEntityCreateCommand",
         IEntityUpdateCommand: "IEntityUpdateCommand",
         IEntityUpsertCommand: "IEntityUpsertCommand",
+        IEntityUpsertByCommand: "IEntityUpsertByCommand",
         IEntityMergeCommand: "IEntityMergeCommand",
         IEntityDeleteCommand: "IEntityDeleteCommand",
         IEntityVersionCommand: "IEntityVersionCommand",
@@ -1371,6 +1405,9 @@ class EntityServiceLocator {
     resolveUpsertCommand() {
         return this.services.resolveUpsertCommand(this.entityName);
     }
+    resolveUpsertByCommand() {
+        return this.services.resolveUpsertByCommand(this.entityName);
+    }
     resolveDeleteCommand() {
         return this.services.resolveDeleteCommand(this.entityName);
     }
@@ -1736,6 +1773,12 @@ class EntitiesServiceLocator {
     registerUpsertCommand(entityName, instance) {
         this.provider.registerEntityService(EntityServices.Commands.IEntityUpsertCommand, entityName, instance);
     }
+    registerUpsertByCommand(entityName, instance) {
+        this.provider.registerEntityService(EntityServices.Commands.IEntityUpsertByCommand, entityName, instance);
+    }
+    resolveUpsertByCommand(entityName) {
+        return this.provider.resolveEntityService(EntityServices.Commands.IEntityUpsertByCommand, entityName);
+    }
     resolveDeleteItemsCommand(entityName) {
         return this.provider.resolveEntityService(EntityServices.Commands.IEntitiesDeleteCommand, entityName);
     }
@@ -2420,6 +2463,7 @@ class EntityManagerServiceCollection {
         return this;
     }
     mapUpdate() {
+        this.locator.registerUpsertByCommand(this.entityName, new EntitiesUpsertByCommand(this.resolver));
         this.locator.registerUpsertCommand(this.entityName, new EntityUpsertCommand(this.resolver));
         this.locator.registerUpsertAction(this.entityName, new EntityUpsertAction(this.resolver));
         this.locator.registerUpdateCommand(this.entityName, new EntityUpdateCommand(this.resolver));