@integromat/module-migrator-core 0.0.1

package/README.md

@@ -0,0 +1,11 @@
+# module-migrator-core
+
+This library was generated with [Nx](https://nx.dev).
+
+## Building
+
+Run `nx build module-migrator-core` to build the library.
+
+## Running unit tests
+
+Run `nx test module-migrator-core` to execute the unit tests via [Jest](https://jestjs.io).

package/cjs/lib/blueprint-parser.d.ts

@@ -0,0 +1,7 @@
+import type { Blueprint, Bundle, DeprecatedModule, FlowModule } from './types.ts';
+declare const parseBlueprint: (json: string) => Blueprint;
+declare const collectAllModules: (blueprint: Blueprint) => FlowModule[];
+declare const findDeprecatedModules: (blueprint: Blueprint, config: Bundle) => DeprecatedModule[];
+declare const cloneBlueprint: (blueprint: Blueprint) => Blueprint;
+declare const serializeBlueprint: (blueprint: Blueprint) => string;
+export { cloneBlueprint, collectAllModules, findDeprecatedModules, parseBlueprint, serializeBlueprint, };

package/cjs/lib/blueprint-parser.js

@@ -0,0 +1,60 @@
+'use strict';
+
+var migration = require('./domain/migration.js');
+
+const parseBlueprint = (json) => {
+    const parsed = JSON.parse(json);
+    return parsed;
+};
+const collectAllModules = (blueprint) => {
+    const modules = [];
+    const traverse = (items) => {
+        for (const flowModule of items) {
+            modules.push(flowModule);
+            if (flowModule.routes) {
+                for (const route of flowModule.routes) {
+                    if (route.flow) {
+                        traverse(route.flow);
+                    }
+                }
+            }
+        }
+    };
+    if (blueprint.flow) {
+        traverse(blueprint.flow);
+    }
+    if (blueprint.metadata?.designer?.orphans) {
+        traverse(blueprint.metadata.designer.orphans);
+    }
+    return modules;
+};
+const findDeprecatedModules = (blueprint, config) => {
+    const allModules = collectAllModules(blueprint);
+    const deprecated = [];
+    for (const flowModule of allModules) {
+        const migration$1 = migration.findMigration(config, flowModule.module, flowModule.version);
+        if (migration$1) {
+            deprecated.push({
+                id: flowModule.id,
+                fromModule: flowModule.module,
+                toModule: migration$1.to.module,
+                toVersion: migration$1.to.version,
+                flowModule,
+            });
+        }
+    }
+    return deprecated;
+};
+const cloneBlueprint = (blueprint) => {
+    return structuredClone(blueprint);
+};
+const serializeBlueprint = (blueprint) => {
+    return JSON.stringify(blueprint, undefined, 2);
+};
+
+exports.cloneBlueprint = cloneBlueprint;
+exports.collectAllModules = collectAllModules;
+exports.findDeprecatedModules = findDeprecatedModules;
+exports.parseBlueprint = parseBlueprint;
+exports.serializeBlueprint = serializeBlueprint;
+//# sourceMappingURL=blueprint-parser.js.map

package/cjs/lib/blueprint-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blueprint-parser.js","sources":["../../src/lib/blueprint-parser.ts"],"sourcesContent":[null],"names":["migration","findMigration"],"mappings":";;;;AAGA,MAAM,cAAc,GAAG,CAAC,IAAY,KAAe;IAClD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY;AAC1C,IAAA,OAAO,MAAmB;AAC3B;AAEA,MAAM,iBAAiB,GAAG,CAAC,SAAoB,KAAkB;IAChE,MAAM,OAAO,GAAiB,EAAE;AAEhC,IAAA,MAAM,QAAQ,GAAG,CAAC,KAAmB,KAAI;AACxC,QAAA,KAAK,MAAM,UAAU,IAAI,KAAK,EAAE;AAC/B,YAAA,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC;AACxB,YAAA,IAAI,UAAU,CAAC,MAAM,EAAE;AACtB,gBAAA,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,MAAM,EAAE;AACtC,oBAAA,IAAI,KAAK,CAAC,IAAI,EAAE;AACf,wBAAA,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;oBACrB;gBACD;YACD;QACD;AACD,IAAA,CAAC;AAED,IAAA,IAAI,SAAS,CAAC,IAAI,EAAE;AACnB,QAAA,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC;IACzB;IAEA,IAAI,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE;QAC1C,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;IAC9C;AAEA,IAAA,OAAO,OAAO;AACf;AAEA,MAAM,qBAAqB,GAAG,CAAC,SAAoB,EAAE,MAAc,KAAwB;AAC1F,IAAA,MAAM,UAAU,GAAG,iBAAiB,CAAC,SAAS,CAAC;IAC/C,MAAM,UAAU,GAAuB,EAAE;AAEzC,IAAA,KAAK,MAAM,UAAU,IAAI,UAAU,EAAE;AACpC,QAAA,MAAMA,WAAS,GAAGC,uBAAa,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC;QAC9E,IAAID,WAAS,EAAE;YACd,UAAU,CAAC,IAAI,CAAC;gBACf,EAAE,EAAE,UAAU,CAAC,EAAE;gBACjB,UAAU,EAAE,UAAU,CAAC,MAAM;AAC7B,gBAAA,QAAQ,EAAEA,WAAS,CAAC,EAAE,CAAC,MAAM;AAC7B,gBAAA,SAAS,EAAEA,WAAS,CAAC,EAAE,CAAC,OAAO;gBAC/B,UAAU;AACV,aAAA,CAAC;QACH;IACD;AAEA,IAAA,OAAO,UAAU;AAClB;AAEA,MAAM,cAAc,GAAG,CAAC,SAAoB,KAAe;AAC1D,IAAA,OAAO,eAAe,CAAC,SAAS,CAAC;AAClC;AAEA,MAAM,kBAAkB,GAAG,CAAC,SAAoB,KAAY;IAC3D,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;AAC/C;;;;;;;;"}

package/cjs/lib/domain/field-entry.d.ts

@@ -0,0 +1,16 @@
+import type { FieldEntry } from '../types.ts';
+/**
+ * Get the target field name that a field maps to.
+ * Returns undefined if the field is removed, otherwise returns the mapped name or original name.
+ */
+declare const getFieldMapsTo: (entry: FieldEntry, fieldName: string) => string | undefined;
+/**
+ * Get the removal note for a field entry, if any.
+ * Only RemoveField entries can have notes.
+ */
+declare const getFieldNote: (entry: FieldEntry) => string | undefined;
+/**
+ * Check if a field entry represents a removal.
+ */
+declare const isFieldRemoved: (entry: FieldEntry) => boolean;
+export { getFieldMapsTo, getFieldNote, isFieldRemoved };

package/cjs/lib/domain/field-entry.js

@@ -0,0 +1,36 @@
+'use strict';
+
+/**
+ * Get the target field name that a field maps to.
+ * Returns undefined if the field is removed, otherwise returns the mapped name or original name.
+ */
+const getFieldMapsTo = (entry, fieldName) => {
+    if (entry.op === 'remove') {
+        return undefined;
+    }
+    if (entry.op === 'keep') {
+        return fieldName;
+    }
+    return entry.to ?? fieldName;
+};
+/**
+ * Get the removal note for a field entry, if any.
+ * Only RemoveField entries can have notes.
+ */
+const getFieldNote = (entry) => {
+    if (entry.op === 'remove') {
+        return entry.note;
+    }
+    return undefined;
+};
+/**
+ * Check if a field entry represents a removal.
+ */
+const isFieldRemoved = (entry) => {
+    return entry.op === 'remove';
+};
+
+exports.getFieldMapsTo = getFieldMapsTo;
+exports.getFieldNote = getFieldNote;
+exports.isFieldRemoved = isFieldRemoved;
+//# sourceMappingURL=field-entry.js.map

package/cjs/lib/domain/field-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-entry.js","sources":["../../../src/lib/domain/field-entry.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA;;;AAGG;AACH,MAAM,cAAc,GAAG,CAAC,KAAiB,EAAE,SAAiB,KAAwB;AACnF,IAAA,IAAI,KAAK,CAAC,EAAE,KAAK,QAAQ,EAAE;AAC1B,QAAA,OAAO,SAAS;IACjB;AACA,IAAA,IAAI,KAAK,CAAC,EAAE,KAAK,MAAM,EAAE;AACxB,QAAA,OAAO,SAAS;IACjB;AACA,IAAA,OAAO,KAAK,CAAC,EAAE,IAAI,SAAS;AAC7B;AAEA;;;AAGG;AACH,MAAM,YAAY,GAAG,CAAC,KAAiB,KAAwB;AAC9D,IAAA,IAAI,KAAK,CAAC,EAAE,KAAK,QAAQ,EAAE;QAC1B,OAAO,KAAK,CAAC,IAAI;IAClB;AACA,IAAA,OAAO,SAAS;AACjB;AAEA;;AAEG;AACH,MAAM,cAAc,GAAG,CAAC,KAAiB,KAAa;AACrD,IAAA,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ;AAC7B;;;;;;"}

package/cjs/lib/domain/field-mapping.d.ts

@@ -0,0 +1,32 @@
+import type { FieldMappings, FlatFieldEntry, ReportMessage } from '../types.ts';
+/**
+ * Flattens nested field mappings into a flat array with full paths.
+ * Recursively processes nested fields and items.
+ *
+ * @param mappings - The field mappings to flatten
+ * @param prefix - Current path prefix for nested fields
+ * @returns Array of flattened field entries with full paths
+ */
+declare const flattenFieldMappings: (mappings: FieldMappings, prefix?: string) => FlatFieldEntry[];
+/**
+ * Builds output field mappings from flattened entries.
+ * Creates a lookup map and set of known fields.
+ *
+ * @param outputs - The output field mappings
+ * @returns Object containing fieldMappings lookup and knownFields set
+ */
+declare const buildOutputMappings: (outputs: FieldMappings) => {
+    fieldMappings: Record<string, string | undefined>;
+    knownFields: Set<string>;
+};
+/**
+ * Applies field mappings to a source object, returning a new transformed object.
+ * Does not mutate the source. Logs removed/renamed fields as messages.
+ *
+ * @param source - The source object to transform
+ * @param mappings - The field mappings to apply
+ * @param messages - Array to collect report messages
+ * @returns A new object with the mappings applied
+ */
+declare const applyFieldMappings: (source: Record<string, unknown>, mappings: FieldMappings, messages: ReportMessage[]) => Record<string, unknown>;
+export { applyFieldMappings, buildOutputMappings, flattenFieldMappings };

package/cjs/lib/domain/field-mapping.js

@@ -0,0 +1,104 @@
+'use strict';
+
+var fieldEntry = require('./field-entry.js');
+
+/**
+ * Flattens nested field mappings into a flat array with full paths.
+ * Recursively processes nested fields and items.
+ *
+ * @param mappings - The field mappings to flatten
+ * @param prefix - Current path prefix for nested fields
+ * @returns Array of flattened field entries with full paths
+ */
+const flattenFieldMappings = (mappings, prefix = '') => {
+    const entries = [];
+    for (const [field, entry] of Object.entries(mappings)) {
+        const fullField = prefix ? `${prefix}.${field}` : field;
+        const localMapsTo = fieldEntry.getFieldMapsTo(entry, field);
+        const fullMapsTo = localMapsTo === undefined
+            ? undefined
+            : prefix
+                ? `${prefix}.${localMapsTo}`
+                : localMapsTo;
+        entries.push({
+            field: fullField,
+            mapsTo: fullMapsTo,
+            note: fieldEntry.getFieldNote(entry),
+        });
+        if (entry.op !== 'remove') {
+            const childPrefix = fullMapsTo ?? fullField;
+            if (entry.fields) {
+                entries.push(...flattenFieldMappings(entry.fields, childPrefix));
+            }
+            if (entry.items) {
+                entries.push(...flattenFieldMappings(entry.items, childPrefix));
+            }
+        }
+    }
+    return entries;
+};
+/**
+ * Builds output field mappings from flattened entries.
+ * Creates a lookup map and set of known fields.
+ *
+ * @param outputs - The output field mappings
+ * @returns Object containing fieldMappings lookup and knownFields set
+ */
+const buildOutputMappings = (outputs) => {
+    const flat = flattenFieldMappings(outputs);
+    const fieldMappings = {};
+    const knownFields = new Set();
+    for (const entry of flat) {
+        knownFields.add(entry.field);
+        fieldMappings[entry.field] = entry.mapsTo;
+    }
+    return { fieldMappings, knownFields };
+};
+/**
+ * Applies field mappings to a source object, returning a new transformed object.
+ * Does not mutate the source. Logs removed/renamed fields as messages.
+ *
+ * @param source - The source object to transform
+ * @param mappings - The field mappings to apply
+ * @param messages - Array to collect report messages
+ * @returns A new object with the mappings applied
+ */
+const applyFieldMappings = (source, mappings, messages) => {
+    const result = {};
+    for (const [key, value] of Object.entries(source)) {
+        const entry = mappings[key];
+        if (!entry) {
+            result[key] = value;
+            continue;
+        }
+        const mapsTo = fieldEntry.getFieldMapsTo(entry, key);
+        if (mapsTo === undefined) {
+            messages.push({
+                type: 'warning',
+                category: 'input',
+                field: key,
+                message: `Input field '${key}' was removed`,
+                note: fieldEntry.getFieldNote(entry),
+                certain: true,
+            });
+            continue;
+        }
+        result[mapsTo] = value;
+        if (mapsTo !== key) {
+            messages.push({
+                type: 'info',
+                category: 'input',
+                field: key,
+                message: `Input field '${key}' renamed to '${mapsTo}'`,
+                certain: true,
+                autoFixed: true,
+            });
+        }
+    }
+    return result;
+};
+
+exports.applyFieldMappings = applyFieldMappings;
+exports.buildOutputMappings = buildOutputMappings;
+exports.flattenFieldMappings = flattenFieldMappings;
+//# sourceMappingURL=field-mapping.js.map

package/cjs/lib/domain/field-mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-mapping.js","sources":["../../../src/lib/domain/field-mapping.ts"],"sourcesContent":[null],"names":["getFieldMapsTo","getFieldNote"],"mappings":"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"}

package/cjs/lib/domain/migration.d.ts

@@ -0,0 +1,12 @@
+import type { Bundle, MigrationConfigV1 } from '../types.ts';
+/**
+ * Pure function to find a migration config for a module.
+ * Matches by module type and version.
+ *
+ * @param config - The bundle containing all migration configurations
+ * @param moduleType - The module type to find (e.g., "google-sheets:addRow")
+ * @param moduleVersion - The version number to match
+ * @returns The matching migration config, or undefined if not found
+ */
+declare const findMigration: (config: Bundle, moduleType: string, moduleVersion: number) => MigrationConfigV1 | undefined;
+export { findMigration };

package/cjs/lib/domain/migration.js

@@ -0,0 +1,19 @@
+'use strict';
+
+/**
+ * Pure function to find a migration config for a module.
+ * Matches by module type and version.
+ *
+ * @param config - The bundle containing all migration configurations
+ * @param moduleType - The module type to find (e.g., "google-sheets:addRow")
+ * @param moduleVersion - The version number to match
+ * @returns The matching migration config, or undefined if not found
+ */
+const findMigration = (config, moduleType, moduleVersion) => {
+    return config.migrations.find((migration) => {
+        return migration.from.module === moduleType && migration.from.version === moduleVersion;
+    });
+};
+
+exports.findMigration = findMigration;
+//# sourceMappingURL=migration.js.map

package/cjs/lib/domain/migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.js","sources":["../../../src/lib/domain/migration.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA;;;;;;;;AAQG;AACH,MAAM,aAAa,GAAG,CACrB,MAAc,EACd,UAAkB,EAClB,aAAqB,KACa;IAClC,OAAO,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,KAAI;AAC3C,QAAA,OAAO,SAAS,CAAC,IAAI,CAAC,MAAM,KAAK,UAAU,IAAI,SAAS,CAAC,IAAI,CAAC,OAAO,KAAK,aAAa;AACxF,IAAA,CAAC,CAAC;AACH;;;;"}

package/cjs/lib/errors/migration-error.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Error codes for migration operations.
+ */
+declare const MigrationErrorCode: {
+    /** Blueprint validation failed */
+    readonly INVALID_BLUEPRINT: "INVALID_BLUEPRINT";
+    /** Bundle/migration config validation failed */
+    readonly INVALID_BUNDLE: "INVALID_BUNDLE";
+    /** Migration execution failed for a specific module */
+    readonly MIGRATION_FAILED: "MIGRATION_FAILED";
+    /** Field mapping operation failed */
+    readonly FIELD_MAPPING_FAILED: "FIELD_MAPPING_FAILED";
+};
+type MigrationErrorCode = (typeof MigrationErrorCode)[keyof typeof MigrationErrorCode];
+/**
+ * Custom error class for migration operations.
+ * Provides structured error information including error code,
+ * optional module ID, and field context.
+ */
+declare class MigrationError extends Error {
+    /** Error code categorizing the type of failure */
+    readonly code: MigrationErrorCode;
+    /** Module ID where the error occurred, if applicable */
+    readonly moduleId?: number;
+    /** Field name where the error occurred, if applicable */
+    readonly field?: string;
+    constructor(code: MigrationErrorCode, message: string, options?: {
+        moduleId?: number;
+        field?: string;
+        cause?: unknown;
+    });
+    /**
+     * Creates a formatted string representation of the error.
+     */
+    toString(): string;
+}
+export { MigrationError, MigrationErrorCode };

package/cjs/lib/errors/migration-error.js

@@ -0,0 +1,53 @@
+'use strict';
+
+/**
+ * Error codes for migration operations.
+ */
+const MigrationErrorCode = {
+    /** Blueprint validation failed */
+    INVALID_BLUEPRINT: 'INVALID_BLUEPRINT',
+    /** Bundle/migration config validation failed */
+    INVALID_BUNDLE: 'INVALID_BUNDLE',
+    /** Migration execution failed for a specific module */
+    MIGRATION_FAILED: 'MIGRATION_FAILED'};
+/**
+ * Custom error class for migration operations.
+ * Provides structured error information including error code,
+ * optional module ID, and field context.
+ */
+class MigrationError extends Error {
+    /** Error code categorizing the type of failure */
+    code;
+    /** Module ID where the error occurred, if applicable */
+    moduleId;
+    /** Field name where the error occurred, if applicable */
+    field;
+    constructor(code, message, options) {
+        super(message, { cause: options?.cause });
+        this.name = 'MigrationError';
+        this.code = code;
+        if (options?.moduleId !== undefined) {
+            this.moduleId = options.moduleId;
+        }
+        if (options?.field !== undefined) {
+            this.field = options.field;
+        }
+    }
+    /**
+     * Creates a formatted string representation of the error.
+     */
+    toString() {
+        const parts = [`MigrationError [${this.code}]: ${this.message}`];
+        if (this.moduleId !== undefined) {
+            parts.push(`  Module ID: ${this.moduleId}`);
+        }
+        if (this.field !== undefined) {
+            parts.push(`  Field: ${this.field}`);
+        }
+        return parts.join('\n');
+    }
+}
+
+exports.MigrationError = MigrationError;
+exports.MigrationErrorCode = MigrationErrorCode;
+//# sourceMappingURL=migration-error.js.map

package/cjs/lib/errors/migration-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-error.js","sources":["../../../src/lib/errors/migration-error.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;AAEG;AACH,MAAM,kBAAkB,GAAG;;AAE1B,IAAA,iBAAiB,EAAE,mBAAmB;;AAEtC,IAAA,cAAc,EAAE,gBAAgB;;AAEhC,IAAA,gBAAgB,EAAE;AAOnB;;;;AAIG;AACH,MAAM,cAAe,SAAQ,KAAK,CAAA;;AAExB,IAAA,IAAI;;AAEJ,IAAA,QAAQ;;AAER,IAAA,KAAK;AAEd,IAAA,WAAA,CACC,IAAwB,EACxB,OAAe,EACf,OAIC,EAAA;QAED,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AACzC,QAAA,IAAI,CAAC,IAAI,GAAG,gBAAgB;AAC5B,QAAA,IAAI,CAAC,IAAI,GAAG,IAAI;AAChB,QAAA,IAAI,OAAO,EAAE,QAAQ,KAAK,SAAS,EAAE;AACpC,YAAA,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ;QACjC;AACA,QAAA,IAAI,OAAO,EAAE,KAAK,KAAK,SAAS,EAAE;AACjC,YAAA,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK;QAC3B;IACD;AAEA;;AAEG;IACM,QAAQ,GAAA;AAChB,QAAA,MAAM,KAAK,GAAG,CAAC,CAAA,gBAAA,EAAmB,IAAI,CAAC,IAAI,CAAA,GAAA,EAAM,IAAI,CAAC,OAAO,CAAA,CAAE,CAAC;AAChE,QAAA,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE;YAChC,KAAK,CAAC,IAAI,CAAC,CAAA,aAAA,EAAgB,IAAI,CAAC,QAAQ,CAAA,CAAE,CAAC;QAC5C;AACA,QAAA,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE;YAC7B,KAAK,CAAC,IAAI,CAAC,CAAA,SAAA,EAAY,IAAI,CAAC,KAAK,CAAA,CAAE,CAAC;QACrC;AACA,QAAA,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;IACxB;AACA;;;;;"}

package/cjs/lib/expression-parser.d.ts

@@ -0,0 +1,26 @@
+type FieldReference = {
+    moduleId: number;
+    fieldPath: string;
+    fullMatch: string;
+    startIndex: number;
+    endIndex: number;
+};
+type FieldChange = {
+    from: string;
+    to: string | undefined;
+};
+declare const parseExpressions: (value: string) => FieldReference[];
+declare const rewriteReferences: (value: string, moduleId: number, fieldMappings: Record<string, string | undefined>) => {
+    newValue: string;
+    changes: FieldChange[];
+};
+declare const findAllReferences: (modules: {
+    id: number;
+    mapper?: Record<string, unknown> | undefined;
+}[], targetModuleId: number) => {
+    moduleId: number;
+    field: string;
+    referencedField: string;
+}[];
+export { findAllReferences, parseExpressions, rewriteReferences };
+export type { FieldReference };

package/cjs/lib/expression-parser.js

@@ -0,0 +1,155 @@
+'use strict';
+
+const extractReferencesFromExpression = (content, baseOffset) => {
+    const references = [];
+    const refPattern = /(\d+)\.([a-zA-Z_][a-zA-Z0-9_]*(?:\[[^\]]*\])?(?:\.[a-zA-Z_][a-zA-Z0-9_]*(?:\[[^\]]*\])?)*)/g;
+    let refMatch = refPattern.exec(content);
+    while (refMatch !== null) {
+        const moduleIdStr = refMatch[1];
+        const fieldPath = refMatch[2];
+        if (moduleIdStr && fieldPath) {
+            const moduleId = Number.parseInt(moduleIdStr, 10);
+            references.push({
+                moduleId,
+                fieldPath,
+                fullMatch: refMatch[0],
+                startIndex: baseOffset + refMatch.index + 2,
+                endIndex: baseOffset + refMatch.index + 2 + refMatch[0].length,
+            });
+        }
+        refMatch = refPattern.exec(content);
+    }
+    return references;
+};
+const parseExpressions = (value) => {
+    const references = [];
+    const expressionPattern = /\{\{([^}]+)\}\}/g;
+    let match = expressionPattern.exec(value);
+    while (match !== null) {
+        const expressionContent = match[1];
+        if (expressionContent) {
+            const innerRefs = extractReferencesFromExpression(expressionContent, match.index);
+            references.push(...innerRefs);
+        }
+        match = expressionPattern.exec(value);
+    }
+    return references;
+};
+const reconstructWithIndices = (original, deindexed, mapped) => {
+    const originalParts = original.split('.');
+    const deindexedParts = deindexed.split('.');
+    const mappedParts = mapped.split('.');
+    if (deindexedParts.length !== mappedParts.length) {
+        return mapped;
+    }
+    return originalParts
+        .map((part, index) => {
+        const mappedPart = mappedParts[index];
+        if (index >= mappedParts.length || mappedPart === undefined) {
+            return part;
+        }
+        const base = part.split('[')[0] ?? '';
+        const indices = part.slice(base.length);
+        const deindexedPart = deindexedParts[index];
+        if (index < deindexedParts.length && deindexedPart === base) {
+            return mappedPart + indices;
+        }
+        return part;
+    })
+        .join('.');
+};
+const findMapping = (fieldPath, fieldMappings) => {
+    // 1. Exact match
+    if (fieldPath in fieldMappings) {
+        const mapped = fieldMappings[fieldPath];
+        return { mappedPath: mapped, matched: true, isRemoved: mapped === undefined };
+    }
+    // 2. De-indexed match: participants[0].primary_flag → participants.primary_flag
+    const deindexed = fieldPath.replaceAll(/\[\d+\]/g, '');
+    if (deindexed !== fieldPath && deindexed in fieldMappings) {
+        const mapped = fieldMappings[deindexed];
+        if (mapped === undefined) {
+            return { mappedPath: undefined, matched: true, isRemoved: true };
+        }
+        return {
+            mappedPath: reconstructWithIndices(fieldPath, deindexed, mapped),
+            matched: true,
+            isRemoved: false,
+        };
+    }
+    // 3. Root field match
+    const rootField = fieldPath.split('.')[0]?.split('[')[0];
+    if (rootField && rootField in fieldMappings) {
+        const mapped = fieldMappings[rootField];
+        if (mapped === undefined) {
+            return { mappedPath: undefined, matched: true, isRemoved: true };
+        }
+        const suffix = fieldPath.slice(rootField.length);
+        return { mappedPath: mapped + suffix, matched: true, isRemoved: false };
+    }
+    return { mappedPath: fieldPath, matched: false, isRemoved: false };
+};
+const rewriteReferences = (value, moduleId, fieldMappings) => {
+    const changes = [];
+    let newValue = value;
+    const refs = parseExpressions(value);
+    const moduleRefs = refs.filter((ref) => {
+        return ref.moduleId === moduleId;
+    });
+    const sortedRefs = [...moduleRefs].sort((a, b) => {
+        return b.startIndex - a.startIndex;
+    });
+    for (const ref of sortedRefs) {
+        const { mappedPath, matched, isRemoved } = findMapping(ref.fieldPath, fieldMappings);
+        if (matched) {
+            if (isRemoved) {
+                changes.push({ from: ref.fieldPath, to: undefined });
+            }
+            else if (mappedPath !== ref.fieldPath) {
+                const newRef = `${moduleId}.${mappedPath}`;
+                newValue =
+                    newValue.slice(0, ref.startIndex) + newRef + newValue.slice(ref.endIndex);
+                changes.push({ from: ref.fieldPath, to: mappedPath });
+            }
+        }
+    }
+    return { newValue, changes };
+};
+const scanMapperForReferences = (obj, sourceModuleId, targetModuleId, path, refs) => {
+    if (typeof obj === 'string') {
+        const parsed = parseExpressions(obj);
+        for (const ref of parsed) {
+            if (ref.moduleId === targetModuleId) {
+                refs.push({
+                    moduleId: sourceModuleId,
+                    field: path,
+                    referencedField: ref.fieldPath,
+                });
+            }
+        }
+    }
+    else if (Array.isArray(obj)) {
+        for (const [index, item] of obj.entries()) {
+            scanMapperForReferences(item, sourceModuleId, targetModuleId, `${path}[${index + 1}]`, refs);
+        }
+    }
+    else if (obj && typeof obj === 'object') {
+        for (const [key, val] of Object.entries(obj)) {
+            scanMapperForReferences(val, sourceModuleId, targetModuleId, path ? `${path}.${key}` : key, refs);
+        }
+    }
+};
+const findAllReferences = (modules, targetModuleId) => {
+    const allRefs = [];
+    for (const flowModule of modules) {
+        if (flowModule.mapper) {
+            scanMapperForReferences(flowModule.mapper, flowModule.id, targetModuleId, '', allRefs);
+        }
+    }
+    return allRefs;
+};
+
+exports.findAllReferences = findAllReferences;
+exports.parseExpressions = parseExpressions;
+exports.rewriteReferences = rewriteReferences;
+//# sourceMappingURL=expression-parser.js.map

package/cjs/lib/expression-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression-parser.js","sources":["../../src/lib/expression-parser.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/cjs/lib/migrator.d.ts

@@ -0,0 +1,16 @@
+import type { Blueprint, Bundle, MigrationReport } from './types.ts';
+/**
+ * Migrates a blueprint by applying module migrations.
+ * Validates inputs, applies field mappings, and generates a migration report.
+ *
+ * @param blueprint - The blueprint to migrate
+ * @param selectedModuleIds - IDs of modules to migrate
+ * @param config - Bundle containing migration configurations
+ * @returns Object containing migrated blueprint and migration report
+ * @throws MigrationError if validation fails or migration encounters an error
+ */
+declare const migrateBlueprint: (blueprint: Blueprint, selectedModuleIds: number[], config: Bundle) => {
+    migratedBlueprint: Blueprint;
+    report: MigrationReport;
+};
+export { migrateBlueprint };