@rentman/rm-core 8.2.0 → 8.2.1

package/dist/types/classes/RequestColumnExpansion.d.ts

@@ -1,15 +1,15 @@
-import { ApiEnumItemType } from '@rentman/backend-types';
-import { ApiRequestColumns, ColumnSet, ColumnUtil, RequestColumnMergeResult } from '../internal';
-declare type RequestColumnMap = {
-    [itemType: string]: ApiRequestColumns;
-};
-export declare class RequestColumnExpansion {
-    private columnUtil;
-    private columns;
-    private columnSetIdMap;
-    constructor(columnUtil: ColumnUtil);
-    expandWithRequestColumns(itemType: ApiEnumItemType, requestColumns: ApiRequestColumns): RequestColumnMergeResult;
-    expand<T extends ColumnSet<ApiEnumItemType>>(columnSet: T): void;
-    get(): RequestColumnMap;
-}
-export {};
+import { ApiEnumItemType } from '@rentman/backend-types';
+import { ApiRequestColumns, ColumnSet, ColumnUtil, RequestColumnMergeResult } from '../internal';
+declare type RequestColumnMap = {
+    [itemType: string]: ApiRequestColumns;
+};
+export declare class RequestColumnExpansion {
+    private columnUtil;
+    private columns;
+    private columnSetIdMap;
+    constructor(columnUtil: ColumnUtil);
+    expandWithRequestColumns(itemType: ApiEnumItemType, requestColumns: ApiRequestColumns): RequestColumnMergeResult;
+    expand<T extends ColumnSet<ApiEnumItemType>>(columnSet: T): void;
+    get(): RequestColumnMap;
+}
+export {};

package/dist/types/classes/SocketMessageHandler.d.ts

@@ -1,34 +1,34 @@
-import { ApiEnumItemType } from '@rentman/backend-types';
-import { ApiFormatter, ApiRequestService, CachedQueryItem, ChangesDeltaFactory, ErrorHandlerInterface, PromiseLibraryInterface, QueryMatcherFactory, RequestBufferManager, RequestColumnExpansionFactory, SocketMessage, TransactionCacheFactory } from '../internal';
-export declare type CachedQueryMatchingResult<ItemTypeType extends ApiEnumItemType> = {
-    fitting: Array<CachedQueryItem<ItemTypeType>>;
-    notfitting: Array<CachedQueryItem<ItemTypeType>>;
-    maybe: Array<CachedQueryItem<ItemTypeType>>;
-};
-export declare class SocketMessageHandler {
-    private requestBufferManager;
-    private changesDeltaFactory;
-    private apiFormatter;
-    private errorHandler;
-    private transactionCacheFactory;
-    private promiseService;
-    private requestColumnExpansionFactory;
-    private apiRequestService;
-    private queryMatcherFactory;
-    constructor(requestBufferManager: RequestBufferManager, changesDeltaFactory: ChangesDeltaFactory, apiFormatter: ApiFormatter, errorHandler: ErrorHandlerInterface, transactionCacheFactory: TransactionCacheFactory, promiseService: PromiseLibraryInterface, requestColumnExpansionFactory: RequestColumnExpansionFactory, apiRequestService: ApiRequestService, queryMatcherFactory: QueryMatcherFactory);
-    onMessageReceived(message: SocketMessage): any;
-    private formatMessageValues;
-    private getCollectionsWithLimitByItemType;
-    /**
-     * @description
-     * When an item is created or updated, we should check if it fits in any of the cached queries (using the values provided by the socket message)
-     * If we think it fits (or maybe) we should fetch the complete item with the superset of columns (the socket message might not have all values)
-     */
-    private processMessage;
-    private processFunctionChangesResolve;
-    private isFunctionChangesResolveMessage;
-    private handleCreate;
-    private handleUpdate;
-    private handleDelete;
-    private handleLinkMove;
-}
+import { ApiEnumItemType } from '@rentman/backend-types';
+import { ApiFormatter, ApiRequestService, CachedQueryItem, ChangesDeltaFactory, ErrorHandlerInterface, PromiseLibraryInterface, QueryMatcherFactory, RequestBufferManager, RequestColumnExpansionFactory, SocketMessage, TransactionCacheFactory } from '../internal';
+export declare type CachedQueryMatchingResult<ItemTypeType extends ApiEnumItemType> = {
+    fitting: Array<CachedQueryItem<ItemTypeType>>;
+    notfitting: Array<CachedQueryItem<ItemTypeType>>;
+    maybe: Array<CachedQueryItem<ItemTypeType>>;
+};
+export declare class SocketMessageHandler {
+    private requestBufferManager;
+    private changesDeltaFactory;
+    private apiFormatter;
+    private errorHandler;
+    private transactionCacheFactory;
+    private promiseService;
+    private requestColumnExpansionFactory;
+    private apiRequestService;
+    private queryMatcherFactory;
+    constructor(requestBufferManager: RequestBufferManager, changesDeltaFactory: ChangesDeltaFactory, apiFormatter: ApiFormatter, errorHandler: ErrorHandlerInterface, transactionCacheFactory: TransactionCacheFactory, promiseService: PromiseLibraryInterface, requestColumnExpansionFactory: RequestColumnExpansionFactory, apiRequestService: ApiRequestService, queryMatcherFactory: QueryMatcherFactory);
+    onMessageReceived(message: SocketMessage): any;
+    private formatMessageValues;
+    private getCollectionsWithLimitByItemType;
+    /**
+     * @description
+     * When an item is created or updated, we should check if it fits in any of the cached queries (using the values provided by the socket message)
+     * If we think it fits (or maybe) we should fetch the complete item with the superset of columns (the socket message might not have all values)
+     */
+    private processMessage;
+    private processFunctionChangesResolve;
+    private isFunctionChangesResolveMessage;
+    private handleCreate;
+    private handleUpdate;
+    private handleDelete;
+    private handleLinkMove;
+}

package/dist/types/classes/TemplateCache.d.ts

@@ -1,63 +1,62 @@
-import { ApiEnumItemType, ApiFields, ItemId } from '@rentman/backend-types';
-import { ApiRequestService, ApiResponse, ColumnHandler, ColumnUtil, EntryParentNull, ErrorHandlerInterface, PromiseInterface, PromiseLibraryInterface, RequestColumnExpansionFactory, RmCore, Template, TemplateFactory } from '../internal';
-export declare class TemplateCache {
-    private core;
-    private columnUtil;
-    private promiseService;
-    private columnHandler;
-    private templateFactory;
-    private errorHandler;
-    private requestColumnExpansionFactory;
-    private apiRequestService;
-    private pendingTemplateBufferMap;
-    templateResponses: {
-        [itemType: string]: ApiResponse;
-    };
-    constructor(core: RmCore, columnUtil: ColumnUtil, promiseService: PromiseLibraryInterface, columnHandler: ColumnHandler, templateFactory: TemplateFactory, errorHandler: ErrorHandlerInterface, requestColumnExpansionFactory: RequestColumnExpansionFactory, apiRequestService: ApiRequestService);
-    /**
-     * @description
-     * Fetches a {@link Template template}, use {@link ItemCreateService.createItemsFromValues createItemsFromValues} to easily create new items from a set of values.
-     * The best way to process the template's values is to call {@link ItemCreateService.processTemplate processTemplate}
-     *
-     * @param itemType The {@link ApiEnumItemType ItemType} of the template item
-     * @param itemId Used for caching, multiple concurrent template calls for the same itemId will return the same template
-     * @param templateOptions
-     * @param templateColumns Additional columns to be fetched, will be stored in the template - warning - the Template won't have values for those columns
-     * @param entryParentOrParentItemType An optional {@link EntryParentNull entry parent} or {@link ApiEnumItemType parent itemType}, if the parent is passed the templateColumns will be expanded with the proper link columns (Through {@link ColumnUtil.getColumnsFromLink ColumnUtil.getColumnsFromLink})
-     *
-     * @example
-     * ```
-     *  const parent: EntryParent = {
-     *      itemType: 'Functie',
-     *      itemId: 10,
-     *  };
-     *
-     *  return core.templateCache
-     *      .fetchTemplate(
-     *          'Planningpersoneel',
-     *          undefined,
-     *          {},
-     *          {},
-     *          parent,
-     *      )
-     *      .then(
-     *          (template: Template<'Planningpersoneel'>) => {
-     *              const changesDelta = transaction.createChangesDelta();
-     *
-     *              for (const itemResource of selectedItems) {
-     *                  changesDelta.setItemCreated(
-     *                      core.keyService.getLocalId(),
-     *                      template.getFields(),
-     *                      template.columns,
-     *                      parent,
-     *                  );
-     *              }
-     *
-     *              return transaction.applyChangesDelta(changesDelta);
-     *          );
-     *  ```
-     */
-    fetchTemplate<ItemTypeType extends ApiEnumItemType, ColumnIds extends Array<keyof ApiFields[ItemTypeType]> = Array<keyof ApiFields[ItemTypeType]>>(itemType: ItemTypeType, itemId?: ItemId, templateOptions?: any, templateColumns?: any, entryParentOrParentItemType?: EntryParentNull | ApiEnumItemType): PromiseInterface<Template<ItemTypeType, ColumnIds>>;
-    private fetchTemplateById;
-    private constructTemplateBuffer;
-}
+import { ApiEnumItemType, ApiFields, ItemId } from '@rentman/backend-types';
+import { ApiRequestService, ApiResponse, ColumnHandler, ColumnUtil, EntryParentNull, ErrorHandlerInterface, PromiseInterface, PromiseLibraryInterface, RequestColumnExpansionFactory, Template, TemplateFactory } from '../internal';
+export declare class TemplateCache {
+    private columnUtil;
+    private promiseService;
+    private columnHandler;
+    private templateFactory;
+    private errorHandler;
+    private requestColumnExpansionFactory;
+    private apiRequestService;
+    private pendingTemplateBufferMap;
+    templateResponses: {
+        [itemType: string]: ApiResponse;
+    };
+    constructor(columnUtil: ColumnUtil, promiseService: PromiseLibraryInterface, columnHandler: ColumnHandler, templateFactory: TemplateFactory, errorHandler: ErrorHandlerInterface, requestColumnExpansionFactory: RequestColumnExpansionFactory, apiRequestService: ApiRequestService);
+    /**
+     * @description
+     * Fetches a {@link Template template}, use {@link ItemCreateService.createItemsFromValues createItemsFromValues} to easily create new items from a set of values.
+     * The best way to process the template's values is to call {@link ItemCreateService.processTemplate processTemplate}
+     *
+     * @param itemType The {@link ApiEnumItemType ItemType} of the template item
+     * @param itemId Used for caching, multiple concurrent template calls for the same itemId will return the same template
+     * @param templateOptions
+     * @param templateColumns Additional columns to be fetched, will be stored in the template - warning - the Template won't have values for those columns
+     * @param entryParentOrParentItemType An optional {@link EntryParentNull entry parent} or {@link ApiEnumItemType parent itemType}, if the parent is passed the templateColumns will be expanded with the proper link columns (Through {@link ColumnUtil.getColumnsFromLink ColumnUtil.getColumnsFromLink})
+     *
+     * @example
+     * ```
+     *  const parent: EntryParent = {
+     *      itemType: 'Functie',
+     *      itemId: 10,
+     *  };
+     *
+     *  return core.templateCache
+     *      .fetchTemplate(
+     *          'Planningpersoneel',
+     *          undefined,
+     *          {},
+     *          {},
+     *          parent,
+     *      )
+     *      .then(
+     *          (template: Template<'Planningpersoneel'>) => {
+     *              const changesDelta = transaction.createChangesDelta();
+     *
+     *              for (const itemResource of selectedItems) {
+     *                  changesDelta.setItemCreated(
+     *                      core.keyService.getLocalId(),
+     *                      template.getFields(),
+     *                      template.columns,
+     *                      parent,
+     *                  );
+     *              }
+     *
+     *              return transaction.applyChangesDelta(changesDelta);
+     *          );
+     *  ```
+     */
+    fetchTemplate<ItemTypeType extends ApiEnumItemType, ColumnIds extends Array<keyof ApiFields[ItemTypeType]> = Array<keyof ApiFields[ItemTypeType]>>(itemType: ItemTypeType, itemId?: ItemId, templateOptions?: any, templateColumns?: any, entryParentOrParentItemType?: EntryParentNull | ApiEnumItemType): PromiseInterface<Template<ItemTypeType, ColumnIds>>;
+    private fetchTemplateById;
+    private constructTemplateBuffer;
+}

package/dist/types/classes/Util.d.ts

@@ -1,28 +1,28 @@
-import { PromiseInterface } from '../internal';
-export declare function findIndex<T>(haystack: T[], callback: (item: T) => boolean): number;
-export declare function shallowMerge(object: any, defaults: any): any;
-export declare function hasProperties(object: any): boolean;
-export declare function getFirstProperty(object: any): string | null;
-export declare function inArray(needle: any, haystack: any): boolean;
-export declare function filterArray<T>(source: T[], callback: (elem: T) => boolean): boolean;
-export declare function emptyArray(array: any): void;
-export declare function pathExists(source: any, path: any): boolean;
-export declare function createPath<T>(object: any, path: Array<number | string>, defaults: any[]): T;
-export declare function getPath(object: {}, path: Array<number | string>, create?: boolean): any;
-export declare function extend(dst: any, ...args: any[]): any;
-export declare function merge(dst: any, ...args: any[]): any;
-export declare function isObject(value: any): boolean;
-export declare function isBlankObject(value: any): boolean;
-export declare function isString(value: any): boolean;
-export declare function isNumber(value: any): boolean;
-export declare function isDate(value: any): boolean;
-export declare const isArray: (arg: any) => arg is any[];
-export declare function isFunction<T>(value: any): value is T;
-export declare function isPromiseLike<T = any>(obj: any): obj is PromiseInterface<T>;
-export declare function isRegExp(value: any): boolean;
-export declare function isBoolean(value: any): boolean;
-export declare function isElement(node: any): boolean;
-export declare function isWindow(obj: any): boolean;
-export declare function isDefined(value: any): boolean;
-export declare function equals(o1: any, o2: any): boolean;
-export declare function copy(source: object, destination?: object, maxDepth?: any): any;
+import { PromiseInterface } from '../internal';
+export declare function findIndex<T>(haystack: T[], callback: (item: T) => boolean): number;
+export declare function shallowMerge(object: any, defaults: any): any;
+export declare function hasProperties(object: any): boolean;
+export declare function getFirstProperty(object: any): string | null;
+export declare function inArray(needle: any, haystack: any): boolean;
+export declare function filterArray<T>(source: T[], callback: (elem: T) => boolean): boolean;
+export declare function emptyArray(array: any): void;
+export declare function pathExists(source: any, path: any): boolean;
+export declare function createPath<T>(object: any, path: Array<number | string>, defaults: any[]): T;
+export declare function getPath(object: {}, path: Array<number | string>, create?: boolean): any;
+export declare function extend(dst: any, ...args: any[]): any;
+export declare function merge(dst: any, ...args: any[]): any;
+export declare function isObject(value: any): boolean;
+export declare function isBlankObject(value: any): boolean;
+export declare function isString(value: any): boolean;
+export declare function isNumber(value: any): boolean;
+export declare function isDate(value: any): boolean;
+export declare const isArray: (arg: any) => arg is any[];
+export declare function isFunction<T>(value: any): value is T;
+export declare function isPromiseLike<T = any>(obj: any): obj is PromiseInterface<T>;
+export declare function isRegExp(value: any): boolean;
+export declare function isBoolean(value: any): boolean;
+export declare function isElement(node: any): boolean;
+export declare function isWindow(obj: any): boolean;
+export declare function isDefined(value: any): boolean;
+export declare function equals(o1: any, o2: any): boolean;
+export declare function copy(source: object, destination?: object, maxDepth?: any): any;

package/dist/types/classes/cache/AbstractCache.d.ts

@@ -1,95 +1,95 @@
-import { ApiEnumItemType } from '@rentman/backend-types';
-import { RmCore } from '../../core';
-import { AbstractCacheDependencyInterface, ApiRequestColumn, CachedQueryItem, ChangesDelta, ChangesDeltaBase, ChangesDeltaResult, CollectionQuery, CollectionResourceParentIdMap, EntryParentNull, FieldMap, InternalChangesDelta, ItemCache, ItemEntry, ItemHandlerBase, ItemIdConversionMap, OnAfterCreateCallback, ParentChangesDelta, PromiseInterface, ServerCache, ServerCachedQueryHandler, ServerItemEntryChanges, TransactionCache, TransactionCachedQueryHandler, TransactionItemEntryChanges, TransactionValidatorFactory } from '../../internal';
-export declare type TransactionOptions = {
-    /**
-     * @description
-     * Sets the TransactionCache to 'transparent' mode, whenever {@link AbstractCache.createChild createChild} is called it will actually be called on the parent
-     */
-    transparent: boolean;
-};
-export declare abstract class AbstractCache {
-    dependencies: AbstractCacheDependencyInterface;
-    core: RmCore;
-    children: TransactionCache[];
-    readonly itemHandler: ItemHandlerBase;
-    readonly cachedQueryHandler: TransactionCachedQueryHandler | ServerCachedQueryHandler;
-    parent: AbstractCache | null;
-    protected constructor(dependencies: AbstractCacheDependencyInterface, core: RmCore);
-    abstract createChild(id?: string, validatorFactory?: TransactionValidatorFactory, options?: TransactionOptions): TransactionCache;
-    onChildDestroy(cache: TransactionCache): void;
-    /**
-     * @description
-     * Expands the items in the collections with the passed columns
-     *
-     * todo[limit] move to TransactionCache ?
-     */
-    abstract expandCollectionResources<ItemTypeType extends ApiEnumItemType>(itemType: ItemTypeType, collections: CollectionResourceParentIdMap<ItemTypeType>, newColumns: ApiRequestColumn[]): PromiseInterface<CollectionResourceParentIdMap>;
-    /**
-     * @description
-     * Returns {@link ItemEntry ItemEntries} that fit the collection's query, copies over the collectionChanges on all transactions in the chain.
-     */
-    abstract getCollectionChangesRecursively<ItemTypeType extends ApiEnumItemType>(itemType: ItemTypeType, parsedQuery: CollectionQuery): CachedQueryItem<ItemTypeType> | undefined;
-    /**
-     * @description
-     * Returns this transaction and all parents
-     */
-    getTransactionChain(): AbstractCache[];
-    /**
-     * @description
-     * Returns the {@link TransactionItemHandler.entries ItemCache} of the transaction
-     */
-    getCurrentItemEntryCache(): ItemCache;
-    abstract getServerCache(): ServerCache;
-    abstract getLocalItemEntry(itemEntryId: ItemEntry['id']): ItemEntry | undefined;
-    abstract getLocalItemEntryByItemId(itemType: ApiEnumItemType, itemId: ItemEntry['itemId']): ItemEntry | undefined;
-    /**
-     * @description
-     * Applies changes from a child transaction to a parent
-     */
-    abstract applyChangesFromChild(transaction: TransactionCache, breakUpByParent?: boolean, onAfterCreateCallback?: OnAfterCreateCallback): PromiseInterface<ItemIdConversionMap>;
-    /**
-     * @description
-     * Called by a parent transaction, propagates changes downwards to all child caches
-     *
-     * @remarks
-     * - Should only be used by the core
-     *
-     * todo[cache] Should we refetch derived values just like in applyChangesDelta ?
-     *
-     * @internal
-     */
-    abstract applyChangesFromParent(parentChangesDelta: ParentChangesDelta, isCalledAfterSocketUpdate: boolean): void;
-    abstract getParent<ItemTypeType extends ApiEnumItemType = any>(itemEntry: ItemEntry<ItemTypeType>, fromInitial?: boolean, providedFields?: FieldMap<ItemTypeType>): EntryParentNull;
-    abstract getItemChangesRecursively(itemEntryId: ItemEntry['id'], copyFields?: boolean): FieldMap;
-    abstract getLocalItemEntryChangesTuple(itemEntryId: ItemEntry['id']): any;
-    /**
-     * @description
-     * Because the `itemChanges` object differs between the {@link ServerItemHandler.itemChanges ServerItemHandler} and the {@link TransactionItemHandler.itemChanges TransactionItemHandler} we need a function to normalise those values
-     *
-     * @remarks
-     * - Should only be used by the core
-     *
-     * @internal
-     */
-    abstract getChangesFromItemChanges<ItemTypeType extends ApiEnumItemType = any>(changesObject: ServerItemEntryChanges<ItemTypeType> | TransactionItemEntryChanges<FieldMap<ItemTypeType>>): FieldMap<ItemTypeType>;
-    abstract applyChangesDelta(changesDelta: ChangesDelta): PromiseInterface<ChangesDeltaResult>;
-    protected getParentFromFields<ItemTypeType extends ApiEnumItemType = any>(itemEntry: ItemEntry<ItemTypeType>, fields: FieldMap<ItemTypeType>): EntryParentNull;
-    /**
-     * @description
-     * Called by applyChangesDelta from ServerCache and TransactionCache. Applies creates, updates and moves, doesn't apply deletes
-     *
-     * @private
-     */
-    protected _applyChangesDelta(changesDelta: ChangesDelta | InternalChangesDelta): {
-        result: ChangesDeltaResult;
-        parentChangesDelta: ParentChangesDelta;
-        matchingDelta: ParentChangesDelta;
-        undoFunctions: Array<(changesDelta: InternalChangesDelta) => void>;
-    };
-    /**
-     * @description
-     * Ensures that for all updated items in the delta the required derived values are present
-     */
-    protected fetchUpdatedDerivedValuesFromDelta(changesDelta: ChangesDeltaBase): PromiseInterface<void>;
-}
+import { ApiEnumItemType } from '@rentman/backend-types';
+import { RmCore } from '../../core';
+import { AbstractCacheDependencyInterface, ApiRequestColumn, CachedQueryItem, ChangesDelta, ChangesDeltaBase, ChangesDeltaResult, CollectionQuery, CollectionResourceParentIdMap, EntryParentNull, FieldMap, InternalChangesDelta, ItemCache, ItemEntry, ItemHandlerBase, ItemIdConversionMap, OnAfterCreateCallback, ParentChangesDelta, PromiseInterface, ServerCache, ServerCachedQueryHandler, ServerItemEntryChanges, TransactionCache, TransactionCachedQueryHandler, TransactionItemEntryChanges, TransactionValidatorFactory } from '../../internal';
+export declare type TransactionOptions = {
+    /**
+     * @description
+     * Sets the TransactionCache to 'transparent' mode, whenever {@link AbstractCache.createChild createChild} is called it will actually be called on the parent
+     */
+    transparent: boolean;
+};
+export declare abstract class AbstractCache {
+    dependencies: AbstractCacheDependencyInterface;
+    core: RmCore;
+    children: TransactionCache[];
+    readonly itemHandler: ItemHandlerBase;
+    readonly cachedQueryHandler: TransactionCachedQueryHandler | ServerCachedQueryHandler;
+    parent: AbstractCache | null;
+    protected constructor(dependencies: AbstractCacheDependencyInterface, core: RmCore);
+    abstract createChild(id?: string, validatorFactory?: TransactionValidatorFactory, options?: TransactionOptions): TransactionCache;
+    onChildDestroy(cache: TransactionCache): void;
+    /**
+     * @description
+     * Expands the items in the collections with the passed columns
+     *
+     * todo[limit] move to TransactionCache ?
+     */
+    abstract expandCollectionResources<ItemTypeType extends ApiEnumItemType>(itemType: ItemTypeType, collections: CollectionResourceParentIdMap<ItemTypeType>, newColumns: ApiRequestColumn[]): PromiseInterface<CollectionResourceParentIdMap>;
+    /**
+     * @description
+     * Returns {@link ItemEntry ItemEntries} that fit the collection's query, copies over the collectionChanges on all transactions in the chain.
+     */
+    abstract getCollectionChangesRecursively<ItemTypeType extends ApiEnumItemType>(itemType: ItemTypeType, parsedQuery: CollectionQuery): CachedQueryItem<ItemTypeType> | undefined;
+    /**
+     * @description
+     * Returns this transaction and all parents
+     */
+    getTransactionChain(): AbstractCache[];
+    /**
+     * @description
+     * Returns the {@link TransactionItemHandler.entries ItemCache} of the transaction
+     */
+    getCurrentItemEntryCache(): ItemCache;
+    abstract getServerCache(): ServerCache;
+    abstract getLocalItemEntry(itemEntryId: ItemEntry['id']): ItemEntry | undefined;
+    abstract getLocalItemEntryByItemId(itemType: ApiEnumItemType, itemId: ItemEntry['itemId']): ItemEntry | undefined;
+    /**
+     * @description
+     * Applies changes from a child transaction to a parent
+     */
+    abstract applyChangesFromChild(transaction: TransactionCache, breakUpByParent?: boolean, onAfterCreateCallback?: OnAfterCreateCallback): PromiseInterface<ItemIdConversionMap>;
+    /**
+     * @description
+     * Called by a parent transaction, propagates changes downwards to all child caches
+     *
+     * @remarks
+     * - Should only be used by the core
+     *
+     * todo[cache] Should we refetch derived values just like in applyChangesDelta ?
+     *
+     * @internal
+     */
+    abstract applyChangesFromParent(parentChangesDelta: ParentChangesDelta, isCalledAfterSocketUpdate: boolean): void;
+    abstract getParent<ItemTypeType extends ApiEnumItemType = any>(itemEntry: ItemEntry<ItemTypeType>, fromInitial?: boolean, providedFields?: FieldMap<ItemTypeType>): EntryParentNull;
+    abstract getItemChangesRecursively(itemEntryId: ItemEntry['id'], copyFields?: boolean): FieldMap;
+    abstract getLocalItemEntryChangesTuple(itemEntryId: ItemEntry['id']): any;
+    /**
+     * @description
+     * Because the `itemChanges` object differs between the {@link ServerItemHandler.itemChanges ServerItemHandler} and the {@link TransactionItemHandler.itemChanges TransactionItemHandler} we need a function to normalise those values
+     *
+     * @remarks
+     * - Should only be used by the core
+     *
+     * @internal
+     */
+    abstract getChangesFromItemChanges<ItemTypeType extends ApiEnumItemType = any>(changesObject: ServerItemEntryChanges<ItemTypeType> | TransactionItemEntryChanges<FieldMap<ItemTypeType>>): FieldMap<ItemTypeType>;
+    abstract applyChangesDelta(changesDelta: ChangesDelta): PromiseInterface<ChangesDeltaResult>;
+    protected getParentFromFields<ItemTypeType extends ApiEnumItemType = any>(itemEntry: ItemEntry<ItemTypeType>, fields: FieldMap<ItemTypeType>): EntryParentNull;
+    /**
+     * @description
+     * Called by applyChangesDelta from ServerCache and TransactionCache. Applies creates, updates and moves, doesn't apply deletes
+     *
+     * @private
+     */
+    protected _applyChangesDelta(changesDelta: ChangesDelta | InternalChangesDelta): {
+        result: ChangesDeltaResult;
+        parentChangesDelta: ParentChangesDelta;
+        matchingDelta: ParentChangesDelta;
+        undoFunctions: Array<(changesDelta: InternalChangesDelta) => void>;
+    };
+    /**
+     * @description
+     * Ensures that for all updated items in the delta the required derived values are present
+     */
+    protected fetchUpdatedDerivedValuesFromDelta(changesDelta: ChangesDeltaBase): PromiseInterface<void>;
+}

package/dist/types/classes/cache/CachedQueryHandlerBase.d.ts

@@ -1,68 +1,68 @@
-import { ApiEnumItemType, ItemId } from '@rentman/backend-types';
-import { AbstractCache, ApiQuery, ApiRequestColumns, CachedQueryItem, CollectionEntryService, CollectionOptions, CollectionQuery, ColumnSubsetCache, ColumnUtil, ItemEntry, ParentIdMap, ParentItemMap, PromiseInterface, PromiseLibraryInterface, RequestColumnExpansionFactory } from '../../internal';
-export declare type CachedQueryItemTree<ItemTypeType extends ApiEnumItemType = any> = {
-    item: CachedQueryItem<ItemTypeType>;
-    children: ParentItemMap<CachedQueryItemTree> | null;
-};
-export declare abstract class CachedQueryHandlerBase {
-    protected collectionEntryService: CollectionEntryService;
-    protected columnUtil: ColumnUtil;
-    protected requestColumnExpansionFactory: RequestColumnExpansionFactory;
-    protected promiseService: PromiseLibraryInterface;
-    protected transaction: AbstractCache;
-    /**
-     * @description
-     * Items (per ItemType) that fit in a query
-     *
-     * @remark
-     * Contains the requestColumns so that new items can include these columns (saving requests when they match)
-     */
-    cachedQueries: {
-        [itemType: string]: {
-            [queryString: string]: CachedQueryItem;
-        };
-    };
-    protected constructor(collectionEntryService: CollectionEntryService, columnUtil: ColumnUtil, requestColumnExpansionFactory: RequestColumnExpansionFactory, promiseService: PromiseLibraryInterface, transaction: AbstractCache);
-    /**
-     * Every time a cached query item is created, either 'resolve' or 'reject' has to be called on the cached query item.
-     */
-    setCachedQuery<ItemTypeType extends ApiEnumItemType>(itemType: ItemTypeType, parsedQuery: CollectionQuery, requestColumns: ApiRequestColumns, itemEntries?: Array<ItemEntry<ItemTypeType>>): CachedQueryItem<ItemTypeType>;
-    /**
-     * Every time a cached query item is created, either 'resolve' or 'reject' has to be called on the cached query item.
-     */
-    protected constructCachedQuery<ItemTypeType extends ApiEnumItemType>(itemType: ItemTypeType, parsedQuery: CollectionQuery, itemEntries: Array<ItemEntry<ItemTypeType>>, requestColumns: ApiRequestColumns): CachedQueryItem<ItemTypeType>;
-    getCachedQueryItems<ItemTypeType extends ApiEnumItemType>(itemType: ItemTypeType, queryString: string): undefined | Array<ItemEntry<ItemTypeType>>;
-    getCachedQueryObjectsByItemType(itemType: ApiEnumItemType): CachedQueryItem[];
-    /**
-     * @description
-     * Fetches a {@link CollectionEntry CollectionEntry} with the given options
-     */
-    abstract __fetchCachedQueryItem<ItemTypeType extends ApiEnumItemType>(itemType: ItemTypeType, options: CollectionOptions): PromiseInterface<CachedQueryItem<ItemTypeType>>;
-    /**
-     * @description
-     * Fetches collections linked to the passed parents
-     */
-    abstract __fetchItemEntriesByQueryData<ItemTypeType extends ApiEnumItemType>(itemType: ItemTypeType, options: CollectionOptions<ItemTypeType>, columnSubsetCache: ColumnSubsetCache<ItemTypeType>, collectionQuery: CollectionQuery): PromiseInterface<CachedQueryItem<ItemTypeType>>;
-    /**
-     * @description
-     * Fetches collections linked to the passed parents
-     */
-    abstract __fetchLinkedCachedQueryItems<ItemTypeType extends ApiEnumItemType>(parentType: ApiEnumItemType, parentIdArray: ItemId[] | (() => ItemId[]), itemType: ItemTypeType, options: CollectionOptions): PromiseInterface<ParentIdMap<CachedQueryItem<ItemTypeType>>>;
-    /**
-     * @description
-     * Adds the passed {@link ItemEntry ItemEntries} to the Transaction's query cache,
-     * will skip the ItemEntry if the `skipEntryFilterFn` callback returns `true`
-     */
-    protected __addItemEntriesToCachedQueries<ItemTypeType extends ApiEnumItemType>(itemType: ItemTypeType, parsedQuery: CollectionQuery, itemEntries: Array<ItemEntry<ItemTypeType>>, skipEntryFilterFn: (temEntry: ItemEntry) => boolean): void;
-    /**
-     * @description
-     * Removes the passed {@link ItemId ItemIds} from the Transaction's query cache
-     */
-    __removeItemEntriesFromCachedQueries<ItemTypeType extends ApiEnumItemType>(itemType: ItemTypeType, parsedQuery: CollectionQuery, itemEntries: Array<ItemEntry<ItemTypeType>>): Array<ItemEntry<ItemTypeType>>;
-    /**
-     * @description
-     * Expands the option's {@link CollectionOptions.columns columns} with the columns required for the {@link CollectionMatcherCachedCollectionProcessor CollectionMatcher} to function.
-     * Data fetched for a parent transaction might also fit in a child transaction, so those {@link CollectionOptions.queryColumns queryColumns} should also be taken into account
-     */
-    expandColumnsWithQueryColumns(itemType: ApiEnumItemType, options: CollectionOptions, query: ApiQuery): void;
-}
+import { ApiEnumItemType, ItemId } from '@rentman/backend-types';
+import { AbstractCache, ApiQuery, ApiRequestColumns, CachedQueryItem, CollectionEntryService, CollectionOptions, CollectionQuery, ColumnSubsetCache, ColumnUtil, ItemEntry, ParentIdMap, ParentItemMap, PromiseInterface, PromiseLibraryInterface, RequestColumnExpansionFactory } from '../../internal';
+export declare type CachedQueryItemTree<ItemTypeType extends ApiEnumItemType = any> = {
+    item: CachedQueryItem<ItemTypeType>;
+    children: ParentItemMap<CachedQueryItemTree> | null;
+};
+export declare abstract class CachedQueryHandlerBase {
+    protected collectionEntryService: CollectionEntryService;
+    protected columnUtil: ColumnUtil;
+    protected requestColumnExpansionFactory: RequestColumnExpansionFactory;
+    protected promiseService: PromiseLibraryInterface;
+    protected transaction: AbstractCache;
+    /**
+     * @description
+     * Items (per ItemType) that fit in a query
+     *
+     * @remark
+     * Contains the requestColumns so that new items can include these columns (saving requests when they match)
+     */
+    cachedQueries: {
+        [itemType: string]: {
+            [queryString: string]: CachedQueryItem;
+        };
+    };
+    protected constructor(collectionEntryService: CollectionEntryService, columnUtil: ColumnUtil, requestColumnExpansionFactory: RequestColumnExpansionFactory, promiseService: PromiseLibraryInterface, transaction: AbstractCache);
+    /**
+     * Every time a cached query item is created, either 'resolve' or 'reject' has to be called on the cached query item.
+     */
+    setCachedQuery<ItemTypeType extends ApiEnumItemType>(itemType: ItemTypeType, parsedQuery: CollectionQuery, requestColumns: ApiRequestColumns, itemEntries?: Array<ItemEntry<ItemTypeType>>): CachedQueryItem<ItemTypeType>;
+    /**
+     * Every time a cached query item is created, either 'resolve' or 'reject' has to be called on the cached query item.
+     */
+    protected constructCachedQuery<ItemTypeType extends ApiEnumItemType>(itemType: ItemTypeType, parsedQuery: CollectionQuery, itemEntries: Array<ItemEntry<ItemTypeType>>, requestColumns: ApiRequestColumns): CachedQueryItem<ItemTypeType>;
+    getCachedQueryItems<ItemTypeType extends ApiEnumItemType>(itemType: ItemTypeType, queryString: string): undefined | Array<ItemEntry<ItemTypeType>>;
+    getCachedQueryObjectsByItemType(itemType: ApiEnumItemType): CachedQueryItem[];
+    /**
+     * @description
+     * Fetches a {@link CollectionEntry CollectionEntry} with the given options
+     */
+    abstract __fetchCachedQueryItem<ItemTypeType extends ApiEnumItemType>(itemType: ItemTypeType, options: CollectionOptions): PromiseInterface<CachedQueryItem<ItemTypeType>>;
+    /**
+     * @description
+     * Fetches collections linked to the passed parents
+     */
+    abstract __fetchItemEntriesByQueryData<ItemTypeType extends ApiEnumItemType>(itemType: ItemTypeType, options: CollectionOptions<ItemTypeType>, columnSubsetCache: ColumnSubsetCache<ItemTypeType>, collectionQuery: CollectionQuery): PromiseInterface<CachedQueryItem<ItemTypeType>>;
+    /**
+     * @description
+     * Fetches collections linked to the passed parents
+     */
+    abstract __fetchLinkedCachedQueryItems<ItemTypeType extends ApiEnumItemType>(parentType: ApiEnumItemType, parentIdArray: ItemId[] | (() => ItemId[]), itemType: ItemTypeType, options: CollectionOptions): PromiseInterface<ParentIdMap<CachedQueryItem<ItemTypeType>>>;
+    /**
+     * @description
+     * Adds the passed {@link ItemEntry ItemEntries} to the Transaction's query cache,
+     * will skip the ItemEntry if the `skipEntryFilterFn` callback returns `true`
+     */
+    protected __addItemEntriesToCachedQueries<ItemTypeType extends ApiEnumItemType>(itemType: ItemTypeType, parsedQuery: CollectionQuery, itemEntries: Array<ItemEntry<ItemTypeType>>, skipEntryFilterFn: (temEntry: ItemEntry) => boolean): void;
+    /**
+     * @description
+     * Removes the passed {@link ItemId ItemIds} from the Transaction's query cache
+     */
+    __removeItemEntriesFromCachedQueries<ItemTypeType extends ApiEnumItemType>(itemType: ItemTypeType, parsedQuery: CollectionQuery, itemEntries: Array<ItemEntry<ItemTypeType>>): Array<ItemEntry<ItemTypeType>>;
+    /**
+     * @description
+     * Expands the option's {@link CollectionOptions.columns columns} with the columns required for the {@link CollectionMatcherCachedCollectionProcessor CollectionMatcher} to function.
+     * Data fetched for a parent transaction might also fit in a child transaction, so those {@link CollectionOptions.queryColumns queryColumns} should also be taken into account
+     */
+    expandColumnsWithQueryColumns(itemType: ApiEnumItemType, options: CollectionOptions, query: ApiQuery): void;
+}