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

package/lib/migration/omniscript.d.ts

@@ -4,20 +4,28 @@ import { BaseMigrationTool } from './base';
 import { MigrationResult, MigrationTool } from './interfaces';
 import { ObjectMapping } from './interfaces';
 import { Connection, Messages } from '@salesforce/core';
-import { UX } from '@salesforce/command';
+import { Ux } from '@salesforce/sf-plugins-core';
 import { OmniAssessmentInfo } from '../../src/utils';
 import { Logger } from '../utils/logger';
 export declare class OmniScriptMigrationTool extends BaseMigrationTool implements MigrationTool {
     private readonly exportType;
     private readonly allVersions;
+    private hookRegisteredClasses;
+    private IS_STANDARD_DATA_MODEL;
+    private readonly apexNamespaceRegistry;
+    private readonly reservedKeys;
+    private readonly tagsToValidate;
+    private readonly OMNISCRIPT;
     static readonly OMNISCRIPT_NAME = "OmniScript__c";
     static readonly ELEMENT_NAME = "Element__c";
     static readonly OMNISCRIPTDEFINITION_NAME = "OmniScriptDefinition__c";
     static readonly OMNIPROCESS_NAME = "OmniProcess";
     static readonly OMNIPROCESSELEMENT_NAME = "OmniProcessElement";
     static readonly OMNIPROCESSCOMPILATION_NAME = "OmniProcessCompilation";
-    constructor(exportType: OmniScriptExportType, namespace: string, connection: Connection, logger: Logger, messages: Messages, ux: UX, allVersions: boolean);
-    getName(): string;
+    constructor(exportType: OmniScriptExportType, namespace: string, connection: Connection, logger: Logger, messages: Messages<string>, ux: Ux, allVersions: boolean);
+    private loadHookRegistrations;
+    private hasHookForClass;
+    getName(singular?: boolean): 'Integration Procedures' | 'Integration Procedure' | 'Omniscripts' | 'Omniscript';
     getRecordName(record: string): string;
     getMappings(): ObjectMapping[];
     truncate(): Promise<void>;
@@ -33,11 +41,18 @@ export declare class OmniScriptMigrationTool extends BaseMigrationTool implement
         };
     }>;
     assess(dataRaptorAssessmentInfos: DataRaptorAssessmentInfo[], flexCardAssessmentInfos: FlexCardAssessmentInfo[]): Promise<OmniAssessmentInfo>;
+    private handleAssessmentForStdDataModelOrgsWithMetadataAPIEnabled;
     processOmniComponents(omniscripts: AnyJson[], dataRaptorAssessmentInfos: DataRaptorAssessmentInfo[], flexCardAssessmentInfos: FlexCardAssessmentInfo[]): Promise<OmniAssessmentInfo>;
     private processOmniScript;
+    private prepareStorageForRelatedObjectsWhenMetadataAPIEnabled;
+    private updateStorageForOmniscriptAssessment;
+    private addKeyToStorage;
+    private markDuplicateKeyInStorage;
+    private isDifferentOmniscript;
+    private cleanLanguageName;
     migrate(): Promise<MigrationResult[]>;
     private getMigratedRecordsByType;
-    private addToAssessmentStorage;
+    private handleMigrationForStdDataModelOrgsWithMetadataAPIEnabled;
     private updateStorageForOmniscript;
     private getAllOmniScripts;
     private getAllElementsForOmniScript;
@@ -52,11 +67,210 @@ export declare class OmniScriptMigrationTool extends BaseMigrationTool implement
      * @returns
      */
     private mapOmniScriptRecord;
+    /**
+     * Processes persistentComponent array in OmniProcess PropertySetConfig to update transform bundle references
+     * Handles: persistentComponent[].remoteOptions.preTransformBundle, persistentComponent[].remoteOptions.postTransformBundle,
+     *          persistentComponent[].preTransformBundle, persistentComponent[].postTransformBundle
+     * @param propertySetConfig The parsed PropertySetConfig object
+     */
+    private processPersistentComponents;
     private mapElementData;
     private mapOsDefinitionsData;
+    /**
+     * Shared helper method to process element types and update references
+     * Handles the switch statement logic for different element types
+     * @param elementType Type of the element
+     * @param propSet Property set map from the element
+     * @param invalidIpReferences Optional map to track invalid IP references
+     * @param elementName Optional element name for logging
+     */
+    private processElementByType;
+    /**
+     * Recursively processes children elements in the content JSON to update bundle/reference names
+     * @param children Array of child elements from the content JSON
+     */
+    private processContentChildren;
+    /**
+     * Processes individual content element to update bundle/reference names based on type
+     * @param element Individual element from the content JSON
+     */
+    private processContentElement;
+    /**
+     * Processes DocuSign Envelope Action elements to update transformBundle references
+     * @param propSetMap Property set map from the element
+     */
+    private processDocuSignEnvelopeAction;
+    /**
+     * Processes DocuSign Signature Action elements to update transformBundle references
+     * @param propSetMap Property set map from the element
+     */
+    private processDocuSignSignatureAction;
+    /**
+     * Processes Integration Procedure Action elements to update reference names
+     * @param propSetMap Property set map from the element
+     * @param invalidIpReferences Optional map to track invalid IP references for reporting
+     * @param elementName Optional element name for tracking invalid references
+     */
+    private processIntegrationProcedureAction;
+    /**
+     * Processes DataRaptor Action elements to update bundle names
+     * @param propSetMap Property set map from the element
+     */
+    private processDataRaptorAction;
+    /**
+     * Processes OmniScript Action elements to update reference names
+     * @param propSetMap Property set map from the element
+     */
+    private processOmniScriptAction;
+    /**
+     * 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
+     */
+    private processNavigateAction;
+    /**
+     * Processes Step elements to update reference names
+     * @param propSetMap Property set map from the element
+     */
+    private processStepAction;
+    /**
+     * Generic helper to process common transform bundle properties
+     * Handles: preTransformBundle, postTransformBundle, remoteOptions.preTransformBundle, remoteOptions.postTransformBundle
+     * @param propSetMap Property set map from the element
+     */
+    private processTransformBundles;
+    /**
+     * Helper to clean a single bundle name using registry or fallback
+     * @param bundleName The bundle name to clean
+     * @returns The cleaned bundle name
+     */
+    private cleanBundleName;
+    /**
+     * Processes Decision Matrix Action elements to update transform bundle references
+     * @param propSetMap Property set map from the element
+     */
+    private processDecisionMatrixAction;
+    /**
+     * Processes Expression Set Action elements to update transform bundle references
+     * @param propSetMap Property set map from the element
+     */
+    private processExpressionSetAction;
+    /**
+     * Processes HTTP Action elements to update transform bundle references
+     * Handles: preTransformBundle, postTransformBundle, xmlPreTransformBundle, xmlPostTransformBundle
+     * @param propSetMap Property set map from the element
+     */
+    private processHttpAction;
+    /**
+     * Processes PDF Action elements to update transform bundle references
+     * @param propSetMap Property set map from the element
+     */
+    private processPdfAction;
+    /**
+     * Processes Remote Action elements to update transform bundle references and qualify remoteClass with namespace
+     * @param propSetMap Property set map from the element
+     */
+    private processRemoteAction;
+    /**
+     * Processes lwcComponentOverride property to update FlexCard reference names
+     * @param propSetMap Property set map from the element
+     */
+    private processLwcComponentOverride;
     private getOmniScriptFields;
     private getElementFields;
+    private getOmniScriptCompiledDefinitionObjectName;
     private getOmniScriptDefinitionFields;
+    /**
+     * Prioritizes OmniScripts by name characteristics:
+     * - Clean names (alphanumeric only) are processed first
+     * - Names with special characters are processed after
+     * This avoids naming conflicts during migration when special characters are cleaned
+     */
+    private prioritizeOmniscriptsWithoutSpecialCharacters;
+    /**
+     * Collects reserved keys found in PropertySet tagsToValidate
+     * @param propertySet - The PropertySet JSON object to validate
+     * @param foundReservedKeys - Set to collect found reserved keys
+     */
+    private collectReservedKeys;
+    /**
+     * Collects DataRaptor transform bundle dependencies from PropertySet
+     * Handles: preTransformBundle, postTransformBundle, xmlPreTransformBundle, xmlPostTransformBundle,
+     * and remoteOptions.preTransformBundle, remoteOptions.postTransformBundle
+     * Used by: HTTP Action, Remote Action, Decision Matrix Action, Expression Set Action, PDF Action, Step
+     * @param propertySet - The PropertySet JSON object
+     * @param elemName - Element name for location tracking
+     * @param dependencyDR - Array to collect DataRaptor dependencies
+     * @param existingDataRaptorNames - Set of existing DataRaptor names
+     * @param missingDR - Array to collect missing DataRaptor names
+     */
+    private collectTransformBundleDependencies;
+    /**
+     * Collects DataRaptor transform bundle dependencies from DocuSign Envelope Action
+     * Handles: docuSignTemplatesGroup[].transformBundle
+     * @param propertySet - The PropertySet JSON object
+     * @param elemName - Element name for location tracking
+     * @param dependencyDR - Array to collect DataRaptor dependencies
+     * @param existingDataRaptorNames - Set of existing DataRaptor names
+     * @param missingDR - Array to collect missing DataRaptor names
+     */
+    private collectDocuSignBundleDependencies;
+    /**
+     * Collects DataRaptor transform bundle dependencies from DocuSign Signature Action
+     * Handles: docuSignTemplatesGroupSig[].transformBundle
+     * @param propertySet - The PropertySet JSON object
+     * @param elemName - Element name for location tracking
+     * @param dependencyDR - Array to collect DataRaptor dependencies
+     * @param existingDataRaptorNames - Set of existing DataRaptor names
+     * @param missingDR - Array to collect missing DataRaptor names
+     */
+    private collectDocuSignSignatureBundleDependencies;
+    /**
+     * Collects DataRaptor transform bundle dependencies from OmniProcess PropertySetConfig persistentComponent array
+     * Handles: persistentComponent[].remoteOptions.preTransformBundle, persistentComponent[].remoteOptions.postTransformBundle,
+     *          persistentComponent[].preTransformBundle, persistentComponent[].postTransformBundle
+     * @param omniscript - The OmniScript/Integration Procedure record
+     * @param dependencyDR - Array to collect DataRaptor dependencies
+     * @param existingDataRaptorNames - Set of existing DataRaptor names
+     * @param missingDR - Array to collect missing DataRaptor names
+     */
+    private collectPersistentComponentBundleDependencies;
+    /**
+     * 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.
+     */
+    private collectStylesheetNamespaceDependencies;
+    /**
+     * 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
+     */
+    private detectCorruptedParentChildElements;
+    private getElementFieldKey;
+    private getFieldKey;
+    private getQueryNamespace;
+    getOmniscriptObjectName(): string;
+    private getElementObjectName;
     private sleep;
 }
 export declare enum OmniScriptExportType {