@dotdo/postgres 0.1.0

package/dist/rls/validator.js.map

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

package/dist/routing/adaptive-router.d.ts

@@ -0,0 +1,317 @@
+/**
+ * Adaptive Routing (learn from history)
+ *
+ * Task: postgres-d6g.10
+ *
+ * Purpose: Learn from execution history to improve routing decisions.
+ * Uses actual CPU time measurements to adjust complexity estimates.
+ */
+import { QueryComplexityFactors, ConfidenceLevel } from './query-complexity-estimator';
+export type RuntimeTarget = 'worker' | 'durable-object';
+export type RoutingStrategy = 'primary' | 'alternative';
+export interface ExecutionOutcome {
+    sql: string;
+    sqlHash: string;
+    predictedCpuTimeMs: number;
+    actualCpuTimeMs: number;
+    runtime: RuntimeTarget;
+    timestamp: number;
+    factors?: Partial<QueryComplexityFactors>;
+    strategy?: RoutingStrategy;
+}
+export interface PredictionResult {
+    estimatedMs: number;
+    confidence: ConfidenceLevel;
+    source: 'history' | 'model' | 'estimator';
+}
+export interface RoutingDecision {
+    target: RuntimeTarget;
+    estimatedMs: number;
+    confidence: ConfidenceLevel;
+    strategy: RoutingStrategy;
+    reason: string;
+}
+export interface PredictionAccuracy {
+    meanAbsoluteError: number;
+    meanAbsolutePercentageError: number;
+    predictionCount: number;
+}
+export interface StrategyStats {
+    avgPredictionError: number;
+    avgActualCpuTimeMs: number;
+    correctRoutingPercent: number;
+    sampleCount: number;
+}
+export interface StrategyComparison {
+    primary: StrategyStats;
+    alternative: StrategyStats;
+    winner: RoutingStrategy | null;
+}
+export interface PerformanceAnomaly {
+    timestamp: number;
+    actualCpuTimeMs: number;
+    expectedCpuTimeMs: number;
+    deviationPercent: number;
+}
+export interface LearningModel {
+    queryModels: Record<string, {
+        avgCpuTimeMs: number;
+        sampleCount: number;
+        variance: number;
+    }>;
+    adjustedWeights: ComplexityWeights;
+    strategyOutcomes: Record<RoutingStrategy, ExecutionOutcome[]>;
+    history: Record<string, ExecutionOutcome[]>;
+    version: string;
+}
+export interface ComplexityWeights {
+    baseQuery: number;
+    perJoin: number;
+    perSubquery: number;
+    perUnion: number;
+    perCte: number;
+    perWindowFunction: number;
+    aggregation: number;
+    groupBy: number;
+    having: number;
+    orderBy: number;
+    distinct: number;
+    noLimit: number;
+    fullTableScan: number;
+    largeTableMultiplier: number;
+    transaction: number;
+}
+export interface SeedData {
+    sqlHash: string;
+    avgCpuTimeMs: number;
+    sampleCount: number;
+}
+/**
+ * Configuration options for the AdaptiveRouter.
+ *
+ * The AdaptiveRouter learns from query execution history to improve routing
+ * decisions over time. It routes queries to either Workers (fast queries) or
+ * Durable Objects (complex queries) based on predicted CPU time.
+ *
+ * @example
+ * ```typescript
+ * const router = new AdaptiveRouter({
+ *   cpuTimeThresholdMs: 30,  // Lower threshold for faster routing
+ *   complexityWeights: {
+ *     // Custom weights tuned for your workload
+ *     baseQuery: 1,
+ *     perJoin: 20,       // Higher if your joins are expensive
+ *     perSubquery: 25,
+ *     perWindowFunction: 30,
+ *     // ... other weights
+ *   },
+ *   enableABTesting: true,
+ * })
+ * ```
+ */
+export interface AdaptiveConfig {
+    /** CPU time threshold for routing decision (default: 50ms) */
+    cpuTimeThresholdMs?: number;
+    /** Enable A/B testing of routing strategies */
+    enableABTesting?: boolean;
+    /** Ratio of traffic to send to alternative strategy (0-1) */
+    abTestingRatio?: number;
+    /** Minimum samples before auto-selecting strategy */
+    minSamplesForDecision?: number;
+    /** Conservative routing for low confidence predictions */
+    conservativeThreshold?: ConfidenceLevel;
+    /** Half-life for time-based decay (ms) */
+    decayHalfLifeMs?: number;
+    /**
+     * Partial complexity weight overrides. These values are merged with
+     * DEFAULT_WEIGHTS, allowing you to adjust specific weights while
+     * keeping defaults for others.
+     *
+     * @example
+     * ```typescript
+     * initialWeights: {
+     *   perJoin: 20,      // Only override JOIN weight
+     *   aggregation: 15,  // And aggregation weight
+     * }
+     * ```
+     *
+     * @see ComplexityWeights for available weight fields
+     * @see complexityWeights for full replacement (no merging)
+     */
+    initialWeights?: Partial<ComplexityWeights>;
+    /**
+     * Complete complexity weights replacement. When provided, these weights
+     * fully replace the defaults (no merging with DEFAULT_WEIGHTS).
+     *
+     * Use this when you have a complete set of weights tuned for your
+     * specific workload, or when exporting/importing router configurations.
+     *
+     * @example
+     * ```typescript
+     * complexityWeights: {
+     *   baseQuery: 1,
+     *   perJoin: 18,
+     *   perSubquery: 22,
+     *   perUnion: 12,
+     *   perCte: 16,
+     *   perWindowFunction: 28,
+     *   aggregation: 12,
+     *   groupBy: 9,
+     *   having: 6,
+     *   orderBy: 9,
+     *   distinct: 11,
+     *   noLimit: 17,
+     *   fullTableScan: 22,
+     *   largeTableMultiplier: 0.00001,
+     *   transaction: 6,
+     * }
+     * ```
+     *
+     * @see ComplexityWeights for field descriptions
+     * @see initialWeights for partial overrides (merged with defaults)
+     */
+    complexityWeights?: ComplexityWeights;
+    /**
+     * Seed data to bootstrap the router's query models on cold start.
+     *
+     * Provide pre-computed query statistics to avoid the learning period
+     * for known query patterns. Each entry associates a SQL hash with its
+     * expected CPU time and sample count, allowing the router to make
+     * informed routing decisions immediately.
+     *
+     * @example
+     * ```typescript
+     * seedData: [
+     *   { sqlHash: 'sql-abc123', avgCpuTimeMs: 25, sampleCount: 100 },
+     *   { sqlHash: 'sql-def456', avgCpuTimeMs: 75, sampleCount: 50 },
+     * ]
+     * ```
+     *
+     * @see SeedData for the structure of seed entries
+     */
+    seedData?: SeedData[];
+    /** Minimum samples to create query-specific model */
+    minSamplesForQueryModel?: number;
+    /** Maximum number of unique query hashes to track in history (default: 1000) */
+    maxHistoryEntries?: number;
+    /** Maximum age for history entries in milliseconds (default: 3600000 = 1 hour) */
+    maxHistoryAgeMs?: number;
+}
+/**
+ * Default complexity weights for SQL query routing decisions.
+ *
+ * These weights represent **relative complexity units** that estimate CPU time
+ * overhead for different SQL operations. They are used by the AdaptiveRouter
+ * to predict query execution time and route queries to the appropriate runtime
+ * (Worker for fast queries, Durable Object for complex queries).
+ *
+ * ## Weight Derivation
+ *
+ * These values were derived from:
+ * 1. **PostgreSQL documentation** - Understanding relative costs of operations
+ *    (e.g., nested loop joins vs hash joins, sequential vs index scans)
+ * 2. **Empirical testing** - Benchmarking common query patterns on PGLite/WASM
+ *    in Cloudflare Workers to measure actual CPU time overhead
+ * 3. **Industry best practices** - Referencing query cost models from PostgreSQL's
+ *    EXPLAIN ANALYZE and similar database query planners
+ *
+ * ## How Weights Affect Routing
+ *
+ * The total complexity score is calculated as:
+ *   score = baseQuery + (joinCount * perJoin) + (subqueryCount * perSubquery) + ...
+ *
+ * This score is then used to estimate CPU time in milliseconds. Queries with
+ * estimated CPU time below `cpuTimeThresholdMs` (default: 50ms) are routed to
+ * Workers; those above are routed to Durable Objects.
+ *
+ * ## Weight Categories
+ *
+ * - **Structural costs** (perJoin, perSubquery, perUnion, perCte): Increase
+ *   linearly with each occurrence. Joins and subqueries are expensive due to
+ *   additional table scans and nested loop processing.
+ *
+ * - **Operation costs** (aggregation, groupBy, having, orderBy, distinct):
+ *   Fixed overhead for using these operations. GROUP BY and ORDER BY require
+ *   sorting; aggregations need accumulator state.
+ *
+ * - **Scan costs** (noLimit, fullTableScan, largeTableMultiplier): Penalize
+ *   queries that may process large result sets. The largeTableMultiplier
+ *   scales with estimated row count (e.g., 100K rows * 0.00001 = 1 unit).
+ *
+ * - **Compute costs** (perWindowFunction): Window functions are particularly
+ *   expensive as they require buffering and sorting result sets.
+ *
+ * ## Adaptive Learning
+ *
+ * These defaults serve as initial values. The AdaptiveRouter adjusts weights
+ * based on actual execution outcomes using online learning. Over time, weights
+ * converge to values that minimize prediction error for your specific workload.
+ *
+ * @see AdaptiveConfig.initialWeights - Override these defaults at construction
+ * @see AdaptiveConfig.complexityWeights - Fully replace the weight configuration
+ */
+export declare const DEFAULT_WEIGHTS: ComplexityWeights;
+export declare class AdaptiveRouter {
+    private config;
+    private estimator;
+    private history;
+    private queryModels;
+    private adjustedWeights;
+    private strategyOutcomes;
+    private selectedStrategy;
+    /** Track last access time for each query hash (for LRU eviction) */
+    private lastAccessTime;
+    constructor(config?: AdaptiveConfig);
+    recordOutcome(outcome: ExecutionOutcome): Promise<void>;
+    /**
+     * Evict the least recently used entry from history
+     */
+    private evictLRUEntry;
+    private updateQueryModel;
+    private updateWeights;
+    private checkStrategySelection;
+    private calculateStrategyStats;
+    getHistory(sqlHash: string): ExecutionOutcome[];
+    /**
+     * Get the number of unique query hashes in history
+     */
+    getHistorySize(): number;
+    /**
+     * Get the current configuration
+     */
+    getConfig(): Required<AdaptiveConfig>;
+    /**
+     * Get the default complexity weights.
+     *
+     * Returns a copy of the default weight values used when no custom
+     * weights are provided. Useful for inspecting defaults or creating
+     * modified weight configurations based on defaults.
+     *
+     * @example
+     * ```typescript
+     * const defaults = AdaptiveRouter.getDefaultWeights()
+     * const customWeights = {
+     *   ...defaults,
+     *   perJoin: defaults.perJoin * 1.5,  // 50% higher JOIN cost
+     * }
+     * const router = new AdaptiveRouter({ complexityWeights: customWeights })
+     * ```
+     */
+    static getDefaultWeights(): ComplexityWeights;
+    /**
+     * Prune entries older than maxHistoryAgeMs
+     */
+    pruneOldEntries(): void;
+    getPredictionAccuracy(): PredictionAccuracy;
+    predictCpuTime(sql: string, sqlHash: string): Promise<PredictionResult>;
+    hasQueryModel(sqlHash: string): boolean;
+    getAdjustedWeights(): ComplexityWeights;
+    route(sql: string, sqlHash?: string): Promise<RoutingDecision>;
+    private hashSql;
+    compareStrategies(): StrategyComparison;
+    getSelectedStrategy(): RoutingStrategy | null;
+    detectPerformanceAnomalies(sqlHash: string): PerformanceAnomaly[];
+    exportModel(): string;
+    importModel(modelJson: string): void;
+}
+//# sourceMappingURL=adaptive-router.d.ts.map

package/dist/routing/adaptive-router.d.ts.map

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