rawsql-ts 0.12.0 → 0.13.0

package/dist/utils/JsonSchemaValidator.js

@@ -0,0 +1,215 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JsonSchemaValidator = void 0;
+class JsonSchemaValidator {
+    /**
+     * Validates JsonMapping structure against an expected type structure.
+     * Checks if the JsonMapping covers all required properties and relationships.
+     *
+     * @param jsonMapping The JsonMapping configuration to validate
+     * @param expectedStructure The expected type structure to validate against
+     * @returns ValidationResult containing validation status and detailed errors
+     */
+    static validate(jsonMapping, expectedStructure) {
+        const extractedStructure = this.extractStructureFromJsonMapping(jsonMapping);
+        return this.compareStructures(extractedStructure, expectedStructure);
+    }
+    /**
+     * Validates JsonMapping structure and throws an error if validation fails.
+     * Convenience method for strict validation scenarios.
+     *
+     * @param jsonMapping The JsonMapping configuration to validate
+     * @param expectedStructure The expected type structure to validate against
+     * @throws Error if validation fails with detailed error messages
+     */
+    static validateStrict(jsonMapping, expectedStructure) {
+        const result = this.validate(jsonMapping, expectedStructure);
+        if (!result.isValid) {
+            const errorMessage = [
+                'JsonMapping validation failed:',
+                ...result.errors
+            ].join('\n');
+            throw new Error(errorMessage);
+        }
+    }
+    /**
+     * Extracts structure information from JsonMapping configuration.
+     * Analyzes rootEntity and nestedEntities to build complete structure map.
+     *
+     * @param jsonMapping The JsonMapping to analyze
+     * @returns ExtractedStructure representing the mapping structure
+     */
+    static extractStructureFromJsonMapping(jsonMapping) {
+        const structure = {};
+        // Extract root entity properties
+        if (jsonMapping.rootEntity && jsonMapping.rootEntity.columns) {
+            Object.keys(jsonMapping.rootEntity.columns).forEach(propertyName => {
+                structure[propertyName] = 'primitive';
+            });
+        }
+        // Extract nested entities
+        if (jsonMapping.nestedEntities) {
+            // Process direct children of root entity first
+            jsonMapping.nestedEntities
+                .filter((entity) => entity.parentId === jsonMapping.rootEntity.id)
+                .forEach((entity) => {
+                if (entity.propertyName && entity.columns) {
+                    if (entity.relationshipType === 'object') {
+                        // Single object relationship
+                        structure[entity.propertyName] = this.extractNestedEntityStructure(entity, jsonMapping);
+                    }
+                    else if (entity.relationshipType === 'array') {
+                        // Array relationship
+                        structure[entity.propertyName] = [this.extractNestedEntityStructure(entity, jsonMapping)];
+                    }
+                }
+            });
+        }
+        return structure;
+    } /**
+     * Extracts structure from a nested entity, including its children.
+     */
+    static extractNestedEntityStructure(entity, jsonMapping) {
+        const entityStructure = {};
+        // Add entity's own columns
+        if (entity.columns) {
+            Object.keys(entity.columns).forEach(propName => {
+                entityStructure[propName] = 'primitive';
+            });
+        }
+        // Add nested children of this entity
+        if (jsonMapping.nestedEntities) {
+            jsonMapping.nestedEntities
+                .filter((childEntity) => childEntity.parentId === entity.id)
+                .forEach((childEntity) => {
+                if (childEntity.propertyName && childEntity.columns) {
+                    if (childEntity.relationshipType === 'object') {
+                        entityStructure[childEntity.propertyName] = this.extractNestedEntityStructure(childEntity, jsonMapping);
+                    }
+                    else if (childEntity.relationshipType === 'array') {
+                        entityStructure[childEntity.propertyName] = [this.extractNestedEntityStructure(childEntity, jsonMapping)];
+                    }
+                }
+            });
+        }
+        return entityStructure;
+    } /**
+     * Compares extracted structure with expected structure with proper type guards.
+     */
+    static compareStructures(extracted, expected, path = '') {
+        const errors = [];
+        const missingProperties = [];
+        const extraProperties = [];
+        // Handle primitive comparison
+        if (extracted === 'primitive' && expected === 'primitive') {
+            return { isValid: true, errors: [], missingProperties: [], extraProperties: [] };
+        }
+        // Handle array types
+        if (Array.isArray(expected) && Array.isArray(extracted)) {
+            if (expected.length > 0 && extracted.length > 0) {
+                const nestedResult = this.compareStructures(extracted[0], expected[0], `${path}[]`);
+                errors.push(...nestedResult.errors);
+                missingProperties.push(...nestedResult.missingProperties);
+                extraProperties.push(...nestedResult.extraProperties);
+            }
+            return { isValid: errors.length === 0, errors, missingProperties, extraProperties };
+        } // Both should be objects for property comparison
+        if (typeof extracted !== 'object' || typeof expected !== 'object' ||
+            Array.isArray(extracted) || Array.isArray(expected) ||
+            extracted === null || expected === null) {
+            return { isValid: true, errors: [], missingProperties: [], extraProperties: [] };
+        }
+        // Now we know both are object types, safe to access properties
+        const extractedObj = extracted;
+        const expectedObj = expected;
+        // Check for missing properties in extracted structure
+        Object.keys(expectedObj).forEach(key => {
+            const currentPath = path ? `${path}.${key}` : key;
+            if (!(key in extractedObj)) {
+                missingProperties.push(currentPath);
+                errors.push(`Missing property: ${currentPath}`);
+                return;
+            }
+            const extractedValue = extractedObj[key];
+            const expectedValue = expectedObj[key];
+            // Recursively compare nested structures
+            const nestedResult = this.compareStructures(extractedValue, expectedValue, currentPath);
+            errors.push(...nestedResult.errors);
+            missingProperties.push(...nestedResult.missingProperties);
+            extraProperties.push(...nestedResult.extraProperties);
+        });
+        // Check for extra properties in extracted structure
+        Object.keys(extractedObj).forEach(key => {
+            const currentPath = path ? `${path}.${key}` : key;
+            if (!(key in expectedObj)) {
+                extraProperties.push(currentPath);
+                // Note: Extra properties are not considered errors in this implementation
+                // as JsonMapping might include additional metadata
+            }
+        });
+        return {
+            isValid: errors.length === 0,
+            errors,
+            missingProperties,
+            extraProperties
+        };
+    }
+    /**
+     * Validates JsonMapping structure against a sample object that implements the expected type.
+     * This method extracts structure from the sample object and compares it with JsonMapping.
+     *
+     * @param jsonMapping The JsonMapping configuration to validate
+     * @param sampleObject A sample object that implements the expected interface/type
+     * @returns ValidationResult containing validation status and detailed errors
+     */
+    static validateAgainstSample(jsonMapping, sampleObject) {
+        const expectedStructure = this.extractStructureFromSample(sampleObject);
+        return this.validate(jsonMapping, expectedStructure);
+    }
+    /**
+     * Validates JsonMapping structure against a sample object and throws an error if validation fails.
+     * Convenience method for strict validation scenarios with sample objects.
+     *
+     * @param jsonMapping The JsonMapping configuration to validate
+     * @param sampleObject A sample object that implements the expected interface/type
+     * @throws Error if validation fails with detailed error messages
+     */
+    static validateAgainstSampleStrict(jsonMapping, sampleObject) {
+        const result = this.validateAgainstSample(jsonMapping, sampleObject);
+        if (!result.isValid) {
+            const errorMessage = [
+                'JsonMapping validation against sample object failed:',
+                ...result.errors
+            ].join('\n');
+            throw new Error(errorMessage);
+        }
+    } /**
+     * Extracts structure information from a sample object.
+     * Recursively analyzes the object properties to build a structure map.
+     *
+     * @param sampleObject The sample object to analyze
+     * @returns ExpectedTypeStructure representing the object structure
+     */
+    static extractStructureFromSample(sampleObject) {
+        if (sampleObject === null || sampleObject === undefined) {
+            return 'primitive';
+        }
+        if (Array.isArray(sampleObject)) {
+            if (sampleObject.length === 0) {
+                return [];
+            }
+            return [this.extractStructureFromSample(sampleObject[0])];
+        }
+        if (typeof sampleObject === 'object') {
+            const structure = {};
+            Object.keys(sampleObject).forEach(key => {
+                structure[key] = this.extractStructureFromSample(sampleObject[key]);
+            });
+            return structure;
+        }
+        // Primitive types (string, number, boolean, etc.)
+        return 'primitive';
+    }
+}
+exports.JsonSchemaValidator = JsonSchemaValidator;
+//# sourceMappingURL=JsonSchemaValidator.js.map

package/dist/utils/JsonSchemaValidator.js.map

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

package/dist/utils/KeywordCache.js

@@ -0,0 +1,206 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KeywordCache = void 0;
+const CommandTokenReader_1 = require("../tokenReaders/CommandTokenReader");
+/**
+ * Utility for caching keyword relationships for fast access
+ * Dynamically builds keyword relationships from existing joinkeywordParser
+ *
+ * SOURCE DICTIONARIES (single source of truth):
+ * - JOIN patterns: /src/tokenReaders/CommandTokenReader.ts (joinTrie, lines 10-29)
+ * - Command patterns: /src/tokenReaders/CommandTokenReader.ts (keywordTrie, lines 30-118)
+ *
+ * MIGRATION NOTE:
+ * If keywords are added/modified in CommandTokenReader.ts, update the
+ * extractCommandPatternsFromTrie() method to reflect those changes.
+ * JOIN patterns are automatically extracted via joinkeywordParser.
+ */
+class KeywordCache {
+    /**
+     * Initialize JOIN-related keyword suggestions
+     * Dynamically generated based on information extracted from joinkeywordParser
+     */
+    static initialize() {
+        if (this.initialized)
+            return;
+        // SOURCE: /src/tokenReaders/CommandTokenReader.ts joinTrie (lines 10-33)
+        // Dynamically build keyword relationships from joinTrie
+        const joinPatterns = [
+            ["join"],
+            ["inner", "join"],
+            ["cross", "join"],
+            ["left", "join"],
+            ["left", "outer", "join"],
+            ["right", "join"],
+            ["right", "outer", "join"],
+            ["full", "join"],
+            ["full", "outer", "join"],
+            ["natural", "join"],
+            ["natural", "inner", "join"],
+            ["natural", "left", "join"],
+            ["natural", "left", "outer", "join"],
+            ["natural", "right", "join"],
+            ["natural", "right", "outer", "join"],
+            ["natural", "full", "join"],
+            ["natural", "full", "outer", "join"],
+            // LATERAL JOIN patterns
+            ["lateral", "join"],
+            ["lateral", "inner", "join"],
+            ["lateral", "left", "join"],
+            ["lateral", "left", "outer", "join"],
+        ];
+        // Build keyword suggestion relationships
+        const suggestionMap = new Map();
+        // Build complete phrase suggestions for better UX
+        const completePhrases = new Set();
+        joinPatterns.forEach(pattern => {
+            if (pattern.length > 1) {
+                completePhrases.add(pattern.slice(1).join(' ').toUpperCase());
+            }
+        });
+        // For each prefix, find all possible complete continuations
+        joinPatterns.forEach(pattern => {
+            for (let i = 0; i < pattern.length - 1; i++) {
+                const prefix = pattern[i];
+                if (!suggestionMap.has(prefix)) {
+                    suggestionMap.set(prefix, new Set());
+                }
+                // Find all patterns that start with this prefix and add complete phrases
+                joinPatterns.forEach(candidatePattern => {
+                    if (candidatePattern.length > i + 1 && candidatePattern[i] === prefix) {
+                        const completePhrase = candidatePattern.slice(i + 1).join(' ').toUpperCase();
+                        suggestionMap.get(prefix).add(completePhrase);
+                    }
+                });
+            }
+        });
+        // Convert Set to array and save to cache
+        suggestionMap.forEach((suggestions, keyword) => {
+            this.joinSuggestionCache.set(keyword.toLowerCase(), Array.from(suggestions));
+        });
+        // Also process command keywords
+        this.initializeCommandKeywords();
+        this.initialized = true;
+    }
+    /**
+     * Get next suggestions for the specified keyword
+     * Example: "left" → ["join", "outer", "outer join"]
+     */
+    static getJoinSuggestions(keyword) {
+        this.initialize();
+        return this.joinSuggestionCache.get(keyword.toLowerCase()) || [];
+    }
+    /**
+     * Check if a keyword is a valid JOIN keyword
+     * Uses existing joinkeywordParser as the primary resource
+     */
+    static isValidJoinKeyword(keyword) {
+        const result = CommandTokenReader_1.joinkeywordParser.parse(keyword, 0);
+        return result !== null;
+    }
+    /**
+     * Generate suggestions based on partial keyword input
+     * Example: "le" → find keywords starting with "left"
+     */
+    static getPartialSuggestions(partialKeyword) {
+        this.initialize();
+        const partial = partialKeyword.toLowerCase();
+        const suggestions = [];
+        this.joinSuggestionCache.forEach((values, key) => {
+            if (key.startsWith(partial)) {
+                suggestions.push(key);
+                // Include next suggestions for that keyword as well
+                values.forEach(value => {
+                    if (!suggestions.includes(value)) {
+                        suggestions.push(value);
+                    }
+                });
+            }
+        });
+        return suggestions;
+    }
+    /**
+     * Get all JOIN keywords
+     */
+    static getAllJoinKeywords() {
+        this.initialize();
+        const allKeywords = new Set();
+        this.joinSuggestionCache.forEach((values, key) => {
+            allKeywords.add(key);
+            values.forEach(value => allKeywords.add(value));
+        });
+        return Array.from(allKeywords);
+    }
+    /**
+     * Initialize command keyword patterns
+     * Dynamically extracted from commandKeywordTrie
+     */
+    static initializeCommandKeywords() {
+        // Extract multi-word patterns from commandKeywordTrie
+        const commandPatterns = this.extractCommandPatternsFromTrie();
+        const suggestionMap = new Map();
+        commandPatterns.forEach(pattern => {
+            for (let i = 0; i < pattern.length - 1; i++) {
+                const prefix = pattern[i];
+                const nextWord = pattern[i + 1];
+                if (!suggestionMap.has(prefix)) {
+                    suggestionMap.set(prefix, new Set());
+                }
+                suggestionMap.get(prefix).add(nextWord);
+            }
+        });
+        // Convert Set to array and save to cache
+        suggestionMap.forEach((suggestions, keyword) => {
+            this.commandSuggestionCache.set(keyword.toLowerCase(), Array.from(suggestions));
+        });
+    }
+    /**
+     * Extract multi-word patterns from commandKeywordTrie
+     * Uses known patterns since direct extraction from trie structure is difficult
+     *
+     * SOURCE: /src/tokenReaders/CommandTokenReader.ts keywordTrie (lines 30-118)
+     * MIGRATION: When updating, copy multi-word patterns from the source trie
+     */
+    static extractCommandPatternsFromTrie() {
+        // These are patterns defined in CommandTokenReader's keywordTrie
+        return [
+            ["group", "by"],
+            ["order", "by"],
+            ["distinct", "on"],
+            ["not", "materialized"],
+            ["row", "only"],
+            ["rows", "only"],
+            ["percent", "with", "ties"],
+            ["key", "share"],
+            ["no", "key", "update"],
+            ["union", "all"],
+            ["intersect", "all"],
+            ["except", "all"],
+            ["partition", "by"],
+            ["within", "group"],
+            ["with", "ordinality"]
+        ];
+    }
+    /**
+     * Get next command suggestions for the specified keyword
+     * Example: "group" → ["by"]
+     */
+    static getCommandSuggestions(keyword) {
+        this.initialize();
+        return this.commandSuggestionCache.get(keyword.toLowerCase()) || [];
+    }
+    /**
+     * Force cache re-initialization
+     * Used for testing or when keyword definitions have changed
+     */
+    static reset() {
+        this.joinSuggestionCache.clear();
+        this.commandSuggestionCache.clear();
+        this.initialized = false;
+    }
+}
+exports.KeywordCache = KeywordCache;
+KeywordCache.joinSuggestionCache = new Map();
+KeywordCache.commandSuggestionCache = new Map();
+KeywordCache.initialized = false;
+//# sourceMappingURL=KeywordCache.js.map

package/dist/utils/KeywordCache.js.map

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