@wildo-ai/saas-backend-lib 1.0.1

package/dist/esm/databases/services/aggregation/aggregation-query.backend.service.d.ts

@@ -0,0 +1,110 @@
+/** ──────────────────────────────────────────────────────────────
+ * AggregationQueryBackendService — Orchestrator
+ *
+ * Database-agnostic orchestrator that dispatches to the correct
+ * compiler (MongoDB or PostgreSQL) based on the resource's
+ * persistenceAdapter configuration.
+ *
+ * Full pipeline:
+ *   1. Resolve timezone
+ *   2. Validate field access (isBackendOnly, isHidden rules)
+ *   3. Authorize (LIST role check, scope filter injection, context filter resolution)
+ *      + Join authorization (LIST check on joined resources, scope injection)
+ *   4. Compile → AggregationExpression (joins, having, binning, window functions)
+ *   5. Dispatch to MongoDB compiler → pipeline, or PostgreSQL compiler → SQL
+ *   6. Execute against the appropriate database → sparse rows
+ *   7. Top-N with "Other" bucket (reduces dimension cardinality)
+ *   8. Densify time-series
+ *   9. Computed measures (expr-eval, in-memory)
+ *  10. Window functions — in-memory fallback (PostgreSQL handles all in-DB)
+ *  11. Return { data, queryMeta }
+ * ────────────────────────────────────────────────────────────── */
+import type { LoggerService } from '../../../monitoring/logger/services/logger.service.js';
+import type { MongoDBService } from '../../../databases/services/mongodb.service.js';
+import type { ResourcesRegistryBackendService } from '../../../resources/services/resources-registry.backend.service.js';
+import { MongoAggregationCompilerBackendService } from '../../../databases/services/mongo-aggregation.backend.service.js';
+import { PostgreSQLAggregationCompilerBackendService } from '../../../databases/services/postgresql-aggregation.backend.service.js';
+import type { PostgreSQLDatabaseBackendService } from '../../../databases/services/postgresql-database.backend.service.js';
+import { FieldAccessValidatorBackendService } from './field-access-validator.backend.service.js';
+import { AggregationAuthorizationBackendService } from './aggregation-authorization.backend.service.js';
+import { TimeSeriesDensifierBackendService } from './time-series-densifier.backend.service.js';
+import { ComputedMeasureEvaluatorBackendService } from './computed-measure-evaluator.backend.service.js';
+import { WindowFunctionProcessorBackendService } from './window-function-processor.backend.service.js';
+import { TopNProcessorBackendService } from './topn-processor.backend.service.js';
+import type { ExecutionContext } from '../../../runtime/models/execution-context.backend.schemas.js';
+import type { ErrorBuilderBackendService } from '../../../errors/services/error-builder.backend.service.js';
+import type { AggregationQuery, AggregationQueryResponse } from '@wildo-ai/saas-models';
+/** Options for the aggregation query execution */
+export interface AggregationQueryOptions {
+    /** Execution context (required for authorized execution) */
+    executionContext?: ExecutionContext<any>;
+    /** Optional chart-level role restriction */
+    chartRoles?: string[];
+    /** URL param values (for context filter resolution) */
+    urlParams?: Record<string, string>;
+    /** Parent resource context (for context filter resolution) */
+    parentResource?: Record<string, unknown>;
+    /** Skip authorization (for system-level queries) */
+    skipAuthorization?: boolean;
+}
+export declare class AggregationQueryBackendService {
+    private readonly logger;
+    private readonly errorBuilder;
+    private readonly mongoService;
+    private readonly resourceRegistry;
+    private readonly mongoCompiler;
+    private readonly pgCompiler;
+    private readonly pgDatabaseService;
+    private readonly fieldAccessValidator;
+    private readonly authorizationService;
+    private readonly timeSeriesDensifier;
+    private readonly computedMeasureEvaluator;
+    private readonly windowFunctionProcessor;
+    private readonly topNProcessor;
+    constructor(logger: LoggerService, errorBuilder: ErrorBuilderBackendService, mongoService: MongoDBService, resourceRegistry: ResourcesRegistryBackendService, mongoCompiler: MongoAggregationCompilerBackendService, pgCompiler: PostgreSQLAggregationCompilerBackendService, pgDatabaseService: PostgreSQLDatabaseBackendService | null, fieldAccessValidator: FieldAccessValidatorBackendService, authorizationService: AggregationAuthorizationBackendService, timeSeriesDensifier: TimeSeriesDensifierBackendService, computedMeasureEvaluator: ComputedMeasureEvaluatorBackendService, windowFunctionProcessor: WindowFunctionProcessorBackendService, topNProcessor: TopNProcessorBackendService);
+    /**
+     * Execute an aggregation query with full pipeline:
+     * timezone → field validation → authorization → compile → execute →
+     * densify → computed measures → window functions → response
+     */
+    execute(query: AggregationQuery, options?: AggregationQueryOptions): Promise<AggregationQueryResponse>;
+    /**
+     * Determine which window functions need in-memory processing.
+     * Functions already handled in-DB by $setWindowFields are excluded.
+     */
+    private getInMemoryWindowFunctions;
+    /**
+     * Determine which database a resource is stored in.
+     * Reads the resource configuration's `persistenceAdapter` field.
+     */
+    private resolveResourceDatabaseType;
+    private resolveTimezone;
+    private compileToExpression;
+    private resolveCollectionName;
+    private resolveFieldRef;
+    /**
+     * Resolve a single join definition to an AST node.
+     * Maps resource type → target collection, determines PK field, attaches auth filter.
+     *
+     * Note: foreignKeyField lives on the **source** (main) resource, not the target,
+     * so we resolve it against mainResourceType.
+     */
+    private resolveJoin;
+    /**
+     * Authorize cross-resource joins: for each join, the user must have LIST access
+     * on the joined resource. Same scope filter logic applies.
+     *
+     * Returns a map of alias → auth filter for each join.
+     */
+    private authorizeJoins;
+    private executePipeline;
+    /**
+     * Execute a parameterized SQL aggregation query against PostgreSQL.
+     *
+     * Uses the PostgreSQLDatabaseBackendService (Kysely) to get a connection.
+     * Wraps execution in a transaction so that SET LOCAL statement_timeout
+     * takes effect (SET LOCAL only applies within a transaction block).
+     */
+    private executeSqlQuery;
+}
+//# sourceMappingURL=aggregation-query.backend.service.d.ts.map

package/dist/esm/databases/services/aggregation/aggregation-query.backend.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregation-query.backend.service.d.ts","sourceRoot":"","sources":["../../../../../src/databases/services/aggregation/aggregation-query.backend.service.ts"],"names":[],"mappings":"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"}

package/dist/esm/databases/services/aggregation/aggregation-query.backend.service.js

@@ -0,0 +1,444 @@
+/** ──────────────────────────────────────────────────────────────
+ * AggregationQueryBackendService — Orchestrator
+ *
+ * Database-agnostic orchestrator that dispatches to the correct
+ * compiler (MongoDB or PostgreSQL) based on the resource's
+ * persistenceAdapter configuration.
+ *
+ * Full pipeline:
+ *   1. Resolve timezone
+ *   2. Validate field access (isBackendOnly, isHidden rules)
+ *   3. Authorize (LIST role check, scope filter injection, context filter resolution)
+ *      + Join authorization (LIST check on joined resources, scope injection)
+ *   4. Compile → AggregationExpression (joins, having, binning, window functions)
+ *   5. Dispatch to MongoDB compiler → pipeline, or PostgreSQL compiler → SQL
+ *   6. Execute against the appropriate database → sparse rows
+ *   7. Top-N with "Other" bucket (reduces dimension cardinality)
+ *   8. Densify time-series
+ *   9. Computed measures (expr-eval, in-memory)
+ *  10. Window functions — in-memory fallback (PostgreSQL handles all in-DB)
+ *  11. Return { data, queryMeta }
+ * ────────────────────────────────────────────────────────────── */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { injectable, inject, optional } from 'inversify';
+import { sql as kyselySql, CompiledQuery } from 'kysely';
+import { SAAS_SERVICE_TYPES } from '../../../inject/models/service-types.js';
+import { MongoAggregationCompilerBackendService } from '../../../databases/services/mongo-aggregation.backend.service.js';
+import { PostgreSQLAggregationCompilerBackendService } from '../../../databases/services/postgresql-aggregation.backend.service.js';
+import { AggregationQuerySchema, DEFAULT_PERSISTENCE_ADAPTER, ErrorType, ErrorCustomMessageReference, } from '@wildo-ai/saas-models';
+import { FieldAccessValidatorBackendService } from './field-access-validator.backend.service.js';
+import { AggregationAuthorizationBackendService } from './aggregation-authorization.backend.service.js';
+import { TimeSeriesDensifierBackendService } from './time-series-densifier.backend.service.js';
+import { ComputedMeasureEvaluatorBackendService } from './computed-measure-evaluator.backend.service.js';
+import { WindowFunctionProcessorBackendService } from './window-function-processor.backend.service.js';
+import { TopNProcessorBackendService } from './topn-processor.backend.service.js';
+import { AggregateFunction } from '@wildo-ai/saas-models';
+const DEFAULT_TIMEZONE = 'UTC';
+const DEFAULT_TIMEOUT_MS = 30_000;
+let AggregationQueryBackendService = class AggregationQueryBackendService {
+    logger;
+    errorBuilder;
+    mongoService;
+    resourceRegistry;
+    mongoCompiler;
+    pgCompiler;
+    pgDatabaseService;
+    fieldAccessValidator;
+    authorizationService;
+    timeSeriesDensifier;
+    computedMeasureEvaluator;
+    windowFunctionProcessor;
+    topNProcessor;
+    constructor(logger, errorBuilder, mongoService, resourceRegistry, mongoCompiler, pgCompiler, pgDatabaseService, fieldAccessValidator, authorizationService, timeSeriesDensifier, computedMeasureEvaluator, windowFunctionProcessor, topNProcessor) {
+        this.logger = logger;
+        this.errorBuilder = errorBuilder;
+        this.mongoService = mongoService;
+        this.resourceRegistry = resourceRegistry;
+        this.mongoCompiler = mongoCompiler;
+        this.pgCompiler = pgCompiler;
+        this.pgDatabaseService = pgDatabaseService;
+        this.fieldAccessValidator = fieldAccessValidator;
+        this.authorizationService = authorizationService;
+        this.timeSeriesDensifier = timeSeriesDensifier;
+        this.computedMeasureEvaluator = computedMeasureEvaluator;
+        this.windowFunctionProcessor = windowFunctionProcessor;
+        this.topNProcessor = topNProcessor;
+    }
+    /**
+     * Execute an aggregation query with full pipeline:
+     * timezone → field validation → authorization → compile → execute →
+     * densify → computed measures → window functions → response
+     */
+    async execute(query, options = {}) {
+        const startTime = Date.now();
+        const parsedQuery = AggregationQuerySchema.parse(query);
+        // 1. Resolve timezone
+        const timezone = this.resolveTimezone(parsedQuery, options.executionContext);
+        // 2. Validate field access (isBackendOnly, isHidden rules)
+        this.fieldAccessValidator.validate(parsedQuery);
+        // 3. Authorize (LIST role check, scope filters, context filters)
+        let resolvedFilter;
+        let joinAuthFilters;
+        if (!options.skipAuthorization && !options.executionContext) {
+            throw this.errorBuilder.buildError(ErrorType.AUTHORIZATION, undefined, {
+                customMessageReference: ErrorCustomMessageReference.AUTHORIZATION,
+                context: {
+                    message: 'Aggregation execution requires an executionContext unless skipAuthorization is explicitly enabled.',
+                },
+            });
+        }
+        if (!options.skipAuthorization && options.executionContext) {
+            const authInput = {
+                query: parsedQuery,
+                executionContext: options.executionContext,
+                chartRoles: options.chartRoles,
+                urlParams: options.urlParams,
+                parentResource: options.parentResource,
+            };
+            const authResult = this.authorizationService.authorize(authInput);
+            resolvedFilter = authResult.resolvedFilter;
+            // 3b. Authorize cross-resource joins (LIST check + scope filters on each joined resource)
+            if (parsedQuery.joins && parsedQuery.joins.length > 0) {
+                joinAuthFilters = this.authorizeJoins(parsedQuery.joins, options);
+            }
+        }
+        else {
+            // No authorization — use static filters as-is
+            resolvedFilter = parsedQuery.filters;
+        }
+        // 4. Compile to AggregationExpression (joins, having, binning, window functions)
+        const expression = this.compileToExpression(parsedQuery, timezone, resolvedFilter, joinAuthFilters);
+        // 5. Determine database type and dispatch to the correct compiler + executor
+        const dbType = this.resolveResourceDatabaseType(parsedQuery.mainResourceType);
+        let data;
+        if (dbType === 'postgresql') {
+            // 5a. Build SQL query
+            const sqlQuery = this.pgCompiler.compile(expression);
+            // 5b. Execute against PostgreSQL
+            data = await this.executeSqlQuery(sqlQuery);
+        }
+        else {
+            // 5a. Build MongoDB pipeline
+            const pipeline = this.mongoCompiler.compile(expression);
+            // 5b. Execute against MongoDB → sparse rows
+            data = await this.executePipeline(pipeline);
+        }
+        // 6. Top-N with "Other" bucket (reduces dimension cardinality before densification)
+        data = this.topNProcessor.process(data, parsedQuery);
+        // 7. Densify time-series (fill missing buckets)
+        data = this.timeSeriesDensifier.densify({
+            query: parsedQuery,
+            data,
+            resolvedFilter,
+            timezone,
+        });
+        // 8. Computed measures (expr-eval, in-memory)
+        if (parsedQuery.computedMeasures && parsedQuery.computedMeasures.length > 0) {
+            data = this.computedMeasureEvaluator.evaluate(data, parsedQuery.computedMeasures);
+        }
+        // 9. Window functions — in-memory fallback for those not handled in-DB
+        const inMemoryWindowFunctions = this.getInMemoryWindowFunctions(parsedQuery.windowFunctions || [], dbType);
+        if (inMemoryWindowFunctions.length > 0) {
+            data = this.windowFunctionProcessor.process(data, inMemoryWindowFunctions);
+        }
+        // 11. Build response
+        const executionTimeMs = Date.now() - startTime;
+        return {
+            data,
+            queryMeta: {
+                executionTimeMs,
+                totalRows: data.length,
+                truncated: parsedQuery.limit != null && data.length >= parsedQuery.limit,
+                resolvedTimezone: timezone,
+            },
+        };
+    }
+    // ── Window Function Routing ───────────────────────────────
+    /**
+     * Determine which window functions need in-memory processing.
+     * Functions already handled in-DB by $setWindowFields are excluded.
+     */
+    getInMemoryWindowFunctions(windowFunctions, dbType = 'mongodb') {
+        if (windowFunctions.length === 0)
+            return [];
+        const inDbTypes = dbType === 'postgresql'
+            ? this.pgCompiler.getInDbWindowTypes()
+            : this.mongoCompiler.getInDbWindowTypes();
+        return windowFunctions.filter(wf => !inDbTypes.has(wf.type));
+    }
+    /**
+     * Determine which database a resource is stored in.
+     * Reads the resource configuration's `persistenceAdapter` field.
+     */
+    resolveResourceDatabaseType(resourceType) {
+        try {
+            const config = this.resourceRegistry.getResourceConfiguration(resourceType);
+            // persistenceAdapter may not be on every config type definition yet,
+            // use safe property access via Record to avoid unsafe `as any`
+            const persistenceAdapter = config['persistenceAdapter'];
+            if (typeof persistenceAdapter === 'string' && (persistenceAdapter === 'mongodb' || persistenceAdapter === 'postgresql')) {
+                return persistenceAdapter;
+            }
+            return DEFAULT_PERSISTENCE_ADAPTER;
+        }
+        catch {
+            this.logger.warn(`AggregationQueryService: could not resolve DB type for '${resourceType}', defaulting to ${DEFAULT_PERSISTENCE_ADAPTER}`);
+            return DEFAULT_PERSISTENCE_ADAPTER;
+        }
+    }
+    // ── Timezone Resolution ────────────────────────────────────
+    resolveTimezone(query, executionContext) {
+        // Priority: query explicit → session/org timezone → UTC fallback
+        if (query.timezone)
+            return query.timezone;
+        // TODO(Milestone B+): Extract user timezone from session, then org timezone from org settings
+        // For now, use executionContext if available, otherwise default
+        if (executionContext) {
+            // Future: executionContext.sessionTimezone ?? executionContext.orgTimezone
+        }
+        return DEFAULT_TIMEZONE;
+    }
+    // ── Expression Compilation ─────────────────────────────────
+    compileToExpression(query, timezone, resolvedFilter, joinAuthFilters) {
+        // Resolve resource type → collection name
+        const collectionName = this.resolveCollectionName(query.mainResourceType);
+        // Collect known join aliases for field reference validation
+        const knownJoinAliases = new Set((query.joins || []).map(j => j.alias));
+        // Map dimensions
+        const dimensions = query.dimensions.map(dim => ({
+            ref: dim.ref,
+            field: this.resolveFieldRef(dim.field, query.mainResourceType, knownJoinAliases),
+            label: dim.label,
+            timeGranularity: dim.timeGranularity,
+            fillMissingBuckets: dim.fillMissingBuckets,
+            dateRange: dim.dateRange,
+            bin: dim.bin,
+            sort: dim.sort,
+            topN: dim.topN,
+            groupOther: dim.groupOther,
+        }));
+        // Map measures
+        const measures = query.measures.map(measure => ({
+            ref: measure.ref,
+            field: this.resolveFieldRef(measure.field, query.mainResourceType, knownJoinAliases),
+            aggregate: measure.aggregate,
+            label: measure.label,
+            percentileValue: measure.percentileValue,
+            separator: measure.separator,
+            arrayLimit: measure.arrayLimit,
+            filter: measure.filter,
+        }));
+        // Map window functions → AST nodes
+        const windowFunctions = (query.windowFunctions || []).map(wf => ({
+            ref: wf.ref,
+            label: wf.label,
+            sourceRef: wf.sourceRef,
+            type: wf.type,
+            windowSize: wf.windowSize,
+            partitionBy: wf.partitionBy,
+            orderBy: wf.orderBy,
+        }));
+        // Map joins → AST nodes (resolve target collection, PK field, auth filters)
+        const joins = (query.joins || []).map(join => this.resolveJoin(join, query.mainResourceType, joinAuthFilters));
+        // Map having → AST nodes
+        const having = (query.having || []).map(h => ({
+            measureRef: h.measureRef,
+            operator: h.operator,
+            value: h.value,
+        }));
+        // Map orderBy
+        const orderBy = (query.orderBy || []).map(ob => ({
+            ref: ob.ref,
+            direction: ob.direction,
+        }));
+        return {
+            collection: collectionName,
+            resourceType: query.mainResourceType,
+            dimensions,
+            measures,
+            filter: resolvedFilter || query.filters,
+            joins,
+            windowFunctions,
+            having,
+            orderBy,
+            limit: query.limit,
+            timezone,
+            timeoutMs: query.timeoutMs ?? DEFAULT_TIMEOUT_MS,
+        };
+    }
+    // ── Collection Name Resolution ─────────────────────────────
+    resolveCollectionName(resourceType) {
+        try {
+            const config = this.resourceRegistry.getResourceConfiguration(resourceType);
+            return config.resourceFieldIdentifier;
+        }
+        catch {
+            // Fallback: lowercase the resource type
+            this.logger.warn(`AggregationQueryService: Could not resolve collection for '${resourceType}', using lowercase fallback`);
+            return resourceType.toLowerCase();
+        }
+    }
+    // ── Field Reference Resolution ─────────────────────────────
+    resolveFieldRef(field, resourceType, knownJoinAliases) {
+        // Direct field mapping (field name = physical path in MongoDB)
+        // Joined fields use dot notation: "alias.field" → physical path is "alias.field"
+        const isJoined = field.includes('.');
+        const joinAlias = isJoined ? field.split('.')[0] : undefined;
+        // Validate that joined field aliases reference a declared join
+        if (isJoined && joinAlias && knownJoinAliases && !knownJoinAliases.has(joinAlias)) {
+            this.logger.warn(`AggregationQueryService: field '${field}' references alias '${joinAlias}' ` +
+                `which is not a declared join. Available aliases: [${[...knownJoinAliases].join(', ')}]`);
+        }
+        return {
+            logicalName: field,
+            physicalPath: field,
+            resourceType,
+            isJoined,
+            joinAlias,
+        };
+    }
+    // ── Join Resolution ───────────────────────────────────────
+    /**
+     * Resolve a single join definition to an AST node.
+     * Maps resource type → target collection, determines PK field, attaches auth filter.
+     *
+     * Note: foreignKeyField lives on the **source** (main) resource, not the target,
+     * so we resolve it against mainResourceType.
+     */
+    resolveJoin(join, mainResourceType, joinAuthFilters) {
+        const targetCollection = this.resolveCollectionName(join.resourceType);
+        // Determine the correct PK field for the target resource based on its database type.
+        // MongoDB uses `_id`, PostgreSQL typically uses `id`.
+        const targetDbType = this.resolveResourceDatabaseType(join.resourceType);
+        const targetPkField = targetDbType === 'postgresql' ? 'id' : '_id';
+        return {
+            targetCollection,
+            targetResourceType: join.resourceType,
+            foreignKeyField: this.resolveFieldRef(join.foreignKeyField, mainResourceType),
+            targetPkField,
+            alias: join.alias,
+            selectFields: join.selectFields,
+            joinType: join.joinType,
+            authFilter: joinAuthFilters?.get(join.alias),
+        };
+    }
+    // ── Join Authorization ────────────────────────────────────
+    /**
+     * Authorize cross-resource joins: for each join, the user must have LIST access
+     * on the joined resource. Same scope filter logic applies.
+     *
+     * Returns a map of alias → auth filter for each join.
+     */
+    authorizeJoins(joins, options) {
+        const result = new Map();
+        for (const join of joins) {
+            // Build a minimal query for the joined resource to check LIST authorization
+            const joinAuthInput = {
+                query: {
+                    mainResourceType: join.resourceType,
+                    dimensions: [{ ref: '_id', field: '_id' }], // Minimal — just need to check LIST access
+                    measures: [{ ref: '_count', field: '*', aggregate: AggregateFunction.COUNT }],
+                },
+                executionContext: options.executionContext,
+                chartRoles: options.chartRoles,
+                urlParams: options.urlParams,
+                parentResource: options.parentResource,
+            };
+            try {
+                const authResult = this.authorizationService.authorize(joinAuthInput);
+                if (authResult.resolvedFilter && Object.keys(authResult.resolvedFilter).length > 0) {
+                    result.set(join.alias, authResult.resolvedFilter);
+                }
+            }
+            catch (error) {
+                this.logger.error(`AggregationQueryService: join authorization failed for resource '${join.resourceType}' (alias: '${join.alias}')`);
+                throw error;
+            }
+        }
+        return result;
+    }
+    // ── Pipeline Execution ─────────────────────────────────────
+    async executePipeline(pipeline) {
+        const db = this.mongoService.getDatabase();
+        const collection = db.collection(pipeline.collection);
+        this.logger.debug(`AggregationQueryService: executing ${pipeline.stages.length}-stage pipeline on '${pipeline.collection}' (maxTimeMS: ${pipeline.maxTimeMS})`);
+        const cursor = collection.aggregate(pipeline.stages, {
+            maxTimeMS: pipeline.maxTimeMS,
+        });
+        const results = await cursor.toArray();
+        return results;
+    }
+    /**
+     * Execute a parameterized SQL aggregation query against PostgreSQL.
+     *
+     * Uses the PostgreSQLDatabaseBackendService (Kysely) to get a connection.
+     * Wraps execution in a transaction so that SET LOCAL statement_timeout
+     * takes effect (SET LOCAL only applies within a transaction block).
+     */
+    async executeSqlQuery(sqlQuery) {
+        if (!this.pgDatabaseService) {
+            throw this.errorBuilder.buildError(ErrorType.CONFIGURATION, undefined, {
+                customMessageReference: ErrorCustomMessageReference.CONFIGURATION,
+                context: {
+                    message: 'PostgreSQL aggregation requested but PostgreSQLDatabaseService is not available',
+                    table: sqlQuery.table,
+                    hint: 'Ensure PostgreSQL is enabled in the database config',
+                },
+            });
+        }
+        const timeoutMs = Math.floor(Number(sqlQuery.statementTimeoutMs) || DEFAULT_TIMEOUT_MS);
+        this.logger.debug(`AggregationQueryService: executing SQL query on '${sqlQuery.table}' ` +
+            `(${sqlQuery.params.length} params, timeout: ${timeoutMs}ms)`);
+        const db = await this.pgDatabaseService.getDb();
+        // Wrap in a transaction so SET LOCAL statement_timeout takes effect.
+        // Without a transaction, SET LOCAL has no effect in PostgreSQL.
+        return await db.transaction().execute(async (trx) => {
+            // Set the statement timeout for this transaction
+            // Use tagged template — Kysely auto-parameterizes the embedded value
+            await kyselySql `SET LOCAL statement_timeout = ${timeoutMs}`.execute(trx);
+            // Execute the pre-built SQL with positional $N params.
+            // CompiledQuery.raw() creates a CompiledQuery from a raw SQL string + params,
+            // which can then be executed directly via Kysely's executeQuery().
+            const compiledQuery = CompiledQuery.raw(sqlQuery.sql, [...sqlQuery.params]);
+            const result = await trx.executeQuery(compiledQuery);
+            return [...result.rows];
+        });
+    }
+};
+AggregationQueryBackendService = __decorate([
+    injectable(),
+    __param(0, inject(SAAS_SERVICE_TYPES.Logger)),
+    __param(1, inject(SAAS_SERVICE_TYPES.ErrorBuilderService)),
+    __param(2, inject(SAAS_SERVICE_TYPES.MongoDBService)),
+    __param(3, inject(SAAS_SERVICE_TYPES.ResourceRegistryService)),
+    __param(4, inject(SAAS_SERVICE_TYPES.MongoAggregationCompiler)),
+    __param(5, inject(SAAS_SERVICE_TYPES.PostgreSQLAggregationCompiler)),
+    __param(6, inject(SAAS_SERVICE_TYPES.PostgreSQLDatabaseService)),
+    __param(6, optional()),
+    __param(7, inject(SAAS_SERVICE_TYPES.FieldAccessValidator)),
+    __param(8, inject(SAAS_SERVICE_TYPES.AggregationAuthorizationService)),
+    __param(9, inject(SAAS_SERVICE_TYPES.TimeSeriesDensifier)),
+    __param(10, inject(SAAS_SERVICE_TYPES.ComputedMeasureEvaluator)),
+    __param(11, inject(SAAS_SERVICE_TYPES.WindowFunctionProcessor)),
+    __param(12, inject(SAAS_SERVICE_TYPES.TopNProcessor)),
+    __metadata("design:paramtypes", [Function, Function, Function, Function, MongoAggregationCompilerBackendService,
+        PostgreSQLAggregationCompilerBackendService, Function, FieldAccessValidatorBackendService,
+        AggregationAuthorizationBackendService,
+        TimeSeriesDensifierBackendService,
+        ComputedMeasureEvaluatorBackendService,
+        WindowFunctionProcessorBackendService,
+        TopNProcessorBackendService])
+], AggregationQueryBackendService);
+export { AggregationQueryBackendService };
+//# sourceMappingURL=aggregation-query.backend.service.js.map

package/dist/esm/databases/services/aggregation/aggregation-query.backend.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregation-query.backend.service.js","sourceRoot":"","sources":["../../../../../src/databases/services/aggregation/aggregation-query.backend.service.ts"],"names":[],"mappings":"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"}

package/dist/esm/databases/services/aggregation/computed-measure-evaluator.backend.service.d.ts

@@ -0,0 +1,38 @@
+/** ──────────────────────────────────────────────────────────────
+ * ComputedMeasureEvaluatorBackendService
+ *
+ * Post-aggregation computed measures using expr-eval safe parser.
+ * Expressions reference measure refs as variables and are evaluated
+ * per result row. No eval(), no string interpolation.
+ *
+ * Features:
+ *   - Parse-once / evaluate-many pattern (expressions compiled on first use)
+ *   - Built-in functions: round, abs, coalesce, min, max, if
+ *   - Division-by-zero safe (returns null, not Infinity/NaN)
+ *   - dependsOn validation (all referenced measures must exist in the row)
+ *
+ * Ref: expr-eval parser spec → L450-474
+ * Ref: ComputedMeasureSchema → L664-683
+ * Ref: Pipeline position → L409 (step 9, after densification)
+ * ────────────────────────────────────────────────────────────── */
+import type { LoggerService } from '../../../monitoring/logger/services/logger.service.js';
+import type { AggregationQueryResponseRow, ComputedMeasure } from '@wildo-ai/saas-models';
+export declare class ComputedMeasureEvaluatorBackendService {
+    private readonly logger;
+    /** Shared parser instance with registered built-in functions */
+    private readonly parser;
+    /** Cache of parsed expressions keyed by expression string */
+    private readonly expressionCache;
+    constructor(logger: LoggerService);
+    /**
+     * Evaluate all computed measures against result rows.
+     * Each computed measure adds a new field (keyed by `ref`) to every row.
+     * Returns the mutated rows array (same reference, augmented in place).
+     */
+    evaluate(data: AggregationQueryResponseRow[], computedMeasures: ComputedMeasure[]): AggregationQueryResponseRow[];
+    private createParser;
+    private parseExpressions;
+    private buildVariables;
+    private sanitizeResult;
+}
+//# sourceMappingURL=computed-measure-evaluator.backend.service.d.ts.map

package/dist/esm/databases/services/aggregation/computed-measure-evaluator.backend.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"computed-measure-evaluator.backend.service.d.ts","sourceRoot":"","sources":["../../../../../src/databases/services/aggregation/computed-measure-evaluator.backend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;oEAgBoE;AAKpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8DAA8D,CAAC;AAClG,OAAO,KAAK,EACV,2BAA2B,EAC3B,eAAe,EAChB,MAAM,uBAAuB,CAAC;AAE/B,qBACa,sCAAsC;IAOZ,OAAO,CAAC,QAAQ,CAAC,MAAM;IAN5D,gEAAgE;IAChE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,6DAA6D;IAC7D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiC;gBAGX,MAAM,EAAE,aAAa;IAK3E;;;;OAIG;IACH,QAAQ,CACN,IAAI,EAAE,2BAA2B,EAAE,EACnC,gBAAgB,EAAE,eAAe,EAAE,GAClC,2BAA2B,EAAE;IAuChC,OAAO,CAAC,YAAY;IA+CpB,OAAO,CAAC,gBAAgB;IAwBxB,OAAO,CAAC,cAAc;IAgCtB,OAAO,CAAC,cAAc;CAKvB"}