@rockster/core 0.0.1 → 0.0.4

package/query/functions/external-column-owner-path.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Segments to walk from each root query row to the object that owns an external column.
+ * Empty when the owner is the root entity row (e.g. root-level `status`).
+ */
+export declare function toExternalOwnerWalkSegments(ownerFullPath: string, rootAlias: string): string[];

package/query/functions/external-column-owner-path.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toExternalOwnerWalkSegments = toExternalOwnerWalkSegments;
+/**
+ * Segments to walk from each root query row to the object that owns an external column.
+ * Empty when the owner is the root entity row (e.g. root-level `status`).
+ */
+function toExternalOwnerWalkSegments(ownerFullPath, rootAlias) {
+    if (ownerFullPath === rootAlias) {
+        return [];
+    }
+    const prefix = `${rootAlias}.`;
+    if (ownerFullPath.startsWith(prefix)) {
+        return ownerFullPath.slice(prefix.length).split(".").filter(Boolean);
+    }
+    return ownerFullPath.split(".").filter(Boolean);
+}
+//# sourceMappingURL=external-column-owner-path.js.map

package/query/functions/external-column-owner-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-column-owner-path.js","sourceRoot":"./","sources":["query/functions/external-column-owner-path.ts"],"names":[],"mappings":";;AAIA,kEAYC;AAhBD;;;GAGG;AACH,SAAgB,2BAA2B,CACxC,aAAqB,EACrB,SAAiB;IAEjB,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,EAAE,CAAC;IACb,CAAC;IACD,MAAM,MAAM,GAAG,GAAG,SAAS,GAAG,CAAC;IAC/B,IAAI,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACpC,OAAO,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACnD,CAAC"}

package/query/functions/get-column-path.js

@@ -12,3 +12,4 @@ const getColumnPath = (path, currentPath = '') => {
     return fullPath;
 };
 exports.getColumnPath = getColumnPath;
+//# sourceMappingURL=get-column-path.js.map

package/query/functions/get-column-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-column-path.js","sourceRoot":"./","sources":["query/functions/get-column-path.ts"],"names":[],"mappings":";;;AAEO,MAAM,aAAa,GAAG,CAAC,IAAe,EAAE,cAAsB,EAAE,EAAE,EAAE;IACxE,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC5B,QAAQ,GAAG,IAAA,qBAAa,EAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACrD,CAAC;SAAM,CAAC;QACL,QAAQ,GAAG,GAAG,IAAI,CAAC,KAAK,IAAI,WAAW,EAAE,CAAC;IAC7C,CAAC;IACD,OAAO,QAAQ,CAAC;AACnB,CAAC,CAAA;AARY,QAAA,aAAa,iBAQzB"}

package/query/functions/get-entity-object-class.d.ts

@@ -0,0 +1,2 @@
+import { Instantiable } from "@rockster/common";
+export declare const getEntityObjectClass: (target: Instantiable) => Instantiable;

package/query/functions/get-entity-object-class.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEntityObjectClass = void 0;
+const object_type_1 = require("../../common/interfaces/enum/object-type");
+const getEntityObjectClass = (target) => {
+    const object = core.storage.findObject(target);
+    return object?.type === object_type_1.ObjectType.entityDto
+        ? object.entity()
+        : object?.objectClass;
+};
+exports.getEntityObjectClass = getEntityObjectClass;
+//# sourceMappingURL=get-entity-object-class.js.map

package/query/functions/get-entity-object-class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-entity-object-class.js","sourceRoot":"./","sources":["query/functions/get-entity-object-class.ts"],"names":[],"mappings":";;;AACA,0EAAsE;AAE/D,MAAM,oBAAoB,GAAG,CAAC,MAAoB,EAAE,EAAE;IAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC/C,OAAO,MAAM,EAAE,IAAI,KAAK,wBAAU,CAAC,SAAS;QACzC,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE;QACjB,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC;AAC5B,CAAC,CAAA;AALY,QAAA,oBAAoB,wBAKhC"}

package/query/functions/get-native-select.d.ts

@@ -1,2 +1,5 @@
 import { Instantiable } from "@rockster/common";
-export declare const getNativeSelect: (target: Instantiable, select: string[]) => string[];
+export declare const getNativeSelect: (target: Instantiable, select: string[]) => {
+    asMap: Map<string, string>;
+    asArry: string[];
+};

package/query/functions/get-native-select.js

@@ -4,6 +4,17 @@ exports.getNativeSelect = void 0;
 const map_query_property_to_column_name_1 = require("./map-query-property-to-column-name");
 const getNativeSelect = (target, select) => {
     const queryObject = core.storage.findObject(target);
-    return select.map(item => (0, map_query_property_to_column_name_1.mapQueryPropertyToColumnName)(queryObject, item));
+    const mapper = new Map();
+    const arry = [];
+    select.forEach(item => {
+        const queryProperty = queryObject.properties[item];
+        if (queryProperty?.isExternal)
+            return;
+        const columnName = (0, map_query_property_to_column_name_1.mapQueryPropertyToColumnName)(queryObject, item);
+        arry.pushIfNotExists(columnName);
+        mapper.set(item, columnName);
+    });
+    return { asMap: mapper, asArry: arry };
 };
 exports.getNativeSelect = getNativeSelect;
+//# sourceMappingURL=get-native-select.js.map

package/query/functions/get-native-select.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-native-select.js","sourceRoot":"./","sources":["query/functions/get-native-select.ts"],"names":[],"mappings":";;;AAGA,2FAAmF;AAE5E,MAAM,eAAe,GAAG,CAC5B,MAAoB,EACpB,MAAgB,EACjB,EAAE;IACD,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAA6B,CAAC;IAChF,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,MAAM,IAAI,GAAG,EAAc,CAAC;IAC5B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;QACnB,MAAM,aAAa,GAAG,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,aAAa,EAAE,UAAU;YAAE,OAAO;QACtC,MAAM,UAAU,GAAG,IAAA,gEAA4B,EAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QACnE,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;QACjC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAC1C,CAAC,CAAA;AAfY,QAAA,eAAe,mBAe3B"}

package/query/functions/load-properties.d.ts

@@ -1,6 +1,15 @@
 import { Dictionary, Instantiable } from "@rockster/common";
 import { Paths } from "../../database/interfaces/path";
 import { QueryPath, QueryProperty, QueryPropertyType, QueryRelationConfig } from "../interfaces/query";
+/** When traversing an object/relation property marked @ExternalColumn, descendants inherit its resolver. */
+export type ExternalSubtreeContext = {
+    resolver: Instantiable;
+    /** Full query path to the entity row that owns `columnKey`. */
+    ownerFullPath: string;
+    columnKey: string;
+    /** Full query paths for DB columns required alongside this external column (selectDependencies). */
+    dependencyQueryPaths: string[];
+};
 export type LoadPropertiesArgs = {
     type: QueryPropertyType;
     target: Instantiable;
@@ -14,6 +23,15 @@ export type LoadPropertiesArgs = {
     secure?: boolean;
     initializedObjects?: string[];
     rootEntity: Instantiable;
-    rootFullPath?: string;
+    rootOrRelationPath?: string;
+    isRelation?: boolean;
+    /** Root query alias (first path segment); used for external owner walk segments. */
+    rootAlias: string;
+    externalSubtree?: ExternalSubtreeContext;
+    /**
+     * SQL table aliases used by {@link joinOne}/{@link joinMany} across the whole query tree.
+     * Root initializes this (includes the root alias); duplicate join `alias` values throw.
+     */
+    usedJoinSqlAliases?: Set<string>;
 };
-export declare const loadProperties: ({ type, target, alias, entityAlias, properties, parent, paths, relation, fullPath, secure, initializedObjects, rootEntity, rootFullPath }: LoadPropertiesArgs) => void;
+export declare const loadProperties: ({ type, target, alias, entityAlias, properties, parent, paths, relation, fullPath, secure, initializedObjects, rootEntity, rootOrRelationPath, rootAlias, externalSubtree, usedJoinSqlAliases: usedJoinSqlAliasesArg }: LoadPropertiesArgs) => void;

package/query/functions/load-properties.js

@@ -4,44 +4,83 @@ exports.loadProperties = void 0;
 const class_pipe_1 = require("@rockster/class-pipe");
 const object_type_1 = require("../../common/interfaces/enum/object-type");
 const get_id_property_1 = require("../../database/functions/get-id-property");
-const loadProperties = ({ type, target, alias, entityAlias, properties, parent, paths, relation, fullPath = '', secure, initializedObjects = [], rootEntity, rootFullPath }) => {
-    // fullPath agora representa o caminho global (root até aqui)
+const get_entity_object_class_1 = require("./get-entity-object-class");
+const external_column_owner_path_1 = require("./external-column-owner-path");
+function resolveExternalColumnClass(ep, entityLabel, propertyKey) {
+    const Resolver = ep.getExternalResolver?.();
+    if (!Resolver) {
+        throw new Error(`External column "${propertyKey}" on ${entityLabel} must use ExternalColumn(() => ResolverClass); the callback returned nothing`);
+    }
+    return Resolver;
+}
+const loadProperties = ({ type, target, alias, entityAlias, properties, parent, paths, relation, fullPath = '', secure, initializedObjects = [], rootEntity, rootOrRelationPath, rootAlias, externalSubtree, usedJoinSqlAliases: usedJoinSqlAliasesArg }) => {
+    const usedJoinSqlAliases = usedJoinSqlAliasesArg ??
+        (type === "root"
+            ? new Set([entityAlias ?? alias])
+            : (() => {
+                throw new Error("loadProperties: join alias registry missing; this is an internal error");
+            })());
     const currentPath = fullPath ? `${fullPath}.${alias}` : alias;
-    ;
     const initializedObjectKey = `${currentPath}:${target.name}`;
+    const targetObjectClass = (0, get_entity_object_class_1.getEntityObjectClass)(target);
+    const entityOwnerLabel = targetObjectClass?.name
+        ?? (typeof target?.name === 'string'
+            ? target.name
+            : 'Entity');
     if (initializedObjects.includes(initializedObjectKey))
         return;
     initializedObjects.push(initializedObjectKey);
-    const targetProperties = (0, class_pipe_1.getExposeProperties)(target);
-    targetProperties
-        .filter((property) => {
+    const targetProperties = (0, class_pipe_1.getExposeProperties)(target).filter((property) => {
         if (property.subtype) {
             const object = core.storage.findObject(property.subtype);
-            const isEntity = object?.type === object_type_1.ObjectType.entity;
+            const isEntity = object?.type === object_type_1.ObjectType.entity || object?.type === object_type_1.ObjectType.entityDto;
             return !isEntity;
         }
         return true;
-    })
-        .forEach((targetProperty) => {
+    });
+    for (const targetProperty of targetProperties) {
         const propertyKey = targetProperty.propertyKey;
         const globalPath = `${currentPath}.${propertyKey}`;
         let columnName;
-        const entityProperty = core
-            .storage
-            .getProperties(targetProperty.objectClass)
-            .find((p) => p.propertyKey === propertyKey);
+        const entityProperty = targetObjectClass
+            ? core
+                .storage
+                .getProperties(targetObjectClass)
+                .find((property) => {
+                return property.propertyKey === propertyKey;
+            })
+            : undefined;
         if (entityProperty) {
             columnName = entityProperty.columnName;
         }
-        if (type === 'root' && !entityProperty) {
-            return;
-        }
-        if ((targetProperty.type === class_pipe_1.PropertyType.object && targetProperty.subtype)
-            || targetProperty.ifChecks?.length > 0) {
-            const hasIfChecks = targetProperty.ifChecks?.length > 0;
-            const objectTypes = hasIfChecks
+        if (type === 'root' && !entityProperty)
+            continue;
+        const subtype = targetProperty.type === class_pipe_1.PropertyType.object && targetProperty.subtype;
+        const multitype = targetProperty.ifChecks?.length > 0;
+        const hasIfChecks = targetProperty.ifChecks?.length > 0;
+        const objectTypes = subtype || multitype
+            ? hasIfChecks
                 ? targetProperty.ifChecks.map((ifCheck) => ifCheck.type)
-                : [targetProperty.subtype];
+                : [targetProperty.subtype].filter(Boolean)
+            : [];
+        /**
+         * @IsIn(enum) can surface as `object` + enum subtype; that is not an @Entity graph.
+         * External columns like that must register a single leaf, not recurse into the enum.
+         * Real external objects (Person entity, etc.) still recurse when subtype resolves in storage.
+         */
+        const shouldRecurseEmbedded = (subtype || multitype) &&
+            (!entityProperty?.isExternal ||
+                objectTypes.some((ot) => !!(0, get_entity_object_class_1.getEntityObjectClass)(ot)));
+        if (shouldRecurseEmbedded) {
+            const anchorDepPaths = (entityProperty?.externalSelectDependencies ?? []).map((d) => `${currentPath}.${d}`);
+            const nextSubtree = entityProperty?.isExternal
+                ? {
+                    resolver: resolveExternalColumnClass(entityProperty, entityOwnerLabel, propertyKey),
+                    ownerFullPath: currentPath,
+                    columnKey: propertyKey,
+                    dependencyQueryPaths: anchorDepPaths,
+                }
+                : externalSubtree;
             objectTypes.forEach((objectType) => {
                 (0, exports.loadProperties)({
                     type: 'embedded',
@@ -50,21 +89,47 @@ const loadProperties = ({ type, target, alias, entityAlias, properties, parent,
                     target: objectType,
                     fullPath: currentPath,
                     initializedObjects,
+                    entityAlias: entityAlias,
                     rootEntity,
-                    rootFullPath: type === "embedded"
-                        ? rootFullPath
-                        : `${currentPath}.${targetProperty.propertyKey}`,
+                    rootAlias,
+                    usedJoinSqlAliases,
+                    externalSubtree: nextSubtree,
                     parent: {
                         alias,
                         target,
                         type,
                         parent,
                         entityAlias
-                    }
+                    },
+                    rootOrRelationPath: type === "embedded"
+                        ? rootOrRelationPath
+                        : `${entityAlias}.${targetProperty.propertyKey}`
                 });
             });
         }
         else {
+            const directExternal = !!entityProperty?.isExternal;
+            const inheritedExternal = !!externalSubtree;
+            const isExternal = directExternal || inheritedExternal;
+            const resolver = directExternal && entityProperty
+                ? resolveExternalColumnClass(entityProperty, entityOwnerLabel, propertyKey)
+                : externalSubtree?.resolver;
+            const ownerFullPath = directExternal
+                ? currentPath
+                : externalSubtree?.ownerFullPath ?? currentPath;
+            const externalColumnKey = directExternal
+                ? propertyKey
+                : externalSubtree?.columnKey ?? propertyKey;
+            const externalDependencyQueryPaths = isExternal
+                ? [
+                    ...new Set([
+                        ...(externalSubtree?.dependencyQueryPaths ?? []),
+                        ...(directExternal && entityProperty
+                            ? (entityProperty.externalSelectDependencies ?? []).map((d) => `${currentPath}.${d}`)
+                            : []),
+                    ]),
+                ]
+                : undefined;
             properties[globalPath] = {
                 path: {
                     target,
@@ -74,54 +139,73 @@ const loadProperties = ({ type, target, alias, entityAlias, properties, parent,
                     parent,
                     secure,
                     entityAlias,
-                    rootOrRelationFullPath: rootFullPath
+                    rootOrRelationPath
                 },
                 isUUID: targetProperty.type === class_pipe_1.PropertyType.string
                     && targetProperty.validatorsConfigs?.some((cfg) => cfg.type === 'isUUID') || false,
                 columnName,
                 isArray: !!targetProperty.isArray,
-                isJson: !!targetProperty.isJSON,
+                isJson: type === 'embedded',
+                isExternal,
+                externalResolver: resolver,
+                externalOwnerWalkSegments: isExternal
+                    ? (0, external_column_owner_path_1.toExternalOwnerWalkSegments)(ownerFullPath, rootAlias)
+                    : undefined,
+                externalColumnKey: isExternal ? externalColumnKey : undefined,
+                externalDependencyQueryPaths,
                 fullPath: globalPath,
                 name: propertyKey,
                 type: targetProperty.type
             };
         }
-    });
+    }
     if (paths) {
         const idProperty = (0, get_id_property_1.getIdProperty)(target);
         const pathKeys = Object.keys(paths);
         for (const pathProperty of pathKeys) {
             const path = paths[pathProperty];
+            const pathObjectClass = (0, get_entity_object_class_1.getEntityObjectClass)(path.target());
             const linkProperty = (path.type === 'indirect'
-                ? core.storage.getProperties(path.target()).find((p) => p.isRelation && p.getRelationType() === target)
-                : core.storage.getProperties(target).find((p) => p.isRelation && p.getRelationType() === path.target()));
-            if (!linkProperty) {
-                const line1 = `Unable to find linkProperty to ${path.alias}:${path.target()?.name} into query:${target.name}`;
+                ? core.storage.getProperties(pathObjectClass).find((p) => p.isRelation && p.getRelationType() === targetObjectClass)
+                : core.storage.getProperties(targetObjectClass).find((p) => p.isRelation && p.getRelationType() === pathObjectClass));
+            if (!linkProperty && !path.condition) {
+                const line1 = `Unable to find linkProperty to ${path.alias}:${pathObjectClass?.name} into query:${target.name}`;
                 const line2 = `Use @Relation(() => <target>) to define`;
                 throw new Error(`${line1}\n${line2}`);
             }
-            const targetIdProperty = (0, get_id_property_1.getIdProperty)(path.target());
+            const joinSqlAlias = path.alias;
+            if (usedJoinSqlAliases.has(joinSqlAlias)) {
+                throw new Error(`Duplicate query join SQL alias "${joinSqlAlias}" (paths key "${pathProperty}" under "${currentPath}"). ` +
+                    `Each joinOne/joinMany must use a globally unique alias in this query (e.g. routerDataCenter vs serverDataCenter).`);
+            }
+            usedJoinSqlAliases.add(joinSqlAlias);
+            const targetIdProperty = (0, get_id_property_1.getIdProperty)(pathObjectClass);
+            const joinEntityAlias = joinSqlAlias;
             const condition = path.condition ?? (() => {
                 const linkName = path.linkProperty || linkProperty.columnName;
                 return path.type === "direct"
-                    ? `"${entityAlias}"."${linkName}" = "${path.alias}"."${targetIdProperty.columnName}"`
-                    : `"${entityAlias}"."${idProperty.columnName}" = "${path.alias}"."${linkName}"`;
+                    ? `"${entityAlias}"."${linkName}" = "${joinEntityAlias}"."${targetIdProperty.columnName}"`
+                    : `"${entityAlias}"."${idProperty.columnName}" = "${joinEntityAlias}"."${linkName}"`;
             })();
             (0, exports.loadProperties)({
                 alias: pathProperty,
-                entityAlias: path.alias,
+                entityAlias: joinEntityAlias,
                 properties,
                 target: path.target(),
                 type: "relation",
                 paths: path.paths,
                 secure: path.secure,
                 rootEntity,
+                fullPath: currentPath,
+                initializedObjects,
+                rootAlias,
+                usedJoinSqlAliases,
+                externalSubtree,
                 relation: {
                     type: path.type,
                     mapTo: `${alias}.${pathProperty}`,
                     condition,
                 },
-                fullPath: currentPath,
                 parent: {
                     alias,
                     target,
@@ -129,10 +213,10 @@ const loadProperties = ({ type, target, alias, entityAlias, properties, parent,
                     relation,
                     parent,
                     entityAlias
-                },
-                initializedObjects
+                }
             });
         }
     }
 };
 exports.loadProperties = loadProperties;
+//# sourceMappingURL=load-properties.js.map

package/query/functions/load-properties.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-properties.js","sourceRoot":"./","sources":["query/functions/load-properties.ts"],"names":[],"mappings":"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"}

package/query/functions/map-query-property-to-column-name.js

@@ -9,9 +9,10 @@ const mapQueryPropertyToColumnName = (queryObject, item) => {
         case "root":
             return `${queryProperty.path.entityAlias}.${queryProperty.name}`;
         case "embedded":
-            return queryProperty.path.rootOrRelationFullPath;
+            return queryProperty.path.rootOrRelationPath;
         default:
             throw new Error(`${item} not found on query`);
     }
 };
 exports.mapQueryPropertyToColumnName = mapQueryPropertyToColumnName;
+//# sourceMappingURL=map-query-property-to-column-name.js.map

package/query/functions/map-query-property-to-column-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-query-property-to-column-name.js","sourceRoot":"./","sources":["query/functions/map-query-property-to-column-name.ts"],"names":[],"mappings":";;;AAGO,MAAM,4BAA4B,GAAG,CAAC,WAAqC,EAAE,IAAY,EAAE,EAAE;IAEjG,MAAM,eAAe,GAAG,WAAW,CAAC,UAAU,CAAC;IAC/C,MAAM,aAAa,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAE5C,QAAQ,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC/B,KAAK,UAAU,CAAC;QAChB,KAAK,MAAM;YACR,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,WAAW,IAAI,aAAa,CAAC,IAAI,EAAE,CAAC;QACpE,KAAK,UAAU;YACZ,OAAO,aAAa,CAAC,IAAI,CAAC,kBAAkB,CAAC;QAChD;YACG,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,qBAAqB,CAAC,CAAC;IACpD,CAAC;AACJ,CAAC,CAAA;AAdY,QAAA,4BAA4B,gCAcxC"}

package/query/functions/query-structure-cache.d.ts

@@ -0,0 +1,24 @@
+import { QueryPath } from '../interfaces/query';
+/**
+ * Returns cached native select (asArry, asMap) for the given structure hash, or undefined.
+ * Caller receives copies so cache entries are never mutated.
+ */
+export declare function getCachedNativeSelect(structureHash: string): {
+    asArry: string[];
+    asMap: Map<string, string>;
+} | undefined;
+/**
+ * Stores native select result for the given structure hash.
+ * Evicts oldest entry when at MAX_ENTRIES (LRU).
+ */
+export declare function setCachedNativeSelect(structureHash: string, asArry: string[], asMap: Map<string, string>): void;
+/**
+ * Returns cached join plan (array of QueryPath) for the given join structure hash.
+ * Paths are applied to a fresh QB each request – we never cache the QB or EntityManager.
+ */
+export declare function getCachedJoinPlan(joinStructureHash: string): QueryPath[] | undefined;
+/**
+ * Stores join plan (order of paths to apply) for the given join structure hash.
+ * Evicts oldest entry when at MAX_ENTRIES (LRU).
+ */
+export declare function setCachedJoinPlan(joinStructureHash: string, paths: QueryPath[]): void;

package/query/functions/query-structure-cache.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCachedNativeSelect = getCachedNativeSelect;
+exports.setCachedNativeSelect = setCachedNativeSelect;
+exports.getCachedJoinPlan = getCachedJoinPlan;
+exports.setCachedJoinPlan = setCachedJoinPlan;
+const MAX_ENTRIES = 500;
+const cache = new Map();
+const keyOrder = [];
+const joinPlanCache = new Map();
+const joinPlanKeyOrder = [];
+function evictOne() {
+    const oldest = keyOrder.shift();
+    if (oldest != null)
+        cache.delete(oldest);
+}
+/**
+ * Returns cached native select (asArry, asMap) for the given structure hash, or undefined.
+ * Caller receives copies so cache entries are never mutated.
+ */
+function getCachedNativeSelect(structureHash) {
+    const entry = cache.get(structureHash);
+    if (!entry)
+        return undefined;
+    return {
+        asArry: [...entry.asArry],
+        asMap: new Map(entry.asMap),
+    };
+}
+/**
+ * Stores native select result for the given structure hash.
+ * Evicts oldest entry when at MAX_ENTRIES (LRU).
+ */
+function setCachedNativeSelect(structureHash, asArry, asMap) {
+    if (cache.has(structureHash))
+        return;
+    if (keyOrder.length >= MAX_ENTRIES)
+        evictOne();
+    keyOrder.push(structureHash);
+    cache.set(structureHash, { asArry, asMap });
+}
+function evictOneJoinPlan() {
+    const oldest = joinPlanKeyOrder.shift();
+    if (oldest != null)
+        joinPlanCache.delete(oldest);
+}
+/**
+ * Returns cached join plan (array of QueryPath) for the given join structure hash.
+ * Paths are applied to a fresh QB each request – we never cache the QB or EntityManager.
+ */
+function getCachedJoinPlan(joinStructureHash) {
+    return joinPlanCache.get(joinStructureHash);
+}
+/**
+ * Stores join plan (order of paths to apply) for the given join structure hash.
+ * Evicts oldest entry when at MAX_ENTRIES (LRU).
+ */
+function setCachedJoinPlan(joinStructureHash, paths) {
+    if (joinPlanCache.has(joinStructureHash))
+        return;
+    if (joinPlanKeyOrder.length >= MAX_ENTRIES)
+        evictOneJoinPlan();
+    joinPlanKeyOrder.push(joinStructureHash);
+    joinPlanCache.set(joinStructureHash, paths);
+}
+//# sourceMappingURL=query-structure-cache.js.map

package/query/functions/query-structure-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-structure-cache.js","sourceRoot":"./","sources":["query/functions/query-structure-cache.ts"],"names":[],"mappings":";;AAwBA,sDASC;AAMD,sDASC;AAWD,8CAEC;AAMD,8CAKC;AAtED,MAAM,WAAW,GAAG,GAAG,CAAC;AAOxB,MAAM,KAAK,GAAG,IAAI,GAAG,EAA6B,CAAC;AACnD,MAAM,QAAQ,GAAa,EAAE,CAAC;AAE9B,MAAM,aAAa,GAAG,IAAI,GAAG,EAAuB,CAAC;AACrD,MAAM,gBAAgB,GAAa,EAAE,CAAC;AAEtC,SAAS,QAAQ;IACd,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC;IAChC,IAAI,MAAM,IAAI,IAAI;QAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED;;;GAGG;AACH,SAAgB,qBAAqB,CAClC,aAAqB;IAErB,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,OAAO;QACJ,MAAM,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;QACzB,KAAK,EAAE,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC;KAC7B,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,SAAgB,qBAAqB,CAClC,aAAqB,EACrB,MAAgB,EAChB,KAA0B;IAE1B,IAAI,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC;QAAE,OAAO;IACrC,IAAI,QAAQ,CAAC,MAAM,IAAI,WAAW;QAAE,QAAQ,EAAE,CAAC;IAC/C,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC7B,KAAK,CAAC,GAAG,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,gBAAgB;IACtB,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,EAAE,CAAC;IACxC,IAAI,MAAM,IAAI,IAAI;QAAE,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACpD,CAAC;AAED;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,iBAAyB;IACxD,OAAO,aAAa,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,iBAAyB,EAAE,KAAkB;IAC5E,IAAI,aAAa,CAAC,GAAG,CAAC,iBAAiB,CAAC;QAAE,OAAO;IACjD,IAAI,gBAAgB,CAAC,MAAM,IAAI,WAAW;QAAE,gBAAgB,EAAE,CAAC;IAC/D,gBAAgB,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACzC,aAAa,CAAC,GAAG,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;AAC/C,CAAC"}

package/query/functions/replace-property-key-to-column-name.js

@@ -8,3 +8,4 @@ const replacePropertyKeyToColumnName = (item, alias, propertyKey, columnName) =>
         : item;
 };
 exports.replacePropertyKeyToColumnName = replacePropertyKeyToColumnName;
+//# sourceMappingURL=replace-property-key-to-column-name.js.map

package/query/functions/replace-property-key-to-column-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace-property-key-to-column-name.js","sourceRoot":"./","sources":["query/functions/replace-property-key-to-column-name.ts"],"names":[],"mappings":";;;AAAO,MAAM,8BAA8B,GAAG,CAC3C,IAAY,EACZ,KAAa,EACb,WAAmB,EACnB,UAAkB,EACnB,EAAE;IACD,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IAC/D,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC;QAC7B,CAAC,CAAC,gBAAgB;QAClB,CAAC,CAAC,IAAI,CAAC;AACb,CAAC,CAAA;AAVY,QAAA,8BAA8B,kCAU1C"}

package/query/interfaces/index.js

@@ -17,3 +17,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./query-action-options"), exports);
 __exportStar(require("./query-object"), exports);
 __exportStar(require("./query"), exports);
+//# sourceMappingURL=index.js.map

package/query/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"./","sources":["query/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAuC;AACvC,iDAA+B;AAC/B,0CAAwB"}

package/query/interfaces/query-action-options.js

@@ -1,2 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=query-action-options.js.map

package/query/interfaces/query-action-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-action-options.js","sourceRoot":"./","sources":["query/interfaces/query-action-options.ts"],"names":[],"mappings":""}

package/query/interfaces/query-object.js

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

package/query/interfaces/query-object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-object.js","sourceRoot":"./","sources":["query/interfaces/query-object.ts"],"names":[],"mappings":""}

package/query/interfaces/query.d.ts

@@ -16,9 +16,37 @@ export type Query<Entity> = {
     data?: Entity[];
     page?: boolean;
 };
+/**
+ * One object graph node that owns ≥1 selected external property (same reference TypeORM returned;
+ * mutate in place so `transform` sees the values).
+ */
+export type ExternalColumnOwner = {
+    object: Record<string, unknown>;
+    /**
+     * Declared external column names on `object` (e.g. `person` when select is `user.person.id`).
+     * Not the nested leaf (`id`); the anchor property marked with ExternalColumn.
+     */
+    properties: string[];
+};
+/**
+ * Passed to {@link ExternalColumnBatchResolver} after `getMany()`, before `transform`.
+ * `owners` is deduped by object identity — batch-load once per unique node (e.g. all `InfraClient` rows).
+ */
+export type ExternalColumnResolvePayload<Entity = any> = {
+    roots: Entity[];
+    externalSelectPaths: string[];
+    owners: ExternalColumnOwner[];
+};
+/**
+ * Called only when at least one external column is in the query select.
+ * Receives raw root rows from TypeORM and a flat list of owner objects that need those columns filled.
+ * Mutate `owners[].object` in place (or return new `roots`); then `transform` runs on `roots`.
+ */
+export type ExternalColumnBatchResolver<Entity = any, ContextData = any> = (payload: ExternalColumnResolvePayload<Entity>, context: IQueryContent<Entity, ContextData>) => Promise<Entity[]>;
 export type IQueryContent<Entity, ContextData = any> = {
     userId?: string;
-    naviteSelect?: string[];
+    nativeSelectAsArry?: string[];
+    nativeSelectAsMap?: Map<string, string>;
     parameters?: Record<string, any>;
     query: Query<Entity>;
     target: Instantiable;
@@ -40,13 +68,29 @@ export type QueryPath = {
     parent?: QueryPath;
     secure?: boolean;
     entityAlias: string;
-    rootOrRelationFullPath?: string;
+    rootOrRelationPath?: string;
 };
 export type QueryProperty = {
     path: QueryPath;
     isUUID?: boolean;
     isArray?: boolean;
     isJson?: boolean;
+    /** When true, value is provided by external service; not selected from DB. */
+    isExternal?: boolean;
+    /** Resolved Injectable class from ExternalColumn(() => Resolver); used by executeQuery. */
+    externalResolver?: Instantiable;
+    /**
+     * Walk from each root row through these relation/embed keys to reach the owner of {@link externalColumnKey}.
+     * Empty when the owner is the root row.
+     */
+    externalOwnerWalkSegments?: string[];
+    /** External property on that owner (object or scalar). */
+    externalColumnKey?: string;
+    /**
+     * Full query paths (e.g. `infraServer.client.clientId`) that must be added to the SQL select when this
+     * external path is selected — same entity row, declared via ExternalColumnOptions.selectDependencies.
+     */
+    externalDependencyQueryPaths?: string[];
     name: string;
     type: PropertyType;
     fullPath: string;

package/query/interfaces/query.js

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

package/query/interfaces/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"./","sources":["query/interfaces/query.ts"],"names":[],"mappings":""}