rawsql-ts 0.12.0 → 0.13.0

package/dist/transformers/LinePrinter.js

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PrintLine = exports.LinePrinter = void 0;
+/**
+ * SqlPrintHelper provides utility methods for SQL pretty printing.
+ */
+class LinePrinter {
+    /**
+     * @param indentChar Character used for indentation (default: ' ') // Accepts logical names like 'space'/'tab'
+     * @param indentSize Number of indentChar per level (default: 0)
+     * @param newline Newline string (default: '\r\n') // Accepts logical names like 'lf'/'crlf'/'cr'
+     * @param commaBreak Comma break style (default: 'none')
+     */
+    constructor(indentChar = ' ', indentSize = 0, newline = '\r\n', commaBreak = 'none') {
+        this.indentChar = indentChar;
+        this.indentSize = indentSize;
+        this.newline = newline;
+        this.commaBreak = commaBreak;
+        this.lines = [];
+        this.appendNewline(0);
+    }
+    print() {
+        let result = '';
+        for (const line of this.lines) {
+            if (line.text !== '') {
+                // append indent and text
+                result += this.indent(line.level) + line.text;
+            }
+        }
+        return result.trimEnd();
+    }
+    /**
+     * Returns the indent string for a given level.
+     * @param level Indentation level
+     */
+    indent(level) {
+        return this.indentChar.repeat(this.indentSize * level);
+    }
+    /**
+     * Appends a newline token to the given tokens array if newline is set, or adds an empty line if tokens is empty.
+     * @param tokens Array of token objects with 'level' and 'text' property
+     * @param level Indentation level
+     */
+    appendNewline(level) {
+        if (this.lines.length > 0) {
+            const current = this.lines[this.lines.length - 1];
+            if (current.text !== '') {
+                current.text = current.text.trimEnd() + this.newline;
+            }
+        }
+        this.lines.push(new PrintLine(level, ''));
+    }
+    /**
+     * Appends text to the last element of tokens array.
+     * @param tokens Array of token objects with 'text' property
+     * @param text Text to append
+     */
+    appendText(text) {
+        // Handle special comma cleanup first
+        if (this.cleanupLine(text)) {
+            // If cleanup was performed, add comma to previous line
+            const previousLine = this.lines[this.lines.length - 1];
+            previousLine.text = previousLine.text.trimEnd() + text;
+            return;
+        }
+        const workLine = this.getCurrentLine();
+        // Leading space is not needed
+        if (!(text === ' ' && workLine.text === '')) {
+            workLine.text += text;
+        }
+    }
+    trimTrailingWhitespaceFromPreviousLine() {
+        if (this.lines.length < 2) {
+            return;
+        }
+        const previousLine = this.lines[this.lines.length - 2];
+        const newlineMatch = previousLine.text.match(/(\r?\n)$/);
+        const trailingNewline = newlineMatch ? newlineMatch[1] : '';
+        const content = trailingNewline
+            ? previousLine.text.slice(0, -trailingNewline.length)
+            : previousLine.text;
+        previousLine.text = content.replace(/[ \t]+$/, '') + trailingNewline;
+    }
+    /**
+     * Cleans up the current line for comma formatting.
+     * For 'after' and 'none' comma styles, removes empty line when a comma is being added.
+     * @param text The text being processed
+     * @returns true if cleanup was performed, false otherwise
+     */
+    cleanupLine(text) {
+        const workLine = this.getCurrentLine();
+        if (text === ',' && workLine.text.trim() === '' && this.lines.length > 1 && (this.commaBreak === 'after' || this.commaBreak === 'none')) {
+            let previousIndex = this.lines.length - 2;
+            while (previousIndex >= 0 && this.lines[previousIndex].text.trim() === '') {
+                this.lines.splice(previousIndex, 1);
+                previousIndex--;
+            }
+            if (previousIndex < 0) {
+                return false;
+            }
+            const previousLine = this.lines[previousIndex];
+            // Avoid pulling commas onto a line comment to keep the comma executable
+            if (this.lineHasTrailingComment(previousLine.text)) {
+                return false;
+            }
+            this.lines.pop(); // Safe: we checked lines.length > 1
+            return true; // Cleanup performed
+        }
+        return false; // No cleanup needed
+    }
+    lineHasTrailingComment(text) {
+        // Strip simple quoted sections so comment markers inside literals are ignored.
+        const withoutStrings = text
+            .replace(/'([^']|'')*'/g, '')
+            .replace(/"([^"]|"")*"/g, '')
+            .trim();
+        // Treat any remaining '--' as a line comment marker so we never pull commas onto commented lines.
+        return withoutStrings.includes('--');
+    }
+    getCurrentLine() {
+        if (this.lines.length > 0) {
+            return this.lines[this.lines.length - 1];
+        }
+        else {
+            throw new Error('No tokens to get current line from.');
+        }
+    }
+    /**
+     * Checks if the current line is empty (has no text content)
+     * @returns true if current line is empty, false otherwise
+     */
+    isCurrentLineEmpty() {
+        if (this.lines.length > 0) {
+            const currentLine = this.lines[this.lines.length - 1];
+            return currentLine.text.trim() === '';
+        }
+        return true;
+    }
+}
+exports.LinePrinter = LinePrinter;
+class PrintLine {
+    constructor(level, text) {
+        this.level = level;
+        this.text = text;
+    }
+}
+exports.PrintLine = PrintLine;
+//# sourceMappingURL=LinePrinter.js.map

package/dist/transformers/LinePrinter.js.map

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

package/dist/transformers/MergeResultSelectConverter.js

@@ -0,0 +1,310 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MergeResultSelectConverter = void 0;
+const Clause_1 = require("../models/Clause");
+const MergeQuery_1 = require("../models/MergeQuery");
+const ValueComponent_1 = require("../models/ValueComponent");
+const SelectQuery_1 = require("../models/SelectQuery");
+const FixtureCteBuilder_1 = require("./FixtureCteBuilder");
+const TableSourceCollector_1 = require("./TableSourceCollector");
+const SelectQueryWithClauseHelper_1 = require("../utils/SelectQueryWithClauseHelper");
+class MergeResultSelectConverter {
+    /**
+     * Converts a MERGE query into a SELECT that counts or models the rows affected by each action.
+     */
+    static toSelectQuery(mergeQuery, options) {
+        var _a, _b, _c;
+        // Build individual SELECTs for each WHEN clause so the row count can include every affected path.
+        const actionSelects = this.buildActionSelects(mergeQuery);
+        if (actionSelects.length === 0) {
+            throw new Error('MERGE query must include at least one action that affects rows.');
+        }
+        // Combine the individual action selects into one union so the COUNT(*) can inspect all of them.
+        const unionSource = this.combineSelects(actionSelects);
+        const derivedSource = new Clause_1.SourceExpression(new Clause_1.SubQuerySource(unionSource), new Clause_1.SourceAliasExpression('__merge_action_rows', null));
+        // Wrap the union in a derived table so the outer query can aggregate a single row count.
+        const finalSelect = new SelectQuery_1.SimpleSelectQuery({
+            selectClause: this.buildCountSelectClause(),
+            fromClause: new Clause_1.FromClause(derivedSource, null)
+        });
+        // Prepare fixture metadata before verifying coverage.
+        const fixtureTables = (_a = options === null || options === void 0 ? void 0 : options.fixtureTables) !== null && _a !== void 0 ? _a : [];
+        const fixtureMap = this.buildFixtureTableMap(fixtureTables);
+        const missingStrategy = (_b = options === null || options === void 0 ? void 0 : options.missingFixtureStrategy) !== null && _b !== void 0 ? _b : this.DEFAULT_MISSING_FIXTURE_STRATEGY;
+        const nativeWithClause = (_c = mergeQuery.withClause) !== null && _c !== void 0 ? _c : null;
+        const referencedTables = this.collectPhysicalTableReferences(unionSource, nativeWithClause);
+        const cteNames = this.collectCteNamesFromWithClause(nativeWithClause);
+        const targetName = this.normalizeIdentifier(this.extractTargetTableName(mergeQuery.target));
+        if (!cteNames.has(targetName)) {
+            referencedTables.add(targetName);
+        }
+        // Ensure every referenced physical table is backed by a fixture when required.
+        this.ensureFixtureCoverage(referencedTables, fixtureMap, missingStrategy);
+        // Merge fixture CTEs ahead of any original MERGE WITH clause definitions.
+        const filteredFixtures = this.filterFixtureTablesForReferences(fixtureTables, referencedTables);
+        const fixtureCtes = this.buildFixtureCtes(filteredFixtures);
+        const combinedWithClause = this.mergeWithClause(nativeWithClause, fixtureCtes);
+        SelectQueryWithClauseHelper_1.SelectQueryWithClauseHelper.setWithClause(finalSelect, combinedWithClause);
+        return finalSelect;
+    }
+    static buildActionSelects(mergeQuery) {
+        const selects = [];
+        // Translate each WHEN clause into a row-producing SELECT when it represents an actual change.
+        for (const clause of mergeQuery.whenClauses) {
+            const selectQuery = this.buildSelectForClause(mergeQuery, clause);
+            if (selectQuery) {
+                selects.push(selectQuery);
+            }
+        }
+        return selects;
+    }
+    static buildSelectForClause(mergeQuery, clause) {
+        switch (clause.matchType) {
+            case 'matched':
+                return this.buildMatchedSelect(mergeQuery, clause);
+            case 'not_matched':
+            case 'not_matched_by_target':
+                return this.buildNotMatchedSelect(mergeQuery, clause);
+            case 'not_matched_by_source':
+                return this.buildNotMatchedBySourceSelect(mergeQuery, clause);
+            default:
+                return null;
+        }
+    }
+    static buildMatchedSelect(mergeQuery, clause) {
+        const action = clause.action;
+        if (action instanceof MergeQuery_1.MergeDoNothingAction) {
+            return null;
+        }
+        if (!(action instanceof MergeQuery_1.MergeUpdateAction) && !(action instanceof MergeQuery_1.MergeDeleteAction)) {
+            return null;
+        }
+        // Match target rows with their source counterparts via the MERGE ON predicate.
+        const joinClause = new Clause_1.JoinClause('inner join', mergeQuery.source, new Clause_1.JoinOnClause(mergeQuery.onCondition), false);
+        // Apply any additional WHEN/WHERE filters tied to this action.
+        const combinedPredicate = this.combineConditions([
+            clause.condition,
+            this.buildActionWhereClause(action)
+        ]);
+        const whereClause = combinedPredicate ? new Clause_1.WhereClause(combinedPredicate) : null;
+        return new SelectQuery_1.SimpleSelectQuery({
+            selectClause: this.buildLiteralSelectClause(),
+            fromClause: new Clause_1.FromClause(mergeQuery.target, [joinClause]),
+            whereClause
+        });
+    }
+    static buildNotMatchedSelect(mergeQuery, clause) {
+        if (!(clause.action instanceof MergeQuery_1.MergeInsertAction)) {
+            return null;
+        }
+        // Select source rows that lack any matching target record using NOT EXISTS semantics.
+        const notExistsExpression = this.buildNotExistsExpression(mergeQuery.target, mergeQuery.onCondition);
+        const combinedPredicate = this.combineConditions([notExistsExpression, clause.condition]);
+        const whereClause = combinedPredicate ? new Clause_1.WhereClause(combinedPredicate) : null;
+        return new SelectQuery_1.SimpleSelectQuery({
+            selectClause: this.buildLiteralSelectClause(),
+            fromClause: new Clause_1.FromClause(mergeQuery.source, null),
+            whereClause
+        });
+    }
+    static buildNotMatchedBySourceSelect(mergeQuery, clause) {
+        const action = clause.action;
+        if (!(action instanceof MergeQuery_1.MergeDeleteAction)) {
+            return null;
+        }
+        // Select target rows that are orphaned by the source to emulate delete actions.
+        const notExistsExpression = this.buildNotExistsExpression(mergeQuery.source, mergeQuery.onCondition);
+        const combinedPredicate = this.combineConditions([
+            notExistsExpression,
+            clause.condition,
+            this.buildActionWhereClause(action)
+        ]);
+        const whereClause = combinedPredicate ? new Clause_1.WhereClause(combinedPredicate) : null;
+        return new SelectQuery_1.SimpleSelectQuery({
+            selectClause: this.buildLiteralSelectClause(),
+            fromClause: new Clause_1.FromClause(mergeQuery.target, null),
+            whereClause
+        });
+    }
+    static buildNotExistsExpression(sourceReference, predicate) {
+        // Build an EXISTS subquery that can be negated to detect missing matches.
+        const existsSelect = new SelectQuery_1.SimpleSelectQuery({
+            selectClause: this.buildLiteralSelectClause(),
+            fromClause: new Clause_1.FromClause(sourceReference, null),
+            whereClause: new Clause_1.WhereClause(predicate)
+        });
+        const existsExpression = new ValueComponent_1.UnaryExpression('exists', new ValueComponent_1.InlineQuery(existsSelect));
+        return new ValueComponent_1.UnaryExpression('not', existsExpression);
+    }
+    static buildActionWhereClause(action) {
+        var _a, _b;
+        return (_b = (_a = action.whereClause) === null || _a === void 0 ? void 0 : _a.condition) !== null && _b !== void 0 ? _b : null;
+    }
+    // Combine additional predicates into a single AND expression for filtering.
+    static combineConditions(predicates) {
+        const values = predicates.filter((predicate) => Boolean(predicate));
+        if (values.length === 0) {
+            return null;
+        }
+        return values.reduce((acc, value) => {
+            if (!acc) {
+                return value;
+            }
+            return new ValueComponent_1.BinaryExpression(acc, 'and', value);
+        }, null);
+    }
+    // Combine all action queries via UNION ALL so the count can see every simulated row.
+    static combineSelects(selects) {
+        if (selects.length === 1) {
+            return selects[0];
+        }
+        let combined = new SelectQuery_1.BinarySelectQuery(selects[0], 'union all', selects[1]);
+        for (let i = 2; i < selects.length; i++) {
+            combined = combined.unionAll(selects[i]);
+        }
+        return combined;
+    }
+    // Build the simple SELECT clause that yields one row per matched action.
+    static buildLiteralSelectClause() {
+        return new Clause_1.SelectClause([new Clause_1.SelectItem(new ValueComponent_1.LiteralValue(1))]);
+    }
+    // Summarize the merged action stream by counting every row that survived the union.
+    static buildCountSelectClause() {
+        const countFunction = new ValueComponent_1.FunctionCall(null, 'count', new ValueComponent_1.RawString('*'), null);
+        const selectItem = new Clause_1.SelectItem(countFunction, 'count');
+        return new Clause_1.SelectClause([selectItem]);
+    }
+    static buildFixtureCtes(fixtures) {
+        if (!fixtures || fixtures.length === 0) {
+            return [];
+        }
+        return FixtureCteBuilder_1.FixtureCteBuilder.buildFixtures(fixtures);
+    }
+    static collectPhysicalTableReferences(query, withClause) {
+        const referencedTables = this.collectReferencedTables(query);
+        const ignoredTables = this.collectCteNamesFromWithClause(withClause);
+        const tablesToShadow = new Set();
+        // Retain only tables that are not defined via WITH clauses so fixtures shadow physical sources.
+        for (const table of referencedTables) {
+            if (ignoredTables.has(table)) {
+                continue;
+            }
+            tablesToShadow.add(table);
+        }
+        const cteReferencedTables = this.collectReferencedTablesFromWithClause(withClause);
+        for (const table of cteReferencedTables) {
+            if (ignoredTables.has(table)) {
+                continue;
+            }
+            tablesToShadow.add(table);
+        }
+        return tablesToShadow;
+    }
+    static filterFixtureTablesForReferences(fixtures, referencedTables) {
+        if (!fixtures.length || referencedTables.size === 0) {
+            return [];
+        }
+        const filtered = [];
+        // Keep fixtures only for tables that actually appear in the converted SELECT.
+        for (const fixture of fixtures) {
+            if (referencedTables.has(this.normalizeIdentifier(fixture.tableName))) {
+                filtered.push(fixture);
+            }
+        }
+        return filtered;
+    }
+    static collectReferencedTablesFromWithClause(withClause) {
+        const tables = new Set();
+        if (!(withClause === null || withClause === void 0 ? void 0 : withClause.tables)) {
+            return tables;
+        }
+        for (const cte of withClause.tables) {
+            for (const table of this.collectReferencedTables(cte.query)) {
+                tables.add(table);
+            }
+        }
+        return tables;
+    }
+    static extractTargetTableName(target) {
+        const datasource = target.datasource;
+        if (datasource instanceof Clause_1.TableSource) {
+            return datasource.getSourceName();
+        }
+        throw new Error('Merge target must be a table source for conversion.');
+    }
+    static buildFixtureTableMap(fixtures) {
+        const map = new Map();
+        for (const fixture of fixtures) {
+            map.set(this.normalizeIdentifier(fixture.tableName), fixture);
+        }
+        return map;
+    }
+    static ensureFixtureCoverage(referencedTables, fixtureMap, strategy) {
+        if (referencedTables.size === 0) {
+            return;
+        }
+        // Compare the referenced tables against the fixtures that were supplied.
+        const missingTables = this.getMissingFixtureTables(referencedTables, fixtureMap);
+        if (missingTables.length === 0) {
+            return;
+        }
+        if (strategy === 'error') {
+            throw new Error(`Merge SELECT refers to tables without fixture coverage: ${missingTables.join(', ')}.`);
+        }
+    }
+    // Use the collector to track every concrete table source referenced by the SELECT.
+    static collectReferencedTables(query) {
+        const collector = new TableSourceCollector_1.TableSourceCollector(false);
+        const sources = collector.collect(query);
+        const normalized = new Set();
+        for (const source of sources) {
+            normalized.add(this.normalizeIdentifier(source.getSourceName()));
+        }
+        return normalized;
+    }
+    // Track CTE aliases so those names are ignored when validating fixtures.
+    static collectCteNamesFromWithClause(withClause) {
+        const names = new Set();
+        if (!(withClause === null || withClause === void 0 ? void 0 : withClause.tables)) {
+            return names;
+        }
+        for (const table of withClause.tables) {
+            names.add(this.normalizeIdentifier(table.getSourceAliasName()));
+        }
+        return names;
+    }
+    // Return every referenced table that lacks an overriding fixture definition.
+    static getMissingFixtureTables(referencedTables, fixtureMap) {
+        const missing = [];
+        for (const table of referencedTables) {
+            if (!fixtureMap.has(table)) {
+                missing.push(table);
+            }
+        }
+        return missing;
+    }
+    // Prepend fixture CTEs ahead of the existing WITH clause so they shadow real tables.
+    static mergeWithClause(original, fixtureCtes) {
+        var _a;
+        if (!fixtureCtes.length && !original) {
+            return null;
+        }
+        const combinedTables = [...fixtureCtes];
+        if (original === null || original === void 0 ? void 0 : original.tables) {
+            combinedTables.push(...original.tables);
+        }
+        if (!combinedTables.length) {
+            return null;
+        }
+        const merged = new Clause_1.WithClause((_a = original === null || original === void 0 ? void 0 : original.recursive) !== null && _a !== void 0 ? _a : false, combinedTables);
+        merged.globalComments = (original === null || original === void 0 ? void 0 : original.globalComments) ? [...original.globalComments] : null;
+        merged.trailingComments = (original === null || original === void 0 ? void 0 : original.trailingComments) ? [...original.trailingComments] : null;
+        return merged;
+    }
+    static normalizeIdentifier(value) {
+        return value.trim().toLowerCase();
+    }
+}
+exports.MergeResultSelectConverter = MergeResultSelectConverter;
+MergeResultSelectConverter.DEFAULT_MISSING_FIXTURE_STRATEGY = 'error';
+//# sourceMappingURL=MergeResultSelectConverter.js.map

package/dist/transformers/MergeResultSelectConverter.js.map

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

package/dist/transformers/ModelDrivenJsonMapping.js

@@ -0,0 +1,122 @@
+"use strict";
+/**
+ * Model-driven JSON mapping structure that mirrors TypeScript model definitions.
+ * This approach provides intuitive, hierarchical mapping that closely resembles the target data structure.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertModelDrivenMapping = convertModelDrivenMapping;
+exports.validateModelDrivenMapping = validateModelDrivenMapping;
+/**
+ * Convert a model-driven JSON mapping to the traditional JsonMapping format.
+ * This enables backward compatibility with existing PostgresJsonQueryBuilder.
+ */
+function convertModelDrivenMapping(modelMapping) {
+    const protectedStringFields = [];
+    let entityIdCounter = 0;
+    const propertyNameCounters = {};
+    // Generate unique entity IDs
+    const generateEntityId = () => `entity_${++entityIdCounter}`;
+    // Generate unique property names to avoid JSON key conflicts
+    const generateUniquePropertyName = (baseName) => {
+        if (!propertyNameCounters[baseName]) {
+            propertyNameCounters[baseName] = 0;
+        }
+        propertyNameCounters[baseName]++;
+        return propertyNameCounters[baseName] === 1 ? baseName : `${baseName}_${propertyNameCounters[baseName]}`;
+    };
+    // Helper function to process structure fields and extract entities
+    const processStructure = (structure, parentId = null) => {
+        const columns = {};
+        const nestedEntities = [];
+        for (const [fieldName, config] of Object.entries(structure)) {
+            if (typeof config === 'string') {
+                // Simple field mapping: "fieldName": "column_name"
+                columns[fieldName] = config;
+            }
+            else if ('column' in config && typeof config.column === 'string' && !('type' in config && (config.type === 'object' || config.type === 'array'))) {
+                // Enhanced field mapping: "fieldName": { "column": "column_name", "type": "string" }
+                const fieldConfig = config;
+                if (typeof fieldConfig === 'object' && 'column' in fieldConfig) {
+                    columns[fieldName] = fieldConfig.column;
+                    if (fieldConfig.type === 'string') {
+                        protectedStringFields.push(fieldConfig.column);
+                    }
+                }
+            }
+            else if ('from' in config && typeof config.from === 'string' && !('type' in config && (config.type === 'object' || config.type === 'array'))) {
+                // Legacy field mapping: "fieldName": { "from": "column_name", "type": "string" }
+                const fieldConfig = config;
+                if (typeof fieldConfig === 'object' && 'from' in fieldConfig) {
+                    columns[fieldName] = fieldConfig.from;
+                    if (fieldConfig.type === 'string') {
+                        protectedStringFields.push(fieldConfig.from);
+                    }
+                }
+            }
+            else if ('type' in config && (config.type === 'object' || config.type === 'array')) {
+                // Nested structure: object or array
+                const nestedStructure = config;
+                const uniquePropertyName = generateUniquePropertyName(fieldName);
+                // Generate globally unique entity ID to ensure unique JSON column names
+                const entityId = generateEntityId();
+                const processedNested = processStructure(nestedStructure.structure, entityId);
+                nestedEntities.push({
+                    id: entityId, // Use unique ID to avoid column conflicts
+                    name: fieldName.charAt(0).toUpperCase() + fieldName.slice(1), // Capitalize first letter
+                    parentId: parentId || 'root',
+                    propertyName: uniquePropertyName,
+                    originalPropertyName: fieldName, // Store original name for final mapping
+                    relationshipType: nestedStructure.type,
+                    columns: processedNested.columns
+                });
+                // Add nested entities from deeper levels
+                nestedEntities.push(...processedNested.nestedEntities.map(entity => ({
+                    ...entity,
+                    parentId: entity.parentId === 'root' ? entityId : entity.parentId
+                })));
+            }
+        }
+        return { columns, nestedEntities };
+    };
+    // Process the root structure
+    const processed = processStructure(modelMapping.structure); // Build the traditional JsonMapping
+    const jsonMapping = {
+        rootName: 'root', // Default root name
+        rootEntity: {
+            id: 'root',
+            name: 'Root',
+            columns: processed.columns
+        },
+        nestedEntities: processed.nestedEntities
+    };
+    // Add typeInfo for backward compatibility
+    jsonMapping.typeInfo = modelMapping.typeInfo;
+    return {
+        jsonMapping,
+        typeProtection: { protectedStringFields }
+    };
+}
+/**
+ * Validate that a model-driven mapping structure is well-formed.
+ */
+function validateModelDrivenMapping(mapping) {
+    const errors = [];
+    // Validate typeInfo
+    if (!mapping.typeInfo) {
+        errors.push('typeInfo is required');
+    }
+    else {
+        if (!mapping.typeInfo.interface) {
+            errors.push('typeInfo.interface is required');
+        }
+        if (!mapping.typeInfo.importPath) {
+            errors.push('typeInfo.importPath is required');
+        }
+    }
+    // Validate structure
+    if (!mapping.structure || typeof mapping.structure !== 'object') {
+        errors.push('structure is required and must be an object');
+    }
+    return errors;
+}
+//# sourceMappingURL=ModelDrivenJsonMapping.js.map

package/dist/transformers/ModelDrivenJsonMapping.js.map

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