feat: add flag for getting the latest version of a experience site / bug fixes

Author: nrkruk

LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2024, Salesforce.com, Inc.
+Copyright (c) 2025, Salesforce.com, Inc.
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

messages/lightning.dev.site.md

@@ -1,6 +1,6 @@
 # summary
 
-Preview an Experience Builder site locally and in real-time, without deploying it.
+[Beta] Preview an Experience Builder site locally and in real-time, without deploying it.
 
 # description
 
@@ -21,7 +21,15 @@ For more considerations and limitations, see the Lightning Web Components Develo
 
 Name of the Experience Builder site to preview. It has to match a site name from the current org.
 
+# flags.get-latest.summary
+
+Download the latest version of the specified site from your org, instead of using any local cache.
+
 # examples
 
+- Select a site to preview from the org "myOrg":
+  <%= config.bin %> <%= command.id %> --target-org myOrg
 - Preview the site "Partner Central" from the org "myOrg":
   <%= config.bin %> <%= command.id %> --name "Partner Central" --target-org myOrg
+- Get and preview the latest version of the "Partner Central" site from the org "myOrg"
+  <%= config.bin %> <%= command.id %> --name "Partner Central" --target-org myOrg --get-latest

messages/prompts.md

@@ -1,6 +1,6 @@
 # site.select
 
-Select a site
+Which Experience Cloud Site would you like to preview (Use arrow keys)
 
 # site.confirm-update
 

package.json

@@ -9,7 +9,7 @@
     "@inquirer/select": "^2.4.7",
     "@lwc/lwc-dev-server": "^11.1.0",
     "@lwc/sfdc-lwc-compiler": "^11.1.0",
-    "@lwrjs/api": "0.15.6",
+    "@lwrjs/api": "0.16.2",
     "@oclif/core": "^4.1.0",
     "@salesforce/core": "^8.6.2",
     "@salesforce/kit": "^3.1.6",

src/commands/lightning/dev/site.ts

@@ -28,6 +28,10 @@ export default class LightningDevSite extends SfCommand<void> {
       char: 'n',
     }),
     'target-org': Flags.requiredOrg(),
+    'get-latest': Flags.boolean({
+      summary: messages.getMessage('flags.get-latest.summary'),
+      char: 'l',
+    }),
   };
 
   public async run(): Promise<void> {
@@ -69,7 +73,7 @@ export default class LightningDevSite extends SfCommand<void> {
             // delete oldSitePath recursive
             const oldSitePath = selectedSite.getExtractDirectory();
             if (fs.existsSync(oldSitePath)) {
-              fs.rmdirSync(oldSitePath, { recursive: true });
+              fs.rmSync(oldSitePath, { recursive: true });
             }
           }
         }

src/shared/experience/expSite.ts

@@ -289,7 +289,9 @@ export class ExperienceSite {
     }
     const resourcePath = this.getSiteZipPath(metadata);
     try {
-      const apiUrl = `${instanceUrl}/services/data/v63.0/sites/${siteIdMinus3}/preview`;
+      // Limit API to published sites for now until we have a patch for the issues with unpublished sites
+      // TODO set the api version dynamically based on CLI input
+      const apiUrl = `${instanceUrl}/services/data/v63.0/sites/${siteIdMinus3}/preview?published`;
       const response = await axios.get(apiUrl, {
         headers: {
           Authorization: `Bearer ${accessToken}`,

src/shared/promptUtils.ts

@@ -21,7 +21,7 @@ const messages = Messages.loadMessages('@salesforce/plugin-lightning-dev', 'prom
 
 export class PromptUtils {
   public static async promptUserToSelectSite(sites: string[]): Promise<string> {
-    const choices = sites.map((site) => ({ value: site }));
+    const choices = sites.sort((a, b) => a.localeCompare(b)).map((site) => ({ value: site }));
     const response = await select({
       message: messages.getMessage('site.select'),
       choices,