@acorex-platform/framework-client 0.0.15 → 0.0.20

package/fesm2022/acorex-platform-framework-client-runtime.mjs

@@ -1,8 +1,62 @@
 import * as i0 from '@angular/core';
 import { inject, Injectable, InjectionToken, EnvironmentInjector, runInInjectionContext, makeEnvironmentProviders, input, ElementRef, effect, Directive, isDevMode, NgModule } from '@angular/core';
-import { AXPBroadcastEventService, AXPDistributedEventListenerService, AXPHookService } from '@acorex-platform/framework-client/core';
+import { AXPHookService, AXPBroadcastEventService, AXPDistributedEventListenerService, AXP_DISTRIBUTED_EVENT_LISTENER_PROVIDER } from '@acorex-platform/framework-client/core';
+import { normalizeCommandInputForRemote, composeCommandMiddlewares, composeQueryMiddlewares } from '@acorex-platform/framework-shared/runtime';
+export { composeCommandMiddlewares, composeQueryMiddlewares } from '@acorex-platform/framework-shared/runtime';
 import { castArray } from 'lodash-es';
 
+//#region ---- Runtime remote execute hooks ----
+/**
+ * Distributed hook keys for remote (non-local) command/query execution.
+ * Connectivity (or another transport) implements these via {@link AXPHookService.runAsync}.
+ *
+ * Host apps that only consume the client lib and call a different API stack should
+ * register {@link provideExternalRuntimeBulkTransport} for {@link AXPRuntimeRemoteHookKeys.CommandExecuteBulk}
+ * (see `RUNTIME_REMOTE_BULK_TRANSPORT.md`).
+ */
+const AXPRuntimeRemoteHookKeys = {
+    CommandExecute: 'runtime.command.execute',
+    CommandExecuteBulk: 'runtime.command.execute-bulk',
+    QueryExecute: 'runtime.query.execute',
+};
+//#endregion
+
+//#region ---- Imports ----
+//#endregion
+//#region ---- Bulk command client ----
+/**
+ * Invokes filter-only bulk execution via the remote hook transport
+ * (`runtime.command.execute-bulk`).
+ *
+ * Default connectivity posts to `/v1/runtime/commands/bulk`. Host apps on another
+ * API stack should register {@link provideExternalRuntimeBulkTransport} instead —
+ * this service never fans out one-by-one on the client.
+ */
+class AXPBulkCommandService {
+    constructor() {
+        this.hooks = inject(AXPHookService);
+    }
+    async execute(request) {
+        const payload = await this.hooks.runAsync(AXPRuntimeRemoteHookKeys.CommandExecuteBulk, { request });
+        if (!payload.handled) {
+            throw new Error('Bulk command remote handler is not available');
+        }
+        return (payload.result ?? {
+            success: false,
+            message: {
+                text: 'Bulk command returned no result.',
+                details: { total: 0, succeeded: 0, failed: 0, results: [] },
+            },
+        });
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPBulkCommandService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPBulkCommandService, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPBulkCommandService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
 //#region ----   Imports   ----
 //#endregion
 const COMMAND_EXECUTION_EVENT_KEY = '@commands:execution';
@@ -89,32 +143,14 @@ class AXPCommandEventsService {
         };
         return walk(value);
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPCommandEventsService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPCommandEventsService, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPCommandEventsService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPCommandEventsService, providedIn: 'root' }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPCommandEventsService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPCommandEventsService, decorators: [{
             type: Injectable,
             args: [{ providedIn: 'root' }]
         }] });
 
-//#endregion
-//#region ----   Middleware Composition   ----
-/**
- * Creates a composed handler by chaining the provided command middlewares.
- */
-function composeCommandMiddlewares(middlewares) {
-    return (handler) => {
-        let composed = handler;
-        for (let i = middlewares.length - 1; i >= 0; i--) {
-            const mw = middlewares[i];
-            const next = composed;
-            composed = (input) => mw(input, next);
-        }
-        return composed;
-    };
-}
-//#endregion
-
 class AXPCommandRegistry {
     constructor() {
         this.registry = new Map();
@@ -145,10 +181,10 @@ class AXPCommandRegistry {
         this.registry.clear();
         this.middlewares.length = 0;
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPCommandRegistry, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPCommandRegistry, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPCommandRegistry, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPCommandRegistry, providedIn: 'root' }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPCommandRegistry, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPCommandRegistry, decorators: [{
             type: Injectable,
             args: [{ providedIn: 'root' }]
         }] });
@@ -156,17 +192,6 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImpor
 // plugins/command.extension.token.ts
 const AXP_COMMAND_EXTENSION = new InjectionToken('AXP_COMMAND_EXTENSION');
 
-//#region ---- Runtime remote execute hooks ----
-/**
- * Distributed hook keys for remote (non-local) command/query execution.
- * Connectivity (or another transport) implements these via {@link AXPHookService.runAsync}.
- */
-const AXPRuntimeRemoteHookKeys = {
-    CommandExecute: 'runtime.command.execute',
-    QueryExecute: 'runtime.query.execute',
-};
-//#endregion
-
 class AXPCommandExecutor {
     constructor() {
         this.injector = inject(EnvironmentInjector);
@@ -175,40 +200,59 @@ class AXPCommandExecutor {
         this.commandEvents = inject(AXPCommandEventsService);
         this.hooks = inject(AXPHookService);
     }
-    async execute(key, input) {
-        if (this.registry.exists(key)) {
-            return this.executeLocal(key, input);
-        }
-        return this.executeRemote(key, input);
+    async execute(key, input, options) {
+        const handler = this.registry.exists(key)
+            ? await this.createLocalHandler(key)
+            : this.createRemoteHandler(key);
+        return this.runWithMiddlewareAndEvents(key, input, handler, options);
     }
-    async executeLocal(key, input) {
+    /**
+     * Always dispatch via {@link AXPRuntimeRemoteHookKeys.CommandExecute}, even when a local
+     * command is registered for the same key. Use from gateway/API clients that wrap remote
+     * handlers so local UI commands can call them without async recursion.
+     *
+     * Skips command middlewares (e.g. toast): the local wrapper owns UX. Running toast
+     * middleware here would double-notify when the wrapper also returns a failure message.
+     */
+    async executeRemote(key, input, options) {
+        return this.runWithEvents(key, input, () => this.createRemoteHandler(key)(input, options), options);
+    }
+    async createLocalHandler(key) {
         const loader = this.registry.getLoader(key);
         if (!loader) {
             throw new Error(`Command '${key}' is not registered`);
         }
         const command = await loader();
-        const handler = (i) => command.execute(i);
+        return (i) => command.execute(i);
+    }
+    createRemoteHandler(key) {
+        return async (input, options) => {
+            const payload = await this.hooks.runAsync(AXPRuntimeRemoteHookKeys.CommandExecute, {
+                name: key,
+                input: normalizeCommandInputForRemote(input),
+                options,
+            });
+            if (!payload.handled) {
+                throw new Error(`Command '${key}' is not registered and no remote handler is available`);
+            }
+            return (payload.result ?? null);
+        };
+    }
+    async runWithMiddlewareAndEvents(key, input, handler, options) {
         const pluginMiddlewares = this.getPluginMiddlewares(key);
         const globalMiddlewares = this.registry.getMiddlewares();
+        // Registry middlewares are untyped (any); re-wrap in injection context.
         const wrappedMiddlewares = [
             ...globalMiddlewares,
             ...pluginMiddlewares,
         ].map((middleware) => {
-            return (input, next) => runInInjectionContext(this.injector, () => middleware(input, next));
-        });
-        const composed = composeCommandMiddlewares(wrappedMiddlewares)(handler);
-        return this.runWithEvents(key, input, () => composed(input));
-    }
-    async executeRemote(key, input) {
-        return this.runWithEvents(key, input, async () => {
-            const payload = await this.hooks.runAsync(AXPRuntimeRemoteHookKeys.CommandExecute, { name: key, input });
-            if (!payload.handled) {
-                throw new Error(`Command '${key}' is not registered and no remote handler is available`);
-            }
-            return (payload.result ?? null);
+            const wrapped = (context, next) => runInInjectionContext(this.injector, () => middleware(context, next));
+            return wrapped;
         });
+        const composed = composeCommandMiddlewares(wrappedMiddlewares)((context) => handler(context.input, context.options));
+        return this.runWithEvents(key, input, () => composed({ input, key, options }), options);
     }
-    async runWithEvents(key, input, run) {
+    async runWithEvents(key, input, run, options) {
         const executionId = crypto.randomUUID();
         const startedAt = performance.now();
         const beforeEvent = {
@@ -216,6 +260,7 @@ class AXPCommandExecutor {
             stage: 'before',
             key,
             input,
+            options,
         };
         await this.commandEvents.emit(beforeEvent);
         try {
@@ -226,6 +271,7 @@ class AXPCommandExecutor {
                 stage: 'after',
                 key,
                 input,
+                options,
                 success: true,
                 result,
                 durationMs,
@@ -240,6 +286,7 @@ class AXPCommandExecutor {
                 stage: 'after',
                 key,
                 input,
+                options,
                 success: false,
                 error,
                 durationMs,
@@ -253,14 +300,19 @@ class AXPCommandExecutor {
             ?.filter((ext) => (ext.target instanceof RegExp ? ext.target.test(key) : ext.target === key))
             .map((ext) => ext.middleware) ?? []);
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPCommandExecutor, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPCommandExecutor, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPCommandExecutor, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPCommandExecutor, providedIn: 'root' }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPCommandExecutor, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPCommandExecutor, decorators: [{
             type: Injectable,
             args: [{ providedIn: 'root' }]
         }] });
 
+/**
+ * Re-exports shared command middleware contracts.
+ * Registration stays client-side (`provideCommandMiddleware` / registry.use).
+ */
+
 class AXPCommandService {
     constructor() {
         this.registry = inject(AXPCommandRegistry);
@@ -286,13 +338,20 @@ class AXPCommandService {
         this.registry.clear();
     }
     // Executor methods
-    async execute(key, input) {
-        return this.executor.execute(key, input);
+    async execute(key, input, options) {
+        return this.executor.execute(key, input, options);
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPCommandService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPCommandService, providedIn: 'root' }); }
+    /**
+     * Force remote transport for {@code key}, ignoring any local command registration.
+     * Prefer this in gateway/API clients used by local UI command wrappers.
+     */
+    async executeRemote(key, input, options) {
+        return this.executor.executeRemote(key, input, options);
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPCommandService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPCommandService, providedIn: 'root' }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPCommandService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPCommandService, decorators: [{
             type: Injectable,
             args: [{ providedIn: 'root' }]
         }] });
@@ -316,9 +375,10 @@ function provideCommandMiddleware(entries) {
             useValue: ext,
             multi: true
         })),
-        // Global middleware setup (triggered via this token)
+        // Global middleware setup — multi so every provideCommandMiddleware() registers its globals
         {
             provide: AXP_COMMAND_MIDDLEWARE_SETUP,
+            multi: true,
             useFactory: () => {
                 const registry = inject(AXPCommandRegistry);
                 for (const mw of global) {
@@ -397,10 +457,10 @@ class AXPQueryRegistry {
         this.registry.clear();
         this.middlewares.length = 0;
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPQueryRegistry, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPQueryRegistry, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPQueryRegistry, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPQueryRegistry, providedIn: 'root' }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPQueryRegistry, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPQueryRegistry, decorators: [{
             type: Injectable,
             args: [{ providedIn: 'root' }]
         }] });
@@ -417,7 +477,11 @@ function provideQueryMiddleware(entries) {
             global.push(entry);
         }
         else {
-            extensions.push(entry);
+            const target = entry.target ?? entry.key;
+            if (target == null) {
+                throw new Error('provideQueryMiddleware: targeted entry requires `target` or `key`');
+            }
+            extensions.push({ target, middleware: entry.middleware });
         }
     }
     return makeEnvironmentProviders([
@@ -427,9 +491,10 @@ function provideQueryMiddleware(entries) {
             useValue: ext,
             multi: true
         })),
-        // Global middleware setup (triggered via this token)
+        // Global middleware setup — multi so every provideQueryMiddleware() registers its globals
         {
             provide: AXP_QUERY_MIDDLEWARE_SETUP,
+            multi: true,
             useFactory: () => {
                 const registry = inject(AXPQueryRegistry);
                 for (const mw of global) {
@@ -544,26 +609,14 @@ class AXPQueryEventsService {
         };
         return walk(value);
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPQueryEventsService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPQueryEventsService, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPQueryEventsService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPQueryEventsService, providedIn: 'root' }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPQueryEventsService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPQueryEventsService, decorators: [{
             type: Injectable,
             args: [{ providedIn: 'root' }]
         }] });
 
-function composeQueryMiddlewares(middlewares) {
-    return (handler) => {
-        let composed = handler;
-        for (let i = middlewares.length - 1; i >= 0; i--) {
-            const mw = middlewares[i];
-            const next = composed;
-            composed = (input) => mw(input, next);
-        }
-        return composed;
-    };
-}
-
 class AXPQueryExecutor {
     constructor() {
         this.injector = inject(EnvironmentInjector);
@@ -572,37 +625,49 @@ class AXPQueryExecutor {
         this.queryEvents = inject(AXPQueryEventsService);
         this.hooks = inject(AXPHookService);
     }
-    async fetch(key, input) {
-        if (this.registry.exists(key)) {
-            return this.fetchLocal(key, input);
-        }
-        return this.fetchRemote(key, input);
+    async fetch(key, input, options) {
+        const handler = this.registry.exists(key)
+            ? await this.createLocalHandler(key)
+            : this.createRemoteHandler(key);
+        return this.runWithMiddlewareAndEvents(key, input, handler, options);
     }
-    async fetchLocal(key, input) {
+    async createLocalHandler(key) {
         const loader = this.registry.getLoader(key);
         if (!loader) {
             throw new Error(`Query '${key}' is not registered`);
         }
         const query = await loader();
-        const handler = (i) => query.fetch(i);
-        const pluginMiddlewares = this.getPluginMiddlewares(key);
-        const globalMiddlewares = this.registry.getMiddlewares();
-        const wrappedMiddlewares = [...globalMiddlewares, ...pluginMiddlewares].map((middleware) => {
-            return (input, next) => runInInjectionContext(this.injector, () => middleware(input, next));
-        });
-        const composed = composeQueryMiddlewares(wrappedMiddlewares)(handler);
-        return this.runWithEvents(key, input, () => composed(input));
-    }
-    async fetchRemote(key, input) {
-        return this.runWithEvents(key, input, async () => {
-            const payload = await this.hooks.runAsync(AXPRuntimeRemoteHookKeys.QueryExecute, { name: key, input });
+        return (i) => query.fetch(i);
+    }
+    createRemoteHandler(key) {
+        return async (input, options) => {
+            const payload = await this.hooks.runAsync(AXPRuntimeRemoteHookKeys.QueryExecute, {
+                name: key,
+                input: normalizeCommandInputForRemote(input),
+                options,
+            });
             if (!payload.handled) {
                 throw new Error(`Query '${key}' is not registered and no remote handler is available`);
             }
             return (payload.result ?? null);
+        };
+    }
+    async runWithMiddlewareAndEvents(key, input, handler, options) {
+        const pluginMiddlewares = this.getPluginMiddlewares(key);
+        const globalMiddlewares = this.registry.getMiddlewares();
+        // Registry middlewares are stored as AXPQueryMiddleware (unknown input/result).
+        // Re-wrap in injection context and narrow for this fetch's TInput/TResult.
+        const wrappedMiddlewares = [
+            ...globalMiddlewares,
+            ...pluginMiddlewares,
+        ].map((middleware) => {
+            const wrapped = (context, next) => runInInjectionContext(this.injector, () => middleware(context, next));
+            return wrapped;
         });
+        const composed = composeQueryMiddlewares(wrappedMiddlewares)((context) => handler(context.input, context.options));
+        return this.runWithEvents(key, input, () => composed({ input, key, options }), options);
     }
-    async runWithEvents(key, input, run) {
+    async runWithEvents(key, input, run, options) {
         const executionId = crypto.randomUUID();
         const startedAt = performance.now();
         const beforeEvent = {
@@ -610,6 +675,7 @@ class AXPQueryExecutor {
             stage: 'before',
             key,
             input,
+            options,
         };
         await this.queryEvents.emit(beforeEvent);
         try {
@@ -620,6 +686,7 @@ class AXPQueryExecutor {
                 stage: 'after',
                 key,
                 input,
+                options,
                 success: true,
                 result,
                 durationMs,
@@ -634,6 +701,7 @@ class AXPQueryExecutor {
                 stage: 'after',
                 key,
                 input,
+                options,
                 success: false,
                 error,
                 durationMs,
@@ -647,14 +715,19 @@ class AXPQueryExecutor {
             ?.filter((ext) => (ext.target instanceof RegExp ? ext.target.test(key) : ext.target === key))
             .map((ext) => ext.middleware) ?? []);
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPQueryExecutor, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPQueryExecutor, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPQueryExecutor, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPQueryExecutor, providedIn: 'root' }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPQueryExecutor, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPQueryExecutor, decorators: [{
             type: Injectable,
             args: [{ providedIn: 'root' }]
         }] });
 
+/**
+ * Re-exports shared query middleware contracts.
+ * Registration stays client-side (`provideQueryMiddleware` / registry.use).
+ */
+
 class AXPQueryService {
     constructor() {
         this.registry = inject(AXPQueryRegistry);
@@ -679,14 +752,14 @@ class AXPQueryService {
     clear() {
         this.registry.clear();
     }
-    // Executor methods
-    async fetch(key, input) {
-        return this.executor.fetch(key, input);
+    /** Same envelope pattern as {@link AXPCommandService.execute}. */
+    async fetch(key, input, options) {
+        return this.executor.fetch(key, input, options);
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPQueryService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPQueryService, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPQueryService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPQueryService, providedIn: 'root' }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPQueryService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPQueryService, decorators: [{
             type: Injectable,
             args: [{ providedIn: 'root' }]
         }] });
@@ -733,10 +806,10 @@ class AXPViewRegistry {
         this.registry.clear();
         this.middlewares.length = 0;
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPViewRegistry, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPViewRegistry, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPViewRegistry, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPViewRegistry, providedIn: 'root' }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPViewRegistry, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPViewRegistry, decorators: [{
             type: Injectable,
             args: [{ providedIn: 'root' }]
         }] });
@@ -769,10 +842,10 @@ class AXPViewExecutor {
             ?.filter(ext => ext.target instanceof RegExp ? ext.target.test(key) : ext.target === key)
             .map(ext => ext.middleware) ?? [];
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPViewExecutor, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPViewExecutor, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPViewExecutor, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPViewExecutor, providedIn: 'root' }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPViewExecutor, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPViewExecutor, decorators: [{
             type: Injectable,
             args: [{ providedIn: 'root' }]
         }] });
@@ -806,10 +879,10 @@ class AXPViewService {
     async provide(key, input) {
         return this.executor.provide(key, input);
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPViewService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPViewService, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPViewService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPViewService, providedIn: 'root' }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPViewService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPViewService, decorators: [{
             type: Injectable,
             args: [{ providedIn: 'root' }]
         }] });
@@ -925,10 +998,10 @@ class AXPPolicyEngineRegistry {
         await composed(context);
         return context;
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPPolicyEngineRegistry, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPPolicyEngineRegistry, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPPolicyEngineRegistry, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPPolicyEngineRegistry, providedIn: 'root' }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPPolicyEngineRegistry, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPPolicyEngineRegistry, decorators: [{
             type: Injectable,
             args: [{ providedIn: 'root' }]
         }] });
@@ -977,10 +1050,10 @@ class AXPPolicyEngineService {
         //     }
         // }
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPPolicyEngineService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
-    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPPolicyEngineService, providedIn: 'root' }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPPolicyEngineService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPPolicyEngineService, providedIn: 'root' }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPPolicyEngineService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPPolicyEngineService, decorators: [{
             type: Injectable,
             args: [{
                     providedIn: 'root'
@@ -1002,13 +1075,14 @@ class AXPPolicyEngineDirective {
                 policies: castArray(policy),
                 sender: this.elementRef.nativeElement
             });
-        }, ...(ngDevMode ? [{ debugName: "#eff" }] : /* istanbul ignore next */ []));
+        }, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "#eff" }] : /* istanbul ignore next */ []));
     }
     #eff;
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPPolicyEngineDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive }); }
-    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "21.2.9", type: AXPPolicyEngineDirective, isStandalone: true, selector: "[axp-apply-policy]", inputs: { policy: { classPropertyName: "policy", publicName: "axp-apply-policy", isSignal: true, isRequired: true, transformFunction: null } }, ngImport: i0 }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPPolicyEngineDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive }); }
+    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "22.0.8", type: AXPPolicyEngineDirective, isStandalone: true, selector: "[axp-apply-policy]", inputs: { policy: { classPropertyName: "policy", publicName: "axp-apply-policy", isSignal: true, isRequired: true, transformFunction: null } }, ngImport: i0 }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPPolicyEngineDirective, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPPolicyEngineDirective, decorators: [{
             type: Directive,
             args: [{
                     selector: '[axp-apply-policy]',
@@ -1081,19 +1155,108 @@ class AXPRuntimeModule {
             console.log('[AXPRuntimeModule] Policy Engine Setup:', this._policyEngineSetup);
         }
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPRuntimeModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule }); }
-    static { this.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "21.2.9", ngImport: i0, type: AXPRuntimeModule }); }
-    static { this.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPRuntimeModule }); }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPRuntimeModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule }); }
+    static { this.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "22.0.8", ngImport: i0, type: AXPRuntimeModule }); }
+    static { this.ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPRuntimeModule }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXPRuntimeModule, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPRuntimeModule, decorators: [{
             type: NgModule
         }], ctorParameters: () => [] });
 
+//#region ---- Runtime transport hooks ----
+/**
+ * Distributed hook keys for keyed runtime transports (SSE, beacon, streaming POST).
+ * Connectivity implements these via {@link AXPHookService.runAsync}.
+ */
+const AXPRuntimeTransportHookKeys = {
+    Execute: 'runtime.transport.execute',
+};
+//#endregion
+
+//#region ---- Imports ----
+//#endregion
+//#region ---- Runtime transport service ----
+/**
+ * Dispatches keyed runtime transports (SSE, beacon, streaming) through distributed hooks.
+ */
+class AXPRuntimeTransportService {
+    constructor() {
+        this.hooks = inject(AXPHookService);
+    }
+    async execute(key, input) {
+        const payload = await this.hooks.runAsync(AXPRuntimeTransportHookKeys.Execute, { key, input });
+        if (!payload.handled) {
+            throw new Error(`No runtime transport registered for key: ${key}`);
+        }
+        return payload.result;
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPRuntimeTransportService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPRuntimeTransportService, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: AXPRuntimeTransportService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
+//#region ---- Imports ----
+//#endregion
+//#region ---- Provider factory ----
+/**
+ * Registers an external-stack implementation of `runtime.command.execute-bulk`.
+ *
+ * Use this when the host app consumes only the ACoreX **client** libraries and
+ * implements the API in another stack. Entity bulk actions (`Entity:Bulk`,
+ * selected delete, etc.) call {@link AXPBulkCommandService}, which runs this hook
+ * once — no client-side per-id fan-out.
+ *
+ * @example
+ * ```typescript
+ * @NgModule({
+ *   providers: [
+ *     ...provideExternalRuntimeBulkTransport(async (request) => {
+ *       const response = await fetch(`${apiBase}/v1/runtime/commands/bulk`, {
+ *         method: 'POST',
+ *         headers: {
+ *           'Content-Type': 'application/json',
+ *           Authorization: `Bearer ${token}`,
+ *         },
+ *         body: JSON.stringify(request),
+ *       });
+ *       return response.json();
+ *     }),
+ *   ],
+ * })
+ * export class AppModule {}
+ * ```
+ */
+function provideExternalRuntimeBulkTransport(transport, options = {}) {
+    const priority = options.priority ?? -100;
+    const provider = {
+        key: AXPRuntimeRemoteHookKeys.CommandExecuteBulk,
+        priority,
+        async execute(payload) {
+            if (payload.handled) {
+                return payload;
+            }
+            const result = await transport(payload.request);
+            return { ...payload, handled: true, result };
+        },
+    };
+    return [
+        {
+            provide: AXP_DISTRIBUTED_EVENT_LISTENER_PROVIDER,
+            useValue: provider,
+            multi: true,
+        },
+    ];
+}
+//#endregion
+
 // Commands
 
 /**
  * Generated bundle index. Do not edit.
  */
 
-export { AXPCommandEventsService, AXPCommandExecutor, AXPCommandRegistry, AXPCommandService, AXPPolicyEngineContext, AXPPolicyEngineDirective, AXPPolicyEngineRegistry, AXPPolicyEngineService, AXPQueryEventsService, AXPQueryExecutor, AXPQueryRegistry, AXPQueryService, AXPRuntimeModule, AXPRuntimeRemoteHookKeys, AXPViewExecutor, AXPViewRegistry, AXPViewService, AXP_COMMAND_EXTENSION, AXP_COMMAND_MIDDLEWARE_SETUP, AXP_COMMAND_SETUP, AXP_POLICY_ENGINE_MIDDLEWARE_SETUP, AXP_POLICY_EXTENSION, AXP_QUERY_EXTENSION, AXP_QUERY_MIDDLEWARE_SETUP, AXP_QUERY_SETUP, AXP_VIEW_EXTENSION, AXP_VIEW_SETUP, composeCommandMiddlewares, composePolicyEngineMiddlewares, composeQueryMiddlewares, composeViewMiddlewares, provideCommand, provideCommandMiddleware, provideCommandSetups, providePolicySetups, provideQueryMiddleware, provideQuerySetups, provideViewSetup, provideViewSetups };
+export { AXPBulkCommandService, AXPCommandEventsService, AXPCommandExecutor, AXPCommandRegistry, AXPCommandService, AXPPolicyEngineContext, AXPPolicyEngineDirective, AXPPolicyEngineRegistry, AXPPolicyEngineService, AXPQueryEventsService, AXPQueryExecutor, AXPQueryRegistry, AXPQueryService, AXPRuntimeModule, AXPRuntimeRemoteHookKeys, AXPRuntimeTransportHookKeys, AXPRuntimeTransportService, AXPViewExecutor, AXPViewRegistry, AXPViewService, AXP_COMMAND_EXTENSION, AXP_COMMAND_MIDDLEWARE_SETUP, AXP_COMMAND_SETUP, AXP_POLICY_ENGINE_MIDDLEWARE_SETUP, AXP_POLICY_EXTENSION, AXP_QUERY_EXTENSION, AXP_QUERY_MIDDLEWARE_SETUP, AXP_QUERY_SETUP, AXP_VIEW_EXTENSION, AXP_VIEW_SETUP, composePolicyEngineMiddlewares, composeViewMiddlewares, provideCommand, provideCommandMiddleware, provideCommandSetups, provideExternalRuntimeBulkTransport, providePolicySetups, provideQueryMiddleware, provideQuerySetups, provideViewSetup, provideViewSetups };
 //# sourceMappingURL=acorex-platform-framework-client-runtime.mjs.map