feat: add --guest flag for experience sites @W-17731639 (#396)

Author: nrkruk

command-snapshot.json

@@ -20,7 +20,7 @@
     "command": "lightning:dev:site",
     "flagAliases": [],
     "flagChars": ["l", "n", "o"],
-    "flags": ["flags-dir", "get-latest", "name", "target-org"],
+    "flags": ["flags-dir", "get-latest", "guest", "name", "target-org"],
     "plugin": "@salesforce/plugin-lightning-dev"
   }
 ]

messages/lightning.dev.site.md

@@ -25,6 +25,10 @@ Name of the Experience Builder site to preview. It has to match a site name from
 
 Download the latest version of the specified site from your org, instead of using any local cache.
 
+# flags.guest.summary
+
+Preview the site as a guest user (rather than an authenticated user).
+
 # examples
 
 - Select a site to preview from the org "myOrg":

src/commands/lightning/dev/site.ts

@@ -32,6 +32,10 @@ export default class LightningDevSite extends SfCommand<void> {
       summary: messages.getMessage('flags.get-latest.summary'),
       char: 'l',
     }),
+    guest: Flags.boolean({
+      summary: messages.getMessage('flags.guest.summary'),
+      default: false,
+    }),
   };
 
   public async run(): Promise<void> {
@@ -40,6 +44,7 @@ export default class LightningDevSite extends SfCommand<void> {
     try {
       const org = flags['target-org'];
       const getLatest = flags['get-latest'];
+      const guest = flags.guest;
       let siteName = flags.name;
 
       const connection = org.getConnection(undefined);
@@ -82,7 +87,7 @@ export default class LightningDevSite extends SfCommand<void> {
       this.log(`[local-dev] launching browser preview for: ${siteName}`);
 
       // Establish a valid access token for this site
-      const authToken = await selectedSite.setupAuth();
+      const authToken = guest ? '' : await selectedSite.setupAuth();
 
       // Start the dev server
       const port = parseInt(process.env.PORT ?? '3000', 10);