@salesforce/ui-bundle-template-feature-angular-language-switcher 12.6.3-canary.999.2.1.gd0b2ab15 → 12.7.0

package/dist/CHANGELOG.md

@@ -3,6 +3,15 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [12.7.0](https://github.com/salesforce-experience-platform-emu/webapps/compare/v12.6.3...v12.7.0) (2026-09-22)
+
+
+### Bug Fixes
+
+* **template-sfdx-project:** preserve target network sender addresses @W-24209513@ ([#993](https://github.com/salesforce-experience-platform-emu/webapps/issues/993)) ([fddbfdd](https://github.com/salesforce-experience-platform-emu/webapps/commit/fddbfddcb41270720372b0fd4c486f043d9ba8c5))
+
+
+
 ## [12.6.3](https://github.com/salesforce-experience-platform-emu/webapps/compare/v12.6.2...v12.6.3) (2026-09-14)
 
 **Note:** Version bump only for package @salesforce/ui-bundle-template-base-sfdx-project

package/dist/README.md

@@ -24,6 +24,12 @@ default org or, in an interactive terminal, prompts you to pick one.
 npm run setup -- --target-org <alias>     # or omit --target-org to use the default / pick
 ```
 
+Before each Network deployment, setup reads the target org's existing sender
+address and preserves it in the local metadata. Sender changes must be made in
+the site's Administration settings. For a direct `sf project deploy` command,
+first run `node scripts/network-senders.mjs --target-org <alias>` after generating
+the project.
+
 Setup does **not** start the dev server. Once the org is set up, use `dev:preview` to
 refresh the GraphQL types against the org and launch the Vite dev server on its own:
 

package/dist/force-app/main/default/uiBundles/feature-angular-language-switcher/package.json

@@ -28,8 +28,8 @@
     "@angular/router": "^21.2.0",
     "@ng-icons/core": "^32.2.0",
     "@ng-icons/lucide": "^32.2.0",
-    "@salesforce/angular-plugin-ui-bundle": "^12.6.3-canary.999.2.1.gd0b2ab15",
-    "@salesforce/platform-sdk": "^12.6.3-canary.999.2.1.gd0b2ab15",
+    "@salesforce/angular-plugin-ui-bundle": "^12.7.0",
+    "@salesforce/platform-sdk": "^12.7.0",
     "@spartan-ng/brain": "^1.3.1",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
@@ -60,8 +60,8 @@
     "tailwindcss": "^4.0.0",
     "typescript": "~5.9.2",
     "typescript-eslint": "^8.0.0",
-    "vitest": "^4.1.0",
-    "@salesforce/graphiti": "^12.6.3-canary.999.2.1.gd0b2ab15"
+    "vitest": "^4.1.11",
+    "@salesforce/graphiti": "^12.7.0"
   },
   "overrides": {
     "undici": "^7.28.0"

package/dist/force-app/main/default/uiBundles/feature-angular-language-switcher/src/app/components/ui/button/button.ts

@@ -18,14 +18,7 @@ import { SpinnerComponent } from '../spinner/spinner';
 
 export type AppButtonAppearance = 'filled' | 'outlined' | 'text' | 'destructive';
 export type AppButtonSize =
-	| 'default'
-	| 'xs'
-	| 'sm'
-	| 'lg'
-	| 'icon'
-	| 'icon-xs'
-	| 'icon-sm'
-	| 'icon-lg';
+	'default' | 'xs' | 'sm' | 'lg' | 'icon' | 'icon-xs' | 'icon-sm' | 'icon-lg';
 
 const APPEARANCE_TO_VARIANT: Record<AppButtonAppearance, string> = {
 	filled: 'default',

package/dist/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@salesforce/ui-bundle-template-base-sfdx-project",
-  "version": "12.6.3-canary.999.2.1.gd0b2ab15",
+  "version": "12.7.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@salesforce/ui-bundle-template-base-sfdx-project",
-      "version": "12.6.3-canary.999.2.1.gd0b2ab15",
+      "version": "12.7.0",
       "license": "SEE LICENSE IN LICENSE.txt",
       "dependencies": {
         "fast-xml-parser": "^5.9.3",

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/ui-bundle-template-base-sfdx-project",
-  "version": "12.6.3-canary.999.2.1.gd0b2ab15",
+  "version": "12.7.0",
   "description": "Base SFDX project template",
   "license": "SEE LICENSE IN LICENSE.txt",
   "publishConfig": {

package/dist/scripts/network-senders.mjs

@@ -0,0 +1,84 @@
+import { execFileSync } from 'node:child_process';
+import { existsSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join, resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { XMLBuilder } from 'fast-xml-parser';
+import { parseNetworkDocument, NetworkXmlError } from './org-setup-xml.mjs';
+import { escapeSoqlString } from './org-setup-utils.mjs';
+
+const builder = new XMLBuilder({
+  ignoreAttributes: false,
+  commentPropName: '#comment',
+  format: true,
+  indentBy: '    ',
+  suppressEmptyNode: true,
+});
+
+export function preserveNetworkSenders(projectDir, targetOrg, run = execFileSync) {
+  const project = JSON.parse(readFileSync(join(projectDir, 'sfdx-project.json'), 'utf8'));
+  const files = (project.packageDirectories ?? []).flatMap(({ path }) => {
+    const dir = join(projectDir, path, 'main/default/networks');
+    if (!existsSync(dir)) return [];
+    return readdirSync(dir)
+      .filter((name) => name.endsWith('.network-meta.xml'))
+      .map((name) => ({ name: name.slice(0, -'.network-meta.xml'.length), path: join(dir, name) }));
+  });
+  if (!files.length) return;
+
+  const names = [...new Set(files.map(({ name }) => `'${escapeSoqlString(name)}'`))];
+  const response = JSON.parse(run('sf', [
+    'data', 'query', '--target-org', targetOrg,
+    '--query', `SELECT Name, EmailSenderAddress FROM Network WHERE Name IN (${names.join(',')})`,
+    '--json',
+  ], { cwd: projectDir, encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'], timeout: 60000 }));
+  if (response.status !== 0 || !Array.isArray(response.result?.records) || !response.result.done) {
+    throw new Error('Could not read all target Network sender addresses; deployment stopped.');
+  }
+  const senders = new Map(response.result.records.map((record) => [record.Name, record.EmailSenderAddress]));
+
+  const updates = files.map((file) => {
+    const original = readFileSync(file.path, 'utf8');
+    const document = parseNetworkDocument(original);
+    const network = document.Network;
+    let changed = false;
+    if (senders.has(file.name)) {
+      const sender = senders.get(file.name);
+      if (typeof sender !== 'string' || !sender.trim()) {
+        throw new Error(`The target Network "${file.name}" has no sender address; deployment stopped.`);
+      }
+      if (typeof network.emailSenderAddress !== 'string') {
+        throw new NetworkXmlError(`Expected one emailSenderAddress in ${file.name}.network-meta.xml`);
+      }
+      if (network.emailSenderAddress !== sender) {
+        network.emailSenderAddress = sender;
+        changed = true;
+      }
+    }
+    // Sender changes belong to the site's Administration workspace.
+    if ('newSenderAddress' in network) {
+      delete network.newSenderAddress;
+      changed = true;
+    }
+    return { ...file, xml: changed ? builder.build(document) : original, changed };
+  });
+
+  for (const file of updates) {
+    if (file.changed) writeFileSync(file.path, file.xml);
+  }
+}
+
+if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+  const args = process.argv.slice(2);
+  if (args.length !== 2 || args[0] !== '--target-org' || !args[1].trim()) {
+    console.error('Usage: node scripts/network-senders.mjs --target-org <alias>');
+    process.exitCode = 1;
+  } else {
+    try {
+      preserveNetworkSenders(resolve(dirname(fileURLToPath(import.meta.url)), '..'), args[1]);
+      console.log('Network metadata prepared with the target org sender addresses.');
+    } catch (error) {
+      console.error(`Network metadata preparation failed: ${error.message}`);
+      process.exitCode = 1;
+    }
+  }
+}

package/dist/scripts/org-setup-xml.mjs

@@ -39,6 +39,7 @@ const parser = new XMLParser({
   ignoreAttributes: false,
   parseTagValue: false,
   parseAttributeValue: false,
+  commentPropName: '#comment',
 });
 
 /**
@@ -73,22 +74,26 @@ export function assertSafeProfileName(name) {
 }
 
 /**
- * Parse + assert this is a Network metadata document. Returns the parsed
- * `Network` object. Throws NetworkXmlError if the root is missing (e.g. a file
+ * Parse + assert this is a Network metadata document. Returns the full parsed
+ * document. Throws NetworkXmlError if the root is missing (e.g. a file
  * that is not actually network metadata).
  */
-export function parseNetwork(xml) {
+export function parseNetworkDocument(xml) {
   let parsed;
   try {
-    parsed = parser.parse(xml);
+    parsed = parser.parse(xml, true);
   } catch (e) {
     throw new NetworkXmlError(`network metadata is not well-formed XML: ${e.message}`);
   }
   const network = parsed?.[NETWORK_ROOT];
-  if (network == null || typeof network !== 'object') {
+  if (network == null || typeof network !== 'object' || Array.isArray(network)) {
     throw new NetworkXmlError(`expected a <${NETWORK_ROOT}> root node, but none was found`);
   }
-  return network;
+  return parsed;
+}
+
+export function parseNetwork(xml) {
+  return parseNetworkDocument(xml)[NETWORK_ROOT];
 }
 
 /** Normalize a fast-xml-parser child (absent | scalar | array) to an array. */

package/dist/scripts/org-setup.mjs

@@ -55,6 +55,7 @@ import {
 import { tmpdir } from 'node:os';
 
 import { validateConfig } from './org-setup-config-schema.mjs';
+import { preserveNetworkSenders } from './network-senders.mjs';
 import {
   addProfileToMemberGroups,
   enableSelfRegInXml,
@@ -1149,9 +1150,14 @@ function ensureLogoutUrl(logoutUrl, siteName, targetOrg) {
   writeFileSync(networkXmlPath, result.xml);
   console.log(`  Set <logoutUrl>${absoluteUrl}</logoutUrl> in ${siteName}.network-meta.xml`);
 
-  // Re-deploy ONLY the network file (mirrors enableSelfRegistration). Best-effort:
-  // a non-zero exit (e.g. the org's emailSenderAddress differs from the shipped
-  // value and can't be updated) logs loudly and continues.
+  try {
+    preserveNetworkSenders(ROOT, targetOrg);
+  } catch (e) {
+    console.error(`  ERROR: cannot prepare Network metadata for "${siteName}" — ${e.message}. Skipping logout URL deployment.`);
+    return;
+  }
+
+  // Logout URL deployment is best-effort.
   const deployResult = spawnSync('sf', [
     'project', 'deploy', 'start',
     '--target-org', targetOrg,
@@ -1160,8 +1166,7 @@ function ensureLogoutUrl(logoutUrl, siteName, targetOrg) {
   if (deployResult.status !== 0) {
     console.error(
       `  ERROR: failed to deploy <logoutUrl> for "${siteName}" (sf exit ${deployResult.status ?? 1}). ` +
-      `If the org's Network emailSenderAddress differs from the shipped value it blocks this deploy — ` +
-      `set the logout URL manually in the site's Administration settings.`,
+      `Set the logout URL manually in the site's Administration settings.`,
     );
     return;
   }
@@ -1208,6 +1213,8 @@ function enableSelfRegistration(selfRegConfig, siteName, targetOrg) {
     writeFileSync(networkXmlPath, result.xml);
     console.log(`  Updated ${siteName}.network-meta.xml: selfRegistration=true, selfRegProfile=${selfRegProfile}`);
 
+    preserveNetworkSenders(ROOT, targetOrg);
+
     // Re-deploy only the network file
     const deployResult = spawnSync('sf', [
       'project', 'deploy', 'start',
@@ -2118,6 +2125,7 @@ async function main() {
           throw new StepError(`deploy blocked — ${licenseGate.reason}`);
         }
       }
+      preserveNetworkSenders(ROOT, targetOrg);
       run('Deploy metadata', 'sf', ['project', 'deploy', 'start', '--target-org', targetOrg], {
         timeout: 180000,
       });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/ui-bundle-template-feature-angular-language-switcher",
-  "version": "12.6.3-canary.999.2.1.gd0b2ab15",
+  "version": "12.7.0",
   "private": false,
   "engines": {
     "node": ">=22"

package/dist/LICENSE.txt

@@ -1,82 +0,0 @@
-Terms of Use
-
-Copyright 2026 Salesforce, Inc. All rights reserved.
-
-These Terms of Use govern the download, installation, and/or use of this
-software provided by Salesforce, Inc. ("Salesforce") (the "Software"), were
-last updated on April 15, 2025, and constitute a legally binding
-agreement between you and Salesforce. If you do not agree to these Terms of
-Use, do not install or use the Software.
-
-Salesforce grants you a worldwide, non-exclusive, no-charge, royalty-free
-copyright license to reproduce, prepare derivative works of, publicly
-display, publicly perform, sublicense, and distribute the Software and
-derivative works subject to these Terms. These Terms shall be included in
-all copies or substantial portions of the Software.
-
-Subject to the limited rights expressly granted hereunder, Salesforce
-reserves all rights, title, and interest in and to all intellectual
-property subsisting in the Software. No rights are granted to you hereunder
-other than as expressly set forth herein. Users residing in countries on
-the United States Office of Foreign Assets Control sanction list, or which
-are otherwise subject to a US export embargo, may not use the Software.
-
-Implementation of the Software may require development work, for which you
-are responsible. The Software may contain bugs, errors and
-incompatibilities and is made available on an AS IS basis without support,
-updates, or service level commitments.
-
-Salesforce reserves the right at any time to modify, suspend, or
-discontinue, the Software (or any part thereof) with or without notice. You
-agree that Salesforce shall not be liable to you or to any third party for
-any modification, suspension, or discontinuance.
-
-You agree to defend Salesforce against any claim, demand, suit or
-proceeding made or brought against Salesforce by a third party arising out
-of or accruing from (a) your use of the Software, and (b) any application
-you develop with the Software that infringes any copyright, trademark,
-trade secret, trade dress, patent, or other intellectual property right of
-any person or defames any person or violates their rights of publicity or
-privacy (each a "Claim Against Salesforce"), and will indemnify Salesforce
-from any damages, attorney fees, and costs finally awarded against
-Salesforce as a result of, or for any amounts paid by Salesforce under a
-settlement approved by you in writing of, a Claim Against Salesforce,
-provided Salesforce (x) promptly gives you written notice of the Claim
-Against Salesforce, (y) gives you sole control of the defense and
-settlement of the Claim Against Salesforce (except that you may not settle
-any Claim Against Salesforce unless it unconditionally releases Salesforce
-of all liability), and (z) gives you all reasonable assistance, at your
-expense.
-
-WITHOUT LIMITING THE GENERALITY OF THE FOREGOING, THE SOFTWARE IS NOT
-SUPPORTED AND IS PROVIDED "AS IS," WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED. IN NO EVENT SHALL SALESFORCE HAVE ANY LIABILITY FOR ANY DAMAGES,
-INCLUDING, BUT NOT LIMITED TO, DIRECT, INDIRECT, SPECIAL, INCIDENTAL,
-PUNITIVE, OR CONSEQUENTIAL DAMAGES, OR DAMAGES BASED ON LOST PROFITS, DATA,
-OR USE, IN CONNECTION WITH THE SOFTWARE, HOWEVER CAUSED AND WHETHER IN
-CONTRACT, TORT, OR UNDER ANY OTHER THEORY OF LIABILITY, WHETHER OR NOT YOU
-HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
-
-These Terms of Use shall be governed exclusively by the internal laws of
-the State of California, without regard to its conflicts of laws
-rules. Each party hereby consents to the exclusive jurisdiction of the
-state and federal courts located in San Francisco County, California to
-adjudicate any dispute arising out of or relating to these Terms of Use and
-the download, installation, and/or use of the Software. Except as expressly
-stated herein, these Terms of Use constitute the entire agreement between
-the parties, and supersede all prior and contemporaneous agreements,
-proposals, or representations, written or oral, concerning their subject
-matter. No modification, amendment, or waiver of any provision of these
-Terms of Use shall be effective unless it is by an update to these Terms of
-Use that Salesforce makes available, or is in writing and signed by the
-party against whom the modification, amendment, or waiver is to be
-asserted.
-
-Data Privacy: Salesforce may collect, process, and store device,
-system, and other information related to your use of the Software. This
-information includes, but is not limited to, IP address, user metrics, and
-other data ("Usage Data"). Salesforce may use Usage Data for analytics,
-product development, and marketing purposes. You acknowledge that files
-generated in conjunction with the Software may contain sensitive or
-confidential data, and you are solely responsible for anonymizing and
-protecting such data.