@W-19835755 - Detect custom LWC cross-namespace risks by sf-IrfanAmeeer-Shaik · Pull Request #483 · salesforcecli/plugin-omnistudio-migration-tool

sf-IrfanAmeeer-Shaik · 2026-05-15T02:58:30Z

What does this PR do?

Adds warnings for FlexCards and OmniScripts that embed custom LWCs. After migration, the auto-generated FlexCard/OmniScript LWCs keep the vertical namespace (like vlocity_ins__) but any custom LWCs inside them move to c/, which breaks at runtime with cross-reference errors.

Now the assess and migrate commands will flag these cases and suggest using omnistudio-standard-runtime-wrapper or enabling Lightning Web Security as a workaround.

What changed:

Added getLwcClassifications() in base.ts to query Tooling API and figure out which LWCs are custom vs auto-generated
Added detection logic in FlexCard and OmniScript tools to scan for embedded custom LWCs during both assessment and migration
New warning message points users to the workaround

What issues does this PR fix or reference?

Fixes W-19835755 - the Prudential cross-reference error issue where FlexCards/OmniScripts with custom LWCs fail post-migration.

Assesmode:

rajender-kumar-salesforce · 2026-05-15T05:09:39Z

  "loglevelFlagDeprecated": "loglevel is deprecated. Use --verbose instead",
-  "cleanupMetadataTablesRequired": "Omnistudio configuration tables contain records. Back up your Omnistudio component table data, and manually clean up the Omnistudio configuration tables. <a href='https://help.salesforce.com/s/articleView?id=xcloud.os_enable_omnistudio_metadata_api_support.htm&type=5' target='_blank'>Learn more about cleaning up tables in Salesforce Help</a>"
+  "cleanupMetadataTablesRequired": "Omnistudio configuration tables contain records. Back up your Omnistudio component table data, and manually clean up the Omnistudio configuration tables. <a href='https://help.salesforce.com/s/articleView?id=xcloud.os_enable_omnistudio_metadata_api_support.htm&type=5' target='_blank'>Learn more about cleaning up tables in Salesforce Help</a>",
+  "customLwcCrossNamespaceWarning": "Embeds LWC '%s' (%s). After migration the auto-generated %s LWC retains the vertical namespace while this LWC moves to c/ — cross-reference error at runtime. Workaround: use omnistudio-standard-runtime-wrapper or enable Lightning Web Security."


Is this label UX Approved ?

rajender-kumar-salesforce · 2026-05-15T05:23:31Z

+   * - 'custom': User-defined custom LWC
+   */
+  protected async getLwcClassifications(): Promise<Map<string, string>> {
+    const lwcMap = new Map<string, string>();


interface LwcBundleRecord {
DeveloperName?: string;
NamespacePrefix?: string;
}

rajender-kumar-salesforce · 2026-05-15T05:24:13Z

+    const lwcMap = new Map<string, string>();
+    try {
+      // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-call
+      const result = await (


Suggested change

const result = await (

let result = await this.connection.tooling.query<LwcBundleRecord>(

'SELECT Id, DeveloperName, NamespacePrefix FROM LightningComponentBundle'

);

const allRecords: LwcBundleRecord[] = [...(result.records ?? [])];

while (!result.done && result.nextRecordsUrl) {

result = await this.connection.tooling.queryMore<LwcBundleRecord>(result.nextRecordsUrl);

allRecords.push(...(result.records ?? []));

}

rajender-kumar-salesforce · 2026-05-15T05:28:00Z

    ];

+    // Check for cross-namespace LWC embeds
+    const lwcMap = await this.getLwcClassifications();


This will be called in loop for n number of flexcards. we can move it processCardComponents ?

rajender-kumar-salesforce · 2026-05-15T05:33:11Z

  "skippingTruncation": "Skipping truncation as the org is on standard data model.",
-  "loglevelFlagDeprecated": "loglevel is deprecated. Use --verbose instead."
+  "loglevelFlagDeprecated": "loglevel is deprecated. Use --verbose instead.",
+  "customLwcCrossNamespaceWarning": "Embeds LWC '%s' (%s). After migration the auto-generated %s LWC retains the vertical namespace while this LWC moves to c/ — cross-reference error at runtime. Workaround: use omnistudio-standard-runtime-wrapper or enable Lightning Web Security."


Same UX Approved

rajender-kumar-salesforce · 2026-05-15T05:34:02Z

+        if (ns) continue; // Skip managed packages
+
+        let kind: string;
+        if (/^cf[a-z0-9]/i.test(name)) {


can we have flexcard which is prefixed with cf and its not generated ?

There can be LWC that has cf prefix and uploaded into the org and is not a flexcard. It is not possible to have a non generated flexcard in managed package.

rajender-kumar-salesforce · 2026-05-15T05:42:43Z

+      if (!lwcName) continue;
+
+      const kind = lwcMap.get(lwcName.toLowerCase());
+      if (kind !== undefined) {


this error should be only for custom correct ?

rajender-kumar-salesforce · 2026-05-15T05:43:15Z

+
+        const lwcName: string = propertySet['lwcName'] || '';
+        const kind = lwcName ? lwcMap.get(lwcName.toLowerCase()) : undefined;
+        if (kind !== undefined) {


Same warning should be only for custom correct ?

rajender-kumar-salesforce · 2026-05-15T05:52:10Z

+    const walkChildren = (children: any[]) => {
+      for (const child of children || []) {
+        if (child.element === 'customLwc') {
+          const lwcName: string = (child.property?.customlwcname || '').toLowerCase();


Is this only path where custom lwc can be referenced ? Found these with claude. can you check it ?

rajender-kumar-salesforce · 2026-05-15T07:29:46Z

+        // Check lwcName field
+        const lwcName: string = propertySet['lwcName'] || '';
+        if (lwcName) {
+          const kind = lwcMap.get(lwcName.toLowerCase());


Code repeated multiple times. Move it to method

rajender-kumar-salesforce · 2026-05-15T07:30:05Z

+      const lwcName: string = propertySet['lwcName'] || '';
+      if (lwcName) {
+        const kind = lwcMap.get(lwcName.toLowerCase());
+        if (kind === 'custom') {


rajender-kumar-salesforce

Take Approval from UX for labels

…ming patterns

sf-kishore-kurri · 2026-05-19T05:25:04Z

  "apexClassNotFound": "Apex class \"%s\" referenced in \"%s\" does not exist in the org",
-  "cleanupMetadataTablesRequired": "Omnistudio configuration tables contain records. Back up your Omnistudio component table data, and manually clean up the Omnistudio configuration tables. <a href='https://help.salesforce.com/s/articleView?id=xcloud.os_enable_omnistudio_metadata_api_support.htm&type=5' target='_blank'>Learn more about cleaning up tables in Salesforce Help</a>"
+  "cleanupMetadataTablesRequired": "Omnistudio configuration tables contain records. Back up your Omnistudio component table data, and manually clean up the Omnistudio configuration tables. <a href='https://help.salesforce.com/s/articleView?id=xcloud.os_enable_omnistudio_metadata_api_support.htm&type=5' target='_blank'>Learn more about cleaning up tables in Salesforce Help</a>",
+  "customLwcCrossNamespaceWarning": "Embeds LWC '%s' (%s). After migration, the auto-generated %s LWC retains the vertical namespace while this LWC moves to c/, causing a cross-reference error at runtime. To resolve this, use the Omnistudio standard wrapper or enable Lightning Web Security."


is this CX reviewed?

sf-IrfanAmeeer-Shaik requested a review from a team as a code owner May 15, 2026 02:58

salesforce-cla Bot added the cla:signed label May 15, 2026

sf-IrfanAmeeer-Shaik changed the base branch from main to develop May 15, 2026 03:00

fix: add customLwcCrossNamespaceWarning message to assess.json

e5d14ef

sf-IrfanAmeeer-Shaik force-pushed the feature/w-19835755-custom-lwc-detection branch from 28392ea to e5d14ef Compare May 15, 2026 03:59

rajender-kumar-salesforce reviewed May 15, 2026

View reviewed changes

sf-IrfanAmeeer-Shaik added 2 commits May 15, 2026 00:19

refactor: enhance LWC cross-namespace detection and optimize performance

3ab070d

chore: merge develop branch and resolve conflicts

580ffd0

rajender-kumar-salesforce reviewed May 15, 2026

View reviewed changes

refactor: merge develop and apply DRY principle to LWC detection

8643238

sf-IrfanAmeeer-Shaik requested a review from rajender-kumar-salesforce May 15, 2026 15:18

rajender-kumar-salesforce approved these changes May 15, 2026

View reviewed changes

rajender-kumar-salesforce reviewed May 15, 2026

View reviewed changes

sf-IrfanAmeeer-Shaik added 2 commits May 15, 2026 11:53

fix: warn for all unmanaged LWCs to catch edge cases with reserved na…

1d3048c

…ming patterns

fix: update customLwcCrossNamespaceWarning label per CX review

ad8d7d3

sf-kishore-kurri reviewed May 19, 2026

View reviewed changes

sf-IrfanAmeeer-Shaik requested a review from sf-kishore-kurri May 19, 2026 15:00

fix: block migration for FlexCards/OmniScripts with custom LWC embeds

b1d3bde

-      const result = await (
+      let result = await this.connection.tooling.query<LwcBundleRecord>(
+        'SELECT Id, DeveloperName, NamespacePrefix FROM LightningComponentBundle'
+      );
+      const allRecords: LwcBundleRecord[] = [...(result.records ?? [])];
+      while (!result.done && result.nextRecordsUrl) {
+        result = await this.connection.tooling.queryMore<LwcBundleRecord>(result.nextRecordsUrl);
+        allRecords.push(...(result.records ?? []));
+      }

Conversation

sf-IrfanAmeeer-Shaik commented May 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What does this PR do?

What issues does this PR fix or reference?

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

rajender-kumar-salesforce left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

sf-IrfanAmeeer-Shaik commented May 15, 2026 •

edited

Loading