@salesforce/plugin-omnistudio-migration-tool 2.0.0-rc.60 → 2.0.0-rc.61

package/lib/migration/omniscript.js

@@ -9,6 +9,7 @@ const Element_1 = __importDefault(require("../mappings/Element"));
 const OmniScriptDefinition_1 = __importDefault(require("../mappings/OmniScriptDefinition"));
 const utils_1 = require("../utils");
 const base_1 = require("./base");
+const CustomCssRegistry_1 = require("./CustomCssRegistry");
 const interfaces_1 = require("./interfaces");
 const net_1 = require("../utils/net");
 const FormulaUtil_1 = require("../utils/formula/FormulaUtil");
@@ -19,10 +20,13 @@ const storageUtil_1 = require("../utils/storageUtil");
 const dataModelService_1 = require("../utils/dataModelService");
 const recordPrioritization_1 = require("../utils/recordPrioritization");
 const stringContants_1 = require("../utils/constants/stringContants");
+const ApexNamespaceRegistry_1 = require("./ApexNamespaceRegistry");
 class OmniScriptMigrationTool extends base_1.BaseMigrationTool {
     constructor(exportType, namespace, connection, logger, messages, ux, allVersions) {
         super(namespace, connection, logger, messages, ux);
+        this.hookRegisteredClasses = new Set();
         this.IS_STANDARD_DATA_MODEL = (0, dataModelService_1.isStandardDataModel)();
+        this.apexNamespaceRegistry = ApexNamespaceRegistry_1.ApexNamespaceRegistry.getInstance();
         // Reserved keys that should not be used for storing output
         this.reservedKeys = new Set(['Request', 'Response']);
         // Tags to validate in PropertySet for reserved key usage
@@ -31,6 +35,36 @@ class OmniScriptMigrationTool extends base_1.BaseMigrationTool {
         this.OMNISCRIPT = 'OmniScript';
         this.exportType = exportType;
         this.allVersions = allVersions;
+        // Configure the shared Custom CSS registry. Idempotent — safe to call from
+        // both the OS and IP tool instances within a single assess run.
+        CustomCssRegistry_1.CustomCssRegistry.getInstance().init(connection, namespace, messages);
+    }
+    async loadHookRegistrations() {
+        try {
+            const objectName = `${this.namespacePrefix}CustomClassImplementation__c`;
+            const soql = `SELECT Id, Name FROM ${objectName} WHERE Name LIKE '%Hook' LIMIT 200`;
+            const result = await this.connection.query(soql);
+            const classes = new Set();
+            if (result.totalSize > 0) {
+                for (const record of result.records) {
+                    const hookName = record.Name || '';
+                    if (hookName.endsWith('Hook')) {
+                        classes.add(hookName.substring(0, hookName.length - 4));
+                    }
+                }
+            }
+            return classes;
+        }
+        catch (e) {
+            logger_1.Logger.warn('Unable to query CustomClassImplementation__c for hook registrations: ' + e);
+            return new Set();
+        }
+    }
+    hasHookForClass(remoteClass) {
+        if (this.hookRegisteredClasses.size === 0 || !remoteClass)
+            return false;
+        const simpleName = remoteClass.includes('.') ? remoteClass.split('.').pop() : remoteClass;
+        return this.hookRegisteredClasses.has(simpleName);
     }
     getName(singular = false) {
         if (this.exportType === OmniScriptExportType.IP) {
@@ -138,6 +172,9 @@ class OmniScriptMigrationTool extends base_1.BaseMigrationTool {
         try {
             const exportComponentType = this.getName();
             const omniscripts = await this.getAllOmniScripts();
+            if (this.exportType !== OmniScriptExportType.OS) {
+                this.hookRegisteredClasses = await this.loadHookRegistrations();
+            }
             if ((0, dataModelService_1.isStandardDataModelWithMetadataAPIEnabled)()) {
                 // For the Standard Data Model Orgs, we only need to prepare the storage
                 return this.handleAssessmentForStdDataModelOrgsWithMetadataAPIEnabled(omniscripts);
@@ -292,7 +329,10 @@ class OmniScriptMigrationTool extends base_1.BaseMigrationTool {
         const missingOS = [];
         const dependenciesRA = [];
         const dependenciesLWC = [];
+        const namespaceWarnings = [];
+        const namespaceErrors = [];
         //const missingRA: string[] = [];
+        const hookEnabledSteps = [];
         // Check for duplicate element names within the same OmniScript
         const elementNames = new Set();
         const duplicateElementNames = new Set();
@@ -307,6 +347,8 @@ class OmniScriptMigrationTool extends base_1.BaseMigrationTool {
                 elementNames.add(elemName);
             }
         }
+        // Detect elements with corrupted parent-child level hierarchy
+        const corruptedParentChildElements = this.detectCorruptedParentChildElements(elements);
         for (const elem of elements) {
             const type = elem[this.getFieldKey('Type__c')];
             const elemName = `${elem['Name']}`;
@@ -364,13 +406,28 @@ class OmniScriptMigrationTool extends base_1.BaseMigrationTool {
                 const nameVal = `${elemName}`;
                 const className = propertySet['remoteClass'];
                 const methodName = propertySet['remoteMethod'];
-                if (className && methodName)
-                    dependenciesRA.push({ name: className + '.' + methodName, location: nameVal });
+                if (className && methodName) {
+                    const status = this.apexNamespaceRegistry.resolveStatus(className);
+                    const qualifiedClass = this.apexNamespaceRegistry.getQualifiedClassName(className);
+                    dependenciesRA.push({ name: qualifiedClass + '.' + methodName, location: nameVal });
+                    if (status === ApexNamespaceRegistry_1.ApexResolveStatus.NAMESPACED) {
+                        namespaceWarnings.push(this.messages.getMessage('remoteActionNamespaceWarning', [nameVal, className, qualifiedClass]));
+                    }
+                    else if (status === ApexNamespaceRegistry_1.ApexResolveStatus.NOT_FOUND) {
+                        namespaceErrors.push(this.messages.getMessage('apexClassNotFound', [className, nameVal]));
+                    }
+                }
+                if (className && this.hasHookForClass(className)) {
+                    hookEnabledSteps.push(nameVal);
+                }
             }
             // To handle radio , multiselect
             if (propertySet['optionSource'] && propertySet['optionSource']['type'] === 'Custom') {
                 const nameVal = `${elemName}`;
-                dependenciesRA.push({ name: propertySet['optionSource']['source'], location: nameVal });
+                const source = propertySet['optionSource']['source'];
+                if (source) {
+                    dependenciesRA.push({ name: source, location: nameVal });
+                }
             }
             if (type === stringContants_1.Constants.CustomLightningWebComponent) {
                 const nameVal = `${elemName}`;
@@ -394,8 +451,8 @@ class OmniScriptMigrationTool extends base_1.BaseMigrationTool {
         const omniScriptName = omniscript[this.getFieldKey('Name')];
         const existingOmniScriptNameVal = new stringval_1.StringVal(omniScriptName, 'name');
         let assessmentStatus = 'Ready for migration';
-        const warnings = [];
-        const errors = [];
+        const warnings = [...namespaceWarnings];
+        const errors = [...namespaceErrors];
         // Check for missing mandatory fields for Integration Procedures
         if (omniProcessType === 'Integration Procedure') {
             if (!existingType || existingType.trim() === '') {
@@ -516,6 +573,12 @@ class OmniScriptMigrationTool extends base_1.BaseMigrationTool {
             warnings.unshift(this.messages.getMessage('reservedKeysFoundInPropertySet', [reservedKeysList]));
             assessmentStatus = 'Needs manual intervention';
         }
+        // Add warning for corrupted parent-child level hierarchy (elements at same level as their parent)
+        if (corruptedParentChildElements.size > 0) {
+            const corruptedNamesList = Array.from(corruptedParentChildElements).join(', ');
+            warnings.push(this.messages.getMessage('corruptedParentChildLevel', [omniProcessType, corruptedNamesList, omniProcessType]));
+            assessmentStatus = 'Needs manual intervention';
+        }
         if (omniProcessType === this.OMNISCRIPT) {
             const type = omniscript[this.getFieldKey('IsLwcEnabled__c')] ? 'LWC' : 'Angular';
             if (type === 'Angular') {
@@ -523,6 +586,19 @@ class OmniScriptMigrationTool extends base_1.BaseMigrationTool {
                 assessmentStatus = 'Needs manual intervention';
             }
         }
+        // Scan custom Lightning/Newport stylesheets for managed-package namespace references.
+        // Any hit forces 'Needs manual intervention' because the migrated component will
+        // silently lose styling until the customer rewrites the stylesheet.
+        const hasStylesheetNamespaceRef = await this.collectStylesheetNamespaceDependencies(omniscript, warnings);
+        if (hasStylesheetNamespaceRef) {
+            assessmentStatus = 'Needs manual intervention';
+        }
+        if (namespaceErrors.length > 0) {
+            assessmentStatus = 'Needs manual intervention';
+        }
+        else if (namespaceWarnings.length > 0 && assessmentStatus === 'Ready for migration') {
+            assessmentStatus = 'Warnings';
+        }
         // Deduplicate all dependency arrays to ensure no duplicates
         // For Remote Actions and LWCs, deduplicate by name property
         const uniqueRA = Array.from(new Map(dependenciesRA.map((item) => [item.name, item])).values());
@@ -534,6 +610,9 @@ class OmniScriptMigrationTool extends base_1.BaseMigrationTool {
         const uniqueMissingDR = [...new Set(missingDR)];
         const uniqueMissingIP = [...new Set(missingIP)];
         const uniqueMissingOS = [...new Set(missingOS)];
+        if (hookEnabledSteps.length > 0 && omniProcessType === 'Integration Procedure') {
+            warnings.push(this.messages.getMessage('prePostHookAutoEnabled', [hookEnabledSteps.join(', ')]));
+        }
         const result = {
             name: recordName,
             id: omniscript['Id'],
@@ -675,6 +754,9 @@ class OmniScriptMigrationTool extends base_1.BaseMigrationTool {
     async migrate() {
         // Get All Records from OmniScript__c (IP & OS Parent Records)
         const omniscripts = await this.getAllOmniScripts();
+        if (this.exportType !== OmniScriptExportType.OS) {
+            this.hookRegisteredClasses = await this.loadHookRegistrations();
+        }
         if ((0, dataModelService_1.isStandardDataModelWithMetadataAPIEnabled)()) {
             return this.handleMigrationForStdDataModelOrgsWithMetadataAPIEnabled(omniscripts);
         }
@@ -756,6 +838,30 @@ class OmniScriptMigrationTool extends base_1.BaseMigrationTool {
                 originalOsRecords.set(recordId, omniscript);
                 continue;
             }
+            // Check for corrupted parent-child level hierarchy (parent and child at same level)
+            const corruptedParentChildElements = this.detectCorruptedParentChildElements(elements);
+            if (corruptedParentChildElements.size > 0) {
+                const corruptedNamesList = Array.from(corruptedParentChildElements).join(', ');
+                const skippedResponse = {
+                    referenceId: recordId,
+                    id: '',
+                    success: false,
+                    hasErrors: false,
+                    errors: [],
+                    warnings: [
+                        this.messages.getMessage('corruptedParentChildLevel', [
+                            omniProcessType,
+                            corruptedNamesList,
+                            omniProcessType,
+                        ]),
+                    ],
+                    newName: '',
+                    skipped: true,
+                };
+                osUploadInfo.set(recordId, skippedResponse);
+                originalOsRecords.set(recordId, omniscript);
+                continue;
+            }
             if (omniscript[this.getFieldKey('IsProcedure__c')] === true) {
                 // Check for missing mandatory fields for Integration Procedures
                 const existingType = omniscript[this.getFieldKey('Type__c')];
@@ -1569,6 +1675,9 @@ class OmniScriptMigrationTool extends base_1.BaseMigrationTool {
             case stringContants_1.Constants.RemoteAction:
                 this.processRemoteAction(propSet);
                 break;
+            case stringContants_1.Constants.NavigateAction:
+                this.processNavigateAction(propSet);
+                break;
             default:
                 // Handle other element types if needed
                 break;
@@ -1788,6 +1897,58 @@ class OmniScriptMigrationTool extends base_1.BaseMigrationTool {
             propSetMap['Sub Type'] = this.cleanName(osSubType);
         }
     }
+    /**
+     * Processes Navigate Action elements so the migrated parent OmniScript can launch its child
+     * under the standard runtime. The standard-runtime Navigate Action LWC reads
+     * `omniscript__type`, `omniscript__subType`, `omniscript__language` from the propertySet to
+     * resolve the child OmniScript (it does not consume `targetLWC`). Params on the URL bound for
+     * the OmniScript page must use the `omniscript__` prefix instead of the managed-package `c__`
+     * prefix.
+     * @param propSetMap Property set map from the element
+     */
+    processNavigateAction(propSetMap) {
+        if (propSetMap.targetType !== 'Vlocity OmniScript') {
+            return;
+        }
+        const lwcRef = typeof propSetMap.targetLWC === 'string' ? propSetMap.targetLWC : '';
+        if (lwcRef) {
+            // propertySet stores the LWC tag form ("c:foo" or "c__foo"); the ES-module form ("c/foo")
+            // never appears here, so stripping a leading "<ns>:" or "c__" covers all valid inputs.
+            const stripped = lwcRef
+                .replace(/^[^:]+:/, '')
+                .replace(/^c__/, '')
+                .toLowerCase();
+            const candidates = this.nameRegistry.getOmniScriptMappingKeys().filter((key) => {
+                const parts = key.split('_');
+                if (parts.length < 2)
+                    return false;
+                const type = parts[0];
+                const subType = parts[1];
+                const language = parts[2] || 'English';
+                const candidate = `${this.cleanName(type)}${this.cleanName(subType)}${language}`.toLowerCase();
+                return candidate === stripped;
+            });
+            if (candidates.length > 1) {
+                logger_1.Logger.logVerbose(`\nMultiple OmniScript registry keys collapse to the same LWC name '${lwcRef}': ${candidates.join(', ')}. Using the first match.`);
+            }
+            const match = candidates[0];
+            if (match) {
+                const cleanedFullName = this.nameRegistry.getCleanedName(match, 'OmniScript');
+                const cleanedParts = cleanedFullName.split('_');
+                if (cleanedParts.length >= 2) {
+                    propSetMap.omniscript__type = cleanedParts[0];
+                    propSetMap.omniscript__subType = cleanedParts[1];
+                    propSetMap.omniscript__language = cleanedParts[2] || match.split('_')[2] || 'English';
+                }
+            }
+            else {
+                logger_1.Logger.logVerbose(`\n${this.messages.getMessage('componentMappingNotFound', ['OmniScript', lwcRef])}`);
+            }
+        }
+        if (typeof propSetMap.targetLWCParams === 'string' && propSetMap.targetLWCParams) {
+            propSetMap.targetLWCParams = propSetMap.targetLWCParams.replace(/(^|&)c__/g, '$1omniscript__');
+        }
+    }
     /**
      * Processes Step elements to update reference names
      * @param propSetMap Property set map from the element
@@ -1897,11 +2058,20 @@ class OmniScriptMigrationTool extends base_1.BaseMigrationTool {
         }
     }
     /**
-     * Processes Remote Action elements to update transform bundle references
+     * Processes Remote Action elements to update transform bundle references and qualify remoteClass with namespace
      * @param propSetMap Property set map from the element
      */
     processRemoteAction(propSetMap) {
         this.processTransformBundles(propSetMap);
+        if (propSetMap.remoteClass) {
+            propSetMap.remoteClass = this.apexNamespaceRegistry.getQualifiedClassName(propSetMap.remoteClass);
+        }
+        if (this.hasHookForClass(propSetMap.remoteClass)) {
+            const remoteOptions = propSetMap['remoteOptions'] || {};
+            remoteOptions['PreHook'] = true;
+            remoteOptions['PostHook'] = true;
+            propSetMap['remoteOptions'] = remoteOptions;
+        }
     }
     /**
      * Processes lwcComponentOverride property to update FlexCard reference names
@@ -2137,6 +2307,79 @@ class OmniScriptMigrationTool extends base_1.BaseMigrationTool {
             });
         });
     }
+    /**
+     * Reads the OmniScript's custom Lightning/Newport stylesheet references from
+     * PropertySetConfig and warns if the referenced StaticResource's CSS body
+     * still contains the org's managed-package namespace string. Such references
+     * won't resolve after migration and would silently break styling, so the
+     * caller escalates `migrationStatus` to 'Needs manual intervention' on a hit.
+     *
+     * Heavy lifting (StaticResource lookup, body fetch, zip extraction, scan,
+     * cache) lives in {@link CustomCssRegistry} so the same cache can later be
+     * shared with FlexCard assessment without re-querying the same resources.
+     *
+     * @param omniscript The OmniScript/IP record being assessed.
+     * @param warnings   Warnings array on the in-progress OSAssessmentInfo (mutated).
+     * @returns          `true` if at least one namespace-referencing stylesheet
+     *                   was found and a warning was pushed.
+     */
+    async collectStylesheetNamespaceDependencies(omniscript, warnings) {
+        const registry = CustomCssRegistry_1.CustomCssRegistry.getInstance();
+        if (!registry.isEnabled()) {
+            return false;
+        }
+        const propertySetConfigStr = omniscript[this.getFieldKey('PropertySet__c')];
+        if (!propertySetConfigStr) {
+            return false;
+        }
+        let propertySetConfig;
+        try {
+            propertySetConfig = JSON.parse(propertySetConfigStr);
+        }
+        catch (ex) {
+            logger_1.Logger.error(`Failed to parse PropertySetConfig for stylesheet scan: ${omniscript['Name']}`);
+            return false;
+        }
+        const { stylesheetsWithNamespaceRefs } = await registry.scanOmniScriptStylesheets(propertySetConfig === null || propertySetConfig === void 0 ? void 0 : propertySetConfig.stylesheet);
+        let pushed = false;
+        for (const resourceName of stylesheetsWithNamespaceRefs) {
+            const message = registry.buildOmniScriptNamespaceWarning(resourceName);
+            if (message) {
+                warnings.push(message);
+                pushed = true;
+            }
+        }
+        return pushed;
+    }
+    /**
+     * Detects elements that have a corrupted parent-child level hierarchy.
+     * In a valid OmniScript, a child element should always have a higher Level__c
+     * than its parent. When both parent and child are at the same level (typically level 0),
+     * it indicates data corruption that will cause elements to be lost during migration.
+     *
+     * @param elements - Array of element records queried from the OmniScript
+     * @returns Set of element names that have corrupted parent-child levels
+     */
+    detectCorruptedParentChildElements(elements) {
+        const corruptedElements = new Set();
+        // Build a map of element IDs to their levels
+        const elementLevelMap = new Map();
+        for (const elem of elements) {
+            elementLevelMap.set(elem['Id'], elem[this.getElementFieldKey('Level__c')]);
+        }
+        // Check each element: if it has a parent and both are at the same level, it's corrupted
+        for (const elem of elements) {
+            const parentId = elem[this.getElementFieldKey('ParentElementId__c')];
+            if (parentId && elementLevelMap.has(parentId)) {
+                const childLevel = elem[this.getElementFieldKey('Level__c')];
+                const parentLevel = elementLevelMap.get(parentId);
+                if (childLevel != null && parentLevel != null && childLevel === parentLevel) {
+                    corruptedElements.add(elem['Name']);
+                }
+            }
+        }
+        return corruptedElements;
+    }
     getElementFieldKey(fieldName) {
         return this.IS_STANDARD_DATA_MODEL ? Element_1.default[fieldName] : this.namespacePrefix + fieldName;
     }