rawsql-ts 0.12.0 → 0.13.0

package/dist/transformers/EnhancedJsonMapping.js

@@ -0,0 +1,223 @@
+"use strict";
+/**
+ * Enhanced JSON mapping structure that extends the base JsonMapping interface
+ * with additional metadata and type safety features.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertColumnsToLegacy = convertColumnsToLegacy;
+exports.convertToLegacyJsonMapping = convertToLegacyJsonMapping;
+exports.toLegacyMapping = toLegacyMapping;
+exports.extractTypeProtection = extractTypeProtection;
+/**
+ * Converts enhanced column configurations to simple string mappings for legacy compatibility.
+ *
+ * This function transforms complex column configurations (with type info, nullable flags, etc.)
+ * into simple string mappings that can be used with PostgresJsonQueryBuilder.
+ *
+ * **Supported Input Formats:**
+ * - Simple strings: `"user_name"` → `"user_name"`
+ * - Column config: `{ column: "u.name", type: "string" }` → `"u.name"`
+ * - From config: `{ from: "user_name", nullable: true }` → `"user_name"`
+ *
+ * @param columns - Record of field names to column configurations
+ * @returns Record of field names to column source strings
+ *
+ * @example
+ * ```typescript
+ * const enhanced = {
+ *   id: { column: "u.user_id", type: "number" },
+ *   name: { from: "user_name", type: "string" },
+ *   email: "email_address"
+ * };
+ *
+ * const legacy = convertColumnsToLegacy(enhanced);
+ * // Result: { id: "u.user_id", name: "user_name", email: "email_address" }
+ * ```
+ */
+function convertColumnsToLegacy(columns) {
+    const result = {};
+    for (const [key, config] of Object.entries(columns)) {
+        if (typeof config === 'string') {
+            result[key] = config;
+        }
+        else if (config && typeof config === 'object') {
+            if ('column' in config) {
+                result[key] = config.column;
+            }
+            else if ('from' in config) {
+                result[key] = config.from;
+            }
+            else {
+                result[key] = key; // fallback
+            }
+        }
+        else {
+            result[key] = key; // fallback
+        }
+    }
+    return result;
+}
+/**
+ * Converts any unified JSON mapping format to legacy JsonMapping format.
+ *
+ * This universal converter handles Enhanced, Unified, and Legacy formats, providing
+ * a single interface for converting complex mapping configurations to the simple
+ * format expected by PostgresJsonQueryBuilder.
+ *
+ * **Supported Input Formats:**
+ * - **Enhanced**: With metadata, type protection, and advanced column configs
+ * - **Unified**: Standard format with rootName and rootEntity
+ * - **Legacy**: Already compatible format (returned as-is)
+ *
+ * **Features:**
+ * - Automatic format detection
+ * - Column configuration simplification
+ * - Nested entity handling
+ * - Type protection extraction
+ *
+ * @param input - JSON mapping in any supported format
+ * @returns Legacy JsonMapping compatible with PostgresJsonQueryBuilder
+ *
+ * @throws {Error} When input is null, undefined, or malformed
+ *
+ * @example
+ * ```typescript
+ * // Enhanced format input
+ * const enhanced = {
+ *   rootName: "User",
+ *   rootEntity: {
+ *     columns: {
+ *       id: { column: "u.user_id", type: "number" },
+ *       name: { column: "u.user_name", type: "string" }
+ *     }
+ *   },
+ *   metadata: { version: "2.0" }
+ * };
+ *
+ * const legacy = convertToLegacyJsonMapping(enhanced);
+ * // Result: Compatible with PostgresJsonQueryBuilder
+ * ```
+ *
+ * @see {@link convertColumnsToLegacy} For column-specific conversion
+ * @see {@link extractTypeProtection} For type safety features
+ */
+function convertToLegacyJsonMapping(input) {
+    if (!input) {
+        throw new Error('Input mapping is required');
+    }
+    // If it's already in legacy format, return as-is
+    if (input.rootName && input.rootEntity &&
+        typeof input.rootEntity.columns === 'object' &&
+        !input.typeInfo && !input.typeProtection && !input.metadata) {
+        // Check if columns are already in string format
+        const allColumnsAreStrings = Object.values(input.rootEntity.columns).every(col => typeof col === 'string');
+        if (allColumnsAreStrings) {
+            return input;
+        }
+    }
+    // Enhanced format conversion
+    if (input.rootName && input.rootEntity) {
+        return {
+            rootName: input.rootName,
+            rootEntity: {
+                id: input.rootEntity.id || 'root',
+                name: input.rootEntity.name || input.rootName,
+                columns: convertColumnsToLegacy(input.rootEntity.columns || {})
+            },
+            nestedEntities: (input.nestedEntities || []).map((entity) => ({
+                id: entity.id,
+                name: entity.name,
+                parentId: entity.parentId,
+                propertyName: entity.propertyName,
+                relationshipType: entity.relationshipType,
+                columns: convertColumnsToLegacy(entity.columns || {})
+            })),
+            resultFormat: input.resultFormat,
+            emptyResult: input.emptyResult
+        };
+    }
+    throw new Error('Unsupported mapping format');
+}
+/**
+ * Converts enhanced mapping to legacy format for backward compatibility.
+ */
+function toLegacyMapping(enhanced) {
+    return {
+        rootName: enhanced.rootName,
+        rootEntity: {
+            id: enhanced.rootEntity.id,
+            name: enhanced.rootEntity.name,
+            columns: convertColumnsToLegacy(enhanced.rootEntity.columns)
+        },
+        nestedEntities: enhanced.nestedEntities.map(entity => ({
+            id: entity.id,
+            name: entity.name,
+            parentId: entity.parentId,
+            propertyName: entity.propertyName,
+            relationshipType: entity.relationshipType,
+            columns: convertColumnsToLegacy(entity.columns)
+        })),
+        resultFormat: enhanced.resultFormat,
+        emptyResult: enhanced.emptyResult
+    };
+}
+/**
+ * Extracts type protection configuration from enhanced mapping.
+ */
+function extractTypeProtection(enhanced) {
+    const protectedStringFields = [];
+    const dateFields = [];
+    const numberFields = [];
+    // Use existing type protection if available
+    if (enhanced.typeProtection) {
+        return {
+            protectedStringFields: enhanced.typeProtection.protectedStringFields || [],
+            dateFields: enhanced.typeProtection.dateFields,
+            numberFields: enhanced.typeProtection.numberFields,
+            customTransforms: enhanced.typeProtection.customTransforms
+        };
+    }
+    // Process root entity
+    for (const [key, config] of Object.entries(enhanced.rootEntity.columns)) {
+        if (typeof config === 'object' && config.type) {
+            const columnName = config.column;
+            switch (config.type) {
+                case 'string':
+                    protectedStringFields.push(columnName);
+                    break;
+                case 'date':
+                    dateFields.push(columnName);
+                    break;
+                case 'number':
+                    numberFields.push(columnName);
+                    break;
+            }
+        }
+    }
+    // Process nested entities
+    for (const entity of enhanced.nestedEntities) {
+        for (const [key, config] of Object.entries(entity.columns)) {
+            if (typeof config === 'object' && config.type) {
+                const columnName = config.column;
+                switch (config.type) {
+                    case 'string':
+                        protectedStringFields.push(columnName);
+                        break;
+                    case 'date':
+                        dateFields.push(columnName);
+                        break;
+                    case 'number':
+                        numberFields.push(columnName);
+                        break;
+                }
+            }
+        }
+    }
+    return {
+        protectedStringFields,
+        dateFields: dateFields.length > 0 ? dateFields : undefined,
+        numberFields: numberFields.length > 0 ? numberFields : undefined,
+        customTransforms: undefined
+    };
+}
+//# sourceMappingURL=EnhancedJsonMapping.js.map

package/dist/transformers/EnhancedJsonMapping.js.map

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

package/dist/transformers/FilterableItemCollector.js

@@ -0,0 +1,259 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilterableItemCollector = exports.FilterableItem = void 0;
+const SimpleSelectQuery_1 = require("../models/SimpleSelectQuery");
+const SchemaCollector_1 = require("./SchemaCollector");
+const ParameterDetector_1 = require("../utils/ParameterDetector");
+const SelectableColumnCollector_1 = require("./SelectableColumnCollector");
+/**
+ * Represents a filterable item that can be used in DynamicQueryBuilder
+ * Can be either a table column or a SQL parameter
+ */
+class FilterableItem {
+    constructor(name, type, tableName) {
+        this.name = name;
+        this.type = type;
+        this.tableName = tableName;
+    }
+}
+exports.FilterableItem = FilterableItem;
+/**
+ * Collects filterable items (columns and parameters) from SQL queries
+ * for use in DynamicQueryBuilder filtering functionality.
+ *
+ * This class combines:
+ * - Table columns (from SelectableColumnCollector with FullName duplicate detection)
+ * - SQL parameters (from ParameterDetector)
+ *
+ * Features:
+ * - FullName mode preserves columns with same names from different tables (u.id vs p.id)
+ * - Upstream collection (default) provides comprehensive column discovery for maximum filtering
+ * - Qualified mode option for table.column naming in complex JOINs
+ *
+ * This allows DynamicQueryBuilder to filter on both actual table columns
+ * and fixed parameters defined in the SQL with full JOIN table support.
+ */
+class FilterableItemCollector {
+    /**
+     * Creates a new FilterableItemCollector
+     * @param tableColumnResolver Optional resolver for wildcard column expansion
+     * @param options Optional configuration options
+     *   - qualified: If true, return table.column names; if false, return column names only
+     *   - upstream: If true (default), collect all available columns from upstream sources for maximum filtering capability
+     */
+    constructor(tableColumnResolver, options) {
+        this.tableColumnResolver = tableColumnResolver;
+        this.options = { qualified: false, upstream: true, ...options };
+    }
+    /**
+     * Collects all filterable items (columns and parameters) from a SQL query
+     * @param query The parsed SQL query to analyze
+     * @returns Array of FilterableItem objects representing columns and parameters
+     */
+    collect(query) {
+        const items = [];
+        // 1. Collect table columns using SchemaCollector
+        const columnItems = this.collectColumns(query);
+        items.push(...columnItems);
+        // 2. Collect SQL parameters using ParameterDetector
+        const parameterItems = this.collectParameters(query);
+        items.push(...parameterItems);
+        // 3. Remove duplicates (same name and type)
+        return this.removeDuplicates(items);
+    }
+    /**
+     * Collects table columns using both SelectableColumnCollector and SchemaCollector
+     */
+    collectColumns(query) {
+        const items = [];
+        // First, collect columns using SelectableColumnCollector (includes WHERE clause columns)
+        try {
+            const columnCollector = new SelectableColumnCollector_1.SelectableColumnCollector(this.tableColumnResolver, false, // includeUsingColumns
+            SelectableColumnCollector_1.DuplicateDetectionMode.FullName, // Use full names to preserve duplicates
+            { upstream: this.options.upstream } // Enable upstream collection based on options
+            );
+            const columns = columnCollector.collect(query);
+            // Convert column information to FilterableItem objects
+            for (const column of columns) {
+                let tableName = undefined;
+                let realTableName = undefined;
+                // Primary: Extract table name from column reference namespace using getNamespace()
+                if (column.value && typeof column.value.getNamespace === 'function') {
+                    const namespace = column.value.getNamespace();
+                    if (namespace && namespace.trim() !== '') {
+                        tableName = namespace;
+                        // Get real table name if using qualified mode
+                        if (this.options.qualified) {
+                            realTableName = this.getRealTableName(query, namespace);
+                        }
+                    }
+                }
+                // Fallback: Try to infer from query structure for simple queries
+                if (!tableName) {
+                    tableName = this.inferTableNameFromQuery(query);
+                    if (tableName && this.options.qualified) {
+                        realTableName = tableName; // For simple queries, table name is already real
+                    }
+                }
+                // Generate column name based on qualified option
+                let columnName = column.name;
+                if (this.options.qualified && (realTableName || tableName)) {
+                    const nameToUse = realTableName || tableName;
+                    columnName = `${nameToUse}.${column.name}`;
+                }
+                items.push(new FilterableItem(columnName, 'column', tableName));
+            }
+        }
+        catch (error) {
+            // If SelectableColumnCollector fails, fall back to SchemaCollector only
+            console.warn('Failed to collect columns with SelectableColumnCollector, using fallback:', error);
+            try {
+                const schemaCollector = new SchemaCollector_1.SchemaCollector(this.tableColumnResolver, true);
+                const schemas = schemaCollector.collect(query);
+                for (const schema of schemas) {
+                    for (const columnName of schema.columns) {
+                        // Generate column name based on qualified option
+                        let finalColumnName = columnName;
+                        if (this.options.qualified) {
+                            // For SchemaCollector, schema.name should already be the real table name
+                            finalColumnName = `${schema.name}.${columnName}`;
+                        }
+                        items.push(new FilterableItem(finalColumnName, 'column', schema.name));
+                    }
+                }
+            }
+            catch (fallbackError) {
+                console.warn('Failed to collect columns with both approaches:', error, fallbackError);
+            }
+        }
+        return items;
+    }
+    /**
+     * Attempts to infer table name from query structure for simple cases
+     */
+    inferTableNameFromQuery(query) {
+        // For simple queries with single table, try to extract table name
+        if (query instanceof SimpleSelectQuery_1.SimpleSelectQuery && query.fromClause && query.fromClause.source) {
+            const datasource = query.fromClause.source.datasource;
+            if (datasource && typeof datasource.table === 'object') {
+                const table = datasource.table;
+                if (table && typeof table.name === 'string') {
+                    return table.name;
+                }
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Attempts to resolve real table name from alias/namespace
+     */
+    getRealTableName(query, aliasOrName) {
+        var _a, _b;
+        try {
+            // Handle CTEs by converting to simple query first
+            const simpleQuery = query.type === 'WITH' ? query.toSimpleQuery() : query;
+            if (simpleQuery instanceof SimpleSelectQuery_1.SimpleSelectQuery && simpleQuery.fromClause) {
+                // Check main datasource
+                if ((_a = simpleQuery.fromClause.source) === null || _a === void 0 ? void 0 : _a.datasource) {
+                    const mainSource = simpleQuery.fromClause.source;
+                    const realName = this.extractRealTableName(mainSource, aliasOrName);
+                    if (realName)
+                        return realName;
+                }
+                // Check JOIN clauses
+                const fromClause = simpleQuery.fromClause;
+                if (fromClause.joinClauses && Array.isArray(fromClause.joinClauses)) {
+                    for (const joinClause of fromClause.joinClauses) {
+                        if ((_b = joinClause.source) === null || _b === void 0 ? void 0 : _b.datasource) {
+                            const realName = this.extractRealTableName(joinClause.source, aliasOrName);
+                            if (realName)
+                                return realName;
+                        }
+                    }
+                }
+            }
+        }
+        catch (error) {
+            console.warn('Error resolving real table name:', error);
+        }
+        // If we can't resolve, return the original name
+        return aliasOrName;
+    }
+    /**
+     * Extracts real table name from a datasource
+     */
+    extractRealTableName(source, aliasOrName) {
+        var _a, _b, _c;
+        try {
+            const datasource = source.datasource;
+            if (!datasource)
+                return undefined;
+            // Get alias from multiple possible locations
+            const alias = source.alias || ((_b = (_a = source.aliasExpression) === null || _a === void 0 ? void 0 : _a.table) === null || _b === void 0 ? void 0 : _b.name);
+            const realTableName = (_c = datasource.table) === null || _c === void 0 ? void 0 : _c.name;
+            if (alias === aliasOrName && realTableName) {
+                return realTableName;
+            }
+            // If no alias but names match, it's a direct table reference
+            if (!alias && realTableName === aliasOrName) {
+                return realTableName;
+            }
+        }
+        catch (error) {
+            // Ignore errors in extraction
+        }
+        return undefined;
+    }
+    /**
+     * Collects SQL parameters from the query using ParameterDetector
+     */
+    collectParameters(query) {
+        const items = [];
+        try {
+            // Use existing ParameterDetector to extract parameter names from AST
+            const parameterNames = ParameterDetector_1.ParameterDetector.extractParameterNames(query);
+            // Convert parameter names to FilterableItem objects
+            for (const paramName of parameterNames) {
+                items.push(new FilterableItem(paramName, 'parameter'));
+            }
+        }
+        catch (error) {
+            // If parameter extraction fails, continue with empty parameter list
+            console.warn('Failed to collect parameters:', error);
+        }
+        return items;
+    }
+    /**
+     * Removes duplicate items with the same name, type, and table name
+     * This preserves columns with the same name from different tables
+     */
+    removeDuplicates(items) {
+        const seen = new Set();
+        const result = [];
+        for (const item of items) {
+            // Include table name in the key to preserve columns from different tables
+            const key = `${item.type}:${item.name}:${item.tableName || 'none'}`;
+            if (!seen.has(key)) {
+                seen.add(key);
+                result.push(item);
+            }
+        }
+        return result.sort((a, b) => {
+            // Sort by type first (columns before parameters), then by table name, then by name
+            if (a.type !== b.type) {
+                return a.type === 'column' ? -1 : 1;
+            }
+            // For columns, sort by table name first, then column name
+            if (a.type === 'column') {
+                const tableA = a.tableName || '';
+                const tableB = b.tableName || '';
+                if (tableA !== tableB) {
+                    return tableA.localeCompare(tableB);
+                }
+            }
+            return a.name.localeCompare(b.name);
+        });
+    }
+}
+exports.FilterableItemCollector = FilterableItemCollector;
+//# sourceMappingURL=FilterableItemCollector.js.map

package/dist/transformers/FilterableItemCollector.js.map

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

package/dist/transformers/FixtureCteBuilder.js

@@ -0,0 +1,151 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FixtureCteBuilder = void 0;
+const Clause_1 = require("../models/Clause");
+const SelectQuery_1 = require("../models/SelectQuery");
+const ValueComponent_1 = require("../models/ValueComponent");
+const DDLToFixtureConverter_1 = require("./DDLToFixtureConverter");
+class FixtureCteBuilder {
+    /**
+     * Creates fixture definitions from a SQL string containing DDL (CREATE TABLE) and INSERT statements.
+     *
+     * @param sql The SQL string containing DDL and INSERTs.
+     * @returns An array of FixtureTableDefinition objects.
+     */
+    static fromSQL(sql) {
+        const fixtureJson = DDLToFixtureConverter_1.DDLToFixtureConverter.convert(sql);
+        return this.fromJSON(fixtureJson);
+    }
+    /**
+     * Converts JSON fixture definitions to FixtureTableDefinition format.
+     * Accepts an object where keys are table names and values contain columns and rows.
+     *
+     * @param jsonDefinitions Object with table definitions
+     * @returns Array of FixtureTableDefinition
+     *
+     * @example
+     * ```typescript
+     * const json = {
+     *   users: {
+     *     columns: [
+     *       { name: 'id', type: 'integer' },
+     *       { name: 'name', type: 'text' }
+     *     ],
+     *     rows: [
+     *       { id: 1, name: 'Alice' },
+     *       { id: 2, name: 'Bob' }
+     *     ]
+     *   }
+     * };
+     * const fixtures = FixtureCteBuilder.fromJSON(json);
+     * ```
+     */
+    static fromJSON(jsonDefinitions) {
+        const fixtures = [];
+        for (const [tableName, def] of Object.entries(jsonDefinitions)) {
+            if (def && Array.isArray(def.columns)) {
+                const columns = def.columns.map(c => ({
+                    name: c.name,
+                    typeName: c.type,
+                    defaultValue: c.default
+                }));
+                let rows = [];
+                if (Array.isArray(def.rows)) {
+                    // Convert array of objects to array of arrays based on column order
+                    rows = def.rows.map(rowObj => {
+                        return columns.map(col => {
+                            return rowObj[col.name] !== undefined ? rowObj[col.name] : null;
+                        });
+                    });
+                }
+                fixtures.push({
+                    tableName,
+                    columns,
+                    rows
+                });
+            }
+        }
+        return fixtures;
+    }
+    /** Builds CommonTable representations for the provided fixtures. */
+    static buildFixtures(fixtures) {
+        return fixtures.map((fixture) => this.buildFixture(fixture));
+    }
+    static buildFixture(fixture) {
+        const query = this.buildSelectQuery(fixture);
+        // Wrap the query into a CommonTable for later WITH clause injection.
+        return new Clause_1.CommonTable(query, fixture.tableName, null);
+    }
+    static buildSelectQuery(fixture) {
+        const columnCount = fixture.columns.length;
+        // Always produce at least one row even when the fixture carries zero entries.
+        const rows = fixture.rows.length > 0 ? fixture.rows : [new Array(columnCount).fill(null)];
+        const selectQueries = rows.map((row) => this.buildSelectRow(fixture.columns, row));
+        if (selectQueries.length === 0) {
+            throw new Error('No rows to build SELECT query');
+        }
+        let result = selectQueries[0];
+        // Build UNION ALL chain for multiple rows
+        for (let i = 1; i < selectQueries.length; i++) {
+            // Both SimpleSelectQuery and BinarySelectQuery have toUnionAll/unionAll methods
+            if (result instanceof SelectQuery_1.SimpleSelectQuery) {
+                result = result.toUnionAll(selectQueries[i]);
+            }
+            else {
+                // BinarySelectQuery has unionAll method
+                result = result.unionAll(selectQueries[i]);
+            }
+        }
+        // Handle empty fixture case: add WHERE 1 = 0 to make it return no rows
+        if (fixture.rows.length === 0 && result instanceof SelectQuery_1.SimpleSelectQuery) {
+            const falseCondition = new ValueComponent_1.BinaryExpression(new ValueComponent_1.LiteralValue(1), '=', new ValueComponent_1.LiteralValue(0));
+            result.whereClause = new Clause_1.WhereClause(falseCondition);
+        }
+        return result;
+    }
+    static buildSelectRow(columns, row) {
+        // Build select items that respect optional type annotations.
+        const items = columns.map((column, index) => {
+            const value = index < row.length ? row[index] : null;
+            const literalValue = this.createLiteralValue(value);
+            let expression = literalValue;
+            if (column.typeName) {
+                const typeValue = new ValueComponent_1.TypeValue(null, new ValueComponent_1.RawString(column.typeName));
+                expression = new ValueComponent_1.CastExpression(literalValue, typeValue);
+            }
+            return new Clause_1.SelectItem(expression, column.name);
+        });
+        const selectClause = new Clause_1.SelectClause(items);
+        return new SelectQuery_1.SimpleSelectQuery({ selectClause });
+    }
+    static createLiteralValue(value) {
+        if (value === null || value === undefined) {
+            return new ValueComponent_1.LiteralValue(null);
+        }
+        if (typeof value === 'number') {
+            return new ValueComponent_1.LiteralValue(Number.isFinite(value) ? value : null);
+        }
+        if (typeof value === 'boolean') {
+            // Preserve boolean literals so the printer emits TRUE/FALSE instead of quoted strings
+            return new ValueComponent_1.LiteralValue(value);
+        }
+        if (typeof value === 'bigint') {
+            // Convert bigint to string to preserve precision
+            // LiteralValue accepts string|number|boolean|null, and when isStringLiteral is false,
+            // the printer will output it as-is without quotes
+            return new ValueComponent_1.LiteralValue(value.toString());
+        }
+        if (typeof Buffer !== 'undefined' && value instanceof Buffer) {
+            // For Buffer, we'll create a hex string literal
+            return new ValueComponent_1.LiteralValue(`X'${value.toString('hex')}'`);
+        }
+        if (typeof value === 'string') {
+            // Store the raw string value WITHOUT quotes or escaping
+            // The SqlPrinter will handle escaping when printing
+            return new ValueComponent_1.LiteralValue(value, undefined, true);
+        }
+        return new ValueComponent_1.LiteralValue(String(value), undefined, true);
+    }
+}
+exports.FixtureCteBuilder = FixtureCteBuilder;
+//# sourceMappingURL=FixtureCteBuilder.js.map

package/dist/transformers/FixtureCteBuilder.js.map

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