@salesforce/plugin-templates 57.3.0 → 57.4.1

package/README.md

@@ -178,7 +178,7 @@ FLAG DESCRIPTIONS
     directory.
 ```
 
-_See code: [src/commands/template/generate/analytics/template.ts](https://github.com/salesforcecli/plugin-templates/blob/57.3.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.4.1/src/commands/template/generate/analytics/template.ts)_
 
 ## `sf template generate apex class`
 
@@ -240,7 +240,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.3.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.4.1/src/commands/template/generate/apex/class.ts)_
 
 ## `sf template generate apex trigger`
 
@@ -310,7 +310,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.3.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.4.1/src/commands/template/generate/apex/trigger.ts)_
 
 ## `sf template generate digital-experience site`
 
@@ -364,7 +364,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.3.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.4.1/src/commands/template/generate/digital-experience/site.ts)_
 
 ## `sf template generate flexipage`
 
@@ -446,7 +446,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.3.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.4.1/src/commands/template/generate/flexipage/index.ts)_
 
 ## `sf template generate lightning app`
 
@@ -504,7 +504,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.3.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.4.1/src/commands/template/generate/lightning/app.ts)_
 
 ## `sf template generate lightning component`
 
@@ -581,7 +581,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.3.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.4.1/src/commands/template/generate/lightning/component.ts)_
 
 ## `sf template generate lightning event`
 
@@ -639,7 +639,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.3.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.4.1/src/commands/template/generate/lightning/event.ts)_
 
 ## `sf template generate lightning interface`
 
@@ -697,7 +697,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.3.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.4.1/src/commands/template/generate/lightning/interface.ts)_
 
 ## `sf template generate lightning test`
 
@@ -755,7 +755,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.3.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.4.1/src/commands/template/generate/lightning/test.ts)_
 
 ## `sf template generate project`
 
@@ -887,7 +887,7 @@ FLAG DESCRIPTIONS
     server-side type stripping.
 ```
 
-_See code: [src/commands/template/generate/project/index.ts](https://github.com/salesforcecli/plugin-templates/blob/57.3.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.4.1/src/commands/template/generate/project/index.ts)_
 
 ## `sf template generate static-resource`
 
@@ -950,7 +950,7 @@ FLAG DESCRIPTIONS
     etc.
 ```
 
-_See code: [src/commands/template/generate/static-resource/index.ts](https://github.com/salesforcecli/plugin-templates/blob/57.3.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.4.1/src/commands/template/generate/static-resource/index.ts)_
 
 ## `sf template generate ui-bundle`
 
@@ -1039,7 +1039,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.3.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.4.1/src/commands/template/generate/ui-bundle/index.ts)_
 
 ## `sf template generate ui-embedding`
 
@@ -1118,7 +1118,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.3.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.4.1/src/commands/template/generate/ui-embedding/index.ts)_
 
 ## `sf template generate visualforce component`
 
@@ -1175,7 +1175,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.3.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.4.1/src/commands/template/generate/visualforce/component.ts)_
 
 ## `sf template generate visualforce page`
 
@@ -1226,6 +1226,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.3.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.4.1/src/commands/template/generate/visualforce/page.ts)_
 
 <!-- commandsstop -->

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

@@ -0,0 +1,60 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { CreateOutput, LightningOutOptions } from '@salesforce/templates';
+/** Flat flag shape read by {@link mergeLightningOutInputs} — a structural subset of the parsed oclif flags. */
+type LightningOutFlags = {
+    'app-name'?: string;
+    'eca-name'?: string;
+    runtime?: 'LWR_CORE' | 'CLWR';
+    'host-domains'?: string[];
+    components?: string[];
+    'eca-contact-email'?: string;
+    'eca-callback-url'?: string;
+    'output-dir'?: string;
+};
+/** Parse the --definition-file JSON, surfacing a clear error on malformed or non-object input. */
+export declare function readDefinition(file: string): Record<string, unknown>;
+/**
+ * Validate the types of --definition-file fields before they reach the generator, so wrong-typed
+ * 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).
+ */
+export declare function validateDefinitionShape(defn: Record<string, unknown>, flags: LightningOutFlags): void;
+/**
+ * Merge the --definition-file JSON with individual flags into one LightningOutOptions, with
+ * per-key precedence (flags win over the file) and wholesale list-replace semantics for
+ * hostDomains/components (never merge/concat). All structural validation (required-ness, shape,
+ * formats) is the generator's job — this function only resolves precedence.
+ */
+export declare function mergeLightningOutInputs(defn: Record<string, unknown>, flags: LightningOutFlags): {
+    opts: LightningOutOptions;
+    unknownKeys: string[];
+};
+/** True when a project sourceApiVersion is present and below the v68.0 deploy floor. Pure; testable. */
+export declare function isBelowApiFloor(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".
+ */
+export declare function shellQuoteArg(p: string): string;
+export default class LightningOut extends SfCommand<CreateOutput> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly state = "beta";
+    static readonly hidden = true;
+    static readonly flags: {
+        'app-name': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'eca-name': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        runtime: import("@oclif/core/interfaces").OptionFlag<"LWR_CORE" | "CLWR" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'host-domains': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        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>;
+        '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>;
+}
+export {};

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

@@ -0,0 +1,179 @@
+/*
+ * Copyright 2025, Salesforce, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import * as fs from 'node:fs';
+import { Flags, loglevel, SfCommand, Ux } from '@salesforce/sf-plugins-core';
+import { TemplateType } from '@salesforce/templates';
+import { Messages, SfProject } from '@salesforce/core';
+import { getCustomTemplates, runGenerator } from '../../../../utils/templateCommand.js';
+import { outputDirFlagLightning } from '../../../../utils/flags.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@salesforce/plugin-templates', 'lightningOut');
+/** Parse the --definition-file JSON, surfacing a clear error on malformed or non-object input. */
+export function readDefinition(file) {
+    let parsed;
+    try {
+        parsed = JSON.parse(fs.readFileSync(file, 'utf8'));
+    }
+    catch (e) {
+        throw messages.createError('error.definition-file-json', [file, e.message]);
+    }
+    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw messages.createError('error.definition-file-not-object', [file]);
+    }
+    return parsed;
+}
+/** True when a value is an array whose every element is a string. */
+function isStringArray(v) {
+    return Array.isArray(v) && v.every((x) => typeof x === 'string');
+}
+/**
+ * Validate the types of --definition-file fields before they reach the generator, so wrong-typed
+ * 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).
+ */
+export function validateDefinitionShape(defn, flags) {
+    const requireString = (overridden, val, key) => {
+        if (!overridden && val !== undefined && typeof val !== 'string') {
+            throw messages.createError('error.definition-file-field-type', [key, 'a string']);
+        }
+    };
+    const requireStringArray = (overridden, val, key) => {
+        if (!overridden && val !== undefined && !isStringArray(val)) {
+            throw messages.createError('error.definition-file-field-type', [key, 'an array of strings']);
+        }
+    };
+    requireString(flags['app-name'] !== undefined, defn.appName, 'appName');
+    requireString(flags.runtime !== undefined, defn.runtime, 'runtime');
+    requireStringArray(flags['host-domains'] !== undefined, defn.hostDomains, 'hostDomains');
+    requireStringArray(flags.components !== undefined, defn.components, 'components');
+    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']);
+        }
+        const eca = defn.eca;
+        requireString(flags['eca-name'] !== undefined, eca.name, 'eca.name');
+        requireString(flags['eca-contact-email'] !== undefined, eca.contactEmail, 'eca.contactEmail');
+        requireString(flags['eca-callback-url'] !== undefined, eca.callbackUrl, 'eca.callbackUrl');
+    }
+}
+/**
+ * Merge the --definition-file JSON with individual flags into one LightningOutOptions, with
+ * per-key precedence (flags win over the file) and wholesale list-replace semantics for
+ * hostDomains/components (never merge/concat). All structural validation (required-ness, shape,
+ * 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 unknownKeys = Object.keys(defn).filter((k) => !known.has(k));
+    const ecaDefn = (defn.eca ?? {});
+    const opts = {
+        appName: flags['app-name'] ?? defn.appName,
+        runtime: (flags.runtime ?? defn.runtime),
+        hostDomains: flags['host-domains'] ?? defn.hostDomains ?? [],
+        components: flags.components ?? defn.components,
+        eca: {
+            name: flags['eca-name'] ?? ecaDefn.name,
+            contactEmail: flags['eca-contact-email'] ?? ecaDefn.contactEmail,
+            callbackUrl: flags['eca-callback-url'] ?? ecaDefn.callbackUrl,
+        },
+        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.
+ */
+async function getSourceApiVersion() {
+    try {
+        const project = await SfProject.resolve();
+        const projectJson = await project.resolveProjectConfig();
+        return projectJson.sourceApiVersion;
+    }
+    catch (e) {
+        return undefined;
+    }
+}
+/** True when a project sourceApiVersion is present and below the v68.0 deploy floor. Pure; testable. */
+export function isBelowApiFloor(projApi) {
+    return !!projApi && Number(projApi) < 68;
+}
+/**
+ * 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".
+ */
+export function shellQuoteArg(p) {
+    return /[\s"'\\]/.test(p) ? `'${p.replace(/'/g, "'\\''")}'` : p;
+}
+export default class LightningOut extends SfCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static state = 'beta';
+    static hidden = true;
+    static flags = {
+        'app-name': Flags.string({ summary: messages.getMessage('flags.app-name.summary'), required: false }),
+        'eca-name': Flags.string({ summary: messages.getMessage('flags.eca-name.summary'), required: false }),
+        runtime: Flags.option({
+            options: ['LWR_CORE', 'CLWR'],
+            summary: messages.getMessage('flags.runtime.summary'),
+        })(),
+        'host-domains': Flags.string({ summary: messages.getMessage('flags.host-domains.summary'), 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') }),
+        'definition-file': Flags.file({ exists: true, summary: messages.getMessage('flags.definition-file.summary') }),
+        'output-dir': outputDirFlagLightning,
+        loglevel,
+    };
+    async run() {
+        const { flags } = await this.parse(LightningOut);
+        const defn = flags['definition-file'] ? readDefinition(flags['definition-file']) : {};
+        validateDefinitionShape(defn, flags);
+        const { opts, unknownKeys } = mergeLightningOutInputs(defn, flags);
+        unknownKeys.forEach((k) => this.warn(messages.getMessage('warning.unknown-definition-key', [k])));
+        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)]));
+        }
+        // Success guidance (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' : '';
+        this.log(messages.getMessage('success.next-step', [outputDir, shellQuoteArg(outputDir), apiVersionSuffix]));
+        this.info(messages.getMessage('success.app-id'));
+        this.info(messages.getMessage('success.dont-delete'));
+        this.info(messages.getMessage('success.eca-overwrite', [opts.eca.name ?? '']));
+        this.info(messages.getMessage('success.components-exist'));
+        // frontdoor.jsp handoff is a CLWR-only concern; don't show it for LWR_CORE runs.
+        if (opts.runtime === 'CLWR') {
+            this.info(messages.getMessage('success.frontdoor'));
+        }
+        return result; // --json returns the full CreateOutput (created[])
+    }
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,105 @@
+# examples
+
+- Generate a Lightning Out 2.0 app using individual flags to specify the values:
+
+  <%= 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:
+
+  <%= config.bin %> <%= command.id %> --definition-file lo-def.json
+
+- Generate the app into a specific directory:
+
+  <%= config.bin %> <%= command.id %> --definition-file lo-def.json --output-dir force-app/main/default
+
+- Generate the app using most of the values from a definition file, but the --host-domains value overrides its equivalent in the file:
+
+  <%= config.bin %> <%= command.id %> --definition-file lo-def.json --host-domains https://staging.example.com
+
+# summary
+
+Generate the required metadata to scaffold a Lightning Out 2.0 app.
+
+# description
+
+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 is generate-only; it doesn't deploy any metadata to an org.
+
+Inputs may 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.
+
+# flags.app-name.summary
+
+Developer name of the new Lightning Out 2.0 app.
+
+# flags.eca-name.summary
+
+Developer name of the External Client Application associated with the app.
+
+# flags.runtime.summary
+
+Runtime the app targets. LWR_CORE serves from your Salesforce org for authenticated users; CLWR serves from an Experience Cloud site (guest access, extra site-deployment step).
+
+# 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.
+
+# flags.components.summary
+
+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.
+
+# flags.eca-contact-email.summary
+
+Contact email for the External Client Application.
+
+# flags.eca-callback-url.summary
+
+OAuth callback URL for the External Client Application.
+
+# 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.
+
+# error.definition-file-json
+
+Definition file %s is not valid JSON: %s
+
+# error.definition-file-not-object
+
+Definition file %s must contain a single JSON object, not an array or scalar.
+
+# error.definition-file-field-type
+
+Definition file field "%s" must be %s.
+
+# warning.unknown-definition-key
+
+Ignoring unrecognized key "%s" in --definition-file.
+
+# 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.
+
+# success.next-step
+
+Scaffold generated in %s. Deploy it with: sf project deploy start --source-dir %s%s
+
+# success.app-id
+
+After deploying, note the LightningOutApp's App ID from Setup — your host page needs it to embed the app.
+
+# success.dont-delete
+
+Don't delete the generated ExternalClientApplication after deploying — Lightning Out uses it for OAuth at runtime.
+
+# success.eca-overwrite
+
+Re-running this command overwrites the generated files for the "%s" External Client Application; back up local edits first.
+
+# success.components-exist
+
+Verify that every component you referenced already exists and is exposed for Lightning Out before deploying.
+
+# success.frontdoor
+
+For CLWR, host pages must complete a frontdoor.jsp handoff before the embedded app can authenticate.

package/oclif.manifest.json

@@ -1,158 +1,5 @@
 {
   "commands": {
-    "template:generate:analytics:template": {
-      "aliases": [
-        "force:analytics:template:create",
-        "analytics:generate:template"
-      ],
-      "args": {},
-      "deprecateAliases": true,
-      "description": "The metadata files associated with the Analytics template must be contained in a parent directory called \"waveTemplates\" in your package directory. Either run this command from an existing directory of this name, or use the --output-dir flag to generate one or point to an existing one.",
-      "examples": [
-        "Generate the metadata files for a simple Analytics template file called myTemplate in the force-app/main/default/waveTemplates directory:\n<%= config.bin %> <%= command.id %> --name myTemplate --output-dir force-app/main/default/waveTemplates"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "flags-dir": {
-          "helpGroup": "GLOBAL",
-          "name": "flags-dir",
-          "summary": "Import flag values from a directory.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "output-dir": {
-          "aliases": [
-            "outputdir"
-          ],
-          "char": "d",
-          "deprecateAliases": true,
-          "description": "The location can be an absolute path or relative to the current working directory. The default is the current directory.",
-          "name": "output-dir",
-          "summary": "Directory for saving the created files.",
-          "default": ".",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "api-version": {
-          "aliases": [
-            "apiversion"
-          ],
-          "deprecateAliases": true,
-          "description": "Override the api version used for api requests made by this command",
-          "name": "api-version",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "name": {
-          "aliases": [
-            "templatename"
-          ],
-          "char": "n",
-          "deprecateAliases": true,
-          "name": "name",
-          "required": true,
-          "summary": "Name of the Analytics template.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "loglevel": {
-          "deprecated": {
-            "message": "The loglevel flag is no longer in use on this command. You may use it without error, but it will be ignored.\nSet the log level using the `SF_LOG_LEVEL` environment variable."
-          },
-          "hidden": true,
-          "name": "loglevel",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "template:generate:analytics:template",
-      "pluginAlias": "@salesforce/plugin-templates",
-      "pluginName": "@salesforce/plugin-templates",
-      "pluginType": "core",
-      "strict": true,
-      "summary": "Generate a simple Analytics template.",
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "lib",
-        "commands",
-        "template",
-        "generate",
-        "analytics",
-        "template.js"
-      ],
-      "aliasPermutations": [
-        "force:analytics:template:create",
-        "analytics:force:template:create",
-        "analytics:template:force:create",
-        "analytics:template:create:force",
-        "force:template:analytics:create",
-        "template:force:analytics:create",
-        "template:analytics:force:create",
-        "template:analytics:create:force",
-        "force:template:create:analytics",
-        "template:force:create:analytics",
-        "template:create:force:analytics",
-        "template:create:analytics:force",
-        "force:analytics:create:template",
-        "analytics:force:create:template",
-        "analytics:create:force:template",
-        "analytics:create:template:force",
-        "force:create:analytics:template",
-        "create:force:analytics:template",
-        "create:analytics:force:template",
-        "create:analytics:template:force",
-        "force:create:template:analytics",
-        "create:force:template:analytics",
-        "create:template:force:analytics",
-        "create:template:analytics:force",
-        "analytics:generate:template",
-        "generate:analytics:template",
-        "generate:template:analytics",
-        "analytics:template:generate",
-        "template:analytics:generate",
-        "template:generate:analytics"
-      ],
-      "permutations": [
-        "template:generate:analytics:template",
-        "generate:template:analytics:template",
-        "generate:analytics:template:template",
-        "generate:analytics:template:template",
-        "template:analytics:generate:template",
-        "analytics:template:generate:template",
-        "analytics:generate:template:template",
-        "analytics:generate:template:template",
-        "template:analytics:template:generate",
-        "analytics:template:template:generate",
-        "analytics:template:template:generate",
-        "analytics:template:generate:template",
-        "template:generate:template:analytics",
-        "generate:template:template:analytics",
-        "generate:template:template:analytics",
-        "generate:template:analytics:template",
-        "template:template:generate:analytics",
-        "template:template:generate:analytics",
-        "template:generate:template:analytics",
-        "template:generate:analytics:template",
-        "template:template:analytics:generate",
-        "template:template:analytics:generate",
-        "template:analytics:template:generate",
-        "template:analytics:generate:template"
-      ]
-    },
     "template:generate:apex:class": {
       "aliases": [
         "force:apex:class:create",
@@ -530,6 +377,159 @@
         "trigger:apex:generate:template"
       ]
     },
+    "template:generate:analytics:template": {
+      "aliases": [
+        "force:analytics:template:create",
+        "analytics:generate:template"
+      ],
+      "args": {},
+      "deprecateAliases": true,
+      "description": "The metadata files associated with the Analytics template must be contained in a parent directory called \"waveTemplates\" in your package directory. Either run this command from an existing directory of this name, or use the --output-dir flag to generate one or point to an existing one.",
+      "examples": [
+        "Generate the metadata files for a simple Analytics template file called myTemplate in the force-app/main/default/waveTemplates directory:\n<%= config.bin %> <%= command.id %> --name myTemplate --output-dir force-app/main/default/waveTemplates"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "output-dir": {
+          "aliases": [
+            "outputdir"
+          ],
+          "char": "d",
+          "deprecateAliases": true,
+          "description": "The location can be an absolute path or relative to the current working directory. The default is the current directory.",
+          "name": "output-dir",
+          "summary": "Directory for saving the created files.",
+          "default": ".",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-version": {
+          "aliases": [
+            "apiversion"
+          ],
+          "deprecateAliases": true,
+          "description": "Override the api version used for api requests made by this command",
+          "name": "api-version",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "name": {
+          "aliases": [
+            "templatename"
+          ],
+          "char": "n",
+          "deprecateAliases": true,
+          "name": "name",
+          "required": true,
+          "summary": "Name of the Analytics template.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "loglevel": {
+          "deprecated": {
+            "message": "The loglevel flag is no longer in use on this command. You may use it without error, but it will be ignored.\nSet the log level using the `SF_LOG_LEVEL` environment variable."
+          },
+          "hidden": true,
+          "name": "loglevel",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "template:generate:analytics:template",
+      "pluginAlias": "@salesforce/plugin-templates",
+      "pluginName": "@salesforce/plugin-templates",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Generate a simple Analytics template.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "template",
+        "generate",
+        "analytics",
+        "template.js"
+      ],
+      "aliasPermutations": [
+        "force:analytics:template:create",
+        "analytics:force:template:create",
+        "analytics:template:force:create",
+        "analytics:template:create:force",
+        "force:template:analytics:create",
+        "template:force:analytics:create",
+        "template:analytics:force:create",
+        "template:analytics:create:force",
+        "force:template:create:analytics",
+        "template:force:create:analytics",
+        "template:create:force:analytics",
+        "template:create:analytics:force",
+        "force:analytics:create:template",
+        "analytics:force:create:template",
+        "analytics:create:force:template",
+        "analytics:create:template:force",
+        "force:create:analytics:template",
+        "create:force:analytics:template",
+        "create:analytics:force:template",
+        "create:analytics:template:force",
+        "force:create:template:analytics",
+        "create:force:template:analytics",
+        "create:template:force:analytics",
+        "create:template:analytics:force",
+        "analytics:generate:template",
+        "generate:analytics:template",
+        "generate:template:analytics",
+        "analytics:template:generate",
+        "template:analytics:generate",
+        "template:generate:analytics"
+      ],
+      "permutations": [
+        "template:generate:analytics:template",
+        "generate:template:analytics:template",
+        "generate:analytics:template:template",
+        "generate:analytics:template:template",
+        "template:analytics:generate:template",
+        "analytics:template:generate:template",
+        "analytics:generate:template:template",
+        "analytics:generate:template:template",
+        "template:analytics:template:generate",
+        "analytics:template:template:generate",
+        "analytics:template:template:generate",
+        "analytics:template:generate:template",
+        "template:generate:template:analytics",
+        "generate:template:template:analytics",
+        "generate:template:template:analytics",
+        "generate:template:analytics:template",
+        "template:template:generate:analytics",
+        "template:template:generate:analytics",
+        "template:generate:template:analytics",
+        "template:generate:analytics:template",
+        "template:template:analytics:generate",
+        "template:template:analytics:generate",
+        "template:analytics:template:generate",
+        "template:analytics:generate:template"
+      ]
+    },
     "template:generate:digital-experience:site": {
       "aliases": [],
       "args": {},
@@ -1739,6 +1739,149 @@
         "test:lightning:generate:template"
       ]
     },
+    "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 is generate-only; it doesn't deploy any metadata to an org.\n\nInputs may 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 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": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "app-name": {
+          "name": "app-name",
+          "required": false,
+          "summary": "Developer name of the new Lightning Out 2.0 app.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "eca-name": {
+          "name": "eca-name",
+          "required": false,
+          "summary": "Developer name of the External Client Application associated with the app.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "runtime": {
+          "name": "runtime",
+          "summary": "Runtime the app targets. LWR_CORE serves from your Salesforce org for authenticated users; CLWR serves from an Experience Cloud site (guest access, extra site-deployment step).",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "LWR_CORE",
+            "CLWR"
+          ],
+          "type": "option"
+        },
+        "host-domains": {
+          "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.",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "components": {
+          "name": "components",
+          "summary": "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.",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "eca-contact-email": {
+          "name": "eca-contact-email",
+          "summary": "Contact email for the External Client Application.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "eca-callback-url": {
+          "name": "eca-callback-url",
+          "summary": "OAuth callback URL for the External Client Application.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "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.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "output-dir": {
+          "aliases": [
+            "outputdir"
+          ],
+          "char": "d",
+          "deprecateAliases": true,
+          "description": "The location can be an absolute path or relative to the current working directory. The default is the current directory.",
+          "name": "output-dir",
+          "summary": "Directory for saving the created files.",
+          "default": ".",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "loglevel": {
+          "deprecated": {
+            "message": "The loglevel flag is no longer in use on this command. You may use it without error, but it will be ignored.\nSet the log level using the `SF_LOG_LEVEL` environment variable."
+          },
+          "hidden": true,
+          "name": "loglevel",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hidden": true,
+      "hiddenAliases": [],
+      "id": "template:generate:lightning-out",
+      "pluginAlias": "@salesforce/plugin-templates",
+      "pluginName": "@salesforce/plugin-templates",
+      "pluginType": "core",
+      "state": "beta",
+      "strict": true,
+      "summary": "Generate the required metadata to scaffold a Lightning Out 2.0 app.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "template",
+        "generate",
+        "lightning-out",
+        "index.js"
+      ],
+      "aliasPermutations": [],
+      "permutations": [
+        "template:generate:lightning-out",
+        "generate:template:lightning-out",
+        "generate:lightning-out:template",
+        "template:lightning-out:generate",
+        "lightning-out:template:generate",
+        "lightning-out:generate:template"
+      ]
+    },
     "template:generate:project": {
       "aliases": [
         "force:project:create",
@@ -2670,5 +2813,5 @@
       ]
     }
   },
-  "version": "57.3.0"
+  "version": "57.4.1"
 }

package/package.json

@@ -1,20 +1,20 @@
 {
     "name": "@salesforce/plugin-templates",
     "description": "Commands to create metadata from a default or custom template",
-    "version": "57.3.0",
+    "version": "57.4.1",
     "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.1.9",
+        "@salesforce/core": "^9.2.0",
         "@salesforce/sf-plugins-core": "^13.0.4",
-        "@salesforce/templates": "^66.15.0"
+        "@salesforce/templates": "^66.16.0"
     },
     "devDependencies": {
         "@oclif/plugin-command-snapshot": "^6.0.0",
         "@salesforce/cli-plugins-testkit": "^5.3.66",
-        "@salesforce/dev-scripts": "^13.0.2",
+        "@salesforce/dev-scripts": "^14.0.0",
         "@salesforce/plugin-command-reference": "^3.1.132",
         "@types/chai": "^4.3.17",
         "@types/mocha": "^10.0.10",
@@ -22,11 +22,11 @@
         "@types/sinon": "^10.0.20",
         "@types/yeoman-assert": "^3.1.4",
         "eslint": "^10.4.0",
-        "eslint-config-salesforce-typescript": "^6.0.0",
+        "eslint-config-salesforce-typescript": "^7.0.0",
         "eslint-plugin-sf-plugin": "^3.0.0",
         "oclif": "^5.0.0",
         "ts-node": "^10.9.2",
-        "typescript": "^5.9.3",
+        "typescript": "^6.0.0",
         "yeoman-assert": "^3.1.1"
     },
     "homepage": "https://github.com/salesforcecli/plugin-templates",
@@ -259,7 +259,7 @@
     "exports": "./lib/index.js",
     "type": "module",
     "sfdx": {
-        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-templates/57.3.0.crt",
-        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-templates/57.3.0.sig"
+        "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-templates/57.4.1.crt",
+        "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-templates/57.4.1.sig"
     }
 }