@acorex/platform 20.2.4-next.9 → 20.3.0-next.1

package/layout/entity/index.d.ts

@@ -1,15 +1,15 @@
 import * as _angular_core from '@angular/core';
-import { InjectionToken, Injector, Type } from '@angular/core';
+import { InjectionToken, Injector, EnvironmentProviders, Type } from '@angular/core';
 import { AXStyleColorType, AXDataSource, AXDataSourceFilterOption } from '@acorex/cdk/common';
 import * as _acorex_platform_common from '@acorex/platform/common';
-import { AXPEntityCommandScope, AXPEntity, AXPEntityAction, AXPEntityProperty, AXPEntityTableColumn, AXPRelatedEntity, AXPEntitySectionView, AXPGridLayoutOptions, AXPEntityPropertyCreateView, AXPEntityPropertyLayoutConfig, AXPQueryView, AXPEntityPropertyView, AXPCategoryEntity, AXPEntityPropertyGroup, AXPEntityMasterCreateLayoutView, AXPEntityMasterUpdateLayoutView, AXPEntityMasterSingleLayoutView, AXPEntityMasterListView, AXPEntityDetailListView, AXPQueryFilter } from '@acorex/platform/common';
+import { AXPEntityCommandScope, AXPEntity, AXPEntityAction, AXPEntityProperty, AXPEntityTableColumn, AXPRelatedEntity, AXPEntitySectionView, AXPGridLayoutOptions, AXPEntityPropertyCreateView, AXPEntityPropertyLayoutConfig, AXPQueryView, AXPEntityPropertyView, AXPCategoryEntity, AXPEntityPropertyGroup, AXPEntityMasterCreateLayoutView, AXPEntityMasterUpdateLayoutView, AXPEntityMasterSingleLayoutView, AXPEntityDetailListView, AXPQueryFilter } from '@acorex/platform/common';
 import { AXPMetaData, AXPBreadcrumbItem, AXPFilterQuery, AXPFilterDefinition, AXPExecuteCommand, AXPQueryRequest, AXPPagedListResult, AXPAppStartUpService } from '@acorex/platform/core';
 import * as i3 from '@acorex/platform/layout/builder';
 import { AXPWidgetColumnNode, AXPWidgetNode, AXPLayoutBuilderService } from '@acorex/platform/layout/builder';
 import * as i1 from '@angular/router';
 import { ResolveFn } from '@angular/router';
-import * as rxjs from 'rxjs';
 import { Subject } from 'rxjs';
+import * as _acorex_platform_layout_entity from '@acorex/platform/layout/entity';
 import * as i2 from '@acorex/platform/workflow';
 import { AXPWorkflowAction, AXPWorkflowContext, AXPWorkflow } from '@acorex/platform/workflow';
 
@@ -41,8 +41,8 @@ declare class AXPEntityCommandTriggerViewModel {
     constructor(entity: AXPEntity, action: AXPEntityAction);
 }
 declare class AXPEntityListViewColumnViewModel {
-    readonly property: AXPEntityProperty;
-    readonly column: AXPEntityTableColumn;
+    private property;
+    private column;
     constructor(property: AXPEntityProperty, column: AXPEntityTableColumn);
     name: string;
     title: string;
@@ -185,12 +185,9 @@ declare class AXPEntityMasterListViewModel {
     private readonly settings;
     private readonly widgetResolver;
     private readonly expressionEvaluator;
-    private readonly commandService;
     private readonly filterOperatorMiddleware;
     private settingEntityKey;
     private readonly destroyed;
-    private lastAppliedSortKey;
-    private lastAppliedFilterKey;
     events$: Subject<{
         action: string;
         meta?: any;
@@ -201,7 +198,7 @@ declare class AXPEntityMasterListViewModel {
     dataSource: AXDataSource<unknown>;
     constructor(injector: Injector, config: AXPEntity);
     applySettings(): Promise<void>;
-    saveSettings(changesType: 'columnSizes' | 'columnOrders' | 'view' | 'pageSize' | 'filters' | 'sorts', data?: any): Promise<void>;
+    saveSettings(changesType: 'columnSizes' | 'columnOrders' | 'view' | 'pageSize', data?: any): Promise<void>;
     selectedItems: _angular_core.WritableSignal<any[]>;
     parentKey: _angular_core.Signal<string | undefined>;
     hasSelectedItems: _angular_core.Signal<boolean>;
@@ -263,6 +260,7 @@ declare class AXPEntityMasterSingleViewGroupViewModel {
     group: _acorex_platform_common.AXPEntityPropertyGroup;
     name: _angular_core.WritableSignal<string>;
     isLoading: _angular_core.WritableSignal<boolean>;
+    type: _angular_core.WritableSignal<"wrapper" | "section">;
     title: _angular_core.Signal<string>;
     description: _angular_core.Signal<string | null | undefined>;
     layout: _angular_core.Signal<AXPGridLayoutOptions>;
@@ -293,14 +291,10 @@ declare class AXPEntityMasterSingleViewModel {
     private readonly session;
     private readonly formatService;
     private readonly workflow;
-    private readonly commandService;
     private readonly destroyed;
     private translateService;
     private entityService;
     private expressionEvaluator;
-    private entityDefinitionRegistryService;
-    private _updateTrigger;
-    readonly updateTrigger: _angular_core.Signal<number>;
     constructor(injector: Injector, config: AXPEntity, entityData: any);
     context: _angular_core.WritableSignal<any>;
     private actions;
@@ -348,6 +342,7 @@ declare class AXPEntityMasterUpdateViewModel {
     private props;
     private entityDef;
     private workflow;
+    private lockService;
     private sessionService;
     private get moduleName();
     private get entityName();
@@ -359,6 +354,7 @@ declare class AXPEntityMasterUpdateViewModel {
     elements: _angular_core.Signal<AXPEntityMasterUpdateElementViewModel[]>;
     save(): Promise<any>;
     reset(): void;
+    unlock(): Promise<void>;
 }
 declare class AXPEntityMasterUpdateViewModelFactory {
     private entityService;
@@ -457,10 +453,6 @@ interface AXPEntityModifierContext {
                 get(): AXPEntityMasterSingleLayoutView | undefined;
                 update(updater: (c: AXPEntityMasterSingleLayoutView | undefined) => AXPEntityMasterSingleLayoutView): AXPEntityModifierContext;
             };
-            list: {
-                get(): AXPEntityMasterListView | undefined;
-                update(updater: (c: AXPEntityMasterListView | undefined) => AXPEntityMasterListView): AXPEntityModifierContext;
-            };
         };
         detail: {
             get(): NonNullable<AXPEntity['interfaces']>['detail'] | undefined;
@@ -475,31 +467,16 @@ interface AXPEntityModifierContext {
 }
 type AXPEntityModifier = (context: AXPEntityModifierContext) => void;
 interface AXPEntityModifierProvider {
-    entityName: string | RegExp;
+    entityName: string;
     modifier: AXPEntityModifier;
 }
 
-declare function ensureListActions(ctx: AXPEntityModifierContext): void;
-declare function actionExists(actions: any[] | undefined, commandName: string, name?: string): boolean;
-
-interface AXPEntityActionPlugin {
-    name: string;
-    order?: number;
-    apply: (ctx: AXPEntityModifierContext, options?: any) => Promise<void> | void;
-}
-declare const AXP_ENTITY_ACTION_PLUGIN: InjectionToken<AXPEntityActionPlugin[]>;
-
 declare class AXPEntityMiddleware {
-    private exactModifiers;
-    private patternModifiers;
-    protected providedModifiers: AXPEntityModifierProvider[];
-    protected providedActionPlugins: AXPEntityActionPlugin[];
-    protected injector: Injector;
+    private modifiers;
+    protected providedModifiers: _acorex_platform_layout_entity.AXPEntityModifierProvider[];
     constructor();
-    register(entityName: string | RegExp, modifier: AXPEntityModifier): void;
-    process(entity: AXPEntity): Promise<AXPEntity>;
-    private wildcardToRegExp;
-    private normalizeRegExp;
+    register(entityName: string, modifier: AXPEntityModifier): void;
+    process(entity: AXPEntity): AXPEntity;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPEntityMiddleware, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPEntityMiddleware>;
 }
@@ -508,6 +485,56 @@ declare function createModifierContext(entity: AXPEntity): AXPEntityModifierCont
 
 declare const AXP_ENTITY_MODIFIER: InjectionToken<AXPEntityModifierProvider[]>;
 
+interface AXPEntityPreloadEntity {
+    module: string;
+    entity: string;
+}
+interface AXPEntityDefinitionPreloader {
+    preload(): AXPEntityPreloadEntity[];
+}
+declare class AXPEntityDefinitionRegistryService {
+    private providers;
+    private resolver;
+    private middleware;
+    preload(): Promise<void>;
+    private entities;
+    private entityResolver;
+    /**
+     * Registers a new entity configuration. Entities are identified uniquely by a combination
+     * of their module and name.
+     *
+     * @param config The configuration object of the entity to be registered.
+     */
+    register(config: AXPEntity): void;
+    /**
+     * Returns an array of all registered entity configurations.
+     *
+     * @returns An array of AXPEntity objects.
+     */
+    getAll(): AXPEntity[];
+    /**
+     * Resolves an entity configuration based on module and entity name. If the configuration
+     * is not already registered, attempts to load it dynamically. Throws an error if the
+     * entity cannot be found or loaded.
+     *
+     * @param moduleName The module name of the entity.
+     * @param entityName The name of the entity.
+     * @returns A promise resolving to the entity configuration.
+     * @throws Error if the entity configuration cannot be resolved.
+     */
+    resolve(moduleName: string, entityName: string): Promise<AXPEntity>;
+    /**
+     * Creates a unique key for an entity based on its module and name.
+     *
+     * @param moduleName The module name of the entity.
+     * @param entityName The name of the entity.
+     * @returns The unique key for the entity.
+     */
+    private createEntityKey;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPEntityDefinitionRegistryService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPEntityDefinitionRegistryService>;
+}
+
 interface AXPAuditable {
     createdAt?: Date;
     updatedAt?: Date;
@@ -530,31 +557,6 @@ interface AXPEntityDetailDto<Id> extends AXPEntityOutputDto<Id> {
 interface AXPEntityListItemDto<Id> extends AXPEntityOutputDto<Id> {
 }
 
-type AXPEntityOp = 'initial' | 'create' | 'update' | 'delete' | 'getOne' | 'getAll' | 'query';
-interface AXPEntityStorageContext<TKey = any, TDetailDto extends AXPEntityDetailDto<TKey> = any, TListItemDto extends AXPEntityListItemDto<TKey> = any, TCreateDto extends AXPEntityCreateDto = any, TUpdateDto extends AXPEntityUpdateDto<TKey> = any> {
-    op: AXPEntityOp;
-    entityName: string;
-    id?: TKey;
-    data?: TCreateDto | Omit<Partial<TUpdateDto>, 'id'>;
-    request?: AXPQueryRequest;
-    previous?: TDetailDto;
-    result?: any;
-    locals: Map<string, unknown>;
-    backend: {
-        getOneRaw: (entityName: string, id: TKey) => Promise<TDetailDto>;
-        insertOneRaw: (entityName: string, entity: TCreateDto) => Promise<TKey>;
-    };
-}
-interface AXPEntityStorageMiddleware<TKey = any, TDetailDto extends AXPEntityDetailDto<TKey> = any, TListItemDto extends AXPEntityListItemDto<TKey> = any, TCreateDto extends AXPEntityCreateDto = any, TUpdateDto extends AXPEntityUpdateDto<TKey> = any> {
-    target?: {
-        ops?: AXPEntityOp[];
-        entity?: string | RegExp;
-        predicate?: (ctx: AXPEntityStorageContext<TKey, TDetailDto, TListItemDto, TCreateDto, TUpdateDto>) => boolean;
-        order?: number;
-    };
-    execute: (ctx: AXPEntityStorageContext<TKey, TDetailDto, TListItemDto, TCreateDto, TUpdateDto>, next: () => Promise<void>) => Promise<void>;
-}
-
 declare abstract class AXPEntityStorageService<TKey, TDetailDto extends AXPEntityDetailDto<TKey> = AXPEntityModel<TKey>, TListItemDto extends AXPEntityListItemDto<TKey> = TDetailDto, TCreateDto extends AXPEntityCreateDto = TDetailDto, TUpdateDto extends AXPEntityUpdateDto<TKey> = TDetailDto> {
     abstract get dbName(): string;
     abstract initial(entityName: string, collection: TCreateDto[], options?: {
@@ -621,115 +623,295 @@ declare class AXMEntityCrudServiceImpl<TKey, TDetailDto extends AXPEntityDetailD
     get storageService(): AXPEntityStorageService<any, any, any, any, any>;
 }
 
-declare const AXP_ENTITY_STORAGE_BACKEND: InjectionToken<AXPEntityStorageService<any, any, any, any, any>>;
-declare const AXP_ENTITY_STORAGE_MIDDLEWARE: InjectionToken<AXPEntityStorageMiddleware<any, any, any, any, any>[]>;
+/**
+ * Context object for entity storage operations
+ */
+interface AXPEntityStorageContext<TKey = any, TDetailDto extends AXPEntityDetailDto<TKey> = any, TListItemDto extends AXPEntityListItemDto<TKey> = any, TCreateDto extends AXPEntityCreateDto = any, TUpdateDto extends AXPEntityUpdateDto<TKey> = any> {
+    /** Operation type being performed */
+    operation: 'getOne' | 'getAll' | 'insertOne' | 'updateOne' | 'deleteOne' | 'query' | 'initial';
+    /** Entity name */
+    entityName: string;
+    /** Database name */
+    dbName: string;
+    /** Input parameters for the operation */
+    input: {
+        id?: TKey;
+        entity?: TCreateDto;
+        keyValues?: Omit<Partial<TUpdateDto>, 'id'>;
+        request?: AXPQueryRequest;
+        collection?: TCreateDto[];
+        options?: {
+            mergeType?: 'merge' | 'replace';
+            uniqueKeys?: string[];
+        };
+    };
+    /** Metadata for the operation */
+    metadata: {
+        startTime: number;
+        requestId: string;
+        user?: any;
+        [key: string]: any;
+    };
+}
+/**
+ * Entity Storage Middleware function type
+ */
+type AXPEntityStorageMiddleware<TKey = any, TDetailDto extends AXPEntityDetailDto<TKey> = any, TListItemDto extends AXPEntityListItemDto<TKey> = any, TCreateDto extends AXPEntityCreateDto = any, TUpdateDto extends AXPEntityUpdateDto<TKey> = any, TResult = any> = (context: AXPEntityStorageContext<TKey, TDetailDto, TListItemDto, TCreateDto, TUpdateDto>, next: (context: AXPEntityStorageContext<TKey, TDetailDto, TListItemDto, TCreateDto, TUpdateDto>) => Promise<TResult>) => Promise<TResult>;
+/**
+ * Compose entity storage middlewares into a pipeline
+ */
+declare function composeEntityStorageMiddlewares<TKey = any, TDetailDto extends AXPEntityDetailDto<TKey> = any, TListItemDto extends AXPEntityListItemDto<TKey> = any, TCreateDto extends AXPEntityCreateDto = any, TUpdateDto extends AXPEntityUpdateDto<TKey> = any, TResult = any>(middlewares: AXPEntityStorageMiddleware<TKey, TDetailDto, TListItemDto, TCreateDto, TUpdateDto, TResult>[]): (handler: (context: AXPEntityStorageContext<TKey, TDetailDto, TListItemDto, TCreateDto, TUpdateDto>) => Promise<TResult>) => (context: AXPEntityStorageContext<TKey, TDetailDto, TListItemDto, TCreateDto, TUpdateDto>) => Promise<TResult>;
+/**
+ * Helper function to generate unique request ID
+ */
+declare function generateRequestId(): string;
+
+/**
+ * Registry for managing entity storage middlewares
+ */
+declare class AXPEntityStorageRegistry {
+    private globalMiddlewares;
+    private entitySpecificMiddlewares;
+    private operationSpecificMiddlewares;
+    /**
+     * Add a global middleware that applies to all operations
+     */
+    useGlobal(middleware: AXPEntityStorageMiddleware): void;
+    /**
+     * Add middleware for specific entity
+     */
+    useForEntity(entityName: string, middleware: AXPEntityStorageMiddleware): void;
+    /**
+     * Add middleware for specific operation (getOne, insertOne, etc.)
+     */
+    useForOperation(operation: string, middleware: AXPEntityStorageMiddleware): void;
+    /**
+     * Get all applicable middlewares for a given context
+     */
+    getMiddlewares(entityName: string, operation: string): AXPEntityStorageMiddleware[];
+    /**
+     * Get all global middlewares
+     */
+    getGlobalMiddlewares(): readonly AXPEntityStorageMiddleware[];
+    /**
+     * Remove middleware from global middlewares
+     */
+    removeGlobalMiddleware(middleware: AXPEntityStorageMiddleware): boolean;
+    /**
+     * Clear all middlewares
+     */
+    clear(): void;
+    /**
+     * Get registered entity names that have specific middlewares
+     */
+    getRegisteredEntityNames(): string[];
+    /**
+     * Get registered operation names that have specific middlewares
+     */
+    getRegisteredOperations(): string[];
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPEntityStorageRegistry, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPEntityStorageRegistry>;
+}
 
-declare class AXPMiddlewareEntityStorageService<TKey = any, TDetailDto extends AXPEntityDetailDto<TKey> = any, TListItemDto extends AXPEntityListItemDto<TKey> = any, TCreateDto extends AXPEntityCreateDto = any, TUpdateDto extends AXPEntityUpdateDto<TKey> = any> extends AXPEntityStorageService<TKey, TDetailDto, TListItemDto, TCreateDto, TUpdateDto> {
-    private readonly backend;
-    private readonly allMiddlewares;
+/**
+ * Executor that wraps entity storage operations with middleware pipeline
+ */
+declare class AXPEntityStorageExecutor<TKey = any, TDetailDto extends AXPEntityDetailDto<TKey> = any, TListItemDto extends AXPEntityListItemDto<TKey> = any, TCreateDto extends AXPEntityCreateDto = any, TUpdateDto extends AXPEntityUpdateDto<TKey> = any> {
+    private storageService;
     private readonly injector;
-    get dbName(): string;
-    private filterMiddlewares;
-    private compose;
-    private run;
-    private createCtx;
-    initial(entityName: string, collection: TCreateDto[], options?: {
-        mergeType?: 'merge' | 'replace';
-        uniqueKeys?: string[];
-    }): Promise<TCreateDto[]>;
+    private readonly registry;
+    constructor(storageService: AXPEntityStorageService<TKey, TDetailDto, TListItemDto, TCreateDto, TUpdateDto>);
+    /**
+     * Execute getOne operation with middleware pipeline
+     */
     getOne(entityName: string, id: TKey): Promise<TDetailDto>;
+    /**
+     * Execute getAll operation with middleware pipeline
+     */
+    getAll(entityName: string): Promise<TListItemDto[]>;
+    /**
+     * Execute insertOne operation with middleware pipeline
+     */
+    insertOne(entityName: string, entity: TCreateDto): Promise<TKey>;
+    /**
+     * Execute updateOne operation with middleware pipeline
+     */
     updateOne(entityName: string, id: TKey, keyValues: Omit<Partial<TUpdateDto>, 'id'>): Promise<TDetailDto>;
+    /**
+     * Execute deleteOne operation with middleware pipeline
+     */
     deleteOne(entityName: string, id: TKey): Promise<void>;
-    insertOne(entityName: string, entity: TCreateDto): Promise<TKey>;
-    getAll(entityName: string): Promise<TListItemDto[]>;
+    /**
+     * Execute query operation with middleware pipeline
+     */
     query(entityName: string, request: AXPQueryRequest): Promise<AXPPagedListResult<TListItemDto>>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPMiddlewareEntityStorageService<any, any, any, any, any>, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPMiddlewareEntityStorageService<any, any, any, any, any>>;
-}
-
-interface AXPEntityPreloadEntity {
-    module: string;
-    entity: string;
-}
-interface AXPEntityDefinitionPreloader {
-    preload(): AXPEntityPreloadEntity[];
-}
-declare class AXPEntityDefinitionRegistryService {
-    private providers;
-    private resolver;
-    private middleware;
-    private onChanged;
-    get onChanged$(): rxjs.Observable<{
-        name: string;
-    }>;
-    preload(): Promise<void>;
-    private entities;
-    private entityResolver;
     /**
-     * Force re-load and re-process entity definitions, then re-register them.
-     * Overloads:
-     *  - refresh(): refresh all registered entities
-     *  - refresh(fullName: string): refresh by fully-qualified name `<module>.<entity>`
-     *  - refresh(moduleName: string, entityName: string): refresh by parts
+     * Execute initial operation with middleware pipeline
      */
-    refresh(): Promise<void>;
-    refresh(fullName: string): Promise<void>;
-    refresh(moduleName: string, entityName: string): Promise<void>;
-    /** Executes the actual refresh for a single entity */
-    private refreshOne;
+    initial(entityName: string, collection: TCreateDto[], options?: {
+        mergeType?: 'merge' | 'replace';
+        uniqueKeys?: string[];
+    }): Promise<TCreateDto[]>;
     /**
-     * Registers a new entity configuration. Entities are identified uniquely by a combination
-     * of their module and name.
-     *
-     * @param config The configuration object of the entity to be registered.
+     * Execute operation with middleware pipeline
      */
-    register(config: AXPEntity): void;
+    private executeWithMiddleware;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPEntityStorageExecutor<any, any, any, any, any>, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPEntityStorageExecutor<any, any, any, any, any>>;
+}
+
+/**
+ * Entity Storage Service with middleware support
+ *
+ * This service wraps the original AXPEntityStorageService and adds middleware pipeline support.
+ * It delegates all operations to the middleware executor which applies the middleware chain.
+ */
+declare class AXPEntityStorageWithMiddlewareService<TKey = any, TDetailDto extends AXPEntityDetailDto<TKey> = any, TListItemDto extends AXPEntityListItemDto<TKey> = any, TCreateDto extends AXPEntityCreateDto = any, TUpdateDto extends AXPEntityUpdateDto<TKey> = any> extends AXPEntityStorageService<TKey, TDetailDto, TListItemDto, TCreateDto, TUpdateDto> {
+    private originalStorageService;
+    private registry;
+    private executor;
+    constructor(originalStorageService: AXPEntityStorageService<TKey, TDetailDto, TListItemDto, TCreateDto, TUpdateDto>, registry: AXPEntityStorageRegistry);
+    get dbName(): string;
     /**
-     * Returns an array of all registered entity configurations.
-     *
-     * @returns An array of AXPEntity objects.
+     * Add a global middleware that applies to all operations
      */
-    getAll(): AXPEntity[];
+    useGlobal(middleware: AXPEntityStorageMiddleware): void;
     /**
-     * Resolves an entity configuration based on module and entity name. If the configuration
-     * is not already registered, attempts to load it dynamically. Throws an error if the
-     * entity cannot be found or loaded.
-     *
-     * @param moduleName The module name of the entity.
-     * @param entityName The name of the entity.
-     * @returns A promise resolving to the entity configuration.
-     * @throws Error if the entity configuration cannot be resolved.
+     * Add middleware for specific entity
      */
-    resolve(moduleName: string, entityName: string): Promise<AXPEntity>;
+    useForEntity(entityName: string, middleware: AXPEntityStorageMiddleware): void;
     /**
-     * Creates a unique key for an entity based on its module and name.
-     *
-     * @param moduleName The module name of the entity.
-     * @param entityName The name of the entity.
-     * @returns The unique key for the entity.
+     * Add middleware for specific operation
      */
-    private createEntityKey;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPEntityDefinitionRegistryService, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPEntityDefinitionRegistryService>;
+    useForOperation(operation: string, middleware: AXPEntityStorageMiddleware): void;
+    initial(entityName: string, collection: TCreateDto[], options?: {
+        mergeType?: 'merge' | 'replace';
+        uniqueKeys?: string[];
+    }): Promise<TCreateDto[]>;
+    getOne(entityName: string, id: TKey): Promise<TDetailDto>;
+    updateOne(entityName: string, id: TKey, keyValues: Omit<Partial<TUpdateDto>, 'id'>): Promise<TDetailDto>;
+    deleteOne(entityName: string, id: TKey): Promise<void>;
+    insertOne(entityName: string, entity: TCreateDto): Promise<TKey>;
+    getAll(entityName: string): Promise<TListItemDto[]>;
+    query(entityName: string, request: AXPQueryRequest): Promise<AXPPagedListResult<TListItemDto>>;
+    get originalService(): AXPEntityStorageService<TKey, TDetailDto, TListItemDto, TCreateDto, TUpdateDto>;
+    get middlewareRegistry(): AXPEntityStorageRegistry;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPEntityStorageWithMiddlewareService<any, any, any, any, any>, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPEntityStorageWithMiddlewareService<any, any, any, any, any>>;
 }
 
 /**
- * Entity Event Dispatcher - A wrapper for entity-specific events
- * Handles pattern-based dispatching for entity operations with wildcard support
+ * Injection token for entity storage middleware setup
+ */
+declare const AXP_ENTITY_STORAGE_MIDDLEWARE_SETUP: InjectionToken<void>;
+/**
+ * Injection token for entity storage middleware extensions
  */
-declare class AXPEntityEventDispatcherService {
-    private readonly eventService;
-    dispatchEntityEvent(operation: 'inserted' | 'updated' | 'deleted', entityName: string, data: any): Promise<void>;
-    private getAllMatchingEventKeys;
-    private findMatchingWildcardKeys;
-    private matchesEntityPattern;
-    private generateEventKeys;
-    dispatchInserted(entityName: string, data: any): Promise<void>;
-    dispatchUpdated(entityName: string, data: any): Promise<void>;
-    dispatchDeleted(entityName: string, data: any): Promise<void>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPEntityEventDispatcherService, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPEntityEventDispatcherService>;
+declare const AXP_ENTITY_STORAGE_EXTENSION: InjectionToken<{
+    target: string | RegExp;
+    middleware: AXPEntityStorageMiddleware;
+}>;
+/**
+ * Configuration for entity-specific middleware
+ */
+interface AXPEntityStorageMiddlewareConfig {
+    /** Global middlewares that apply to all operations */
+    global?: AXPEntityStorageMiddleware[];
+    /** Entity-specific middlewares */
+    entities?: {
+        [entityName: string]: AXPEntityStorageMiddleware[];
+    };
+    /** Operation-specific middlewares */
+    operations?: {
+        [operation: string]: AXPEntityStorageMiddleware[];
+    };
+    /** Advanced middleware configurations with targets */
+    extensions?: {
+        target: string | RegExp;
+        middleware: AXPEntityStorageMiddleware;
+    }[];
 }
+/**
+ * Provide entity storage middleware configuration
+ */
+declare function provideEntityStorageMiddleware(config: AXPEntityStorageMiddlewareConfig): EnvironmentProviders;
+/**
+ * Simplified provider for global middleware only
+ */
+declare function provideGlobalEntityStorageMiddleware(middlewares: AXPEntityStorageMiddleware[]): EnvironmentProviders;
+/**
+ * Provider for entity-specific middlewares
+ */
+declare function provideEntitySpecificMiddleware(entityName: string, middlewares: AXPEntityStorageMiddleware[]): EnvironmentProviders;
+/**
+ * Provider for operation-specific middlewares
+ */
+declare function provideOperationSpecificMiddleware(operation: string, middlewares: AXPEntityStorageMiddleware[]): EnvironmentProviders;
+
+/**
+ * Logging middleware for entity storage operations
+ */
+declare const loggingMiddleware: AXPEntityStorageMiddleware;
+/**
+ * Performance monitoring middleware
+ */
+declare const performanceMiddleware: AXPEntityStorageMiddleware;
+/**
+ * Error handling middleware with retry logic
+ */
+declare const errorHandlingMiddleware: AXPEntityStorageMiddleware;
+/**
+ * Validation middleware
+ */
+declare const validationMiddleware: AXPEntityStorageMiddleware;
+/**
+ * Caching middleware (simple in-memory cache)
+ */
+declare const cachingMiddleware: AXPEntityStorageMiddleware;
+
+/**
+ * Audit trail entry interface
+ */
+interface AXPAuditEntry {
+    id: string;
+    entityName: string;
+    operation: string;
+    entityId?: any;
+    changes?: any;
+    user?: string;
+    timestamp: Date;
+    requestId: string;
+    metadata?: any;
+}
+/**
+ * Audit trail storage interface
+ */
+interface AXPAuditStorage {
+    save(entry: AXPAuditEntry): Promise<void>;
+}
+/**
+ * Simple in-memory audit storage (for demo purposes)
+ */
+declare class InMemoryAuditStorage implements AXPAuditStorage {
+    private entries;
+    save(entry: AXPAuditEntry): Promise<void>;
+    getEntries(): AXPAuditEntry[];
+    getEntriesForEntity(entityName: string): AXPAuditEntry[];
+    clear(): void;
+}
+declare const auditStorage: InMemoryAuditStorage;
+/**
+ * Audit middleware that tracks all entity operations
+ */
+declare const auditMiddleware: AXPEntityStorageMiddleware;
+/**
+ * User context middleware - adds user information to context
+ */
+declare const userContextMiddleware: AXPEntityStorageMiddleware;
+/**
+ * Data sanitization middleware - removes sensitive data from logs
+ */
+declare const dataSanitizationMiddleware: AXPEntityStorageMiddleware;
 
 interface AXPEntityConfigs {
     viewers: {
@@ -739,7 +921,6 @@ interface AXPEntityConfigs {
         };
         master: {
             single: () => Type<any> | Promise<Type<any>>;
-            details: () => Type<any> | Promise<Type<any>>;
             create: () => Type<any> | Promise<Type<any>>;
             modify: () => Type<any> | Promise<Type<any>>;
             list: () => Type<any> | Promise<Type<any>>;
@@ -909,52 +1090,11 @@ declare function entityMasterCrudActions(): AXPEntityAction[];
 declare function entityMasterRecordActions(): AXPEntityAction[];
 declare function entityDetailsCreateActions(parentId: string): AXPEntityAction;
 declare function entityDetailsSimpleCondition(fk: string): AXPQueryFilter;
-declare function entityDetailsReferenceCondition(type: string): AXPQueryFilter[];
+declare function entityDetailsReferenceCondition(): AXPQueryFilter[];
 declare function entityDetailsEditAction(): AXPEntityAction;
 declare function entityOverrideDetailsViewAction(): AXPEntityAction;
 declare function entityDetailsCrudActions(parentId: string): AXPEntityAction[];
-declare function entityDetailsReferenceCreateActions(type: string): AXPEntityAction[];
-type AXPEntityChangeSet = {
-    [key: string]: {
-        oldValue: any;
-        newValue: any;
-        added?: any[];
-        removed?: any[];
-    };
-};
-/**
- * Computes a diff between two plain objects with array-aware semantics.
- * - For arrays of objects with an id field, computes added/removed by id.
- * - For arrays of primitives or objects without id, uses deep equality.
- * - For scalars/objects, reports oldValue/newValue when changed.
- */
-declare function detectEntityChanges(oldObj: any, newObj: any): AXPEntityChangeSet;
-
-declare const eventDispatchMiddleware: AXPEntityStorageMiddleware;
-
-/**
- * Map of column name -> width value
- * Example: { title: '300px', description: '300px' }
- */
-type ColumnWidthConfig = Record<string, string | number>;
-/**
- * Default widths for common text columns
- */
-declare const DEFAULT_COLUMN_WIDTHS: ColumnWidthConfig;
-/**
- * Factory to create a column width middleware using provided config map.
- * Sets width for columns defined in the map if not already defined on the column.
- */
-declare const columnWidthMiddlewareFactory: (widths: ColumnWidthConfig) => AXPEntityModifier;
-/**
- * Helper to create a provider for the column width middleware.
- * By default it applies to all entities using the '*' pattern.
- */
-declare const createColumnWidthMiddlewareProvider: (widths: ColumnWidthConfig, entityName?: string | RegExp) => AXPEntityModifierProvider;
-/**
- * Default provider registered with the default map.
- */
-declare const columnWidthMiddlewareProvider: AXPEntityModifierProvider;
+declare function entityDetailsReferenceCreateActions(): AXPEntityAction[];
 
-export { AXMEntityCrudService, AXMEntityCrudServiceImpl, AXPCreateEntityWorkflow, AXPDataSeederService, AXPDeleteEntityWorkflow, AXPEntityApplyUpdatesAction, AXPEntityCommandTriggerViewModel, AXPEntityCreateEvent, AXPEntityCreatePopupAction, AXPEntityCreateSubmittedAction, AXPEntityCreateViewElementViewModel, AXPEntityCreateViewModelFactory, AXPEntityCreateViewSectionViewModel, AXPEntityDataProvider, AXPEntityDataProviderImpl, AXPEntityDefinitionRegistryService, AXPEntityDeletedEvent, AXPEntityDetailListViewModel, AXPEntityDetailViewModelFactory, AXPEntityDetailViewModelResolver, AXPEntityEventDispatcherService, AXPEntityListViewColumnViewModel, AXPEntityListViewModelFactory, AXPEntityListViewModelResolver, AXPEntityMasterCreateViewModel, AXPEntityMasterListViewModel, AXPEntityMasterListViewQueryViewModel, AXPEntityMasterSingleElementViewModel, AXPEntityMasterSingleViewGroupViewModel, AXPEntityMasterSingleViewModel, AXPEntityMasterUpdateElementViewModel, AXPEntityMasterUpdateViewModel, AXPEntityMasterUpdateViewModelFactory, AXPEntityMiddleware, AXPEntityModifyConfirmedAction, AXPEntityModifyEvent, AXPEntityModifySectionPopupAction, AXPEntityModule, AXPEntityPerformDeleteAction, AXPEntityResolver, AXPEntityService, AXPEntityStorageService, AXPMiddlewareEntityStorageService, AXPModifyEntitySectionWorkflow, AXPQuickEntityModifyPopupAction, AXPQuickModifyEntityWorkflow, AXPShowDetailViewAction, AXPShowDetailsViewWorkflow, AXPShowListViewAction, AXPShowListViewWorkflow, AXP_DATA_SEEDER_TOKEN, AXP_ENTITY_ACTION_PLUGIN, AXP_ENTITY_CONFIG_TOKEN, AXP_ENTITY_DEFINITION_LOADER, AXP_ENTITY_MODIFIER, AXP_ENTITY_STORAGE_BACKEND, AXP_ENTITY_STORAGE_MIDDLEWARE, DEFAULT_COLUMN_WIDTHS, actionExists, columnWidthMiddlewareFactory, columnWidthMiddlewareProvider, createColumnWidthMiddlewareProvider, createModifierContext, detectEntityChanges, ensureListActions, entityDetailsCreateActions, entityDetailsCrudActions, entityDetailsEditAction, entityDetailsReferenceCondition, entityDetailsReferenceCreateActions, entityDetailsSimpleCondition, entityMasterBulkDeleteAction, entityMasterCreateAction, entityMasterCrudActions, entityMasterDeleteAction, entityMasterRecordActions, entityMasterViewAction, entityOverrideDetailsViewAction, eventDispatchMiddleware };
-export type { AXPAuditable, AXPDataSeeder, AXPEntityActionPlugin, AXPEntityChangeSet, AXPEntityConfigs, AXPEntityCreateDto, AXPEntityDefinitionLoader, AXPEntityDefinitionPreloader, AXPEntityDeleteOptions, AXPEntityDetailDto, AXPEntityListItemDto, AXPEntityMasterListViewSortPropViewModel, AXPEntityModel, AXPEntityModifier, AXPEntityModifierContext, AXPEntityModifierProvider, AXPEntityOp, AXPEntityOutputDto, AXPEntityPreloadEntity, AXPEntityStorageContext, AXPEntityStorageMiddleware, AXPEntityUpdateDto, ColumnWidthConfig };
+export { AXMEntityCrudService, AXMEntityCrudServiceImpl, AXPCreateEntityWorkflow, AXPDataSeederService, AXPDeleteEntityWorkflow, AXPEntityApplyUpdatesAction, AXPEntityCommandTriggerViewModel, AXPEntityCreateEvent, AXPEntityCreatePopupAction, AXPEntityCreateSubmittedAction, AXPEntityCreateViewElementViewModel, AXPEntityCreateViewModelFactory, AXPEntityCreateViewSectionViewModel, AXPEntityDataProvider, AXPEntityDataProviderImpl, AXPEntityDefinitionRegistryService, AXPEntityDeletedEvent, AXPEntityDetailListViewModel, AXPEntityDetailViewModelFactory, AXPEntityDetailViewModelResolver, AXPEntityListViewColumnViewModel, AXPEntityListViewModelFactory, AXPEntityListViewModelResolver, AXPEntityMasterCreateViewModel, AXPEntityMasterListViewModel, AXPEntityMasterListViewQueryViewModel, AXPEntityMasterSingleElementViewModel, AXPEntityMasterSingleViewGroupViewModel, AXPEntityMasterSingleViewModel, AXPEntityMasterUpdateElementViewModel, AXPEntityMasterUpdateViewModel, AXPEntityMasterUpdateViewModelFactory, AXPEntityMiddleware, AXPEntityModifyConfirmedAction, AXPEntityModifyEvent, AXPEntityModifySectionPopupAction, AXPEntityModule, AXPEntityPerformDeleteAction, AXPEntityResolver, AXPEntityService, AXPEntityStorageExecutor, AXPEntityStorageRegistry, AXPEntityStorageService, AXPEntityStorageWithMiddlewareService, AXPModifyEntitySectionWorkflow, AXPQuickEntityModifyPopupAction, AXPQuickModifyEntityWorkflow, AXPShowDetailViewAction, AXPShowDetailsViewWorkflow, AXPShowListViewAction, AXPShowListViewWorkflow, AXP_DATA_SEEDER_TOKEN, AXP_ENTITY_CONFIG_TOKEN, AXP_ENTITY_DEFINITION_LOADER, AXP_ENTITY_MODIFIER, AXP_ENTITY_STORAGE_EXTENSION, AXP_ENTITY_STORAGE_MIDDLEWARE_SETUP, auditMiddleware, auditStorage, cachingMiddleware, composeEntityStorageMiddlewares, createModifierContext, dataSanitizationMiddleware, entityDetailsCreateActions, entityDetailsCrudActions, entityDetailsEditAction, entityDetailsReferenceCondition, entityDetailsReferenceCreateActions, entityDetailsSimpleCondition, entityMasterBulkDeleteAction, entityMasterCreateAction, entityMasterCrudActions, entityMasterDeleteAction, entityMasterRecordActions, entityMasterViewAction, entityOverrideDetailsViewAction, errorHandlingMiddleware, generateRequestId, loggingMiddleware, performanceMiddleware, provideEntitySpecificMiddleware, provideEntityStorageMiddleware, provideGlobalEntityStorageMiddleware, provideOperationSpecificMiddleware, userContextMiddleware, validationMiddleware };
+export type { AXPAuditEntry, AXPAuditStorage, AXPAuditable, AXPDataSeeder, AXPEntityConfigs, AXPEntityCreateDto, AXPEntityDefinitionLoader, AXPEntityDefinitionPreloader, AXPEntityDeleteOptions, AXPEntityDetailDto, AXPEntityListItemDto, AXPEntityMasterListViewSortPropViewModel, AXPEntityModel, AXPEntityModifier, AXPEntityModifierContext, AXPEntityModifierProvider, AXPEntityOutputDto, AXPEntityPreloadEntity, AXPEntityStorageContext, AXPEntityStorageMiddleware, AXPEntityStorageMiddlewareConfig, AXPEntityUpdateDto };