mongo.do 0.1.0

package/dist/olap/stage/router.js

@@ -0,0 +1,390 @@
+/**
+ * Query Router for $olap Stage
+ *
+ * Routes analytical queries to the appropriate OLAP engine based on
+ * query complexity, features used, and engine availability.
+ */
+// ============================================================================
+// Constants
+// ============================================================================
+const JOIN_PATTERNS = [
+    /\bINNER\s+JOIN\b/i,
+    /\bLEFT\s+(?:OUTER\s+)?JOIN\b/i,
+    /\bRIGHT\s+(?:OUTER\s+)?JOIN\b/i,
+    /\bFULL\s+(?:OUTER\s+)?JOIN\b/i,
+    /\bCROSS\s+JOIN\b/i,
+    /\bJOIN\b/i,
+];
+const IMPLICIT_JOIN_PATTERN = /\bFROM\s+[\w.]+(?:\s+\w+)?\s*,/i;
+const WINDOW_FUNCTION_PATTERNS = [
+    /\bROW_NUMBER\s*\(/i,
+    /\bRANK\s*\(/i,
+    /\bDENSE_RANK\s*\(/i,
+    /\bLAG\s*\(/i,
+    /\bLEAD\s*\(/i,
+    /\bNTILE\s*\(/i,
+    /\bFIRST_VALUE\s*\(/i,
+    /\bLAST_VALUE\s*\(/i,
+    /\bOVER\s*\(/i,
+    /\bPARTITION\s+BY\b/i,
+];
+const CTE_PATTERN = /\bWITH\s+(?!(?:TIME\s+ZONE|LOCAL\s+TIME))/i;
+const RECURSIVE_CTE_PATTERN = /\bWITH\s+RECURSIVE\b/i;
+const UNION_PATTERN = /\bUNION\b/i;
+const INTERSECT_PATTERN = /\bINTERSECT\b/i;
+const EXCEPT_PATTERN = /\bEXCEPT\b/i;
+const SUBQUERY_PATTERN = /\(\s*SELECT\b/i;
+const GROUP_BY_PATTERN = /\bGROUP\s+BY\b/i;
+const HAVING_PATTERN = /\bHAVING\b/i;
+const ORDER_BY_PATTERN = /\bORDER\s+BY\b/i;
+const DISTINCT_PATTERN = /\bDISTINCT\b/i;
+// TABLE_PATTERN used only in countTables function with its own local pattern
+const LARGE_RESULT_THRESHOLD = 100000;
+const ROUTER_VERSION = '1.0.0';
+const DEFAULT_CAPABILITIES = {
+    r2sql: {
+        supportsJoins: false,
+        supportsWindowFunctions: false,
+        supportsCTEs: false,
+        supportsSubqueries: true,
+        maxConcurrentQueries: 10,
+        maxRowsPerQuery: 100000,
+        supportedFunctions: ['COUNT', 'SUM', 'AVG', 'MIN', 'MAX', 'GROUP BY', 'ORDER BY'],
+    },
+    clickhouse: {
+        supportsJoins: true,
+        supportsWindowFunctions: true,
+        supportsCTEs: true,
+        supportsSubqueries: true,
+        maxConcurrentQueries: 100,
+        maxRowsPerQuery: 10000000,
+        supportedFunctions: [
+            'COUNT', 'SUM', 'AVG', 'MIN', 'MAX', 'GROUP BY', 'ORDER BY',
+            'JOIN', 'LEFT JOIN', 'RIGHT JOIN', 'INNER JOIN',
+            'ROW_NUMBER', 'RANK', 'DENSE_RANK', 'LAG', 'LEAD', 'OVER', 'PARTITION BY',
+            'WITH', 'UNION', 'INTERSECT', 'EXCEPT',
+        ],
+    },
+};
+// ============================================================================
+// QueryRouter Class
+// ============================================================================
+export class QueryRouter {
+    _config;
+    constructor(config = {}) {
+        this._config = {
+            availability: config.availability ?? { r2sql: true, clickhouse: true },
+            capabilities: config.capabilities ?? DEFAULT_CAPABILITIES,
+            defaultEngine: config.defaultEngine ?? 'auto',
+            ...(config.preferEngine !== undefined && { preferEngine: config.preferEngine }),
+            ...(config.enableCostBasedRouting !== undefined && { enableCostBasedRouting: config.enableCostBasedRouting }),
+            ...(config.costFactors !== undefined && { costFactors: config.costFactors }),
+        };
+    }
+    /**
+     * Map feature complexity to decision complexity
+     */
+    _mapComplexity(features) {
+        // High complexity: JOINs, window functions, CTEs, or many tables
+        if (features.hasJoins || features.hasImplicitJoin || features.hasWindowFunctions ||
+            features.hasCTEs || features.tableCount >= 4) {
+            return 'high';
+        }
+        // Medium complexity: GROUP BY, HAVING, subqueries
+        if (features.hasGroupBy || features.hasHaving || features.hasSubqueries ||
+            features.hasUnion || features.hasIntersect || features.hasExcept) {
+            return 'medium';
+        }
+        // Low complexity: simple queries
+        return 'low';
+    }
+    /**
+     * Add metadata to routing decision
+     */
+    _addMetadata(decision, options) {
+        const complexity = decision.features ? this._mapComplexity(decision.features) : 'low';
+        const estimatedRows = options.maxRows ?? (options.partition ? 10000 : undefined);
+        return {
+            ...decision,
+            timestamp: Date.now(),
+            routerVersion: ROUTER_VERSION,
+            ...(estimatedRows !== undefined && { estimatedRows }),
+            complexity,
+        };
+    }
+    /**
+     * Route a query to the appropriate OLAP engine
+     */
+    route(options) {
+        const { availability, capabilities } = this._config;
+        // Check if any engine is available
+        if (!availability.r2sql && !availability.clickhouse) {
+            throw new Error('No OLAP engine available');
+        }
+        const query = typeof options.query === 'string' ? options.query : '';
+        const features = detectQueryFeatures(query);
+        const warnings = [];
+        // Handle explicit engine selection
+        if (options.engine !== 'auto') {
+            const decision = this._handleExplicitEngine(options.engine, features, availability, capabilities, warnings);
+            return this._addMetadata(decision, options);
+        }
+        // Handle preferEngine hint
+        if (this._config.preferEngine && this._config.preferEngine !== 'auto') {
+            const preferred = this._config.preferEngine;
+            if ((preferred === 'r2sql' && availability.r2sql) || (preferred === 'clickhouse' && availability.clickhouse)) {
+                return this._addMetadata({
+                    engine: preferred,
+                    reason: `Preferred engine: ${preferred}`,
+                    features,
+                    overridden: true,
+                }, options);
+            }
+        }
+        // Auto-select engine based on query features
+        const decision = this._autoSelectEngine(options, features, availability, capabilities, warnings);
+        return this._addMetadata(decision, options);
+    }
+    _handleExplicitEngine(engine, features, availability, capabilities, warnings) {
+        // Check if requested engine is available
+        if (engine === 'r2sql' && !availability.r2sql) {
+            if (availability.clickhouse) {
+                return {
+                    engine: 'clickhouse',
+                    reason: 'R2 SQL unavailable, falling back to ClickHouse',
+                    features,
+                    fallback: true,
+                    warnings: ['Requested engine R2 SQL is unavailable'],
+                };
+            }
+            throw new Error('No OLAP engine available');
+        }
+        if (engine === 'clickhouse' && !availability.clickhouse) {
+            if (availability.r2sql) {
+                return {
+                    engine: 'r2sql',
+                    reason: 'ClickHouse unavailable, falling back to R2 SQL',
+                    features,
+                    fallback: true,
+                    warnings: ['Requested engine ClickHouse is unavailable'],
+                };
+            }
+            throw new Error('No OLAP engine available');
+        }
+        // Engine is available - check for compatibility warnings
+        if (engine === 'r2sql') {
+            const r2Caps = capabilities['r2sql'];
+            if ((features.hasJoins || features.hasImplicitJoin) && !r2Caps?.supportsJoins) {
+                warnings.push('R2 SQL does not support JOINs');
+            }
+            if (features.hasWindowFunctions && !r2Caps?.supportsWindowFunctions) {
+                warnings.push('window functions');
+            }
+            if (features.hasCTEs && !r2Caps?.supportsCTEs) {
+                warnings.push('R2 SQL does not support CTEs');
+            }
+        }
+        const result = {
+            engine,
+            reason: `Explicitly selected ${engine}`,
+            features,
+            overridden: true,
+        };
+        if (warnings.length > 0) {
+            result.warnings = warnings;
+        }
+        return result;
+    }
+    _autoSelectEngine(options, features, availability, capabilities, warnings) {
+        const r2Caps = capabilities['r2sql'];
+        // Features that require ClickHouse
+        const requiresClickHouse = features.hasJoins ||
+            features.hasImplicitJoin ||
+            features.hasWindowFunctions ||
+            features.hasCTEs ||
+            features.hasUnion ||
+            features.hasIntersect ||
+            features.hasExcept ||
+            features.estimatedComplexity === 'complex';
+        // Large result sets should use ClickHouse
+        const hasLargeResultSet = options.maxRows && options.maxRows > (r2Caps?.maxRowsPerQuery || LARGE_RESULT_THRESHOLD);
+        // Determine preferred engine
+        let preferredEngine;
+        let reason;
+        if (requiresClickHouse) {
+            preferredEngine = 'clickhouse';
+            if (features.hasJoins || features.hasImplicitJoin) {
+                reason = 'complex query contains JOIN operations - routing to ClickHouse';
+            }
+            else if (features.hasWindowFunctions) {
+                reason = 'complex query contains window functions - routing to ClickHouse';
+            }
+            else if (features.hasCTEs) {
+                reason = 'complex query contains CTEs - routing to ClickHouse';
+            }
+            else if (features.estimatedComplexity === 'complex') {
+                reason = 'complex query - routing to ClickHouse';
+            }
+            else {
+                reason = 'complex query requires advanced features - routing to ClickHouse';
+            }
+        }
+        else if (hasLargeResultSet) {
+            preferredEngine = 'clickhouse';
+            reason = 'Query expects large result set - routing to ClickHouse';
+        }
+        else {
+            preferredEngine = 'r2sql';
+            reason = 'simple aggregation - routing to R2 SQL';
+        }
+        // Check availability and fallback if needed
+        if (preferredEngine === 'clickhouse' && !availability.clickhouse) {
+            if (availability.r2sql) {
+                // Check if query might fail on R2 SQL
+                const mayFail = requiresClickHouse && ((features.hasJoins && !r2Caps?.supportsJoins) ||
+                    (features.hasWindowFunctions && !r2Caps?.supportsWindowFunctions) ||
+                    (features.hasCTEs && !r2Caps?.supportsCTEs));
+                if (features.hasJoins || features.hasImplicitJoin) {
+                    warnings.push('JOINs are not supported');
+                }
+                if (features.hasWindowFunctions) {
+                    warnings.push('window functions are not supported');
+                }
+                if (features.hasCTEs) {
+                    warnings.push('CTEs are not supported');
+                }
+                const fallbackResult = {
+                    engine: 'r2sql',
+                    reason: 'ClickHouse unavailable, falling back to R2 SQL',
+                    features,
+                    fallback: true,
+                    mayFail,
+                };
+                if (warnings.length > 0) {
+                    fallbackResult.warnings = warnings;
+                }
+                return fallbackResult;
+            }
+            throw new Error('No OLAP engine available');
+        }
+        if (preferredEngine === 'r2sql' && !availability.r2sql) {
+            if (availability.clickhouse) {
+                return {
+                    engine: 'clickhouse',
+                    reason: 'R2 SQL unavailable, falling back to ClickHouse',
+                    features,
+                    fallback: true,
+                };
+            }
+            throw new Error('No OLAP engine available');
+        }
+        // Check if we're in a degraded state (one engine unavailable)
+        const inDegradedState = !availability.r2sql || !availability.clickhouse;
+        const result = {
+            engine: preferredEngine,
+            reason,
+            features,
+        };
+        if (warnings.length > 0) {
+            result.warnings = warnings;
+        }
+        if (inDegradedState) {
+            result.fallback = true;
+        }
+        return result;
+    }
+}
+// ============================================================================
+// Feature Detection Functions
+// ============================================================================
+/**
+ * Count tables referenced in a query
+ */
+function countTables(query) {
+    const tables = new Set();
+    let match;
+    const pattern = /\b(?:FROM|JOIN)\s+(\w+)/gi;
+    while ((match = pattern.exec(query)) !== null) {
+        if (match[1]) {
+            tables.add(match[1].toLowerCase());
+        }
+    }
+    return tables.size;
+}
+/**
+ * Detect query features for routing decisions
+ */
+export function detectQueryFeatures(query) {
+    const hasJoins = JOIN_PATTERNS.some((pattern) => pattern.test(query));
+    const hasImplicitJoin = IMPLICIT_JOIN_PATTERN.test(query);
+    const hasWindowFunctions = WINDOW_FUNCTION_PATTERNS.some((pattern) => pattern.test(query));
+    const hasCTEs = CTE_PATTERN.test(query);
+    const hasRecursiveCTE = RECURSIVE_CTE_PATTERN.test(query);
+    const hasSubqueries = SUBQUERY_PATTERN.test(query);
+    const hasUnion = UNION_PATTERN.test(query);
+    const hasIntersect = INTERSECT_PATTERN.test(query);
+    const hasExcept = EXCEPT_PATTERN.test(query);
+    const hasGroupBy = GROUP_BY_PATTERN.test(query);
+    const hasHaving = HAVING_PATTERN.test(query);
+    const hasOrderBy = ORDER_BY_PATTERN.test(query);
+    const hasDistinct = DISTINCT_PATTERN.test(query);
+    const tableCount = countTables(query);
+    // Estimate complexity
+    let complexityScore = 0;
+    if (hasJoins || hasImplicitJoin)
+        complexityScore += 2;
+    if (hasWindowFunctions)
+        complexityScore += 2;
+    if (hasCTEs)
+        complexityScore += 2;
+    if (hasRecursiveCTE)
+        complexityScore += 3;
+    if (hasSubqueries)
+        complexityScore += 1;
+    if (hasUnion || hasIntersect || hasExcept)
+        complexityScore += 1;
+    let estimatedComplexity;
+    if (complexityScore === 0) {
+        estimatedComplexity = 'simple';
+    }
+    else if (complexityScore <= 2) {
+        estimatedComplexity = 'medium';
+    }
+    else {
+        estimatedComplexity = 'complex';
+    }
+    return {
+        hasJoins,
+        hasImplicitJoin,
+        hasWindowFunctions,
+        hasCTEs,
+        hasRecursiveCTE,
+        hasSubqueries,
+        hasUnion,
+        hasIntersect,
+        hasExcept,
+        hasGroupBy,
+        hasHaving,
+        hasOrderBy,
+        hasDistinct,
+        tableCount,
+        estimatedComplexity,
+    };
+}
+// ============================================================================
+// Convenience Functions
+// ============================================================================
+/**
+ * Create a query router with the given config
+ */
+export function createQueryRouter(config = {}) {
+    return new QueryRouter(config);
+}
+/**
+ * Route a query using a default router configuration
+ */
+export function routeQuery(options, config = {}) {
+    const router = new QueryRouter(config);
+    return router.route(options);
+}
+//# sourceMappingURL=router.js.map

package/dist/olap/stage/router.js.map

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

package/dist/rpc/endpoint.d.ts

@@ -0,0 +1,52 @@
+/**
+ * RPC Endpoint - Workers RPC handler for MondoBackend operations
+ *
+ * Implements:
+ * - HTTP POST /rpc endpoint for JSON-RPC style calls
+ * - Request validation and routing
+ * - MongoDB-compatible error codes
+ * - CORS support
+ * - Authentication (optional)
+ */
+import type { ExecutionContext } from './worker-entrypoint';
+import type { DurableObjectNamespace, RpcHandler } from '../types/rpc';
+export type { RpcHandler };
+/**
+ * Environment with MONDO_DATABASE Durable Object binding
+ */
+export interface RpcEnv {
+    MONDO_DATABASE: DurableObjectNamespace;
+    MONDO_AUTH_TOKEN?: string;
+}
+/**
+ * Create an RPC handler for the given environment
+ */
+export declare function createRpcHandler(env: RpcEnv, _ctx: ExecutionContext): RpcHandler;
+/**
+ * JSON-RPC 2.0 Handler interface
+ *
+ * This handler implements the JSON-RPC 2.0 specification:
+ * - Request: { jsonrpc: "2.0", id: string|number, method: string, params: object|array }
+ * - Response: { jsonrpc: "2.0", id: string|number, result: any }
+ * - Error: { jsonrpc: "2.0", id: string|number|null, error: { code, message, data? } }
+ */
+export interface JsonRpcHandler {
+    fetch(request: Request): Promise<Response>;
+}
+/**
+ * Create a JSON-RPC 2.0 handler for the given environment
+ *
+ * Implements JSON-RPC 2.0 protocol support:
+ * - Parse JSON-RPC formatted requests
+ * - Return JSON-RPC formatted responses
+ * - Handle batch requests
+ * - Support notifications (requests without id)
+ * - Return standard JSON-RPC error codes:
+ *   - -32700: Parse error
+ *   - -32600: Invalid Request
+ *   - -32601: Method not found
+ *   - -32602: Invalid params
+ *   - -32603: Internal error
+ */
+export declare function createJsonRpcHandler(env: RpcEnv, _ctx: ExecutionContext): JsonRpcHandler;
+//# sourceMappingURL=endpoint.d.ts.map

package/dist/rpc/endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.d.ts","sourceRoot":"","sources":["../../src/rpc/endpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,KAAK,EACV,sBAAsB,EAItB,UAAU,EACX,MAAM,cAAc,CAAA;AAIrB,YAAY,EAAE,UAAU,EAAE,CAAA;AAE1B;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,cAAc,EAAE,sBAAsB,CAAA;IACtC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AA+LD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,UAAU,CA+GhF;AA0ND;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;CAC3C;AAgFD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,cAAc,CA4ExF"}