@acorex-platform/framework-shared 0.0.18 → 0.0.20

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"}

package/runtime/src/lib/queries/query-input.packs.d.ts

@@ -0,0 +1,27 @@
+import type { AXPCatalogSchemaPropertyDefinition } from '../shared/catalog-definition-base.types';
+import type { AXDataSourceFilterOption, AXDataSourceSortOption } from '@acorex-platform/framework-shared/core';
+/** Soft cap when collection `take` is `null` (fetch-all). */
+export declare const AXP_COLLECTION_QUERY_SOFT_LIMIT = 1000;
+/**
+ * Standard paging/filter inputs for `kind: 'collection'`.
+ * `take: null` means fetch-all up to {@link AXP_COLLECTION_QUERY_SOFT_LIMIT}.
+ */
+export interface AXPCollectionQueryInput {
+    skip: number;
+    take: number | null;
+    filter?: AXDataSourceFilterOption;
+    sort?: AXDataSourceSortOption[];
+}
+/** Base for `kind: 'object'` — no paging. */
+export type AXPObjectQueryInput = Record<string, unknown>;
+/** Base for `kind: 'value'` — no paging. */
+export type AXPValueQueryInput = Record<string, unknown>;
+/** Catalog property rows describing collection `skip` / `take` (for tooling that materializes paging into a flat schema). Prefer `paging` section in catalog JSON — do not put skip/take in query `args`. */
+export declare function collectionStandardInputDefs(): AXPCatalogSchemaPropertyDefinition[];
+/**
+ * Resolve effective take for a collection query.
+ * `null` / omitted → soft limit; otherwise clamps to soft limit.
+ */
+export declare function resolveCollectionTake(take: number | null | undefined, softLimit?: number): number;
+export declare function resolveCollectionSkip(skip: number | null | undefined): number;
+//# sourceMappingURL=query-input.packs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query-input.packs.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/queries/query-input.packs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,yCAAyC,CAAC;AAClG,OAAO,KAAK,EACV,wBAAwB,EACxB,sBAAsB,EACvB,MAAM,wCAAwC,CAAC;AAIhD,6DAA6D;AAC7D,eAAO,MAAM,+BAA+B,OAAO,CAAC;AAMpD;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,CAAC,EAAE,wBAAwB,CAAC;IAClC,IAAI,CAAC,EAAE,sBAAsB,EAAE,CAAC;CACjC;AAED,6CAA6C;AAC7C,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1D,4CAA4C;AAC5C,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAMzD,6MAA6M;AAC7M,wBAAgB,2BAA2B,IAAI,kCAAkC,EAAE,CAoBlF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC/B,SAAS,GAAE,MAAwC,GAClD,MAAM,CAQR;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAK7E"}

package/runtime/src/lib/queries/query-input.packs.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AXP_COLLECTION_QUERY_SOFT_LIMIT = void 0;
+exports.collectionStandardInputDefs = collectionStandardInputDefs;
+exports.resolveCollectionTake = resolveCollectionTake;
+exports.resolveCollectionSkip = resolveCollectionSkip;
+//#region ---- Constants ----
+/** Soft cap when collection `take` is `null` (fetch-all). */
+exports.AXP_COLLECTION_QUERY_SOFT_LIMIT = 1000;
+//#endregion
+//#region ---- Catalog input packs ----
+/** Catalog property rows describing collection `skip` / `take` (for tooling that materializes paging into a flat schema). Prefer `paging` section in catalog JSON — do not put skip/take in query `args`. */
+function collectionStandardInputDefs() {
+    return [
+        {
+            name: 'skip',
+            title: 'Skip',
+            description: 'Number of rows to skip (offset). Required; use 0 for the first page.',
+            defaultValue: 0,
+            interface: { name: 'number-editor' },
+            validations: [{ rule: 'required' }],
+        },
+        {
+            name: 'take',
+            title: 'Take',
+            description: 'Page size. Use null to fetch all rows up to the platform soft limit.',
+            defaultValue: 50,
+            interface: { name: 'number-editor' },
+            validations: [{ rule: 'required' }],
+        },
+    ];
+}
+/**
+ * Resolve effective take for a collection query.
+ * `null` / omitted → soft limit; otherwise clamps to soft limit.
+ */
+function resolveCollectionTake(take, softLimit = exports.AXP_COLLECTION_QUERY_SOFT_LIMIT) {
+    if (take == null) {
+        return softLimit;
+    }
+    if (!Number.isFinite(take) || take < 0) {
+        return softLimit;
+    }
+    return Math.min(take, softLimit);
+}
+function resolveCollectionSkip(skip) {
+    if (skip == null || !Number.isFinite(skip) || skip < 0) {
+        return 0;
+    }
+    return Math.floor(skip);
+}
+//#endregion
+//# sourceMappingURL=query-input.packs.js.map

package/runtime/src/lib/queries/query-input.packs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-input.packs.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/queries/query-input.packs.ts"],"names":[],"mappings":";;;AAqCA,kEAoBC;AAMD,sDAWC;AAED,sDAKC;AA3ED,6BAA6B;AAE7B,6DAA6D;AAChD,QAAA,+BAA+B,GAAG,IAAI,CAAC;AAuBpD,YAAY;AAEZ,uCAAuC;AAEvC,6MAA6M;AAC7M,SAAgB,2BAA2B;IACzC,OAAO;QACL;YACE,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,MAAM;YACb,WAAW,EAAE,sEAAsE;YACnF,YAAY,EAAE,CAAC;YACf,SAAS,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE;YACpC,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;SACpC;QACD;YACE,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,MAAM;YACb,WAAW,EACT,sEAAsE;YACxE,YAAY,EAAE,EAAE;YAChB,SAAS,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE;YACpC,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;SACpC;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAgB,qBAAqB,CACnC,IAA+B,EAC/B,YAAoB,uCAA+B;IAEnD,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;QACjB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACvC,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AACnC,CAAC;AAED,SAAgB,qBAAqB,CAAC,IAA+B;IACnE,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACvD,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,YAAY"}

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

@@ -0,0 +1,10 @@
+/**
+ * Query result / metadata kind — shared by `defineQuery` and {@link AXPRuntimeQueryResult}.
+ */
+export type AXPQueryKind = 'value' | 'object' | 'collection';
+/** Select/lookup field binding for `kind: 'collection'` queries. */
+export interface AXPQueryCollectionBinding {
+    valueField: string;
+    textField: string;
+}
+//# sourceMappingURL=query-kind.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query-kind.types.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/queries/query-kind.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,YAAY,CAAC;AAE7D,oEAAoE;AACpE,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB"}

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

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Query result / metadata kind — shared by `defineQuery` and {@link AXPRuntimeQueryResult}.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//#endregion
+//# sourceMappingURL=query-kind.types.js.map

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

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

package/runtime/src/lib/queries/query.interface.d.ts

@@ -1,4 +1,35 @@
-export interface AXPQuery<TInput = any, TResult = any> {
-    fetch(input: TInput): Promise<TResult>;
+import type { AXPRuntimeQueryCollectionResult, AXPRuntimeQueryObjectResult, AXPRuntimeQueryResult, AXPRuntimeQueryValueResult } from '@acorex-platform/framework-shared/core';
+import type { AXPCollectionQueryInput, AXPObjectQueryInput, AXPValueQueryInput } from './query-input.packs';
+/** Any-query fetch promise (when kind is not fixed at the type level). */
+export type AXPQueryFetchResultPromise<TResult = unknown> = Promise<AXPRuntimeQueryResult<TResult>>;
+export type AXPQueryValueFetchResultPromise<TResult = unknown> = Promise<AXPRuntimeQueryValueResult<TResult>>;
+export type AXPQueryObjectFetchResultPromise<TResult = unknown> = Promise<AXPRuntimeQueryObjectResult<TResult>>;
+export type AXPQueryCollectionFetchResultPromise<TItem = unknown> = Promise<AXPRuntimeQueryCollectionResult<TItem>>;
+/**
+ * Client/server query handler contract (kind not fixed).
+ * Prefer {@link AXPCollectionQuery} / {@link AXPObjectQuery} / {@link AXPValueQuery}
+ * so input + result envelope stay paired with `defineQuery.kind`.
+ */
+export interface AXPQuery<TInput = unknown, TResult = unknown> {
+    fetch(input: TInput): AXPQueryFetchResultPromise<TResult>;
+}
+/**
+ * `kind: 'collection'` — input must include paging (`skip` / `take`);
+ * success `data` is always `{ items, total, … }` ({@link AXPRuntimeCollectionData}).
+ */
+export interface AXPCollectionQuery<TInput extends AXPCollectionQueryInput = AXPCollectionQueryInput, TItem = unknown> {
+    fetch(input: TInput): AXPQueryCollectionFetchResultPromise<TItem>;
+}
+/**
+ * `kind: 'object'` — no paging; success `data` is one record.
+ */
+export interface AXPObjectQuery<TInput extends AXPObjectQueryInput = AXPObjectQueryInput, TResult = unknown> {
+    fetch(input: TInput): AXPQueryObjectFetchResultPromise<TResult>;
+}
+/**
+ * `kind: 'value'` — no paging; success `data` is a scalar / value payload.
+ */
+export interface AXPValueQuery<TInput extends AXPValueQueryInput = AXPValueQueryInput, TResult = unknown> {
+    fetch(input: TInput): AXPQueryValueFetchResultPromise<TResult>;
 }
 //# sourceMappingURL=query.interface.d.ts.map

package/runtime/src/lib/queries/query.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/queries/query.interface.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,QAAQ,CAAC,MAAM,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG;IACjD,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1C"}
+{"version":3,"file":"query.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/shared/runtime/src/lib/queries/query.interface.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,+BAA+B,EAC/B,2BAA2B,EAC3B,qBAAqB,EACrB,0BAA0B,EAC3B,MAAM,wCAAwC,CAAC;AAEhD,OAAO,KAAK,EACV,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,qBAAqB,CAAC;AAM7B,0EAA0E;AAC1E,MAAM,MAAM,0BAA0B,CAAC,OAAO,GAAG,OAAO,IACtD,OAAO,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;AAE1C,MAAM,MAAM,+BAA+B,CAAC,OAAO,GAAG,OAAO,IAC3D,OAAO,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAC,CAAC;AAE/C,MAAM,MAAM,gCAAgC,CAAC,OAAO,GAAG,OAAO,IAC5D,OAAO,CAAC,2BAA2B,CAAC,OAAO,CAAC,CAAC,CAAC;AAEhD,MAAM,MAAM,oCAAoC,CAAC,KAAK,GAAG,OAAO,IAC9D,OAAO,CAAC,+BAA+B,CAAC,KAAK,CAAC,CAAC,CAAC;AAElD;;;;GAIG;AACH,MAAM,WAAW,QAAQ,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IAC3D,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;CAC3D;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB,CACjC,MAAM,SAAS,uBAAuB,GAAG,uBAAuB,EAChE,KAAK,GAAG,OAAO;IAEf,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,oCAAoC,CAAC,KAAK,CAAC,CAAC;CACnE;AAED;;GAEG;AACH,MAAM,WAAW,cAAc,CAC7B,MAAM,SAAS,mBAAmB,GAAG,mBAAmB,EACxD,OAAO,GAAG,OAAO;IAEjB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,gCAAgC,CAAC,OAAO,CAAC,CAAC;CACjE;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAC5B,MAAM,SAAS,kBAAkB,GAAG,kBAAkB,EACtD,OAAO,GAAG,OAAO;IAEjB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,+BAA+B,CAAC,OAAO,CAAC,CAAC;CAChE"}

package/runtime/src/lib/queries/query.interface.js

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

package/runtime/src/lib/queries/query.interface.js.map

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