@tejasanik/postgres-mcp-server 2.1.0 → 2.2.0

package/dist/tools/sql/utils/file-handler.js

@@ -0,0 +1,150 @@
+/**
+ * File Handler Utilities
+ *
+ * Functions for validating and processing SQL files.
+ * Handles file validation, reading, and preprocessing.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { MAX_SQL_FILE_SIZE } from './constants.js';
+/**
+ * Validates a SQL file path and returns file information.
+ *
+ * @param filePath - Path to the SQL file
+ * @returns Validation result with resolved path and file size
+ */
+export function validateSqlFile(filePath) {
+    // Check file extension
+    const ext = path.extname(filePath).toLowerCase();
+    if (ext !== '.sql') {
+        return {
+            isValid: false,
+            resolvedPath: '',
+            fileSize: 0,
+            error: 'Only .sql files are allowed. Received file extension: ' + ext,
+        };
+    }
+    // Resolve path
+    const resolvedPath = path.resolve(filePath);
+    // Check file exists
+    if (!fs.existsSync(resolvedPath)) {
+        return {
+            isValid: false,
+            resolvedPath,
+            fileSize: 0,
+            error: `File not found: ${filePath}`,
+        };
+    }
+    // Get file stats
+    const stats = fs.statSync(resolvedPath);
+    // Check it's a file
+    if (!stats.isFile()) {
+        return {
+            isValid: false,
+            resolvedPath,
+            fileSize: 0,
+            error: `Not a file: ${filePath}`,
+        };
+    }
+    // Check file size
+    if (stats.size > MAX_SQL_FILE_SIZE) {
+        return {
+            isValid: false,
+            resolvedPath,
+            fileSize: stats.size,
+            error: `File too large: ${formatFileSize(stats.size)}. Maximum allowed: ${formatFileSize(MAX_SQL_FILE_SIZE)}`,
+        };
+    }
+    // Check file not empty
+    if (stats.size === 0) {
+        return {
+            isValid: false,
+            resolvedPath,
+            fileSize: 0,
+            error: 'File is empty',
+        };
+    }
+    return {
+        isValid: true,
+        resolvedPath,
+        fileSize: stats.size,
+    };
+}
+/**
+ * Reads a SQL file and optionally preprocesses it.
+ *
+ * @param resolvedPath - Resolved path to the SQL file
+ * @param stripPatterns - Optional patterns to remove from content
+ * @param stripAsRegex - If true, patterns are regex; if false, literal strings
+ * @returns Preprocessed SQL content
+ */
+export function readSqlFile(resolvedPath, stripPatterns, stripAsRegex = false) {
+    let content = fs.readFileSync(resolvedPath, 'utf-8');
+    if (stripPatterns && stripPatterns.length > 0) {
+        content = preprocessSqlContent(content, stripPatterns, stripAsRegex);
+    }
+    return content;
+}
+/**
+ * Preprocess SQL content by removing patterns.
+ * Supports both literal string matching and regex patterns.
+ *
+ * @param sql - The SQL content to preprocess
+ * @param patterns - Array of patterns to remove from SQL content
+ * @param isRegex - If true, patterns are treated as regex; if false, as literal strings
+ * @returns Preprocessed SQL content
+ */
+export function preprocessSqlContent(sql, patterns, isRegex = false) {
+    let result = sql;
+    for (const pattern of patterns) {
+        try {
+            if (isRegex) {
+                // Treat as regex pattern (multiline by default)
+                const regex = new RegExp(pattern, 'gm');
+                result = result.replace(regex, '');
+            }
+            else {
+                // Treat as literal string - escape and match on its own line
+                const escapedPattern = pattern.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+                const regex = new RegExp(`^\\s*${escapedPattern}\\s*$`, 'gm');
+                result = result.replace(regex, '');
+            }
+        }
+        catch (error) {
+            // Invalid regex - skip this pattern silently in production
+            // Log only in non-production for debugging
+            if (process.env.NODE_ENV !== 'production') {
+                console.error(`Warning: Invalid pattern "${pattern}": ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Format file size in human-readable format.
+ *
+ * @param bytes - File size in bytes
+ * @returns Human-readable file size (e.g., "1.5 MB")
+ */
+export function formatFileSize(bytes) {
+    if (bytes === 0)
+        return '0 B';
+    const units = ['B', 'KB', 'MB', 'GB'];
+    const base = 1024;
+    const unitIndex = Math.min(Math.floor(Math.log(bytes) / Math.log(base)), units.length - 1);
+    const size = bytes / Math.pow(base, unitIndex);
+    return `${size.toFixed(unitIndex > 0 ? 1 : 0)} ${units[unitIndex]}`;
+}
+/**
+ * Ensure a file path is safe (no path traversal attacks).
+ *
+ * @param basePath - Base directory path
+ * @param filePath - File path to validate
+ * @returns True if the file path is within the base path
+ */
+export function isPathSafe(basePath, filePath) {
+    const resolvedBase = path.resolve(basePath);
+    const resolvedFile = path.resolve(filePath);
+    return resolvedFile.startsWith(resolvedBase);
+}
+//# sourceMappingURL=file-handler.js.map

package/dist/tools/sql/utils/file-handler.js.map

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

package/dist/tools/sql/utils/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * SQL Tools Utilities
+ *
+ * Re-exports all utility modules for convenient importing.
+ */
+export * from './constants.js';
+export * from './connection-utils.js';
+export * from './dry-run-utils.js';
+export * from './file-handler.js';
+export * from './result-formatter.js';
+export * from './sql-parser.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/sql/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/sql/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC"}

package/dist/tools/sql/utils/index.js

@@ -0,0 +1,12 @@
+/**
+ * SQL Tools Utilities
+ *
+ * Re-exports all utility modules for convenient importing.
+ */
+export * from './constants.js';
+export * from './connection-utils.js';
+export * from './dry-run-utils.js';
+export * from './file-handler.js';
+export * from './result-formatter.js';
+export * from './sql-parser.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/sql/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tools/sql/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC"}

package/dist/tools/sql/utils/result-formatter.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Result Formatter Utilities
+ *
+ * Functions for formatting query results, handling large outputs,
+ * and timing measurements.
+ */
+/**
+ * Result of large output handling.
+ */
+export interface LargeOutputResult {
+    truncated: boolean;
+    outputFile?: string;
+    rows: unknown[];
+}
+/**
+ * Calculate execution time from hrtime bigints.
+ *
+ * @param startTime - Start time from process.hrtime.bigint()
+ * @param endTime - End time from process.hrtime.bigint()
+ * @returns Execution time in milliseconds (rounded to 2 decimal places)
+ */
+export declare function calculateExecutionTime(startTime: bigint, endTime: bigint): number;
+/**
+ * Get current time for timing measurements.
+ *
+ * @returns Current high-resolution time as bigint
+ */
+export declare function getStartTime(): bigint;
+/**
+ * Handle potentially large output by writing to file if necessary.
+ *
+ * @param rows - Result rows to check
+ * @param maxChars - Maximum characters before writing to file
+ * @returns Object with truncated flag, optional file path, and rows
+ */
+export declare function handleLargeOutput(rows: unknown[], maxChars?: number): LargeOutputResult;
+/**
+ * Paginate result rows.
+ *
+ * @param rows - All result rows
+ * @param offset - Number of rows to skip
+ * @param maxRows - Maximum rows to return
+ * @returns Paginated rows and metadata
+ */
+export declare function paginateRows(rows: unknown[], offset: number, maxRows: number): {
+    rows: unknown[];
+    offset: number;
+    hasMore: boolean;
+    totalCount: number;
+};
+/**
+ * Truncate SQL for display in error messages or previews.
+ *
+ * @param sql - SQL string to truncate
+ * @param maxLength - Maximum length (default: 200)
+ * @returns Truncated SQL with ellipsis if needed
+ */
+export declare function truncateSql(sql: string, maxLength?: number): string;
+/**
+ * Format field names from query result.
+ *
+ * @param fields - Array of field objects from pg result
+ * @returns Array of field names
+ */
+export declare function formatFieldNames(fields: Array<{
+    name: string;
+}>): string[];
+/**
+ * Create a summary message for statement execution.
+ *
+ * @param totalStatements - Total number of statements
+ * @param successCount - Number of successful statements
+ * @param failureCount - Number of failed statements
+ * @param skippedCount - Number of skipped statements
+ * @param rolledBack - Whether changes were rolled back
+ * @returns Summary message string
+ */
+export declare function createExecutionSummary(totalStatements: number, successCount: number, failureCount: number, skippedCount: number, rolledBack: boolean): string;
+/**
+ * Count statements by type.
+ *
+ * @param types - Array of statement types
+ * @returns Object with counts by type
+ */
+export declare function countStatementsByType(types: string[]): Record<string, number>;
+/**
+ * Create a human-readable file summary.
+ *
+ * @param statementsByType - Statement counts by type
+ * @param totalStatements - Total statement count
+ * @returns Summary string
+ */
+export declare function createFileSummary(statementsByType: Record<string, number>, totalStatements: number): string;
+//# sourceMappingURL=result-formatter.d.ts.map

package/dist/tools/sql/utils/result-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-formatter.d.ts","sourceRoot":"","sources":["../../../../src/tools/sql/utils/result-formatter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,OAAO,EAAE,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,OAAO,EAAE,EACf,QAAQ,GAAE,MAAyB,GAClC,iBAAiB,CAmBnB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,OAAO,EAAE,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd;IACD,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB,CAWA;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,GAAE,MAAY,GAAG,MAAM,CAMxE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,MAAM,EAAE,CAE1E;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,OAAO,GAClB,MAAM,CAwBR;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQ7E;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACxC,eAAe,EAAE,MAAM,GACtB,MAAM,CAOR"}

package/dist/tools/sql/utils/result-formatter.js

@@ -0,0 +1,154 @@
+/**
+ * Result Formatter Utilities
+ *
+ * Functions for formatting query results, handling large outputs,
+ * and timing measurements.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { v4 as uuidv4 } from 'uuid';
+import { MAX_OUTPUT_CHARS } from './constants.js';
+/**
+ * Calculate execution time from hrtime bigints.
+ *
+ * @param startTime - Start time from process.hrtime.bigint()
+ * @param endTime - End time from process.hrtime.bigint()
+ * @returns Execution time in milliseconds (rounded to 2 decimal places)
+ */
+export function calculateExecutionTime(startTime, endTime) {
+    return Math.round((Number(endTime - startTime) / 1_000_000) * 100) / 100;
+}
+/**
+ * Get current time for timing measurements.
+ *
+ * @returns Current high-resolution time as bigint
+ */
+export function getStartTime() {
+    return process.hrtime.bigint();
+}
+/**
+ * Handle potentially large output by writing to file if necessary.
+ *
+ * @param rows - Result rows to check
+ * @param maxChars - Maximum characters before writing to file
+ * @returns Object with truncated flag, optional file path, and rows
+ */
+export function handleLargeOutput(rows, maxChars = MAX_OUTPUT_CHARS) {
+    const output = JSON.stringify(rows);
+    if (output.length <= maxChars) {
+        return { truncated: false, rows };
+    }
+    // Write to temp file
+    const tempDir = os.tmpdir();
+    const fileName = `sql-result-${uuidv4()}.json`;
+    const filePath = path.join(tempDir, fileName);
+    fs.writeFileSync(filePath, output, { mode: 0o600 });
+    return {
+        truncated: true,
+        outputFile: filePath,
+        rows: [], // Return empty rows since output is in file
+    };
+}
+/**
+ * Paginate result rows.
+ *
+ * @param rows - All result rows
+ * @param offset - Number of rows to skip
+ * @param maxRows - Maximum rows to return
+ * @returns Paginated rows and metadata
+ */
+export function paginateRows(rows, offset, maxRows) {
+    const totalCount = rows.length;
+    const paginatedRows = rows.slice(offset, offset + maxRows);
+    const hasMore = offset + paginatedRows.length < totalCount;
+    return {
+        rows: paginatedRows,
+        offset,
+        hasMore,
+        totalCount,
+    };
+}
+/**
+ * Truncate SQL for display in error messages or previews.
+ *
+ * @param sql - SQL string to truncate
+ * @param maxLength - Maximum length (default: 200)
+ * @returns Truncated SQL with ellipsis if needed
+ */
+export function truncateSql(sql, maxLength = 200) {
+    const trimmed = sql.trim();
+    if (trimmed.length <= maxLength) {
+        return trimmed;
+    }
+    return trimmed.substring(0, maxLength) + '...';
+}
+/**
+ * Format field names from query result.
+ *
+ * @param fields - Array of field objects from pg result
+ * @returns Array of field names
+ */
+export function formatFieldNames(fields) {
+    return fields.map((f) => f.name);
+}
+/**
+ * Create a summary message for statement execution.
+ *
+ * @param totalStatements - Total number of statements
+ * @param successCount - Number of successful statements
+ * @param failureCount - Number of failed statements
+ * @param skippedCount - Number of skipped statements
+ * @param rolledBack - Whether changes were rolled back
+ * @returns Summary message string
+ */
+export function createExecutionSummary(totalStatements, successCount, failureCount, skippedCount, rolledBack) {
+    const parts = [];
+    if (rolledBack) {
+        parts.push(`Dry-run of ${totalStatements} statements:`);
+    }
+    else {
+        parts.push(`Executed ${totalStatements} statements:`);
+    }
+    if (successCount > 0) {
+        parts.push(`${successCount} succeeded`);
+    }
+    if (failureCount > 0) {
+        parts.push(`${failureCount} failed`);
+    }
+    if (skippedCount > 0) {
+        parts.push(`${skippedCount} skipped (non-rollbackable)`);
+    }
+    if (rolledBack) {
+        parts.push('All changes rolled back.');
+    }
+    return parts.join(', ').replace('statements:,', 'statements:');
+}
+/**
+ * Count statements by type.
+ *
+ * @param types - Array of statement types
+ * @returns Object with counts by type
+ */
+export function countStatementsByType(types) {
+    const counts = {};
+    for (const type of types) {
+        counts[type] = (counts[type] || 0) + 1;
+    }
+    return counts;
+}
+/**
+ * Create a human-readable file summary.
+ *
+ * @param statementsByType - Statement counts by type
+ * @param totalStatements - Total statement count
+ * @returns Summary string
+ */
+export function createFileSummary(statementsByType, totalStatements) {
+    const parts = Object.entries(statementsByType)
+        .sort(([, a], [, b]) => b - a)
+        .map(([type, count]) => `${count} ${type}`)
+        .join(', ');
+    return `File contains ${totalStatements} statements: ${parts}`;
+}
+//# sourceMappingURL=result-formatter.js.map

package/dist/tools/sql/utils/result-formatter.js.map

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

package/dist/tools/sql/utils/sql-parser.d.ts

@@ -0,0 +1,125 @@
+/**
+ * SQL Parser Utilities
+ *
+ * Functions for parsing, analyzing, and splitting SQL statements.
+ * Handles PostgreSQL-specific syntax including:
+ * - Dollar-quoted strings ($$ or $tag$)
+ * - Nested block comments
+ * - Single and double-quoted strings with escape handling
+ */
+import { ParsedStatement } from '../../../types.js';
+/**
+ * Warning information from SQL parsing.
+ */
+export interface ParseWarning {
+    type: 'unclosed_dollar_quote' | 'unclosed_block_comment' | 'unclosed_string';
+    message: string;
+    lineNumber: number;
+    position: number;
+    tag?: string;
+}
+/**
+ * Result of SQL parsing with optional warnings.
+ */
+export interface ParseResult {
+    statements: ParsedStatement[];
+    warnings: ParseWarning[];
+}
+/**
+ * Strips leading line comments and block comments from SQL.
+ * Properly handles nested block comments (PostgreSQL supports nesting).
+ * Returns empty string if the entire content is just comments.
+ *
+ * IMPORTANT: This function only strips LEADING comments. Line numbers
+ * in the remaining SQL are NOT affected - they still correspond to
+ * the original file positions.
+ *
+ * @param sql - The SQL string to process
+ * @returns The SQL with leading comments stripped
+ */
+export declare function stripLeadingComments(sql: string): string;
+/**
+ * Detect the type of SQL statement (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.)
+ *
+ * @param sql - The SQL statement to analyze
+ * @returns The detected statement type
+ */
+export declare function detectStatementType(sql: string): string;
+/**
+ * Split SQL content into individual statements with line number tracking.
+ * Handles PostgreSQL-specific syntax including:
+ * - Single and double-quoted strings with escape handling
+ * - Dollar-quoted strings ($$ or $tag$)
+ * - Line comments (--)
+ * - Nested block comments (PostgreSQL supports nested comments)
+ *
+ * Line numbers in the returned statements correspond to actual file positions.
+ * Comments are NOT excluded from line counting - all newlines are counted.
+ *
+ * @param sql - The SQL content to split
+ * @returns Array of parsed statements with accurate line numbers
+ */
+export declare function splitSqlStatementsWithLineNumbers(sql: string): ParsedStatement[];
+/**
+ * Split SQL content into individual statements with line number tracking
+ * and collect any warnings about parsing issues.
+ *
+ * @param sql - The SQL content to split
+ * @returns Object with statements and any parsing warnings
+ */
+export declare function splitSqlStatementsWithWarnings(sql: string): ParseResult;
+/**
+ * Table reference extracted from SQL.
+ */
+export interface TableReference {
+    schema: string;
+    table: string;
+}
+/**
+ * Extracts table names from a SQL query.
+ * Handles common patterns:
+ * - FROM, JOIN, INTO, UPDATE, DELETE FROM
+ * - MERGE INTO/USING
+ * - COPY (table) FROM/TO
+ * - LATERAL subquery references
+ * - USING clause in JOINs
+ *
+ * @param sql - The SQL query to analyze
+ * @returns Array of unique table references
+ */
+export declare function extractTablesFromSql(sql: string): TableReference[];
+/**
+ * Filter parsed statements to only executable ones (non-empty, non-comment).
+ *
+ * @param statements - Array of parsed statements
+ * @returns Filtered array of executable statements
+ */
+export declare function filterExecutableStatements(statements: ParsedStatement[]): ParsedStatement[];
+/**
+ * Normalize SQL by removing comments and extra whitespace.
+ * Properly handles nested block comments.
+ *
+ * @param sql - The SQL to normalize
+ * @returns Normalized SQL string
+ */
+export declare function normalizeSql(sql: string): string;
+/**
+ * Checks if SQL content is empty after preprocessing (removing comments/whitespace).
+ *
+ * @param sql - The SQL to check
+ * @returns true if SQL is effectively empty, false otherwise
+ */
+export declare function isEmptyAfterPreprocessing(sql: string): boolean;
+/**
+ * Detects potential schema change statements in SQL.
+ * Useful for warning about schema changes during multi-statement execution.
+ *
+ * @param sql - The SQL statement to check
+ * @returns Object with detected schema changes
+ */
+export declare function detectSchemaChanges(sql: string): {
+    hasSchemaChange: boolean;
+    changeType?: 'search_path' | 'schema_create' | 'schema_drop' | 'schema_alter';
+    newSchema?: string;
+};
+//# sourceMappingURL=sql-parser.d.ts.map

package/dist/tools/sql/utils/sql-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-parser.d.ts","sourceRoot":"","sources":["../../../../src/tools/sql/utils/sql-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAiEpD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,uBAAuB,GAAG,wBAAwB,GAAG,iBAAiB,CAAC;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CA2BxD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAcvD;AAaD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iCAAiC,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,EAAE,CAGhF;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CA0KvE;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,EAAE,CAiElE;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,eAAe,EAAE,GAAG,eAAe,EAAE,CAO3F;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAgBhD;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAG9D;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG;IAChD,eAAe,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,aAAa,GAAG,eAAe,GAAG,aAAa,GAAG,cAAc,CAAC;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CA8BA"}