@salesforce/webapp-template-app-react-sample-b2e-experimental 1.92.0 → 1.93.0

package/dist/force-app/main/default/webapplications/appreactsampleb2e/package.json

@@ -15,9 +15,9 @@
     "graphql:schema": "node scripts/get-graphql-schema.mjs"
   },
   "dependencies": {
-    "@salesforce/agentforce-conversation-client": "^1.92.0",
-    "@salesforce/sdk-data": "^1.92.0",
-    "@salesforce/webapp-experimental": "^1.92.0",
+    "@salesforce/agentforce-conversation-client": "^1.93.0",
+    "@salesforce/sdk-data": "^1.93.0",
+    "@salesforce/webapp-experimental": "^1.93.0",
     "@tailwindcss/vite": "^4.1.17",
     "@tanstack/react-form": "^1.28.4",
     "class-variance-authority": "^0.7.1",
@@ -42,7 +42,7 @@
     "@graphql-eslint/eslint-plugin": "^4.1.0",
     "@graphql-tools/utils": "^11.0.0",
     "@playwright/test": "^1.49.0",
-    "@salesforce/vite-plugin-webapp-experimental": "^1.92.0",
+    "@salesforce/vite-plugin-webapp-experimental": "^1.93.0",
     "@testing-library/jest-dom": "^6.6.3",
     "@testing-library/react": "^16.1.0",
     "@testing-library/user-event": "^14.5.2",

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/webapp-template-base-sfdx-project-experimental",
-  "version": "1.92.0",
+  "version": "1.93.0",
   "description": "Base SFDX project template",
   "private": true,
   "files": [

package/dist/scripts/prepare-import-unique-fields.js

@@ -5,7 +5,7 @@
  *
  * Usage:
  *   node scripts/prepare-import-unique-fields.js
- *   node scripts/prepare-import-unique-fields.js --data-dir /path/to/force-app/main/default/data
+ *   node scripts/prepare-import-unique-fields.js --data-dir /path/to/<sfdx-source>/data
  *
  * Expects data dir to contain (optional) JSON files:
  *   Contact.json (Email with unique domain per run, LastName, FirstName, Phone — standard Contact)
@@ -18,8 +18,22 @@
 const fs = require('fs');
 const path = require('path');
 
-// When run from project root: scripts/prepare-import-unique-fields.js → data dir under force-app
-const DEFAULT_DATA_DIR = path.resolve(__dirname, '..', 'force-app/main/default/data');
+function resolveSfdxSource() {
+  const sfdxPath = path.resolve(__dirname, '..', 'sfdx-project.json');
+  if (!fs.existsSync(sfdxPath)) {
+    console.error('Error: sfdx-project.json not found at project root.');
+    process.exit(1);
+  }
+  const sfdxProject = JSON.parse(fs.readFileSync(sfdxPath, 'utf8'));
+  const pkgDir = sfdxProject?.packageDirectories?.[0]?.path;
+  if (!pkgDir) {
+    console.error('Error: No packageDirectories[].path found in sfdx-project.json.');
+    process.exit(1);
+  }
+  return path.resolve(__dirname, '..', pkgDir, 'main', 'default');
+}
+
+const DEFAULT_DATA_DIR = path.resolve(resolveSfdxSource(), 'data');
 
 function parseArgs() {
   const args = process.argv.slice(2);

package/dist/scripts/setup-cli.mjs

@@ -4,37 +4,56 @@
  * Use this script to make setup easier for each app generated from this template.
  *
  * Usage:
- *   node scripts/setup-cli.mjs --target-org <alias>   # run all steps
+ *   node scripts/setup-cli.mjs --target-org <alias>           # interactive step picker (all selected)
+ *   node scripts/setup-cli.mjs --target-org <alias> --yes     # skip picker, run all steps
  *   node scripts/setup-cli.mjs --target-org afv5 --skip-login
  *   node scripts/setup-cli.mjs --target-org afv5 --skip-data --skip-webapp-build
  *   node scripts/setup-cli.mjs --target-org myorg --webapp-name my-app
  *
  * Steps (in order):
  *   1. login     — sf org login web only if org not already connected (skip with --skip-login)
- *   2. deploy    — sf project deploy start --target-org <alias>
- *   3. permset   — sf org assign permset (skip with --skip-permset; name via --permset-name)
- *   4. data      — prepare unique fields + sf data import tree (skipped if no data dir/plan)
- *   5. graphql   — (in webapp) npm run graphql:schema then npm run graphql:codegen
- *   6. webapp    — (in webapp) npm install && npm run build
+ *   2. webapp    — (all web apps) npm install && npm run build so dist exists for deploy (skip with --skip-webapp-build)
+ *   3. deploy    — sf project deploy start --target-org <alias> (requires dist for entity deployment)
+ *   4. permset   — sf org assign permset (skip with --skip-permset; name via --permset-name)
+ *   5. data      — prepare unique fields + sf data import tree (skipped if no data dir/plan)
+ *   6. graphql   — (in webapp) npm run graphql:schema then npm run graphql:codegen
  *   7. dev       — (in webapp) npm run dev — launch dev server (skip with --skip-dev)
  */
 
 import { spawnSync } from 'node:child_process';
 import { resolve, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { readdirSync, existsSync } from 'node:fs';
+import { readdirSync, existsSync, readFileSync, writeFileSync, unlinkSync } from 'node:fs';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const ROOT = resolve(__dirname, '..');
-const WEBAPPLICATIONS_DIR = resolve(ROOT, 'force-app/main/default/webapplications');
-const DATA_DIR = resolve(ROOT, 'force-app/main/default/data');
-const DATA_PLAN = resolve(ROOT, 'force-app/main/default/data/data-plan.json');
+
+function resolveSfdxSource() {
+  const sfdxPath = resolve(ROOT, 'sfdx-project.json');
+  if (!existsSync(sfdxPath)) {
+    console.error('Error: sfdx-project.json not found at project root.');
+    process.exit(1);
+  }
+  const sfdxProject = JSON.parse(readFileSync(sfdxPath, 'utf8'));
+  const pkgDir = sfdxProject?.packageDirectories?.[0]?.path;
+  if (!pkgDir) {
+    console.error('Error: No packageDirectories[].path found in sfdx-project.json.');
+    process.exit(1);
+  }
+  return resolve(ROOT, pkgDir, 'main', 'default');
+}
+
+const SFDX_SOURCE = resolveSfdxSource();
+const WEBAPPLICATIONS_DIR = resolve(SFDX_SOURCE, 'webapplications');
+const DATA_DIR = resolve(SFDX_SOURCE, 'data');
+const DATA_PLAN = resolve(SFDX_SOURCE, 'data/data-plan.json');
 
 function parseArgs() {
   const args = process.argv.slice(2);
   let targetOrg = null;
   let webappName = null;
   let permsetName = 'Property_Management_Access';
+  let yes = false;
   const flags = {
     skipLogin: false,
     skipDeploy: false,
@@ -58,6 +77,7 @@ function parseArgs() {
     else if (args[i] === '--skip-graphql') flags.skipGraphql = true;
     else if (args[i] === '--skip-webapp-build') flags.skipWebappBuild = true;
     else if (args[i] === '--skip-dev') flags.skipDev = true;
+    else if (args[i] === '--yes' || args[i] === '-y') yes = true;
     else if (args[i] === '--help' || args[i] === '-h') {
       console.log(`
 Setup CLI — one-command setup for apps in this project
@@ -78,6 +98,7 @@ Options:
   --skip-graphql         Do not fetch schema or run GraphQL codegen
   --skip-webapp-build    Do not npm install / build the web application
   --skip-dev             Do not launch the dev server at the end
+  -y, --yes              Skip interactive step picker; run all enabled steps immediately
   -h, --help             Show this help
 `);
       process.exit(0);
@@ -87,18 +108,10 @@ Options:
     console.error('Error: --target-org <alias> is required.');
     process.exit(1);
   }
-  return { targetOrg, webappName, permsetName, ...flags };
+  return { targetOrg, webappName, permsetName, yes, ...flags };
 }
 
-function discoverWebappDir(webappName) {
-  if (webappName) {
-    const dir = resolve(WEBAPPLICATIONS_DIR, webappName);
-    if (!existsSync(dir)) {
-      console.error(`Error: Web app directory not found: ${dir}`);
-      process.exit(1);
-    }
-    return dir;
-  }
+function discoverAllWebappDirs(webappName) {
   if (!existsSync(WEBAPPLICATIONS_DIR)) {
     console.error(`Error: webapplications directory not found: ${WEBAPPLICATIONS_DIR}`);
     process.exit(1);
@@ -109,10 +122,23 @@ function discoverWebappDir(webappName) {
     console.error(`Error: No web app folder found under ${WEBAPPLICATIONS_DIR}`);
     process.exit(1);
   }
-  if (dirs.length > 1) {
-    console.log(`Multiple web apps found; using first: ${dirs[0].name}`);
+  if (webappName) {
+    const requested = dirs.find((d) => d.name === webappName);
+    if (!requested) {
+      console.error(`Error: Web app directory not found: ${webappName}`);
+      process.exit(1);
+    }
+    return [resolve(WEBAPPLICATIONS_DIR, requested.name)];
+  }
+  return dirs.map((d) => resolve(WEBAPPLICATIONS_DIR, d.name));
+}
+
+function discoverWebappDir(webappName) {
+  const all = discoverAllWebappDirs(webappName);
+  if (all.length > 1 && !webappName) {
+    console.log(`Multiple web apps found; using first: ${all[0].split(/[/\\]/).pop()}`);
   }
-  return resolve(WEBAPPLICATIONS_DIR, dirs[0].name);
+  return all[0];
 }
 
 function isOrgConnected(targetOrg) {
@@ -124,6 +150,117 @@ function isOrgConnected(targetOrg) {
   return result.status === 0;
 }
 
+function apexLiteral(value) {
+  if (value === null || value === undefined) return 'null';
+  if (typeof value === 'boolean') return String(value);
+  if (typeof value === 'number') return String(value);
+  const s = String(value);
+  if (/^\d{4}-\d{2}-\d{2}$/.test(s)) return `Date.valueOf('${s}')`;
+  if (/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}/.test(s)) {
+    const dt = s.replace('T', ' ').replace(/\.\d+/, '').replace('Z', '');
+    return `DateTime.valueOf('${dt}')`;
+  }
+  return "'" + s.replace(/\\/g, '\\\\').replace(/'/g, "\\'") + "'";
+}
+
+function buildApexInsert(sobject, records, refIds) {
+  const lines = [
+    'Database.DMLOptions dmlOpts = new Database.DMLOptions();',
+    'dmlOpts.DuplicateRuleHeader.allowSave = true;',
+    `List<${sobject}> recs = new List<${sobject}>();`,
+  ];
+  for (const rec of records) {
+    lines.push(`{ ${sobject} r = new ${sobject}();`);
+    for (const [key, val] of Object.entries(rec)) {
+      if (key === 'attributes') continue;
+      lines.push(`r.put('${key}', ${apexLiteral(val)});`);
+    }
+    lines.push('recs.add(r); }');
+  }
+  lines.push('Database.SaveResult[] results = Database.insert(recs, dmlOpts);');
+  const refArray = refIds.map((r) => `'${r}'`).join(',');
+  lines.push(`String[] refs = new String[]{${refArray}};`);
+  lines.push('for (Integer i = 0; i < results.size(); i++) {');
+  lines.push("  if (results[i].isSuccess()) System.debug('REF:' + refs[i] + ':' + results[i].getId());");
+  lines.push("  else System.debug('ERR:' + refs[i] + ':' + results[i].getErrors()[0].getMessage());");
+  lines.push('}');
+  return lines.join('\n');
+}
+
+/**
+ * Interactive multi-select: arrow keys navigate, space toggles, 'a' toggles all, enter confirms.
+ * Returns a boolean[] matching the input order.  Falls through immediately when stdin is not a TTY.
+ */
+async function promptSteps(steps) {
+  if (!process.stdin.isTTY) return steps.map((s) => s.enabled);
+
+  const selected = steps.map((s) => s.enabled);
+  let cursor = 0;
+  const DIM = '\x1B[2m';
+  const RST = '\x1B[0m';
+  const CYAN = '\x1B[36m';
+  const GREEN = '\x1B[32m';
+
+  function render() {
+    return steps.map((s, i) => {
+      const ptr = i === cursor ? `${CYAN}❯${RST}` : ' ';
+      if (!s.available) return `${ptr} ${DIM}○ ${s.label} (n/a)${RST}`;
+      const chk = selected[i] ? `${GREEN}●${RST}` : '○';
+      return `${ptr} ${chk} ${s.label}`;
+    });
+  }
+
+  return new Promise((resolve) => {
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    process.stdin.setEncoding('utf8');
+    process.stdout.write('\x1B[?25l');
+    console.log('\nSelect steps (↑↓ move, space toggle, a all, enter confirm):\n');
+    process.stdout.write(render().join('\n') + '\n');
+
+    function redraw() {
+      process.stdout.write(`\x1B[${steps.length}A`);
+      for (const line of render()) process.stdout.write(`\x1B[2K${line}\n`);
+    }
+
+    process.stdin.on('data', (key) => {
+      if (key === '\x03') {
+        process.stdout.write('\x1B[?25h\n');
+        process.exit(0);
+      }
+      if (key === '\r' || key === '\n') {
+        process.stdout.write('\x1B[?25h');
+        process.stdin.setRawMode(false);
+        process.stdin.pause();
+        process.stdin.removeAllListeners('data');
+        console.log();
+        resolve(selected);
+        return;
+      }
+      if (key === ' ') {
+        if (steps[cursor].available) selected[cursor] = !selected[cursor];
+        redraw();
+        return;
+      }
+      if (key === 'a') {
+        const allOn = steps.every((s, i) => !s.available || selected[i]);
+        for (let i = 0; i < steps.length; i++) {
+          if (steps[i].available) selected[i] = !allOn;
+        }
+        redraw();
+        return;
+      }
+      if (key === '\x1B[A' || key === 'k') {
+        cursor = Math.max(0, cursor - 1);
+        redraw();
+      } else if (key === '\x1B[B' || key === 'j') {
+        cursor = Math.min(steps.length - 1, cursor + 1);
+        redraw();
+      }
+    });
+  });
+}
+
 function run(name, cmd, args, opts = {}) {
   const { cwd = ROOT, optional = false } = opts;
   console.log('\n---', name, '---');
@@ -140,25 +277,52 @@ function run(name, cmd, args, opts = {}) {
   return result;
 }
 
-function main() {
+async function main() {
   const {
     targetOrg,
     webappName,
     permsetName,
-    skipLogin,
-    skipDeploy,
-    skipPermset,
-    skipData,
-    skipGraphql,
-    skipWebappBuild,
-    skipDev,
+    yes,
+    skipLogin: argSkipLogin,
+    skipDeploy: argSkipDeploy,
+    skipPermset: argSkipPermset,
+    skipData: argSkipData,
+    skipGraphql: argSkipGraphql,
+    skipWebappBuild: argSkipWebappBuild,
+    skipDev: argSkipDev,
   } = parseArgs();
 
-  const webappDir = discoverWebappDir(webappName);
   const hasDataPlan = existsSync(DATA_PLAN) && existsSync(DATA_DIR);
-  const doData = !skipData && hasDataPlan;
 
-  console.log('Setup — target org:', targetOrg, '| web app:', webappDir);
+  const stepDefs = [
+    { key: 'login', label: 'Login — org authentication', enabled: !argSkipLogin, available: true },
+    { key: 'webappBuild', label: 'Webapp Build — npm install + build (pre-deploy)', enabled: !argSkipWebappBuild, available: true },
+    { key: 'deploy', label: 'Deploy — sf project deploy start', enabled: !argSkipDeploy, available: true },
+    { key: 'permset', label: `Permset — assign ${permsetName}`, enabled: !argSkipPermset, available: true },
+    { key: 'data', label: 'Data — delete + import records via Apex', enabled: !argSkipData && hasDataPlan, available: hasDataPlan },
+    { key: 'graphql', label: 'GraphQL — schema introspect + codegen', enabled: !argSkipGraphql, available: true },
+    { key: 'dev', label: 'Dev — launch dev server', enabled: !argSkipDev, available: true },
+  ];
+
+  const selections = yes ? stepDefs.map((s) => s.enabled) : await promptSteps(stepDefs);
+  const on = {};
+  stepDefs.forEach((s, i) => {
+    on[s.key] = selections[i];
+  });
+
+  const skipLogin = !on.login;
+  const skipWebappBuild = !on.webappBuild;
+  const skipDeploy = !on.deploy;
+  const skipPermset = !on.permset;
+  const skipData = !on.data;
+  const skipGraphql = !on.graphql;
+  const skipDev = !on.dev;
+
+  const needsWebapp = !skipWebappBuild || !skipGraphql || !skipDev;
+  const webappDir = needsWebapp ? discoverWebappDir(webappName) : null;
+  const doData = !skipData;
+
+  console.log('Setup — target org:', targetOrg, '| web app:', webappDir ?? '(none)');
   console.log(
     'Steps: login=%s deploy=%s permset=%s data=%s graphql=%s webapp=%s dev=%s',
     !skipLogin,
@@ -169,11 +333,6 @@ function main() {
     !skipWebappBuild,
     !skipDev
   );
-  if (skipData && hasDataPlan) {
-    console.log('(Data dir present; use without --skip-data to run data import.)');
-  } else if (!hasDataPlan && !skipData) {
-    console.log('(No data plan found; skipping data step.)');
-  }
 
   if (!skipLogin) {
     if (isOrgConnected(targetOrg)) {
@@ -184,6 +343,16 @@ function main() {
     }
   }
 
+  // Build all web apps before deploy so dist exists for entity deployment
+  if (!skipDeploy && !skipWebappBuild) {
+    const allWebappDirs = discoverAllWebappDirs(webappName);
+    for (const dir of allWebappDirs) {
+      const name = dir.split(/[/\\]/).pop();
+      run(`Web app install (${name})`, 'npm', ['install'], { cwd: dir });
+      run(`Web app build (${name})`, 'npm', ['run', 'build'], { cwd: dir });
+    }
+  }
+
   if (!skipDeploy) {
     run('Deploy metadata', 'sf', ['project', 'deploy', 'start', '--target-org', targetOrg], {
       timeout: 180000,
@@ -225,36 +394,115 @@ function main() {
     run('Prepare data (unique fields)', 'node', [prepareScript, '--data-dir', DATA_DIR], {
       cwd: ROOT,
     });
-    // Data import tree: if only DUPLICATES_DETECTED (org duplicate rules), warn and continue
+    // Normalize Lease__c Tenant refs to 1–15 so all refs resolve (Tenant__c.json has 15 records)
+    const leasePath = resolve(DATA_DIR, 'Lease__c.json');
+    if (existsSync(leasePath)) {
+      let leaseContent = readFileSync(leasePath, 'utf8');
+      leaseContent = leaseContent.replace(/@TenantRef(\d+)/g, (_m, n) => {
+        const k = ((parseInt(n, 10) - 1) % 15) + 1;
+        return `@TenantRef${k}`;
+      });
+      writeFileSync(leasePath, leaseContent);
+    }
+
+    // Delete existing records so every run inserts the full dataset without duplicate conflicts.
+    // Reverse plan order ensures children are removed before parents (FK safety).
+    console.log('\n--- Clean existing data for fresh import ---');
+    const planEntries = JSON.parse(readFileSync(DATA_PLAN, 'utf8'));
+    const sobjectsReversed = [...planEntries.map((e) => e.sobject)].reverse();
+    const tmpApex = resolve(ROOT, '.tmp-setup-delete.apex');
+    for (const sobject of sobjectsReversed) {
+      const apexCode = [
+        'try {',
+        `  List<SObject> recs = Database.query('SELECT Id FROM ${sobject} LIMIT 10000');`,
+        '  if (!recs.isEmpty()) {',
+        '    Database.delete(recs, false);',
+        '    Database.emptyRecycleBin(recs);',
+        '  }',
+        '} catch (Exception e) {',
+        '  // non-deletable records (e.g. Contact linked to Case) are skipped via allOrNone=false',
+        '}',
+      ].join('\n');
+      writeFileSync(tmpApex, apexCode);
+      spawnSync('sf', ['apex', 'run', '--target-org', targetOrg, '--file', tmpApex], {
+        cwd: ROOT,
+        stdio: 'pipe',
+        shell: true,
+        timeout: 60000,
+      });
+      console.log(`  ${sobject}: cleaned`);
+    }
+    if (existsSync(tmpApex)) unlinkSync(tmpApex);
+
+    // Import via Anonymous Apex with Database.DMLOptions.duplicateRuleHeader.allowSave = true.
+    // This bypasses both duplicate-rule blocks AND matching-service timeouts that the REST
+    // API headers (Sforce-Duplicate-Rule-Action) cannot override.
     console.log('\n--- Data import tree ---');
-    const importResult = spawnSync(
-      'sf',
-      ['data', 'import', 'tree', '--plan', DATA_PLAN, '--target-org', targetOrg, '--json'],
-      { cwd: ROOT, stdio: 'pipe', shell: true, timeout: 120000 }
-    );
-    const out = (importResult.stdout?.toString() || '') + (importResult.stderr?.toString() || '');
-    if (importResult.status !== 0) {
-      let onlyDuplicates = false;
-      try {
-        const j = JSON.parse(out);
-        const errors = Array.isArray(j?.data) ? j.data : [];
-        onlyDuplicates =
-          errors.length > 0 &&
-          errors.every((e) => e.StatusCode === 'DUPLICATES_DETECTED' || e.statusCode === 'DUPLICATES_DETECTED');
-      } catch (_) {
-        onlyDuplicates = out.includes('DUPLICATES_DETECTED') && /Use one of these records\?/.test(out);
-      }
-      if (onlyDuplicates) {
-        console.warn(
-          'Data import hit org duplicate rules (e.g. Contact). Skipping import; rest of setup continues.'
-        );
-      } else {
-        process.stdout.write(importResult.stdout?.toString() || '');
-        process.stderr.write(importResult.stderr?.toString() || '');
-        console.error('\nSetup failed at step: Data import tree');
-        process.exit(importResult.status ?? 1);
+    const refMap = new Map();
+    const APEX_CHAR_LIMIT = 25000;
+    const APEX_MAX_BATCH = 200;
+
+    for (const entry of planEntries) {
+      for (const file of entry.files) {
+        const data = JSON.parse(readFileSync(resolve(DATA_DIR, file), 'utf8'));
+        const records = data.records || [];
+
+        for (const rec of records) {
+          for (const key of Object.keys(rec)) {
+            if (key === 'attributes') continue;
+            const val = rec[key];
+            if (typeof val === 'string' && val.startsWith('@')) {
+              const actual = refMap.get(val.slice(1));
+              if (actual) {
+                rec[key] = actual;
+              } else if (refMap.size > 0) {
+                console.warn(`    Warning: unresolved ref ${val} in ${file}`);
+              }
+            }
+          }
+        }
+
+        let imported = 0;
+        const sampleRec = records[0] || {};
+        const fieldsPerRec = Object.keys(sampleRec).filter((k) => k !== 'attributes').length;
+        const estCharsPerRec = 40 + fieldsPerRec * 55;
+        const batchSize = Math.min(APEX_MAX_BATCH, Math.max(5, Math.floor(APEX_CHAR_LIMIT / estCharsPerRec)));
+        for (let i = 0; i < records.length; i += batchSize) {
+          const batch = records.slice(i, i + batchSize);
+          const refIds = batch.map((r) => r.attributes?.referenceId || `_idx${i}`);
+          const apex = buildApexInsert(entry.sobject, batch, refIds);
+          writeFileSync(tmpApex, apex);
+          const apexResult = spawnSync(
+            'sf',
+            ['apex', 'run', '--target-org', targetOrg, '--file', tmpApex],
+            { cwd: ROOT, stdio: 'pipe', shell: true, timeout: 120000 }
+          );
+          const apexOut = apexResult.stdout?.toString() || '';
+          const apexErr = apexResult.stderr?.toString() || '';
+          if (apexResult.status !== 0 && !apexOut.includes('Compiled successfully')) {
+            console.error(`  ${entry.sobject}: apex execution failed`);
+            process.stderr.write(apexErr || apexOut);
+            process.exit(1);
+          }
+          const okMatches = [...apexOut.matchAll(/\|DEBUG\|REF:([^:\n]+):(\w+)/g)];
+          const errMatches = [...apexOut.matchAll(/\|DEBUG\|ERR:([^:\n]+):([^\n]+)/g)];
+          if (errMatches.length) {
+            for (const m of errMatches.slice(0, 5)) {
+              console.error(`    ${m[1]}: ${m[2].trim()}`);
+            }
+            if (errMatches.length > 5) console.error(`    ... and ${errMatches.length - 5} more`);
+            console.error(`\nSetup failed at step: Data import tree (${entry.sobject})`);
+            process.exit(1);
+          }
+          if (entry.saveRefs) {
+            for (const m of okMatches) refMap.set(m[1], m[2]);
+          }
+          imported += okMatches.length;
+        }
+        console.log(`  ${entry.sobject}: imported ${imported} records`);
       }
     }
+    if (existsSync(tmpApex)) unlinkSync(tmpApex);
   }
 
   if (!skipGraphql || !skipWebappBuild) {
@@ -279,4 +527,7 @@ function main() {
   }
 }
 
-main();
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/webapp-template-app-react-sample-b2e-experimental",
-  "version": "1.92.0",
+  "version": "1.93.0",
   "description": "B2E starter app template",
   "license": "SEE LICENSE IN LICENSE.txt",
   "author": "",
@@ -16,8 +16,8 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@salesforce/webapp-experimental": "^1.92.0",
-    "@salesforce/webapp-template-feature-react-global-search-experimental": "^1.92.0"
+    "@salesforce/webapp-experimental": "^1.93.0",
+    "@salesforce/webapp-template-feature-react-global-search-experimental": "^1.93.0"
   },
   "devDependencies": {
     "@testing-library/jest-dom": "^6.6.3",

package/dist/.a4drules/webapp-no-node-e.md

@@ -1,65 +0,0 @@
----
-description: No complex node -e one-liners — use temp .js files or sed/awk instead
-paths:
-  - "force-app/main/default/webapplications/**/*"
----
-
-# A4D Enforcement: No `node -e` One-Liners
-
-This project **forbids** using `node -e` (or `node -p`, `node --eval`) one-liners for any operation—file manipulation, string replacement, reading/writing configs, or shell automation.
-
-## Why This Exists
-
-Complex `node -e '...'` one-liners **silently break in Zsh** (the default macOS shell) because of:
-
-- **`!` (history expansion):** Zsh interprets `!` inside double quotes as history expansion, causing `event not found` errors or silent corruption.
-- **Backtick interpolation:** Template literals (`` ` ``) are interpreted as command substitution by the shell before Node.js ever sees them.
-- **Nested quoting:** Multi-line JS crammed into a single shell string requires fragile quote escaping that differs between Bash and Zsh.
-
-These failures are **silent and intermittent**—the command may appear to succeed while producing corrupt output.
-
-## What To Do Instead
-
-### For multi-line file edits or transforms
-
-1. **Write a temporary `.js` script**, run it, then delete it:
-
-```bash
-cat > /tmp/_transform.js << 'SCRIPT'
-const fs = require('fs');
-const data = JSON.parse(fs.readFileSync('package.json', 'utf8'));
-data.name = 'my-app';
-fs.writeFileSync('package.json', JSON.stringify(data, null, 2) + '\n');
-SCRIPT
-node /tmp/_transform.js && rm /tmp/_transform.js
-```
-
-2. **Use `sed` or `awk`** for simple, single-pattern replacements with careful escaping:
-
-```bash
-sed -i '' 's/old-value/new-value/g' path/to/file
-```
-
-3. **Use `jq`** for JSON edits:
-
-```bash
-jq '.name = "my-app"' package.json > tmp.json && mv tmp.json package.json
-```
-
-4. **Use the IDE/agent file-editing tools** (replace_in_file, write_to_file, StrReplace, Write) whenever available—these bypass the shell entirely.
-
-### For simple, truly one-line expressions
-
-A trivial `node -e "console.log(1+1)"` with no special characters is acceptable, but **if the expression contains any of these, use a temp file instead:**
-- Template literals (backticks)
-- `!` characters
-- Nested quotes
-- Multi-line strings
-- `fs` read/write operations
-
-## Violation Handling
-
-- If any prior step used a complex `node -e` one-liner, **revert and redo** using one of the approved methods above.
-- If a shell command fails with `event not found`, `unexpected token`, or produces garbled output, check for a `node -e` violation first.
-
-**Cross-reference:** This rule is also summarized in **webapp.md** (MUST FOLLOW #1). Both apply.