@gravito/ripple 4.0.1 → 5.0.0

package/dist/atlas/src/pool/PoolStrategy.d.ts

@@ -1,129 +0,0 @@
-/**
- * @gravito/atlas - Pool Strategy Engine
- * @description Strategies for adaptive connection pool management
- */
-import type { PoolStats } from '../types';
-/**
- * Pool strategy decision result
- */
-export interface PoolAdjustmentDecision {
-    /**
-     * Action to take: 'increase' | 'decrease' | 'maintain'
-     */
-    action: 'increase' | 'decrease' | 'maintain';
-    /**
-     * Target pool size
-     */
-    targetSize: number;
-    /**
-     * Reason for the decision
-     */
-    reason: string;
-    /**
-     * Confidence level (0-1)
-     */
-    confidence: number;
-}
-/**
- * Strategy context for decision making
- */
-export interface PoolStrategyContext {
-    /**
-     * Current pool statistics
-     */
-    stats: PoolStats;
-    /**
-     * Historical statistics (if available)
-     */
-    history?: PoolStats[];
-    /**
-     * Pool configuration
-     */
-    config: {
-        min?: number;
-        max?: number;
-    };
-    /**
-     * Connection name
-     */
-    connectionName: string;
-}
-/**
- * Abstract base class for pool adjustment strategies
- */
-export declare abstract class PoolStrategy {
-    /**
-     * Strategy name
-     */
-    abstract readonly name: string;
-    /**
-     * Make an adjustment decision based on pool context
-     */
-    abstract decide(context: PoolStrategyContext): PoolAdjustmentDecision;
-    /**
-     * Validate if an adjustment decision is acceptable
-     */
-    validateAdjustment(decision: PoolAdjustmentDecision, context: PoolStrategyContext): boolean;
-    /**
-     * Protected helper: calculate utilization ratio
-     */
-    protected calculateUtilization(stats: PoolStats): number;
-    /**
-     * Protected helper: calculate pending ratio
-     */
-    protected calculatePendingRatio(stats: PoolStats): number;
-    /**
-     * Protected helper: clamp value to bounds
-     */
-    protected clampToSize(value: number, context: PoolStrategyContext): number;
-}
-/**
- * Load-aware strategy: adjusts based on current utilization
- */
-export declare class LoadAwareStrategy extends PoolStrategy {
-    readonly name = "load-aware";
-    private readonly warningUtilization;
-    private readonly criticalUtilization;
-    private readonly recoveryUtilization;
-    constructor(config?: {
-        warningUtilization?: number;
-        criticalUtilization?: number;
-        recoveryUtilization?: number;
-    });
-    decide(context: PoolStrategyContext): PoolAdjustmentDecision;
-}
-/**
- * Predictive strategy: adjusts based on historical trends
- */
-export declare class PredictiveStrategy extends PoolStrategy {
-    readonly name = "predictive";
-    private readonly minHistorySize;
-    constructor(config?: {
-        minHistorySize?: number;
-    });
-    decide(context: PoolStrategyContext): PoolAdjustmentDecision;
-    /**
-     * Calculate linear trend from data points
-     */
-    private calculateTrend;
-}
-/**
- * Hybrid strategy: combines multiple strategies
- */
-export declare class HybridStrategy extends PoolStrategy {
-    private loadAware;
-    private predictive;
-    private loadWeight;
-    private predictiveWeight;
-    readonly name = "hybrid";
-    constructor(loadAware: LoadAwareStrategy, predictive: PredictiveStrategy, loadWeight?: number, predictiveWeight?: number);
-    decide(context: PoolStrategyContext): PoolAdjustmentDecision;
-}
-/**
- * Create default strategies for pool management
- */
-export declare function createDefaultStrategies(): {
-    loadAware: LoadAwareStrategy;
-    predictive: PredictiveStrategy;
-    hybrid: HybridStrategy;
-};

package/dist/atlas/src/pool/PoolWarmer.d.ts

@@ -1,92 +0,0 @@
-/**
- * @gravito/atlas - Connection Pool Warmer
- * @description Preheats connection pools during initialization
- */
-import type { ConnectionManager } from '../connection/ConnectionManager';
-export interface PoolWarmerConfig {
-    /**
-     * Target number of connections to warm for each pool
-     * @default 2
-     */
-    targetConnections?: number;
-    /**
-     * Number of concurrent warmup queries
-     * @default 2
-     */
-    concurrency?: number;
-    /**
-     * Timeout (ms) for each warmup query
-     * @default 5000
-     */
-    timeout?: number;
-    /**
-     * Callback when warmup completes
-     */
-    onComplete?: (result: WarmupResult) => void;
-    /**
-     * Callback for individual connection warmup
-     */
-    onConnectionWarmed?: (connection: string, duration: number) => void;
-}
-export interface ConnectionWarmupResult {
-    /**
-     * Whether warmup succeeded
-     */
-    success: boolean;
-    /**
-     * Connection name
-     */
-    connection: string;
-    /**
-     * Time spent warming up (ms)
-     */
-    duration: number;
-    /**
-     * Error message (if failed)
-     */
-    error?: string;
-}
-export interface WarmupResult {
-    /**
-     * Total connections processed
-     */
-    total: number;
-    /**
-     * Number of successful warmups
-     */
-    successful: number;
-    /**
-     * Number of failed warmups
-     */
-    failed: number;
-    /**
-     * Results for each connection
-     */
-    results: Record<string, ConnectionWarmupResult>;
-    /**
-     * Total duration (ms)
-     */
-    duration: number;
-}
-export declare const DEFAULT_WARMER_CONFIG: PoolWarmerConfig;
-/**
- * Connection pool warmer
- * Preheats pools by establishing connections
- */
-export declare class PoolWarmer {
-    private connectionManager;
-    private config;
-    constructor(connectionManager: ConnectionManager, config: PoolWarmerConfig);
-    /**
-     * Warm all connection pools
-     */
-    warmAll(): Promise<WarmupResult>;
-    /**
-     * Warm a specific connection pool
-     */
-    warmConnection(name: string): Promise<ConnectionWarmupResult>;
-    /**
-     * Execute a warmup query with timeout
-     */
-    private executeWarmupQuery;
-}

package/dist/atlas/src/query/Expression.d.ts

@@ -1,60 +0,0 @@
-/**
- * Raw SQL Expression
- * @description Represents a raw SQL expression that should not be escaped by the query builder.
- * Use this for complex SQL fragments, function calls, or database-specific syntax.
- */
-export declare class Expression {
-    private readonly sql;
-    private readonly bindings;
-    /**
-     * Create a new Expression instance
-     *
-     * @param sql - The raw SQL string
-     * @param bindings - Optional array of bindings for the expression
-     */
-    constructor(sql: string, bindings?: unknown[]);
-    /**
-     * Get the raw SQL string
-     *
-     * @returns The SQL string
-     */
-    getValue(): string;
-    /**
-     * Get the bindings associated with this expression
-     *
-     * @returns Array of bindings
-     */
-    getBindings(): unknown[];
-    /**
-     * Convert the expression to its SQL string representation
-     *
-     * @returns The SQL string
-     */
-    toString(): string;
-}
-/**
- * Create a raw SQL expression
- *
- * @param sql - The raw SQL string
- * @param bindings - Optional array of bindings
- * @returns A new Expression instance
- * @example
- * ```typescript
- * DB.table('users').select(raw('COUNT(*) as total')).get()
- * ```
- */
-export declare function raw(sql: string, bindings?: unknown[]): Expression;
-/**
- * Tagged template literal for safe raw SQL construction
- *
- * @param strings - Template strings
- * @param values - Values to be used as bindings
- * @returns A new Expression instance with auto-generated placeholders
- * @example
- * ```typescript
- * const userId = 1;
- * const query = sql`SELECT * FROM users WHERE id = ${userId}`;
- * // Result: Expression { sql: "SELECT * FROM users WHERE id = ?", bindings: [1] }
- * ```
- */
-export declare function sql(strings: TemplateStringsArray, ...values: unknown[]): Expression;

package/dist/atlas/src/query/NPlusOneDetector.d.ts

@@ -1,10 +0,0 @@
-export declare class NPlusOneDetector {
-    private static queryCounts;
-    private static timeframe;
-    private static threshold;
-    private static enabled;
-    static track(tableName: string, sql: string, structureKey: string): void;
-    static reset(): void;
-    static setEnabled(enabled: boolean): void;
-    private static warn;
-}