@freshguard/freshguard-core 0.11.2

package/dist/resilience/timeout-manager.js

@@ -0,0 +1,339 @@
+export class OperationTimeoutError extends Error {
+    duration;
+    operationName;
+    timestamp;
+    constructor(duration, operationName, customMessage) {
+        const message = customMessage ||
+            `Operation '${operationName}' timed out after ${duration}ms`;
+        super(message);
+        this.name = 'OperationTimeoutError';
+        this.duration = duration;
+        this.operationName = operationName;
+        this.timestamp = new Date();
+    }
+}
+export class OperationCancelledError extends Error {
+    operationName;
+    timestamp;
+    reason;
+    constructor(operationName, reason = 'Operation was cancelled') {
+        super(`Operation '${operationName}' was cancelled: ${reason}`);
+        this.name = 'OperationCancelledError';
+        this.operationName = operationName;
+        this.timestamp = new Date();
+        this.reason = reason;
+    }
+}
+export class TimeoutManager {
+    controller;
+    timeoutId = null;
+    config;
+    startTime = null;
+    endTime = null;
+    children = new Set();
+    timeoutFired = false;
+    stats = {
+        totalExecutions: 0,
+        successfulExecutions: 0,
+        timeoutCount: 0,
+        cancelledCount: 0,
+        averageDuration: 0,
+        maxDuration: 0,
+        minDuration: Infinity,
+        timeoutRate: 0,
+        lastExecutionTime: null
+    };
+    constructor(config) {
+        this.controller = new AbortController();
+        this.config = {
+            name: config.name || 'TimeoutManager',
+            parent: config.parent,
+            message: config.message,
+            propagateToChildren: config.propagateToChildren ?? true,
+            duration: config.duration
+        };
+        if (this.config.duration <= 0) {
+            throw new Error('Timeout duration must be positive');
+        }
+        if (this.config.parent) {
+            this.config.parent.addChild(this);
+            if (this.config.parent.isAborted()) {
+                this.cancel('Parent timeout was already cancelled');
+            }
+            else {
+                this.config.parent.controller.signal.addEventListener('abort', () => {
+                    this.cancel('Parent timeout was cancelled');
+                });
+            }
+        }
+    }
+    async execute(fn) {
+        const result = await this.executeWithResult(fn);
+        if (result.success && result.data !== undefined) {
+            return result.data;
+        }
+        else {
+            throw result.error || new Error('Timeout execution failed with unknown error');
+        }
+    }
+    async executeWithResult(fn) {
+        this.startTime = new Date();
+        this.timeoutFired = false;
+        this.stats.totalExecutions++;
+        this.stats.lastExecutionTime = this.startTime;
+        this.timeoutId = setTimeout(() => {
+            this.timeout();
+        }, this.config.duration);
+        let result;
+        let error;
+        let success = false;
+        let timedOut = false;
+        let cancelled = false;
+        try {
+            result = await fn(this.controller.signal);
+            success = true;
+        }
+        catch (err) {
+            error = err;
+            if (this.controller.signal.aborted) {
+                if (this.timeoutFired) {
+                    timedOut = true;
+                }
+                else {
+                    cancelled = true;
+                }
+            }
+        }
+        finally {
+            this.cleanup();
+            this.endTime = new Date();
+        }
+        const duration = this.endTime.getTime() - this.startTime.getTime();
+        this.updateStats(duration, success, timedOut, cancelled);
+        return {
+            success,
+            data: result,
+            error,
+            duration,
+            timedOut,
+            cancelled
+        };
+    }
+    static async executeWithTimeout(fn, duration, name = 'StaticTimeout') {
+        const manager = new TimeoutManager({ duration, name });
+        return manager.execute(fn);
+    }
+    static async executeWithTimeoutResult(fn, duration, name = 'StaticTimeout') {
+        const manager = new TimeoutManager({ duration, name });
+        return manager.executeWithResult(fn);
+    }
+    createChild(config) {
+        const childConfig = {
+            ...config,
+            parent: this
+        };
+        return new TimeoutManager(childConfig);
+    }
+    addChild(child) {
+        this.children.add(child);
+    }
+    removeChild(child) {
+        this.children.delete(child);
+    }
+    cancel(reason = 'Operation cancelled') {
+        if (!this.controller.signal.aborted) {
+            this.controller.abort();
+            if (this.config.propagateToChildren) {
+                for (const child of this.children) {
+                    child.cancel(`Parent cancelled: ${reason}`);
+                }
+            }
+        }
+        this.cleanup();
+    }
+    timeout() {
+        if (!this.controller.signal.aborted) {
+            this.timeoutFired = true;
+            this.controller.abort();
+            if (this.config.propagateToChildren) {
+                for (const child of this.children) {
+                    child.cancel(`Parent timed out after ${this.config.duration}ms`);
+                }
+            }
+        }
+    }
+    cleanup() {
+        if (this.timeoutId) {
+            clearTimeout(this.timeoutId);
+            this.timeoutId = null;
+        }
+        if (this.config.parent) {
+            this.config.parent.removeChild(this);
+        }
+        for (const child of this.children) {
+            child.cancel('Parent cleanup');
+        }
+        this.children.clear();
+    }
+    updateStats(duration, success, timedOut, cancelled) {
+        if (success) {
+            this.stats.successfulExecutions++;
+        }
+        if (timedOut) {
+            this.stats.timeoutCount++;
+        }
+        if (cancelled) {
+            this.stats.cancelledCount++;
+        }
+        this.stats.averageDuration = ((this.stats.averageDuration * (this.stats.totalExecutions - 1) + duration) /
+            this.stats.totalExecutions);
+        this.stats.maxDuration = Math.max(this.stats.maxDuration, duration);
+        this.stats.minDuration = Math.min(this.stats.minDuration, duration);
+        this.stats.timeoutRate = (this.stats.timeoutCount / this.stats.totalExecutions) * 100;
+    }
+    isAborted() {
+        return this.controller.signal.aborted;
+    }
+    getSignal() {
+        return this.controller.signal;
+    }
+    getConfig() {
+        return { ...this.config };
+    }
+    getStats() {
+        return {
+            ...this.stats,
+            averageDuration: Math.round(this.stats.averageDuration * 100) / 100,
+            timeoutRate: Math.round(this.stats.timeoutRate * 100) / 100,
+            minDuration: this.stats.minDuration === Infinity ? 0 : this.stats.minDuration
+        };
+    }
+    resetStats() {
+        this.stats = {
+            totalExecutions: 0,
+            successfulExecutions: 0,
+            timeoutCount: 0,
+            cancelledCount: 0,
+            averageDuration: 0,
+            maxDuration: 0,
+            minDuration: Infinity,
+            timeoutRate: 0,
+            lastExecutionTime: null
+        };
+    }
+    getActiveTimeout() {
+        if (!this.startTime || this.endTime) {
+            return null;
+        }
+        return {
+            id: `${this.config.name}-${this.startTime.getTime()}`,
+            name: this.config.name,
+            startTime: this.startTime,
+            duration: this.config.duration,
+            controller: this.controller,
+            parent: this.config.parent,
+            children: new Set(this.children)
+        };
+    }
+    getRemainingTime() {
+        if (!this.startTime || this.endTime || this.isAborted()) {
+            return 0;
+        }
+        const elapsed = Date.now() - this.startTime.getTime();
+        return Math.max(0, this.config.duration - elapsed);
+    }
+    getElapsedTime() {
+        if (!this.startTime) {
+            return 0;
+        }
+        const endTime = this.endTime || new Date();
+        return endTime.getTime() - this.startTime.getTime();
+    }
+}
+export class TimeoutRegistry {
+    timeouts = new Map();
+    activeTimeouts = new Map();
+    create(name, config) {
+        const fullConfig = { ...config, name };
+        const manager = new TimeoutManager(fullConfig);
+        this.timeouts.set(name, manager);
+        return manager;
+    }
+    get(name) {
+        return this.timeouts.get(name);
+    }
+    getOrCreate(name, config) {
+        let manager = this.timeouts.get(name);
+        if (!manager) {
+            manager = this.create(name, config);
+        }
+        return manager;
+    }
+    remove(name) {
+        const manager = this.timeouts.get(name);
+        if (manager) {
+            manager.cancel('Removed from registry');
+            return this.timeouts.delete(name);
+        }
+        return false;
+    }
+    getAllTimeouts() {
+        return new Map(this.timeouts);
+    }
+    getActiveTimeouts() {
+        const active = new Map();
+        for (const [name, manager] of this.timeouts) {
+            const activeTimeout = manager.getActiveTimeout();
+            if (activeTimeout) {
+                active.set(name, activeTimeout);
+            }
+        }
+        return active;
+    }
+    getAllStats() {
+        const stats = {};
+        for (const [name, manager] of this.timeouts) {
+            stats[name] = manager.getStats();
+        }
+        return stats;
+    }
+    cancelAll(reason = 'Registry shutdown') {
+        for (const manager of this.timeouts.values()) {
+            manager.cancel(reason);
+        }
+    }
+    resetAllStats() {
+        for (const manager of this.timeouts.values()) {
+            manager.resetStats();
+        }
+    }
+    clear() {
+        this.cancelAll('Registry cleared');
+        this.timeouts.clear();
+        this.activeTimeouts.clear();
+    }
+}
+export async function withTimeout(fn, timeoutMs, name = 'WithTimeout') {
+    return TimeoutManager.executeWithTimeout(fn, timeoutMs, name);
+}
+export async function withTimeoutResult(fn, timeoutMs, name = 'WithTimeoutResult') {
+    return TimeoutManager.executeWithTimeoutResult(fn, timeoutMs, name);
+}
+export function createDatabaseTimeout(operationName) {
+    return new TimeoutManager({
+        duration: 30000,
+        name: `db-${operationName}`,
+        message: `Database operation '${operationName}' timed out`,
+        propagateToChildren: true
+    });
+}
+export function createApiTimeout(operationName) {
+    return new TimeoutManager({
+        duration: 10000,
+        name: `api-${operationName}`,
+        message: `API operation '${operationName}' timed out`,
+        propagateToChildren: true
+    });
+}
+export const defaultTimeoutRegistry = new TimeoutRegistry();
+//# sourceMappingURL=timeout-manager.js.map

package/dist/resilience/timeout-manager.js.map

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

package/dist/security/query-analyzer.d.ts

@@ -0,0 +1,82 @@
+export interface QueryComplexity {
+    allowExecution: boolean;
+    riskScore: number;
+    complexityScore: number;
+    estimatedCost: number;
+    securityWarnings: string[];
+    performanceWarnings: string[];
+    recommendations: string[];
+    details: QueryAnalysisDetails;
+}
+export interface QueryAnalysisDetails {
+    queryType: string;
+    tableCount: number;
+    joinCount: number;
+    hasSubqueries: boolean;
+    hasAggregations: boolean;
+    hasWildcards: boolean;
+    hasLimit: boolean;
+    limitValue?: number;
+    hasWhere: boolean;
+    hasOrderBy: boolean;
+    hasGroupBy: boolean;
+    hasHaving: boolean;
+    estimatedResultSize: number;
+}
+export interface TableMetadata {
+    name: string;
+    estimatedRows: number;
+    sizeBytes?: number;
+    indexes: IndexInfo[];
+    columns: ColumnInfo[];
+    lastUpdated: Date;
+}
+export interface IndexInfo {
+    name: string;
+    columns: string[];
+    unique: boolean;
+    type?: string;
+}
+export interface ColumnInfo {
+    name: string;
+    type: string;
+    nullable: boolean;
+    indexed: boolean;
+    cardinality?: number;
+}
+export interface QueryAnalyzerConfig {
+    maxRiskScore: number;
+    maxComplexityScore: number;
+    maxEstimatedCost: number;
+    maxResultSetSize: number;
+    enablePerformanceAnalysis: boolean;
+    enableSecurityAnalysis: boolean;
+    customRiskFactors: RiskFactor[];
+}
+export interface RiskFactor {
+    pattern: RegExp;
+    riskScore: number;
+    description: string;
+    blocking: boolean;
+}
+export declare class QueryComplexityAnalyzer {
+    private config;
+    private readonly riskFactors;
+    constructor(config?: Partial<QueryAnalyzerConfig>);
+    analyzeQuery(sql: string, tableMetadata?: TableMetadata[]): QueryComplexity;
+    private calculateComplexityScore;
+    private calculateRiskScore;
+    private calculateEstimatedCost;
+    private generateSecurityWarnings;
+    private generatePerformanceWarnings;
+    private generateRecommendations;
+    private shouldAllowExecution;
+    updateConfig(config: Partial<QueryAnalyzerConfig>): void;
+    addRiskFactor(factor: RiskFactor): void;
+    getConfig(): QueryAnalyzerConfig;
+}
+export declare function createQueryAnalyzer(config?: Partial<QueryAnalyzerConfig>): QueryComplexityAnalyzer;
+export declare function createSecurityAnalyzer(): QueryComplexityAnalyzer;
+export declare function createPerformanceAnalyzer(): QueryComplexityAnalyzer;
+export declare const defaultQueryAnalyzer: QueryComplexityAnalyzer;
+//# sourceMappingURL=query-analyzer.d.ts.map

package/dist/security/query-analyzer.d.ts.map

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