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

package/lib/migration/flexcard.d.ts

@@ -6,9 +6,11 @@ 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<string>, ux: Ux, allVersions: boolean);
@@ -20,6 +22,26 @@ 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)
@@ -67,6 +89,21 @@ export declare class CardMigrationTool extends BaseMigrationTool implements Migr
     private handleMigrationForStdDataModelOrgsWithMetadataAPIEnabled;
     private readChildCardsFromDefinition;
     private checkComponentForDependencies;
+    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;
@@ -100,6 +137,60 @@ export declare class CardMigrationTool extends BaseMigrationTool implements Migr
      * 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)
      */
@@ -141,6 +232,13 @@ export declare class CardMigrationTool extends BaseMigrationTool implements Migr
      * @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;