@salesforce/templates 66.4.1 → 66.4.2

package/lib/templates/project/reactb2e/_r_/webapp-webapplication.md

@@ -0,0 +1,159 @@
+
+---
+paths:
+  - "**/webapplications/**/*"
+---
+
+# WebApplication Requirements
+
+## Bundle Rules
+- A WebApplication bundle must live under `webapplications/<AppName>/`
+- The bundle must contain `<AppName>.webapplication-meta.xml`
+- The metadata filename must exactly match the folder name
+- A build output directory must exist and contain at least one file
+- Default build output directory: `dist/`
+- If `webapplication.json.outputDir` is set, it overrides `dist/`
+
+Valid example:
+```text
+webapplications/
+  MyApp/
+    MyApp.webapplication-meta.xml
+    webapplication.json
+    dist/
+      index.html
+```
+
+## Metadata XML
+Required fields:
+- `masterLabel`
+- `version` (max 20 chars)
+- `isActive` (boolean)
+
+Optional fields:
+- `description` (max 255 chars)
+
+## webapplication.json
+`webapplication.json` is optional.
+
+Allowed top-level keys only:
+- `outputDir`
+- `routing`
+- `headers`
+
+### File Constraints
+- Must be valid UTF-8 JSON
+- Max size: 100 KB
+- Root must be a non-empty object
+- Never allow `{}`, arrays, or primitives as the root
+
+### Path Safety
+Applies to:
+- `outputDir`
+- `routing.fallback`
+
+Reject:
+- backslashes
+- leading `/` or `\`
+- `..` segments
+- null or control characters
+- globs: `*`, `?`, `**`
+- `%`
+
+All resolved paths must stay within the application bundle.
+
+### outputDir
+- Must be a non-empty string
+- Must reference a subdirectory only
+- Reject `.` and `./`
+- The directory must exist in the bundle
+- The directory must contain at least one file
+
+### routing
+- If present, must be a non-empty object
+- Allowed keys only:
+  - `rewrites`
+  - `redirects`
+  - `fallback`
+  - `trailingSlash`
+  - `fileBasedRouting`
+
+#### routing.trailingSlash
+- Must be one of: `"always"`, `"never"`, `"auto"`
+
+#### routing.fileBasedRouting
+- Must be a boolean
+
+#### routing.fallback
+- Must be a non-empty string
+- Must satisfy Path Safety rules
+- Target file must exist
+
+#### routing.rewrites
+- Must be a non-empty array
+- Each item must be a non-empty object
+- Allowed keys: `route`, `rewrite`
+- `rewrite` must be a non-empty string
+- `route`, if present, must be a non-empty string
+
+Example:
+```json
+{
+  "routing": {
+    "rewrites": [
+      { "route": "/app/:path*", "rewrite": "/index.html" }
+    ]
+  }
+}
+```
+
+#### routing.redirects
+- Must be a non-empty array
+- Each item must be a non-empty object
+- Allowed keys: `route`, `redirect`, `statusCode`
+- `redirect` must be a non-empty string
+- `route`, if present, must be a non-empty string
+- `statusCode`, if present, must be one of: `301`, `302`, `307`, `308`
+
+Example:
+```json
+{
+  "routing": {
+    "redirects": [
+      { "route": "/old-page", "redirect": "/new-page", "statusCode": 301 }
+    ]
+  }
+}
+```
+
+### headers
+- If present, must be a non-empty array
+- Each item must be a non-empty object
+- Allowed keys: `source`, `headers`
+- `headers` must be a non-empty array
+
+Each header entry must contain:
+- `key`: non-empty string
+- `value`: non-empty string
+
+Example:
+```json
+{
+  "headers": [
+    {
+      "source": "/assets/**",
+      "headers": [
+        { "key": "Cache-Control", "value": "public, max-age=31536000, immutable" }
+      ]
+    }
+  ]
+}
+```
+
+## Never Suggest
+- `{}` as the JSON root
+- `"routing": {}`
+- empty arrays
+- empty array items such as `[{}]`
+- `"outputDir": "."`
+- `"outputDir": "./"`

package/lib/templates/project/reactb2e/_r_/webapp.md

@@ -1,7 +1,7 @@
 ---
 description: Core web application rules for SFDX React apps
 paths:
-  - "force-app/main/default/webapplications/**/*"
+  - "**/webapplications/**/*"
 ---
 
 # Skills-First (MUST FOLLOW)
@@ -81,7 +81,7 @@ Agents consistently miss these. **You must not leave them default.**
 
 # Shell Command Safety (MUST FOLLOW)
 
-**Never use complex `node -e` one-liners** for file edits or multi-line transforms. They break in Zsh due to `!` history expansion and backtick interpolation. Use a temporary `.js` file, `sed`/`awk`, `jq`, or IDE file-editing tools instead. See **webapp-no-node-e.md** for full details and approved alternatives.
+**Never use complex `node -e` one-liners** for file edits or multi-line transforms. They break in Zsh due to `!` history expansion and backtick interpolation. Use a temporary `.js` file, `sed`/`awk`, `jq`, or IDE file-editing tools instead. See **webapp-cli-commands.md** for full details and approved alternatives.
 
 # Development Cycle
 

package/lib/templates/project/reactb2e/package.json

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

package/lib/templates/project/reactb2e/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);