mongo.do 0.1.0

package/dist/olap/stage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/olap/stage/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC"}

package/dist/olap/stage/index.js

@@ -0,0 +1,6 @@
+/**
+ * $olap Stage - OLAP Query Routing for MongoDB Aggregation Pipelines
+ */
+export * from './parser';
+export * from './router';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/olap/stage/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC"}

package/dist/olap/stage/parser.d.ts

@@ -0,0 +1,68 @@
+/**
+ * $olap Stage Parser
+ *
+ * Parses and validates the $olap aggregation stage for routing analytical
+ * queries to OLAP engines (R2 SQL, ClickHouse) from within MongoDB pipelines.
+ */
+export type OlapEngine = 'r2sql' | 'clickhouse' | 'auto';
+export interface StructuredQuery {
+    select: string[];
+    from: string;
+    where?: Record<string, unknown>;
+    groupBy?: string[];
+    having?: Record<string, unknown>;
+    orderBy?: Array<{
+        field: string;
+        direction: 'ASC' | 'DESC';
+    }>;
+    limit?: number;
+    offset?: number;
+}
+export type OlapQuery = string | StructuredQuery;
+export interface PartitionOptions {
+    column: string;
+    start?: string | number | Date;
+    end?: string | number | Date;
+    interval?: 'day' | 'week' | 'month' | 'quarter' | 'year';
+    step?: number;
+}
+export interface OlapSettings {
+    max_threads?: number;
+    max_memory_usage?: number;
+}
+export interface OlapStageOptions {
+    engine: OlapEngine;
+    query: OlapQuery;
+    partition?: PartitionOptions;
+    parameters?: Record<string, unknown>;
+    timeout?: number;
+    maxRows?: number;
+    outputFormat?: string;
+    settings?: OlapSettings;
+}
+export interface OlapStageParseResult {
+    isValid: boolean;
+    options?: OlapStageOptions;
+    error?: string;
+    warnings?: string[];
+    originalStage?: Record<string, unknown>;
+}
+export declare class OlapStageParser {
+    /**
+     * Parse a $olap stage from an aggregation pipeline
+     */
+    parse(stage: Record<string, unknown>): OlapStageParseResult;
+    private _validateEngine;
+    private _validateQuery;
+    private _validatePartition;
+    private _validateParameters;
+}
+/**
+ * Parse an $olap stage using a new parser instance
+ */
+export declare function parseOlapStage(stage: Record<string, unknown>): OlapStageParseResult;
+/**
+ * Validate $olap stage options
+ */
+export declare function validateOlapStageOptions(options: unknown): OlapStageParseResult;
+//# sourceMappingURL=parser.d.ts.map

package/dist/olap/stage/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/olap/stage/parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,YAAY,GAAG,MAAM,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,eAAe,CAAC;AAEjD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACzD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAgBD,qBAAa,eAAe;IAC1B;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,oBAAoB;IAqI3D,OAAO,CAAC,eAAe;IAuBvB,OAAO,CAAC,cAAc;IAmEtB,OAAO,CAAC,kBAAkB;IAgD1B,OAAO,CAAC,mBAAmB;CAqB5B;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,oBAAoB,CAGnF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,oBAAoB,CAU/E"}

package/dist/olap/stage/parser.js

@@ -0,0 +1,293 @@
+/**
+ * $olap Stage Parser
+ *
+ * Parses and validates the $olap aggregation stage for routing analytical
+ * queries to OLAP engines (R2 SQL, ClickHouse) from within MongoDB pipelines.
+ */
+// ============================================================================
+// Constants
+// ============================================================================
+const VALID_ENGINES = ['r2sql', 'clickhouse', 'auto'];
+const VALID_INTERVALS = ['day', 'week', 'month', 'quarter', 'year'];
+const VALID_OUTPUT_FORMATS = ['documents', 'array', 'cursor'];
+const DISALLOWED_STATEMENTS = ['INSERT', 'UPDATE', 'DELETE', 'DROP', 'TRUNCATE', 'ALTER', 'CREATE'];
+const KNOWN_OPTIONS = ['engine', 'query', 'partition', 'parameters', 'timeout', 'maxRows', 'outputFormat', 'settings'];
+// ============================================================================
+// OlapStageParser Class
+// ============================================================================
+export class OlapStageParser {
+    /**
+     * Parse a $olap stage from an aggregation pipeline
+     */
+    parse(stage) {
+        const olapSpec = stage.$olap;
+        if (!olapSpec || typeof olapSpec !== 'object') {
+            return {
+                isValid: false,
+                error: 'Invalid $olap stage: expected object',
+            };
+        }
+        const spec = olapSpec;
+        const warnings = [];
+        // Check for unknown options and add warnings
+        for (const key of Object.keys(spec)) {
+            if (!KNOWN_OPTIONS.includes(key)) {
+                warnings.push(key);
+            }
+        }
+        // Validate engine
+        const engineResult = this._validateEngine(spec.engine);
+        if (!engineResult.isValid) {
+            return engineResult;
+        }
+        // Validate query
+        const queryResult = this._validateQuery(spec.query);
+        if (!queryResult.isValid) {
+            return queryResult;
+        }
+        // Validate partition options if present
+        if (spec.partition !== undefined) {
+            const partitionResult = this._validatePartition(spec.partition);
+            if (!partitionResult.isValid) {
+                return partitionResult;
+            }
+        }
+        // Validate parameters if present
+        if (spec.parameters !== undefined) {
+            const paramsResult = this._validateParameters(spec.parameters);
+            if (!paramsResult.isValid) {
+                return paramsResult;
+            }
+        }
+        // Validate timeout if present
+        if (spec.timeout !== undefined) {
+            if (typeof spec.timeout !== 'number') {
+                return {
+                    isValid: false,
+                    error: 'Invalid timeout: expected number',
+                };
+            }
+            if (spec.timeout < 0) {
+                return {
+                    isValid: false,
+                    error: 'Invalid timeout: must be a positive number',
+                };
+            }
+        }
+        // Validate maxRows if present
+        if (spec.maxRows !== undefined) {
+            if (typeof spec.maxRows !== 'number') {
+                return {
+                    isValid: false,
+                    error: 'Invalid maxRows: expected number',
+                };
+            }
+            if (spec.maxRows > 10000000) {
+                return {
+                    isValid: false,
+                    error: 'Invalid maxRows: exceeds system limit of 10000000',
+                };
+            }
+        }
+        // Validate outputFormat if present
+        if (spec.outputFormat !== undefined) {
+            if (typeof spec.outputFormat !== 'string' || !VALID_OUTPUT_FORMATS.includes(spec.outputFormat)) {
+                return {
+                    isValid: false,
+                    error: `Invalid outputFormat: must be one of ${VALID_OUTPUT_FORMATS.join(', ')}`,
+                };
+            }
+        }
+        // Build valid options
+        const options = {
+            engine: spec.engine || 'auto',
+            query: spec.query,
+        };
+        if (spec.partition) {
+            options.partition = spec.partition;
+        }
+        if (spec.parameters) {
+            options.parameters = spec.parameters;
+        }
+        if (spec.timeout !== undefined) {
+            options.timeout = spec.timeout;
+        }
+        if (spec.maxRows !== undefined) {
+            options.maxRows = spec.maxRows;
+        }
+        if (spec.outputFormat !== undefined) {
+            options.outputFormat = spec.outputFormat;
+        }
+        if (spec.settings !== undefined) {
+            options.settings = spec.settings;
+        }
+        const result = {
+            isValid: true,
+            options,
+            originalStage: stage,
+        };
+        if (warnings.length > 0) {
+            result.warnings = warnings;
+        }
+        return result;
+    }
+    _validateEngine(engine) {
+        if (engine === undefined) {
+            // Default to auto
+            return { isValid: true };
+        }
+        if (typeof engine !== 'string') {
+            return {
+                isValid: false,
+                error: 'Invalid engine: expected string',
+            };
+        }
+        if (!VALID_ENGINES.includes(engine)) {
+            return {
+                isValid: false,
+                error: `Invalid engine '${engine}': must be one of ${VALID_ENGINES.join(', ')}`,
+            };
+        }
+        return { isValid: true };
+    }
+    _validateQuery(query) {
+        if (query === undefined || query === null) {
+            return {
+                isValid: false,
+                error: 'Missing required field: query',
+            };
+        }
+        // String query
+        if (typeof query === 'string') {
+            if (query.trim() === '') {
+                return {
+                    isValid: false,
+                    error: 'Invalid query: cannot be empty',
+                };
+            }
+            // Check for multiple statements first
+            const statements = query.split(';').filter((s) => s.trim().length > 0);
+            if (statements.length > 1) {
+                return {
+                    isValid: false,
+                    error: 'Invalid query: multiple statements not allowed',
+                };
+            }
+            // Check for disallowed statements
+            const upperQuery = query.toUpperCase();
+            for (const stmt of DISALLOWED_STATEMENTS) {
+                if (upperQuery.includes(stmt)) {
+                    return {
+                        isValid: false,
+                        error: `Disallowed statement: ${stmt} is not permitted in OLAP queries`,
+                    };
+                }
+            }
+            return { isValid: true };
+        }
+        // Structured query object
+        if (typeof query === 'object') {
+            const q = query;
+            if (!q.select || !Array.isArray(q.select)) {
+                return {
+                    isValid: false,
+                    error: 'Invalid query: structured query requires select array',
+                };
+            }
+            if (!q.from || typeof q.from !== 'string') {
+                return {
+                    isValid: false,
+                    error: 'Invalid query: structured query requires from string',
+                };
+            }
+            return { isValid: true };
+        }
+        return {
+            isValid: false,
+            error: 'Invalid query: expected string or structured query object',
+        };
+    }
+    _validatePartition(partition) {
+        if (typeof partition !== 'object' || partition === null) {
+            return {
+                isValid: false,
+                error: 'Invalid partition: expected object',
+            };
+        }
+        const p = partition;
+        if (!p.column || typeof p.column !== 'string') {
+            return {
+                isValid: false,
+                error: 'Invalid partition: column is required',
+            };
+        }
+        if (p.interval !== undefined) {
+            if (typeof p.interval !== 'string' || !VALID_INTERVALS.includes(p.interval)) {
+                return {
+                    isValid: false,
+                    error: `Invalid partition interval: must be one of ${VALID_INTERVALS.join(', ')}`,
+                };
+            }
+        }
+        if (p.step !== undefined && typeof p.step !== 'number') {
+            return {
+                isValid: false,
+                error: 'Invalid partition step: expected number',
+            };
+        }
+        // Validate that end is after start
+        if (p.start !== undefined && p.end !== undefined) {
+            const start = typeof p.start === 'string' ? new Date(p.start).getTime() : p.start;
+            const end = typeof p.end === 'string' ? new Date(p.end).getTime() : p.end;
+            if (end < start) {
+                return {
+                    isValid: false,
+                    error: 'Invalid partition: end must be after start',
+                };
+            }
+        }
+        return { isValid: true };
+    }
+    _validateParameters(parameters) {
+        if (typeof parameters !== 'object' || parameters === null) {
+            return {
+                isValid: false,
+                error: 'Invalid parameters: expected object',
+            };
+        }
+        const params = parameters;
+        for (const [key, value] of Object.entries(params)) {
+            if (typeof value === 'function') {
+                return {
+                    isValid: false,
+                    error: `Invalid parameter '${key}': functions are not allowed`,
+                };
+            }
+        }
+        return { isValid: true };
+    }
+}
+// ============================================================================
+// Convenience Functions
+// ============================================================================
+/**
+ * Parse an $olap stage using a new parser instance
+ */
+export function parseOlapStage(stage) {
+    const parser = new OlapStageParser();
+    return parser.parse(stage);
+}
+/**
+ * Validate $olap stage options
+ */
+export function validateOlapStageOptions(options) {
+    if (!options || typeof options !== 'object') {
+        return {
+            isValid: false,
+            error: 'Invalid options: expected object',
+        };
+    }
+    const parser = new OlapStageParser();
+    return parser.parse({ $olap: options });
+}
+//# sourceMappingURL=parser.js.map

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

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

package/dist/olap/stage/router.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Query Router for $olap Stage
+ *
+ * Routes analytical queries to the appropriate OLAP engine based on
+ * query complexity, features used, and engine availability.
+ */
+import type { OlapStageOptions, OlapEngine } from './parser';
+export interface EngineAvailability {
+    r2sql: boolean;
+    clickhouse: boolean;
+}
+export interface EngineCapabilities {
+    supportsJoins: boolean;
+    supportsWindowFunctions: boolean;
+    supportsCTEs: boolean;
+    supportsSubqueries: boolean;
+    maxConcurrentQueries: number;
+    maxRowsPerQuery: number;
+    supportedFunctions: string[];
+}
+export interface QueryFeatures {
+    hasJoins: boolean;
+    hasImplicitJoin: boolean;
+    hasWindowFunctions: boolean;
+    hasCTEs: boolean;
+    hasRecursiveCTE: boolean;
+    hasSubqueries: boolean;
+    hasUnion: boolean;
+    hasIntersect: boolean;
+    hasExcept: boolean;
+    hasGroupBy: boolean;
+    hasHaving: boolean;
+    hasOrderBy: boolean;
+    hasDistinct: boolean;
+    tableCount: number;
+    estimatedComplexity: 'simple' | 'medium' | 'complex';
+    estimatedResultSize?: number;
+}
+export interface RoutingDecision {
+    engine: OlapEngine;
+    reason: string;
+    features?: QueryFeatures;
+    overridden?: boolean;
+    fallback?: boolean;
+    warnings?: string[];
+    mayFail?: boolean;
+    timestamp?: number;
+    routerVersion?: string;
+    estimatedRows?: number;
+    complexity?: 'low' | 'medium' | 'high';
+}
+export interface CostFactors {
+    baseCost: number;
+    perRowCost: number;
+}
+export interface QueryRouterConfig {
+    availability?: EngineAvailability;
+    capabilities?: Record<string, EngineCapabilities>;
+    defaultEngine?: OlapEngine;
+    preferEngine?: OlapEngine;
+    enableCostBasedRouting?: boolean;
+    costFactors?: Record<string, CostFactors>;
+}
+export declare class QueryRouter {
+    private _config;
+    constructor(config?: QueryRouterConfig);
+    /**
+     * Map feature complexity to decision complexity
+     */
+    private _mapComplexity;
+    /**
+     * Add metadata to routing decision
+     */
+    private _addMetadata;
+    /**
+     * Route a query to the appropriate OLAP engine
+     */
+    route(options: OlapStageOptions): RoutingDecision;
+    private _handleExplicitEngine;
+    private _autoSelectEngine;
+}
+/**
+ * Detect query features for routing decisions
+ */
+export declare function detectQueryFeatures(query: string): QueryFeatures;
+/**
+ * Create a query router with the given config
+ */
+export declare function createQueryRouter(config?: QueryRouterConfig): QueryRouter;
+/**
+ * Route a query using a default router configuration
+ */
+export declare function routeQuery(options: OlapStageOptions, config?: QueryRouterConfig): RoutingDecision;
+//# sourceMappingURL=router.d.ts.map

package/dist/olap/stage/router.d.ts.map

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