@freshguard/freshguard-core 0.11.2

package/dist/monitor/baseline-calculator.js

@@ -0,0 +1,192 @@
+import { MonitoringError } from '../errors/index.js';
+export class BaselineCalculator {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    calculateBaseline(historicalData, currentRowCount) {
+        const dataPoints = this.convertToDataPoints(historicalData);
+        const filteredData = this.filterData(dataPoints);
+        if (filteredData.length < this.config.minimumDataPoints) {
+            return {
+                mean: currentRowCount,
+                deviationPercent: 0,
+                dataPointsUsed: filteredData.length,
+                calculationMethod: this.config.calculationMethod,
+                seasonalAdjusted: false,
+            };
+        }
+        try {
+            const adjustedData = this.config.seasonalAdjustment
+                ? this.applySeasonalAdjustment(filteredData)
+                : filteredData;
+            const seasonalAdjustmentApplied = this.config.seasonalAdjustment && filteredData.length >= 14;
+            const baseline = this.calculateStatistic(adjustedData);
+            const adjustedCurrentRowCount = seasonalAdjustmentApplied
+                ? this.adjustCurrentValueForSeason(filteredData, currentRowCount)
+                : currentRowCount;
+            const deviationPercent = this.calculateDeviation(baseline, adjustedCurrentRowCount);
+            return {
+                mean: Math.round(baseline),
+                deviationPercent: Math.round(deviationPercent * 100) / 100,
+                dataPointsUsed: adjustedData.length,
+                calculationMethod: this.config.calculationMethod,
+                seasonalAdjusted: seasonalAdjustmentApplied,
+            };
+        }
+        catch (error) {
+            return {
+                mean: currentRowCount,
+                deviationPercent: 0,
+                dataPointsUsed: filteredData.length,
+                calculationMethod: 'fallback',
+                seasonalAdjusted: false,
+            };
+        }
+    }
+    convertToDataPoints(executions) {
+        return executions
+            .filter(e => e.rowCount !== undefined && e.executedAt)
+            .map(e => ({
+            rowCount: e.rowCount,
+            executedAt: e.executedAt,
+        }));
+    }
+    filterData(dataPoints) {
+        if (!this.config.excludeWeekends) {
+            return dataPoints;
+        }
+        return dataPoints.filter(point => {
+            const dayOfWeek = point.executedAt.getDay();
+            return dayOfWeek !== 0 && dayOfWeek !== 6;
+        });
+    }
+    applySeasonalAdjustment(dataPoints) {
+        if (dataPoints.length < 14) {
+            return dataPoints;
+        }
+        const dayOfWeekStats = this.calculateDayOfWeekStats(dataPoints);
+        const overallMean = this.calculateMean(dataPoints.map(p => p.rowCount));
+        const adjustedPoints = dataPoints.map(point => {
+            const dayOfWeek = point.executedAt.getDay();
+            const dayStats = dayOfWeekStats[dayOfWeek];
+            if (!dayStats || dayStats.count < 2) {
+                return point;
+            }
+            const dayFactor = overallMean / dayStats.mean;
+            const adjustedRowCount = point.rowCount * dayFactor;
+            return {
+                ...point,
+                rowCount: adjustedRowCount,
+            };
+        });
+        return adjustedPoints;
+    }
+    adjustCurrentValueForSeason(dataPoints, currentRowCount) {
+        if (dataPoints.length < 14) {
+            return currentRowCount;
+        }
+        const dayOfWeekStats = this.calculateDayOfWeekStats(dataPoints);
+        const overallMean = this.calculateMean(dataPoints.map(p => p.rowCount));
+        const currentDayOfWeek = new Date().getDay();
+        const currentDayStats = dayOfWeekStats[currentDayOfWeek];
+        if (!currentDayStats || currentDayStats.count < 2) {
+            return currentRowCount;
+        }
+        const dayFactor = overallMean / currentDayStats.mean;
+        const adjustedCurrentRowCount = currentRowCount * dayFactor;
+        return adjustedCurrentRowCount;
+    }
+    calculateDayOfWeekStats(dataPoints) {
+        const stats = {};
+        dataPoints.forEach(point => {
+            const dayOfWeek = point.executedAt.getDay();
+            if (!stats[dayOfWeek]) {
+                stats[dayOfWeek] = { mean: 0, count: 0 };
+            }
+            stats[dayOfWeek].mean += point.rowCount;
+            stats[dayOfWeek].count += 1;
+        });
+        Object.values(stats).forEach(stat => {
+            if (stat.count > 0) {
+                stat.mean = stat.mean / stat.count;
+            }
+        });
+        return stats;
+    }
+    calculateStatistic(dataPoints) {
+        const values = dataPoints.map(p => p.rowCount);
+        this.validateValues(values);
+        switch (this.config.calculationMethod) {
+            case 'mean':
+                return this.calculateMean(values);
+            case 'median':
+                return this.calculateMedian(values);
+            case 'trimmed_mean':
+                return this.calculateTrimmedMean(values, this.config.trimmedMeanPercentile);
+            default:
+                throw new MonitoringError(`Unknown calculation method: ${this.config.calculationMethod}`, 'volume', undefined, undefined);
+        }
+    }
+    validateValues(values) {
+        if (values.length === 0) {
+            throw new MonitoringError('No valid data points for baseline calculation', 'volume');
+        }
+        if (values.some(value => isNaN(value) || value < 0)) {
+            throw new MonitoringError('Invalid row count values detected', 'volume');
+        }
+    }
+    calculateMean(values) {
+        const sum = values.reduce((a, b) => {
+            const result = a + b;
+            if (result > Number.MAX_SAFE_INTEGER) {
+                throw new MonitoringError('Statistical calculation overflow', 'volume');
+            }
+            return result;
+        }, 0);
+        return sum / values.length;
+    }
+    calculateMedian(values) {
+        const sorted = [...values].sort((a, b) => a - b);
+        const mid = Math.floor(sorted.length / 2);
+        if (sorted.length % 2 === 0) {
+            const left = sorted[mid - 1];
+            const right = sorted[mid];
+            if (left === undefined || right === undefined) {
+                throw new MonitoringError('Invalid data for median calculation', 'volume');
+            }
+            return (left + right) / 2;
+        }
+        else {
+            const middle = sorted[mid];
+            if (middle === undefined) {
+                throw new MonitoringError('Invalid data for median calculation', 'volume');
+            }
+            return middle;
+        }
+    }
+    calculateTrimmedMean(values, trimPercentile) {
+        if (values.length < 4) {
+            return this.calculateMean(values);
+        }
+        const sorted = [...values].sort((a, b) => a - b);
+        const trimCount = Math.floor((sorted.length * trimPercentile) / 100);
+        const trimmedValues = sorted.slice(trimCount, sorted.length - trimCount);
+        if (trimmedValues.length === 0) {
+            return this.calculateMean(values);
+        }
+        return this.calculateMean(trimmedValues);
+    }
+    calculateDeviation(baseline, currentValue) {
+        if (baseline <= 0) {
+            return 0;
+        }
+        const deviation = Math.abs(currentValue - baseline);
+        const deviationPercent = (deviation / baseline) * 100;
+        if (isNaN(deviationPercent) || deviationPercent === Infinity) {
+            return 0;
+        }
+        return deviationPercent;
+    }
+}
+//# sourceMappingURL=baseline-calculator.js.map

package/dist/monitor/baseline-calculator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseline-calculator.js","sourceRoot":"","sources":["../../src/monitor/baseline-calculator.ts"],"names":[],"mappings":"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"}

package/dist/monitor/baseline-config.d.ts

@@ -0,0 +1,37 @@
+import type { MonitoringRule } from '../types.js';
+export interface ResolvedBaselineConfig {
+    windowDays: number;
+    minimumDataPoints: number;
+    timeoutSeconds: number;
+    excludeWeekends: boolean;
+    calculationMethod: 'mean' | 'median' | 'trimmed_mean';
+    trimmedMeanPercentile: number;
+    seasonalAdjustment: boolean;
+    deviationThresholdPercent: number;
+    minimumRowCount: number;
+}
+export declare class BaselineConfigResolver {
+    private readonly config;
+    constructor(rule: MonitoringRule);
+    getConfig(): ResolvedBaselineConfig;
+    getWindowDays(): number;
+    getMinimumDataPoints(): number;
+    getTimeoutSeconds(): number;
+    shouldExcludeWeekends(): boolean;
+    getCalculationMethod(): 'mean' | 'median' | 'trimmed_mean';
+    getTrimmedMeanPercentile(): number;
+    shouldApplySeasonalAdjustment(): boolean;
+    getDeviationThresholdPercent(): number;
+    getMinimumRowCount(): number;
+    private resolveConfiguration;
+    private resolveWindowDays;
+    private validateConfiguration;
+    private validateWindowDays;
+    private validateMinimumDataPoints;
+    private validateTimeoutSeconds;
+    private validateCalculationMethod;
+    private validateTrimmedMeanPercentile;
+    private validateDeviationThresholdPercent;
+    private validateMinimumRowCount;
+}
+//# sourceMappingURL=baseline-config.d.ts.map

package/dist/monitor/baseline-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseline-config.d.ts","sourceRoot":"","sources":["../../src/monitor/baseline-config.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAMlD,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,iBAAiB,EAAE,MAAM,GAAG,QAAQ,GAAG,cAAc,CAAC;IACtD,qBAAqB,EAAE,MAAM,CAAC;IAC9B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,yBAAyB,EAAE,MAAM,CAAC;IAClC,eAAe,EAAE,MAAM,CAAC;CACzB;AAQD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;gBAEpC,IAAI,EAAE,cAAc;IAQhC,SAAS,IAAI,sBAAsB;IAOnC,aAAa,IAAI,MAAM;IAOvB,oBAAoB,IAAI,MAAM;IAO9B,iBAAiB,IAAI,MAAM;IAO3B,qBAAqB,IAAI,OAAO;IAOhC,oBAAoB,IAAI,MAAM,GAAG,QAAQ,GAAG,cAAc;IAO1D,wBAAwB,IAAI,MAAM;IAOlC,6BAA6B,IAAI,OAAO;IAOxC,4BAA4B,IAAI,MAAM;IAOtC,kBAAkB,IAAI,MAAM;IAO5B,OAAO,CAAC,oBAAoB;IAgC5B,OAAO,CAAC,iBAAiB;IAgBzB,OAAO,CAAC,qBAAqB;IAa7B,OAAO,CAAC,kBAAkB;IA+B1B,OAAO,CAAC,yBAAyB;IA+BjC,OAAO,CAAC,sBAAsB;IA+B9B,OAAO,CAAC,yBAAyB;IAgBjC,OAAO,CAAC,6BAA6B;IA4BrC,OAAO,CAAC,iCAAiC;IA+BzC,OAAO,CAAC,uBAAuB;CAmBhC"}

package/dist/monitor/baseline-config.js

@@ -0,0 +1,156 @@
+import { ConfigurationError } from '../errors/index.js';
+export class BaselineConfigResolver {
+    config;
+    constructor(rule) {
+        this.config = this.resolveConfiguration(rule);
+        this.validateConfiguration();
+    }
+    getConfig() {
+        return this.config;
+    }
+    getWindowDays() {
+        return this.config.windowDays;
+    }
+    getMinimumDataPoints() {
+        return this.config.minimumDataPoints;
+    }
+    getTimeoutSeconds() {
+        return this.config.timeoutSeconds;
+    }
+    shouldExcludeWeekends() {
+        return this.config.excludeWeekends;
+    }
+    getCalculationMethod() {
+        return this.config.calculationMethod;
+    }
+    getTrimmedMeanPercentile() {
+        return this.config.trimmedMeanPercentile;
+    }
+    shouldApplySeasonalAdjustment() {
+        return this.config.seasonalAdjustment;
+    }
+    getDeviationThresholdPercent() {
+        return this.config.deviationThresholdPercent;
+    }
+    getMinimumRowCount() {
+        return this.config.minimumRowCount;
+    }
+    resolveConfiguration(rule) {
+        const baselineConfig = rule.baselineConfig || {};
+        const windowDays = this.resolveWindowDays(rule, baselineConfig);
+        const deviationThresholdPercent = rule.deviationThresholdPercent || 20;
+        const minimumRowCount = rule.minimumRowCount || 0;
+        const minimumDataPoints = baselineConfig.minimumDataPoints ?? 3;
+        const timeoutSeconds = baselineConfig.timeoutSeconds ?? 30;
+        const excludeWeekends = baselineConfig.excludeWeekends || false;
+        const calculationMethod = baselineConfig.calculationMethod || 'mean';
+        const trimmedMeanPercentile = baselineConfig.trimmedMeanPercentile || 10;
+        const seasonalAdjustment = baselineConfig.seasonalAdjustment || false;
+        return {
+            windowDays,
+            minimumDataPoints,
+            timeoutSeconds,
+            excludeWeekends,
+            calculationMethod,
+            trimmedMeanPercentile,
+            seasonalAdjustment,
+            deviationThresholdPercent,
+            minimumRowCount,
+        };
+    }
+    resolveWindowDays(rule, baselineConfig) {
+        if (baselineConfig.windowDays !== undefined) {
+            return baselineConfig.windowDays;
+        }
+        if (rule.baselineWindowDays !== undefined) {
+            return rule.baselineWindowDays;
+        }
+        return 30;
+    }
+    validateConfiguration() {
+        this.validateWindowDays();
+        this.validateMinimumDataPoints();
+        this.validateTimeoutSeconds();
+        this.validateCalculationMethod();
+        this.validateTrimmedMeanPercentile();
+        this.validateDeviationThresholdPercent();
+        this.validateMinimumRowCount();
+    }
+    validateWindowDays() {
+        const { windowDays } = this.config;
+        if (typeof windowDays !== 'number' || !Number.isInteger(windowDays)) {
+            throw ConfigurationError.invalidValue('baselineConfig.windowDays', windowDays.toString(), 'integer');
+        }
+        if (windowDays < 1) {
+            throw ConfigurationError.invalidValue('baselineConfig.windowDays', windowDays.toString(), 'positive integer (minimum 1)');
+        }
+        if (windowDays > 365) {
+            throw ConfigurationError.invalidValue('baselineConfig.windowDays', windowDays.toString(), 'integer between 1 and 365');
+        }
+    }
+    validateMinimumDataPoints() {
+        const { minimumDataPoints } = this.config;
+        if (typeof minimumDataPoints !== 'number' || !Number.isInteger(minimumDataPoints)) {
+            throw ConfigurationError.invalidValue('baselineConfig.minimumDataPoints', minimumDataPoints.toString(), 'integer');
+        }
+        if (minimumDataPoints < 1) {
+            throw ConfigurationError.invalidValue('baselineConfig.minimumDataPoints', minimumDataPoints.toString(), 'positive integer (minimum 1)');
+        }
+        if (minimumDataPoints > 1000) {
+            throw ConfigurationError.invalidValue('baselineConfig.minimumDataPoints', minimumDataPoints.toString(), 'integer between 1 and 1000');
+        }
+    }
+    validateTimeoutSeconds() {
+        const { timeoutSeconds } = this.config;
+        if (typeof timeoutSeconds !== 'number' || !Number.isInteger(timeoutSeconds)) {
+            throw ConfigurationError.invalidValue('baselineConfig.timeoutSeconds', timeoutSeconds.toString(), 'integer');
+        }
+        if (timeoutSeconds < 1) {
+            throw ConfigurationError.invalidValue('baselineConfig.timeoutSeconds', timeoutSeconds.toString(), 'positive integer (minimum 1)');
+        }
+        if (timeoutSeconds > 600) {
+            throw ConfigurationError.invalidValue('baselineConfig.timeoutSeconds', timeoutSeconds.toString(), 'integer between 1 and 600');
+        }
+    }
+    validateCalculationMethod() {
+        const { calculationMethod } = this.config;
+        const validMethods = ['mean', 'median', 'trimmed_mean'];
+        if (!validMethods.includes(calculationMethod)) {
+            throw ConfigurationError.invalidValue('baselineConfig.calculationMethod', calculationMethod, 'mean, median, or trimmed_mean');
+        }
+    }
+    validateTrimmedMeanPercentile() {
+        const { trimmedMeanPercentile, calculationMethod } = this.config;
+        if (calculationMethod !== 'trimmed_mean') {
+            return;
+        }
+        if (typeof trimmedMeanPercentile !== 'number') {
+            throw ConfigurationError.invalidValue('baselineConfig.trimmedMeanPercentile', String(trimmedMeanPercentile), 'number');
+        }
+        if (trimmedMeanPercentile < 0 || trimmedMeanPercentile > 50) {
+            throw ConfigurationError.invalidValue('baselineConfig.trimmedMeanPercentile', String(trimmedMeanPercentile), 'number between 0 and 50');
+        }
+    }
+    validateDeviationThresholdPercent() {
+        const { deviationThresholdPercent } = this.config;
+        if (typeof deviationThresholdPercent !== 'number') {
+            throw ConfigurationError.invalidValue('deviationThresholdPercent', String(deviationThresholdPercent), 'number');
+        }
+        if (deviationThresholdPercent < 0) {
+            throw ConfigurationError.invalidValue('deviationThresholdPercent', String(deviationThresholdPercent), 'non-negative number');
+        }
+        if (deviationThresholdPercent > 1000) {
+            throw ConfigurationError.invalidValue('deviationThresholdPercent', String(deviationThresholdPercent), 'number between 0 and 1000');
+        }
+    }
+    validateMinimumRowCount() {
+        const { minimumRowCount } = this.config;
+        if (typeof minimumRowCount !== 'number' || !Number.isInteger(minimumRowCount)) {
+            throw ConfigurationError.invalidValue('minimumRowCount', String(minimumRowCount), 'integer');
+        }
+        if (minimumRowCount < 0) {
+            throw ConfigurationError.invalidValue('minimumRowCount', String(minimumRowCount), 'non-negative integer');
+        }
+    }
+}
+//# sourceMappingURL=baseline-config.js.map

package/dist/monitor/baseline-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseline-config.js","sourceRoot":"","sources":["../../src/monitor/baseline-config.ts"],"names":[],"mappings":"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"}

package/dist/monitor/freshness.d.ts

@@ -0,0 +1,5 @@
+import type { CheckResult, MonitoringRule, FreshGuardConfig } from '../types.js';
+import type { Connector } from '../types/connector.js';
+import type { MetadataStorage } from '../metadata/interface.js';
+export declare function checkFreshness(connector: Connector, rule: MonitoringRule, metadataStorage?: MetadataStorage, config?: FreshGuardConfig): Promise<CheckResult>;
+//# sourceMappingURL=freshness.d.ts.map

package/dist/monitor/freshness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"freshness.d.ts","sourceRoot":"","sources":["../../src/monitor/freshness.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,gBAAgB,EAAe,MAAM,aAAa,CAAC;AAC9F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAoBhE,wBAAsB,cAAc,CAClC,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,cAAc,EACpB,eAAe,CAAC,EAAE,eAAe,EACjC,MAAM,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,WAAW,CAAC,CA2KtB"}

package/dist/monitor/freshness.js

@@ -0,0 +1,239 @@
+import { validateTableName, validateColumnName } from '../validators/index.js';
+import { QueryError, TimeoutError, ConfigurationError, ErrorHandler } from '../errors/index.js';
+import { DebugErrorFactory, mergeDebugConfig } from '../errors/debug-factory.js';
+export async function checkFreshness(connector, rule, metadataStorage, config) {
+    const startTime = Date.now();
+    const debugConfig = mergeDebugConfig(config?.debug);
+    const debugFactory = new DebugErrorFactory(debugConfig);
+    const debugId = `fg-${Date.now().toString(36)}-${Math.random().toString(36).substr(2, 5)}`;
+    try {
+        if (debugConfig.enabled) {
+            console.log(`[DEBUG-${debugId}] Starting freshness check:`, {
+                table: rule.tableName,
+                ruleId: rule.id,
+                timestamp: new Date().toISOString()
+            });
+        }
+        validateFreshnessRule(rule);
+        const timestampColumn = rule.timestampColumn || 'updated_at';
+        const toleranceMinutes = rule.toleranceMinutes || 60;
+        validateTableName(rule.tableName);
+        validateColumnName(timestampColumn);
+        if (toleranceMinutes < 1 || toleranceMinutes > 10080) {
+            throw new ConfigurationError('Tolerance minutes must be between 1 and 10080 (1 week)');
+        }
+        const queryResult = await executeWithTimeout(() => executeFreshnessQuery(connector, rule.tableName, timestampColumn, debugConfig, debugFactory), config?.timeoutMs || 30000, 'Freshness check query timeout');
+        if (!queryResult?.row) {
+            throw new QueryError('Query returned no results', 'freshness_query', rule.tableName);
+        }
+        const { rowCount, lastUpdate } = queryResult;
+        if (isNaN(rowCount) || rowCount < 0) {
+            throw new QueryError('Invalid row count returned from query', 'freshness_query', rule.tableName);
+        }
+        if (rowCount === 0) {
+            const executedAt = new Date();
+            const executionDurationMs = Date.now() - startTime;
+            await saveExecutionResult(metadataStorage, {
+                ruleId: rule.id,
+                status: 'alert',
+                rowCount: 0,
+                executionDurationMs,
+                executedAt,
+                error: 'Table is empty',
+            }, debugConfig);
+            return createSecureCheckResult('alert', {
+                rowCount: 0,
+                error: 'Table is empty',
+                executionDurationMs,
+                executedAt,
+            });
+        }
+        if (!lastUpdate) {
+            const executedAt = new Date();
+            const executionDurationMs = Date.now() - startTime;
+            await saveExecutionResult(metadataStorage, {
+                ruleId: rule.id,
+                status: 'alert',
+                rowCount,
+                executionDurationMs,
+                executedAt,
+                error: 'No timestamp found in specified column',
+            }, debugConfig);
+            return createSecureCheckResult('alert', {
+                rowCount,
+                error: 'No timestamp found in specified column',
+                executionDurationMs,
+                executedAt,
+            });
+        }
+        const currentTime = Date.now();
+        const updateTime = new Date(lastUpdate).getTime();
+        if (updateTime > currentTime + 3600000) {
+            throw new QueryError('Invalid timestamp: future date detected', 'freshness_query', rule.tableName);
+        }
+        const lagMs = currentTime - updateTime;
+        const lagMinutes = Math.floor(lagMs / 60000);
+        const isStale = lagMinutes > toleranceMinutes;
+        const status = isStale ? 'alert' : 'ok';
+        const executedAt = new Date();
+        const executionDurationMs = Date.now() - startTime;
+        const safeLagMinutes = Math.max(0, lagMinutes);
+        await saveExecutionResult(metadataStorage, {
+            ruleId: rule.id,
+            status,
+            rowCount,
+            lagMinutes: safeLagMinutes,
+            executionDurationMs,
+            executedAt,
+        }, debugConfig);
+        return createSecureCheckResult(status, {
+            rowCount,
+            lastUpdate: new Date(lastUpdate),
+            lagMinutes: safeLagMinutes,
+            executionDurationMs,
+            executedAt,
+        });
+    }
+    catch (error) {
+        const userMessage = ErrorHandler.getUserMessage(error);
+        const executedAt = new Date();
+        const executionDurationMs = Date.now() - startTime;
+        if (debugConfig.enabled) {
+            console.error(`[DEBUG-${debugId}] Freshness check failed:`, {
+                table: rule.tableName,
+                ruleId: rule.id,
+                error: userMessage,
+                rawError: debugConfig.exposeRawErrors && error instanceof Error ? error.message : undefined,
+                duration: executionDurationMs
+            });
+        }
+        if (rule?.id) {
+            await saveExecutionResult(metadataStorage, {
+                ruleId: rule.id,
+                status: 'failed',
+                executionDurationMs,
+                executedAt,
+                error: userMessage,
+            }, debugConfig);
+        }
+        const result = createSecureCheckResult('failed', {
+            error: userMessage,
+            executionDurationMs,
+            executedAt,
+            debugId,
+        });
+        if (debugConfig.enabled && error instanceof Error && 'debug' in error) {
+            result.debug = error.debug;
+        }
+        return result;
+    }
+}
+async function saveExecutionResult(metadataStorage, execution, debugConfig) {
+    if (!metadataStorage)
+        return;
+    try {
+        await metadataStorage.saveExecution({
+            ruleId: execution.ruleId,
+            status: execution.status,
+            rowCount: execution.rowCount,
+            lagMinutes: execution.lagMinutes,
+            executionDurationMs: execution.executionDurationMs,
+            executedAt: execution.executedAt,
+            error: execution.error,
+        });
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        if (debugConfig?.enabled) {
+            console.error('[DEBUG] Failed to save execution history:', {
+                ruleId: execution.ruleId,
+                error: errorMessage,
+                rawError: debugConfig.exposeRawErrors ? errorMessage : undefined
+            });
+        }
+        else {
+            console.warn(`Failed to save execution history for rule ${execution.ruleId}: ${errorMessage}`);
+        }
+    }
+}
+function validateFreshnessRule(rule) {
+    if (!rule) {
+        throw new ConfigurationError('Monitoring rule is required');
+    }
+    if (!rule.tableName || typeof rule.tableName !== 'string') {
+        throw new ConfigurationError('Table name is required and must be a string');
+    }
+    if (rule.tableName.length > 256) {
+        throw new ConfigurationError('Table name too long (max 256 characters)');
+    }
+    if (rule.timestampColumn && typeof rule.timestampColumn !== 'string') {
+        throw new ConfigurationError('Timestamp column must be a string');
+    }
+    if (rule.timestampColumn && rule.timestampColumn.length > 256) {
+        throw new ConfigurationError('Timestamp column name too long (max 256 characters)');
+    }
+    if (rule.toleranceMinutes && (typeof rule.toleranceMinutes !== 'number' || !Number.isInteger(rule.toleranceMinutes))) {
+        throw new ConfigurationError('Tolerance minutes must be an integer');
+    }
+    if (rule.ruleType !== 'freshness') {
+        throw new ConfigurationError('Rule type must be "freshness" for freshness checks');
+    }
+}
+async function executeFreshnessQuery(connector, tableName, timestampColumn, debugConfig, debugFactory) {
+    const startTime = performance.now();
+    const queryContext = {
+        sql: `connector.getRowCount('${tableName}') + connector.getMaxTimestamp('${tableName}', '${timestampColumn}')`,
+        params: [],
+        table: tableName,
+        column: timestampColumn,
+        operation: 'freshness_query'
+    };
+    try {
+        if (debugConfig.enabled) {
+            console.log(`[DEBUG] Executing freshness check via connector:`, {
+                table: tableName,
+                column: timestampColumn,
+                operations: debugConfig.exposeQueries
+                    ? `getRowCount('${tableName}'), getMaxTimestamp('${tableName}', '${timestampColumn}')`
+                    : '[Connector operations hidden]'
+            });
+        }
+        const [rowCount, lastUpdate] = await Promise.all([
+            connector.getRowCount(tableName),
+            connector.getMaxTimestamp(tableName, timestampColumn)
+        ]);
+        queryContext.duration = performance.now() - startTime;
+        if (isNaN(rowCount) || rowCount < 0) {
+            throw debugFactory.createQueryError('Invalid row count returned from connector', undefined, queryContext);
+        }
+        const row = {
+            row_count: rowCount.toString(),
+            last_update: lastUpdate
+        };
+        return { rowCount, lastUpdate, row };
+    }
+    catch (error) {
+        queryContext.duration = performance.now() - startTime;
+        throw debugFactory.createQueryError('Failed to execute freshness check via connector', error instanceof Error ? error : undefined, queryContext);
+    }
+}
+async function executeWithTimeout(operation, timeoutMs, timeoutMessage) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            reject(new TimeoutError(timeoutMessage, 'freshness_check', timeoutMs));
+        }, timeoutMs);
+        operation()
+            .then(resolve)
+            .catch(reject)
+            .finally(() => clearTimeout(timer));
+    });
+}
+function createSecureCheckResult(status, data) {
+    return {
+        status,
+        executedAt: data.executedAt || new Date(),
+        executionDurationMs: data.executionDurationMs,
+        ...data
+    };
+}
+//# sourceMappingURL=freshness.js.map