ngx-material-entity 15.1.5 → 15.1.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ngx-material-entity",
-  "version": "15.1.5",
+  "version": "15.1.7",
   "license": "MIT",
   "keywords": [
     "angular",

package/public-api.d.ts

@@ -40,6 +40,8 @@ export * from './decorators/object/object-decorator.data';
 export * from './decorators/object/object.decorator';
 export * from './decorators/references-many/references-many-decorator.data';
 export * from './decorators/references-many/references-many.decorator';
+export * from './decorators/has-many/has-many-decorator.data';
+export * from './decorators/has-many/has-many.decorator';
 export * from './decorators/string/string-decorator.data';
 export * from './decorators/string/string.decorator';
 export * from './services/entity.service';

package/services/entity.service.d.ts

@@ -55,9 +55,11 @@ export declare abstract class EntityService<EntityType extends BaseEntityType<En
      *
      * @param entity - The data of the entity to create.
      * All values that should be omitted will be removed from it inside this method.
+     * @param baseUrl - The base url to send the post request to.
+     * This can be used if you want to create an entity belonging to another, like "customers/{id}/invoices".
      * @returns A Promise of the created entity.
      */
-    create(entity: EntityType): Promise<EntityType>;
+    create(entity: EntityType, baseUrl?: string): Promise<EntityType>;
     /**
      * Imports everything from the provided json file.
      *
@@ -73,22 +75,27 @@ export declare abstract class EntityService<EntityType extends BaseEntityType<En
      * @param body - The body Of the request.
      * @param filePropertyKeys - All property keys that are files and need to be added to the form data.
      * @param entity - The entity to create. This is needed in addition to the body because the body doesn't contain any metadata.
+     * @param baseUrl - The base url to send the post request to.
+     * This can be used if you want to create an entity belonging to another, like "customers/{id}/invoices".
      * @returns The created entity from the server.
      */
-    protected createWithFormData(body: Partial<EntityType>, filePropertyKeys: (keyof EntityType)[], entity: EntityType): Promise<EntityType>;
+    protected createWithFormData(body: Partial<EntityType>, filePropertyKeys: (keyof EntityType)[], entity: EntityType, baseUrl?: string): Promise<EntityType>;
     /**
      * Creates the entity with a normal json body in contrast to creating it with form data when the entity contains files.
      *
      * @param body - The body Of the request.
+     * @param baseUrl - The base url to send the post request to.
+     * This can be used if you want to create an entity belonging to another, like "customers/{id}/invoices".
      * @returns The created entity from the server.
      */
-    protected createWithJson(body: Partial<EntityType>): Promise<EntityType>;
+    protected createWithJson(body: Partial<EntityType>, baseUrl?: string): Promise<EntityType>;
     /**
      * Gets all existing entities and pushes them to the entities array.
      *
+     * @param baseUrl - The base url for the request. Defaults to the baseUrl on the service.
      * @returns A Promise of all received Entities.
      */
-    read(): Promise<EntityType[]>;
+    read(baseUrl?: string): Promise<EntityType[]>;
     /**
      * Tries to find an entity with the given id.
      *
@@ -105,6 +112,14 @@ export declare abstract class EntityService<EntityType extends BaseEntityType<En
      * It Is used to get changed values and only update them instead of sending the whole entity data.
      */
     update(entity: EntityType, entityPriorChanges: EntityType): Promise<void>;
+    /**
+     * Builds the update request body from the given entity before and after its changes.
+     *
+     * @param entity - The entity with changed values.
+     * @param entityPriorChanges - The entity before any changes.
+     * @returns A partial of only the changed values.
+     */
+    protected entityToUpdateRequestBody(entity: EntityType, entityPriorChanges: EntityType): Promise<Partial<EntityType>>;
     /**
      * Updates the entity with form data when the entity contains files in contrast to creating it with a normal json body.
      * All file values are stored inside their respective property key and their name.

package/utilities/entity.utilities.d.ts

@@ -55,6 +55,22 @@ export declare abstract class EntityUtilities {
      * @returns The properties which should be left out for creating a new Entity.
      */
     static getOmitForCreate<EntityType extends BaseEntityType<EntityType>>(entity: EntityType): (keyof EntityType)[];
+    /**
+     * Returns the given entity without the values that should be omitted for creation.
+     *
+     * @param entity - The entity with all its values.
+     * @returns The reduced entity object.
+     */
+    static getWithoutOmitCreateValues<EntityType extends BaseEntityType<EntityType>>(entity: EntityType): Partial<EntityType>;
+    /**
+     * Returns the given entity without the values that should be omitted for updating.
+     * This also handles omitting keys for @object or @array values and removes values that haven't been changed by default.
+     *
+     * @param entity - The entity with all its values.
+     * @param entityPriorChanges - The entity before any changes were applied.
+     * @returns The reduced entity object.
+     */
+    static getWithoutOmitUpdateValues<EntityType extends BaseEntityType<EntityType>>(entity: EntityType, entityPriorChanges: EntityType): Promise<Partial<EntityType>>;
     /**
      * Gets all properties on the given entity which are files.
      *
@@ -138,7 +154,6 @@ export declare abstract class EntityUtilities {
      * @param entityPriorChanges - The second entity to compare.
      * @returns The difference between the two Entities in form of a Partial.
      */
-    static difference<EntityType extends BaseEntityType<EntityType>>(entity: EntityType, entityPriorChanges: EntityType): Promise<Partial<EntityType>>;
     /**
      * Checks if two given values are equal.
      * It uses the isEqual method from LodashUtilities and extends it with functionality regarding Dates.

package/components/input/add-array-item-dialog-data.builder.d.ts

@@ -1,22 +0,0 @@
-import { NgModel } from '@angular/forms';
-import { BaseBuilder } from '../../classes/base.builder';
-import { BaseEntityType } from '../../classes/entity.model';
-import { CreateDialogDataInternal } from '../table/create-dialog/create-dialog-data.builder';
-import { AddArrayItemDialogData } from './add-array-item-dialog-data';
-/**
- * The internal AddArrayItemDialogData. Requires all default values the user can leave out.
- */
-export declare class AddArrayItemDialogDataInternal<EntityType extends BaseEntityType<EntityType>> implements AddArrayItemDialogData<EntityType> {
-    entity: EntityType;
-    createDialogData: CreateDialogDataInternal;
-    getValidationErrorMessage: (model: NgModel) => string;
-    constructor(entity: EntityType, createDialogData: CreateDialogDataInternal, getValidationErrorMessage: (model: NgModel) => string);
-}
-/**
- * The Builder for the AddArrayItemDialogData. Sets default values.
- */
-export declare class AddArrayItemDialogDataBuilder<EntityType extends BaseEntityType<EntityType>> extends BaseBuilder<AddArrayItemDialogDataInternal<EntityType>, AddArrayItemDialogData<EntityType>> {
-    protected readonly defaultGetValidationErrorMessage: (model: NgModel) => string;
-    constructor(data: AddArrayItemDialogData<EntityType>, defaultGetValidationErrorMessage: (model: NgModel) => string);
-    protected generateBaseData(data: AddArrayItemDialogData<EntityType>): AddArrayItemDialogDataInternal<EntityType>;
-}

package/components/input/add-array-item-dialog-data.d.ts

@@ -1,20 +0,0 @@
-import { NgModel } from '@angular/forms';
-import { BaseEntityType } from '../../classes/entity.model';
-import { CreateDialogData } from '../table/table-data';
-/**
- * The configuration options for the dialog that adds items to an array.
- */
-export interface AddArrayItemDialogData<EntityType extends BaseEntityType<EntityType>> {
-    /**
-     * An empty entity that is used as the data model.
-     */
-    entity: EntityType;
-    /**
-     * The info of the generic create-dialog.
-     */
-    createDialogData?: CreateDialogData;
-    /**
-     * A custom function to generate the error-message for invalid inputs.
-     */
-    getValidationErrorMessage?: (model: NgModel) => string;
-}

package/esm2020/components/input/add-array-item-dialog-data.builder.mjs

@@ -1,38 +0,0 @@
-import { __decorate, __metadata, __param } from "tslib";
-import { Inject } from '@angular/core';
-import { BaseBuilder } from '../../classes/base.builder';
-import { NGX_GET_VALIDATION_ERROR_MESSAGE } from '../get-validation-error-message.function';
-import { CreateDialogDataBuilder } from '../table/create-dialog/create-dialog-data.builder';
-/**
- * The internal AddArrayItemDialogData. Requires all default values the user can leave out.
- */
-export class AddArrayItemDialogDataInternal {
-    constructor(entity, createDialogData, getValidationErrorMessage) {
-        this.entity = entity;
-        this.createDialogData = createDialogData;
-        this.getValidationErrorMessage = getValidationErrorMessage;
-    }
-}
-/**
- * The Builder for the AddArrayItemDialogData. Sets default values.
- */
-let AddArrayItemDialogDataBuilder = class AddArrayItemDialogDataBuilder extends BaseBuilder {
-    constructor(data, defaultGetValidationErrorMessage) {
-        super(data);
-        this.defaultGetValidationErrorMessage = defaultGetValidationErrorMessage;
-    }
-    // eslint-disable-next-line jsdoc/require-jsdoc
-    generateBaseData(data) {
-        const createDialogData = new CreateDialogDataBuilder(data.createDialogData)
-            .withDefault('createButtonLabel', 'Add')
-            .withDefault('title', 'Add to array')
-            .getResult();
-        return new AddArrayItemDialogDataInternal(data.entity, createDialogData, data.getValidationErrorMessage ?? this.defaultGetValidationErrorMessage);
-    }
-};
-AddArrayItemDialogDataBuilder = __decorate([
-    __param(1, Inject(NGX_GET_VALIDATION_ERROR_MESSAGE)),
-    __metadata("design:paramtypes", [Object, Function])
-], AddArrayItemDialogDataBuilder);
-export { AddArrayItemDialogDataBuilder };
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWRkLWFycmF5LWl0ZW0tZGlhbG9nLWRhdGEuYnVpbGRlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uL3Byb2plY3RzL25neC1tYXRlcmlhbC1lbnRpdHkvc3JjL2NvbXBvbmVudHMvaW5wdXQvYWRkLWFycmF5LWl0ZW0tZGlhbG9nLWRhdGEuYnVpbGRlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUEsT0FBTyxFQUFFLE1BQU0sRUFBRSxNQUFNLGVBQWUsQ0FBQztBQUV2QyxPQUFPLEVBQUUsV0FBVyxFQUFFLE1BQU0sNEJBQTRCLENBQUM7QUFFekQsT0FBTyxFQUFFLGdDQUFnQyxFQUFFLE1BQU0sMENBQTBDLENBQUM7QUFDNUYsT0FBTyxFQUFFLHVCQUF1QixFQUE0QixNQUFNLG1EQUFtRCxDQUFDO0FBR3RIOztHQUVHO0FBQ0gsTUFBTSxPQUFPLDhCQUE4QjtJQVF2QyxZQUNJLE1BQWtCLEVBQ2xCLGdCQUEwQyxFQUMxQyx5QkFBcUQ7UUFFckQsSUFBSSxDQUFDLE1BQU0sR0FBRyxNQUFNLENBQUM7UUFDckIsSUFBSSxDQUFDLGdCQUFnQixHQUFHLGdCQUFnQixDQUFDO1FBQ3pDLElBQUksQ0FBQyx5QkFBeUIsR0FBRyx5QkFBeUIsQ0FBQztJQUMvRCxDQUFDO0NBQ0o7QUFFRDs7R0FFRztBQUNJLElBQU0sNkJBQTZCLEdBQW5DLE1BQU0sNkJBQ1QsU0FBUSxXQUEyRjtJQUVuRyxZQUNJLElBQXdDLEVBRXJCLGdDQUE0RDtRQUUvRSxLQUFLLENBQUMsSUFBSSxDQUFDLENBQUM7UUFGTyxxQ0FBZ0MsR0FBaEMsZ0NBQWdDLENBQTRCO0lBR25GLENBQUM7SUFFRCwrQ0FBK0M7SUFDckMsZ0JBQWdCLENBQUMsSUFBd0M7UUFDL0QsTUFBTSxnQkFBZ0IsR0FBNkIsSUFBSSx1QkFBdUIsQ0FBQyxJQUFJLENBQUMsZ0JBQWdCLENBQUM7YUFDaEcsV0FBVyxDQUFDLG1CQUFtQixFQUFFLEtBQUssQ0FBQzthQUN2QyxXQUFXLENBQUMsT0FBTyxFQUFFLGNBQWMsQ0FBQzthQUNwQyxTQUFTLEVBQUUsQ0FBQztRQUNqQixPQUFPLElBQUksOEJBQThCLENBQ3JDLElBQUksQ0FBQyxNQUFNLEVBQ1gsZ0JBQWdCLEVBQ2hCLElBQUksQ0FBQyx5QkFBeUIsSUFBSSxJQUFJLENBQUMsZ0NBQWdDLENBQzFFLENBQUM7SUFDTixDQUFDO0NBQ0osQ0FBQTtBQXZCWSw2QkFBNkI7SUFLakMsV0FBQSxNQUFNLENBQUMsZ0NBQWdDLENBQUMsQ0FBQTs7R0FMcEMsNkJBQTZCLENBdUJ6QztTQXZCWSw2QkFBNkIiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBJbmplY3QgfSBmcm9tICdAYW5ndWxhci9jb3JlJztcbmltcG9ydCB7IE5nTW9kZWwgfSBmcm9tICdAYW5ndWxhci9mb3Jtcyc7XG5pbXBvcnQgeyBCYXNlQnVpbGRlciB9IGZyb20gJy4uLy4uL2NsYXNzZXMvYmFzZS5idWlsZGVyJztcbmltcG9ydCB7IEJhc2VFbnRpdHlUeXBlIH0gZnJvbSAnLi4vLi4vY2xhc3Nlcy9lbnRpdHkubW9kZWwnO1xuaW1wb3J0IHsgTkdYX0dFVF9WQUxJREFUSU9OX0VSUk9SX01FU1NBR0UgfSBmcm9tICcuLi9nZXQtdmFsaWRhdGlvbi1lcnJvci1tZXNzYWdlLmZ1bmN0aW9uJztcbmltcG9ydCB7IENyZWF0ZURpYWxvZ0RhdGFCdWlsZGVyLCBDcmVhdGVEaWFsb2dEYXRhSW50ZXJuYWwgfSBmcm9tICcuLi90YWJsZS9jcmVhdGUtZGlhbG9nL2NyZWF0ZS1kaWFsb2ctZGF0YS5idWlsZGVyJztcbmltcG9ydCB7IEFkZEFycmF5SXRlbURpYWxvZ0RhdGEgfSBmcm9tICcuL2FkZC1hcnJheS1pdGVtLWRpYWxvZy1kYXRhJztcblxuLyoqXG4gKiBUaGUgaW50ZXJuYWwgQWRkQXJyYXlJdGVtRGlhbG9nRGF0YS4gUmVxdWlyZXMgYWxsIGRlZmF1bHQgdmFsdWVzIHRoZSB1c2VyIGNhbiBsZWF2ZSBvdXQuXG4gKi9cbmV4cG9ydCBjbGFzcyBBZGRBcnJheUl0ZW1EaWFsb2dEYXRhSW50ZXJuYWw8RW50aXR5VHlwZSBleHRlbmRzIEJhc2VFbnRpdHlUeXBlPEVudGl0eVR5cGU+PiBpbXBsZW1lbnRzIEFkZEFycmF5SXRlbURpYWxvZ0RhdGE8RW50aXR5VHlwZT4ge1xuICAgIC8vIGVzbGludC1kaXNhYmxlLW5leHQtbGluZSBqc2RvYy9yZXF1aXJlLWpzZG9jXG4gICAgZW50aXR5OiBFbnRpdHlUeXBlO1xuICAgIC8vIGVzbGludC1kaXNhYmxlLW5leHQtbGluZSBqc2RvYy9yZXF1aXJlLWpzZG9jXG4gICAgY3JlYXRlRGlhbG9nRGF0YTogQ3JlYXRlRGlhbG9nRGF0YUludGVybmFsO1xuICAgIC8vIGVzbGludC1kaXNhYmxlLW5leHQtbGluZSBqc2RvYy9yZXF1aXJlLWpzZG9jXG4gICAgZ2V0VmFsaWRhdGlvbkVycm9yTWVzc2FnZTogKG1vZGVsOiBOZ01vZGVsKSA9PiBzdHJpbmc7XG5cbiAgICBjb25zdHJ1Y3RvcihcbiAgICAgICAgZW50aXR5OiBFbnRpdHlUeXBlLFxuICAgICAgICBjcmVhdGVEaWFsb2dEYXRhOiBDcmVhdGVEaWFsb2dEYXRhSW50ZXJuYWwsXG4gICAgICAgIGdldFZhbGlkYXRpb25FcnJvck1lc3NhZ2U6IChtb2RlbDogTmdNb2RlbCkgPT4gc3RyaW5nXG4gICAgKSB7XG4gICAgICAgIHRoaXMuZW50aXR5ID0gZW50aXR5O1xuICAgICAgICB0aGlzLmNyZWF0ZURpYWxvZ0RhdGEgPSBjcmVhdGVEaWFsb2dEYXRhO1xuICAgICAgICB0aGlzLmdldFZhbGlkYXRpb25FcnJvck1lc3NhZ2UgPSBnZXRWYWxpZGF0aW9uRXJyb3JNZXNzYWdlO1xuICAgIH1cbn1cblxuLyoqXG4gKiBUaGUgQnVpbGRlciBmb3IgdGhlIEFkZEFycmF5SXRlbURpYWxvZ0RhdGEuIFNldHMgZGVmYXVsdCB2YWx1ZXMuXG4gKi9cbmV4cG9ydCBjbGFzcyBBZGRBcnJheUl0ZW1EaWFsb2dEYXRhQnVpbGRlcjxFbnRpdHlUeXBlIGV4dGVuZHMgQmFzZUVudGl0eVR5cGU8RW50aXR5VHlwZT4+XG4gICAgZXh0ZW5kcyBCYXNlQnVpbGRlcjxBZGRBcnJheUl0ZW1EaWFsb2dEYXRhSW50ZXJuYWw8RW50aXR5VHlwZT4sIEFkZEFycmF5SXRlbURpYWxvZ0RhdGE8RW50aXR5VHlwZT4+IHtcblxuICAgIGNvbnN0cnVjdG9yKFxuICAgICAgICBkYXRhOiBBZGRBcnJheUl0ZW1EaWFsb2dEYXRhPEVudGl0eVR5cGU+LFxuICAgICAgICBASW5qZWN0KE5HWF9HRVRfVkFMSURBVElPTl9FUlJPUl9NRVNTQUdFKVxuICAgICAgICBwcm90ZWN0ZWQgcmVhZG9ubHkgZGVmYXVsdEdldFZhbGlkYXRpb25FcnJvck1lc3NhZ2U6IChtb2RlbDogTmdNb2RlbCkgPT4gc3RyaW5nXG4gICAgKSB7XG4gICAgICAgIHN1cGVyKGRhdGEpO1xuICAgIH1cblxuICAgIC8vIGVzbGludC1kaXNhYmxlLW5leHQtbGluZSBqc2RvYy9yZXF1aXJlLWpzZG9jXG4gICAgcHJvdGVjdGVkIGdlbmVyYXRlQmFzZURhdGEoZGF0YTogQWRkQXJyYXlJdGVtRGlhbG9nRGF0YTxFbnRpdHlUeXBlPik6IEFkZEFycmF5SXRlbURpYWxvZ0RhdGFJbnRlcm5hbDxFbnRpdHlUeXBlPiB7XG4gICAgICAgIGNvbnN0IGNyZWF0ZURpYWxvZ0RhdGE6IENyZWF0ZURpYWxvZ0RhdGFJbnRlcm5hbCA9IG5ldyBDcmVhdGVEaWFsb2dEYXRhQnVpbGRlcihkYXRhLmNyZWF0ZURpYWxvZ0RhdGEpXG4gICAgICAgICAgICAud2l0aERlZmF1bHQoJ2NyZWF0ZUJ1dHRvbkxhYmVsJywgJ0FkZCcpXG4gICAgICAgICAgICAud2l0aERlZmF1bHQoJ3RpdGxlJywgJ0FkZCB0byBhcnJheScpXG4gICAgICAgICAgICAuZ2V0UmVzdWx0KCk7XG4gICAgICAgIHJldHVybiBuZXcgQWRkQXJyYXlJdGVtRGlhbG9nRGF0YUludGVybmFsKFxuICAgICAgICAgICAgZGF0YS5lbnRpdHksXG4gICAgICAgICAgICBjcmVhdGVEaWFsb2dEYXRhLFxuICAgICAgICAgICAgZGF0YS5nZXRWYWxpZGF0aW9uRXJyb3JNZXNzYWdlID8/IHRoaXMuZGVmYXVsdEdldFZhbGlkYXRpb25FcnJvck1lc3NhZ2VcbiAgICAgICAgKTtcbiAgICB9XG59Il19

package/esm2020/components/input/add-array-item-dialog-data.mjs

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWRkLWFycmF5LWl0ZW0tZGlhbG9nLWRhdGEuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi9wcm9qZWN0cy9uZ3gtbWF0ZXJpYWwtZW50aXR5L3NyYy9jb21wb25lbnRzL2lucHV0L2FkZC1hcnJheS1pdGVtLWRpYWxvZy1kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiIiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBOZ01vZGVsIH0gZnJvbSAnQGFuZ3VsYXIvZm9ybXMnO1xuaW1wb3J0IHsgQmFzZUVudGl0eVR5cGUgfSBmcm9tICcuLi8uLi9jbGFzc2VzL2VudGl0eS5tb2RlbCc7XG5pbXBvcnQgeyBDcmVhdGVEaWFsb2dEYXRhIH0gZnJvbSAnLi4vdGFibGUvdGFibGUtZGF0YSc7XG5cbi8qKlxuICogVGhlIGNvbmZpZ3VyYXRpb24gb3B0aW9ucyBmb3IgdGhlIGRpYWxvZyB0aGF0IGFkZHMgaXRlbXMgdG8gYW4gYXJyYXkuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQWRkQXJyYXlJdGVtRGlhbG9nRGF0YTxFbnRpdHlUeXBlIGV4dGVuZHMgQmFzZUVudGl0eVR5cGU8RW50aXR5VHlwZT4+IHtcbiAgICAvKipcbiAgICAgKiBBbiBlbXB0eSBlbnRpdHkgdGhhdCBpcyB1c2VkIGFzIHRoZSBkYXRhIG1vZGVsLlxuICAgICAqL1xuICAgIGVudGl0eTogRW50aXR5VHlwZSxcbiAgICAvKipcbiAgICAgKiBUaGUgaW5mbyBvZiB0aGUgZ2VuZXJpYyBjcmVhdGUtZGlhbG9nLlxuICAgICAqL1xuICAgIGNyZWF0ZURpYWxvZ0RhdGE/OiBDcmVhdGVEaWFsb2dEYXRhLFxuICAgIC8qKlxuICAgICAqIEEgY3VzdG9tIGZ1bmN0aW9uIHRvIGdlbmVyYXRlIHRoZSBlcnJvci1tZXNzYWdlIGZvciBpbnZhbGlkIGlucHV0cy5cbiAgICAgKi9cbiAgICBnZXRWYWxpZGF0aW9uRXJyb3JNZXNzYWdlPzogKG1vZGVsOiBOZ01vZGVsKSA9PiBzdHJpbmdcbn0iXX0=