rawsql-ts 0.13.0 → 0.13.3

package/dist/src/transformers/JsonMappingConverter.js

@@ -1,392 +0,0 @@
-"use strict";
-/**
- * Unified JSON mapping converter that handles all supported formats
- * and provides a single interface for mapping transformations.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.JsonMappingConverter = void 0;
-const ModelDrivenJsonMapping_1 = require("./ModelDrivenJsonMapping");
-const EnhancedJsonMapping_1 = require("./EnhancedJsonMapping");
-/**
- * Type guard to check if input is valid JSON mapping input
- */
-function isValidMappingInput(input) {
-    return input !== null &&
-        input !== undefined &&
-        typeof input === 'object';
-}
-/**
- * Enhanced format conversion strategy.
- */
-class EnhancedFormatStrategy {
-    detect(input) {
-        if (!isValidMappingInput(input)) {
-            return false;
-        }
-        const candidate = input;
-        if (!candidate ||
-            typeof candidate.rootName !== 'string' ||
-            !candidate.rootEntity ||
-            !Array.isArray(candidate.nestedEntities)) {
-            return false;
-        }
-        // Check if it has enhanced features
-        if (candidate.typeInfo || candidate.typeProtection || candidate.metadata) {
-            return true;
-        }
-        // Check if any column uses enhanced format (object with 'column' property)
-        const hasEnhancedColumns = (columns) => {
-            if (!columns || typeof columns !== 'object')
-                return false;
-            return Object.values(columns).some(col => typeof col === 'object' && col !== null && 'column' in col);
-        };
-        if (hasEnhancedColumns(candidate.rootEntity.columns)) {
-            return true;
-        }
-        return candidate.nestedEntities.some((entity) => entity && typeof entity === 'object' &&
-            hasEnhancedColumns(entity.columns));
-    }
-    convert(input) {
-        var _a, _b;
-        return {
-            format: 'enhanced',
-            mapping: (0, EnhancedJsonMapping_1.toLegacyMapping)(input),
-            typeProtection: (0, EnhancedJsonMapping_1.extractTypeProtection)(input),
-            originalInput: input,
-            metadata: {
-                typeInfo: input.typeInfo,
-                version: (_a = input.metadata) === null || _a === void 0 ? void 0 : _a.version,
-                description: (_b = input.metadata) === null || _b === void 0 ? void 0 : _b.description
-            }
-        };
-    }
-}
-/**
- * Model-driven format conversion strategy.
- */
-class ModelDrivenFormatStrategy {
-    detect(input) {
-        if (!isValidMappingInput(input)) {
-            return false;
-        }
-        const candidate = input;
-        return candidate &&
-            candidate.typeInfo &&
-            candidate.structure &&
-            typeof candidate.typeInfo.interface === 'string';
-    }
-    convert(input) {
-        // Use the existing convertModelDrivenMapping function to avoid code duplication
-        const converted = (0, ModelDrivenJsonMapping_1.convertModelDrivenMapping)(input);
-        return {
-            format: 'model-driven',
-            mapping: converted.jsonMapping,
-            typeProtection: converted.typeProtection,
-            originalInput: input,
-            metadata: {
-                typeInfo: input.typeInfo
-            }
-        };
-    }
-}
-/**
- * Legacy format conversion strategy.
- */
-class LegacyFormatStrategy {
-    detect(input) {
-        if (!isValidMappingInput(input)) {
-            return false;
-        }
-        const candidate = input;
-        if (!candidate ||
-            typeof candidate.rootName !== 'string' ||
-            !candidate.rootEntity ||
-            typeof candidate.rootEntity.columns !== 'object' ||
-            candidate.typeInfo || candidate.typeProtection || candidate.metadata) {
-            return false;
-        }
-        // Check if any column uses enhanced format (object with 'column' property)
-        const hasEnhancedColumns = (columns) => {
-            if (!columns || typeof columns !== 'object')
-                return false;
-            return Object.values(columns).some(col => typeof col === 'object' && col !== null && 'column' in col);
-        };
-        // If it has enhanced columns, it's not legacy format
-        if (hasEnhancedColumns(candidate.rootEntity.columns)) {
-            return false;
-        }
-        if (candidate.nestedEntities && Array.isArray(candidate.nestedEntities)) {
-            const hasEnhancedNested = candidate.nestedEntities.some((entity) => entity && typeof entity === 'object' && hasEnhancedColumns(entity.columns));
-            if (hasEnhancedNested) {
-                return false;
-            }
-        }
-        return true;
-    }
-    convert(input) {
-        return {
-            format: 'legacy',
-            mapping: input,
-            typeProtection: { protectedStringFields: [] },
-            originalInput: input
-        };
-    }
-}
-/**
- * Unified JSON mapping converter that handles all supported formats using the Strategy pattern.
- *
- * This converter automatically detects the input format and applies the appropriate conversion
- * strategy to transform any supported JSON mapping format into a standardized result.
- *
- * **Supported Formats:**
- * - **Enhanced**: Rich format with metadata, type protection, and advanced column configurations
- * - **Model-Driven**: TypeScript interface-based mapping with structured field definitions
- * - **Legacy**: Simple format compatible with PostgresJsonQueryBuilder
- *
- * **Usage:**
- * ```typescript
- * const converter = new JsonMappingConverter();
- * const result = converter.convert(someMapping);
- * const legacyMapping = converter.toLegacyMapping(someMapping);
- * ```
- *
- * @public
- */
-class JsonMappingConverter {
-    /**
-     * Creates a new JsonMappingConverter with all supported strategies.
-     *
-     * Strategies are checked in order of specificity:
-     * 1. Enhanced format (most feature-rich)
-     * 2. Model-driven format (TypeScript-based)
-     * 3. Legacy format (fallback)
-     */
-    constructor() {
-        this.strategies = [
-            new EnhancedFormatStrategy(),
-            new ModelDrivenFormatStrategy(),
-            new LegacyFormatStrategy()
-        ];
-    }
-    /**
-     * Detects the format of the input mapping without performing conversion.
-     *
-     * This method uses the same strategy pattern as conversion but only returns
-     * the detected format type for inspection purposes.
-     *
-     * @param input - The JSON mapping to analyze
-     * @returns The detected mapping format type
-     *
-     * @throws {Error} When input format is not supported by any strategy
-     *
-     * @example
-     * ```typescript
-     * const format = converter.detectFormat(myMapping);
-     * console.log(`Detected format: ${format}`); // "enhanced", "model-driven", or "legacy"
-     * ```
-     */
-    detectFormat(input) {
-        for (const strategy of this.strategies) {
-            if (strategy.detect(input)) {
-                const result = strategy.convert(input);
-                return result.format;
-            }
-        }
-        throw new Error('Unsupported JSON mapping format');
-    }
-    /**
-     * Converts any supported JSON mapping format to a comprehensive result with metadata.
-     *
-     * This is the primary conversion method that performs format detection and transformation
-     * in a single operation. The result includes the legacy mapping, type protection configuration,
-     * and metadata about the conversion process.
-     *
-     * @param input - The JSON mapping in any supported format (Enhanced, Model-Driven, or Legacy)
-     * @returns Complete conversion result with mapping, metadata, and type protection
-     *
-     * @throws {Error} When the input format is not recognized by any strategy
-     *
-     * @example
-     * ```typescript
-     * const result = converter.convert(enhancedMapping);
-     * console.log(`Format: ${result.format}`);
-     * console.log(`Type protection: ${result.typeProtection.protectedStringFields.length} fields`);
-     *
-     * // Use the converted mapping
-     * const queryBuilder = new PostgresJsonQueryBuilder(result.mapping);
-     * ```
-     *
-     * @see {@link toLegacyMapping} For simple mapping extraction
-     * @see {@link getTypeProtection} For type protection only
-     */
-    convert(input) {
-        for (const strategy of this.strategies) {
-            if (strategy.detect(input)) {
-                return strategy.convert(input);
-            }
-        }
-        throw new Error('Unsupported JSON mapping format: Unable to detect a compatible strategy for the provided input');
-    }
-    /**
-     * Extracts only the legacy JsonMapping for direct use with PostgresJsonQueryBuilder.
-     *
-     * This convenience method performs the full conversion but returns only the mapping portion,
-     * discarding metadata and type protection information. Use this when you only need
-     * the mapping for query building and don't require additional metadata.
-     *
-     * @param input - The JSON mapping in any supported format
-     * @returns Legacy-format JsonMapping ready for PostgresJsonQueryBuilder
-     *
-     * @throws {Error} When the input format is not supported
-     *
-     * @example
-     * ```typescript
-     * const legacyMapping = converter.toLegacyMapping(modelDrivenMapping);
-     * const queryBuilder = new PostgresJsonQueryBuilder(legacyMapping);
-     * const query = queryBuilder.build(selectQuery);
-     * ```
-     *
-     * @see {@link convert} For full conversion with metadata
-     */
-    toLegacyMapping(input) {
-        return this.convert(input).mapping;
-    }
-    /**
-     * Extracts type protection configuration for runtime type checking.
-     *
-     * Type protection helps identify fields that should be treated as strings
-     * to prevent injection attacks or type coercion issues. This is particularly
-     * useful when working with user input or external data sources.
-     *
-     * @param input - The JSON mapping in any supported format
-     * @returns Type protection configuration with protected field definitions
-     *
-     * @throws {Error} When the input format is not supported
-     *
-     * @example
-     * ```typescript
-     * const typeProtection = converter.getTypeProtection(enhancedMapping);
-     *
-     * // Apply type protection during data processing
-     * for (const field of typeProtection.protectedStringFields) {
-     *     if (typeof data[field] !== 'string') {
-     *         data[field] = String(data[field]);
-     *     }
-     * }
-     * ```
-     */
-    getTypeProtection(input) {
-        return this.convert(input).typeProtection;
-    }
-    /**
-     * Validates that the input mapping is well-formed and can be successfully converted.
-     *
-     * This method performs comprehensive validation without attempting conversion,
-     * returning an array of error messages for any issues found. An empty array
-     * indicates the mapping is valid and ready for conversion.
-     *
-     * **Validation Checks:**
-     * - Basic structure validation (object type, required fields)
-     * - Format-specific validation (Enhanced, Model-Driven, Legacy)
-     * - Column configuration validation
-     * - Type protection configuration validation
-     *
-     * @param input - The JSON mapping to validate
-     * @returns Array of validation error messages (empty if valid)
-     *
-     * @example
-     * ```typescript
-     * const errors = converter.validate(suspiciousMapping);
-     * if (errors.length > 0) {
-     *     console.error('Validation failed:', errors);
-     *     throw new Error(`Invalid mapping: ${errors.join(', ')}`);
-     * }
-     *
-     * // Safe to convert
-     * const result = converter.convert(suspiciousMapping);
-     * ```
-     *
-     * @see {@link convert} Performs conversion after implicit validation
-     */
-    validate(input) {
-        const errors = [];
-        // Pre-validation checks
-        if (!input || typeof input !== 'object') {
-            errors.push('Input must be an object');
-            return errors;
-        }
-        // Check for rootName before attempting conversion
-        if (!('rootName' in input) || !input.rootName) {
-            errors.push('rootName is required');
-        }
-        try {
-            const result = this.convert(input);
-            // Basic validation
-            if (!result.mapping.rootName) {
-                errors.push('rootName is required');
-            }
-            if (!result.mapping.rootEntity) {
-                errors.push('rootEntity is required');
-            }
-            else {
-                if (!result.mapping.rootEntity.id) {
-                    errors.push('rootEntity.id is required');
-                }
-                if (!result.mapping.rootEntity.columns) {
-                    errors.push('rootEntity.columns is required');
-                }
-            }
-            // Validate nested entities
-            if (result.mapping.nestedEntities) {
-                for (const entity of result.mapping.nestedEntities) {
-                    if (!entity.id) {
-                        errors.push(`Nested entity missing id: ${entity.propertyName}`);
-                    }
-                    if (!entity.parentId) {
-                        errors.push(`Nested entity missing parentId: ${entity.id}`);
-                    }
-                    if (!entity.propertyName) {
-                        errors.push(`Nested entity missing propertyName: ${entity.id}`);
-                    }
-                }
-            }
-        }
-        catch (error) {
-            // Only add conversion error if we haven't already found specific errors
-            if (errors.length === 0) {
-                errors.push(`Conversion failed: ${error instanceof Error ? error.message : String(error)}`);
-            }
-        }
-        return errors;
-    }
-    /**
-     * Creates a new enhanced mapping from legacy mapping.
-     */
-    upgradeToEnhanced(legacy, typeInfo) {
-        return {
-            rootName: legacy.rootName,
-            rootEntity: {
-                id: legacy.rootEntity.id,
-                name: legacy.rootEntity.name,
-                columns: legacy.rootEntity.columns
-            },
-            nestedEntities: legacy.nestedEntities.map(entity => ({
-                id: entity.id,
-                name: entity.name,
-                parentId: entity.parentId,
-                propertyName: entity.propertyName,
-                relationshipType: entity.relationshipType || 'object',
-                columns: entity.columns
-            })),
-            resultFormat: legacy.resultFormat,
-            emptyResult: legacy.emptyResult,
-            typeInfo,
-            metadata: {
-                version: '1.0',
-                description: 'Upgraded from legacy format'
-            }
-        };
-    }
-}
-exports.JsonMappingConverter = JsonMappingConverter;
-//# sourceMappingURL=JsonMappingConverter.js.map

package/dist/src/transformers/JsonMappingConverter.js.map

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

package/dist/src/transformers/JsonMappingUnifier.js

@@ -1,216 +0,0 @@
-"use strict";
-/**
- * Unified JSON Mapping processor that supports both legacy and model-driven formats.
- *
- * @deprecated Use JsonMappingConverter instead. This module is kept for backward compatibility.
- * This module provides backward compatibility while encouraging migration to the model-driven format.
- * It automatically detects the input format and normalizes to a consistent internal representation.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.detectMappingFormat = detectMappingFormat;
-exports.processJsonMapping = processJsonMapping;
-exports.unifyJsonMapping = unifyJsonMapping;
-exports.isModelDrivenFormat = isModelDrivenFormat;
-exports.isUnifiedFormat = isUnifiedFormat;
-exports.isLegacyFormat = isLegacyFormat;
-exports.suggestModelDrivenMigration = suggestModelDrivenMigration;
-const JsonMappingConverter_1 = require("./JsonMappingConverter");
-/**
- * Detects the format of a JSON mapping configuration.
- *
- * @param input - The mapping configuration to analyze
- * @returns The detected format type
- */
-function detectMappingFormat(input) {
-    // Model-driven format: has typeInfo and structure
-    if (input.typeInfo && input.structure) {
-        return 'model-driven';
-    }
-    // Unified format: has rootName and rootEntity
-    if (input.rootName && input.rootEntity) {
-        return 'unified';
-    }
-    // Legacy format: direct JsonMapping structure
-    if (input.columns || input.relationships) {
-        return 'legacy';
-    }
-    // Default fallback
-    return 'legacy';
-}
-/**
- * Converts legacy unified format to JsonMapping.
- *
- * @param input - Unified format mapping configuration
- * @returns Converted JsonMapping
- */
-function convertUnifiedFormat(input) {
-    if (!input.rootEntity) {
-        throw new Error('Unified format requires rootEntity');
-    }
-    const result = {
-        rootName: input.rootName || 'root',
-        rootEntity: {
-            id: input.rootEntity.id || 'root',
-            name: input.rootEntity.name || 'Root',
-            columns: input.rootEntity.columns || {}
-        },
-        nestedEntities: []
-    };
-    // Convert nestedEntities
-    if (input.nestedEntities && Array.isArray(input.nestedEntities)) {
-        result.nestedEntities = input.nestedEntities.map(entity => ({
-            id: entity.id || entity.propertyName || 'nested',
-            name: entity.name || entity.propertyName || 'Nested',
-            parentId: entity.parentId || result.rootEntity.id,
-            propertyName: entity.propertyName || 'nested',
-            relationshipType: entity.relationshipType || 'object',
-            columns: entity.columns || {}
-        }));
-    }
-    return result;
-}
-/**
- * Converts legacy format directly to JsonMapping.
- *
- * @param input - Legacy format mapping configuration
- * @returns JsonMapping
- */
-function convertLegacyFormat(input) {
-    const result = {
-        rootName: input.rootName || 'root',
-        rootEntity: {
-            id: 'root',
-            name: input.rootName || 'Root',
-            columns: input.columns || {}
-        },
-        nestedEntities: []
-    };
-    // Convert relationships to nestedEntities
-    if (input.relationships && typeof input.relationships === 'object') {
-        for (const [propertyName, relationship] of Object.entries(input.relationships)) {
-            // Type assertion for legacy relationship format
-            const rel = relationship;
-            result.nestedEntities.push({
-                id: propertyName,
-                name: propertyName.charAt(0).toUpperCase() + propertyName.slice(1),
-                parentId: 'root',
-                propertyName,
-                relationshipType: rel.type === 'hasMany' ? 'array' : 'object',
-                columns: rel.columns || {}
-            });
-        }
-    }
-    return result;
-}
-/**
- * Main processor that unifies all JSON mapping formats into a consistent JsonMapping.
- *
- * @deprecated Use JsonMappingConverter.convert() instead.
- *
- * Features:
- * - Automatic format detection
- * - Backward compatibility with all existing formats
- * - Metadata preservation for advanced features
- * - Zero external dependencies
- *
- * @param input - Any supported JSON mapping format
- * @returns Unified processing result with JsonMapping and metadata
- */
-function processJsonMapping(input) {
-    var _a;
-    // Runtime deprecation warning
-    console.warn('⚠️ DEPRECATED: processJsonMapping() is deprecated. Use JsonMappingConverter.convert() instead.');
-    console.warn('Migration guide: https://github.com/mk3008/rawsql-ts/blob/main/docs/migration-guide.md');
-    // Check for legacy format with columns and relationships
-    if ((input.columns || input.relationships) && !input.rootName && !input.rootEntity) {
-        const jsonMapping = convertLegacyFormat(input);
-        return {
-            format: 'legacy',
-            jsonMapping,
-            originalInput: input,
-            metadata: {}
-        };
-    }
-    const converter = new JsonMappingConverter_1.JsonMappingConverter();
-    const result = converter.convert(input);
-    // Map converter formats to unifier formats for backward compatibility
-    let format = result.format;
-    // If it's detected as 'legacy' by converter but has rootName and rootEntity, it's 'unified' format
-    if (result.format === 'legacy' && input.rootName && input.rootEntity) {
-        format = 'unified';
-    }
-    return {
-        format,
-        jsonMapping: result.mapping,
-        originalInput: input,
-        metadata: {
-            typeInfo: (_a = result.metadata) === null || _a === void 0 ? void 0 : _a.typeInfo,
-            typeProtection: result.typeProtection
-        }
-    };
-}
-/**
- * Convenience function for direct JsonMapping extraction.
- *
- * @deprecated Use JsonMappingConverter.toLegacyMapping() instead.
- *
- * @param input - Any supported JSON mapping format
- * @returns JsonMapping ready for use with PostgresJsonQueryBuilder
- */
-function unifyJsonMapping(input) {
-    // Runtime deprecation warning
-    console.warn('⚠️ DEPRECATED: unifyJsonMapping() is deprecated. Use JsonMappingConverter.toLegacyMapping() instead.');
-    console.warn('Migration guide: https://github.com/mk3008/rawsql-ts/blob/main/docs/migration-guide.md');
-    const converter = new JsonMappingConverter_1.JsonMappingConverter();
-    return converter.toLegacyMapping(input);
-}
-/**
- * Type guard to check if input uses model-driven format.
- *
- * @param input - Mapping input to check
- * @returns True if input is model-driven format
- */
-function isModelDrivenFormat(input) {
-    return detectMappingFormat(input) === 'model-driven';
-}
-/**
- * Type guard to check if input uses unified format.
- *
- * @param input - Mapping input to check
- * @returns True if input is unified format
- */
-function isUnifiedFormat(input) {
-    return detectMappingFormat(input) === 'unified';
-}
-/**
- * Type guard to check if input uses legacy format.
- *
- * @param input - Mapping input to check
- * @returns True if input is legacy format
- */
-function isLegacyFormat(input) {
-    return detectMappingFormat(input) === 'legacy';
-}
-/**
- * Migration helper that suggests upgrading to model-driven format.
- *
- * @param input - Current mapping configuration
- * @returns Suggestions for migration (if applicable)
- */
-function suggestModelDrivenMigration(input) {
-    const format = detectMappingFormat(input);
-    const suggestions = [];
-    if (format !== 'model-driven') {
-        suggestions.push('Consider migrating to model-driven JSON mapping format');
-        suggestions.push('Benefits: Better type safety, IDE support, and future-proof design');
-        suggestions.push('See: Model-Driven JSON Mapping Guide for migration instructions');
-        if (format === 'unified') {
-            suggestions.push('Your current unified format can be automatically converted');
-        }
-        if (format === 'legacy') {
-            suggestions.push('Legacy format support will be maintained but new features target model-driven format');
-        }
-    }
-    return suggestions;
-}
-//# sourceMappingURL=JsonMappingUnifier.js.map

package/dist/src/transformers/JsonMappingUnifier.js.map

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