@salesforce/ui-bundle-template-app-react-sample-b2e 2.2.1 → 3.1.0

package/dist/CHANGELOG.md

@@ -3,6 +3,23 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [3.1.0](https://github.com/salesforce-experience-platform-emu/webapps/compare/v3.0.0...v3.1.0) (2026-05-12)
+
+
+### Features
+
+* post tdx changes @W-22390798 ([#500](https://github.com/salesforce-experience-platform-emu/webapps/issues/500)) ([b611d9e](https://github.com/salesforce-experience-platform-emu/webapps/commit/b611d9ecbadd07d052bd7d9a4f5659dec422bf22))
+
+
+
+## [3.0.0](https://github.com/salesforce-experience-platform-emu/webapps/compare/v2.2.1...v3.0.0) (2026-05-11)
+
+**Note:** Version bump only for package @salesforce/ui-bundle-template-base-sfdx-project
+
+
+
+
+
 ## [2.2.1](https://github.com/salesforce-experience-platform-emu/webapps/compare/v2.2.0...v2.2.1) (2026-05-11)
 
 **Note:** Version bump only for package @salesforce/ui-bundle-template-base-sfdx-project

package/dist/README.md

@@ -11,7 +11,7 @@ A property management sample React UI Bundle for the Salesforce platform. Demons
    - [1. Install Dependencies](#1-install-dependencies)
    - [2. Authenticate Your Org](#2-authenticate-your-org)
    - [3. Deploy Metadata](#3-deploy-metadata)
-   - [4. Assign Permission Set](#4-assign-permission-set)
+   - [4. Assign Permission Sets](#4-assign-permission-sets)
    - [5. Import Sample Data](#5-import-sample-data)
    - [6. Generate GraphQL Types](#6-generate-graphql-types)
    - [7. Rebuild the UI Bundle](#7-rebuild-the-ui-bundle)
@@ -27,9 +27,9 @@ A property management sample React UI Bundle for the Salesforce platform. Demons
 ```
 force-app/main/default/
 ├── uiBundles/            # React UI Bundle (source, config, tests)
-├── objects/              # 17 Custom Objects (Property, Tenant, Lease, etc.)
+├── objects/              # 18 Custom Objects (Property, Tenant, Lease, Agent, etc.)
 ├── layouts/              # Page layouts for all custom objects
-├── permissionsets/       # Property_Management_Access (Full CRUD)
+├── permissionsets/       # Property_Management_Access (Full CRUD) & Tenant_Maintenance_Access (Scoped)
 └── data/                 # Sample JSON data (use: sf data import tree)
 ```
 
@@ -92,6 +92,38 @@ For a full list of options:
 npm run setup -- --help
 ```
 
+### Setup Configuration (`scripts/org-setup.config.json`)
+
+The `npm run setup` script reads `scripts/org-setup.config.json` to control permission set assignment behavior. Each top-level section is **optional** — if a section is absent, the corresponding step is hidden from the interactive picker.
+
+```json
+{
+  "permsetAssignments": {
+    "defaultAssignee": "skip",
+    "assignments": {
+      "Property_Management_Access": { "assignee": "currentUser" },
+      "Tenant_Maintenance_Access": { "assignee": "skip" }
+    }
+  }
+}
+```
+
+#### `permsetAssignments`
+
+| Field             | Description                                                                  |
+| ----------------- | ---------------------------------------------------------------------------- |
+| `defaultAssignee` | Fallback assignee for permission sets not explicitly listed in `assignments` |
+| `assignments`     | Per-permission-set overrides (key = permission set API name)                 |
+
+Each assignment's `assignee` value controls who it is assigned to:
+
+| Value            | Behavior                                                                          |
+| ---------------- | --------------------------------------------------------------------------------- |
+| `"currentUser"`  | Assigns to the user running the script (resolved via `sf org display`)            |
+| `"skip"`         | Explicitly skips this permission set                                              |
+| `"guestUser"`    | Auto-resolves the site's guest user (requires `siteName` field on the same entry) |
+| `"user@org.com"` | Assigns to a specific user by username                                            |
+
 ---
 
 ## Step-by-Step Setup
@@ -167,18 +199,21 @@ sf project deploy start --source-dir force-app/main/default/uiBundles --target-o
 
 Replace `<alias>` with your target org alias.
 
-### 4. Assign Permission Set
+### 4. Assign Permission Sets
+
+After deploying the metadata, assign permission sets to grant access to the custom objects and fields:
 
-After deploying the metadata, assign the `Property_Management_Access` permission set to grant access to the custom objects and fields:
+| Permission Set               | Purpose                                                                                                 | Assign To                       |
+| ---------------------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------- |
+| `Property_Management_Access` | Full CRUD access to all custom objects. Intended for property managers and admin users.                 | Internal users managing the app |
+| `Tenant_Maintenance_Access`  | Scoped read/write access for tenants. Allows creating and updating their own maintenance requests only. | Tenant community users          |
 
 ```bash
+# Assign Property_Management_Access to the current user
 sf org assign permset --name Property_Management_Access --target-org <alias>
-```
-
-To assign to a specific user:
 
-```bash
-sf org assign permset --name Property_Management_Access --on-behalf-of <username> --target-org <alias>
+# Assign Tenant_Maintenance_Access to a specific tenant user
+sf org assign permset --name Tenant_Maintenance_Access --on-behalf-of <username> --target-org <alias>
 ```
 
 Replace `<alias>` with your target org alias.

package/dist/force-app/main/default/applications/PropertyManagement.app-meta.xml

@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<CustomApplication xmlns="http://soap.sforce.com/2006/04/metadata">
+    <defaultLandingTab>standard-home</defaultLandingTab>
+    <description>Property Rental Management Application for managing properties, tenants, leases, payments, and maintenance.</description>
+    <formFactors>Large</formFactors>
+    <isNavAutoTempTabsDisabled>false</isNavAutoTempTabsDisabled>
+    <isNavPersonalizationDisabled>false</isNavPersonalizationDisabled>
+    <isNavTabPersistenceDisabled>false</isNavTabPersistenceDisabled>
+    <isOmniPinnedViewEnabled>false</isOmniPinnedViewEnabled>
+    <label>Property Management</label>
+    <navType>Standard</navType>
+    <tabs>standard-home</tabs>
+    <tabs>Property__c</tabs>
+    <tabs>Property_Listing__c</tabs>
+    <tabs>Tenant__c</tabs>
+    <tabs>Lease__c</tabs>
+    <tabs>Payment__c</tabs>
+    <tabs>Maintenance_Request__c</tabs>
+    <tabs>Maintenance_Worker__c</tabs>
+    <tabs>Application__c</tabs>
+    <tabs>Property_Owner__c</tabs>
+    <tabs>Property_Management_Company__c</tabs>
+    <tabs>Property_Cost__c</tabs>
+    <tabs>Property_Feature__c</tabs>
+    <tabs>Property_Image__c</tabs>
+    <tabs>Property_Sale__c</tabs>
+    <tabs>KPI_Snapshot__c</tabs>
+    <tabs>Notification__c</tabs>
+    <tabs>Agent__c</tabs>
+    <tabs>standard-report</tabs>
+    <tabs>standard-Dashboard</tabs>
+    <uiType>Lightning</uiType>
+</CustomApplication>

package/dist/force-app/main/default/data/Application__c.json

@@ -6,7 +6,7 @@
         "referenceId": "ApplicationRef1"
       },
       "Property__c": "@PropertyRef5",
-      "User__c": "@ContactRef1",
+      "User__c": null,
       "Status__c": "Submitted",
       "Start_Date__c": "2024-12-01",
       "Employment__c": "TechCorp Inc. - Senior Software Engineer - $95,000/year",
@@ -18,7 +18,7 @@
         "referenceId": "ApplicationRef2"
       },
       "Property__c": "@PropertyRef8",
-      "User__c": "@ContactRef2",
+      "User__c": null,
       "Status__c": "Background Check",
       "Start_Date__c": "2024-12-15",
       "Employment__c": "City Hospital - Registered Nurse - $72,000/year",
@@ -30,7 +30,7 @@
         "referenceId": "ApplicationRef3"
       },
       "Property__c": "@PropertyRef12",
-      "User__c": "@ContactRef3",
+      "User__c": null,
       "Status__c": "Approved",
       "Start_Date__c": "2024-11-01",
       "Employment__c": "Global Consulting LLC - Management Consultant - $110,000/year",
@@ -42,7 +42,7 @@
         "referenceId": "ApplicationRef4"
       },
       "Property__c": "@PropertyRef5",
-      "User__c": "@ContactRef3",
+      "User__c": null,
       "Status__c": "Rejected",
       "Start_Date__c": "2024-12-01",
       "Employment__c": "Retail Store - Assistant Manager - $32,000/year",
@@ -54,7 +54,7 @@
         "referenceId": "ApplicationRef5"
       },
       "Property__c": "@PropertyRef16",
-      "User__c": "@ContactRef3",
+      "User__c": null,
       "Status__c": "Draft",
       "Start_Date__c": "2025-01-15",
       "Employment__c": "University - Graduate Student - $18,000/year stipend",
@@ -66,7 +66,7 @@
         "referenceId": "ApplicationRef6"
       },
       "Property__c": "@PropertyRef20",
-      "User__c": "@ContactRef3",
+      "User__c": null,
       "Status__c": "Submitted",
       "Start_Date__c": "2025-01-01",
       "Employment__c": "Local Business - Marketing Coordinator - $48,000/year (Co-signer: Parent, $85,000/year)",
@@ -78,7 +78,7 @@
         "referenceId": "ApplicationRef7"
       },
       "Property__c": "@PropertyRef8",
-      "User__c": "@ContactRef3",
+      "User__c": null,
       "Status__c": "Background Check",
       "Start_Date__c": "2024-12-20",
       "Employment__c": "Finance Corp - Financial Analyst - $78,000/year",
@@ -90,7 +90,7 @@
         "referenceId": "ApplicationRef8"
       },
       "Property__c": "@PropertyRef3",
-      "User__c": "@ContactRef3",
+      "User__c": null,
       "Status__c": "Approved",
       "Start_Date__c": "2024-10-01",
       "Employment__c": "Design Studio - UX Designer - $68,000/year",
@@ -102,7 +102,7 @@
         "referenceId": "ApplicationRef9"
       },
       "Property__c": "@PropertyRef12",
-      "User__c": "@ContactRef3",
+      "User__c": null,
       "Status__c": "Rejected",
       "Start_Date__c": "2024-10-25",
       "Employment__c": "Various part-time positions - $25,000/year",
@@ -114,7 +114,7 @@
         "referenceId": "ApplicationRef10"
       },
       "Property__c": "@PropertyRef5",
-      "User__c": "@ContactRef3",
+      "User__c": null,
       "Status__c": "Submitted",
       "Start_Date__c": "2024-12-10",
       "Employment__c": "Teaching - High School Teacher - $55,000/year",

package/dist/force-app/main/default/data/data-plan.json

@@ -1,10 +1,4 @@
 [
-  {
-    "sobject": "Contact",
-    "saveRefs": true,
-    "resolveRefs": false,
-    "files": ["Contact.json"]
-  },
   {
     "sobject": "Agent__c",
     "saveRefs": true,

package/dist/force-app/main/default/objects/Application__c/fields/User__c.field-meta.xml

@@ -2,10 +2,10 @@
 <CustomField xmlns="http://soap.sforce.com/2006/04/metadata">
     <fullName>User__c</fullName>
     <deleteConstraint>SetNull</deleteConstraint>
-    <description>The person applying (Contact record)</description>
+    <description>The person applying (User record)</description>
     <externalId>false</externalId>
     <label>Applicant</label>
-    <referenceTo>Contact</referenceTo>
+    <referenceTo>User</referenceTo>
     <relationshipLabel>Applications</relationshipLabel>
     <relationshipName>Applications</relationshipName>
     <required>false</required>

package/dist/force-app/main/default/objects/Property__c/Property__c.object-meta.xml

@@ -53,7 +53,7 @@
     <enableSearch>true</enableSearch>
     <enableSharing>true</enableSharing>
     <enableStreamingApi>true</enableStreamingApi>
-    <externalSharingModel>Private</externalSharingModel>
+    <externalSharingModel>Read</externalSharingModel>
     <label>Property</label>
     <nameField>
         <label>Property Name</label>

package/dist/force-app/main/default/permissionsets/Property_Management_Access.permissionset-meta.xml

@@ -630,4 +630,80 @@
         <field>Tenant__c.Status__c</field>
         <readable>true</readable>
     </fieldPermissions>
+
+    <!-- Application Permissions -->
+    <applicationVisibilities>
+        <application>PropertyManagement</application>
+        <visible>true</visible>
+    </applicationVisibilities>
+
+    <!-- Tab Permissions -->
+    <tabSettings>
+        <tab>Agent__c</tab>
+        <visibility>Visible</visibility>
+    </tabSettings>
+    <tabSettings>
+        <tab>Application__c</tab>
+        <visibility>Visible</visibility>
+    </tabSettings>
+    <tabSettings>
+        <tab>KPI_Snapshot__c</tab>
+        <visibility>Visible</visibility>
+    </tabSettings>
+    <tabSettings>
+        <tab>Lease__c</tab>
+        <visibility>Visible</visibility>
+    </tabSettings>
+    <tabSettings>
+        <tab>Maintenance_Request__c</tab>
+        <visibility>Visible</visibility>
+    </tabSettings>
+    <tabSettings>
+        <tab>Maintenance_Worker__c</tab>
+        <visibility>Visible</visibility>
+    </tabSettings>
+    <tabSettings>
+        <tab>Notification__c</tab>
+        <visibility>Visible</visibility>
+    </tabSettings>
+    <tabSettings>
+        <tab>Payment__c</tab>
+        <visibility>Visible</visibility>
+    </tabSettings>
+    <tabSettings>
+        <tab>Property__c</tab>
+        <visibility>Visible</visibility>
+    </tabSettings>
+    <tabSettings>
+        <tab>Property_Cost__c</tab>
+        <visibility>Visible</visibility>
+    </tabSettings>
+    <tabSettings>
+        <tab>Property_Feature__c</tab>
+        <visibility>Visible</visibility>
+    </tabSettings>
+    <tabSettings>
+        <tab>Property_Image__c</tab>
+        <visibility>Visible</visibility>
+    </tabSettings>
+    <tabSettings>
+        <tab>Property_Listing__c</tab>
+        <visibility>Visible</visibility>
+    </tabSettings>
+    <tabSettings>
+        <tab>Property_Management_Company__c</tab>
+        <visibility>Visible</visibility>
+    </tabSettings>
+    <tabSettings>
+        <tab>Property_Owner__c</tab>
+        <visibility>Visible</visibility>
+    </tabSettings>
+    <tabSettings>
+        <tab>Property_Sale__c</tab>
+        <visibility>Visible</visibility>
+    </tabSettings>
+    <tabSettings>
+        <tab>Tenant__c</tab>
+        <visibility>Visible</visibility>
+    </tabSettings>
 </PermissionSet>

package/dist/force-app/main/default/permissionsets/Tenant_Maintenance_Access.permissionset-meta.xml

@@ -36,7 +36,7 @@
         <readable>true</readable>
     </fieldPermissions>
     <fieldPermissions>
-        <editable>false</editable>
+        <editable>true</editable>
         <field>Maintenance_Request__c.Property__c</field>
         <readable>true</readable>
     </fieldPermissions>

package/dist/force-app/main/default/tabs/Agent__c.tab-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<CustomTab xmlns="http://soap.sforce.com/2006/04/metadata">
+    <customObject>true</customObject>
+    <motif>Custom51: People</motif>
+</CustomTab>

package/dist/force-app/main/default/tabs/Application__c.tab-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<CustomTab xmlns="http://soap.sforce.com/2006/04/metadata">
+    <customObject>true</customObject>
+    <motif>Custom20: Airplane</motif>
+</CustomTab>

package/dist/force-app/main/default/tabs/KPI_Snapshot__c.tab-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<CustomTab xmlns="http://soap.sforce.com/2006/04/metadata">
+    <customObject>true</customObject>
+    <motif>Custom40: Radar</motif>
+</CustomTab>

package/dist/force-app/main/default/tabs/Lease__c.tab-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<CustomTab xmlns="http://soap.sforce.com/2006/04/metadata">
+    <customObject>true</customObject>
+    <motif>Custom25: Handshake</motif>
+</CustomTab>

package/dist/force-app/main/default/tabs/Maintenance_Request__c.tab-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<CustomTab xmlns="http://soap.sforce.com/2006/04/metadata">
+    <customObject>true</customObject>
+    <motif>Custom48: Wrench</motif>
+</CustomTab>

package/dist/force-app/main/default/tabs/Maintenance_Worker__c.tab-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<CustomTab xmlns="http://soap.sforce.com/2006/04/metadata">
+    <customObject>true</customObject>
+    <motif>Custom48: Wrench</motif>
+</CustomTab>

package/dist/force-app/main/default/tabs/Notification__c.tab-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<CustomTab xmlns="http://soap.sforce.com/2006/04/metadata">
+    <customObject>true</customObject>
+    <motif>Custom31: Bell</motif>
+</CustomTab>

package/dist/force-app/main/default/tabs/Payment__c.tab-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<CustomTab xmlns="http://soap.sforce.com/2006/04/metadata">
+    <customObject>true</customObject>
+    <motif>Custom18: Dollar</motif>
+</CustomTab>

package/dist/force-app/main/default/tabs/Property_Cost__c.tab-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<CustomTab xmlns="http://soap.sforce.com/2006/04/metadata">
+    <customObject>true</customObject>
+    <motif>Custom18: Dollar</motif>
+</CustomTab>

package/dist/force-app/main/default/tabs/Property_Feature__c.tab-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<CustomTab xmlns="http://soap.sforce.com/2006/04/metadata">
+    <customObject>true</customObject>
+    <motif>Custom57: Check</motif>
+</CustomTab>

package/dist/force-app/main/default/tabs/Property_Image__c.tab-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<CustomTab xmlns="http://soap.sforce.com/2006/04/metadata">
+    <customObject>true</customObject>
+    <motif>Custom46: Camera</motif>
+</CustomTab>

package/dist/force-app/main/default/tabs/Property_Listing__c.tab-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<CustomTab xmlns="http://soap.sforce.com/2006/04/metadata">
+    <customObject>true</customObject>
+    <motif>Custom24: Building</motif>
+</CustomTab>

package/dist/force-app/main/default/tabs/Property_Management_Company__c.tab-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<CustomTab xmlns="http://soap.sforce.com/2006/04/metadata">
+    <customObject>true</customObject>
+    <motif>Custom24: Building</motif>
+</CustomTab>

package/dist/force-app/main/default/tabs/Property_Owner__c.tab-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<CustomTab xmlns="http://soap.sforce.com/2006/04/metadata">
+    <customObject>true</customObject>
+    <motif>Custom51: People</motif>
+</CustomTab>

package/dist/force-app/main/default/tabs/Property_Sale__c.tab-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<CustomTab xmlns="http://soap.sforce.com/2006/04/metadata">
+    <customObject>true</customObject>
+    <motif>Custom18: Dollar</motif>
+</CustomTab>

package/dist/force-app/main/default/tabs/Property__c.tab-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<CustomTab xmlns="http://soap.sforce.com/2006/04/metadata">
+    <customObject>true</customObject>
+    <motif>Custom24: Building</motif>
+</CustomTab>

package/dist/force-app/main/default/tabs/Tenant__c.tab-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<CustomTab xmlns="http://soap.sforce.com/2006/04/metadata">
+    <customObject>true</customObject>
+    <motif>Custom24: Building</motif>
+</CustomTab>

package/dist/force-app/main/default/uiBundles/propertymanagementapp/src/api/applications/applications.ts

@@ -1,7 +1,6 @@
 import GET_APPLICATIONS from "./query/getApplications.graphql?raw";
 import UPDATE_APPLICATION_STATUS from "./query/updateApplicationStatus.graphql?raw";
 import APPLICATION_FOR_APPROVAL_QUERY from "./query/applicationForApproval.graphql?raw";
-import USER_BY_CONTACT_QUERY from "./query/userByContact.graphql?raw";
 import EXISTING_TENANT_QUERY from "./query/existingTenant.graphql?raw";
 import { createRecord } from "@salesforce/ui-bundle/api";
 import type {
@@ -11,8 +10,6 @@ import type {
 	UpdateApplicationStatusMutationVariables,
 	ApplicationForApprovalQuery,
 	ApplicationForApprovalQueryVariables,
-	UserByContactQuery,
-	UserByContactQueryVariables,
 	ExistingTenantQuery,
 	ExistingTenantQueryVariables,
 } from "../graphql-operations-types.js";
@@ -81,20 +78,11 @@ async function ensureTenantForApprovedApplication(applicationId: string): Promis
 		throw new Error("Application record not found.");
 	}
 
-	const contactId = applicationNode.User__c?.value ?? null;
+	const userId = applicationNode.User__c?.value ?? null;
 	const propertyId = applicationNode.Property__c?.value ?? null;
 	const startDate = applicationNode.Start_Date__c?.value ?? null;
 
-	if (!contactId || !propertyId) {
-		return;
-	}
-
-	const userData = await executeGraphQL<UserByContactQuery, UserByContactQueryVariables>(
-		USER_BY_CONTACT_QUERY,
-		{ contactId },
-	);
-	const userId = userData.uiapi?.query?.User?.edges?.[0]?.node?.Id ?? null;
-	if (!userId) {
+	if (!userId || !propertyId) {
 		return;
 	}
 

package/dist/force-app/main/default/uiBundles/propertymanagementapp/src/api/applications/query/getApplications.graphql

@@ -9,10 +9,7 @@ query GetApplications {
 							value
 						}
 						User__r @optional {
-							FirstName @optional {
-								value
-							}
-							LastName @optional {
+							Name @optional {
 								value
 							}
 						}