@acorex-platform/framework-shared 0.0.18 → 0.0.20

package/runtime/src/lib/commands/bulk-command-failure.util.js

@@ -0,0 +1,75 @@
+"use strict";
+//#region ---- Imports ----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyzeBulkCommandFailures = analyzeBulkCommandFailures;
+exports.buildBulkCommandFailureMessage = buildBulkCommandFailureMessage;
+//#endregion
+//#region ---- Analyze bulk failures ----
+/**
+ * Classifies failed bulk item results for UX:
+ * - `single` — exactly one failure (show that item’s reason)
+ * - `shared-code` — 2+ failures, all with the same `message.code`
+ * - `mixed` — 2+ failures with differing / missing codes (summary only)
+ */
+function analyzeBulkCommandFailures(results) {
+    var _a, _b;
+    const failed = (results !== null && results !== void 0 ? results : []).filter((item) => !item.success);
+    if (failed.length === 0) {
+        return { failed, mode: 'none' };
+    }
+    if (failed.length === 1) {
+        const representative = (_a = failed[0]) === null || _a === void 0 ? void 0 : _a.message;
+        return {
+            failed,
+            mode: 'single',
+            sharedCode: typeof (representative === null || representative === void 0 ? void 0 : representative.code) === 'string' ? representative.code : undefined,
+            representative,
+        };
+    }
+    const codes = failed
+        .map((item) => { var _a; return (_a = item.message) === null || _a === void 0 ? void 0 : _a.code; })
+        .filter((code) => typeof code === 'string' && code.trim().length > 0);
+    if (codes.length === failed.length && new Set(codes).size === 1) {
+        return {
+            failed,
+            mode: 'shared-code',
+            sharedCode: codes[0],
+            representative: (_b = failed[0]) === null || _b === void 0 ? void 0 : _b.message,
+        };
+    }
+    return { failed, mode: 'mixed' };
+}
+/**
+ * Top-level soft-fail `message` for a bulk command response.
+ * Lifts `code` when there is a single failure or all failures share one code.
+ */
+function buildBulkCommandFailureMessage(succeeded, failed, results) {
+    var _a, _b, _c, _d;
+    if (failed <= 0) {
+        return undefined;
+    }
+    const analysis = analyzeBulkCommandFailures(results);
+    if (analysis.mode === 'single' || analysis.mode === 'shared-code') {
+        const code = (_a = analysis.sharedCode) !== null && _a !== void 0 ? _a : (_b = analysis.representative) === null || _b === void 0 ? void 0 : _b.code;
+        const message = {
+            type: 'error',
+            code,
+            details: (_c = analysis.representative) === null || _c === void 0 ? void 0 : _c.details,
+        };
+        // Prefer code → client i18n; keep @i18n text if the item already used one.
+        const text = (_d = analysis.representative) === null || _d === void 0 ? void 0 : _d.text;
+        if (typeof text === 'string' && text.startsWith('@')) {
+            message.text = text;
+        }
+        else if (text && typeof text === 'object') {
+            message.text = text;
+        }
+        return message;
+    }
+    return {
+        type: 'error',
+        text: `Bulk command finished with ${succeeded} succeeded and ${failed} failed.`,
+    };
+}
+//#endregion
+//# sourceMappingURL=bulk-command-failure.util.js.map

package/runtime/src/lib/commands/bulk-command-failure.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-command-failure.util.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/commands/bulk-command-failure.util.ts"],"names":[],"mappings":";AAAA,2BAA2B;;AA+B3B,gEAgCC;AAMD,wEA+BC;AA/ED,YAAY;AAEZ,yCAAyC;AAEzC;;;;;GAKG;AACH,SAAgB,0BAA0B,CACxC,OAAsD;;IAEtD,MAAM,MAAM,GAAG,CAAC,OAAO,aAAP,OAAO,cAAP,OAAO,GAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAClC,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,cAAc,GAAG,MAAA,MAAM,CAAC,CAAC,CAAC,0CAAE,OAAO,CAAC;QAC1C,OAAO;YACL,MAAM;YACN,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,OAAO,CAAA,cAAc,aAAd,cAAc,uBAAd,cAAc,CAAE,IAAI,CAAA,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;YACtF,cAAc;SACf,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,MAAM;SACjB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,WAAC,OAAA,MAAA,IAAI,CAAC,OAAO,0CAAE,IAAI,CAAA,EAAA,CAAC;SACjC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAExF,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QAChE,OAAO;YACL,MAAM;YACN,IAAI,EAAE,aAAa;YACnB,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;YACpB,cAAc,EAAE,MAAA,MAAM,CAAC,CAAC,CAAC,0CAAE,OAAO;SACnC,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,SAAgB,8BAA8B,CAC5C,SAAiB,EACjB,MAAc,EACd,OAAmC;;IAEnC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAChB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,QAAQ,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;IACrD,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QAClE,MAAM,IAAI,GAAG,MAAA,QAAQ,CAAC,UAAU,mCAAI,MAAA,QAAQ,CAAC,cAAc,0CAAE,IAAI,CAAC;QAClE,MAAM,OAAO,GAAsB;YACjC,IAAI,EAAE,OAAO;YACb,IAAI;YACJ,OAAO,EAAE,MAAA,QAAQ,CAAC,cAAc,0CAAE,OAAO;SAC1C,CAAC;QACF,2EAA2E;QAC3E,MAAM,IAAI,GAAG,MAAA,QAAQ,CAAC,cAAc,0CAAE,IAAI,CAAC;QAC3C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrD,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;QACtB,CAAC;aAAM,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC5C,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;QACtB,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,8BAA8B,SAAS,kBAAkB,MAAM,UAAU;KAChF,CAAC;AACJ,CAAC;AAED,YAAY"}

package/runtime/src/lib/commands/bulk-command.types.d.ts

@@ -0,0 +1,45 @@
+import type { AXDataSourceFilterOption, AXPRuntimeMessage } from '@acorex-platform/framework-shared/core';
+/** Default cap for ids resolved from a bulk filter before fan-out. */
+export declare const AXP_BULK_COMMAND_DEFAULT_MAX_ITEMS = 100;
+/** Default parallel fan-out workers for bulk command execution. */
+export declare const AXP_BULK_COMMAND_DEFAULT_CONCURRENCY = 1;
+/** Hard upper bound for bulk filter resolution / fan-out. */
+export declare const AXP_BULK_COMMAND_HARD_MAX_ITEMS = 500;
+/**
+ * Filter-only bulk execute request.
+ * Target rows are resolved server-side via entity query + {@link filter}.
+ */
+export interface AXPBulkCommandRequest {
+    /** Server-executable command key (e.g. `Entity:Delete:Default`, `BackgroundJobManagement:Schedule:RunNow`). */
+    name: string;
+    /**
+     * Entity used to resolve {@link filter} and, for `Entity:*:Default` names,
+     * injected into each fan-out command input (do not repeat in {@link input}).
+     */
+    entity: string;
+    /** Same filter shape as runtime entity queries. Selected rows → `{ field:'id', operator:{type:'in'}, value: ids }`. */
+    filter: AXDataSourceFilterOption;
+    /** Shared input merged into each per-item command call (patch fields, etc. — not `entity`). */
+    input?: Record<string, unknown>;
+    /** Field name for the resolved id in each command input. Default: `id`. */
+    idField?: string;
+    /** Max rows to resolve from filter (capped by hard max). */
+    maxItems?: number;
+    /** Parallel fan-out size (capped). Default: 1 (sequential). */
+    concurrency?: number;
+}
+export interface AXPBulkCommandItemResult {
+    id: string;
+    success: boolean;
+    data?: unknown;
+    message?: AXPRuntimeMessage;
+}
+export interface AXPBulkCommandResultData {
+    total: number;
+    succeeded: number;
+    failed: number;
+    /** True when filter matched more rows than {@link AXPBulkCommandRequest.maxItems}. */
+    truncated?: boolean;
+    results: AXPBulkCommandItemResult[];
+}
+//# sourceMappingURL=bulk-command.types.d.ts.map

package/runtime/src/lib/commands/bulk-command.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-command.types.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/commands/bulk-command.types.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAE1G,sEAAsE;AACtE,eAAO,MAAM,kCAAkC,MAAM,CAAC;AAEtD,mEAAmE;AACnE,eAAO,MAAM,oCAAoC,IAAI,CAAC;AAEtD,6DAA6D;AAC7D,eAAO,MAAM,+BAA+B,MAAM,CAAC;AAEnD;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,+GAA+G;IAC/G,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,uHAAuH;IACvH,MAAM,EAAE,wBAAwB,CAAC;IACjC,+FAA+F;IAC/F,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,sFAAsF;IACtF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,wBAAwB,EAAE,CAAC;CACrC"}

package/runtime/src/lib/commands/bulk-command.types.js

@@ -0,0 +1,12 @@
+"use strict";
+//#region ---- Bulk command contracts ----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AXP_BULK_COMMAND_HARD_MAX_ITEMS = exports.AXP_BULK_COMMAND_DEFAULT_CONCURRENCY = exports.AXP_BULK_COMMAND_DEFAULT_MAX_ITEMS = void 0;
+/** Default cap for ids resolved from a bulk filter before fan-out. */
+exports.AXP_BULK_COMMAND_DEFAULT_MAX_ITEMS = 100;
+/** Default parallel fan-out workers for bulk command execution. */
+exports.AXP_BULK_COMMAND_DEFAULT_CONCURRENCY = 1;
+/** Hard upper bound for bulk filter resolution / fan-out. */
+exports.AXP_BULK_COMMAND_HARD_MAX_ITEMS = 500;
+//#endregion
+//# sourceMappingURL=bulk-command.types.js.map

package/runtime/src/lib/commands/bulk-command.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-command.types.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/commands/bulk-command.types.ts"],"names":[],"mappings":";AAAA,0CAA0C;;;AAI1C,sEAAsE;AACzD,QAAA,kCAAkC,GAAG,GAAG,CAAC;AAEtD,mEAAmE;AACtD,QAAA,oCAAoC,GAAG,CAAC,CAAC;AAEtD,6DAA6D;AAChD,QAAA,+BAA+B,GAAG,GAAG,CAAC;AA0CnD,YAAY"}

package/runtime/src/lib/commands/catalog-command-definition.d.ts

@@ -2,7 +2,7 @@
  * Build-time command metadata only. Safe under Node (e.g. generate-runtime-catalog) without loading the command executor stack.
  * Sidecars should import `defineCommand` from `@acorex-platform/framework-shared/runtime`.
  */
-export { defineCommand } from './define-command';
 export * from './command-definition.categories';
 export * from './command-definition.types';
+export { defineCommand } from './define-command';
 //# sourceMappingURL=catalog-command-definition.d.ts.map

package/runtime/src/lib/commands/catalog-command-definition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog-command-definition.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/commands/catalog-command-definition.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,cAAc,iCAAiC,CAAC;AAChD,cAAc,4BAA4B,CAAC"}
+{"version":3,"file":"catalog-command-definition.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/commands/catalog-command-definition.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,iCAAiC,CAAC;AAChD,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}

package/runtime/src/lib/commands/catalog-command-definition.js

@@ -6,8 +6,8 @@ const tslib_1 = require("tslib");
  * Build-time command metadata only. Safe under Node (e.g. generate-runtime-catalog) without loading the command executor stack.
  * Sidecars should import `defineCommand` from `@acorex-platform/framework-shared/runtime`.
  */
-var define_command_1 = require("./define-command");
-Object.defineProperty(exports, "defineCommand", { enumerable: true, get: function () { return define_command_1.defineCommand; } });
 tslib_1.__exportStar(require("./command-definition.categories"), exports);
 tslib_1.__exportStar(require("./command-definition.types"), exports);
+var define_command_1 = require("./define-command");
+Object.defineProperty(exports, "defineCommand", { enumerable: true, get: function () { return define_command_1.defineCommand; } });
 //# sourceMappingURL=catalog-command-definition.js.map

package/runtime/src/lib/commands/catalog-command-definition.js.map

@@ -1 +1 @@
-{"version":3,"file":"catalog-command-definition.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/commands/catalog-command-definition.ts"],"names":[],"mappings":";;;;AAAA;;;GAGG;AACH,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AACtB,0EAAgD;AAChD,qEAA2C"}
+{"version":3,"file":"catalog-command-definition.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/commands/catalog-command-definition.ts"],"names":[],"mappings":";;;;AAAA;;;GAGG;AACH,0EAAgD;AAChD,qEAA2C;AAC3C,mDAAiD;AAAxC,+GAAA,aAAa,OAAA"}

package/runtime/src/lib/commands/command-definition.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-definition.types.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/commands/command-definition.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,uBAAuB,EACvB,gCAAgC,EACjC,MAAM,yCAAyC,CAAC;AAEjD,cAAc,yCAAyC,CAAC;AAIxD,MAAM,MAAM,2BAA2B,GACnC;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,GACD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAMN,MAAM,WAAW,4BAA6B,SAAQ,gCAAgC;IACpF,wEAAwE;IACxE,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,uBAAuB,CAAC;IACvC,QAAQ,EAAE,2BAA2B,CAAC;CACvC"}
+{"version":3,"file":"command-definition.types.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/commands/command-definition.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,gCAAgC,EAAE,MAAM,yCAAyC,CAAC;AAEzH,cAAc,yCAAyC,CAAC;AAIxD,MAAM,MAAM,2BAA2B,GACnC;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,GACD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAMN,MAAM,WAAW,4BAA6B,SAAQ,gCAAgC;IACpF,wEAAwE;IACxE,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,uBAAuB,CAAC;IACvC,QAAQ,EAAE,2BAA2B,CAAC;CACvC"}

package/runtime/src/lib/commands/command-definition.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"command-definition.types.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/commands/command-definition.types.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAOH,kFAAwD;AA2BxD,YAAY"}
+{"version":3,"file":"command-definition.types.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/commands/command-definition.types.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAIH,kFAAwD;AA2BxD,YAAY"}

package/runtime/src/lib/commands/command-execute-options.types.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Parent bag for command execute knobs (not business input).
+ * Extensible — add fields here instead of new positional args.
+ * Separate from {@link AXPQueryExecuteOptions}.
+ */
+export interface AXPCommandExecuteOptions {
+}
+//# sourceMappingURL=command-execute-options.types.d.ts.map

package/runtime/src/lib/commands/command-execute-options.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-execute-options.types.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/commands/command-execute-options.types.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;CAExC"}

package/runtime/src/lib/commands/command-execute-options.types.js

@@ -0,0 +1,5 @@
+"use strict";
+//#region ----- Command execute options -----
+Object.defineProperty(exports, "__esModule", { value: true });
+//#endregion
+//# sourceMappingURL=command-execute-options.types.js.map

package/runtime/src/lib/commands/command-execute-options.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-execute-options.types.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/commands/command-execute-options.types.ts"],"names":[],"mappings":";AAAA,6CAA6C;;AAW7C,YAAY"}

package/runtime/src/lib/commands/command.interface.d.ts

@@ -1,6 +1,17 @@
-import { AXPExecuteCommandResult } from '@acorex-platform/framework-shared/core';
-export type AXPExecuteCommandResultPromise<TResult = any> = Promise<AXPExecuteCommandResult<TResult>>;
-export interface AXPCommand<TInput = any, TResult = any> {
-    execute(input: TInput): AXPExecuteCommandResultPromise<TResult>;
+import type { AXPRuntimeCommandResult } from '@acorex-platform/framework-shared/core';
+/**
+ * Command execute promise.
+ * Success envelope still uses shared kinds (`value` | `object` | `collection`) on
+ * {@link AXPRuntimeCommandResult}, but unlike queries there is no kind-driven
+ * standard input pack (no skip/take contract).
+ */
+export type AXPCommandExecuteResultPromise<TResult = unknown> = Promise<AXPRuntimeCommandResult<TResult>>;
+/**
+ * Client/server command handler contract.
+ * Input shape is free; return {@link AXPRuntimeCommandResult} with the appropriate
+ * success `kind` for the payload.
+ */
+export interface AXPCommand<TInput = unknown, TResult = unknown> {
+    execute(input: TInput): AXPCommandExecuteResultPromise<TResult>;
 }
 //# sourceMappingURL=command.interface.d.ts.map

package/runtime/src/lib/commands/command.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/commands/command.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AAEjF,MAAM,MAAM,8BAA8B,CAAC,OAAO,GAAG,GAAG,IAAI,OAAO,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,CAAC;AAEtG,MAAM,WAAW,UAAU,CAAC,MAAM,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG;IACrD,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,8BAA8B,CAAC,OAAO,CAAC,CAAC;CACjE"}
+{"version":3,"file":"command.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/commands/command.interface.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AAMtF;;;;;GAKG;AACH,MAAM,MAAM,8BAA8B,CAAC,OAAO,GAAG,OAAO,IAC1D,OAAO,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,CAAC;AAE5C;;;;GAIG;AACH,MAAM,WAAW,UAAU,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IAC7D,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,8BAA8B,CAAC,OAAO,CAAC,CAAC;CACjE"}

package/runtime/src/lib/commands/command.interface.js

@@ -1,3 +1,5 @@
 "use strict";
+//#region ---- Imports ----
 Object.defineProperty(exports, "__esModule", { value: true });
+//#endregion
 //# sourceMappingURL=command.interface.js.map

package/runtime/src/lib/commands/command.interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"command.interface.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/commands/command.interface.ts"],"names":[],"mappings":""}
+{"version":3,"file":"command.interface.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/commands/command.interface.ts"],"names":[],"mappings":";AAAA,2BAA2B;;AA0B3B,YAAY"}

package/runtime/src/lib/commands/command.middleware.d.ts

@@ -0,0 +1,22 @@
+import type { AXPCommandExecuteResultPromise } from './command.interface';
+import type { AXPCommandExecuteOptions } from './command-execute-options.types';
+/**
+ * Context passed through the named-command middleware pipeline.
+ * Separate from query middleware — do not unify the public aliases.
+ *
+ * Defaults use `any` (same as the former client-only types) so targeted
+ * middlewares remain assignable to the untyped registry slot.
+ */
+export type AXPCommandMiddlewareContext<TInput = any> = {
+    key: string;
+    input: TInput;
+    options?: AXPCommandExecuteOptions;
+};
+/**
+ * Onion middleware around a named command execute.
+ * `next` / return are command envelopes ({@link AXPCommandExecuteResultPromise}),
+ * not an arbitrary `TResult` payload.
+ */
+export type AXPCommandMiddleware<TInput = any, TResult = any> = (context: AXPCommandMiddlewareContext<TInput>, next: (context: AXPCommandMiddlewareContext<TInput>) => AXPCommandExecuteResultPromise<TResult>) => AXPCommandExecuteResultPromise<TResult>;
+export declare function composeCommandMiddlewares<TInput, TResult>(middlewares: readonly AXPCommandMiddleware<TInput, TResult>[]): (handler: (context: AXPCommandMiddlewareContext<TInput>) => AXPCommandExecuteResultPromise<TResult>) => (context: AXPCommandMiddlewareContext<TInput>) => AXPCommandExecuteResultPromise<TResult>;
+//# sourceMappingURL=command.middleware.d.ts.map

package/runtime/src/lib/commands/command.middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.middleware.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/commands/command.middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAIhF;;;;;;GAMG;AACH,MAAM,MAAM,2BAA2B,CAAC,MAAM,GAAG,GAAG,IAAI;IACtD,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,wBAAwB,CAAC;CACpC,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,CAAC,MAAM,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,CAC9D,OAAO,EAAE,2BAA2B,CAAC,MAAM,CAAC,EAC5C,IAAI,EAAE,CAAC,OAAO,EAAE,2BAA2B,CAAC,MAAM,CAAC,KAAK,8BAA8B,CAAC,OAAO,CAAC,KAC5F,8BAA8B,CAAC,OAAO,CAAC,CAAC;AAE7C,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,OAAO,EACvD,WAAW,EAAE,SAAS,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAC5D,CACD,OAAO,EAAE,CAAC,OAAO,EAAE,2BAA2B,CAAC,MAAM,CAAC,KAAK,8BAA8B,CAAC,OAAO,CAAC,KAC/F,CAAC,OAAO,EAAE,2BAA2B,CAAC,MAAM,CAAC,KAAK,8BAA8B,CAAC,OAAO,CAAC,CAc7F"}

package/runtime/src/lib/commands/command.middleware.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.composeCommandMiddlewares = composeCommandMiddlewares;
+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 = (context) => mw(context, next);
+        }
+        return composed;
+    };
+}
+//#endregion
+//# sourceMappingURL=command.middleware.js.map

package/runtime/src/lib/commands/command.middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.middleware.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/commands/command.middleware.ts"],"names":[],"mappings":";;AA4BA,8DAkBC;AAlBD,SAAgB,yBAAyB,CACvC,WAA6D;IAI7D,OAAO,CACL,OAAkG,EAClG,EAAE;QACF,IAAI,QAAQ,GAAG,OAAO,CAAC;QAEvB,KAAK,IAAI,CAAC,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACjD,MAAM,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;YAC1B,MAAM,IAAI,GAAG,QAAQ,CAAC;YACtB,QAAQ,GAAG,CAAC,OAA4C,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACjF,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;AACJ,CAAC;AAED,YAAY"}

package/runtime/src/lib/commands/entity-action-command-input.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Flat single-input shape for entity list/toolbar/detail command invocations.
+ *
+ * Producers pass these fields at the root of `commandService.execute(key, input)`.
+ * Handlers should use {@link resolveEntityActionCommandInput} to normalize.
+ */
+export interface AXPEntityActionEntityInfo {
+    name: string;
+    module: string;
+    title?: unknown;
+    parentKey?: string;
+    source?: string;
+}
+export interface AXPEntityActionCommandInput {
+    /** Entity full name, e.g. `HealthCore.BodyPart`. */
+    entity?: string;
+    /** Row, selection, or create seed. */
+    data?: unknown;
+    /** Evaluated action options / process flags. */
+    options?: Record<string, unknown>;
+    entityInfo?: AXPEntityActionEntityInfo;
+    /** Parent record when invoked from a related list. */
+    hostContext?: unknown;
+    /** Action metadata (producers / viewers). */
+    metadata?: unknown;
+    /** Bulk / multi-delete payloads. */
+    entities?: unknown;
+    /** Refresh / middleware meta (e.g. refreshTargetId). */
+    meta?: unknown;
+    /** Open-list filter conditions (when used). */
+    conditions?: unknown;
+    /** Legacy root refs still accepted by some plugins. */
+    refId?: unknown;
+    refType?: unknown;
+}
+export type AXPEntityActionCommandInputLike = AXPEntityActionCommandInput | null | undefined;
+export interface AXPEntityActionResolvedRef {
+    refType: string;
+    refId: string;
+    rowData?: Record<string, unknown>;
+    options: Record<string, unknown>;
+    resolved: AXPEntityActionCommandInput;
+}
+export interface AXPEntityActionResolvedBulkRef {
+    refType: string;
+    ids: string[];
+    rows: Record<string, unknown>[];
+    options: Record<string, unknown>;
+    resolved: AXPEntityActionCommandInput;
+}
+/**
+ * Normalizes flat entity-action input into {@link AXPEntityActionCommandInput}.
+ * Reads only root fields (`entity`, `data`, `options`, `entityInfo`, `hostContext`,
+ * `metadata`, `entities`, `meta`, `conditions`, `refId`, `refType`).
+ */
+export declare function resolveEntityActionCommandInput(input: AXPEntityActionCommandInputLike | unknown): AXPEntityActionCommandInput;
+/**
+ * First row/object from `data` (array → first element; object → itself).
+ */
+export declare function entityActionDataRecord(data: unknown): Record<string, unknown> | undefined;
+/**
+ * All row objects from `data` (array, single object, or empty).
+ */
+export declare function entityActionDataRows(data: unknown): Record<string, unknown>[];
+/**
+ * Resolves entity/plugin refType from flat input:
+ * `options.refType` → `entity` → `entityInfo.source` → root `refType`.
+ */
+export declare function entityActionRefType(resolved: AXPEntityActionCommandInput): string;
+/**
+ * Resolves a single-record ref id from options, row data, or root `refId`.
+ */
+export declare function entityActionRefId(resolved: AXPEntityActionCommandInput, rowData?: Record<string, unknown>): string | undefined;
+/**
+ * Single-record entity/plugin ref (`refType` + `refId`) from flat command input.
+ */
+export declare function resolveEntityActionRef(input: AXPEntityActionCommandInputLike | unknown): AXPEntityActionResolvedRef | null;
+/**
+ * Bulk entity/plugin ref (`refType` + row ids) from flat command input.
+ */
+export declare function resolveEntityActionBulkRef(input: AXPEntityActionCommandInputLike | unknown): AXPEntityActionResolvedBulkRef | null;
+/**
+ * Picks a field from root input, falling back to `options[field]`.
+ * Useful for commands that accept both root and options-nested shapes.
+ */
+export declare function pickInputOrOptionsField<T = unknown>(input: unknown, field: string): T | undefined;
+/**
+ * Merges related-list / create seed payload:
+ * `hostContext` → `data` → `options.process.data` (later wins).
+ */
+export declare function mergeEntityActionProcessData(input: AXPEntityActionCommandInputLike | unknown): Record<string, unknown>;
+/**
+ * Hard-strips unknown envelope keys before remote transport so the HTTP body
+ * is business input only. Does not merge or read nested payload from those keys.
+ *
+ * Nest/express JSON body parsing (strict) accepts only objects and arrays.
+ * Entity `byKey` / GetOne often pass a bare id string — wrap as `{ id }` so the
+ * request is valid JSON over HTTP (handlers already accept both shapes).
+ */
+export declare function normalizeCommandInputForRemote(input: unknown): unknown;
+//# sourceMappingURL=entity-action-command-input.d.ts.map

package/runtime/src/lib/commands/entity-action-command-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-action-command-input.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/commands/entity-action-command-input.ts"],"names":[],"mappings":"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"}

package/runtime/src/lib/commands/entity-action-command-input.js

@@ -0,0 +1,204 @@
+"use strict";
+//#region ----- Entity action command input (flat) -----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveEntityActionCommandInput = resolveEntityActionCommandInput;
+exports.entityActionDataRecord = entityActionDataRecord;
+exports.entityActionDataRows = entityActionDataRows;
+exports.entityActionRefType = entityActionRefType;
+exports.entityActionRefId = entityActionRefId;
+exports.resolveEntityActionRef = resolveEntityActionRef;
+exports.resolveEntityActionBulkRef = resolveEntityActionBulkRef;
+exports.pickInputOrOptionsField = pickInputOrOptionsField;
+exports.mergeEntityActionProcessData = mergeEntityActionProcessData;
+exports.normalizeCommandInputForRemote = normalizeCommandInputForRemote;
+function isPlainObject(value) {
+    return value != null && typeof value === 'object' && !Array.isArray(value);
+}
+function asEntityInfo(value) {
+    if (!isPlainObject(value)) {
+        return undefined;
+    }
+    const name = value['name'];
+    const moduleName = value['module'];
+    if (typeof name !== 'string' || typeof moduleName !== 'string') {
+        return undefined;
+    }
+    return {
+        name,
+        module: moduleName,
+        title: value['title'],
+        parentKey: typeof value['parentKey'] === 'string' ? value['parentKey'] : undefined,
+        source: typeof value['source'] === 'string' ? value['source'] : undefined,
+    };
+}
+function pickOptionalString(value) {
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function asDataRecord(value) {
+    return isPlainObject(value) ? value : undefined;
+}
+/**
+ * Normalizes flat entity-action input into {@link AXPEntityActionCommandInput}.
+ * Reads only root fields (`entity`, `data`, `options`, `entityInfo`, `hostContext`,
+ * `metadata`, `entities`, `meta`, `conditions`, `refId`, `refType`).
+ */
+function resolveEntityActionCommandInput(input) {
+    if (!isPlainObject(input)) {
+        return {};
+    }
+    const root = input;
+    return {
+        entity: pickOptionalString(root.entity),
+        data: root.data,
+        options: isPlainObject(root.options) ? root.options : undefined,
+        entityInfo: asEntityInfo(root.entityInfo),
+        hostContext: root.hostContext,
+        metadata: root.metadata,
+        entities: root.entities,
+        meta: root.meta,
+        conditions: root.conditions,
+        refId: root.refId,
+        refType: root.refType,
+    };
+}
+/**
+ * First row/object from `data` (array → first element; object → itself).
+ */
+function entityActionDataRecord(data) {
+    if (Array.isArray(data)) {
+        return asDataRecord(data[0]);
+    }
+    return asDataRecord(data);
+}
+/**
+ * All row objects from `data` (array, single object, or empty).
+ */
+function entityActionDataRows(data) {
+    if (Array.isArray(data)) {
+        return data.filter(isPlainObject);
+    }
+    const single = asDataRecord(data);
+    return single ? [single] : [];
+}
+/**
+ * Resolves entity/plugin refType from flat input:
+ * `options.refType` → `entity` → `entityInfo.source` → root `refType`.
+ */
+function entityActionRefType(resolved) {
+    var _a, _b, _c, _d, _e, _f;
+    const options = (_a = resolved.options) !== null && _a !== void 0 ? _a : {};
+    return String((_f = (_e = (_c = (_b = options['refType']) !== null && _b !== void 0 ? _b : resolved.entity) !== null && _c !== void 0 ? _c : (_d = resolved.entityInfo) === null || _d === void 0 ? void 0 : _d.source) !== null && _e !== void 0 ? _e : resolved.refType) !== null && _f !== void 0 ? _f : '');
+}
+/**
+ * Resolves a single-record ref id from options, row data, or root `refId`.
+ */
+function entityActionRefId(resolved, rowData) {
+    var _a, _b, _c, _d;
+    const options = (_a = resolved.options) !== null && _a !== void 0 ? _a : {};
+    const rawId = (_d = (_c = (_b = options['refId']) !== null && _b !== void 0 ? _b : rowData === null || rowData === void 0 ? void 0 : rowData['id']) !== null && _c !== void 0 ? _c : rowData === null || rowData === void 0 ? void 0 : rowData['_id']) !== null && _d !== void 0 ? _d : resolved.refId;
+    if (rawId == null || rawId === '') {
+        return undefined;
+    }
+    return String(rawId);
+}
+/**
+ * Single-record entity/plugin ref (`refType` + `refId`) from flat command input.
+ */
+function resolveEntityActionRef(input) {
+    var _a;
+    const resolved = resolveEntityActionCommandInput(input);
+    const options = (_a = resolved.options) !== null && _a !== void 0 ? _a : {};
+    const rowData = entityActionDataRecord(resolved.data);
+    const refType = entityActionRefType(resolved);
+    const refId = entityActionRefId(resolved, rowData);
+    if (!refType || refId == null) {
+        return null;
+    }
+    return { refType, refId, rowData, options, resolved };
+}
+/**
+ * Bulk entity/plugin ref (`refType` + row ids) from flat command input.
+ */
+function resolveEntityActionBulkRef(input) {
+    var _a;
+    const resolved = resolveEntityActionCommandInput(input);
+    const options = (_a = resolved.options) !== null && _a !== void 0 ? _a : {};
+    const rows = entityActionDataRows(resolved.data);
+    const refType = entityActionRefType(resolved);
+    const ids = rows
+        .map((row) => row['id'])
+        .filter((id) => id != null && id !== '')
+        .map(String);
+    if (!refType || ids.length === 0) {
+        return null;
+    }
+    return { refType, ids, rows, options, resolved };
+}
+/**
+ * Picks a field from root input, falling back to `options[field]`.
+ * Useful for commands that accept both root and options-nested shapes.
+ */
+function pickInputOrOptionsField(input, field) {
+    if (!isPlainObject(input)) {
+        return undefined;
+    }
+    const rootValue = input[field];
+    if (rootValue !== undefined) {
+        return rootValue;
+    }
+    const options = input['options'];
+    if (!isPlainObject(options)) {
+        return undefined;
+    }
+    return options[field];
+}
+/**
+ * Merges related-list / create seed payload:
+ * `hostContext` → `data` → `options.process.data` (later wins).
+ */
+function mergeEntityActionProcessData(input) {
+    var _a, _b, _c, _d;
+    const resolved = resolveEntityActionCommandInput(input);
+    const hostContext = (_a = asDataRecord(resolved.hostContext)) !== null && _a !== void 0 ? _a : {};
+    const data = (_b = asDataRecord(resolved.data)) !== null && _b !== void 0 ? _b : {};
+    const process = isPlainObject((_c = resolved.options) === null || _c === void 0 ? void 0 : _c['process'])
+        ? resolved.options['process']
+        : undefined;
+    const processData = (_d = asDataRecord(process === null || process === void 0 ? void 0 : process['data'])) !== null && _d !== void 0 ? _d : {};
+    return Object.assign(Object.assign(Object.assign({}, hostContext), data), processData);
+}
+/**
+ * Hard-strips unknown envelope keys before remote transport so the HTTP body
+ * is business input only. Does not merge or read nested payload from those keys.
+ *
+ * Nest/express JSON body parsing (strict) accepts only objects and arrays.
+ * Entity `byKey` / GetOne often pass a bare id string — wrap as `{ id }` so the
+ * request is valid JSON over HTTP (handlers already accept both shapes).
+ */
+function normalizeCommandInputForRemote(input) {
+    if (input == null) {
+        return {};
+    }
+    if (Array.isArray(input)) {
+        return input;
+    }
+    if (!isPlainObject(input)) {
+        if (typeof input === 'string' || typeof input === 'number' || typeof input === 'boolean') {
+            return { id: input };
+        }
+        return {};
+    }
+    if (!('__context__' in input) && !('__metadata__' in input)) {
+        return input;
+    }
+    const root = Object.assign({}, input);
+    delete root['__context__'];
+    delete root['__metadata__'];
+    return root;
+}
+//#endregion
+//# sourceMappingURL=entity-action-command-input.js.map

package/runtime/src/lib/commands/entity-action-command-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-action-command-input.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/commands/entity-action-command-input.ts"],"names":[],"mappings":"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"}