refactor: rename webapplication.json and meta XML references to uibundle

Rename all occurrences of webapplication.json to uibundle.json and
.webapplication-meta.xml to .uibundle-meta.xml in source code, error
messages, comments, and tests to align with the ui-bundle naming.

Author: garychangsf

src/commands/ui-bundle/dev.ts

@@ -133,7 +133,7 @@ export default class UiBundleDev extends SfCommand<WebAppDevResult> {
     intervalMs = 500,
     start = Date.now()
   ): Promise<boolean> {
-      if (await UiBundleDev.isUrlReachable(url)) {
+    if (await UiBundleDev.isUrlReachable(url)) {
       return true;
     }
     if (Date.now() - start >= timeoutMs) {
@@ -182,7 +182,7 @@ export default class UiBundleDev extends SfCommand<WebAppDevResult> {
 
     try {
       // Step 1: Discover and select webapp
-      this.logger.debug('Discovering webapplication.json manifest(s)...');
+      this.logger.debug('Discovering uibundle.json manifest(s)...');
 
       const { webapp: discoveredWebapp, allWebapps, autoSelected } = await discoverWebapp(flags.name);
 
@@ -277,7 +277,7 @@ export default class UiBundleDev extends SfCommand<WebAppDevResult> {
       const resolvedUrl = flags.url ?? manifest?.dev?.url ?? (hasDevCommand ? 'http://localhost:5173' : null);
       if (!resolvedUrl) {
         throw new SfError(
-          '❌ Unable to determine dev server URL. Specify --url or configure dev.url or dev.command in webapplication.json.',
+          '❌ Unable to determine dev server URL. Specify --url or configure dev.url or dev.command in uibundle.json.',
           'DevServerUrlError'
         );
       }
@@ -303,7 +303,7 @@ export default class UiBundleDev extends SfCommand<WebAppDevResult> {
         // dev.url in manifest but no dev.command - don't start (we can't control the port)
         throw new SfError(messages.getMessage('error.dev-url-unreachable', [resolvedUrl]), 'DevServerUrlError', [
           `Ensure your dev server is running at ${resolvedUrl}`,
-          'Or add dev.command to webapplication.json to start it automatically',
+          'Or add dev.command to uibundle.json to start it automatically',
         ]);
       } else {
         // URL not reachable - we have dev.command (or defaults) to start
@@ -372,7 +372,7 @@ export default class UiBundleDev extends SfCommand<WebAppDevResult> {
 
           const suggestions: string[] = [
             'The dev server may be taking longer than expected to start',
-            'Check if the dev server command is correct in webapplication.json',
+            'Check if the dev server command is correct in uibundle.json',
             `Try running the command manually to see the error: ${devCommand}`,
           ];
           const devError =
@@ -403,7 +403,7 @@ export default class UiBundleDev extends SfCommand<WebAppDevResult> {
       // Ensure devServerUrl is set (should always be set by step 3)
       if (!devServerUrl) {
         throw new SfError(
-          '❌ Unable to determine dev server URL. Please specify --url or configure dev.url in webapplication.json.',
+          '❌ Unable to determine dev server URL. Please specify --url or configure dev.url in uibundle.json.',
           'DevServerUrlError'
         );
       }

src/config/ManifestWatcher.ts

@@ -38,8 +38,8 @@ export type ManifestChangeEvent = {
  */
 type ManifestWatcherOptions = {
   /**
-   * Path to the webapplication.json manifest file
-   * Defaults to webapplication.json in the current working directory
+   * Path to the uibundle.json manifest file
+   * Defaults to uibundle.json in the current working directory
    */
   manifestPath?: string;
 
@@ -66,10 +66,10 @@ type ManifestWatcherEvents = {
 };
 
 /**
- * ManifestWatcher loads and monitors the webapplication.json manifest file
+ * ManifestWatcher loads and monitors the uibundle.json manifest file
  *
  * Features:
- * - Loads webapplication.json from project root
+ * - Loads uibundle.json from project root
  * - Watches for file changes and emits events
  * - Provides helpful error messages
  * - Supports hot-reload without restarting the proxy
@@ -87,7 +87,7 @@ export class ManifestWatcher extends EventEmitter {
     super();
 
     this.options = {
-      manifestPath: options.manifestPath ?? join(process.cwd(), 'webapplication.json'),
+      manifestPath: options.manifestPath ?? join(process.cwd(), 'uibundle.json'),
       watch: options.watch ?? true,
       debounceMs: options.debounceMs ?? 300,
     };
@@ -175,8 +175,8 @@ export class ManifestWatcher extends EventEmitter {
         });
         this.emit(
           'error',
-          new SfError('webapplication.json was deleted', 'ManifestRemovedError', [
-            'Recreate the webapplication.json file to continue',
+          new SfError('uibundle.json was deleted', 'ManifestRemovedError', [
+            'Recreate the uibundle.json file to continue',
           ])
         );
       } else {
@@ -208,10 +208,10 @@ export class ManifestWatcher extends EventEmitter {
   private loadManifest(): void {
     // Check if file exists
     if (!existsSync(this.options.manifestPath)) {
-      throw new SfError(`webapplication.json not found at ${this.options.manifestPath}`, 'ManifestNotFoundError', [
+      throw new SfError(`uibundle.json not found at ${this.options.manifestPath}`, 'ManifestNotFoundError', [
         'Make sure you are in the correct directory',
-        'Create a webapplication.json file in your project root',
-        'Check that the file is named exactly "webapplication.json"',
+        'Create a uibundle.json file in your project root',
+        'Check that the file is named exactly "uibundle.json"',
       ]);
     }
 
@@ -221,7 +221,7 @@ export class ManifestWatcher extends EventEmitter {
       rawContent = readFileSync(this.options.manifestPath, 'utf-8');
     } catch (error) {
       throw new SfError(
-        `Failed to read webapplication.json: ${error instanceof Error ? error.message : String(error)}`,
+        `Failed to read uibundle.json: ${error instanceof Error ? error.message : String(error)}`,
         'ManifestReadError',
         ['Check file permissions', 'Ensure the file is not locked by another process']
       );
@@ -232,7 +232,7 @@ export class ManifestWatcher extends EventEmitter {
     try {
       parsed = JSON.parse(rawContent) as WebAppManifest;
     } catch (error) {
-      throw new SfError(`Invalid JSON in webapplication.json: ${(error as Error).message}`, 'ManifestParseError', [
+      throw new SfError(`Invalid JSON in uibundle.json: ${(error as Error).message}`, 'ManifestParseError', [
         'Check for missing commas or brackets',
         'Validate JSON syntax using a JSON validator',
         'Common issues: trailing commas, unquoted keys, single quotes instead of double quotes',
@@ -272,7 +272,7 @@ export class ManifestWatcher extends EventEmitter {
       this.emit(
         'error',
         new SfError(`File watcher error: ${error.message}`, 'ManifestWatcherError', [
-          'The webapplication.json file watcher encountered an error',
+          'The uibundle.json file watcher encountered an error',
           'You may need to restart the command',
         ])
       );

src/config/manifest.ts

@@ -39,7 +39,7 @@ export type DevConfig = {
 };
 
 /**
- * WebApp manifest configuration - defines the structure of webapplication.json file
+ * WebApp manifest configuration - defines the structure of uibundle.json file
  * Extended from @salesforce/webapp-experimental with plugin-specific fields
  */
 export type WebAppManifest = BaseWebAppManifest & {

src/config/webappDiscovery.ts

@@ -22,7 +22,7 @@ import type { WebAppManifest } from './manifest.js';
 const logger = Logger.childFromRoot('WebappDiscovery');
 
 /**
- * Default command to run when no webapplication.json manifest is found
+ * Default command to run when no uibundle.json manifest is found
  */
 export const DEFAULT_DEV_COMMAND = 'npm run dev';
 
@@ -35,7 +35,7 @@ const WEBAPPLICATIONS_RELATIVE_PATH = 'main/default/uiBundles';
 /**
  * Pattern to match webapplication metadata XML files
  */
-const WEBAPP_META_XML_PATTERN = /^(.+)\.webapplication-meta\.xml$/;
+const WEBAPP_META_XML_PATTERN = /^(.+)\.uibundle-meta\.xml$/;
 
 /**
  * Discovered webapp with its directory path and optional manifest
@@ -45,15 +45,15 @@ export type DiscoveredWebapp = {
   path: string;
   /** Relative path from cwd to the webapp directory */
   relativePath: string;
-  /** Parsed manifest content (null if no webapplication.json found) */
+  /** Parsed manifest content (null if no uibundle.json found) */
   manifest: WebAppManifest | null;
-  /** Webapp name (from .webapplication-meta.xml or folder name) */
+  /** Webapp name (from .uibundle-meta.xml or folder name) */
   name: string;
-  /** Whether this webapp has a webapplication.json manifest file */
+  /** Whether this webapp has a uibundle.json manifest file */
   hasManifest: boolean;
   /** Path to the manifest file (null if no manifest) */
   manifestPath: string | null;
-  /** Whether this webapp has a .webapplication-meta.xml file (valid SFDX webapp) */
+  /** Whether this webapp has a .uibundle-meta.xml file (valid SFDX webapp) */
   hasMetaXml: boolean;
 };
 
@@ -81,7 +81,7 @@ function isWebapplicationsFolder(folderName: string): boolean {
 }
 
 /**
- * Check if a directory contains a {name}.webapplication-meta.xml file
+ * Check if a directory contains a {name}.uibundle-meta.xml file
  * Returns the webapp name extracted from the filename, or null if not found.
  * Logs a warning if multiple metadata files are found (uses first match).
  */
@@ -103,7 +103,7 @@ async function findWebappMetaXml(dirPath: string): Promise<string | null> {
 
     if (matches.length > 1) {
       logger.warn(
-        `Multiple .webapplication-meta.xml files found in ${dirPath}: ${matches.join(', ')}. Using "${matches[0]}".`
+        `Multiple .uibundle-meta.xml files found in ${dirPath}: ${matches.join(', ')}. Using "${matches[0]}".`
       );
     }
 
@@ -126,7 +126,7 @@ async function pathExists(path: string): Promise<boolean> {
 }
 
 /**
- * Try to parse a webapplication.json file.
+ * Try to parse a uibundle.json file.
  * Accepts any valid JSON object - missing fields will use defaults.
  */
 async function tryParseWebappManifest(filePath: string): Promise<WebAppManifest | null> {
@@ -150,7 +150,7 @@ async function tryParseWebappManifest(filePath: string): Promise<WebAppManifest
  * Manifest does not have a name property - do not depend on it.
  *
  * @param folderName - The folder name (fallback)
- * @param metaXmlName - Name extracted from .webapplication-meta.xml (or null)
+ * @param metaXmlName - Name extracted from .uibundle-meta.xml (or null)
  * @returns The resolved webapp name
  */
 function resolveWebappName(folderName: string, metaXmlName: string | null): string {
@@ -266,12 +266,12 @@ function findWebapplicationsFolderUpward(
 
 /**
  * Discover all webapps inside the uiBundles folder.
- * Only directories containing a {name}.webapplication-meta.xml file are considered valid webapps.
- * If a webapplication.json exists, use it for dev configuration.
+ * Only directories containing a {name}.uibundle-meta.xml file are considered valid webapps.
+ * If a uibundle.json exists, use it for dev configuration.
  *
  * @param webappsFolderPath - Absolute path to the uiBundles folder
  * @param cwd - Original working directory for relative path calculation
- * @returns Array of discovered webapps (only those with .webapplication-meta.xml)
+ * @returns Array of discovered webapps (only those with .uibundle-meta.xml)
  */
 async function discoverWebappsInFolder(webappsFolderPath: string, cwd: string): Promise<DiscoveredWebapp[]> {
   try {
@@ -284,15 +284,15 @@ async function discoverWebappsInFolder(webappsFolderPath: string, cwd: string):
     const webappPromises = webappDirs.map(async (entry): Promise<DiscoveredWebapp | null> => {
       const webappPath = join(webappsFolderPath, entry.name);
 
-      // Check for .webapplication-meta.xml file - this identifies valid webapps
+      // Check for .uibundle-meta.xml file - this identifies valid webapps
       const metaXmlName = await findWebappMetaXml(webappPath);
 
-      // Only include directories that have a .webapplication-meta.xml file
+      // Only include directories that have a .uibundle-meta.xml file
       if (!metaXmlName) {
         return null;
       }
 
-      const manifestFilePath = join(webappPath, 'webapplication.json');
+      const manifestFilePath = join(webappPath, 'uibundle.json');
 
       // Try to load manifest for dev configuration
       const manifest = await tryParseWebappManifest(manifestFilePath);
@@ -310,7 +310,7 @@ async function discoverWebappsInFolder(webappsFolderPath: string, cwd: string):
 
     const results = await Promise.all(webappPromises);
 
-    // Filter out null results (directories without .webapplication-meta.xml)
+    // Filter out null results (directories without .uibundle-meta.xml)
     return results.filter((webapp): webapp is DiscoveredWebapp => webapp !== null);
   } catch {
     // Permission denied or other read error
@@ -338,7 +338,7 @@ type FindAllWebappsResult = {
  * Discovery strategy (in order):
  * 1. Check if inside a uiBundles/<webapp> directory (upward search)
  * 2. Check for SFDX project and search uiBundles in all package directories
- * 3. If neither, check if current directory is a webapp (has .webapplication-meta.xml)
+ * 3. If neither, check if current directory is a webapp (has .uibundle-meta.xml)
  *
  * @param cwd - Directory to search from (defaults to process.cwd())
  * @returns Object with discovered webapps and context information
@@ -379,12 +379,12 @@ async function findAllWebapps(cwd: string = process.cwd()): Promise<FindAllWebap
   }
 
   // Step 3: If no uiBundles folder found, check if current directory IS a webapp
-  // (has a .webapplication-meta.xml file) - for running outside SFDX project context
+  // (has a .uibundle-meta.xml file) - for running outside SFDX project context
   if (!webappsFolder) {
     const metaXmlName = await findWebappMetaXml(cwd);
     if (metaXmlName) {
       // Current directory is a standalone webapp
-      const manifestFilePath = join(cwd, 'webapplication.json');
+      const manifestFilePath = join(cwd, 'uibundle.json');
       const manifest = await tryParseWebappManifest(manifestFilePath);
       const webappName = resolveWebappName(basename(cwd), metaXmlName);
 
@@ -444,14 +444,14 @@ export type DiscoverWebappResult = {
  *
  * Discovery use cases:
  * 1. SFDX Project Root: Search uiBundles in all package directories
- * - Webapps identified by {name}.webapplication-meta.xml
+ * - Webapps identified by {name}.uibundle-meta.xml
  * - Always prompt for selection (even if only 1 webapp)
  *
  * 2. Inside uiBundles/<webapp> directory:
  * - Auto-select current webapp
  * - Error if --name conflicts with current directory
  *
- * 3. Outside SFDX project with .webapplication-meta.xml in current dir:
+ * 3. Outside SFDX project with .uibundle-meta.xml in current dir:
  * - Use current directory as standalone webapp
  *
  * @param name - Optional webapp name to search for (--name flag)
@@ -468,15 +468,15 @@ export async function discoverWebapp(
   // No webapps found
   if (allWebapps.length === 0) {
     if (webappsFolderFound) {
-      // Folder exists but no valid webapps (no .webapplication-meta.xml files)
+      // Folder exists but no valid webapps (no .uibundle-meta.xml files)
       throw new SfError(
         'Found "uiBundles" folder but no valid webapps inside it.\n' +
-          'Each webapp must have a {name}.webapplication-meta.xml file.\n\n' +
+          'Each webapp must have a {name}.uibundle-meta.xml file.\n\n' +
           'Expected structure:\n' +
           '  uiBundles/\n' +
           '    └── my-app/\n' +
-          '        ├── my-app.webapplication-meta.xml  (required)\n' +
-          '        └── webapplication.json             (optional, for dev config)',
+          '        ├── my-app.uibundle-meta.xml  (required)\n' +
+          '        └── uibundle.json             (optional, for dev config)',
         'WebappNotFoundError'
       );
     } else if (inSfdxProject) {
@@ -486,8 +486,8 @@ export async function discoverWebapp(
           'Create the folder structure in any package directory (e.g. force-app, packages/my-pkg):\n' +
           '  <package-path>/main/default/uiBundles/\n' +
           '    └── my-app/\n' +
-          '        ├── my-app.webapplication-meta.xml  (required)\n' +
-          '        └── webapplication.json             (optional, for dev config)',
+          '        ├── my-app.uibundle-meta.xml  (required)\n' +
+          '        └── uibundle.json             (optional, for dev config)',
         'WebappNotFoundError'
       );
     } else {
@@ -497,7 +497,7 @@ export async function discoverWebapp(
           'To use this command, either:\n' +
           '1. Run from an SFDX project with webapps in <package>/main/default/uiBundles/\n' +
           '2. Run from inside a uiBundles/<webapp>/ directory\n' +
-          '3. Run from a directory containing a {name}.webapplication-meta.xml file',
+          '3. Run from a directory containing a {name}.uibundle-meta.xml file',
         'WebappNotFoundError'
       );
     }

src/server/DevServerManager.ts

@@ -359,7 +359,7 @@ export class DevServerManager extends EventEmitter {
     this.logger.error(`Dev server process error: ${error.message}`);
 
     const sfError = new SfError(`❌ Dev server process error: ${error.message}`, 'DevServerProcessError', [
-      'Check that the command is correct in webapplication.json',
+      'Check that the command is correct in uibundle.json',
       'Verify all dependencies are installed',
       'Try running the command manually to see the error',
     ]);

test/config/ManifestWatcher.test.ts

@@ -25,7 +25,7 @@ import type { WebAppManifest, ManifestChangeEvent } from '../../src/config/types
 describe('ManifestWatcher', () => {
   const $$ = new TestContext();
   const testDir = join(process.cwd(), '.test-manifests');
-  const testManifestPath = join(testDir, 'webapplication.json');
+  const testManifestPath = join(testDir, 'uibundle.json');
 
   const validManifest: WebAppManifest = {
     name: 'testApp',
@@ -90,7 +90,7 @@ describe('ManifestWatcher', () => {
       } catch (error) {
         expect(error).to.be.instanceOf(SfError);
         expect((error as SfError).name).to.equal('ManifestNotFoundError');
-        expect((error as SfError).message).to.include('webapplication.json not found');
+        expect((error as SfError).message).to.include('uibundle.json not found');
         expect((error as SfError).actions).to.exist;
       }
 
@@ -125,7 +125,7 @@ describe('ManifestWatcher', () => {
 
     it('should handle read permission errors', async () => {
       // Create a file path that doesn't exist to simulate read error
-      const invalidPath = join(testDir, 'nonexistent', 'webapplication.json');
+      const invalidPath = join(testDir, 'nonexistent', 'uibundle.json');
 
       const watcher = new ManifestWatcher({ manifestPath: invalidPath, watch: false });
 
@@ -431,8 +431,8 @@ describe('ManifestWatcher', () => {
   });
 
   describe('Default Options', () => {
-    it('should use webapplication.json in current directory by default', async () => {
-      const defaultPath = join(process.cwd(), 'webapplication.json');
+    it('should use uibundle.json in current directory by default', async () => {
+      const defaultPath = join(process.cwd(), 'uibundle.json');
 
       // Create manifest in current directory
       writeFileSync(defaultPath, JSON.stringify(validManifest, null, 2));