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

package/lib/migration/omniscriptInstance.js

@@ -0,0 +1,755 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OmniScriptInstanceMigrationTool = void 0;
+const OmniScriptInstance_1 = __importDefault(require("../mappings/OmniScriptInstance"));
+const OmniScript_1 = __importDefault(require("../mappings/OmniScript"));
+const utils_1 = require("../utils");
+const logger_1 = require("../utils/logger");
+const net_1 = require("../utils/net");
+const dataModelService_1 = require("../utils/dataModelService");
+const stringContants_1 = require("../utils/constants/stringContants");
+const base_1 = require("./base");
+const interfaces_1 = require("./interfaces");
+const base_2 = require("./base");
+class OmniScriptInstanceMigrationTool extends base_1.BaseMigrationTool {
+    constructor(namespace, connection, logger, messages, ux) {
+        super(namespace, connection, logger, messages, ux);
+        this.IS_STANDARD_DATA_MODEL = (0, dataModelService_1.isStandardDataModel)();
+    }
+    getName() {
+        return stringContants_1.Constants.OmniScriptSavedSessionsDisplayName;
+    }
+    getRecordName(record) {
+        return record['Name'] || record['Id'];
+    }
+    getMappings() {
+        return [
+            {
+                source: stringContants_1.Constants.OmniScriptInstanceObjectName,
+                target: stringContants_1.Constants.OmniScriptSavedSessionObjectName,
+            },
+        ];
+    }
+    async truncate() {
+        // Truncation is needed when we migrate from custom to standard data model
+        // For custom data model, no truncation is required
+        if (this.IS_STANDARD_DATA_MODEL) {
+            logger_1.Logger.logVerbose(this.messages.getMessage('skippingTruncation'));
+            return;
+        }
+        // Delete ALL records from Core, just like OS, IP, and DM do
+        // This ensures a clean migration state
+        await super.truncate(stringContants_1.Constants.OmniScriptSavedSessionObjectName);
+    }
+    /**
+     * Assess Save for Later instances for migration readiness
+     * Checks dependencies on OmniScript migration status
+     */
+    async assess(omniAssessmentInfos) {
+        try {
+            if ((0, dataModelService_1.isStandardDataModelWithMetadataAPIEnabled)()) {
+                return [];
+            }
+            logger_1.Logger.log(this.messages.getMessage('startingOmniScriptAssessment', [stringContants_1.Constants.OmniScriptSavedSessionsDisplayName]));
+            const omniscriptInstances = await this.queryOmniscriptInstance();
+            logger_1.Logger.log(this.messages.getMessage('foundOmniScriptsToAssess', [
+                omniscriptInstances.length,
+                stringContants_1.Constants.OmniScriptSavedSessionsDisplayName,
+            ]));
+            if (omniscriptInstances.length === 0) {
+                return [];
+            }
+            const { omniProcessMap, omniscriptSet } = await this.assessPrepare(omniscriptInstances, omniAssessmentInfos);
+            const progressBar = (0, base_2.createProgressBar)('Assessing', this.getName());
+            progressBar.start(omniscriptInstances.length, 0);
+            const assessmentInfos = [];
+            let progressCounter = 0;
+            // Process and set the migration status for both saved sessions and omniscripts
+            for (const osInstance of omniscriptInstances) {
+                const assessInfo = this.performAssessment(osInstance, omniProcessMap, omniscriptSet);
+                assessmentInfos.push(assessInfo);
+                progressBar.update(++progressCounter);
+            }
+            progressBar.stop();
+            logger_1.Logger.log(this.messages.getMessage('assessedOmniScriptsCount', [
+                assessmentInfos.length,
+                stringContants_1.Constants.OmniScriptSavedSessionsDisplayName,
+            ]));
+            return assessmentInfos;
+        }
+        catch (err) {
+            if (err instanceof interfaces_1.InvalidEntityTypeError) {
+                throw err;
+            }
+            logger_1.Logger.error(this.messages.getMessage('errorDuringSaveForLaterAssessment', [err.message]));
+            return [];
+        }
+    }
+    /**
+     * Migration of Save for Later instances
+     */
+    async migrate() {
+        var _a;
+        if ((0, dataModelService_1.isStandardDataModelWithMetadataAPIEnabled)()) {
+            return [];
+        }
+        const originalOsInstanceRecords = new Map();
+        const osInstanceUploadInfo = new Map();
+        try {
+            // verify custom field PackageSavedSessionId__c exists in OmniScriptSavedSession
+            const hasCustomField = await this.hasCustomFieldPackageSavedSessionId();
+            if (!hasCustomField) {
+                logger_1.Logger.error(this.messages.getMessage('ossMissingCustomField'));
+                return [];
+            }
+            const omniscriptInstances = await this.queryOmniscriptInstance();
+            logger_1.Logger.log(this.messages.getMessage('foundOmniScriptsToMigrate', [
+                omniscriptInstances.length,
+                stringContants_1.Constants.OmniScriptSavedSessionsDisplayName,
+            ]));
+            if (omniscriptInstances.length === 0) {
+                return [];
+            }
+            const { omniProcessMap } = await this.assessPrepare(omniscriptInstances);
+            const progressBar = (0, base_2.createProgressBar)('Migrating', this.getName());
+            progressBar.start(omniscriptInstances.length, 0);
+            let progressCounter = 0;
+            // Process and set the migration status for both saved sessions and omniscripts
+            for (const osInstance of omniscriptInstances) {
+                const migratedInfo = await this.performMigration(osInstance, omniProcessMap);
+                const osInstanceId = String((_a = osInstance['Id']) !== null && _a !== void 0 ? _a : '');
+                osInstanceUploadInfo.set(osInstanceId, migratedInfo);
+                originalOsInstanceRecords.set(osInstanceId, osInstance);
+                progressBar.update(++progressCounter);
+            }
+            progressBar.stop();
+        }
+        catch (error) {
+            logger_1.Logger.error(this.messages.getMessage('ossMigrationFailed'), error);
+        }
+        return [
+            {
+                name: this.getName(),
+                results: osInstanceUploadInfo,
+                records: originalOsInstanceRecords,
+            },
+        ];
+    }
+    async assessPrepare(omniscriptInstances, omniAssessmentInfos) {
+        var _a, _b, _c, _d, _e, _f, _g;
+        let omniscriptSet = new Set();
+        if (omniAssessmentInfos && omniAssessmentInfos.osAssessmentInfos) {
+            omniscriptSet = this.extractUniqueNamesFromOmniscriptAssessment(omniAssessmentInfos.osAssessmentInfos);
+        }
+        const omniscriptTypes = new Set();
+        // extract all OmniscriptType__c field from omniscriptInstance to prepare for query
+        // NOTE : if OmniscriptType__c is null for an omniscriptInstance,
+        // it means that the original omniscript has been deleted AND this specific instance might be unrepairable
+        for (const osInst of omniscriptInstances) {
+            const osType = String((_a = osInst[this.getOmniscriptInstancePackageFieldKey('OmniScriptType__c')]) !== null && _a !== void 0 ? _a : '');
+            if (osInst && osType !== '') {
+                omniscriptTypes.add(osType);
+            }
+        }
+        // query for Omniscript__c if omniscriptAssessment did not provide any information
+        if (omniscriptSet.size === 0) {
+            const packageOmniscripts = await this.queryPackageOmniscriptsWithType(omniscriptTypes);
+            const osType = this.getOmniscriptPackageFieldKey('Type__c');
+            const osSubType = this.getOmniscriptPackageFieldKey('SubType__c');
+            const osLanguage = this.getOmniscriptPackageFieldKey('Language__c');
+            omniscriptSet = new Set();
+            for (const pkgos of packageOmniscripts) {
+                const uniqueOmniProcessString = String((_b = pkgos[osType]) !== null && _b !== void 0 ? _b : '') + String((_c = pkgos[osSubType]) !== null && _c !== void 0 ? _c : '') + String((_d = pkgos[osLanguage]) !== null && _d !== void 0 ? _d : '');
+                if (uniqueOmniProcessString !== '') {
+                    omniscriptSet.add(uniqueOmniProcessString);
+                }
+            }
+        }
+        // query for OmniProcesses matching the types defined in the OmniscriptInstance__c
+        const omniProcesses = await this.queryOmniProcessesWithType(omniscriptTypes);
+        // extract the unique string for each omni process, store it in a set, it will be used
+        // later to determine the omniscript migration status
+        const omniProcessMap = new Map();
+        for (const omniProcess of omniProcesses) {
+            const uniqueOmniProcessString = String((_e = omniProcess['Type']) !== null && _e !== void 0 ? _e : '') +
+                String((_f = omniProcess['SubType']) !== null && _f !== void 0 ? _f : '') +
+                String((_g = omniProcess['Language']) !== null && _g !== void 0 ? _g : '');
+            const recordId = String(omniProcess['Id']);
+            if (uniqueOmniProcessString !== '' && recordId !== '') {
+                omniProcessMap.set(uniqueOmniProcessString, recordId);
+            }
+        }
+        return {
+            omniProcessMap,
+            omniscriptSet,
+        };
+    }
+    extractUniqueNamesFromOmniscriptAssessment(osAssessmentInfos) {
+        var _a, _b, _c;
+        const omniscriptSet = new Set();
+        if (Array.isArray(osAssessmentInfos)) {
+            for (const osAssessInfo of osAssessmentInfos) {
+                // assessment info for omniscripts will show what the old and newType, newSubtype and newLanguage
+                // newType, newSubType, newLanguage will show up regardless of migration,
+                // so that OmniProcess doesn't even have to exist
+                if (osAssessInfo) {
+                    const nameMapping = osAssessInfo['nameMapping'];
+                    if (nameMapping != null) {
+                        const uniqueOmniscriptString = String((_a = nameMapping['newType']) !== null && _a !== void 0 ? _a : '') +
+                            String((_b = nameMapping['newSubType']) !== null && _b !== void 0 ? _b : '') +
+                            String((_c = nameMapping['newLanguage']) !== null && _c !== void 0 ? _c : '');
+                        if (uniqueOmniscriptString !== '') {
+                            omniscriptSet.add(uniqueOmniscriptString);
+                        }
+                    }
+                }
+            }
+        }
+        return omniscriptSet;
+    }
+    performAssessment(osInstance, omniProcessMap, omniscriptSet) {
+        var _a, _b, _c, _d, _e, _f, _g, _h;
+        const osId = String((_a = osInstance[this.getOmniscriptInstancePackageFieldKey('OmniScriptId__c')]) !== null && _a !== void 0 ? _a : '');
+        const osType = String((_b = osInstance[this.getOmniscriptInstancePackageFieldKey('OmniScriptType__c')]) !== null && _b !== void 0 ? _b : '');
+        const osSubType = String((_c = osInstance[this.getOmniscriptInstancePackageFieldKey('OmniScriptSubType__c')]) !== null && _c !== void 0 ? _c : '');
+        const osLanguage = String((_d = osInstance[this.getOmniscriptInstancePackageFieldKey('OmniScriptLanguage__c')]) !== null && _d !== void 0 ? _d : '');
+        const osInstanceId = String((_e = osInstance['Id']) !== null && _e !== void 0 ? _e : '');
+        const osInstanceName = String((_f = osInstance['Name']) !== null && _f !== void 0 ? _f : '');
+        const osInstanceStatus = String((_g = osInstance[this.getOmniscriptInstancePackageFieldKey('Status__c')]) !== null && _g !== void 0 ? _g : '');
+        const osInstanceLastSaved = String((_h = osInstance[this.getOmniscriptInstancePackageFieldKey('LastSaved__c')]) !== null && _h !== void 0 ? _h : '');
+        const uniqueOmniProcessString = osType + osSubType + osLanguage;
+        const osUniqueName = osType !== '' ? `${osType}_${osSubType}_${osLanguage}` : '';
+        const errors = [];
+        const dependencies = [];
+        let migrationStatus = 'Ready for migration';
+        let omniScriptMigrationStatus = 'Ready for migration';
+        // if omniscriptInstance's referenced omniscript is not migrated to core
+        // then check the passed in omniscripts assessments from managed package
+        if (omniProcessMap.has(uniqueOmniProcessString)) {
+            // active Omni Process is in the org (already migrated)
+            migrationStatus = 'Ready for migration';
+            omniScriptMigrationStatus = 'Complete';
+        }
+        else if (omniscriptSet.has(uniqueOmniProcessString)) {
+            // active Omniscript__c is in the org
+            // No active Omni Process
+            migrationStatus = 'Ready for migration';
+            omniScriptMigrationStatus = 'Ready for migration';
+            const osNeedsToBeDeployed = this.messages.getMessage('omniscriptNeedsToBeMigrated', [osUniqueName]);
+            errors.push(osNeedsToBeDeployed);
+            dependencies.push(osUniqueName);
+        }
+        else {
+            // both Omniscript__c and Omni Process does not exist in the org, panic
+            // OR
+            // OmniscriptInstance having no data for OmniScriptType__c probably means the Omniscript__c no longer exists in the Org.
+            migrationStatus = 'Needs manual intervention';
+            omniScriptMigrationStatus = 'Needs manual intervention';
+            const unableToFindOs = this.messages.getMessage('unableToFindActiveOmniscript', [osUniqueName]);
+            const followUpMsg = this.messages.getMessage('omniscriptDoesNotExistOrActivate');
+            let msg = `${unableToFindOs}`;
+            if (osType === '') {
+                const noOsFound = this.messages.getMessage('noOmniscriptFoundForOsInstance', [osInstanceName]);
+                // OmniscriptInstance having no data for OmniScriptType__c probably means the Omniscript no longer exists in the Org.
+                msg = `${noOsFound}`;
+            }
+            errors.push(msg);
+            errors.push(followUpMsg);
+        }
+        const assessInfo = {
+            id: osInstanceId,
+            name: osInstanceName,
+            oldName: osInstanceName,
+            omniScriptId: osId,
+            omniScriptName: osUniqueName,
+            status: osInstanceStatus,
+            lastSaved: osInstanceLastSaved,
+            migrationStatus,
+            omniScriptMigrationStatus,
+            dependenciesOS: dependencies,
+            errors,
+            infos: [],
+            warnings: [],
+        };
+        return assessInfo;
+    }
+    async performMigration(osInstance, omniProcessMap) {
+        var _a, _b, _c, _d, _e, _f, _g, _h;
+        const errors = [];
+        const warnings = [];
+        let skipped = false;
+        // Extract OmniScript Instance data
+        const osInstanceId = String((_a = osInstance['Id']) !== null && _a !== void 0 ? _a : '');
+        const osInstanceName = String((_b = osInstance['Name']) !== null && _b !== void 0 ? _b : '');
+        const osTypeFieldKey = this.getOmniscriptInstancePackageFieldKey('OmniScriptType__c');
+        const osSubTypeFieldKey = this.getOmniscriptInstancePackageFieldKey('OmniScriptSubType__c');
+        const osLanguageFieldKey = this.getOmniscriptInstancePackageFieldKey('OmniScriptLanguage__c');
+        const osType = String((_c = osInstance[osTypeFieldKey]) !== null && _c !== void 0 ? _c : '');
+        const osSubType = String((_d = osInstance[osSubTypeFieldKey]) !== null && _d !== void 0 ? _d : '');
+        const osLanguage = String((_e = osInstance[osLanguageFieldKey]) !== null && _e !== void 0 ? _e : '');
+        if (osType === '' || osSubType === '' || osLanguage === '') {
+            errors.push(this.messages.getMessage('ossMissingFieldValue', [
+                osInstanceName,
+                osTypeFieldKey,
+                osSubTypeFieldKey,
+                osLanguageFieldKey,
+            ]));
+            skipped = true;
+            const uploadedRecord = {
+                referenceId: osInstanceId,
+                id: '',
+                success: errors.length === 0,
+                hasErrors: errors.length > 0,
+                errors,
+                warnings,
+                newName: osInstanceName,
+                skipped,
+            };
+            return uploadedRecord;
+        }
+        // Extract OmniProcess Id from omniProcessSet
+        const uniqueOmniProcessString = osType + osSubType + osLanguage;
+        const targetOmniProcessId = omniProcessMap.get(uniqueOmniProcessString);
+        if (!targetOmniProcessId) {
+            errors.push(this.messages.getMessage('ossOmniscriptNeedsMigration', [osType, osSubType, osLanguage]));
+            skipped = true;
+            const uploadedRecord = {
+                referenceId: osInstanceId,
+                id: '',
+                success: errors.length === 0,
+                hasErrors: errors.length > 0,
+                errors,
+                warnings,
+                newName: osInstanceName,
+                skipped,
+            };
+            return uploadedRecord;
+        }
+        logger_1.Logger.debug(this.messages.getMessage('ossFoundOmniProcess', [osType, osSubType, osLanguage, targetOmniProcessId]));
+        // Construct data for OmniScriptSavedSession
+        const savedSessionData = {};
+        // Map fields from OmniScriptInstance__c to OmniScriptSavedSession
+        for (const [packageField, coreField] of Object.entries(OmniScriptInstance_1.default)) {
+            const packageFieldKey = this.getOmniscriptInstancePackageFieldKey(packageField);
+            const sourceValue = String((_f = osInstance[packageFieldKey]) !== null && _f !== void 0 ? _f : '');
+            if (sourceValue !== '') {
+                savedSessionData[coreField] = sourceValue;
+            }
+        }
+        delete savedSessionData['IsWebCompEnabled'];
+        delete savedSessionData['OmniScriptVersionNumber'];
+        delete savedSessionData['OmniScriptType'];
+        delete savedSessionData['OmniScriptSubType'];
+        delete savedSessionData['OmniScriptLanguage'];
+        savedSessionData['Name'] = osInstanceName;
+        savedSessionData['OmniScriptId'] = targetOmniProcessId;
+        savedSessionData['PackageSavedSessionId__c'] = osInstanceId;
+        // Upload to OmniScriptSavedSession
+        const omniscriptSavedSessionResult = await this.migrateCreateOmniscriptSavedSession(osInstanceId, osInstanceName, osType, osSubType, osLanguage, savedSessionData);
+        if (((_g = omniscriptSavedSessionResult === null || omniscriptSavedSessionResult === void 0 ? void 0 : omniscriptSavedSessionResult.errors) === null || _g === void 0 ? void 0 : _g.length) > 0) {
+            errors.push(...omniscriptSavedSessionResult.errors);
+        }
+        // Extract Id for OmniScriptSavedSession
+        const newSavedSessionId = omniscriptSavedSessionResult === null || omniscriptSavedSessionResult === void 0 ? void 0 : omniscriptSavedSessionResult.id;
+        if (!newSavedSessionId) {
+            const errMsg = this.messages.getMessage('ossSkipAttachmentUpload', [osInstanceName]);
+            logger_1.Logger.error(errMsg);
+            errors.push(errMsg);
+        }
+        else {
+            // Extract all attachment object information for current omniscriptInstance record
+            // includes the url to the content of the attachment Body
+            const attachments = await this.queryAttachments(osInstanceId);
+            logger_1.Logger.log(this.messages.getMessage('ossFoundAttachments', [attachments.length, osInstanceId]));
+            // Download attachment body
+            const attachmentBodyData = await this.downloadAttachments(attachments);
+            // Transform / replace references to managed package in attachments Body  : OmniscriptFullJSON.json
+            // Upload Attachment with Saved Session's Id as ParentId
+            const uploadAttachmentResult = await this.migrateUploadAttachments(attachmentBodyData, newSavedSessionId, osInstanceName);
+            if (((_h = uploadAttachmentResult === null || uploadAttachmentResult === void 0 ? void 0 : uploadAttachmentResult.errors) === null || _h === void 0 ? void 0 : _h.length) > 0) {
+                errors.concat(uploadAttachmentResult.errors);
+            }
+        }
+        const uploadedRecord = {
+            referenceId: osInstanceId,
+            id: newSavedSessionId,
+            success: errors.length === 0,
+            hasErrors: errors.length > 0,
+            errors,
+            warnings,
+            newName: osInstanceName,
+            skipped,
+        };
+        return uploadedRecord;
+    }
+    async migrateCreateOmniscriptSavedSession(osInstanceId, osInstanceName, osType, osSubType, osLanguage, savedSessionData) {
+        var _a, _b;
+        const errors = [];
+        let recordId = '';
+        let uploadResult;
+        try {
+            uploadResult = await net_1.NetUtils.createOne(this.connection, stringContants_1.Constants.OmniScriptSavedSessionObjectName, osInstanceId, savedSessionData);
+            if (!uploadResult.success || uploadResult.hasErrors) {
+                const errMsg = this.messages.getMessage('ossCreateOssFailure', [osInstanceName, JSON.stringify(uploadResult)]);
+                logger_1.Logger.error(errMsg);
+                errors.push(errMsg);
+            }
+            recordId = uploadResult.id || '';
+            logger_1.Logger.logVerbose(this.messages.getMessage('ossCreateOssSuccess', [recordId]));
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            const msg = this.messages.getMessage('ossCreateOssError', [osInstanceName, errorMsg]);
+            logger_1.Logger.error(msg);
+            errors.push(msg);
+        }
+        if (savedSessionData && recordId !== '') {
+            // update the Session Id's Resume Urls with its own record Id
+            // replace the URLS
+            savedSessionData['ResumeUrl'] = this.replaceResumeSessionUrl(String((_a = savedSessionData['ResumeUrl']) !== null && _a !== void 0 ? _a : ''), osType, osSubType, osLanguage, recordId);
+            savedSessionData['RelativeResumeUrl'] = this.replaceResumeSessionUrl(String((_b = savedSessionData['RelativeResumeUrl']) !== null && _b !== void 0 ? _b : ''), osType, osSubType, osLanguage, recordId);
+            // resume urls have been updated, show as debugging log
+            logger_1.Logger.debug(this.messages.getMessage('ossSessionDataShape', [JSON.stringify(savedSessionData)]));
+            try {
+                uploadResult = await net_1.NetUtils.updateOne(this.connection, stringContants_1.Constants.OmniScriptSavedSessionObjectName, osInstanceId, recordId, savedSessionData);
+                if (!uploadResult.success || uploadResult.hasErrors) {
+                    const errMsg = this.messages.getMessage('ossUpdateOssFailure', [
+                        osInstanceName,
+                        JSON.stringify(uploadResult),
+                    ]);
+                    logger_1.Logger.error(errMsg);
+                    errors.push(errMsg);
+                }
+            }
+            catch (error) {
+                const errorMsg = error instanceof Error ? error.message : String(error);
+                const msg = this.messages.getMessage('ossUpdateOssError', [osInstanceName, errorMsg]);
+                logger_1.Logger.error(msg);
+                errors.push(msg);
+            }
+        }
+        return {
+            id: recordId,
+            createOmniscriptSavedSessionSuccess: errors.length === 0,
+            errors,
+        };
+    }
+    async migrateUploadAttachments(attachments, savedSessionId, osInstanceName) {
+        var _a, _b, _c;
+        let attachmentsUploaded = 0;
+        const errors = [];
+        if (attachments.length > 0) {
+            logger_1.Logger.logVerbose(this.messages.getMessage('ossAttachmentUploadStart', [attachments.length, osInstanceName]));
+            for (const attachment of attachments) {
+                const attachmentName = String((_a = attachment['name']) !== null && _a !== void 0 ? _a : '');
+                const attachmentData = {
+                    ParentId: savedSessionId,
+                    Name: attachmentName,
+                    Body: String((_b = attachment['body']) !== null && _b !== void 0 ? _b : ''),
+                };
+                const attachmentId = String((_c = attachment['id']) !== null && _c !== void 0 ? _c : '');
+                try {
+                    const attachResult = await net_1.NetUtils.createOne(this.connection, stringContants_1.Constants.AttachmentObjectName, attachmentId, attachmentData);
+                    if (!attachResult.success || attachResult.hasErrors) {
+                        const errorMsg = this.messages.getMessage('ossAttachmentUploadFailed', [
+                            attachmentName,
+                            JSON.stringify(attachResult.errors),
+                        ]);
+                        logger_1.Logger.warn(errorMsg);
+                        errors.push(errorMsg);
+                    }
+                    else {
+                        attachmentsUploaded++;
+                        logger_1.Logger.logVerbose(this.messages.getMessage('ossAttachmentUploadSuccess', [attachmentName]));
+                    }
+                }
+                catch (error) {
+                    const errMsg = error instanceof Error ? error.message : String(error);
+                    const errorMsg = this.messages.getMessage('ossAttachmentUploadError', [attachmentName, errMsg]);
+                    logger_1.Logger.warn(errorMsg);
+                    errors.push(errorMsg);
+                }
+            }
+            logger_1.Logger.logVerbose(this.messages.getMessage('ossAttachmentUploadEnd', [attachmentsUploaded, attachments.length, osInstanceName]));
+        }
+        return {
+            attachmentUploadSuccess: attachmentsUploaded === 3,
+            errors,
+        };
+    }
+    replaceResumeSessionUrl(url, osType, osSubType, osLanguage, osInstanceId) {
+        let updatedUrl = url;
+        // not a real url
+        const urlHostTemp = 'https://migrationtool.omnistudio.salesforce.com';
+        let urlObj;
+        if (this.isAbsoluteUrl(updatedUrl)) {
+            urlObj = new URL(updatedUrl);
+        }
+        else {
+            // relative url requires a temporary host
+            urlObj = new URL(updatedUrl, urlHostTemp);
+        }
+        urlObj.searchParams.set('c__InstanceId', osInstanceId);
+        urlObj.searchParams.set('omniscript__type', osType);
+        urlObj.searchParams.set('omniscript__subType', osSubType);
+        urlObj.searchParams.set('omniscript__language', osLanguage);
+        urlObj.searchParams.delete('c__target');
+        // replace aura wrapper
+        if (urlObj.pathname.indexOf('vlocityLWCOmniWrapper') > -1) {
+            urlObj.pathname = '/lightning/page/omnistudio/omniscript';
+        }
+        if (urlObj.origin === urlHostTemp) {
+            updatedUrl = urlObj.pathname + urlObj.search;
+        }
+        else {
+            updatedUrl = urlObj.toString();
+        }
+        return updatedUrl;
+    }
+    isAbsoluteUrl(urlString) {
+        try {
+            new URL(urlString);
+            return true; // If no error, it's absolute
+        }
+        catch {
+            return false; // If error, it's relative or invalid
+        }
+    }
+    /**
+     * Query Omni Process (Core) and filter by type using QueryTools pattern
+     * Uses mappings to determine which fields to query
+     */
+    async queryOmniProcessesWithType(omniProcessTypes) {
+        const fields = ['Id', 'Name', 'Type', 'SubType', 'Language'];
+        const osTypeList = Array.from(omniProcessTypes);
+        const typeInListFilter = `Type IN (${osTypeList.map((s) => `'${s}'`).join(',')})`;
+        const filters = ['IsActive = true'];
+        let filterQuery = '';
+        if (osTypeList.length > 0) {
+            filters.push(typeInListFilter);
+            filterQuery = filters.join(' AND ');
+        }
+        else {
+            filterQuery = filters.join('');
+        }
+        /**
+         * SELECT Name, Type, SubType, Language FROM OmniProcess WHERE Type IN ('sfl','test','other') AND IsActive = true
+         */
+        const queryString = `SELECT ${fields.join(',')} 
+                        FROM ${stringContants_1.Constants.OmniProcessObjectName} 
+                        WHERE ${filterQuery}`;
+        try {
+            return await utils_1.QueryTools.queryCustom(this.connection, queryString);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            logger_1.Logger.error(this.messages.getMessage('errorOmniProcessWithTypeQuery'), error);
+            return [];
+        }
+    }
+    /**
+     * Query Omniscripts__c (Package) and filter by type using QueryTools pattern
+     * Uses mappings to determine which fields to query
+     */
+    async queryPackageOmniscriptsWithType(omniscriptTypes) {
+        var _a, _b, _c, _d;
+        const osType = String((_a = this.getOmniscriptPackageFieldKey('Type__c')) !== null && _a !== void 0 ? _a : '');
+        const osSubType = String((_b = this.getOmniscriptPackageFieldKey('SubType__c')) !== null && _b !== void 0 ? _b : '');
+        const osLanguage = String((_c = this.getOmniscriptPackageFieldKey('Language__c')) !== null && _c !== void 0 ? _c : '');
+        const osIsActive = String((_d = this.getOmniscriptPackageFieldKey('IsActive__c')) !== null && _d !== void 0 ? _d : '');
+        const fields = [osType, osSubType, osLanguage];
+        const osTypeList = Array.from(omniscriptTypes);
+        const typeInListFilter = `${osType} IN (${osTypeList.map((s) => `'${s}'`).join(',')})`;
+        const filters = [`${osIsActive} = true`];
+        let filterQuery = '';
+        if (osTypeList.length > 0) {
+            filters.push(typeInListFilter);
+            filterQuery = filters.join(' AND ');
+        }
+        else {
+            filterQuery = filters.join('');
+        }
+        /**
+         * SELECT Name, Type, SubType, Language FROM OmniProcess WHERE Type IN ('sfl','test','other') AND IsActive = true
+         */
+        const queryString = `SELECT ${fields.join(',')} 
+                        FROM ${this.namespace}__${stringContants_1.Constants.OmniscriptObjectName} 
+                        WHERE ${filterQuery}`;
+        try {
+            return await utils_1.QueryTools.queryCustom(this.connection, queryString);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            logger_1.Logger.error(this.messages.getMessage('errorOmniProcessWithTypeQuery'), error);
+            return [];
+        }
+    }
+    /**
+     * Query OmniscriptInstance__c (Package) using QueryTools pattern
+     * Uses mappings to determine which fields to query
+     */
+    async queryOmniscriptInstance() {
+        const fields = this.getQueryFields(OmniScriptInstance_1.default, false);
+        const filters = new Map();
+        // Only migrate 'In Progress' sessions
+        filters.set(this.getOmniscriptInstanceFieldKey('Status__c'), 'In Progress');
+        try {
+            return await utils_1.QueryTools.queryWithFilter(this.connection, this.getQueryNamespace(), stringContants_1.Constants.OmniScriptInstanceObjectName, fields, filters);
+        }
+        catch (err) {
+            if (err && typeof err === 'object' && 'errorCode' in err && err.errorCode === 'INVALID_TYPE') {
+                throw new interfaces_1.InvalidEntityTypeError(`${stringContants_1.Constants.OmniScriptInstanceObjectName} type is not found under this namespace`);
+            }
+            return [];
+        }
+    }
+    /**
+     * Query for all attachments with the following parent ids
+     *
+     * @param attachmentParentIds a set containing ids
+     * @returns a list of attachment records with parent ids matching the list of parent ids provided
+     */
+    async queryAttachments(attachmentParentId) {
+        const fields = ['Id', 'Name', 'Body', 'ContentType'];
+        const filterStr = `WHERE ParentId = '${attachmentParentId}'`;
+        /**
+         * SELECT Id, Name, Body, ContentType FROM Attachment WHERE ParentId = a3eSB000000DI0jYAG)
+         */
+        const queryString = `SELECT ${fields.join(',')} 
+                        FROM ${stringContants_1.Constants.AttachmentObjectName} 
+                        ${filterStr}`;
+        try {
+            return await utils_1.QueryTools.queryCustom(this.connection, queryString);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            logger_1.Logger.error(this.messages.getMessage('errorOmniProcessWithTypeQuery'), error);
+            return [];
+        }
+    }
+    async hasCustomFieldPackageSavedSessionId() {
+        const fields = ['Name', 'PackageSavedSessionId__c'];
+        /**
+         * SELECT Name, PackageSavedSessionId__c FROM OmniscriptSavedSession LIMIT 1
+         */
+        const queryString = `SELECT ${fields.join(',')} 
+                        FROM ${stringContants_1.Constants.OmniScriptSavedSessionObjectName} 
+                        LIMIT 1`;
+        try {
+            await utils_1.QueryTools.queryCustom(this.connection, queryString);
+            return true;
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            logger_1.Logger.error('Does not have PackageSavedSessionId__c', error);
+            return false;
+        }
+    }
+    /**
+     * Download attachment bodies from Salesforce
+     *
+     * @param connection - Salesforce connection instance
+     * @param attachmentBodyPaths - Array of attachment body URLs (e.g., /services/data/v67.0/sobjects/Attachment/00PSB000003DJG12AO/Body)
+     * @returns Array of downloaded attachment data with bodies and any errors
+     */
+    async downloadAttachments(attachments) {
+        var _a, _b, _c;
+        const results = [];
+        for (const attachment of attachments) {
+            const errors = [];
+            const attachmentId = String((_a = attachment['Id']) !== null && _a !== void 0 ? _a : '');
+            const attachmentName = String((_b = attachment['Name']) !== null && _b !== void 0 ? _b : '');
+            const path = String((_c = attachment['Body']) !== null && _c !== void 0 ? _c : '');
+            let body = '';
+            try {
+                const raw = await this.connection.request({
+                    method: 'GET',
+                    url: path,
+                });
+                if (typeof raw === 'object') {
+                    body = JSON.stringify(raw);
+                }
+                else if (typeof raw === 'string') {
+                    body = raw;
+                }
+                logger_1.Logger.logVerbose(this.messages.getMessage('ossAttachmentDownloadSuccess', [attachmentId, body.length]));
+            }
+            catch (error) {
+                const errorMsg = error instanceof Error ? error.message : String(error);
+                const msg = this.messages.getMessage('ossAttachmentDownloadFailed', [path, JSON.stringify(errorMsg)]);
+                logger_1.Logger.error(msg);
+                errors.push(msg);
+            }
+            results.push({
+                id: attachmentId,
+                name: attachmentName,
+                body,
+                originalPath: path,
+                errors,
+            });
+        }
+        return results;
+    }
+    /**
+     * Get field key with namespace prefix from OmniscriptInstanceMapping
+     * Uses mappings object to get the source field name, then adds namespace if needed
+     */
+    getOmniscriptInstanceFieldKey(fieldName, useStandardDataModel = false) {
+        // If fieldName is already a key in mappings, use it directly
+        if (Object.prototype.hasOwnProperty.call(OmniScriptInstance_1.default, fieldName)) {
+            if (useStandardDataModel) {
+                const mappedValue = OmniScriptInstance_1.default[fieldName];
+                return mappedValue;
+            }
+            return `${this.namespace}__${fieldName}`;
+        }
+        // Otherwise, assume it's already the correct field name
+        return fieldName;
+    }
+    getOmniscriptInstancePackageFieldKey(fieldName) {
+        return this.getOmniscriptInstanceFieldKey(fieldName, false);
+    }
+    /**
+     * Get field key with namespace prefix from OmniscriptMapping
+     * Uses mappings object to get the source field name, then adds namespace if needed
+     */
+    getOmniscriptFieldKey(fieldName, useStandardDataModel = false) {
+        // If fieldName is already a key in mappings, use it directly
+        if (Object.prototype.hasOwnProperty.call(OmniScript_1.default, fieldName)) {
+            if (useStandardDataModel) {
+                const mappedValue = OmniScript_1.default[fieldName];
+                return mappedValue;
+            }
+            return `${this.namespace}__${fieldName}`;
+        }
+        // Otherwise, assume it's already the correct field name
+        return fieldName;
+    }
+    getOmniscriptPackageFieldKey(fieldName) {
+        return this.getOmniscriptFieldKey(fieldName, false);
+    }
+    /**
+     * Get all field keys from mappings for querying
+     * Returns field names without namespace prefix - QueryTools will add it
+     */
+    getQueryFields(objectMap, useStandardDataModel) {
+        if (useStandardDataModel) {
+            return Object.values(objectMap);
+        }
+        return Object.keys(objectMap);
+    }
+    /**
+     * Returns the namespace of the managed package
+     *
+     * @param useStandardDataModel false by default
+     * @returns empty string or namespace
+     */
+    getQueryNamespace(useStandardDataModel = false) {
+        return useStandardDataModel ? '' : this.namespace;
+    }
+}
+exports.OmniScriptInstanceMigrationTool = OmniScriptInstanceMigrationTool;
+//# sourceMappingURL=omniscriptInstance.js.map