@acorex-platform/framework-server 0.0.10

package/jql/abstract/src/lib/entity-schema/entity-schema-naming.util.js

@@ -0,0 +1,31 @@
+"use strict";
+//#region ---- Entity schema naming ----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.entityNameToStorageName = entityNameToStorageName;
+exports.resolveEntityJqlSourceName = resolveEntityJqlSourceName;
+exports.resolveColumnName = resolveColumnName;
+/** Converts a camelCase/PascalCase segment to snake_case. */
+function toSnakeCaseSegment(value) {
+    return value
+        .replace(/([a-z0-9])([A-Z])/g, '$1_$2')
+        .replace(/[-\s]+/g, '_')
+        .toLowerCase();
+}
+/** Converts an entity name (e.g. `TaskManagement.Task`) to a physical table/collection name. */
+function entityNameToStorageName(entityName) {
+    return entityName
+        .split(/[./]/)
+        .filter((segment) => segment.length > 0)
+        .map((segment) => toSnakeCaseSegment(segment))
+        .join('_');
+}
+/** JQL source name for an entity (same as logical entity name). */
+function resolveEntityJqlSourceName(entityName) {
+    return entityName;
+}
+/** Resolves a logical column name to its physical snake_case column name. */
+function resolveColumnName(name, columnName) {
+    return columnName ?? toSnakeCaseSegment(name);
+}
+//#endregion
+//# sourceMappingURL=entity-schema-naming.util.js.map

package/jql/abstract/src/lib/entity-schema/entity-schema-naming.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-schema-naming.util.js","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/jql/abstract/src/lib/entity-schema/entity-schema-naming.util.ts"],"names":[],"mappings":";AAAA,wCAAwC;;AAWxC,0DAMC;AAGD,gEAEC;AAGD,8CAEC;AAzBD,6DAA6D;AAC7D,SAAS,kBAAkB,CAAC,KAAa;IACvC,OAAO,KAAK;SACT,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,WAAW,EAAE,CAAC;AACnB,CAAC;AAED,gGAAgG;AAChG,SAAgB,uBAAuB,CAAC,UAAkB;IACxD,OAAO,UAAU;SACd,KAAK,CAAC,MAAM,CAAC;SACb,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;SACvC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;SAC7C,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,mEAAmE;AACnE,SAAgB,0BAA0B,CAAC,UAAkB;IAC3D,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,6EAA6E;AAC7E,SAAgB,iBAAiB,CAAC,IAAY,EAAE,UAAmB;IACjE,OAAO,UAAU,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;AAChD,CAAC;AAED,YAAY"}

package/jql/abstract/src/lib/entity-schema/entity-storage-source.util.d.ts

@@ -0,0 +1,2 @@
+/** Whether a JQL source name refers to per-entity runtime storage (not domain metadata). */
+export declare function isEntityDataSource(source: string): boolean;

package/jql/abstract/src/lib/entity-schema/entity-storage-source.util.js

@@ -0,0 +1,26 @@
+"use strict";
+//#region ---- Entity storage source helpers ----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isEntityDataSource = isEntityDataSource;
+const DOMAIN_DEFINITION_SOURCES = new Set([
+    'modules',
+    'aggregates',
+    'entities',
+    'relations',
+    'schemaDefinitions',
+    'interfaces',
+    'properties',
+    'plugins',
+    'validations',
+    'menus',
+    'permissionGroups',
+    'commands',
+    'queries',
+    'widgets',
+]);
+/** Whether a JQL source name refers to per-entity runtime storage (not domain metadata). */
+function isEntityDataSource(source) {
+    return !DOMAIN_DEFINITION_SOURCES.has(source);
+}
+//#endregion
+//# sourceMappingURL=entity-storage-source.util.js.map

package/jql/abstract/src/lib/entity-schema/entity-storage-source.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-storage-source.util.js","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/jql/abstract/src/lib/entity-schema/entity-storage-source.util.ts"],"names":[],"mappings":";AAAA,iDAAiD;;AAoBjD,gDAEC;AApBD,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAC;IACxC,SAAS;IACT,YAAY;IACZ,UAAU;IACV,WAAW;IACX,mBAAmB;IACnB,YAAY;IACZ,YAAY;IACZ,SAAS;IACT,aAAa;IACb,OAAO;IACP,kBAAkB;IAClB,UAAU;IACV,SAAS;IACT,SAAS;CACV,CAAC,CAAC;AAEH,4FAA4F;AAC5F,SAAgB,kBAAkB,CAAC,MAAc;IAC/C,OAAO,CAAC,yBAAyB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAChD,CAAC;AAED,YAAY"}

package/jql/abstract/src/lib/entity-schema/jql-entity-schema-not-found.error.d.ts

@@ -0,0 +1,3 @@
+export declare class JqlEntitySchemaNotFoundError extends Error {
+    constructor(entityName: string);
+}

package/jql/abstract/src/lib/entity-schema/jql-entity-schema-not-found.error.js

@@ -0,0 +1,13 @@
+"use strict";
+//#region ---- Entity schema errors ----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JqlEntitySchemaNotFoundError = void 0;
+class JqlEntitySchemaNotFoundError extends Error {
+    constructor(entityName) {
+        super(`Entity schema is not registered for "${entityName}". Register it via domain definitions or POST /api/entity-storage/schema.`);
+        this.name = 'JqlEntitySchemaNotFoundError';
+    }
+}
+exports.JqlEntitySchemaNotFoundError = JqlEntitySchemaNotFoundError;
+//#endregion
+//# sourceMappingURL=jql-entity-schema-not-found.error.js.map

package/jql/abstract/src/lib/entity-schema/jql-entity-schema-not-found.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jql-entity-schema-not-found.error.js","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/jql/abstract/src/lib/entity-schema/jql-entity-schema-not-found.error.ts"],"names":[],"mappings":";AAAA,wCAAwC;;;AAExC,MAAa,4BAA6B,SAAQ,KAAK;IACrD,YAAY,UAAkB;QAC5B,KAAK,CACH,wCAAwC,UAAU,2EAA2E,CAC9H,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF;AAPD,oEAOC;AAED,YAAY"}

package/jql/abstract/src/lib/entity-schema/jql-entity-schema.types.d.ts

@@ -0,0 +1,35 @@
+export type JqlColumnDataType = 'text' | 'integer' | 'numeric' | 'boolean' | 'timestamptz' | 'jsonb' | 'uuid';
+export interface JqlColumnDefinition {
+    /** Logical field name used in entity documents and JQL filters. */
+    name: string;
+    /** Physical SQL/BSON column name (defaults to snake_case of {@link name}). */
+    columnName?: string;
+    dataType: JqlColumnDataType;
+    nullable?: boolean;
+    isId?: boolean;
+    isForeignKey?: boolean;
+}
+export interface JqlIndexDefinition {
+    columns: string[];
+    unique?: boolean;
+}
+/**
+ * Describes the physical storage layout for a single entity type.
+ */
+export interface JqlEntitySchema {
+    entityName: string;
+    tableName?: string;
+    collectionName?: string;
+    columns: JqlColumnDefinition[];
+    indexes?: JqlIndexDefinition[];
+    hierarchical?: boolean;
+    /** Lodash-get paths used for inline-all / quickSearch full-text queries. */
+    fullTextSearchPaths?: string[];
+}
+export type JqlSchemaMigrationStatus = 'created' | 'migrated' | 'unchanged';
+export interface JqlSchemaRegistrationResult {
+    entityName: string;
+    tableName: string;
+    columns: JqlColumnDefinition[];
+    status: JqlSchemaMigrationStatus;
+}

package/jql/abstract/src/lib/entity-schema/jql-entity-schema.types.js

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

package/jql/abstract/src/lib/entity-schema/jql-entity-schema.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jql-entity-schema.types.js","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/jql/abstract/src/lib/entity-schema/jql-entity-schema.types.ts"],"names":[],"mappings":";AAAA,uCAAuC;;AAkDvC,YAAY"}

package/jql/abstract/src/lib/entity-store/category-hierarchy-filter.util.d.ts

@@ -0,0 +1,37 @@
+import { JqlFilter } from '../jql.types';
+export interface AxpFilterLeaf {
+    field?: string;
+    operator?: {
+        type?: string;
+    };
+    value?: unknown;
+}
+export interface AxpFilterGroup {
+    logic?: string;
+    filters?: unknown[];
+}
+export interface CategoryTreeNode {
+    id: string;
+    parentId?: string | null;
+}
+export interface CategoryTreeIndex {
+    childrenByParent: Map<string, string[]>;
+}
+/**
+ * Fields where `contains` means hierarchical category membership (expand to descendants).
+ * Excludes e.g. `roleIds`, which uses array membership only.
+ */
+export declare function isCategoryContainsFieldName(field: unknown): boolean;
+export declare function isCategoryContainsLeaf(filter: unknown): boolean;
+/** Detects category hierarchy filters (contains on categoryIds or *Ids except roleIds). */
+export declare function isCategoryFilter(filter: unknown): boolean;
+/** Companion category entity name: `Module.Entity` → `Module.EntityCategory`. */
+export declare function resolveCompanionCategoryEntityName(entityName: string): string;
+export declare function buildCategoryTreeIndex(nodes: CategoryTreeNode[]): CategoryTreeIndex;
+/** Collects a category id and all descendant category ids (breadth-first). */
+export declare function collectDescendantCategoryIds(categoryId: string, tree: CategoryTreeIndex): string[];
+export declare function categoryTreeCacheKey(categoryEntityName: string): string;
+/** Rewrites AXP category `contains` leaves to `arrayOverlaps` with expanded id lists. */
+export declare function rewriteAxpCategoryHierarchyFilter(filter: unknown, expandIds: (categoryId: string) => string[]): unknown;
+/** Rewrites JQL `contains` category leaves to `arrayOverlaps`. */
+export declare function rewriteJqlCategoryHierarchyFilter(filter: JqlFilter | undefined, expandIds: (categoryId: string) => string[]): JqlFilter | undefined;

package/jql/abstract/src/lib/entity-store/category-hierarchy-filter.util.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isCategoryContainsFieldName = isCategoryContainsFieldName;
+exports.isCategoryContainsLeaf = isCategoryContainsLeaf;
+exports.isCategoryFilter = isCategoryFilter;
+exports.resolveCompanionCategoryEntityName = resolveCompanionCategoryEntityName;
+exports.buildCategoryTreeIndex = buildCategoryTreeIndex;
+exports.collectDescendantCategoryIds = collectDescendantCategoryIds;
+exports.categoryTreeCacheKey = categoryTreeCacheKey;
+exports.rewriteAxpCategoryHierarchyFilter = rewriteAxpCategoryHierarchyFilter;
+exports.rewriteJqlCategoryHierarchyFilter = rewriteJqlCategoryHierarchyFilter;
+const CATEGORY_TREE_CACHE_KEY_PREFIX = 'category-tree:';
+/**
+ * Fields where `contains` means hierarchical category membership (expand to descendants).
+ * Excludes e.g. `roleIds`, which uses array membership only.
+ */
+function isCategoryContainsFieldName(field) {
+    if (field === 'categoryIds') {
+        return true;
+    }
+    if (typeof field === 'string' && field.endsWith('Ids') && field !== 'roleIds') {
+        return true;
+    }
+    return false;
+}
+function isCategoryContainsLeaf(filter) {
+    if (!filter || typeof filter !== 'object') {
+        return false;
+    }
+    const leaf = filter;
+    return leaf.operator?.type === 'contains' && isCategoryContainsFieldName(leaf.field);
+}
+/** Detects category hierarchy filters (contains on categoryIds or *Ids except roleIds). */
+function isCategoryFilter(filter) {
+    if (!filter || typeof filter !== 'object') {
+        return false;
+    }
+    if (isCategoryContainsLeaf(filter)) {
+        return true;
+    }
+    const group = filter;
+    if (group.filters && Array.isArray(group.filters)) {
+        return group.filters.some((nested) => isCategoryFilter(nested));
+    }
+    return false;
+}
+/** Companion category entity name: `Module.Entity` → `Module.EntityCategory`. */
+function resolveCompanionCategoryEntityName(entityName) {
+    const dot = entityName.lastIndexOf('.');
+    if (dot === -1) {
+        return `${entityName}Category`;
+    }
+    const module = entityName.slice(0, dot);
+    const entity = entityName.slice(dot + 1);
+    return `${module}.${entity}Category`;
+}
+function buildCategoryTreeIndex(nodes) {
+    const childrenByParent = new Map();
+    for (const node of nodes) {
+        const id = String(node.id);
+        const parentId = node.parentId;
+        if (parentId == null || parentId === '' || parentId === 'all') {
+            continue;
+        }
+        const parentKey = String(parentId);
+        const siblings = childrenByParent.get(parentKey) ?? [];
+        siblings.push(id);
+        childrenByParent.set(parentKey, siblings);
+    }
+    return { childrenByParent };
+}
+/** Collects a category id and all descendant category ids (breadth-first). */
+function collectDescendantCategoryIds(categoryId, tree) {
+    const rootId = String(categoryId);
+    const collected = new Set([rootId]);
+    const queue = [rootId];
+    while (queue.length > 0) {
+        const parentId = queue.shift();
+        const children = tree.childrenByParent.get(parentId) ?? [];
+        for (const childId of children) {
+            if (!collected.has(childId)) {
+                collected.add(childId);
+                queue.push(childId);
+            }
+        }
+    }
+    return [...collected];
+}
+function categoryTreeCacheKey(categoryEntityName) {
+    return `${CATEGORY_TREE_CACHE_KEY_PREFIX}${categoryEntityName}`;
+}
+/** Rewrites AXP category `contains` leaves to `arrayOverlaps` with expanded id lists. */
+function rewriteAxpCategoryHierarchyFilter(filter, expandIds) {
+    if (!filter || typeof filter !== 'object') {
+        return filter;
+    }
+    if (isCategoryContainsLeaf(filter)) {
+        const leaf = filter;
+        const categoryId = String(leaf.value ?? '');
+        const expandedIds = expandIds(categoryId);
+        return {
+            field: leaf.field,
+            operator: { type: 'arrayOverlaps' },
+            value: expandedIds,
+        };
+    }
+    const group = filter;
+    if (group.filters?.length) {
+        return {
+            ...group,
+            filters: group.filters.map((child) => rewriteAxpCategoryHierarchyFilter(child, expandIds)),
+        };
+    }
+    return filter;
+}
+/** Rewrites JQL `contains` category leaves to `arrayOverlaps`. */
+function rewriteJqlCategoryHierarchyFilter(filter, expandIds) {
+    if (!filter) {
+        return undefined;
+    }
+    if ('filters' in filter && Array.isArray(filter.filters)) {
+        const rewritten = filter.filters
+            .map((child) => rewriteJqlCategoryHierarchyFilter(child, expandIds))
+            .filter((child) => Boolean(child));
+        if (!rewritten.length) {
+            return undefined;
+        }
+        return { logic: filter.logic, filters: rewritten };
+    }
+    const condition = filter;
+    if (condition.op === 'contains' && isCategoryContainsFieldName(condition.field)) {
+        const expandedIds = expandIds(String(condition.value ?? ''));
+        return { field: condition.field, op: 'arrayOverlaps', value: expandedIds };
+    }
+    return filter;
+}
+//#endregion
+//# sourceMappingURL=category-hierarchy-filter.util.js.map

package/jql/abstract/src/lib/entity-store/category-hierarchy-filter.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"category-hierarchy-filter.util.js","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/jql/abstract/src/lib/entity-store/category-hierarchy-filter.util.ts"],"names":[],"mappings":";;AA8BA,kEAQC;AAED,wDAMC;AAGD,4CAeC;AAGD,gFAQC;AAED,wDAgBC;AAGD,oEAoBC;AAED,oDAEC;AAGD,8EA4BC;AAGD,8EA2BC;AA7JD,MAAM,8BAA8B,GAAG,gBAAgB,CAAC;AAExD;;;GAGG;AACH,SAAgB,2BAA2B,CAAC,KAAc;IACxD,IAAI,KAAK,KAAK,aAAa,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC9E,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAgB,sBAAsB,CAAC,MAAe;IACpD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,IAAI,GAAG,MAAuB,CAAC;IACrC,OAAO,IAAI,CAAC,QAAQ,EAAE,IAAI,KAAK,UAAU,IAAI,2BAA2B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACvF,CAAC;AAED,2FAA2F;AAC3F,SAAgB,gBAAgB,CAAC,MAAe;IAC9C,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,sBAAsB,CAAC,MAAM,CAAC,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAG,MAAwB,CAAC;IACvC,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAClD,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,iFAAiF;AACjF,SAAgB,kCAAkC,CAAC,UAAkB;IACnE,MAAM,GAAG,GAAG,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;QACf,OAAO,GAAG,UAAU,UAAU,CAAC;IACjC,CAAC;IACD,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IACzC,OAAO,GAAG,MAAM,IAAI,MAAM,UAAU,CAAC;AACvC,CAAC;AAED,SAAgB,sBAAsB,CAAC,KAAyB;IAC9D,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAoB,CAAC;IAErD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC/B,IAAI,QAAQ,IAAI,IAAI,IAAI,QAAQ,KAAK,EAAE,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;YAC9D,SAAS;QACX,CAAC;QACD,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QACvD,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClB,gBAAgB,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAC9B,CAAC;AAED,8EAA8E;AAC9E,SAAgB,4BAA4B,CAC1C,UAAkB,EAClB,IAAuB;IAEvB,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IAClC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,CAAC;IAEvB,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,EAAG,CAAC;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC3D,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC5B,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBACvB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,SAAS,CAAC,CAAC;AACxB,CAAC;AAED,SAAgB,oBAAoB,CAAC,kBAA0B;IAC7D,OAAO,GAAG,8BAA8B,GAAG,kBAAkB,EAAE,CAAC;AAClE,CAAC;AAED,yFAAyF;AACzF,SAAgB,iCAAiC,CAC/C,MAAe,EACf,SAA2C;IAE3C,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1C,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,sBAAsB,CAAC,MAAM,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,MAAuB,CAAC;QACrC,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5C,MAAM,WAAW,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;QAC1C,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE;YACnC,KAAK,EAAE,WAAW;SACnB,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,MAAwB,CAAC;IACvC,IAAI,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAC1B,OAAO;YACL,GAAG,KAAK;YACR,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,iCAAiC,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;SAC3F,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,kEAAkE;AAClE,SAAgB,iCAAiC,CAC/C,MAA6B,EAC7B,SAA2C;IAE3C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,SAAS,IAAI,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QACzD,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO;aAC7B,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,iCAAiC,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;aACnE,MAAM,CAAC,CAAC,KAAK,EAAsB,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAEzD,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;YACtB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IACrD,CAAC;IAED,MAAM,SAAS,GAAG,MAAwD,CAAC;IAC3E,IAAI,SAAS,CAAC,EAAE,KAAK,UAAU,IAAI,2BAA2B,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QAChF,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;QAC7D,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;IAC7E,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,YAAY"}

package/jql/abstract/src/lib/entity-store/entity-fulltext-search-paths.util.d.ts

@@ -0,0 +1,25 @@
+import type { JqlEntitySchema } from '../entity-schema/jql-entity-schema.types';
+/** Baseline scalar fields searched when present on the entity schema. */
+export declare const FULLTEXT_BASE_FIELD_PATHS: readonly ["id", "code", "title", "name", "shortName"];
+export interface FullTextEntityFieldLike {
+    name: string;
+    dataType?: string;
+    interface?: {
+        options?: Record<string, unknown>;
+    };
+}
+export interface FullTextExposeEntry {
+    source: string;
+    target: string;
+}
+export declare function parsePropertyExposeEntries(options: Record<string, unknown> | undefined): FullTextExposeEntry[];
+export declare function collectExposeTargetPathsFromField(field: FullTextEntityFieldLike): string[];
+/** Unique root segments from dotted expose targets (e.g. `product` from `product.title`). */
+export declare function collectLookupSnapshotRootPaths(fields: FullTextEntityFieldLike[]): string[];
+/**
+ * Lodash-get paths for full-text search from entity field metadata (host scalars + lookup expose targets).
+ */
+export declare function collectFullTextSearchPathsFromEntityFields(fields: FullTextEntityFieldLike[]): string[];
+/** Baseline + scalar text columns from a {@link JqlEntitySchema}. */
+export declare function collectFullTextSearchPathsFromSchemaColumns(schema: JqlEntitySchema): string[];
+export declare function mergeFullTextSearchPaths(...pathLists: Array<string[] | undefined>): string[];

package/jql/abstract/src/lib/entity-store/entity-fulltext-search-paths.util.js

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FULLTEXT_BASE_FIELD_PATHS = void 0;
+exports.parsePropertyExposeEntries = parsePropertyExposeEntries;
+exports.collectExposeTargetPathsFromField = collectExposeTargetPathsFromField;
+exports.collectLookupSnapshotRootPaths = collectLookupSnapshotRootPaths;
+exports.collectFullTextSearchPathsFromEntityFields = collectFullTextSearchPathsFromEntityFields;
+exports.collectFullTextSearchPathsFromSchemaColumns = collectFullTextSearchPathsFromSchemaColumns;
+exports.mergeFullTextSearchPaths = mergeFullTextSearchPaths;
+//#region ---- Full-text search path resolution ----
+/** Baseline scalar fields searched when present on the entity schema. */
+exports.FULLTEXT_BASE_FIELD_PATHS = ['id', 'code', 'title', 'name', 'shortName'];
+const SYSTEM_JSON_COLUMNS = new Set(['created', 'updated']);
+const NON_TEXT_DATATYPES = new Set([
+    'number',
+    'integer',
+    'int',
+    'long',
+    'float',
+    'double',
+    'decimal',
+    'money',
+    'currency',
+    'boolean',
+    'bool',
+    'date',
+    'datetime',
+    'time',
+    'object',
+    'array',
+    'json',
+    'image',
+    'file',
+    'binary',
+]);
+function isTextLikeDataType(dataType) {
+    const normalized = (dataType ?? 'string').toLowerCase().trim();
+    if (!normalized || NON_TEXT_DATATYPES.has(normalized)) {
+        return false;
+    }
+    return true;
+}
+function parsePropertyExposeEntries(options) {
+    const expose = options?.['expose'];
+    if (!Array.isArray(expose)) {
+        return [];
+    }
+    return expose.filter((row) => row != null &&
+        typeof row === 'object' &&
+        typeof row.source === 'string' &&
+        typeof row.target === 'string');
+}
+function collectExposeTargetPathsFromField(field) {
+    const opts = field.interface?.options;
+    if (!opts || typeof opts !== 'object') {
+        return [];
+    }
+    const paths = new Set();
+    for (const entry of parsePropertyExposeEntries(opts)) {
+        const target = entry.target.trim();
+        if (target) {
+            paths.add(target);
+        }
+    }
+    return Array.from(paths);
+}
+/** Unique root segments from dotted expose targets (e.g. `product` from `product.title`). */
+function collectLookupSnapshotRootPaths(fields) {
+    const roots = new Set();
+    for (const field of fields) {
+        for (const target of collectExposeTargetPathsFromField(field)) {
+            const dotIndex = target.indexOf('.');
+            if (dotIndex > 0) {
+                roots.add(target.slice(0, dotIndex));
+            }
+        }
+    }
+    return Array.from(roots);
+}
+/**
+ * Lodash-get paths for full-text search from entity field metadata (host scalars + lookup expose targets).
+ */
+function collectFullTextSearchPathsFromEntityFields(fields) {
+    const paths = new Set();
+    for (const field of fields) {
+        if (isTextLikeDataType(field.dataType)) {
+            paths.add(field.name);
+        }
+        for (const target of collectExposeTargetPathsFromField(field)) {
+            paths.add(target);
+        }
+    }
+    return Array.from(paths);
+}
+/** Baseline + scalar text columns from a {@link JqlEntitySchema}. */
+function collectFullTextSearchPathsFromSchemaColumns(schema) {
+    const columnNames = new Set(schema.columns.map((column) => column.name));
+    const fields = new Set();
+    for (const base of exports.FULLTEXT_BASE_FIELD_PATHS) {
+        if (columnNames.has(base)) {
+            fields.add(base);
+        }
+    }
+    for (const column of schema.columns) {
+        if (column.dataType !== 'text' || SYSTEM_JSON_COLUMNS.has(column.name)) {
+            continue;
+        }
+        fields.add(column.name);
+    }
+    return Array.from(fields);
+}
+function mergeFullTextSearchPaths(...pathLists) {
+    const merged = new Set();
+    for (const list of pathLists) {
+        if (!list?.length) {
+            continue;
+        }
+        for (const path of list) {
+            const trimmed = path.trim();
+            if (trimmed) {
+                merged.add(trimmed);
+            }
+        }
+    }
+    return Array.from(merged);
+}
+//#endregion
+//# sourceMappingURL=entity-fulltext-search-paths.util.js.map

package/jql/abstract/src/lib/entity-store/entity-fulltext-search-paths.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-fulltext-search-paths.util.js","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/jql/abstract/src/lib/entity-store/entity-fulltext-search-paths.util.ts"],"names":[],"mappings":"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"}

package/jql/abstract/src/lib/entity-store/entity-fulltext-search.util.d.ts

@@ -0,0 +1,44 @@
+import { JqlFilter } from '../jql.types';
+import { JqlEntitySchema } from '../entity-schema/jql-entity-schema.types';
+import { FULLTEXT_BASE_FIELD_PATHS } from './entity-fulltext-search-paths.util';
+export { FULLTEXT_BASE_FIELD_PATHS };
+interface AxpFilterLeaf {
+    field?: string;
+    operator?: {
+        type?: string;
+    };
+    value?: unknown;
+    logic?: string;
+    filters?: AxpFilterLeaf[];
+}
+export interface ExtractedFullTextSearch {
+    term: string;
+    remainingFilter?: unknown;
+    /** Field paths from inline-all child filters (e.g. `product.title`). */
+    fieldPaths?: string[];
+}
+/**
+ * Detects UI inline search: `{ field: 'all', logic: 'or', filters: [...contains...] }`.
+ */
+export declare function isInlineAllOrFilter(filter: AxpFilterLeaf | undefined): boolean;
+/**
+ * Pulls inline-all OR nodes out of the filter tree before structured JQL compilation.
+ */
+export declare function extractFullTextFromFilter(filter: unknown): ExtractedFullTextSearch | null;
+export declare function extractQuickSearchTerm(params?: Record<string, unknown>): string | undefined;
+/**
+ * Resolves lodash-get paths used for full-text search on an entity schema.
+ */
+export declare function resolveFullTextSearchFields(schema: JqlEntitySchema): string[];
+/**
+ * Builds a JQL filter: each whitespace token must match (AND), and each token matches
+ * when any searchable field contains it (OR of `contains` clauses).
+ */
+export declare function buildFullTextJqlFilter(term: string, fields: string[]): JqlFilter | undefined;
+/**
+ * Combines structured user filter with inline-all / quickSearch full-text clauses.
+ */
+export declare function composeFullTextAwareJqlFilter(request: {
+    filter?: unknown;
+    params?: Record<string, unknown>;
+}, structuredFilter: JqlFilter | undefined, searchableFields?: string[]): JqlFilter | undefined;