@acorex-platform/framework-shared 0.0.15 → 0.0.20

package/runtime/src/lib/index.d.ts

@@ -1,23 +1,43 @@
 export * from './shared/catalog-definition-base.types';
 export * from './shared/catalog-definition.categories';
-export * from './commands/command.interface';
-export * from './commands/command-definition.types';
+export * from './commands/auth-command-keys';
+export * from './commands/bulk-command-failure.util';
+export * from './commands/bulk-command.types';
+export * from './commands/catalog-command-definition';
 export * from './commands/command-definition.categories';
+export * from './commands/command-definition.types';
+export * from './commands/command.interface';
+export * from './commands/command-execute-options.types';
+export * from './commands/command.middleware';
 export * from './commands/define-command';
-export * from './commands/catalog-command-definition';
+export * from './commands/entity-action-command-input';
 export * from './commands/entity-command-keys';
-export * from './queries/query.interface';
-export * from './queries/query-definition.types';
-export * from './queries/query-definition.categories';
-export * from './queries/define-query';
+export * from './commands/file-command-keys';
+export * from './commands/lock-command-keys';
+export * from './commands/presence-command-keys';
+export * from './commands/workflow-command-keys';
+export * from './queries/domain-query-keys';
+export * from './queries/presence-query-keys';
 export * from './queries/catalog-query-definition';
+export * from './queries/define-query';
+export * from './queries/query-capability.types';
+export * from './queries/query-definition.categories';
+export * from './queries/query-definition.types';
+export * from './queries/query-input.packs';
+export * from './queries/query-kind.types';
+export * from './queries/query-execute-options.types';
+export * from './queries/query.middleware';
+export * from './queries/query.interface';
 export * from './views/view.interface';
-export * from './widgets/widget-definition.types';
-export * from './widgets/widget-definition.categories';
-export * from './widgets/define-widget';
 export * from './widgets/catalog-widget-definition';
-export * from './plugins/entity-plugin-definition.types';
-export * from './plugins/entity-plugin-definition.categories';
-export * from './plugins/define-entity-plugin';
+export * from './widgets/define-widget';
+export * from './widgets/get-widgets-for-ai-agent-scope.util';
+export * from './widgets/widget-definition.categories';
+export * from './widgets/widget-definition.types';
 export * from './plugins/catalog-entity-plugin-definition';
+export * from './plugins/define-entity-plugin';
+export * from './plugins/entity-plugin-definition.categories';
+export * from './plugins/entity-plugin-definition.types';
+export * from './transports/runtime-invoke-url.util';
+export * from './transports/runtime-transport.keys';
 //# sourceMappingURL=index.d.ts.map

package/runtime/src/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../libs/framework/shared/runtime/src/lib/index.ts"],"names":[],"mappings":"AAEA,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AAEvD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qCAAqC,CAAC;AACpD,cAAc,0CAA0C,CAAC;AACzD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uCAAuC,CAAC;AACtD,cAAc,gCAAgC,CAAC;AAE/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kCAAkC,CAAC;AACjD,cAAc,uCAAuC,CAAC;AACtD,cAAc,wBAAwB,CAAC;AACvC,cAAc,oCAAoC,CAAC;AAEnD,cAAc,wBAAwB,CAAC;AAEvC,cAAc,mCAAmC,CAAC;AAClD,cAAc,wCAAwC,CAAC;AACvD,cAAc,yBAAyB,CAAC;AACxC,cAAc,qCAAqC,CAAC;AAGpD,cAAc,0CAA0C,CAAC;AACzD,cAAc,+CAA+C,CAAC;AAC9D,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4CAA4C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../libs/framework/shared/runtime/src/lib/index.ts"],"names":[],"mappings":"AAEA,cAAc,wCAAwC,CAAC;AACvD,cAAc,wCAAwC,CAAC;AAEvD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sCAAsC,CAAC;AACrD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uCAAuC,CAAC;AACtD,cAAc,0CAA0C,CAAC;AACzD,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0CAA0C,CAAC;AACzD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wCAAwC,CAAC;AACvD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AAEjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAE9C,cAAc,oCAAoC,CAAC;AACnD,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC;AACjD,cAAc,uCAAuC,CAAC;AACtD,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uCAAuC,CAAC;AACtD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAE1C,cAAc,wBAAwB,CAAC;AAEvC,cAAc,qCAAqC,CAAC;AACpD,cAAc,yBAAyB,CAAC;AACxC,cAAc,+CAA+C,CAAC;AAC9D,cAAc,wCAAwC,CAAC;AACvD,cAAc,mCAAmC,CAAC;AAElD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,gCAAgC,CAAC;AAC/C,cAAc,+CAA+C,CAAC;AAC9D,cAAc,0CAA0C,CAAC;AAEzD,cAAc,sCAAsC,CAAC;AACrD,cAAc,qCAAqC,CAAC"}

package/runtime/src/lib/index.js

@@ -4,25 +4,45 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./shared/catalog-definition-base.types"), exports);
 tslib_1.__exportStar(require("./shared/catalog-definition.categories"), exports);
-tslib_1.__exportStar(require("./commands/command.interface"), exports);
-tslib_1.__exportStar(require("./commands/command-definition.types"), exports);
+tslib_1.__exportStar(require("./commands/auth-command-keys"), exports);
+tslib_1.__exportStar(require("./commands/bulk-command-failure.util"), exports);
+tslib_1.__exportStar(require("./commands/bulk-command.types"), exports);
+tslib_1.__exportStar(require("./commands/catalog-command-definition"), exports);
 tslib_1.__exportStar(require("./commands/command-definition.categories"), exports);
+tslib_1.__exportStar(require("./commands/command-definition.types"), exports);
+tslib_1.__exportStar(require("./commands/command.interface"), exports);
+tslib_1.__exportStar(require("./commands/command-execute-options.types"), exports);
+tslib_1.__exportStar(require("./commands/command.middleware"), exports);
 tslib_1.__exportStar(require("./commands/define-command"), exports);
-tslib_1.__exportStar(require("./commands/catalog-command-definition"), exports);
+tslib_1.__exportStar(require("./commands/entity-action-command-input"), exports);
 tslib_1.__exportStar(require("./commands/entity-command-keys"), exports);
-tslib_1.__exportStar(require("./queries/query.interface"), exports);
-tslib_1.__exportStar(require("./queries/query-definition.types"), exports);
-tslib_1.__exportStar(require("./queries/query-definition.categories"), exports);
-tslib_1.__exportStar(require("./queries/define-query"), exports);
+tslib_1.__exportStar(require("./commands/file-command-keys"), exports);
+tslib_1.__exportStar(require("./commands/lock-command-keys"), exports);
+tslib_1.__exportStar(require("./commands/presence-command-keys"), exports);
+tslib_1.__exportStar(require("./commands/workflow-command-keys"), exports);
+tslib_1.__exportStar(require("./queries/domain-query-keys"), exports);
+tslib_1.__exportStar(require("./queries/presence-query-keys"), exports);
 tslib_1.__exportStar(require("./queries/catalog-query-definition"), exports);
+tslib_1.__exportStar(require("./queries/define-query"), exports);
+tslib_1.__exportStar(require("./queries/query-capability.types"), exports);
+tslib_1.__exportStar(require("./queries/query-definition.categories"), exports);
+tslib_1.__exportStar(require("./queries/query-definition.types"), exports);
+tslib_1.__exportStar(require("./queries/query-input.packs"), exports);
+tslib_1.__exportStar(require("./queries/query-kind.types"), exports);
+tslib_1.__exportStar(require("./queries/query-execute-options.types"), exports);
+tslib_1.__exportStar(require("./queries/query.middleware"), exports);
+tslib_1.__exportStar(require("./queries/query.interface"), exports);
 tslib_1.__exportStar(require("./views/view.interface"), exports);
-tslib_1.__exportStar(require("./widgets/widget-definition.types"), exports);
-tslib_1.__exportStar(require("./widgets/widget-definition.categories"), exports);
-tslib_1.__exportStar(require("./widgets/define-widget"), exports);
 tslib_1.__exportStar(require("./widgets/catalog-widget-definition"), exports);
-tslib_1.__exportStar(require("./plugins/entity-plugin-definition.types"), exports);
-tslib_1.__exportStar(require("./plugins/entity-plugin-definition.categories"), exports);
-tslib_1.__exportStar(require("./plugins/define-entity-plugin"), exports);
+tslib_1.__exportStar(require("./widgets/define-widget"), exports);
+tslib_1.__exportStar(require("./widgets/get-widgets-for-ai-agent-scope.util"), exports);
+tslib_1.__exportStar(require("./widgets/widget-definition.categories"), exports);
+tslib_1.__exportStar(require("./widgets/widget-definition.types"), exports);
 tslib_1.__exportStar(require("./plugins/catalog-entity-plugin-definition"), exports);
+tslib_1.__exportStar(require("./plugins/define-entity-plugin"), exports);
+tslib_1.__exportStar(require("./plugins/entity-plugin-definition.categories"), exports);
+tslib_1.__exportStar(require("./plugins/entity-plugin-definition.types"), exports);
+tslib_1.__exportStar(require("./transports/runtime-invoke-url.util"), exports);
+tslib_1.__exportStar(require("./transports/runtime-transport.keys"), exports);
 //#endregion
 //# sourceMappingURL=index.js.map

package/runtime/src/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../libs/framework/shared/runtime/src/lib/index.ts"],"names":[],"mappings":";AAAA,qCAAqC;;;AAErC,iFAAuD;AACvD,iFAAuD;AAEvD,uEAA6C;AAC7C,8EAAoD;AACpD,mFAAyD;AACzD,oEAA0C;AAC1C,gFAAsD;AACtD,yEAA+C;AAE/C,oEAA0C;AAC1C,2EAAiD;AACjD,gFAAsD;AACtD,iEAAuC;AACvC,6EAAmD;AAEnD,iEAAuC;AAEvC,4EAAkD;AAClD,iFAAuD;AACvD,kEAAwC;AACxC,8EAAoD;AAGpD,mFAAyD;AACzD,wFAA8D;AAC9D,yEAA+C;AAC/C,qFAA2D;AAE3D,YAAY"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../libs/framework/shared/runtime/src/lib/index.ts"],"names":[],"mappings":";AAAA,qCAAqC;;;AAErC,iFAAuD;AACvD,iFAAuD;AAEvD,uEAA6C;AAC7C,+EAAqD;AACrD,wEAA8C;AAC9C,gFAAsD;AACtD,mFAAyD;AACzD,8EAAoD;AACpD,uEAA6C;AAC7C,mFAAyD;AACzD,wEAA8C;AAC9C,oEAA0C;AAC1C,iFAAuD;AACvD,yEAA+C;AAC/C,uEAA6C;AAC7C,uEAA6C;AAC7C,2EAAiD;AACjD,2EAAiD;AAEjD,sEAA4C;AAC5C,wEAA8C;AAE9C,6EAAmD;AACnD,iEAAuC;AACvC,2EAAiD;AACjD,gFAAsD;AACtD,2EAAiD;AACjD,sEAA4C;AAC5C,qEAA2C;AAC3C,gFAAsD;AACtD,qEAA2C;AAC3C,oEAA0C;AAE1C,iEAAuC;AAEvC,8EAAoD;AACpD,kEAAwC;AACxC,wFAA8D;AAC9D,iFAAuD;AACvD,4EAAkD;AAElD,qFAA2D;AAC3D,yEAA+C;AAC/C,wFAA8D;AAC9D,mFAAyD;AAEzD,+EAAqD;AACrD,8EAAoD;AAEpD,YAAY"}

package/runtime/src/lib/queries/define-query.d.ts

@@ -1,6 +1,22 @@
+import type { AXPCatalogSchemaPropertyDefinition } from '../shared/catalog-definition-base.types';
+import type { AXPQueryArgsSection, AXPQueryFilterSection, AXPQueryPagingSection, AXPQuerySortSection } from './query-capability.types';
 import type { AXPQueryMetadataDefinition } from './query-definition.types';
+export type AXPAlignedQueryMetadataDefinition = Omit<AXPQueryMetadataDefinition, 'args' | 'filter' | 'sort' | 'paging' | 'columns' | 'inputs' | 'outputs'> & {
+    args: AXPQueryArgsSection;
+    filter: AXPQueryFilterSection;
+    sort: AXPQuerySortSection;
+    paging: AXPQueryPagingSection;
+    columns?: AXPCatalogSchemaPropertyDefinition[];
+};
 /**
- * Typed identity helper for query metadata sidecars.
+ * Prepares query metadata for catalog JSON / DB seed.
+ * Produces explicit `{ enabled, definition }` sections for args / filter / sort / paging.
+ * Does not emit flattened legacy `inputs` / `outputs` — catalog uses capability sections + `columns`.
  */
-export declare function defineQuery<T extends AXPQueryMetadataDefinition>(definition: T): T;
+export declare function alignQueryDefinitionForCatalog(definition: AXPQueryMetadataDefinition): AXPAlignedQueryMetadataDefinition;
+/**
+ * Typed helper for query metadata sidecars.
+ * Asserts collection-only fields and aligns catalog capability sections before DB seed/catalog gen.
+ */
+export declare function defineQuery<T extends AXPQueryMetadataDefinition>(definition: T): AXPAlignedQueryMetadataDefinition;
 //# sourceMappingURL=define-query.d.ts.map

package/runtime/src/lib/queries/define-query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define-query.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/queries/define-query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAI3E;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,0BAA0B,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,CAElF"}
+{"version":3,"file":"define-query.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/queries/define-query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,yCAAyC,CAAC;AAClG,OAAO,KAAK,EACV,mBAAmB,EAInB,qBAAqB,EAErB,qBAAqB,EAErB,mBAAmB,EACpB,MAAM,0BAA0B,CAAC;AAIlC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAwH3E,MAAM,MAAM,iCAAiC,GAAG,IAAI,CAClD,0BAA0B,EAC1B,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CACzE,GAAG;IACF,IAAI,EAAE,mBAAmB,CAAC;IAC1B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,OAAO,CAAC,EAAE,kCAAkC,EAAE,CAAC;CAChD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,0BAA0B,GACrC,iCAAiC,CAuCnC;AAMD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,0BAA0B,EAC9D,UAAU,EAAE,CAAC,GACZ,iCAAiC,CAenC"}

package/runtime/src/lib/queries/define-query.js

@@ -1,12 +1,150 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.alignQueryDefinitionForCatalog = alignQueryDefinitionForCatalog;
 exports.defineQuery = defineQuery;
+const tslib_1 = require("tslib");
+const query_capability_types_1 = require("./query-capability.types");
+//#region ---- Section normalize ----
+function isCapabilitySection(value) {
+    return (value != null &&
+        typeof value === 'object' &&
+        !Array.isArray(value) &&
+        typeof value.enabled === 'boolean');
+}
+function normalizeListSection(input, mapItem) {
+    var _a;
+    if (input == null) {
+        return { enabled: false };
+    }
+    if (isCapabilitySection(input)) {
+        if (!input.enabled) {
+            return { enabled: false };
+        }
+        const definition = ((_a = input.definition) !== null && _a !== void 0 ? _a : []).map((item) => (mapItem ? mapItem(item) : item));
+        if (definition.length === 0) {
+            return { enabled: false };
+        }
+        return { enabled: true, definition };
+    }
+    if (Array.isArray(input)) {
+        if (input.length === 0) {
+            return { enabled: false };
+        }
+        const definition = mapItem ? input.map(mapItem) : [...input];
+        return { enabled: true, definition };
+    }
+    return { enabled: false };
+}
+function normalizePagingSection(input) {
+    var _a;
+    if (input == null) {
+        return { enabled: false };
+    }
+    if (isCapabilitySection(input)) {
+        if (!input.enabled) {
+            return { enabled: false };
+        }
+        return {
+            enabled: true,
+            definition: Object.assign(Object.assign({}, query_capability_types_1.AXP_QUERY_DEFAULT_COLLECTION_PAGING), ((_a = input.definition) !== null && _a !== void 0 ? _a : {})),
+        };
+    }
+    if (typeof input === 'object') {
+        return {
+            enabled: true,
+            definition: Object.assign(Object.assign({}, query_capability_types_1.AXP_QUERY_DEFAULT_COLLECTION_PAGING), input),
+        };
+    }
+    return { enabled: false };
+}
+function normalizeFilterItem(item) {
+    var _a, _b;
+    const source = (_a = item.source) !== null && _a !== void 0 ? _a : (item.field != null ? 'field' : 'custom');
+    return Object.assign(Object.assign(Object.assign({}, item), { source }), (source === 'field' ? { field: (_b = item.field) !== null && _b !== void 0 ? _b : item.name } : {}));
+}
+function normalizeSortItem(item) {
+    var _a, _b, _c;
+    const source = (_a = item.source) !== null && _a !== void 0 ? _a : (item.field != null ? 'field' : 'field');
+    return Object.assign(Object.assign({}, item), { source, field: (_b = item.field) !== null && _b !== void 0 ? _b : item.name, directions: ((_c = item.directions) === null || _c === void 0 ? void 0 : _c.length) ? item.directions : ['asc', 'desc'] });
+}
+//#endregion
+//#region ---- Legacy bridge ----
+const PAGING_INPUT_NAMES = new Set(['skip', 'take']);
+/**
+ * Prefer `args` / `columns`. When only legacy `inputs` / `outputs` exist, map them so catalog JSON
+ * still gets explicit capability sections.
+ */
+function bridgeLegacyInputs(definition) {
+    var _a;
+    if (definition.args != null) {
+        return { argsInput: definition.args };
+    }
+    const inputs = (_a = definition.inputs) !== null && _a !== void 0 ? _a : [];
+    if (inputs.length === 0) {
+        return { argsInput: undefined };
+    }
+    const argsOnly = inputs.filter((row) => !PAGING_INPUT_NAMES.has(row.name));
+    return {
+        argsInput: argsOnly.length > 0 ? argsOnly : undefined,
+    };
+}
+function bridgeLegacyColumns(definition) {
+    if (definition.columns != null) {
+        return definition.columns;
+    }
+    return definition.outputs;
+}
+/**
+ * Prepares query metadata for catalog JSON / DB seed.
+ * Produces explicit `{ enabled, definition }` sections for args / filter / sort / paging.
+ * Does not emit flattened legacy `inputs` / `outputs` — catalog uses capability sections + `columns`.
+ */
+function alignQueryDefinitionForCatalog(definition) {
+    const { argsInput } = bridgeLegacyInputs(definition);
+    const args = normalizeListSection(argsInput);
+    const filter = normalizeListSection(definition.filter, normalizeFilterItem);
+    const sort = normalizeListSection(definition.sort, normalizeSortItem);
+    let paging = normalizePagingSection(definition.paging);
+    // Collection defaults to paging unless the sidecar set `paging` explicitly (including `{ enabled: false }`).
+    if (definition.kind === 'collection' && definition.paging == null) {
+        paging = {
+            enabled: true,
+            definition: Object.assign({}, query_capability_types_1.AXP_QUERY_DEFAULT_COLLECTION_PAGING),
+        };
+    }
+    // Reject declaring skip/take as args when collection paging is system-managed.
+    if (definition.kind === 'collection' && args.enabled) {
+        const conflict = args.definition.find((row) => PAGING_INPUT_NAMES.has(row.name));
+        if (conflict) {
+            throw new Error(`defineQuery(${definition.key}): do not declare arg "${conflict.name}" — ` +
+                `skip/take belong to paging when kind is 'collection'`);
+        }
+    }
+    const columns = bridgeLegacyColumns(definition);
+    // Drop legacy flat fields from the aligned catalog payload.
+    const { inputs: _legacyInputs, outputs: _legacyOutputs } = definition, rest = tslib_1.__rest(definition, ["inputs", "outputs"]);
+    return Object.assign(Object.assign({}, rest), { args,
+        filter,
+        sort,
+        paging,
+        columns });
+}
+//#endregion
 //#region ---- defineQuery ----
 /**
- * Typed identity helper for query metadata sidecars.
+ * Typed helper for query metadata sidecars.
+ * Asserts collection-only fields and aligns catalog capability sections before DB seed/catalog gen.
  */
 function defineQuery(definition) {
-    return definition;
+    if (definition.kind != null && definition.kind !== 'collection') {
+        if (definition.binding != null) {
+            throw new Error(`defineQuery(${definition.key}): binding is only allowed when kind is 'collection'`);
+        }
+        if (definition.byKeyQuery != null) {
+            throw new Error(`defineQuery(${definition.key}): byKeyQuery is only allowed when kind is 'collection'`);
+        }
+    }
+    return alignQueryDefinitionForCatalog(definition);
 }
 //#endregion
 //# sourceMappingURL=define-query.js.map

package/runtime/src/lib/queries/define-query.js.map

@@ -1 +1 @@
-{"version":3,"file":"define-query.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/queries/define-query.ts"],"names":[],"mappings":";;AAOA,kCAEC;AAPD,+BAA+B;AAE/B;;GAEG;AACH,SAAgB,WAAW,CAAuC,UAAa;IAC7E,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,YAAY"}
+{"version":3,"file":"define-query.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/queries/define-query.ts"],"names":[],"mappings":"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"}

package/runtime/src/lib/queries/domain-query-keys.d.ts

@@ -0,0 +1,15 @@
+export declare const DOMAIN_GET_ENTITY_LAYOUT_DEFAULT: "Domain:GetEntityLayout";
+export interface DomainGetEntityLayoutInput {
+    module: string;
+    entity: string;
+}
+export declare const DOMAIN_LIST_ENTITY_LAYOUTS_DEFAULT: "Domain:ListEntityLayouts";
+export interface DomainListEntityLayoutsInput {
+    /** When set, only entities for this module are returned. */
+    module?: string;
+}
+export interface DomainEntityLayoutListItem {
+    module: string;
+    entity: string;
+}
+//# sourceMappingURL=domain-query-keys.d.ts.map

package/runtime/src/lib/queries/domain-query-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-query-keys.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/queries/domain-query-keys.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gCAAgC,EAAG,wBAAiC,CAAC;AAElF,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,kCAAkC,EAAG,0BAAmC,CAAC;AAEtF,MAAM,WAAW,4BAA4B;IAC3C,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/runtime/src/lib/queries/domain-query-keys.js

@@ -0,0 +1,8 @@
+"use strict";
+//#region ---- Domain query keys ----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DOMAIN_LIST_ENTITY_LAYOUTS_DEFAULT = exports.DOMAIN_GET_ENTITY_LAYOUT_DEFAULT = void 0;
+exports.DOMAIN_GET_ENTITY_LAYOUT_DEFAULT = 'Domain:GetEntityLayout';
+exports.DOMAIN_LIST_ENTITY_LAYOUTS_DEFAULT = 'Domain:ListEntityLayouts';
+//#endregion
+//# sourceMappingURL=domain-query-keys.js.map

package/runtime/src/lib/queries/domain-query-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-query-keys.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/queries/domain-query-keys.ts"],"names":[],"mappings":";AAAA,qCAAqC;;;AAExB,QAAA,gCAAgC,GAAG,wBAAiC,CAAC;AAOrE,QAAA,kCAAkC,GAAG,0BAAmC,CAAC;AAYtF,YAAY"}

package/runtime/src/lib/queries/presence-query-keys.d.ts

@@ -0,0 +1,3 @@
+export declare const PRESENCE_USER_ACTIVITY: "Presence:UserActivity";
+export declare const PRESENCE_TENANT_ACTIVITY: "Presence:TenantActivity";
+//# sourceMappingURL=presence-query-keys.d.ts.map

package/runtime/src/lib/queries/presence-query-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence-query-keys.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/queries/presence-query-keys.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,sBAAsB,EAAG,uBAAgC,CAAC;AACvE,eAAO,MAAM,wBAAwB,EAAG,yBAAkC,CAAC"}

package/runtime/src/lib/queries/presence-query-keys.js

@@ -0,0 +1,8 @@
+"use strict";
+//#region ----- Presence query keys -----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PRESENCE_TENANT_ACTIVITY = exports.PRESENCE_USER_ACTIVITY = void 0;
+exports.PRESENCE_USER_ACTIVITY = 'Presence:UserActivity';
+exports.PRESENCE_TENANT_ACTIVITY = 'Presence:TenantActivity';
+//#endregion
+//# sourceMappingURL=presence-query-keys.js.map

package/runtime/src/lib/queries/presence-query-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence-query-keys.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/queries/presence-query-keys.ts"],"names":[],"mappings":";AAAA,yCAAyC;;;AAE5B,QAAA,sBAAsB,GAAG,uBAAgC,CAAC;AAC1D,QAAA,wBAAwB,GAAG,yBAAkC,CAAC;AAE3E,YAAY"}

package/runtime/src/lib/queries/query-capability.types.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Query catalog capability sections for AI / report / DB seed.
+ * Catalog JSON uses explicit `{ enabled, definition }` (never infer support from absent lists).
+ */
+import type { AXPCatalogSchemaPropertyDefinition } from '../shared/catalog-definition-base.types';
+/**
+ * One request axis (args / filter / sort / paging).
+ * If `enabled` is false, callers and AI must not send that axis.
+ */
+export type AXPQueryCapabilitySection<TDefinition> = {
+    enabled: false;
+    definition?: undefined;
+} | {
+    enabled: true;
+    definition: TDefinition;
+};
+/**
+ * Authoring shorthand before {@link alignQueryDefinitionForCatalog}:
+ * - omit / undefined → `{ enabled: false }`
+ * - array (or paging object) → `{ enabled: true, definition }`
+ * - full section → kept (validated)
+ */
+export type AXPQueryCapabilitySectionInput<TDefinition> = TDefinition | AXPQueryCapabilitySection<TDefinition> | undefined;
+/** Named contract parameter (not a dynamic filter clause). */
+export type AXPQueryArgDefinition = AXPCatalogSchemaPropertyDefinition;
+export type AXPQueryArgsSection = AXPQueryCapabilitySection<AXPQueryArgDefinition[]>;
+export type AXPQueryArgsSectionInput = AXPQueryCapabilitySectionInput<AXPQueryArgDefinition[]>;
+/**
+ * Filter descriptor.
+ * - `source: 'field'` — bound to a result/column field
+ * - `source: 'custom'` — semantic / virtual (e.g. near|expired|both)
+ */
+export interface AXPQueryFilterDefinition extends AXPCatalogSchemaPropertyDefinition {
+    source?: 'field' | 'custom';
+    /** When `source` is `field`, the column/field name (defaults to `name`). */
+    field?: string;
+}
+export type AXPQueryFilterSection = AXPQueryCapabilitySection<AXPQueryFilterDefinition[]>;
+export type AXPQueryFilterSectionInput = AXPQueryCapabilitySectionInput<AXPQueryFilterDefinition[]>;
+/** Sortable key; may reference a non-visible / non-column field. */
+export interface AXPQuerySortDefinition {
+    name: string;
+    title?: string;
+    description?: string;
+    source?: 'field' | 'custom';
+    /** Sort field path when different from `name`. */
+    field?: string;
+    directions?: Array<'asc' | 'desc'>;
+}
+export type AXPQuerySortSection = AXPQueryCapabilitySection<AXPQuerySortDefinition[]>;
+export type AXPQuerySortSectionInput = AXPQueryCapabilitySectionInput<AXPQuerySortDefinition[]>;
+export interface AXPQueryPagingDefinition {
+    skip?: boolean;
+    take?: boolean;
+    /** `take: null` means fetch-all up to platform soft limit. */
+    takeNullMeansAll?: boolean;
+    /**
+     * Optional default page size for UI widgets that wrap this query as an AXDataSource
+     * (e.g. select-box). Omitted → widget / control default.
+     */
+    pageSize?: number;
+}
+export type AXPQueryPagingSection = AXPQueryCapabilitySection<AXPQueryPagingDefinition>;
+export type AXPQueryPagingSectionInput = AXPQueryCapabilitySectionInput<AXPQueryPagingDefinition>;
+/** Default collection paging contract injected by align. */
+export declare const AXP_QUERY_DEFAULT_COLLECTION_PAGING: AXPQueryPagingDefinition;
+/** Collection item / object field schema (result shape, not a request capability). */
+export type AXPQueryColumnDefinition = AXPCatalogSchemaPropertyDefinition;
+/** Builtin scalar result for `kind: 'value'`. */
+export type AXPQueryValueType = 'string' | 'number' | 'boolean' | 'date' | 'datetime' | 'json';
+//# sourceMappingURL=query-capability.types.d.ts.map

package/runtime/src/lib/queries/query-capability.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-capability.types.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/queries/query-capability.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,yCAAyC,CAAC;AAIlG;;;GAGG;AACH,MAAM,MAAM,yBAAyB,CAAC,WAAW,IAC7C;IACE,OAAO,EAAE,KAAK,CAAC;IACf,UAAU,CAAC,EAAE,SAAS,CAAC;CACxB,GACD;IACE,OAAO,EAAE,IAAI,CAAC;IACd,UAAU,EAAE,WAAW,CAAC;CACzB,CAAC;AAEN;;;;;GAKG;AACH,MAAM,MAAM,8BAA8B,CAAC,WAAW,IAClD,WAAW,GACX,yBAAyB,CAAC,WAAW,CAAC,GACtC,SAAS,CAAC;AAMd,8DAA8D;AAC9D,MAAM,MAAM,qBAAqB,GAAG,kCAAkC,CAAC;AAEvE,MAAM,MAAM,mBAAmB,GAAG,yBAAyB,CAAC,qBAAqB,EAAE,CAAC,CAAC;AACrF,MAAM,MAAM,wBAAwB,GAAG,8BAA8B,CAAC,qBAAqB,EAAE,CAAC,CAAC;AAM/F;;;;GAIG;AACH,MAAM,WAAW,wBAAyB,SAAQ,kCAAkC;IAClF,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC5B,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,qBAAqB,GAAG,yBAAyB,CAAC,wBAAwB,EAAE,CAAC,CAAC;AAC1F,MAAM,MAAM,0BAA0B,GAAG,8BAA8B,CAAC,wBAAwB,EAAE,CAAC,CAAC;AAMpG,oEAAoE;AACpE,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC5B,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC;CACpC;AAED,MAAM,MAAM,mBAAmB,GAAG,yBAAyB,CAAC,sBAAsB,EAAE,CAAC,CAAC;AACtF,MAAM,MAAM,wBAAwB,GAAG,8BAA8B,CAAC,sBAAsB,EAAE,CAAC,CAAC;AAMhG,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,qBAAqB,GAAG,yBAAyB,CAAC,wBAAwB,CAAC,CAAC;AACxF,MAAM,MAAM,0BAA0B,GAAG,8BAA8B,CAAC,wBAAwB,CAAC,CAAC;AAElG,4DAA4D;AAC5D,eAAO,MAAM,mCAAmC,EAAE,wBAIjD,CAAC;AAMF,sFAAsF;AACtF,MAAM,MAAM,wBAAwB,GAAG,kCAAkC,CAAC;AAE1E,iDAAiD;AACjD,MAAM,MAAM,iBAAiB,GACzB,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,MAAM,GACN,UAAU,GACV,MAAM,CAAC"}

package/runtime/src/lib/queries/query-capability.types.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * Query catalog capability sections for AI / report / DB seed.
+ * Catalog JSON uses explicit `{ enabled, definition }` (never infer support from absent lists).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AXP_QUERY_DEFAULT_COLLECTION_PAGING = void 0;
+/** Default collection paging contract injected by align. */
+exports.AXP_QUERY_DEFAULT_COLLECTION_PAGING = {
+    skip: true,
+    take: true,
+    takeNullMeansAll: true,
+};
+//#endregion
+//# sourceMappingURL=query-capability.types.js.map

package/runtime/src/lib/queries/query-capability.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-capability.types.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/queries/query-capability.types.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAgGH,4DAA4D;AAC/C,QAAA,mCAAmC,GAA6B;IAC3E,IAAI,EAAE,IAAI;IACV,IAAI,EAAE,IAAI;IACV,gBAAgB,EAAE,IAAI;CACvB,CAAC;AAkBF,YAAY"}

package/runtime/src/lib/queries/query-definition.types.d.ts

@@ -1,14 +1,61 @@
 /**
  * Build-time query metadata for AXPQuery implementations.
  * Mirrors command metadata shape except there are no `outcomes` (queries only `fetch`).
- * Shares {@link AXPCatalogMetadataDefinitionBase} with commands and widgets; `inputs` / `outputs` live on the base.
+ * Shares {@link AXPCatalogMetadataDefinitionBase} with commands and widgets.
+ * Prefer `args` / `filter` / `sort` / `paging` / `columns`. Legacy `inputs` / `outputs` are
+ * accepted only as an inbound bridge for older sidecars and are stripped from catalog output.
  */
 import type { AXPCatalogExecutionMode, AXPCatalogMetadataDefinitionBase, AXPCatalogSchemaPropertyDefinition } from '../shared/catalog-definition-base.types';
+import type { AXPQueryArgsSectionInput, AXPQueryColumnDefinition, AXPQueryFilterSectionInput, AXPQueryPagingSectionInput, AXPQuerySortSectionInput, AXPQueryValueType } from './query-capability.types';
+import type { AXPQueryCollectionBinding, AXPQueryKind } from './query-kind.types';
 /** One input/output property description for query definitions (same as command / widget catalog rows). */
 export type AXPQuerySchemaPropertyDefinition = AXPCatalogSchemaPropertyDefinition;
 export interface AXPQueryMetadataDefinition extends AXPCatalogMetadataDefinitionBase {
     /** Runtime registration key (provideQuerySetups). */
     key: string;
     executionMode: AXPCatalogExecutionMode;
+    /**
+     * Result shape — must match the success `kind` returned by `fetch`
+     * (`value` | `object` | `collection`).
+     */
+    kind?: AXPQueryKind;
+    /**
+     * Optional stable result DTO id (e.g. `AXPBarChartQueryResult`).
+     * Used by chart/KPI widget designers to filter compatible queries.
+     */
+    resultType?: string;
+    /**
+     * Select/lookup binding for `kind: 'collection'` only.
+     * Ignored for `value` / `object`.
+     */
+    binding?: AXPQueryCollectionBinding;
+    /**
+     * Runtime query key of an `object` query used to resolve one row by `binding.valueField`.
+     * Collection only.
+     */
+    byKeyQuery?: string;
+    /**
+     * Contract args (named params). Prefer over stuffing everything into `inputs`.
+     * Authoring: array shorthand or `{ enabled, definition }`.
+     */
+    args?: AXPQueryArgsSectionInput;
+    /**
+     * Dynamic filters (field-bound or custom/semantic). Omit or empty ⇒ not supported.
+     */
+    filter?: AXPQueryFilterSectionInput;
+    /**
+     * Sort keys (may include fields not shown as columns).
+     */
+    sort?: AXPQuerySortSectionInput;
+    /**
+     * Paging contract. For `kind: 'collection'`, align injects a default when omitted.
+     */
+    paging?: AXPQueryPagingSectionInput;
+    /**
+     * Result field schema for `object` / `collection` items (catalog `outputs` equivalent).
+     */
+    columns?: AXPQueryColumnDefinition[];
+    /** Scalar result type when `kind: 'value'`. */
+    valueType?: AXPQueryValueType;
 }
 //# sourceMappingURL=query-definition.types.d.ts.map

package/runtime/src/lib/queries/query-definition.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query-definition.types.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/queries/query-definition.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,uBAAuB,EACvB,gCAAgC,EAChC,kCAAkC,EACnC,MAAM,yCAAyC,CAAC;AAIjD,2GAA2G;AAC3G,MAAM,MAAM,gCAAgC,GAAG,kCAAkC,CAAC;AAElF,MAAM,WAAW,0BAA2B,SAAQ,gCAAgC;IAClF,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,uBAAuB,CAAC;CACxC"}
+{"version":3,"file":"query-definition.types.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/queries/query-definition.types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,uBAAuB,EACvB,gCAAgC,EAChC,kCAAkC,EACnC,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EACV,wBAAwB,EACxB,wBAAwB,EACxB,0BAA0B,EAC1B,0BAA0B,EAC1B,wBAAwB,EACxB,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,yBAAyB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIlF,2GAA2G;AAC3G,MAAM,MAAM,gCAAgC,GAAG,kCAAkC,CAAC;AAElF,MAAM,WAAW,0BAA2B,SAAQ,gCAAgC;IAClF,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,uBAAuB,CAAC;IACvC;;;OAGG;IACH,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,OAAO,CAAC,EAAE,yBAAyB,CAAC;IACpC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,IAAI,CAAC,EAAE,wBAAwB,CAAC;IAChC;;OAEG;IACH,MAAM,CAAC,EAAE,0BAA0B,CAAC;IACpC;;OAEG;IACH,IAAI,CAAC,EAAE,wBAAwB,CAAC;IAChC;;OAEG;IACH,MAAM,CAAC,EAAE,0BAA0B,CAAC;IACpC;;OAEG;IACH,OAAO,CAAC,EAAE,wBAAwB,EAAE,CAAC;IACrC,+CAA+C;IAC/C,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC/B"}

package/runtime/src/lib/queries/query-definition.types.js

@@ -2,7 +2,9 @@
 /**
  * Build-time query metadata for AXPQuery implementations.
  * Mirrors command metadata shape except there are no `outcomes` (queries only `fetch`).
- * Shares {@link AXPCatalogMetadataDefinitionBase} with commands and widgets; `inputs` / `outputs` live on the base.
+ * Shares {@link AXPCatalogMetadataDefinitionBase} with commands and widgets.
+ * Prefer `args` / `filter` / `sort` / `paging` / `columns`. Legacy `inputs` / `outputs` are
+ * accepted only as an inbound bridge for older sidecars and are stripped from catalog output.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 //#endregion

package/runtime/src/lib/queries/query-definition.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"query-definition.types.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/queries/query-definition.types.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAmBH,YAAY"}
+{"version":3,"file":"query-definition.types.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/queries/query-definition.types.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAwEH,YAAY"}

package/runtime/src/lib/queries/query-execute-options.types.d.ts

@@ -0,0 +1,23 @@
+/**
+ * How this execute call should use ReportManagement query snapshots.
+ * Interpreted by the server query-snapshot middleware when a policy exists.
+ *
+ * - `true` — prefer snapshot; on miss/stale, sync ensure (canonical `{}`) then return
+ * - `{ minCalculatedAt, maxAgeMs }` — same as `true`, with a freshness floor
+ * - `false` — force live handler (skip snapshot serve)
+ * - omitted — transparent: serve ready+fresh snapshot when policy exists; miss → live (no ensure)
+ */
+export type AXPQuerySnapshotOption = boolean | {
+    /** Snapshot `calculatedAt` must be at/after this epoch ms. */
+    minCalculatedAt?: number;
+    /** Max age in ms (overrides policy `staleAfterMs` for this call). */
+    maxAgeMs?: number;
+};
+/**
+ * Parent bag for query execute knobs (not business input).
+ * Extensible — add fields here instead of new positional args.
+ */
+export interface AXPQueryExecuteOptions {
+    snapshot?: AXPQuerySnapshotOption;
+}
+//# sourceMappingURL=query-execute-options.types.d.ts.map

package/runtime/src/lib/queries/query-execute-options.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-execute-options.types.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/queries/query-execute-options.types.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,MAAM,sBAAsB,GAC9B,OAAO,GACP;IACE,8DAA8D;IAC9D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEN;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,sBAAsB,CAAC;CACnC"}

package/runtime/src/lib/queries/query-execute-options.types.js

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

package/runtime/src/lib/queries/query-execute-options.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-execute-options.types.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/queries/query-execute-options.types.ts"],"names":[],"mappings":";AAAA,2CAA2C;;AA4B3C,YAAY"}