@salesforce/plugin-templates 57.6.0 → 57.7.0

package/README.md

@@ -7,15 +7,15 @@ This repository provides a series of commands, templates, and generators for var
 
 # Getting Started
 
-To use, install the [Salesforce CLI](https://developer.salesforce.com/tools/sfdxcli) and run the following commands.
+To use, install the [Salesforce CLI](https://developer.salesforce.com/tools/salesforcecli) and run the following commands.
 
 ```
 Verify the CLI is installed
-  $ sfdx (-v | --version)
+  $ sf (-v | --version)
 Install the @salesforce/plugin-templates plugin
-  $ sfdx plugins:install @salesforce/plugin-templates
+  $ sf plugins install @salesforce/plugin-templates
 To run a command
-  $ sfdx [command]
+  $ sf [command]
 ```
 
 ## Install
@@ -29,8 +29,7 @@ git clone git@github.com:salesforcecli/plugin-templates.git
 2. Ensure you have [Yarn](https://yarnpkg.com/) installed and run the following to build:
 
 ```
-yarn install
-yarn build
+yarn && yarn build
 ```
 
 ## Issues
@@ -39,18 +38,7 @@ Please report any issues to https://github.com/salesforcecli/plugin-templates/is
 
 ## Contributing
 
-1. Familiarize yourself with the codebase by reading the docs and the templates [library](https://github.com/salesforcecli/plugin-templates).
-   - If you're adding a new template generator, see the [Development Guide](./DEVELOPMENT.md) for detailed instructions.
-1. Create a new issue before starting your project so that we can keep track of
-   what you're trying to add/fix. That way, we can also offer suggestions or
-   let you know if there is already an effort in progress.
-1. Fork this repository.
-1. The [build](#build) section has details on how to set up your environment.
-1. Create a _topic_ branch in your fork based on the correct branch (usually the **main** branch). Note: this step is recommended but technically not required if contributing using a fork.
-1. Edit the code in your fork.
-1. Sign CLA (see [CLA](#cla)).
-1. Send us a pull request when you're done. We'll review your code, suggest any
-   needed changes, and merge it in.
+If you're interested in contributing, take a look at the [CONTRIBUTING](CONTRIBUTING.md) guide.
 
 ## Pull Requests
 
@@ -69,22 +57,22 @@ Agreement. You can do so by going to https://cla.salesforce.com/sign-cla.
 
 ## Developing Plugin
 
-To test plugin locally, use `bin/dev` in place of `sfdx`. For example:
+To test plugin locally, use `bin/dev.js` in place of `sf`. For example:
 
 ```sh
-./bin/dev force:apex:class:create --classname 'TestClass' --template 'DefaultApexClass' --outputdir ./testsoutput/myApex/
+./bin/dev.js force:apex:class:create --classname 'TestClass' --template 'DefaultApexClass' --outputdir ./testsoutput/myApex/
 ```
 
 Link your plugin to Salesforce CLI:
 
 ```sh
-sfdx plugins:link .
+sf plugins link .
 ```
 
 Verify plugin is linked:
 
 ```sh
-sfdx plugins
+sf plugins
 ```
 
 To test plugin locally with Salesforce CLI, add `"@salesforce/plugin-templates": "file://path/to/plugin-templates"` to the plugin's `package.json`.
@@ -98,13 +86,13 @@ To debug the `hello:org` command:
 1. If you linked your plugin to the Salesforce CLI, call your command with the `dev-suspend` switch:
 
 ```sh-session
-$ sfdx hello:org -u myOrg@example.com --dev-suspend
+$ sf hello:org -u myOrg@example.com --dev-suspend
 ```
 
 Alternatively, to call your command using the `bin/dev` script, set the `NODE_OPTIONS` environment variable to `--inspect-brk` when starting the debugger:
 
 ```sh-session
-$ NODE_OPTIONS=--inspect-brk ./bin/dev force:apex:class:create --classname 'TestClass' --template 'DefaultApexClass' --outputdir ./testsoutput/myApex/
+$ NODE_OPTIONS=--inspect-brk ./bin/dev.js force:apex:class:create --classname 'TestClass' --template 'DefaultApexClass' --outputdir ./testsoutput/myApex/
 ```
 
 2. Set some breakpoints in your command code.
@@ -179,7 +167,7 @@ FLAG DESCRIPTIONS
     directory.
 ```
 
-_See code: [src/commands/template/generate/analytics/template.ts](https://github.com/salesforcecli/plugin-templates/blob/57.6.0/src/commands/template/generate/analytics/template.ts)_
+_See code: [src/commands/template/generate/analytics/template.ts](https://github.com/salesforcecli/plugin-templates/blob/57.7.0/src/commands/template/generate/analytics/template.ts)_
 
 ## `sf template generate apex class`
 
@@ -241,7 +229,7 @@ FLAG DESCRIPTIONS
     Supplied parameter values or default values are filled into a copy of the template.
 ```
 
-_See code: [src/commands/template/generate/apex/class.ts](https://github.com/salesforcecli/plugin-templates/blob/57.6.0/src/commands/template/generate/apex/class.ts)_
+_See code: [src/commands/template/generate/apex/class.ts](https://github.com/salesforcecli/plugin-templates/blob/57.7.0/src/commands/template/generate/apex/class.ts)_
 
 ## `sf template generate apex trigger`
 
@@ -311,7 +299,7 @@ FLAG DESCRIPTIONS
     Supplied parameter values or default values are filled into a copy of the template.
 ```
 
-_See code: [src/commands/template/generate/apex/trigger.ts](https://github.com/salesforcecli/plugin-templates/blob/57.6.0/src/commands/template/generate/apex/trigger.ts)_
+_See code: [src/commands/template/generate/apex/trigger.ts](https://github.com/salesforcecli/plugin-templates/blob/57.7.0/src/commands/template/generate/apex/trigger.ts)_
 
 ## `sf template generate digital-experience site`
 
@@ -365,7 +353,7 @@ FLAG DESCRIPTIONS
     project, defaults to the current directory.
 ```
 
-_See code: [src/commands/template/generate/digital-experience/site.ts](https://github.com/salesforcecli/plugin-templates/blob/57.6.0/src/commands/template/generate/digital-experience/site.ts)_
+_See code: [src/commands/template/generate/digital-experience/site.ts](https://github.com/salesforcecli/plugin-templates/blob/57.7.0/src/commands/template/generate/digital-experience/site.ts)_
 
 ## `sf template generate flexipage`
 
@@ -447,7 +435,7 @@ FLAG DESCRIPTIONS
     'Custom_Object__c'. This sets the `sobjectType` field in the FlexiPage metadata.
 ```
 
-_See code: [src/commands/template/generate/flexipage/index.ts](https://github.com/salesforcecli/plugin-templates/blob/57.6.0/src/commands/template/generate/flexipage/index.ts)_
+_See code: [src/commands/template/generate/flexipage/index.ts](https://github.com/salesforcecli/plugin-templates/blob/57.7.0/src/commands/template/generate/flexipage/index.ts)_
 
 ## `sf template generate lightning-out`
 
@@ -457,10 +445,13 @@ Generate the required metadata to scaffold a Lightning Out 2.0 app.
 USAGE
   $ sf template generate lightning-out [--json] [--flags-dir <value>] [--app-name <value>] [--eca-name <value>] [--runtime
     LWR_CORE|CLWR] [--host-domains <value>...] [--components <value>...] [--eca-contact-email <value>]
-    [--eca-callback-url <value>] [--definition-file <value>] [-d <value>]
+    [--eca-callback-url <value>] [--site <value>] [--access guest|authenticated] [--definition-file <value>] [-d
+    <value>]
 
 FLAGS
   -d, --output-dir=<value>         [default: .] Directory for saving the created files.
+      --access=<option>            Type of Experience Cloud site user who accesses a CLWR app.
+                                   <options: guest|authenticated>
       --app-name=<value>           Developer name of the new Lightning Out 2.0 app.
       --components=<value>...      Name of a Lightning web component exposed by the app. Repeat the flag to specify more
                                    than one. Replaces, rather than merges with, any components in the --definition-file.
@@ -469,12 +460,10 @@ FLAGS
       --eca-callback-url=<value>   OAuth callback URL for the External Client Application.
       --eca-contact-email=<value>  Contact email for the External Client Application.
       --eca-name=<value>           Developer name of the External Client Application associated with the app.
-      --host-domains=<value>...    HTTP or HTTPS origin of an external host page that embeds the app. Repeat the flag to
-                                   specify more than one. Replaces, rather than merges with, any hostDomains in the
-                                   --definition-file. For CLWR apps, host domains are used only for CORS, which
-                                   authenticated users need. Set up framing for the site in Experience Builder.
+      --host-domains=<value>...    HTTP or HTTPS origin of an external host page that embeds the app.
       --runtime=<option>           Runtime that serves the app.
                                    <options: LWR_CORE|CLWR>
+      --site=<value>               Name of the Experience Cloud site to link a CLWR app to.
 
 GLOBAL FLAGS
   --flags-dir=<value>  Import flag values from a directory.
@@ -488,8 +477,11 @@ DESCRIPTION
   This command gets you started by generating the seven metadata artifact types that a Lightning Out 2.0 app requires
   into your Salesforce DX project: LightningOutApp, MyDomain and Security settings, one CorsWhitelistOrigin per host
   domain, and the three External Client Application OAuth components (ExternalClientApplication,
-  ExtlClntAppGlobalOauthSettings, ExtlClntAppOauthSettings). The command only generates files. It doesn't deploy any
-  metadata to an org.
+  ExtlClntAppGlobalOauthSettings, ExtlClntAppOauthSettings). For a CLWR app with --access guest, the command generates
+  only the LightningOutApp, because guest users don't log in. The command only generates files. It doesn't deploy any
+  metadata to an org. When you deploy the generated LightningOutApp, its components and host domains replace the app's
+  existing ones in the org, including any added in Setup. List every component and host domain the app needs, not just
+  the new ones.
 
   Inputs can come from a --definition-file JSON, individual flags, or both. Flag values take precedence over the file on
   a per-key basis. The command validates the types of definition-file fields; the underlying generator performs the
@@ -509,9 +501,15 @@ EXAMPLES
 
     $ sf template generate lightning-out --definition-file lo-def.json --output-dir force-app/main/default
 
-  Generate a CLWR app for an Experience Cloud site using a definition file:
+  Generate a CLWR app for authenticated users (the default) of the Experience Cloud site named "My Site", using a
+  definition file for the other values:
+
+    $ sf template generate lightning-out --runtime CLWR --site "My Site" --definition-file lo-def.json
+
+  Generate a CLWR app for guest users of the Experience Cloud site named "My Site":
 
-    $ sf template generate lightning-out --runtime CLWR --definition-file lo-def.json
+    $ sf template generate lightning-out --app-name MyLoApp --runtime CLWR --access guest --site "My Site" \
+      --components c/myHeader
 
   Generate the app using most of the values from a definition file, but the --host-domains value overrides its
   equivalent in the file:
@@ -524,13 +522,31 @@ FLAG DESCRIPTIONS
     The location can be an absolute path or relative to the current working directory. The default is the current
     directory.
 
+  --access=guest|authenticated  Type of Experience Cloud site user who accesses a CLWR app.
+
+    Valid values are "authenticated" (default) and "guest". With "authenticated", the command generates the app plus the
+    External Client Application, CORS, and MyDomain and Security settings that site users need to log in. With "guest",
+    the command generates only the app, because guest users don't log in. Used only with --runtime CLWR.
+
+  --host-domains=<value>...  HTTP or HTTPS origin of an external host page that embeds the app.
+
+    Repeat the flag to specify more than one. Replaces, rather than merges with, any hostDomains in the
+    --definition-file. Not used for CLWR with --access guest.
+
   --runtime=LWR_CORE|CLWR  Runtime that serves the app.
 
     LWR_CORE serves the app from your Salesforce org to authenticated users. CLWR serves it from an Experience Cloud
-    site to guest and authenticated users. After you deploy a CLWR app, link it to your site in Setup.
+    site to guest and authenticated users. For CLWR, specify the site with --site and the type of user with --access.
+
+  --site=<value>  Name of the Experience Cloud site to link a CLWR app to.
+
+    Use the site name shown on the All Sites page in Setup, not its URL path prefix. The site must be active and use the
+    Lightning Out (LWR) or Build Your Own (LWR) template. Used only with --runtime CLWR. To deploy an app that's linked
+    to a site, use API version 69.0 or later. This flag is required for CLWR unless the project's sourceApiVersion is
+    below 69.0, because deploying a CLWR app without a site at 69.0 or later removes the app's existing site link.
 ```
 
-_See code: [src/commands/template/generate/lightning-out/index.ts](https://github.com/salesforcecli/plugin-templates/blob/57.6.0/src/commands/template/generate/lightning-out/index.ts)_
+_See code: [src/commands/template/generate/lightning-out/index.ts](https://github.com/salesforcecli/plugin-templates/blob/57.7.0/src/commands/template/generate/lightning-out/index.ts)_
 
 ## `sf template generate lightning app`
 
@@ -588,7 +604,7 @@ FLAG DESCRIPTIONS
     field in the DX project's "sfdx-project.json" file.
 ```
 
-_See code: [src/commands/template/generate/lightning/app.ts](https://github.com/salesforcecli/plugin-templates/blob/57.6.0/src/commands/template/generate/lightning/app.ts)_
+_See code: [src/commands/template/generate/lightning/app.ts](https://github.com/salesforcecli/plugin-templates/blob/57.7.0/src/commands/template/generate/lightning/app.ts)_
 
 ## `sf template generate lightning component`
 
@@ -665,7 +681,7 @@ FLAG DESCRIPTIONS
     field in the DX project's "sfdx-project.json" file.
 ```
 
-_See code: [src/commands/template/generate/lightning/component.ts](https://github.com/salesforcecli/plugin-templates/blob/57.6.0/src/commands/template/generate/lightning/component.ts)_
+_See code: [src/commands/template/generate/lightning/component.ts](https://github.com/salesforcecli/plugin-templates/blob/57.7.0/src/commands/template/generate/lightning/component.ts)_
 
 ## `sf template generate lightning event`
 
@@ -723,7 +739,7 @@ FLAG DESCRIPTIONS
     field in the DX project's "sfdx-project.json" file.
 ```
 
-_See code: [src/commands/template/generate/lightning/event.ts](https://github.com/salesforcecli/plugin-templates/blob/57.6.0/src/commands/template/generate/lightning/event.ts)_
+_See code: [src/commands/template/generate/lightning/event.ts](https://github.com/salesforcecli/plugin-templates/blob/57.7.0/src/commands/template/generate/lightning/event.ts)_
 
 ## `sf template generate lightning interface`
 
@@ -781,7 +797,7 @@ FLAG DESCRIPTIONS
     field in the DX project's "sfdx-project.json" file.
 ```
 
-_See code: [src/commands/template/generate/lightning/interface.ts](https://github.com/salesforcecli/plugin-templates/blob/57.6.0/src/commands/template/generate/lightning/interface.ts)_
+_See code: [src/commands/template/generate/lightning/interface.ts](https://github.com/salesforcecli/plugin-templates/blob/57.7.0/src/commands/template/generate/lightning/interface.ts)_
 
 ## `sf template generate lightning test`
 
@@ -839,7 +855,7 @@ FLAG DESCRIPTIONS
     field in the DX project's "sfdx-project.json" file.
 ```
 
-_See code: [src/commands/template/generate/lightning/test.ts](https://github.com/salesforcecli/plugin-templates/blob/57.6.0/src/commands/template/generate/lightning/test.ts)_
+_See code: [src/commands/template/generate/lightning/test.ts](https://github.com/salesforcecli/plugin-templates/blob/57.7.0/src/commands/template/generate/lightning/test.ts)_
 
 ## `sf template generate project`
 
@@ -973,7 +989,7 @@ FLAG DESCRIPTIONS
     server-side type stripping.
 ```
 
-_See code: [src/commands/template/generate/project/index.ts](https://github.com/salesforcecli/plugin-templates/blob/57.6.0/src/commands/template/generate/project/index.ts)_
+_See code: [src/commands/template/generate/project/index.ts](https://github.com/salesforcecli/plugin-templates/blob/57.7.0/src/commands/template/generate/project/index.ts)_
 
 ## `sf template generate static-resource`
 
@@ -1036,7 +1052,7 @@ FLAG DESCRIPTIONS
     etc.
 ```
 
-_See code: [src/commands/template/generate/static-resource/index.ts](https://github.com/salesforcecli/plugin-templates/blob/57.6.0/src/commands/template/generate/static-resource/index.ts)_
+_See code: [src/commands/template/generate/static-resource/index.ts](https://github.com/salesforcecli/plugin-templates/blob/57.7.0/src/commands/template/generate/static-resource/index.ts)_
 
 ## `sf template generate ui-bundle`
 
@@ -1131,7 +1147,7 @@ FLAG DESCRIPTIONS
     Supplied parameter values or default values are filled into a copy of the template.
 ```
 
-_See code: [src/commands/template/generate/ui-bundle/index.ts](https://github.com/salesforcecli/plugin-templates/blob/57.6.0/src/commands/template/generate/ui-bundle/index.ts)_
+_See code: [src/commands/template/generate/ui-bundle/index.ts](https://github.com/salesforcecli/plugin-templates/blob/57.7.0/src/commands/template/generate/ui-bundle/index.ts)_
 
 ## `sf template generate ui-embedding`
 
@@ -1210,7 +1226,7 @@ FLAG DESCRIPTIONS
     (announced by screen readers).
 ```
 
-_See code: [src/commands/template/generate/ui-embedding/index.ts](https://github.com/salesforcecli/plugin-templates/blob/57.6.0/src/commands/template/generate/ui-embedding/index.ts)_
+_See code: [src/commands/template/generate/ui-embedding/index.ts](https://github.com/salesforcecli/plugin-templates/blob/57.7.0/src/commands/template/generate/ui-embedding/index.ts)_
 
 ## `sf template generate visualforce component`
 
@@ -1267,7 +1283,7 @@ FLAG DESCRIPTIONS
     Supplied parameter values or default values are filled into a copy of the template.
 ```
 
-_See code: [src/commands/template/generate/visualforce/component.ts](https://github.com/salesforcecli/plugin-templates/blob/57.6.0/src/commands/template/generate/visualforce/component.ts)_
+_See code: [src/commands/template/generate/visualforce/component.ts](https://github.com/salesforcecli/plugin-templates/blob/57.7.0/src/commands/template/generate/visualforce/component.ts)_
 
 ## `sf template generate visualforce page`
 
@@ -1318,6 +1334,6 @@ FLAG DESCRIPTIONS
     The name can be up to 40 characters and must start with a letter.
 ```
 
-_See code: [src/commands/template/generate/visualforce/page.ts](https://github.com/salesforcecli/plugin-templates/blob/57.6.0/src/commands/template/generate/visualforce/page.ts)_
+_See code: [src/commands/template/generate/visualforce/page.ts](https://github.com/salesforcecli/plugin-templates/blob/57.7.0/src/commands/template/generate/visualforce/page.ts)_
 
 <!-- commandsstop -->

package/lib/commands/template/generate/lightning-out/index.d.ts

@@ -9,6 +9,8 @@ type LightningOutFlags = {
     components?: string[];
     'eca-contact-email'?: string;
     'eca-callback-url'?: string;
+    site?: string;
+    access?: 'guest' | 'authenticated';
     'output-dir'?: string;
 };
 /** Parse the --definition-file JSON, surfacing a clear error on malformed or non-object input. */
@@ -18,6 +20,7 @@ export declare function readDefinition(file: string): Record<string, unknown>;
  * JSON (e.g. `"appName": 123`) yields an actionable error here rather than an internal TypeError
  * from the generator (which calls `.trim()` on string fields). A field is skipped when the matching
  * flag overrides it, since flags always arrive as strings and win per-key (see mergeLightningOutInputs).
+ * An explicit JSON null for `site`/`access` counts as absent, matching the generator.
  */
 export declare function validateDefinitionShape(defn: Record<string, unknown>, flags: LightningOutFlags): void;
 /**
@@ -30,8 +33,13 @@ export declare function mergeLightningOutInputs(defn: Record<string, unknown>, f
     opts: LightningOutOptions;
     unknownKeys: string[];
 };
-/** True when a project sourceApiVersion is present and below the v68.0 deploy floor. Pure; testable. */
+/** True when a project sourceApiVersion is known and below the v68.0 deploy floor. Pure; testable. */
 export declare function isBelowApiFloor(projApi: string | undefined): boolean;
+/**
+ * True when a project sourceApiVersion is known and below 69.0, where <sites> isn't deployable.
+ * An unknown or unparsable version is not "below", so CLWR without a site fails closed. Pure; testable.
+ */
+export declare function isBelowSitesApi(projApi: string | undefined): boolean;
 /**
  * Quote a path for safe copy-paste into a POSIX shell when it contains whitespace or quote chars,
  * so the suggested deploy command survives output dirs such as "/tmp/Lightning Out".
@@ -49,10 +57,16 @@ export default class LightningOut extends SfCommand<CreateOutput> {
         components: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'eca-contact-email': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'eca-callback-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        site: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        access: import("@oclif/core/interfaces").OptionFlag<"guest" | "authenticated" | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'definition-file': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'output-dir': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         loglevel: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<CreateOutput>;
+    /** Post-generate warnings (`this.warn`, so they also appear in the --json `warnings` array). */
+    private warnAfterGenerate;
+    /** Success guidance (log/info are suppressed automatically under --json). */
+    private printGuidance;
 }
 export {};

package/lib/commands/template/generate/lightning-out/index.js

@@ -14,6 +14,7 @@
  * limitations under the License.
  */
 import * as fs from 'node:fs';
+import * as path from 'node:path';
 import { Flags, loglevel, SfCommand, Ux } from '@salesforce/sf-plugins-core';
 import { TemplateType } from '@salesforce/templates';
 import { Messages, SfProject } from '@salesforce/core';
@@ -21,6 +22,11 @@ import { getCustomTemplates, runGenerator } from '../../../../utils/templateComm
 import { outputDirFlagLightning } from '../../../../utils/flags.js';
 Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
 const messages = Messages.loadMessages('@salesforce/plugin-templates', 'lightningOut');
+const KNOWN_KEYS = ['appName', 'runtime', 'hostDomains', 'components', 'eca', 'site', 'access'];
+/** The v68.0 deploy floor for LightningOutApp. */
+const API_FLOOR = 68;
+/** First API version whose LightningOutApp accepts <sites>; at/after it, omitting <sites> can unlink. */
+const SITES_API_VERSION = 69;
 /** Parse the --definition-file JSON, surfacing a clear error on malformed or non-object input. */
 export function readDefinition(file) {
     let parsed;
@@ -44,6 +50,7 @@ function isStringArray(v) {
  * JSON (e.g. `"appName": 123`) yields an actionable error here rather than an internal TypeError
  * from the generator (which calls `.trim()` on string fields). A field is skipped when the matching
  * flag overrides it, since flags always arrive as strings and win per-key (see mergeLightningOutInputs).
+ * An explicit JSON null for `site`/`access` counts as absent, matching the generator.
  */
 export function validateDefinitionShape(defn, flags) {
     const requireString = (overridden, val, key) => {
@@ -60,6 +67,8 @@ export function validateDefinitionShape(defn, flags) {
     requireString(flags.runtime !== undefined, defn.runtime, 'runtime');
     requireStringArray(flags['host-domains'] !== undefined, defn.hostDomains, 'hostDomains');
     requireStringArray(flags.components !== undefined, defn.components, 'components');
+    requireString(flags.site !== undefined, defn.site ?? undefined, 'site');
+    requireString(flags.access !== undefined, defn.access ?? undefined, 'access');
     if (defn.eca !== undefined) {
         if (typeof defn.eca !== 'object' || defn.eca === null || Array.isArray(defn.eca)) {
             throw messages.createError('error.definition-file-field-type', ['eca', 'an object']);
@@ -77,7 +86,7 @@ export function validateDefinitionShape(defn, flags) {
  * formats) is the generator's job — this function only resolves precedence.
  */
 export function mergeLightningOutInputs(defn, flags) {
-    const known = new Set(['appName', 'runtime', 'hostDomains', 'components', 'eca']);
+    const known = new Set(KNOWN_KEYS);
     const unknownKeys = Object.keys(defn).filter((k) => !known.has(k));
     const ecaDefn = (defn.eca ?? {});
     const opts = {
@@ -90,28 +99,65 @@ export function mergeLightningOutInputs(defn, flags) {
             contactEmail: flags['eca-contact-email'] ?? ecaDefn.contactEmail,
             callbackUrl: flags['eca-callback-url'] ?? ecaDefn.callbackUrl,
         },
+        // An explicit JSON null counts as absent, so the `site === undefined` checks stay sound.
+        site: flags.site ?? defn.site ?? undefined,
+        access: flags.access ?? defn.access ?? undefined,
         outputdir: flags['output-dir'],
     };
     return { opts, unknownKeys };
 }
 /**
- * Resolve the local DX project's `sourceApiVersion`, used only for a CLI-side advisory warning
- * (the generator itself has no project context). Returns undefined when there's no DX project —
- * generating outside a project must not error.
+ * Resolve the DX project that contains `dir` and its `sourceApiVersion` (the generator itself has no
+ * project context). `inProject` is false when `dir` isn't in a DX project, so generating outside a
+ * project doesn't error. `api` is undefined when the version is missing or not a string or number.
  */
-async function getSourceApiVersion() {
+async function getProjectApi(dir) {
+    let project;
+    try {
+        project = await SfProject.resolve(path.resolve(dir));
+    }
+    catch (e) {
+        return { inProject: false };
+    }
     try {
-        const project = await SfProject.resolve();
         const projectJson = await project.resolveProjectConfig();
-        return projectJson.sourceApiVersion;
+        // sfdx-project.json isn't schema-validated on read, so a bare number (66) can arrive here.
+        const v = projectJson.sourceApiVersion;
+        return { inProject: true, api: typeof v === 'string' || typeof v === 'number' ? String(v) : undefined };
     }
     catch (e) {
-        return undefined;
+        return { inProject: true };
     }
 }
-/** True when a project sourceApiVersion is present and below the v68.0 deploy floor. Pure; testable. */
+/**
+ * Strictly parse an API version such as "68.0" or "68". Anything else (for example "latest", "0x44",
+ * or "1e2") is NaN, so callers treat it as unknown and fail closed.
+ */
+function parseApiVersion(projApi) {
+    const v = projApi?.trim() ?? '';
+    return /^\d+(\.\d+)?$/.test(v) ? Number(v) : NaN;
+}
+/** True when a project sourceApiVersion is known and below the v68.0 deploy floor. Pure; testable. */
 export function isBelowApiFloor(projApi) {
-    return !!projApi && Number(projApi) < 68;
+    return parseApiVersion(projApi) < API_FLOOR;
+}
+/**
+ * True when a project sourceApiVersion is known and below 69.0, where <sites> isn't deployable.
+ * An unknown or unparsable version is not "below", so CLWR without a site fails closed. Pure; testable.
+ */
+export function isBelowSitesApi(projApi) {
+    return parseApiVersion(projApi) < SITES_API_VERSION;
+}
+/** Last sentence of the site-required error: why the project's version didn't exempt the app. */
+function siteRequiredReason(inProject, projApi) {
+    if (!inProject)
+        return messages.getMessage('error.clwr-site-required.no-project');
+    if (projApi === undefined)
+        return messages.getMessage('error.clwr-site-required.no-version');
+    if (Number.isNaN(parseApiVersion(projApi))) {
+        return messages.getMessage('error.clwr-site-required.invalid-version', [projApi]);
+    }
+    return messages.getMessage('error.clwr-site-required.version', [projApi]);
 }
 /**
  * Quote a path for safe copy-paste into a POSIX shell when it contains whitespace or quote chars,
@@ -132,10 +178,23 @@ export default class LightningOut extends SfCommand {
             summary: messages.getMessage('flags.runtime.summary'),
             description: messages.getMessage('flags.runtime.description'),
         })(),
-        'host-domains': Flags.string({ summary: messages.getMessage('flags.host-domains.summary'), multiple: true }),
+        'host-domains': Flags.string({
+            summary: messages.getMessage('flags.host-domains.summary'),
+            description: messages.getMessage('flags.host-domains.description'),
+            multiple: true,
+        }),
         components: Flags.string({ summary: messages.getMessage('flags.components.summary'), multiple: true }),
         'eca-contact-email': Flags.string({ summary: messages.getMessage('flags.eca-contact-email.summary') }),
         'eca-callback-url': Flags.string({ summary: messages.getMessage('flags.eca-callback-url.summary') }),
+        site: Flags.string({
+            summary: messages.getMessage('flags.site.summary'),
+            description: messages.getMessage('flags.site.description'),
+        }),
+        access: Flags.option({
+            options: ['guest', 'authenticated'],
+            summary: messages.getMessage('flags.access.summary'),
+            description: messages.getMessage('flags.access.description'),
+        })(),
         'definition-file': Flags.file({ exists: true, summary: messages.getMessage('flags.definition-file.summary') }),
         'output-dir': outputDirFlagLightning,
         loglevel,
@@ -146,37 +205,79 @@ export default class LightningOut extends SfCommand {
         validateDefinitionShape(defn, flags);
         const { opts, unknownKeys } = mergeLightningOutInputs(defn, flags);
         unknownKeys.forEach((k) => this.warn(messages.getMessage('warning.unknown-definition-key', [k])));
+        const isClwr = opts.runtime === 'CLWR';
+        const isGuest = isClwr && opts.access === 'guest';
+        const outputDir = opts.outputdir ?? '.';
+        // CLI-side sourceApiVersion check, against the project the files are generated into.
+        const { inProject, api: projApi } = await getProjectApi(outputDir);
+        // A CLWR app file without <sites> can unlink the app's site when deployed at 69.0+, so a site is
+        // required unless the project is known to be below 69.0 (where <sites> can't be deployed and
+        // Core keeps the link). Checked before generating so no files are written. A blank or empty site
+        // is the generator's error, not this one.
+        if (isClwr && opts.site === undefined && !isBelowSitesApi(projApi)) {
+            throw messages.createError('error.clwr-site-required', [siteRequiredReason(inProject, projApi)]);
+        }
         const result = await runGenerator({
             templateType: TemplateType.LightningOut,
             opts,
             ux: new Ux({ jsonEnabled: this.jsonEnabled() }),
             templates: getCustomTemplates(this.configAggregator),
         });
-        // CLI-side sourceApiVersion floor check (the generator has no project context).
-        const projApi = await getSourceApiVersion();
-        const belowFloor = isBelowApiFloor(projApi);
-        if (belowFloor) {
-            this.warn(messages.getMessage('warning.source-api-version', [String(projApi)]));
+        // Only a known version below 69.0 is certain to fail; an unknown one may deploy at the org's version.
+        const siteWillFail = opts.site !== undefined && isBelowSitesApi(projApi);
+        this.warnAfterGenerate(opts, { projApi, isClwr, isGuest, siteWillFail });
+        this.printGuidance(opts, { isClwr, isGuest, outputDir, siteWillFail, belowFloor: isBelowApiFloor(projApi) });
+        return result; // --json returns the full CreateOutput (created[])
+    }
+    /** Post-generate warnings (`this.warn`, so they also appear in the --json `warnings` array). */
+    warnAfterGenerate(opts, ctx) {
+        // Also shown with a site: the site warning's "regenerate without --site" fallback still needs 68.0.
+        if (isBelowApiFloor(ctx.projApi)) {
+            this.warn(messages.getMessage('warning.source-api-version', [String(ctx.projApi)]));
         }
-        // The org-wide settings notice is a warning, so it also appears in the --json `warnings` array.
-        this.warn(messages.getMessage('warning.org-settings'));
-        // Success guidance (log/info are suppressed automatically under --json).
-        // Only pin --api-version to the 68.0 deploy floor when the project is below it; otherwise omit
-        // the optional flag so the user's own (>= floor) project default applies rather than being downgraded.
-        const outputDir = opts.outputdir ?? '.';
-        const apiVersionSuffix = belowFloor ? ' --api-version 68.0' : '';
+        if (ctx.siteWillFail) {
+            this.warn(messages.getMessage('warning.site-api-version', [String(ctx.projApi)]));
+        }
+        // Reaching here with CLWR and no site means the project is below 69.0; a later bump would unlink it.
+        if (ctx.isClwr && opts.site === undefined) {
+            this.warn(messages.getMessage('warning.clwr-site-later'));
+        }
+        // Guest writes no settings files, so the org-wide settings notice applies only otherwise.
+        if (!ctx.isGuest) {
+            this.warn(messages.getMessage('warning.org-settings'));
+        }
+    }
+    /** Success guidance (log/info are suppressed automatically under --json). */
+    printGuidance(opts, ctx) {
         this.info(messages.getMessage('success.components-exist'));
-        this.log(messages.getMessage('success.next-step', [outputDir, shellQuoteArg(outputDir), apiVersionSuffix]));
-        // CLWR finds the app through the site link; app-id only applies to LWR_CORE.
-        if (opts.runtime === 'CLWR') {
-            this.info(messages.getMessage('success.clwr-site'));
+        // A deploy known to fail (below the 68.0 floor, or a site below 69.0) gets no copy-paste command; its
+        // warning says how to fix it. --api-version isn't offered: it doesn't change the deployed metadata's version.
+        if (!ctx.siteWillFail && !ctx.belowFloor) {
+            this.log(messages.getMessage('success.next-step', [ctx.outputDir, shellQuoteArg(ctx.outputDir)]));
+        }
+        if (ctx.isClwr) {
+            if (opts.site) {
+                // The deploy itself links the site; the rest of the site setup is done in Experience Builder.
+                // Skipped when the version warning says this deploy fails, since the site wouldn't be linked.
+                if (!ctx.siteWillFail) {
+                    const key = ctx.isGuest ? 'success.clwr-site-linked-guest' : 'success.clwr-site-linked-authenticated';
+                    this.info(messages.getMessage(key, [opts.site.trim()]));
+                }
+            }
+            else {
+                // Below 69.0: <sites> can't be deployed, so the site is linked in Setup.
+                this.info(messages.getMessage('success.clwr-site'));
+                this.info(messages.getMessage(ctx.isGuest ? 'success.clwr-site-guest' : 'success.clwr-site-authenticated'));
+            }
         }
         else {
+            // CLWR finds the app through the site link; app-id only applies to LWR_CORE.
             this.info(messages.getMessage('success.app-id'));
         }
-        this.info(messages.getMessage('success.dont-delete'));
-        this.info(messages.getMessage('success.eca-overwrite', [opts.eca.name ?? '']));
-        return result; // --json returns the full CreateOutput (created[])
+        if (!ctx.isGuest) {
+            this.info(messages.getMessage('success.dont-delete'));
+            this.info(messages.getMessage('success.eca-overwrite', [opts.eca?.name ?? '']));
+        }
     }
 }
 //# sourceMappingURL=index.js.map

package/lib/commands/template/generate/lightning-out/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/commands/template/generate/lightning-out/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/commands/template/generate/lightning-out/index.ts"],"names":[],"mappings":"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"}

package/messages/lightningOut.md

@@ -12,9 +12,13 @@
 
   <%= config.bin %> <%= command.id %> --definition-file lo-def.json --output-dir force-app/main/default
 
-- Generate a CLWR app for an Experience Cloud site using a definition file:
+- Generate a CLWR app for authenticated users (the default) of the Experience Cloud site named "My Site", using a definition file for the other values:
 
-  <%= config.bin %> <%= command.id %> --runtime CLWR --definition-file lo-def.json
+  <%= config.bin %> <%= command.id %> --runtime CLWR --site "My Site" --definition-file lo-def.json
+
+- Generate a CLWR app for guest users of the Experience Cloud site named "My Site":
+
+  <%= config.bin %> <%= command.id %> --app-name MyLoApp --runtime CLWR --access guest --site "My Site" --components c/myHeader
 
 - Generate the app using most of the values from a definition file, but the --host-domains value overrides its equivalent in the file:
 
@@ -28,7 +32,7 @@ Generate the required metadata to scaffold a Lightning Out 2.0 app.
 
 Lightning Out 2.0 lets you embed custom Lightning web components (LWCs) into your external, non-Salesforce apps.
 
-This command gets you started by generating the seven metadata artifact types that a Lightning Out 2.0 app requires into your Salesforce DX project: LightningOutApp, MyDomain and Security settings, one CorsWhitelistOrigin per host domain, and the three External Client Application OAuth components (ExternalClientApplication, ExtlClntAppGlobalOauthSettings, ExtlClntAppOauthSettings). The command only generates files. It doesn't deploy any metadata to an org.
+This command gets you started by generating the seven metadata artifact types that a Lightning Out 2.0 app requires into your Salesforce DX project: LightningOutApp, MyDomain and Security settings, one CorsWhitelistOrigin per host domain, and the three External Client Application OAuth components (ExternalClientApplication, ExtlClntAppGlobalOauthSettings, ExtlClntAppOauthSettings). For a CLWR app with --access guest, the command generates only the LightningOutApp, because guest users don't log in. The command only generates files. It doesn't deploy any metadata to an org. When you deploy the generated LightningOutApp, its components and host domains replace the app's existing ones in the org, including any added in Setup. List every component and host domain the app needs, not just the new ones.
 
 Inputs can come from a --definition-file JSON, individual flags, or both. Flag values take precedence over the file on a per-key basis. The command validates the types of definition-file fields; the underlying generator performs the remaining structural validation, such as required fields and formats.
 
@@ -46,11 +50,15 @@ Runtime that serves the app.
 
 # flags.runtime.description
 
-LWR_CORE serves the app from your Salesforce org to authenticated users. CLWR serves it from an Experience Cloud site to guest and authenticated users. After you deploy a CLWR app, link it to your site in Setup.
+LWR_CORE serves the app from your Salesforce org to authenticated users. CLWR serves it from an Experience Cloud site to guest and authenticated users. For CLWR, specify the site with --site and the type of user with --access.
 
 # flags.host-domains.summary
 
-HTTP or HTTPS origin of an external host page that embeds the app. Repeat the flag to specify more than one. Replaces, rather than merges with, any hostDomains in the --definition-file. For CLWR apps, host domains are used only for CORS, which authenticated users need. Set up framing for the site in Experience Builder.
+HTTP or HTTPS origin of an external host page that embeds the app.
+
+# flags.host-domains.description
+
+Repeat the flag to specify more than one. Replaces, rather than merges with, any hostDomains in the --definition-file. Not used for CLWR with --access guest.
 
 # flags.components.summary
 
@@ -64,6 +72,22 @@ Contact email for the External Client Application.
 
 OAuth callback URL for the External Client Application.
 
+# flags.site.summary
+
+Name of the Experience Cloud site to link a CLWR app to.
+
+# flags.site.description
+
+Use the site name shown on the All Sites page in Setup, not its URL path prefix. The site must be active and use the Lightning Out (LWR) or Build Your Own (LWR) template. Used only with --runtime CLWR. To deploy an app that's linked to a site, use API version 69.0 or later. This flag is required for CLWR unless the project's sourceApiVersion is below 69.0, because deploying a CLWR app without a site at 69.0 or later removes the app's existing site link.
+
+# flags.access.summary
+
+Type of Experience Cloud site user who accesses a CLWR app.
+
+# flags.access.description
+
+Valid values are "authenticated" (default) and "guest". With "authenticated", the command generates the app plus the External Client Application, CORS, and MyDomain and Security settings that site users need to log in. With "guest", the command generates only the app, because guest users don't log in. Used only with --runtime CLWR.
+
 # flags.definition-file.summary
 
 Path to a JSON file describing the Lightning Out 2.0 app. Individual flags, when supplied, override the corresponding value in this file.
@@ -84,9 +108,41 @@ Definition file field "%s" must be %s.
 
 Ignoring unrecognized key "%s" in --definition-file.
 
+# error.clwr-site-required
+
+Specify the Experience Cloud site for this CLWR app with --site or with "site" in the definition file. Without a site, deploying the app at API version 69.0 or later removes the app's existing site link. %s
+
+# error.clwr-site-required.version
+
+The project's sourceApiVersion is %s.
+
+# error.clwr-site-required.no-version
+
+The command can't check the API version because sfdx-project.json doesn't set sourceApiVersion.
+
+# error.clwr-site-required.invalid-version
+
+The command can't check the API version because the project's sourceApiVersion, "%s", isn't valid.
+
+# error.clwr-site-required.no-project
+
+The command can't check the API version because the output directory isn't in a Salesforce DX project.
+
+# warning.site-api-version
+
+To deploy an app that's linked to a site, use sourceApiVersion 69.0 or later. The project's sourceApiVersion is %s, so the deploy fails. Set sourceApiVersion to 69.0 or later in sfdx-project.json, or regenerate the app without --site and link the site in Setup after you deploy.
+
+# success.clwr-site-authenticated
+
+For authenticated users, on your host page, also set "frontdoor-url" on the <lightning-out-application> tag to the frontdoor_uri that your host app gets for the logged-in user from the site's /services/oauth2/lightningoutsingleaccess endpoint.
+
+# warning.clwr-site-later
+
+If you later set sourceApiVersion to 69.0 or later, regenerate the app with --site before you redeploy. Otherwise, the deploy removes the app's site link.
+
 # warning.source-api-version
 
-Your local project's sourceApiVersion (%s) is below 68.0, the minimum API version this scaffold supports for deployment. Set sourceApiVersion to 68.0 or later in sfdx-project.json, or pass --api-version 68.0 or later when you deploy.
+The project's sourceApiVersion is %s, which is below 68.0, the minimum API version for deploying a Lightning Out 2.0 app, so the deploy fails. Set sourceApiVersion to 68.0 or later in sfdx-project.json before you deploy. Passing --api-version when you deploy doesn't change the API version of the deployed metadata.
 
 # warning.org-settings
 
@@ -94,7 +150,7 @@ Deploying the generated MyDomain and Security settings changes two org-wide sett
 
 # success.next-step
 
-Scaffold generated in %s. Deploy it with: sf project deploy start --source-dir %s%s
+Scaffold generated in %s. Deploy it with: sf project deploy start --source-dir %s
 
 # success.app-id
 
@@ -112,6 +168,18 @@ Re-running this command overwrites the generated files for the "%s" External Cli
 
 Verify that every component you referenced already exists and is exposed for Lightning Out 2.0 before deploying.
 
+# success.clwr-site-linked-guest
+
+Deploying the app links it to the "%s" site and replaces the app's current site link, if it has one. After you deploy, in Experience Builder for the site, go to Settings > Security & Privacy, set "Clickjack Protection Level" to "Allow framing of site pages on external domains", and add your host domains to "Trusted Domains for Inline Framing". Then make the site's /lightning-out page public, and publish the site. On your host page, set "org-url" to the site's origin without its path prefix, for example "https://example.my.site.com", and "site-prefix" to the URL path prefix, for example "/mysite", on the <lightning-out-application> tag. For a site at the root of its domain, set "site-prefix" to "". For host-page setup, see "Use Components Outside Salesforce with Lightning Out 2.0" in the Lightning Web Components Developer Guide.
+
+# success.clwr-site-linked-authenticated
+
+Deploying the app links it to the "%s" site and replaces the app's current site link, if it has one. After you deploy, in Experience Builder for the site, go to Settings > Security & Privacy, set "Clickjack Protection Level" to "Allow framing of site pages on external domains", and add your host domains to "Trusted Domains for Inline Framing". Then publish the site. On your host page, set "frontdoor-url" to the frontdoor_uri that your host app gets for the logged-in user from the site's /services/oauth2/lightningoutsingleaccess endpoint, and set "site-prefix" to the site's URL path prefix, for example "/mysite", on the <lightning-out-application> tag. For a site at the root of its domain, set "site-prefix" to "". For host-page setup, see "Use Components Outside Salesforce with Lightning Out 2.0" in the Lightning Web Components Developer Guide.
+
 # success.clwr-site
 
-Link the app to your Experience Cloud site after deploying. From Setup, in the Quick Find box, enter Lightning Out, and then select "Lightning Out 2.0 App Manager". Edit the app, select your site on the "Linked Communities Site" tab, and save. Then follow the steps in the "Complete Deployment in Experience Builder" dialog, which include publishing the site. On your host page, set the "site-prefix" attribute on the <lightning-out-application> tag to your site's URL path prefix, for example "/mysite". For host-page setup, see "Use Components Outside Salesforce with Lightning Out 2.0" in the Lightning Web Components Developer Guide.
+Link the app to your Experience Cloud site after deploying. From Setup, in the Quick Find box, enter Lightning Out, and then select "Lightning Out 2.0 App Manager". Edit the app, select your site on the "Linked Communities Site" tab, and save. Then, in Experience Builder for the site, go to Settings > Security & Privacy and set "Clickjack Protection Level" to "Allow framing of site pages on external domains". The "Complete Deployment in Experience Builder" dialog doesn't include this step. Then follow the steps in the dialog, which include adding your host domains to the site's trusted domains and publishing the site. On your host page, set the "site-prefix" attribute on the <lightning-out-application> tag to your site's URL path prefix, for example "/mysite". For a site at the root of its domain, set "site-prefix" to "". For host-page setup, see "Use Components Outside Salesforce with Lightning Out 2.0" in the Lightning Web Components Developer Guide.
+
+# success.clwr-site-guest
+
+For guest users, don't skip the dialog's Guest User Mode step for the site's /lightning-out page. On your host page, also set "org-url" on the <lightning-out-application> tag to the site's origin without its path prefix, for example "https://example.my.site.com".

package/oclif.manifest.json

@@ -1742,12 +1742,13 @@
     "template:generate:lightning-out": {
       "aliases": [],
       "args": {},
-      "description": "Lightning Out 2.0 lets you embed custom Lightning web components (LWCs) into your external, non-Salesforce apps.\n\nThis command gets you started by generating the seven metadata artifact types that a Lightning Out 2.0 app requires into your Salesforce DX project: LightningOutApp, MyDomain and Security settings, one CorsWhitelistOrigin per host domain, and the three External Client Application OAuth components (ExternalClientApplication, ExtlClntAppGlobalOauthSettings, ExtlClntAppOauthSettings). The command only generates files. It doesn't deploy any metadata to an org.\n\nInputs can come from a --definition-file JSON, individual flags, or both. Flag values take precedence over the file on a per-key basis. The command validates the types of definition-file fields; the underlying generator performs the remaining structural validation, such as required fields and formats.",
+      "description": "Lightning Out 2.0 lets you embed custom Lightning web components (LWCs) into your external, non-Salesforce apps.\n\nThis command gets you started by generating the seven metadata artifact types that a Lightning Out 2.0 app requires into your Salesforce DX project: LightningOutApp, MyDomain and Security settings, one CorsWhitelistOrigin per host domain, and the three External Client Application OAuth components (ExternalClientApplication, ExtlClntAppGlobalOauthSettings, ExtlClntAppOauthSettings). For a CLWR app with --access guest, the command generates only the LightningOutApp, because guest users don't log in. The command only generates files. It doesn't deploy any metadata to an org. When you deploy the generated LightningOutApp, its components and host domains replace the app's existing ones in the org, including any added in Setup. List every component and host domain the app needs, not just the new ones.\n\nInputs can come from a --definition-file JSON, individual flags, or both. Flag values take precedence over the file on a per-key basis. The command validates the types of definition-file fields; the underlying generator performs the remaining structural validation, such as required fields and formats.",
       "examples": [
         "Generate a Lightning Out 2.0 app using individual flags to specify the values:\n<%= config.bin %> <%= command.id %> --app-name MyLoApp --runtime LWR_CORE --host-domains https://example.com --eca-name MyLoAppEca --eca-contact-email dev@example.com --eca-callback-url https://example.com/cb",
         "Generate an app using the values in a JSON definition file called lo-def.json:\n<%= config.bin %> <%= command.id %> --definition-file lo-def.json",
         "Generate the app into a specific directory:\n<%= config.bin %> <%= command.id %> --definition-file lo-def.json --output-dir force-app/main/default",
-        "Generate a CLWR app for an Experience Cloud site using a definition file:\n<%= config.bin %> <%= command.id %> --runtime CLWR --definition-file lo-def.json",
+        "Generate a CLWR app for authenticated users (the default) of the Experience Cloud site named \"My Site\", using a definition file for the other values:\n<%= config.bin %> <%= command.id %> --runtime CLWR --site \"My Site\" --definition-file lo-def.json",
+        "Generate a CLWR app for guest users of the Experience Cloud site named \"My Site\":\n<%= config.bin %> <%= command.id %> --app-name MyLoApp --runtime CLWR --access guest --site \"My Site\" --components c/myHeader",
         "Generate the app using most of the values from a definition file, but the --host-domains value overrides its equivalent in the file:\n<%= config.bin %> <%= command.id %> --definition-file lo-def.json --host-domains https://staging.example.com"
       ],
       "flags": {
@@ -1783,7 +1784,7 @@
           "type": "option"
         },
         "runtime": {
-          "description": "LWR_CORE serves the app from your Salesforce org to authenticated users. CLWR serves it from an Experience Cloud site to guest and authenticated users. After you deploy a CLWR app, link it to your site in Setup.",
+          "description": "LWR_CORE serves the app from your Salesforce org to authenticated users. CLWR serves it from an Experience Cloud site to guest and authenticated users. For CLWR, specify the site with --site and the type of user with --access.",
           "name": "runtime",
           "summary": "Runtime that serves the app.",
           "hasDynamicHelp": false,
@@ -1795,8 +1796,9 @@
           "type": "option"
         },
         "host-domains": {
+          "description": "Repeat the flag to specify more than one. Replaces, rather than merges with, any hostDomains in the --definition-file. Not used for CLWR with --access guest.",
           "name": "host-domains",
-          "summary": "HTTP or HTTPS origin of an external host page that embeds the app. Repeat the flag to specify more than one. Replaces, rather than merges with, any hostDomains in the --definition-file. For CLWR apps, host domains are used only for CORS, which authenticated users need. Set up framing for the site in Experience Builder.",
+          "summary": "HTTP or HTTPS origin of an external host page that embeds the app.",
           "hasDynamicHelp": false,
           "multiple": true,
           "type": "option"
@@ -1822,6 +1824,26 @@
           "multiple": false,
           "type": "option"
         },
+        "site": {
+          "description": "Use the site name shown on the All Sites page in Setup, not its URL path prefix. The site must be active and use the Lightning Out (LWR) or Build Your Own (LWR) template. Used only with --runtime CLWR. To deploy an app that's linked to a site, use API version 69.0 or later. This flag is required for CLWR unless the project's sourceApiVersion is below 69.0, because deploying a CLWR app without a site at 69.0 or later removes the app's existing site link.",
+          "name": "site",
+          "summary": "Name of the Experience Cloud site to link a CLWR app to.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "access": {
+          "description": "Valid values are \"authenticated\" (default) and \"guest\". With \"authenticated\", the command generates the app plus the External Client Application, CORS, and MyDomain and Security settings that site users need to log in. With \"guest\", the command generates only the app, because guest users don't log in. Used only with --runtime CLWR.",
+          "name": "access",
+          "summary": "Type of Experience Cloud site user who accesses a CLWR app.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "guest",
+            "authenticated"
+          ],
+          "type": "option"
+        },
         "definition-file": {
           "name": "definition-file",
           "summary": "Path to a JSON file describing the Lightning Out 2.0 app. Individual flags, when supplied, override the corresponding value in this file.",
@@ -2816,5 +2838,5 @@
       ]
     }
   },
-  "version": "57.6.0"
+  "version": "57.7.0"
 }

package/package.json

@@ -1,28 +1,28 @@
 {
     "name": "@salesforce/plugin-templates",
     "description": "Commands to create metadata from a default or custom template",
-    "version": "57.6.0",
+    "version": "57.7.0",
     "author": "Salesforce",
     "bugs": "https://github.com/salesforcecli/plugin-templates/issues",
     "enableO11y": true,
     "o11yUploadEndpoint": "https://794testsite.my.site.com/byolwr/webruntime/log/metrics",
     "dependencies": {
         "@salesforce/core": "^9.2.0",
-        "@salesforce/sf-plugins-core": "^13.0.7",
-        "@salesforce/templates": "^66.19.0"
+        "@salesforce/sf-plugins-core": "^13.0.8",
+        "@salesforce/templates": "^66.20.0"
     },
     "devDependencies": {
-        "@oclif/plugin-command-snapshot": "^6.0.6",
-        "@salesforce/cli-plugins-testkit": "^5.3.81",
-        "@salesforce/dev-scripts": "^15.0.0",
+        "@oclif/plugin-command-snapshot": "^6.0.7",
+        "@salesforce/cli-plugins-testkit": "^5.3.90",
+        "@salesforce/dev-scripts": "^15.0.1",
         "@salesforce/plugin-command-reference": "^3.1.147",
         "@types/chai": "^4.3.17",
         "@types/mocha": "^10.0.10",
         "@types/node": "^18",
         "@types/sinon": "^10.0.20",
         "@types/yeoman-assert": "^3.1.4",
-        "eslint": "^10.13.0",
-        "eslint-config-salesforce-typescript": "^7.0.1",
+        "eslint": "^10.14.0",
+        "eslint-config-salesforce-typescript": "^7.0.6",
         "eslint-plugin-sf-plugin": "^3.0.4",
         "oclif": "^5.0.2",
         "ts-node": "^10.9.2",
@@ -259,7 +259,7 @@
     "exports": "./lib/index.js",
     "type": "module",
     "sfdx": {
-        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-templates/57.6.0.crt",
-        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-templates/57.6.0.sig"
+        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-templates/57.7.0.crt",
+        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-templates/57.7.0.sig"
     }
 }