@acorex-platform/framework-server 0.0.15 → 0.0.20

package/cache/providers/src/lib/server-query-cache.service.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServerQueryCacheService = void 0;
+const tslib_1 = require("tslib");
+const abstract_1 = require("@acorex-platform/framework-server/domain/abstract");
+const core_1 = require("@acorex-platform/framework-server/core");
+const common_1 = require("@nestjs/common");
+const axp_cache_service_1 = require("./axp-cache.service");
+const cache_config_resolver_service_1 = require("./cache-config-resolver.service");
+const cache_key_builder_1 = require("./cache-key-builder");
+//#region ---- Server query cache ----
+const ACX_REQUEST_SESSION_KEY = 'acxRequestSession';
+/**
+ * Wraps {@link AxpCacheService} for declarative {@code @ServerQueryHandler({ cache })}.
+ * Provided as {@link SERVER_QUERY_CACHE} so domain/providers stay decoupled.
+ */
+let ServerQueryCacheService = class ServerQueryCacheService {
+    constructor(cacheService, keyBuilder, configResolver) {
+        this.cacheService = cacheService;
+        this.keyBuilder = keyBuilder;
+        this.configResolver = configResolver;
+    }
+    async wrap(queryKey, input, options, factory) {
+        const globalEnabled = this.configResolver?.getGlobalConfig().enabled ?? this.cacheService.isEnabled();
+        const enabled = globalEnabled && (options.enabled ?? abstract_1.DEFAULT_SERVER_QUERY_CACHE_OPTIONS.enabled);
+        if (!enabled) {
+            return factory();
+        }
+        const session = this.resolveSession(options.scope ?? abstract_1.DEFAULT_SERVER_QUERY_CACHE_OPTIONS.scope);
+        const inputHash = this.keyBuilder.hashQueryInput(input);
+        const cacheKey = this.keyBuilder.buildNamespaceKey(`query:${queryKey}`, inputHash, session);
+        const ttlMs = options.ttlMs ?? this.configResolver?.getGlobalConfig().ttlMs ?? 60_000;
+        // Cache failures must never break the query path.
+        const cached = await this.cacheService.get(cacheKey).catch(() => undefined);
+        if (cached !== undefined) {
+            return cached;
+        }
+        const value = await factory();
+        await this.cacheService.set(cacheKey, value, ttlMs).catch(() => undefined);
+        return value;
+    }
+    resolveSession(scope) {
+        const request = (0, core_1.getEntityStorageRequest)();
+        const raw = request?.[ACX_REQUEST_SESSION_KEY];
+        if (scope === 'global' || !raw) {
+            return undefined;
+        }
+        if (scope === 'tenant') {
+            return {
+                tenantId: raw.tenantId,
+                applicationId: raw.applicationId,
+            };
+        }
+        return {
+            userId: raw.userId,
+            tenantId: raw.tenantId,
+            applicationId: raw.applicationId,
+        };
+    }
+};
+exports.ServerQueryCacheService = ServerQueryCacheService;
+exports.ServerQueryCacheService = ServerQueryCacheService = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__param(2, (0, common_1.Optional)()),
+    tslib_1.__metadata("design:paramtypes", [axp_cache_service_1.AxpCacheService,
+        cache_key_builder_1.CacheKeyBuilder,
+        cache_config_resolver_service_1.CacheConfigResolverService])
+], ServerQueryCacheService);
+//#endregion
+//# sourceMappingURL=server-query-cache.service.js.map

package/cache/providers/src/lib/server-query-cache.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-query-cache.service.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/cache/providers/src/lib/server-query-cache.service.ts"],"names":[],"mappings":";;;;AAAA,gFAK2D;AAC3D,iEAAiF;AACjF,2CAAsD;AACtD,2DAAsD;AACtD,mFAA6E;AAC7E,2DAAgF;AAEhF,sCAAsC;AAEtC,MAAM,uBAAuB,GAAG,mBAAmB,CAAC;AAMpD;;;GAGG;AAEI,IAAM,uBAAuB,GAA7B,MAAM,uBAAuB;IAClC,YACmB,YAA6B,EAC7B,UAA2B,EACf,cAA2C;QAFvD,iBAAY,GAAZ,YAAY,CAAiB;QAC7B,eAAU,GAAV,UAAU,CAAiB;QACf,mBAAc,GAAd,cAAc,CAA6B;IACvE,CAAC;IAEJ,KAAK,CAAC,IAAI,CACR,QAAgB,EAChB,KAAc,EACd,OAAmC,EACnC,OAAyB;QAEzB,MAAM,aAAa,GAAG,IAAI,CAAC,cAAc,EAAE,eAAe,EAAE,CAAC,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC;QACtG,MAAM,OAAO,GACX,aAAa,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,6CAAkC,CAAC,OAAO,CAAC,CAAC;QACnF,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,OAAO,EAAE,CAAC;QACnB,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,KAAK,IAAI,6CAAkC,CAAC,KAAK,CAAC,CAAC;QAC/F,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,SAAS,QAAQ,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAC5F,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,cAAc,EAAE,eAAe,EAAE,CAAC,KAAK,IAAI,MAAM,CAAC;QAEtF,kDAAkD;QAClD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,CAAI,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC/E,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,OAAO,EAAE,CAAC;QAE9B,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC3E,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,cAAc,CAAC,KAA+B;QACpD,MAAM,OAAO,GAAG,IAAA,8BAAuB,GAAoC,CAAC;QAC5E,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC,uBAAuB,CAAC,CAAC;QAE/C,IAAI,KAAK,KAAK,QAAQ,IAAI,CAAC,GAAG,EAAE,CAAC;YAC/B,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;YACvB,OAAO;gBACL,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,aAAa,EAAE,GAAG,CAAC,aAAa;aACjC,CAAC;QACJ,CAAC;QAED,OAAO;YACL,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,aAAa,EAAE,GAAG,CAAC,aAAa;SACjC,CAAC;IACJ,CAAC;CACF,CAAA;AA1DY,0DAAuB;kCAAvB,uBAAuB;IADnC,IAAA,mBAAU,GAAE;IAKR,mBAAA,IAAA,iBAAQ,GAAE,CAAA;6CAFoB,mCAAe;QACjB,mCAAe;QACE,0DAA0B;GAJ/D,uBAAuB,CA0DnC;AAED,YAAY"}

package/cache/providers/src/services.d.ts

@@ -1,4 +1,5 @@
 export * from './lib/axp-cache.service';
 export * from './lib/cache-config-resolver.service';
 export * from './lib/cache-key-builder';
+export * from './lib/server-query-cache.service';
 //# sourceMappingURL=services.d.ts.map

package/cache/providers/src/services.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../../../../../../libs/framework/server/cache/providers/src/services.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,qCAAqC,CAAC;AACpD,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../../../../../../libs/framework/server/cache/providers/src/services.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,qCAAqC,CAAC;AACpD,cAAc,yBAAyB,CAAC;AACxC,cAAc,kCAAkC,CAAC"}

package/cache/providers/src/services.js

@@ -4,4 +4,5 @@ const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./lib/axp-cache.service"), exports);
 tslib_1.__exportStar(require("./lib/cache-config-resolver.service"), exports);
 tslib_1.__exportStar(require("./lib/cache-key-builder"), exports);
+tslib_1.__exportStar(require("./lib/server-query-cache.service"), exports);
 //# sourceMappingURL=services.js.map

package/cache/providers/src/services.js.map

@@ -1 +1 @@
-{"version":3,"file":"services.js","sourceRoot":"","sources":["../../../../../../../libs/framework/server/cache/providers/src/services.ts"],"names":[],"mappings":";;;AAAA,kEAAwC;AACxC,8EAAoD;AACpD,kEAAwC"}
+{"version":3,"file":"services.js","sourceRoot":"","sources":["../../../../../../../libs/framework/server/cache/providers/src/services.ts"],"names":[],"mappings":";;;AAAA,kEAAwC;AACxC,8EAAoD;AACpD,kEAAwC;AACxC,2EAAiD"}

package/core/src/index.d.ts

@@ -1,4 +1,7 @@
+export * from './lib/context-definition';
 export * from './lib/entity-storage';
+export * from './lib/errors';
+export * from './lib/expression-evaluator';
 export * from './lib/filters';
 export * from './lib/runtime';
 export * from './lib/startup';

package/core/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../libs/framework/server/core/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../libs/framework/server/core/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC"}

package/core/src/index.js

@@ -1,7 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./lib/context-definition"), exports);
 tslib_1.__exportStar(require("./lib/entity-storage"), exports);
+tslib_1.__exportStar(require("./lib/errors"), exports);
+tslib_1.__exportStar(require("./lib/expression-evaluator"), exports);
 tslib_1.__exportStar(require("./lib/filters"), exports);
 tslib_1.__exportStar(require("./lib/runtime"), exports);
 tslib_1.__exportStar(require("./lib/startup"), exports);

package/core/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/framework/server/core/src/index.ts"],"names":[],"mappings":";;;AAAA,+DAAqC;AACrC,wDAA8B;AAC9B,wDAA8B;AAC9B,wDAA8B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/framework/server/core/src/index.ts"],"names":[],"mappings":";;;AAAA,mEAAyC;AACzC,+DAAqC;AACrC,uDAA6B;AAC7B,qEAA2C;AAC3C,wDAA8B;AAC9B,wDAA8B;AAC9B,wDAA8B"}

package/core/src/lib/context-definition/context-definition.module.d.ts

@@ -0,0 +1,3 @@
+export declare class AXPContextDefinitionModule {
+}
+//# sourceMappingURL=context-definition.module.d.ts.map

package/core/src/lib/context-definition/context-definition.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-definition.module.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/core/src/lib/context-definition/context-definition.module.ts"],"names":[],"mappings":"AAKA,qBAKa,0BAA0B;CAAG"}

package/core/src/lib/context-definition/context-definition.module.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AXPContextDefinitionModule = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const context_definition_registry_1 = require("./context-definition.registry");
+//#region ----- Context definition module -----
+let AXPContextDefinitionModule = class AXPContextDefinitionModule {
+};
+exports.AXPContextDefinitionModule = AXPContextDefinitionModule;
+exports.AXPContextDefinitionModule = AXPContextDefinitionModule = tslib_1.__decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({
+        providers: [context_definition_registry_1.AXPContextDefinitionRegistry],
+        exports: [context_definition_registry_1.AXPContextDefinitionRegistry],
+    })
+], AXPContextDefinitionModule);
+//#endregion
+//# sourceMappingURL=context-definition.module.js.map

package/core/src/lib/context-definition/context-definition.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-definition.module.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/core/src/lib/context-definition/context-definition.module.ts"],"names":[],"mappings":";;;;AAAA,2CAAgD;AAChD,+EAA6E;AAE7E,+CAA+C;AAOxC,IAAM,0BAA0B,GAAhC,MAAM,0BAA0B;CAAG,CAAA;AAA7B,gEAA0B;qCAA1B,0BAA0B;IALtC,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC;QACN,SAAS,EAAE,CAAC,0DAA4B,CAAC;QACzC,OAAO,EAAE,CAAC,0DAA4B,CAAC;KACxC,CAAC;GACW,0BAA0B,CAAG;AAE1C,YAAY"}

package/core/src/lib/context-definition/context-definition.registry.d.ts

@@ -0,0 +1,11 @@
+import type { AXPContextDefinition } from '@acorex-platform/framework-shared/core';
+/**
+ * Nest-native replacement for Angular `AXP_CONTEXT_DEFINITION_PROVIDER` aggregation.
+ * Feature modules register definition rows in `onModuleInit`.
+ */
+export declare class AXPContextDefinitionRegistry {
+    private readonly byName;
+    registerAll(items: readonly AXPContextDefinition[]): void;
+    items(): AXPContextDefinition[];
+}
+//# sourceMappingURL=context-definition.registry.d.ts.map

package/core/src/lib/context-definition/context-definition.registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-definition.registry.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/core/src/lib/context-definition/context-definition.registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAInF;;;GAGG;AACH,qBACa,4BAA4B;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2C;IAElE,WAAW,CAAC,KAAK,EAAE,SAAS,oBAAoB,EAAE,GAAG,IAAI;IASzD,KAAK,IAAI,oBAAoB,EAAE;CAGhC"}

package/core/src/lib/context-definition/context-definition.registry.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AXPContextDefinitionRegistry = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+//#region ----- Context definition registry -----
+/**
+ * Nest-native replacement for Angular `AXP_CONTEXT_DEFINITION_PROVIDER` aggregation.
+ * Feature modules register definition rows in `onModuleInit`.
+ */
+let AXPContextDefinitionRegistry = class AXPContextDefinitionRegistry {
+    constructor() {
+        this.byName = new Map();
+    }
+    registerAll(items) {
+        for (const item of items) {
+            const name = item.name?.trim();
+            if (name) {
+                this.byName.set(name, item);
+            }
+        }
+    }
+    items() {
+        return [...this.byName.values()];
+    }
+};
+exports.AXPContextDefinitionRegistry = AXPContextDefinitionRegistry;
+exports.AXPContextDefinitionRegistry = AXPContextDefinitionRegistry = tslib_1.__decorate([
+    (0, common_1.Injectable)()
+], AXPContextDefinitionRegistry);
+//#endregion
+//# sourceMappingURL=context-definition.registry.js.map

package/core/src/lib/context-definition/context-definition.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-definition.registry.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/core/src/lib/context-definition/context-definition.registry.ts"],"names":[],"mappings":";;;;AAAA,2CAA4C;AAG5C,iDAAiD;AAEjD;;;GAGG;AAEI,IAAM,4BAA4B,GAAlC,MAAM,4BAA4B;IAAlC;QACY,WAAM,GAAG,IAAI,GAAG,EAAgC,CAAC;IAcpE,CAAC;IAZC,WAAW,CAAC,KAAsC;QAChD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;YAC/B,IAAI,IAAI,EAAE,CAAC;gBACT,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK;QACH,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACnC,CAAC;CACF,CAAA;AAfY,oEAA4B;uCAA5B,4BAA4B;IADxC,IAAA,mBAAU,GAAE;GACA,4BAA4B,CAexC;AAED,YAAY"}

package/core/src/lib/context-definition/index.d.ts

@@ -0,0 +1,3 @@
+export * from './context-definition.registry';
+export * from './context-definition.module';
+//# sourceMappingURL=index.d.ts.map

package/core/src/lib/context-definition/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/core/src/lib/context-definition/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC"}

package/core/src/lib/context-definition/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./context-definition.registry"), exports);
+tslib_1.__exportStar(require("./context-definition.module"), exports);
+//# sourceMappingURL=index.js.map

package/core/src/lib/context-definition/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/core/src/lib/context-definition/index.ts"],"names":[],"mappings":";;;AAAA,wEAA8C;AAC9C,sEAA4C"}

package/core/src/lib/entity-storage/entity-mutation-events/entity-mutation-event-emitter.service.d.ts

@@ -1,5 +1,5 @@
 import { EventEmitter2 } from '@nestjs/event-emitter';
-import type { EntityMutationEvent } from './entity-mutation-event.types';
+import type { EntityBulkMutationCompletedEvent, EntityMutationEvent } from './entity-mutation-event.types';
 /**
  * Publishes {@link EntityMutationEvent} on Nest {@link EventEmitter2}
  * using hierarchical keys (operation, entity, module) plus `entity.*`.
@@ -8,5 +8,6 @@ export declare class EntityMutationEventEmitter {
     private readonly eventEmitter;
     constructor(eventEmitter: EventEmitter2);
     emit(event: EntityMutationEvent): void;
+    emitBulkCompleted(event: EntityBulkMutationCompletedEvent): void;
 }
 //# sourceMappingURL=entity-mutation-event-emitter.service.d.ts.map

package/core/src/lib/entity-storage/entity-mutation-events/entity-mutation-event-emitter.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entity-mutation-event-emitter.service.d.ts","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/core/src/lib/entity-storage/entity-mutation-events/entity-mutation-event-emitter.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAKzE;;;GAGG;AACH,qBACa,0BAA0B;IACzB,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAAZ,YAAY,EAAE,aAAa;IAExD,IAAI,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI;CAMvC"}
+{"version":3,"file":"entity-mutation-event-emitter.service.d.ts","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/core/src/lib/entity-storage/entity-mutation-events/entity-mutation-event-emitter.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,KAAK,EAAE,gCAAgC,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAM3G;;;GAGG;AACH,qBACa,0BAA0B;IACzB,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAAZ,YAAY,EAAE,aAAa;IAExD,IAAI,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI;IAOtC,iBAAiB,CAAC,KAAK,EAAE,gCAAgC,GAAG,IAAI;CAGjE"}

package/core/src/lib/entity-storage/entity-mutation-events/entity-mutation-event-emitter.service.js

@@ -4,6 +4,7 @@ exports.EntityMutationEventEmitter = void 0;
 const tslib_1 = require("tslib");
 const common_1 = require("@nestjs/common");
 const event_emitter_1 = require("@nestjs/event-emitter");
+const entity_mutation_event_types_1 = require("./entity-mutation-event.types");
 const entity_mutation_event_util_1 = require("./entity-mutation-event.util");
 //#region ---- Entity mutation event emitter ----
 /**
@@ -20,6 +21,9 @@ let EntityMutationEventEmitter = class EntityMutationEventEmitter {
             this.eventEmitter.emit(key, event);
         }
     }
+    emitBulkCompleted(event) {
+        this.eventEmitter.emit(entity_mutation_event_types_1.ENTITY_BULK_MUTATION_COMPLETED, event);
+    }
 };
 exports.EntityMutationEventEmitter = EntityMutationEventEmitter;
 exports.EntityMutationEventEmitter = EntityMutationEventEmitter = tslib_1.__decorate([

package/core/src/lib/entity-storage/entity-mutation-events/entity-mutation-event-emitter.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"entity-mutation-event-emitter.service.js","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/core/src/lib/entity-storage/entity-mutation-events/entity-mutation-event-emitter.service.ts"],"names":[],"mappings":";;;;AAAA,2CAA4C;AAC5C,yDAAsD;AAGtD,6EAA4E;AAE5E,iDAAiD;AAEjD;;;GAGG;AAEI,IAAM,0BAA0B,GAAhC,MAAM,0BAA0B;IACrC,YAA6B,YAA2B;QAA3B,iBAAY,GAAZ,YAAY,CAAe;IAAG,CAAC;IAE5D,IAAI,CAAC,KAA0B;QAC7B,MAAM,IAAI,GAAG,IAAA,yDAA4B,EAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;QAC7E,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;CACF,CAAA;AATY,gEAA0B;qCAA1B,0BAA0B;IADtC,IAAA,mBAAU,GAAE;6CAEgC,6BAAa;GAD7C,0BAA0B,CAStC;AAED,YAAY"}
+{"version":3,"file":"entity-mutation-event-emitter.service.js","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/core/src/lib/entity-storage/entity-mutation-events/entity-mutation-event-emitter.service.ts"],"names":[],"mappings":";;;;AAAA,2CAA4C;AAC5C,yDAAsD;AAGtD,+EAA+E;AAC/E,6EAA4E;AAE5E,iDAAiD;AAEjD;;;GAGG;AAEI,IAAM,0BAA0B,GAAhC,MAAM,0BAA0B;IACrC,YAA6B,YAA2B;QAA3B,iBAAY,GAAZ,YAAY,CAAe;IAAG,CAAC;IAE5D,IAAI,CAAC,KAA0B;QAC7B,MAAM,IAAI,GAAG,IAAA,yDAA4B,EAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;QAC7E,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,iBAAiB,CAAC,KAAuC;QACvD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,4DAA8B,EAAE,KAAK,CAAC,CAAC;IAChE,CAAC;CACF,CAAA;AAbY,gEAA0B;qCAA1B,0BAA0B;IADtC,IAAA,mBAAU,GAAE;6CAEgC,6BAAa;GAD7C,0BAA0B,CAatC;AAED,YAAY"}

package/core/src/lib/entity-storage/entity-mutation-events/entity-mutation-event.middleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entity-mutation-event.middleware.d.ts","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/core/src/lib/entity-storage/entity-mutation-events/entity-mutation-event.middleware.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,uBAAuB,EACxB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAYrF,qBACa,6BAA8B,YAAW,uBAAuB;IAM/D,OAAO,CAAC,QAAQ,CAAC,MAAM;IALnC,QAAQ,CAAC,MAAM;aAC0B,WAAW,EAAE;;MAEpD;gBAE2B,MAAM,EAAE,0BAA0B;IAEzD,OAAO,CAAC,GAAG,EAAE,oBAAoB,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBlF,OAAO,CAAC,kBAAkB;CAa3B"}
+{"version":3,"file":"entity-mutation-event.middleware.d.ts","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/core/src/lib/entity-storage/entity-mutation-events/entity-mutation-event.middleware.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,uBAAuB,EACxB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAYrF,qBACa,6BAA8B,YAAW,uBAAuB;IAM/D,OAAO,CAAC,QAAQ,CAAC,MAAM;IALnC,QAAQ,CAAC,MAAM;aAC0B,WAAW,EAAE;;MAEpD;gBAE2B,MAAM,EAAE,0BAA0B;IAEzD,OAAO,CAAC,GAAG,EAAE,oBAAoB,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BlF,OAAO,CAAC,kBAAkB;CAmB3B"}

package/core/src/lib/entity-storage/entity-mutation-events/entity-mutation-event.middleware.js

@@ -30,6 +30,7 @@ let EntityMutationEventMiddleware = class EntityMutationEventMiddleware {
             entityName: ctx.entityName,
             id: (0, entity_mutation_event_util_1.resolveEntityMutationRecordId)(ctx),
             tenantId: session?.tenantId,
+            applicationId: session?.applicationId,
             userId: session?.userId,
             data: ctx.op === 'delete' ? (ctx.previous ?? ctx.result) : (ctx.result ?? ctx.data),
             previous: ctx.previous,
@@ -47,6 +48,7 @@ let EntityMutationEventMiddleware = class EntityMutationEventMiddleware {
         const record = session;
         return {
             tenantId: typeof record['tenantId'] === 'string' ? record['tenantId'] : undefined,
+            applicationId: typeof record['applicationId'] === 'string' ? record['applicationId'] : undefined,
             userId: typeof record['userId'] === 'string' ? record['userId'] : undefined,
         };
     }

package/core/src/lib/entity-storage/entity-mutation-events/entity-mutation-event.middleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"entity-mutation-event.middleware.js","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/core/src/lib/entity-storage/entity-mutation-events/entity-mutation-event.middleware.ts"],"names":[],"mappings":";;;;AAAA,2CAA4C;AAM5C,sFAA4E;AAC5E,mGAAqF;AACrF,+EAGuC;AACvC,6EAA6E;AAE7E,+DAA+D;AAC/D,MAAM,uBAAuB,GAAG,mBAAmB,CAAC;AAEpD,oDAAoD;AAG7C,IAAM,6BAA6B,GAAnC,MAAM,6BAA6B;IAMxC,YAA6B,MAAkC;QAAlC,WAAM,GAAN,MAAM,CAA4B;QALtD,WAAM,GAAG;YAChB,GAAG,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAkB;YACpD,KAAK,EAAE,EAAE;SACV,CAAC;IAEgE,CAAC;IAEnE,KAAK,CAAC,OAAO,CAAC,GAAyB,EAAE,IAAyB;QAChE,MAAM,IAAI,EAAE,CAAC;QAEb,MAAM,SAAS,GAAG,IAAA,0DAA4B,EAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAE1C,MAAM,KAAK,GAAwB;YACjC,SAAS;YACT,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,EAAE,EAAE,IAAA,0DAA6B,EAAC,GAAG,CAAC;YACtC,QAAQ,EAAE,OAAO,EAAE,QAAQ;YAC3B,MAAM,EAAE,OAAO,EAAE,MAAM;YACvB,IAAI,EAAE,GAAG,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC;YACnF,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,MAAM,EAAE,uBAAuB;SAChC,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAEO,kBAAkB;QACxB,MAAM,OAAO,GAAG,IAAA,wDAAuB,GAAyC,CAAC;QACjF,MAAM,OAAO,GAAG,OAAO,EAAE,CAAC,uBAAuB,CAAC,CAAC;QACnD,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC5C,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,MAAM,GAAG,OAAkC,CAAC;QAClD,OAAO;YACL,QAAQ,EAAE,OAAO,MAAM,CAAC,UAAU,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS;YACjF,MAAM,EAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS;SAC5E,CAAC;IACJ,CAAC;CACF,CAAA;AA9CY,sEAA6B;wCAA7B,6BAA6B;IADzC,IAAA,mBAAU,GAAE;6CAO0B,kEAA0B;GANpD,6BAA6B,CA8CzC;AAED,YAAY"}
+{"version":3,"file":"entity-mutation-event.middleware.js","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/core/src/lib/entity-storage/entity-mutation-events/entity-mutation-event.middleware.ts"],"names":[],"mappings":";;;;AAAA,2CAA4C;AAM5C,sFAA4E;AAC5E,mGAAqF;AACrF,+EAGuC;AACvC,6EAA6E;AAE7E,+DAA+D;AAC/D,MAAM,uBAAuB,GAAG,mBAAmB,CAAC;AAEpD,oDAAoD;AAG7C,IAAM,6BAA6B,GAAnC,MAAM,6BAA6B;IAMxC,YAA6B,MAAkC;QAAlC,WAAM,GAAN,MAAM,CAA4B;QALtD,WAAM,GAAG;YAChB,GAAG,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAkB;YACpD,KAAK,EAAE,EAAE;SACV,CAAC;IAEgE,CAAC;IAEnE,KAAK,CAAC,OAAO,CAAC,GAAyB,EAAE,IAAyB;QAChE,MAAM,IAAI,EAAE,CAAC;QAEb,MAAM,SAAS,GAAG,IAAA,0DAA4B,EAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAE1C,MAAM,KAAK,GAAwB;YACjC,SAAS;YACT,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,EAAE,EAAE,IAAA,0DAA6B,EAAC,GAAG,CAAC;YACtC,QAAQ,EAAE,OAAO,EAAE,QAAQ;YAC3B,aAAa,EAAE,OAAO,EAAE,aAAa;YACrC,MAAM,EAAE,OAAO,EAAE,MAAM;YACvB,IAAI,EAAE,GAAG,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC;YACnF,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,MAAM,EAAE,uBAAuB;SAChC,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAEO,kBAAkB;QAKxB,MAAM,OAAO,GAAG,IAAA,wDAAuB,GAAyC,CAAC;QACjF,MAAM,OAAO,GAAG,OAAO,EAAE,CAAC,uBAAuB,CAAC,CAAC;QACnD,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC5C,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,MAAM,GAAG,OAAkC,CAAC;QAClD,OAAO;YACL,QAAQ,EAAE,OAAO,MAAM,CAAC,UAAU,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS;YACjF,aAAa,EACX,OAAO,MAAM,CAAC,eAAe,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,SAAS;YACnF,MAAM,EAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS;SAC5E,CAAC;IACJ,CAAC;CACF,CAAA;AArDY,sEAA6B;wCAA7B,6BAA6B;IADzC,IAAA,mBAAU,GAAE;6CAO0B,kEAA0B;GANpD,6BAA6B,CAqDzC;AAED,YAAY"}

package/core/src/lib/entity-storage/entity-mutation-events/entity-mutation-event.types.d.ts

@@ -6,6 +6,7 @@ export interface EntityMutationEvent {
     entityName: string;
     id?: string;
     tenantId?: string;
+    applicationId?: string;
     userId?: string;
     data?: unknown;
     previous?: unknown;
@@ -14,5 +15,19 @@ export interface EntityMutationEvent {
 }
 /** Wildcard pattern for listeners that react to any entity mutation. Requires EventEmitter wildcard mode. */
 export declare const ENTITY_MUTATION_EVENT_WILDCARD = "entity.*";
+/** Emitted once after a server bulk command fan-out completes with at least one success. */
+export declare const ENTITY_BULK_MUTATION_COMPLETED = "entity.bulk.completed";
+export interface EntityBulkMutationCompletedEvent {
+    entityName: string;
+    operation: EntityMutationOperation;
+    succeeded: number;
+    failed: number;
+    total: number;
+    tenantId?: string;
+    userId?: string;
+    bulkExecutionId: string;
+    timestamp: Date;
+    source: 'entity-bulk-mutation';
+}
 export declare function mapEntityStorageOpToMutation(op: AXPEntityOp): EntityMutationOperation | null;
 //# sourceMappingURL=entity-mutation-event.types.d.ts.map

package/core/src/lib/entity-storage/entity-mutation-events/entity-mutation-event.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entity-mutation-event.types.d.ts","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/core/src/lib/entity-storage/entity-mutation-events/entity-mutation-event.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gDAAgD,CAAC;AAIlF,qFAAqF;AACrF,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAExE,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,uBAAuB,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,EAAE,uBAAuB,CAAC;CACjC;AAED,6GAA6G;AAC7G,eAAO,MAAM,8BAA8B,aAAa,CAAC;AAEzD,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,WAAW,GAAG,uBAAuB,GAAG,IAAI,CAW5F"}
+{"version":3,"file":"entity-mutation-event.types.d.ts","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/core/src/lib/entity-storage/entity-mutation-events/entity-mutation-event.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gDAAgD,CAAC;AAIlF,qFAAqF;AACrF,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAExE,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,uBAAuB,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,EAAE,uBAAuB,CAAC;CACjC;AAED,6GAA6G;AAC7G,eAAO,MAAM,8BAA8B,aAAa,CAAC;AAEzD,4FAA4F;AAC5F,eAAO,MAAM,8BAA8B,0BAA0B,CAAC;AAEtE,MAAM,WAAW,gCAAgC;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,uBAAuB,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,EAAE,sBAAsB,CAAC;CAChC;AAED,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,WAAW,GAAG,uBAAuB,GAAG,IAAI,CAW5F"}

package/core/src/lib/entity-storage/entity-mutation-events/entity-mutation-event.types.js

@@ -1,9 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ENTITY_MUTATION_EVENT_WILDCARD = void 0;
+exports.ENTITY_BULK_MUTATION_COMPLETED = exports.ENTITY_MUTATION_EVENT_WILDCARD = void 0;
 exports.mapEntityStorageOpToMutation = mapEntityStorageOpToMutation;
 /** Wildcard pattern for listeners that react to any entity mutation. Requires EventEmitter wildcard mode. */
 exports.ENTITY_MUTATION_EVENT_WILDCARD = 'entity.*';
+/** Emitted once after a server bulk command fan-out completes with at least one success. */
+exports.ENTITY_BULK_MUTATION_COMPLETED = 'entity.bulk.completed';
 function mapEntityStorageOpToMutation(op) {
     switch (op) {
         case 'create':

package/core/src/lib/entity-storage/entity-mutation-events/entity-mutation-event.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"entity-mutation-event.types.js","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/core/src/lib/entity-storage/entity-mutation-events/entity-mutation-event.types.ts"],"names":[],"mappings":";;;AAsBA,oEAWC;AAdD,6GAA6G;AAChG,QAAA,8BAA8B,GAAG,UAAU,CAAC;AAEzD,SAAgB,4BAA4B,CAAC,EAAe;IAC1D,QAAQ,EAAE,EAAE,CAAC;QACX,KAAK,QAAQ;YACX,OAAO,SAAS,CAAC;QACnB,KAAK,QAAQ;YACX,OAAO,SAAS,CAAC;QACnB,KAAK,QAAQ;YACX,OAAO,SAAS,CAAC;QACnB;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,YAAY"}
+{"version":3,"file":"entity-mutation-event.types.js","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/core/src/lib/entity-storage/entity-mutation-events/entity-mutation-event.types.ts"],"names":[],"mappings":";;;AAuCA,oEAWC;AA9BD,6GAA6G;AAChG,QAAA,8BAA8B,GAAG,UAAU,CAAC;AAEzD,4FAA4F;AAC/E,QAAA,8BAA8B,GAAG,uBAAuB,CAAC;AAetE,SAAgB,4BAA4B,CAAC,EAAe;IAC1D,QAAQ,EAAE,EAAE,CAAC;QACX,KAAK,QAAQ;YACX,OAAO,SAAS,CAAC;QACnB,KAAK,QAAQ;YACX,OAAO,SAAS,CAAC;QACnB,KAAK,QAAQ;YACX,OAAO,SAAS,CAAC;QACnB;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,YAAY"}

package/core/src/lib/entity-storage/entity-storage-middleware.service.d.ts

@@ -1,4 +1,6 @@
 import type { AXPEntityAggregateRequest, AXPEntityAggregateResult } from '@acorex-platform/framework-shared/entity';
+import { type ExecutionTraceRecorder } from '@acorex-platform/framework-server/observability/abstract';
+import { type EntityTraceConfigResolver } from '@acorex-platform/framework-server/tracing/abstract';
 import { OnApplicationBootstrap } from '@nestjs/common';
 import { ModuleRef, ModulesContainer } from '@nestjs/core';
 import type { EntityStorageBackend, EntityStorageInitialOptions } from '@acorex-platform/framework-server/jql/abstract';
@@ -7,6 +9,8 @@ export declare class EntityStorageMiddlewareService implements OnApplicationBoot
     private readonly backend;
     private readonly moduleRef;
     private readonly modulesContainer;
+    private readonly executionTrace;
+    private readonly entityTraceConfig;
     private readonly logger;
     /** Cached at bootstrap — only middleware with a fully static DI tree. */
     private singletonMiddlewares;
@@ -15,13 +19,15 @@ export declare class EntityStorageMiddlewareService implements OnApplicationBoot
     /** Resolved per request (explicit REQUEST scope or request-scoped dependencies). */
     private contextScopedMiddlewareTypes;
     private pipelineResolved;
-    constructor(backend: EntityStorageBackend, moduleRef: ModuleRef, modulesContainer: ModulesContainer);
+    constructor(backend: EntityStorageBackend, moduleRef: ModuleRef, modulesContainer: ModulesContainer, executionTrace: ExecutionTraceRecorder | null, entityTraceConfig: EntityTraceConfigResolver | null);
     onApplicationBootstrap(): void;
     get dbName(): string;
     getOne(entityName: string, id: string): Promise<unknown>;
     /** Engine read — skips request-scoped middleware (Bull workers, scanners). */
     getOneAsEngine(entityName: string, id: string): Promise<unknown>;
     query(entityName: string, request: AXPQueryRequest): Promise<EntityStoragePagedResponse>;
+    /** Engine query — skips request-scoped middleware (tenant filters, etc.). */
+    queryAsEngine(entityName: string, request: AXPQueryRequest): Promise<EntityStoragePagedResponse>;
     aggregate(entityName: string, request: AXPEntityAggregateRequest): Promise<AXPEntityAggregateResult>;
     insertOne(entityName: string, entity: unknown): Promise<string>;
     updateOne(entityName: string, id: string, patch: Record<string, unknown>): Promise<unknown>;
@@ -36,6 +42,8 @@ export declare class EntityStorageMiddlewareService implements OnApplicationBoot
     /** Engine write — skips request-scoped middleware and policy enforcement. */
     updateOneAsEngine(entityName: string, id: string, patch: Record<string, unknown>): Promise<unknown>;
     deleteOne(entityName: string, id: string): Promise<void>;
+    /** Engine delete — skips request-scoped middleware and policy enforcement. */
+    deleteOneAsEngine(entityName: string, id: string): Promise<void>;
     /**
      * Registers middleware after application bootstrap.
      * Use when a module provides the class directly but pipeline discovery only sees `useExisting` aliases.
@@ -52,6 +60,7 @@ export declare class EntityStorageMiddlewareService implements OnApplicationBoot
     private resolveMiddlewares;
     private filterMiddlewares;
     private compose;
+    private resolveTraceConfig;
     private run;
     private createCtx;
 }

package/core/src/lib/entity-storage/entity-storage-middleware.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entity-storage-middleware.service.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/core/src/lib/entity-storage/entity-storage-middleware.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"entity-storage-middleware.service.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/core/src/lib/entity-storage/entity-storage-middleware.service.ts"],"names":[],"mappings":"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"}