@devrev/meerkat-node 0.0.122 → 0.0.124

package/src/__tests__/comprehensive/helpers/test-helpers.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Test Helper Utilities
+ *
+ * Common utilities for Vitest-based comprehensive tests
+ */
+/**
+ * Batch Error Reporter
+ *
+ * Collects multiple test failures and reports them together
+ * instead of failing on the first error. Useful for data-driven tests.
+ */
+export declare class BatchErrorReporter {
+    private errors;
+    /**
+     * Add an error to the batch
+     */
+    addError(testCase: string, error: Error, context?: any): void;
+    /**
+     * Check if there are any errors
+     */
+    hasErrors(): boolean;
+    /**
+     * Get count of errors
+     */
+    getErrorCount(): number;
+    /**
+     * Get all errors
+     */
+    getErrors(): {
+        testCase: string;
+        error: Error;
+        context?: any;
+    }[];
+    /**
+     * Throw if there are any errors, with a comprehensive report
+     */
+    throwIfErrors(): void;
+    /**
+     * Clear all errors
+     */
+    clear(): void;
+}
+/**
+ * Compare numeric values with tolerance for floating-point precision
+ */
+export declare function compareNumbers(actual: number, expected: number, tolerance?: number): boolean;
+/**
+ * Compare query results with tolerance for numeric fields
+ */
+export declare function compareResults(actual: any[], expected: any[], options?: {
+    numericTolerance?: number;
+    ignoreOrder?: boolean;
+    ignoreFields?: string[];
+}): {
+    match: boolean;
+    diff?: string;
+};
+/**
+ * Create a reference SQL query for validation
+ * This is the "oracle" pattern - we create direct SQL to validate Meerkat's output
+ */
+export declare function createReferenceSQL(options: {
+    select: string[];
+    from: string;
+    where?: string;
+    groupBy?: string[];
+    orderBy?: string[];
+    limit?: number;
+}): string;
+/**
+ * Measure execution time of a function
+ */
+export declare function measureExecutionTime<T>(fn: () => Promise<T>): Promise<{
+    result: T;
+    duration: number;
+}>;
+/**
+ * Validate query performance against a budget
+ */
+export declare function validatePerformance(duration: number, budgetMs: number, queryDescription: string): void;
+/**
+ * Execute a reference SQL and validate against Meerkat result
+ */
+export declare function validateAgainstReference(meerkatResult: any[], referenceSQL: string, options?: {
+    numericTolerance?: number;
+    ignoreOrder?: boolean;
+    ignoreFields?: string[];
+}): Promise<void>;
+/**
+ * Generate test cases for a data-driven test
+ */
+export declare function generateTestCases<T>(template: T, variations: Array<Partial<T>>): T[];
+/**
+ * Format SQL for error messages (truncate if too long)
+ */
+export declare function formatSQL(sql: string, maxLength?: number): string;
+/**
+ * Retry a function with exponential backoff
+ * Useful for flaky operations
+ */
+export declare function retryWithBackoff<T>(fn: () => Promise<T>, options?: {
+    maxRetries?: number;
+    initialDelay?: number;
+    maxDelay?: number;
+    backoffMultiplier?: number;
+}): Promise<T>;

package/src/__tests__/comprehensive/synthetic/schema-setup.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Synthetic Schema Setup
+ *
+ * Creates comprehensive test tables with 1M+ rows covering all data types
+ * and patterns used in production Meerkat queries.
+ */
+/**
+ * Create the comprehensive fact_all_types table
+ * This table contains ~100 columns covering all normalized DB types
+ */
+export declare function createFactAllTypesTable(): Promise<void>;
+/**
+ * Create dimension table: dim_user
+ */
+export declare function createDimUserTable(): Promise<void>;
+/**
+ * Create dimension table: dim_part
+ */
+export declare function createDimPartTable(): Promise<void>;
+/**
+ * Create all synthetic tables in one go
+ */
+export declare function createAllSyntheticTables(): Promise<void>;
+/**
+ * Drop all synthetic tables (for cleanup)
+ */
+export declare function dropSyntheticTables(): Promise<void>;
+/**
+ * Verify tables exist and have data
+ */
+export declare function verifySyntheticTables(): Promise<void>;

package/src/__tests__/comprehensive/synthetic/table-schemas.d.ts

@@ -0,0 +1,123 @@
+/**
+ * TableSchema Definitions for Synthetic Test Tables
+ *
+ * These schemas match the synthetic tables created in schema-setup.ts
+ * and follow the same conventions as production Meerkat schemas.
+ */
+export declare const FACT_ALL_TYPES_SCHEMA: {
+    name: string;
+    sql: string;
+    measures: {
+        name: string;
+        sql: string;
+        type: string;
+    }[];
+    dimensions: {
+        name: string;
+        sql: string;
+        type: string;
+    }[];
+};
+export declare const DIM_USER_SCHEMA: {
+    name: string;
+    sql: string;
+    measures: {
+        name: string;
+        sql: string;
+        type: string;
+    }[];
+    dimensions: {
+        name: string;
+        sql: string;
+        type: string;
+    }[];
+    joins: {
+        name: string;
+        relationship: string;
+        sql: string;
+    }[];
+};
+export declare const DIM_PART_SCHEMA: {
+    name: string;
+    sql: string;
+    measures: {
+        name: string;
+        sql: string;
+        type: string;
+    }[];
+    dimensions: {
+        name: string;
+        sql: string;
+        type: string;
+    }[];
+    joins: {
+        name: string;
+        relationship: string;
+        sql: string;
+    }[];
+};
+/**
+ * Helper to get all schemas as an array
+ */
+export declare function getAllSchemas(): {
+    name: string;
+    sql: string;
+    measures: {
+        name: string;
+        sql: string;
+        type: string;
+    }[];
+    dimensions: {
+        name: string;
+        sql: string;
+        type: string;
+    }[];
+}[];
+/**
+ * Helper to get just the fact schema
+ */
+export declare function getFactSchema(): {
+    name: string;
+    sql: string;
+    measures: {
+        name: string;
+        sql: string;
+        type: string;
+    }[];
+    dimensions: {
+        name: string;
+        sql: string;
+        type: string;
+    }[];
+};
+/**
+ * Helper to get fact + one dimension
+ */
+export declare function getFactWithUserSchema(): {
+    name: string;
+    sql: string;
+    measures: {
+        name: string;
+        sql: string;
+        type: string;
+    }[];
+    dimensions: {
+        name: string;
+        sql: string;
+        type: string;
+    }[];
+}[];
+export declare function getFactWithPartSchema(): {
+    name: string;
+    sql: string;
+    measures: {
+        name: string;
+        sql: string;
+        type: string;
+    }[];
+    dimensions: {
+        name: string;
+        sql: string;
+        type: string;
+    }[];
+}[];

package/src/ensure-table-schema-alias/ensure-table-schema-alias.d.ts

@@ -0,0 +1,3 @@
+import { TableSchema } from '@devrev/meerkat-core';
+export declare const ensureTableSchemasAlias: (tableSchemas: TableSchema[]) => Promise<TableSchema[]>;
+export declare const ensureTableSchemaAlias: () => (tableSchemas: TableSchema[]) => Promise<TableSchema[]>;

package/src/index.d.ts

@@ -4,3 +4,4 @@ export * from './duckdb-manager/duckdb-manager';
 export * from './duckdb-singleton';
 export * from './file-manager/file-manager';
 export * from './node-sql-to-serialization';
+export * from './ensure-table-schema-alias/ensure-table-schema-alias';