@integromat/module-migrator-core 0.0.1

package/cjs/lib/migrator.js

@@ -0,0 +1,264 @@
+'use strict';
+
+var blueprintParser = require('./blueprint-parser.js');
+var fieldMapping = require('./domain/field-mapping.js');
+var migration = require('./domain/migration.js');
+var migrationError = require('./errors/migration-error.js');
+var expressionParser = require('./expression-parser.js');
+var path = require('./utils/path.js');
+var typeGuards = require('./utils/type-guards.js');
+var validation = require('./validation.js');
+
+/**
+ * Migrates mapper fields using field mappings.
+ * Returns the migrated mapper (does not mutate the original).
+ */
+const migrateMapper = (flowModule, mapperMappings, messages) => {
+    if (!flowModule.mapper) {
+        return undefined;
+    }
+    return fieldMapping.applyFieldMappings(flowModule.mapper, mapperMappings, messages);
+};
+/**
+ * Migrates parameters using field mappings.
+ * Returns the migrated parameters (does not mutate the original).
+ */
+const migrateParameters = (flowModule, paramMappings, messages) => {
+    if (!flowModule.parameters) {
+        return undefined;
+    }
+    return fieldMapping.applyFieldMappings(flowModule.parameters, paramMappings, messages);
+};
+/**
+ * Pre-builds a map from field names to referencing module IDs.
+ * Optimizes lookup from O(n) per field to O(1).
+ */
+const buildFieldToModulesMap = (refs) => {
+    const fieldToModules = new Map();
+    for (const ref of refs) {
+        const field = ref.referencedField;
+        const rootField = path.getRootField(field);
+        // Add exact field reference
+        if (!fieldToModules.has(field)) {
+            fieldToModules.set(field, new Set());
+        }
+        fieldToModules.get(field).add(ref.moduleId);
+        // Add root field reference
+        if (rootField && rootField !== field) {
+            if (!fieldToModules.has(rootField)) {
+                fieldToModules.set(rootField, new Set());
+            }
+            fieldToModules.get(rootField).add(ref.moduleId);
+        }
+    }
+    return fieldToModules;
+};
+/**
+ * Gets all module IDs that reference a field or its descendants.
+ */
+const getReferencingModules = (field, fieldToModules) => {
+    const moduleIds = new Set();
+    const rootField = path.getRootField(field);
+    // Exact match
+    const exactModules = fieldToModules.get(field);
+    if (exactModules) {
+        for (const id of exactModules) {
+            moduleIds.add(id);
+        }
+    }
+    // Root field match
+    if (rootField && rootField !== field) {
+        const rootModules = fieldToModules.get(rootField);
+        if (rootModules) {
+            for (const id of rootModules) {
+                moduleIds.add(id);
+            }
+        }
+    }
+    // Check for descendant references (field.* or field[*)
+    for (const [refField, modules] of fieldToModules) {
+        if (refField.startsWith(rootField + '.') || refField.startsWith(rootField + '[')) {
+            for (const id of modules) {
+                moduleIds.add(id);
+            }
+        }
+    }
+    return [...moduleIds];
+};
+/**
+ * Generates output messages for fields that were removed or renamed.
+ * Uses pre-built map for O(1) lookups instead of O(n) filtering per field.
+ */
+const generateOutputMessages = (flatEntries, moduleId, messages, allModules, knownFields) => {
+    const refs = expressionParser.findAllReferences(allModules, moduleId);
+    const fieldToModules = buildFieldToModulesMap(refs);
+    const referencedFields = new Set(fieldToModules.keys());
+    for (const { field, mapsTo, note } of flatEntries) {
+        const rootField = path.getRootField(field);
+        const isReferenced = referencedFields.has(field) || referencedFields.has(rootField);
+        if (!isReferenced) {
+            continue;
+        }
+        const uniqueReferencingModules = getReferencingModules(field, fieldToModules);
+        if (mapsTo === undefined) {
+            messages.push({
+                type: 'warning',
+                category: 'output',
+                field,
+                message: `Output field '${field}' was removed and is referenced by other modules`,
+                note,
+                certain: true,
+                referencedBy: uniqueReferencingModules,
+            });
+        }
+        else if (mapsTo !== field) {
+            messages.push({
+                type: 'info',
+                category: 'output',
+                field,
+                message: `Output field '${field}' renamed to '${mapsTo}'`,
+                certain: true,
+                autoFixed: true,
+                referencedBy: uniqueReferencingModules,
+            });
+        }
+    }
+    for (const ref of refs) {
+        const rootField = path.getRootField(ref.referencedField);
+        if (rootField && !knownFields.has(rootField) && !knownFields.has(ref.referencedField)) {
+            messages.push({
+                type: 'warning',
+                category: 'output',
+                field: ref.referencedField,
+                message: `Output field '${ref.referencedField}' may no longer exist, please verify`,
+                certain: false,
+                referencedBy: [ref.moduleId],
+            });
+        }
+    }
+};
+/**
+ * Recursively rewrites field references in a mapper object.
+ * Mutates the object in place (called on already-cloned data).
+ */
+const rewriteMapperReferences = (obj, targetModuleId, fieldMappings) => {
+    for (const key of Object.keys(obj)) {
+        const value = obj[key];
+        if (typeof value === 'string') {
+            const { newValue } = expressionParser.rewriteReferences(value, targetModuleId, fieldMappings);
+            if (newValue !== value) {
+                obj[key] = newValue;
+            }
+        }
+        else if (Array.isArray(value)) {
+            for (let i = 0; i < value.length; i += 1) {
+                const element = value[i];
+                if (typeGuards.isPlainObject(element)) {
+                    rewriteMapperReferences(element, targetModuleId, fieldMappings);
+                }
+                else if (typeof element === 'string') {
+                    const { newValue } = expressionParser.rewriteReferences(element, targetModuleId, fieldMappings);
+                    if (newValue !== element) {
+                        value[i] = newValue;
+                    }
+                }
+            }
+        }
+        else if (typeGuards.isPlainObject(value)) {
+            rewriteMapperReferences(value, targetModuleId, fieldMappings);
+        }
+    }
+};
+const rewriteDownstreamReferences = (allModules, migratedModuleId, fieldMappings) => {
+    for (const flowModule of allModules) {
+        if (flowModule.id === migratedModuleId) {
+            continue;
+        }
+        if (!flowModule.mapper) {
+            continue;
+        }
+        rewriteMapperReferences(flowModule.mapper, migratedModuleId, fieldMappings);
+    }
+};
+/**
+ * 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
+ */
+const migrateBlueprint = (blueprint, selectedModuleIds, config) => {
+    // Validate inputs
+    validation.validateBlueprint(blueprint);
+    validation.validateBundle(config);
+    validation.validateModuleIds(selectedModuleIds);
+    const migrated = blueprintParser.cloneBlueprint(blueprint);
+    const allModules = blueprintParser.collectAllModules(migrated);
+    const report = {
+        summary: {
+            totalModules: allModules.length,
+            deprecatedFound: 0,
+            migrated: 0,
+            warnings: 0,
+            infos: 0,
+        },
+        modules: [],
+    };
+    const modulesToMigrate = allModules.filter((flowModule) => {
+        return selectedModuleIds.includes(flowModule.id);
+    });
+    for (const flowModule of modulesToMigrate) {
+        const migration$1 = migration.findMigration(config, flowModule.module, flowModule.version);
+        if (!migration$1) {
+            continue;
+        }
+        report.summary.deprecatedFound += 1;
+        const moduleReport = {
+            moduleId: flowModule.id,
+            fromModule: flowModule.module,
+            toModule: migration$1.to.module,
+            messages: [],
+        };
+        try {
+            flowModule.module = migration$1.to.module;
+            flowModule.version = migration$1.to.version;
+            if (flowModule.mapper && migration$1.mapper) {
+                flowModule.mapper = migrateMapper(flowModule, migration$1.mapper, moduleReport.messages);
+            }
+            if (flowModule.parameters && migration$1.parameters) {
+                flowModule.parameters = migrateParameters(flowModule, migration$1.parameters, moduleReport.messages);
+            }
+            // Create new metadata object with only designer preserved (immutable pattern)
+            if (flowModule.metadata) {
+                flowModule.metadata = { designer: flowModule.metadata.designer };
+            }
+            const outputs = migration$1.outputs ?? {};
+            const flatEntries = fieldMapping.flattenFieldMappings(outputs);
+            const { fieldMappings, knownFields } = fieldMapping.buildOutputMappings(outputs);
+            generateOutputMessages(flatEntries, flowModule.id, moduleReport.messages, allModules, knownFields);
+            rewriteDownstreamReferences(allModules, flowModule.id, fieldMappings);
+            report.modules.push(moduleReport);
+            report.summary.migrated += 1;
+        }
+        catch (error) {
+            throw new migrationError.MigrationError(migrationError.MigrationErrorCode.MIGRATION_FAILED, `Failed to migrate module ${flowModule.module}`, { moduleId: flowModule.id, cause: error });
+        }
+    }
+    for (const moduleReport of report.modules) {
+        for (const msg of moduleReport.messages) {
+            if (msg.type === 'warning') {
+                report.summary.warnings += 1;
+            }
+            else {
+                report.summary.infos += 1;
+            }
+        }
+    }
+    return { migratedBlueprint: migrated, report };
+};
+
+exports.migrateBlueprint = migrateBlueprint;
+//# sourceMappingURL=migrator.js.map

package/cjs/lib/migrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrator.js","sources":["../../src/lib/migrator.ts"],"sourcesContent":[null],"names":["applyFieldMappings","getRootField","findAllReferences","rewriteReferences","isPlainObject","validateBlueprint","validateBundle","validateModuleIds","cloneBlueprint","collectAllModules","migration","findMigration","flattenFieldMappings","buildOutputMappings","MigrationError","MigrationErrorCode"],"mappings":"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"}

package/cjs/lib/ports/config-repository.d.ts

@@ -0,0 +1,19 @@
+import type { Bundle } from '../types.ts';
+/**
+ * Port type for loading migration configuration.
+ * Adapters implement this to provide config from different sources
+ * (HTTP fetch, filesystem, in-memory, etc.)
+ */
+type ConfigRepository = {
+    /**
+     * Load the migration configuration bundle.
+     * Implementations may cache internally.
+     */
+    load: () => Promise<Bundle>;
+    /**
+     * Get cached config if available, null otherwise.
+     * Does not trigger loading.
+     */
+    getCached: () => Bundle | null;
+};
+export type { ConfigRepository };

package/cjs/lib/ports/migration-service.d.ts

@@ -0,0 +1,28 @@
+import type { Blueprint, Bundle, DeprecatedModule, MigrationReport } from '../types.ts';
+/**
+ * Port type for the migration use cases.
+ * This is the primary driving port - what consumers call.
+ */
+type MigrationService = {
+    /**
+     * Parse a blueprint JSON string into a Blueprint object.
+     */
+    parseBlueprint: (json: string) => Blueprint;
+    /**
+     * Find all modules in a blueprint that have available migrations.
+     */
+    findDeprecatedModules: (blueprint: Blueprint, config: Bundle) => DeprecatedModule[];
+    /**
+     * Migrate selected modules in a blueprint to newer versions.
+     * Returns the migrated blueprint and a report of changes.
+     */
+    migrateBlueprint: (blueprint: Blueprint, selectedModuleIds: number[], config: Bundle) => {
+        migratedBlueprint: Blueprint;
+        report: MigrationReport;
+    };
+    /**
+     * Serialize a blueprint back to JSON string.
+     */
+    serializeBlueprint: (blueprint: Blueprint) => string;
+};
+export type { MigrationService };

package/cjs/lib/schemas.d.ts

@@ -0,0 +1,246 @@
+import type { Static } from '@sinclair/typebox';
+/**
+ * Schema for FieldEntry - union of keep, map, or remove.
+ */
+declare const FieldEntrySchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+    op: import("@sinclair/typebox").TLiteral<"keep">;
+    fields: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRef<import("@sinclair/typebox").TSchema>>;
+    items: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRef<import("@sinclair/typebox").TSchema>>;
+}>, import("@sinclair/typebox").TObject<{
+    op: import("@sinclair/typebox").TLiteral<"map">;
+    to: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    toSection: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"parameters">, import("@sinclair/typebox").TLiteral<"mapper">]>>;
+    fields: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRef<import("@sinclair/typebox").TSchema>>;
+    items: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRef<import("@sinclair/typebox").TSchema>>;
+}>, import("@sinclair/typebox").TObject<{
+    op: import("@sinclair/typebox").TLiteral<"remove">;
+    note: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>]>;
+/**
+ * Schema for FieldMappings - record of field name to entry.
+ */
+declare const FieldMappingsSchema: import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+    op: import("@sinclair/typebox").TLiteral<"keep">;
+    fields: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRef<import("@sinclair/typebox").TSchema>>;
+    items: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRef<import("@sinclair/typebox").TSchema>>;
+}>, import("@sinclair/typebox").TObject<{
+    op: import("@sinclair/typebox").TLiteral<"map">;
+    to: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    toSection: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"parameters">, import("@sinclair/typebox").TLiteral<"mapper">]>>;
+    fields: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRef<import("@sinclair/typebox").TSchema>>;
+    items: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRef<import("@sinclair/typebox").TSchema>>;
+}>, import("@sinclair/typebox").TObject<{
+    op: import("@sinclair/typebox").TLiteral<"remove">;
+    note: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>]>>;
+/**
+ * Schema for MigrationConfigV1.
+ */
+declare const MigrationConfigV1Schema: import("@sinclair/typebox").TObject<{
+    configVersion: import("@sinclair/typebox").TLiteral<"1.0">;
+    from: import("@sinclair/typebox").TObject<{
+        module: import("@sinclair/typebox").TString;
+        version: import("@sinclair/typebox").TNumber;
+    }>;
+    to: import("@sinclair/typebox").TObject<{
+        module: import("@sinclair/typebox").TString;
+        version: import("@sinclair/typebox").TNumber;
+    }>;
+    parameters: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+        op: import("@sinclair/typebox").TLiteral<"keep">;
+        fields: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRef<import("@sinclair/typebox").TSchema>>;
+        items: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRef<import("@sinclair/typebox").TSchema>>;
+    }>, import("@sinclair/typebox").TObject<{
+        op: import("@sinclair/typebox").TLiteral<"map">;
+        to: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        toSection: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"parameters">, import("@sinclair/typebox").TLiteral<"mapper">]>>;
+        fields: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRef<import("@sinclair/typebox").TSchema>>;
+        items: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRef<import("@sinclair/typebox").TSchema>>;
+    }>, import("@sinclair/typebox").TObject<{
+        op: import("@sinclair/typebox").TLiteral<"remove">;
+        note: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>]>>>;
+    mapper: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+        op: import("@sinclair/typebox").TLiteral<"keep">;
+        fields: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRef<import("@sinclair/typebox").TSchema>>;
+        items: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRef<import("@sinclair/typebox").TSchema>>;
+    }>, import("@sinclair/typebox").TObject<{
+        op: import("@sinclair/typebox").TLiteral<"map">;
+        to: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        toSection: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"parameters">, import("@sinclair/typebox").TLiteral<"mapper">]>>;
+        fields: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRef<import("@sinclair/typebox").TSchema>>;
+        items: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRef<import("@sinclair/typebox").TSchema>>;
+    }>, import("@sinclair/typebox").TObject<{
+        op: import("@sinclair/typebox").TLiteral<"remove">;
+        note: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>]>>>;
+    outputs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+        op: import("@sinclair/typebox").TLiteral<"keep">;
+        fields: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRef<import("@sinclair/typebox").TSchema>>;
+        items: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRef<import("@sinclair/typebox").TSchema>>;
+    }>, import("@sinclair/typebox").TObject<{
+        op: import("@sinclair/typebox").TLiteral<"map">;
+        to: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        toSection: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"parameters">, import("@sinclair/typebox").TLiteral<"mapper">]>>;
+        fields: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRef<import("@sinclair/typebox").TSchema>>;
+        items: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRef<import("@sinclair/typebox").TSchema>>;
+    }>, import("@sinclair/typebox").TObject<{
+        op: import("@sinclair/typebox").TLiteral<"remove">;
+        note: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>]>>>;
+}>;
+/**
+ * Schema for Bundle containing migration configurations.
+ */
+declare const BundleSchema: import("@sinclair/typebox").TObject<{
+    generatedAt: import("@sinclair/typebox").TString;
+    migrations: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        configVersion: import("@sinclair/typebox").TLiteral<"1.0">;
+        from: import("@sinclair/typebox").TObject<{
+            module: import("@sinclair/typebox").TString;
+            version: import("@sinclair/typebox").TNumber;
+        }>;
+        to: import("@sinclair/typebox").TObject<{
+            module: import("@sinclair/typebox").TString;
+            version: import("@sinclair/typebox").TNumber;
+        }>;
+        parameters: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            op: import("@sinclair/typebox").TLiteral<"keep">;
+            fields: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRef<import("@sinclair/typebox").TSchema>>;
+            items: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRef<import("@sinclair/typebox").TSchema>>;
+        }>, import("@sinclair/typebox").TObject<{
+            op: import("@sinclair/typebox").TLiteral<"map">;
+            to: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            toSection: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"parameters">, import("@sinclair/typebox").TLiteral<"mapper">]>>;
+            fields: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRef<import("@sinclair/typebox").TSchema>>;
+            items: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRef<import("@sinclair/typebox").TSchema>>;
+        }>, import("@sinclair/typebox").TObject<{
+            op: import("@sinclair/typebox").TLiteral<"remove">;
+            note: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        }>]>>>;
+        mapper: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            op: import("@sinclair/typebox").TLiteral<"keep">;
+            fields: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRef<import("@sinclair/typebox").TSchema>>;
+            items: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRef<import("@sinclair/typebox").TSchema>>;
+        }>, import("@sinclair/typebox").TObject<{
+            op: import("@sinclair/typebox").TLiteral<"map">;
+            to: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            toSection: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"parameters">, import("@sinclair/typebox").TLiteral<"mapper">]>>;
+            fields: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRef<import("@sinclair/typebox").TSchema>>;
+            items: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRef<import("@sinclair/typebox").TSchema>>;
+        }>, import("@sinclair/typebox").TObject<{
+            op: import("@sinclair/typebox").TLiteral<"remove">;
+            note: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        }>]>>>;
+        outputs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+            op: import("@sinclair/typebox").TLiteral<"keep">;
+            fields: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRef<import("@sinclair/typebox").TSchema>>;
+            items: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRef<import("@sinclair/typebox").TSchema>>;
+        }>, import("@sinclair/typebox").TObject<{
+            op: import("@sinclair/typebox").TLiteral<"map">;
+            to: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+            toSection: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"parameters">, import("@sinclair/typebox").TLiteral<"mapper">]>>;
+            fields: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRef<import("@sinclair/typebox").TSchema>>;
+            items: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRef<import("@sinclair/typebox").TSchema>>;
+        }>, import("@sinclair/typebox").TObject<{
+            op: import("@sinclair/typebox").TLiteral<"remove">;
+            note: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        }>]>>>;
+    }>>;
+}>;
+/**
+ * Schema for FlowModule (recursive for routes).
+ */
+declare const FlowModuleSchema: import("@sinclair/typebox").TRecursive<import("@sinclair/typebox").TObject<{
+    id: import("@sinclair/typebox").TNumber;
+    module: import("@sinclair/typebox").TString;
+    version: import("@sinclair/typebox").TNumber;
+    parameters: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+    mapper: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+    metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+        designer: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+            x: import("@sinclair/typebox").TNumber;
+            y: import("@sinclair/typebox").TNumber;
+        }>>;
+        expect: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnknown>>;
+        interface: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnknown>>;
+        restore: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+        parameters: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnknown>>;
+    }>>;
+    routes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        flow: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TThis>;
+    }>>>;
+}>>;
+/**
+ * Schema for Blueprint.
+ */
+declare const BlueprintSchema: import("@sinclair/typebox").TObject<{
+    name: import("@sinclair/typebox").TString;
+    flow: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TRecursive<import("@sinclair/typebox").TObject<{
+        id: import("@sinclair/typebox").TNumber;
+        module: import("@sinclair/typebox").TString;
+        version: import("@sinclair/typebox").TNumber;
+        parameters: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+        mapper: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+        metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+            designer: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                x: import("@sinclair/typebox").TNumber;
+                y: import("@sinclair/typebox").TNumber;
+            }>>;
+            expect: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnknown>>;
+            interface: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnknown>>;
+            restore: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+            parameters: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnknown>>;
+        }>>;
+        routes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+            flow: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TThis>;
+        }>>>;
+    }>>>;
+    metadata: import("@sinclair/typebox").TObject<{
+        instant: import("@sinclair/typebox").TBoolean;
+        version: import("@sinclair/typebox").TNumber;
+        scenario: import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>;
+        designer: import("@sinclair/typebox").TObject<{
+            orphans: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TRecursive<import("@sinclair/typebox").TObject<{
+                id: import("@sinclair/typebox").TNumber;
+                module: import("@sinclair/typebox").TString;
+                version: import("@sinclair/typebox").TNumber;
+                parameters: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+                mapper: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+                metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                    designer: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
+                        x: import("@sinclair/typebox").TNumber;
+                        y: import("@sinclair/typebox").TNumber;
+                    }>>;
+                    expect: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnknown>>;
+                    interface: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnknown>>;
+                    restore: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+                    parameters: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnknown>>;
+                }>>;
+                routes: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+                    flow: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TThis>;
+                }>>>;
+            }>>>;
+        }>;
+        zone: import("@sinclair/typebox").TString;
+        notes: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnknown>;
+    }>;
+}>;
+type Blueprint = Static<typeof BlueprintSchema>;
+type Bundle = Static<typeof BundleSchema>;
+/**
+ * Validates a blueprint using TypeBox schema.
+ * Throws MigrationError if validation fails.
+ */
+declare const validateBlueprint: (value: unknown) => Blueprint;
+/**
+ * Validates a bundle using TypeBox schema.
+ * Throws MigrationError if validation fails.
+ */
+declare const validateBundle: (value: unknown) => Bundle;
+/**
+ * Validates an array of module IDs.
+ * Throws MigrationError if validation fails.
+ */
+declare const validateModuleIds: (value: unknown) => number[];
+export { BlueprintSchema, BundleSchema, FieldEntrySchema, FieldMappingsSchema, FlowModuleSchema, MigrationConfigV1Schema, validateBlueprint, validateBundle, validateModuleIds, };