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

package/lib/migration/deployer.js

@@ -0,0 +1,105 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Deployer = void 0;
+const path = __importStar(require("path"));
+const shell = __importStar(require("shelljs"));
+const sfProject_1 = require("../utils/sfcli/project/sfProject");
+const logger_1 = require("../utils/logger");
+const omniscriptPackageManager_1 = require("../utils/omniscriptPackageManager");
+const deploymentErrors_1 = require("../error/deploymentErrors");
+class Deployer {
+    constructor(projectPath, messages, username, authKey) {
+        this.omniscriptCustomizationPackage = '@omnistudio/omniscript_customization';
+        this.omniscriptCustomizationPackageVersion = '250.0.0';
+        this.projectPath = projectPath;
+        this.username = username;
+        this.messages = messages;
+        this.authKey = authKey;
+        // Configure omniscript package settings
+        this.omniscriptPackageConfig = {
+            packageName: this.omniscriptCustomizationPackage,
+            version: this.omniscriptCustomizationPackageVersion,
+        };
+    }
+    async deploy() {
+        const pwd = shell.pwd();
+        shell.cd(this.projectPath);
+        try {
+            // Install dependencies including omniscript customization package
+            if (this.authKey) {
+                sfProject_1.sfProject.createNPMConfigFile(this.authKey);
+                logger_1.Logger.logVerbose(this.messages.getMessage('installingRequiredDependencies'));
+                sfProject_1.sfProject.installDependency();
+                sfProject_1.sfProject.installDependency(`${this.omniscriptCustomizationPackage}@${this.omniscriptCustomizationPackageVersion}`);
+                // Deploy omniscript customization package separately first
+                await this.deployOmniscriptPackage();
+            }
+            // Deploy the main project after omniscript package deployment succeeds
+            logger_1.Logger.log(path.join(pwd.toString(), 'package.xml'));
+            sfProject_1.sfProject.deployFromManifest(path.join(pwd.toString(), 'package.xml'), this.username);
+        }
+        finally {
+            shell.cd(pwd);
+        }
+    }
+    async deployOmniscriptPackage() {
+        try {
+            this.omniscriptPackageManager = new omniscriptPackageManager_1.OmniscriptPackageManager(this.projectPath, this.omniscriptPackageConfig, this.username);
+            const success = await this.omniscriptPackageManager.deployPackageAsync();
+            if (success) {
+                logger_1.Logger.log(this.messages.getMessage('omniscriptPackageIntegrated'));
+            }
+            else {
+                const errorMsg = this.messages.getMessage('omniscriptPackageDeploymentFailedReturnedFalse');
+                logger_1.Logger.error(errorMsg);
+                throw new deploymentErrors_1.OmniscriptPackageDeploymentError(this.messages.getMessage('omniscriptPackageDeploymentFailedWithMessage', [errorMsg]));
+            }
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logger_1.Logger.error(this.messages.getMessage('errorIntegratingOmniscriptPackage'), error);
+            // Re-throw as OmniscriptPackageDeploymentError for consistent error handling upstream
+            if (error instanceof deploymentErrors_1.OmniscriptPackageDeploymentError) {
+                throw error;
+            }
+            else {
+                throw new deploymentErrors_1.OmniscriptPackageDeploymentError(this.messages.getMessage('omniscriptPackageDeploymentFailedWithMessage', [errorMessage]));
+            }
+        }
+    }
+}
+exports.Deployer = Deployer;
+//# sourceMappingURL=deployer.js.map

package/lib/migration/deployer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployer.js","sourceRoot":"","sources":["../../src/migration/deployer.ts"],"names":[],"mappings":"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"}

package/lib/migration/flexcard.d.ts

@@ -1,16 +1,19 @@
 import { AnyJson } from '@salesforce/ts-types';
 import { BaseMigrationTool } from './base';
-import { MigrationResult, MigrationTool, ObjectMapping } from './interfaces';
+import { MigrationResult, MigrationTool, ObjectMapping, FlexcardStorage } from './interfaces';
 import { Connection, Messages } from '@salesforce/core';
-import { UX } from '@salesforce/command';
+import { Ux } from '@salesforce/sf-plugins-core';
 import { FlexCardAssessmentInfo } from '../../src/utils';
 import { Logger } from '../utils/logger';
 export declare class CardMigrationTool extends BaseMigrationTool implements MigrationTool {
+    private readonly apexNamespaceRegistry;
     static readonly VLOCITYCARD_NAME = "VlocityCard__c";
     static readonly OMNIUICARD_NAME = "OmniUiCard";
     static readonly VERSION_PROP = "Version__c";
+    private static readonly URL_PARSE_BASE;
+    private IS_STANDARD_DATA_MODEL;
     private readonly allVersions;
-    constructor(namespace: string, connection: Connection, logger: Logger, messages: Messages, ux: UX, allVersions: boolean);
+    constructor(namespace: string, connection: Connection, logger: Logger, messages: Messages<string>, ux: Ux, allVersions: boolean);
     getName(): string;
     getRecordName(record: string): any;
     getMappings(): ObjectMapping[];
@@ -19,17 +22,264 @@ export declare class CardMigrationTool extends BaseMigrationTool implements Migr
     assess(): Promise<FlexCardAssessmentInfo[]>;
     processCardComponents(flexCards: AnyJson[]): Promise<FlexCardAssessmentInfo[]>;
     private processFlexCard;
+    /**
+     * Scan a FlexCard for two distinct kinds of namespace-bound custom CSS:
+     *
+     *  1. **StaticResource-backed stylesheet** — `Definition__c.customStyleSheet`
+     *     stores the *Name* of a Static Resource. We look it up, fetch its body,
+     *     and substring-check for the org's managed-package namespace. Same flow
+     *     and same warning message as the OmniScript implementation; resource
+     *     scans are cached by name in {@link CustomCssRegistry}, so a stylesheet
+     *     shared between OmniScripts and FlexCards is only fetched once per run.
+     *
+     *  2. **Inline CSS** — `Styles__c.customStyles` stores raw CSS text. We
+     *     substring-check the namespace directly against that string. No
+     *     SOQL/REST traffic and no caching (the CSS is per-FlexCard and not
+     *     shared across records).
+     *
+     * Both checks emit a warning into `flexCardAssessmentInfo.warnings` and bump
+     * `migrationStatus` to 'Needs manual intervention' (via
+     * `getUpdatedAssessmentStatus`, which never downgrades a stricter status).
+     */
+    private collectStylesheetNamespaceDependencies;
     private updateDependencies;
+    /**
+     * Check events array for dependencies (Assessment)
+     * Handles: events[].actionList[].stateAction references
+     */
+    private checkEventsForDependencies;
+    /**
+     * Shared helper to check if a "cf" prefixed LWC name references a FlexCard and add dependency (assessment phase)
+     * @param cfPrefixedLwcName LWC name with "cf" prefix (e.g., "cfMyFlexCard")
+     * @param flexCardAssessmentInfo Assessment info to add dependencies and warnings
+     */
+    private addCfPrefixedFlexCardDependency;
+    /**
+     * Shared helper to update a "cf" prefixed LWC name with registry (migration phase)
+     * @param cfPrefixedLwcName LWC name with "cf" prefix (e.g., "cfMyFlexCard")
+     * @returns Updated LWC name with "cf" prefix
+     */
+    private updateCfPrefixedFlexCardName;
+    /**
+     * Shared helper to check Custom LWC component for FlexCard dependencies (assessment phase)
+     * Handles customlwcname with "cf" prefix indicating FlexCard reference
+     */
+    private checkCustomLwcForDependencies;
+    /**
+     * Shared helper to update Custom LWC component with registry (migration phase)
+     * Handles customlwcname with "cf" prefix indicating FlexCard reference
+     */
+    private updateCustomLwcWithRegistry;
+    /**
+     * Shared helper to update flyoutLwc value with registry (migration phase)
+     * Handles FlexCard child cards references
+     */
+    private updateFlyoutLwcValue;
+    /**
+     * Shared helper to process stateAction.message JSON for dependencies
+     * Handles DataRaptor bundle and Integration Procedure ipMethod references
+     */
+    private processStateActionMessageForDependencies;
+    /**
+     * Shared helper to process stateAction.message JSON with registry updates
+     * Handles DataRaptor bundle and Integration Procedure ipMethod references
+     */
+    private processStateActionMessageWithRegistry;
+    private handleAssessmentForStdDataModelOrgsWithMetadataAPIEnabled;
+    private handleMigrationForStdDataModelOrgsWithMetadataAPIEnabled;
     private readChildCardsFromDefinition;
     private checkComponentForDependencies;
-    private getAllActiveCards;
+    private addOmniScriptNavigateURLAssessmentWarning;
+    /**
+     * Build the customer-facing warning shown when a Web Page action URL contains
+     * fragment tokens that decodeURIComponent couldn't parse. Centralised here so
+     * the assessment and migration paths emit byte-identical text.
+     *
+     * Returns an empty string when the helper is called with no malformed tokens
+     * (defense in depth: callers already guard, but a future caller that forgets
+     * shouldn't be able to produce a degenerate warning with an empty bracket).
+     * Non-string entries are coerced via String() so a misbehaving caller can't
+     * surface "undefined" / "[object Object]" to customers; duplicates are
+     * suppressed so a fragment like `#/Foo%/Bar/Foo%/Baz` doesn't render as
+     * `["Foo%", "Foo%"]`.
+     */
+    private formatMalformedFragmentTokenWarning;
+    private getAllCards;
     private uploadAllCards;
     private uploadCard;
-    private addToAssessmentStorage;
+    private prepareStorageForRelatedObjectsWhenMetadataAPIEnabled;
+    private prepareAssessmentStorageForFlexcards;
+    private addKeyToStorage;
+    private markDuplicateKeyInStorage;
+    isDifferentFlexcard(storedValue: FlexcardStorage, originalName: string): boolean;
     private prepareStorageForFlexcards;
     private getChildCards;
     private updateChildCards;
     private mapVlocityCardRecord;
-    private fixChildren;
+    /**
+     * Comprehensive dependency update using NameMappingRegistry - mirrors assessment logic
+     */
+    private updateAllDependenciesWithRegistry;
+    /**
+     * Update events array references (Migration)
+     * Handles: events[].actionList[].stateAction references
+     */
+    private updateEventsWithRegistry;
+    /**
+     * Update dataSource (DataRaptor, Integration Procedures, Apex Remote) using registry
+     */
+    private updateDataSourceWithRegistry;
+    /**
+     * Update OmniScript reference using registry
+     */
+    private updateOmniScriptReferenceWithRegistry;
+    /**
+     * Update component dependencies comprehensively
+     */
+    private updateComponentDependenciesWithRegistry;
+    private applyOmniScriptURLRewrite;
+    /** Build a human-readable "before -> after" string for warning messages only. */
+    private formatURLRewriteSummary;
+    /**
+     * Decode a URL for DISPLAY purposes only (warning/log messages). The output
+     * is lossy with respect to URL parsing semantics (e.g. an encoded `%26`
+     * becomes a literal `&`) and must NOT be re-fed into a URL parser. Falls
+     * back to the raw input on malformed percent sequences.
+     */
+    private toReadableURL;
+    private getOmniScriptURLRewrite;
+    private isCustomWebPageAction;
+    /**
+     * Parse a URL string without throwing. Returns the parsed URL on success or
+     * undefined for:
+     *   - syntactically invalid input (e.g. `https://[bad`, raw spaces in host,
+     *     `http:///` with no host), or
+     *   - URLs whose scheme is not `http:` or `https:` (e.g. `javascript:`,
+     *     `data:`, `file:`, `mailto:`).
+     *
+     * See URL_PARSE_BASE for why a synthetic base is supplied.
+     */
+    private tryParseURL;
+    /**
+     * Verify a parsed URL has the OmniScript Navigate shape. We validate against
+     * the parsed components (pathname / searchParams / hash) rather than doing
+     * substring matches on the raw input so callers cannot smuggle the required
+     * tokens in unrelated positions (e.g. inside another query value).
+     *
+     * The pathname must START WITH `/apex/` and contain the universal-page
+     * token. Anchoring to the prefix rejects non-http(s) schemes such as
+     * `javascript:alert(1)//apex/...` whose parsed pathname does not begin
+     * with `/` (it begins with the opaque body of the scheme).
+     *
+     * Two legitimate shapes are accepted:
+     *   1. Path + query:    /apex/<ns>__OmniScriptUniversalPage?OmniScriptType=...&OmniScriptSubType=...&OmniScriptLang=...
+     *   2. Path + fragment: /apex/<ns>__OmniScriptUniversalPage?...#/OmniScriptType/.../OmniScriptSubType/.../OmniScriptLang/...
+     */
+    private isValidOmniScriptNavigationURL;
+    private convertToStandardOmniScriptURL;
+    /**
+     * Parse a slash-separated OmniScript fragment of the form
+     *   #/Key1/Value1/Key2/Value2/...
+     * into [key, value] pairs. Tolerates leading `#`, leading `/`, empty values
+     * (consecutive slashes), and a trailing orphan token (which is dropped).
+     *
+     * Tokens with malformed percent sequences (e.g. `Foo%`, `Bar%E2`) are kept
+     * as-is rather than throwing; decodeURIComponent raises URIError on invalid
+     * escape sequences and we don't want one bad token to crash the whole
+     * FlexCard's URL rewrite. The raw (still-encoded) tokens are also returned
+     * via `malformedTokens` so callers can surface them to customers as a
+     * "please verify" warning rather than silently shipping a best-effort guess.
+     */
+    private parseSlashFragmentParams;
+    /**
+     * Update omniType.Name using registry (handles Type/SubType/Language format)
+     */
+    private updateOmniTypeNameWithRegistry;
+    /**
+     * Update osName using registry (handles Type/SubType/Language format)
+     */
+    private updateOsNameWithRegistry;
+    /**
+     * Helper method to add OmniScript dependency and warnings during assessment
+     * Handles osName in format "Type/SubType/Language" or "Type/SubType"
+     * @param osName - OmniScript name in format "Type/SubType" or "Type/SubType/Language"
+     * @param flexCardAssessmentInfo - Assessment info to update
+     */
+    private addOmniScriptDependency;
+    /**
+     * Helper method to add OmniScript dependency from type/subtype/language fields
+     * @param type - OmniScript type
+     * @param subtype - OmniScript subtype
+     * @param language - OmniScript language (defaults to 'English')
+     * @param flexCardAssessmentInfo - Assessment info to update
+     */
+    private addOmniScriptDependencyFromParts;
+    /**
+     * Helper method to add DataRaptor dependency and warnings during assessment
+     * @param bundle - DataRaptor bundle name
+     * @param flexCardAssessmentInfo - Assessment info to update
+     */
+    private addDataRaptorDependency;
+    /**
+     * Helper method to add Integration Procedure dependency and warnings during assessment
+     * @param ipMethod - Integration Procedure method name (Type_SubType format)
+     * @param flexCardAssessmentInfo - Assessment info to update
+     */
+    private addIntegrationProcedureDependency;
+    /**
+     * Helper method to add FlexCard dependency and warnings during assessment
+     * @param cardName - FlexCard name
+     * @param flexCardAssessmentInfo - Assessment info to update
+     */
+    private addFlexCardDependency;
+    /**
+     * Helper method to flag a Vlocity Action dependency during assessment.
+     * Vlocity Actions are not supported in standard runtime FlexCards, so the
+     * FlexCard cannot be auto-migrated and must be manually reimplemented using
+     * the FlexCard Action (cardAction) feature.
+     */
+    private addVlocityActionDependency;
     private getCardFields;
+    private getFieldKey;
+    private getQueryNamespace;
+    private getCardObjectName;
+    /**
+     * Check if a FlexCard has dependencies on Angular OmniScripts
+     */
+    private hasAngularOmniScriptDependencies;
+    /**
+     * Check if events array has Angular OmniScript dependencies
+     */
+    private eventsHaveAngularOmniScriptDependency;
+    private hasOmniscriptFlyoutDependency;
+    private hasFlexCardFlyoutDependency;
+    private hasCustomLwcFlyoutDependency;
+    private hasFlyoutLwc;
+    /**
+     * Recursively check if a component has Angular Omniscript dependencies
+     */
+    private componentHasAngularOmniScriptDependency;
+    /**
+     * Check if an omniType references an Angular OmniScript
+     * Handles both string format and object with Name property
+     */
+    private checkOmniTypeForAngular;
+    /**
+     * Check if an osName string references an Angular OmniScript
+     * Handles Type/SubType/Language format in string
+     */
+    private checkOsNameForAngular;
+    /**
+     * Ensures that the FlexCard Definition includes required Lightning Community targets
+     * Adds "lightningCommunity__Page" and "lightningCommunity__Default" if missing
+     * This is needed as vlocity wrapper can have flexcard which is unpublished but omniwapper needs published card
+     */
+    private ensureCommunityTargets;
+    /**
+     * Prioritizes FlexCards 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 prioritizeFlexCardsWithoutSpecialCharacters;
 }