@salesforce/ui-bundle-template-app-react-sample-b2x 1.117.2

package/dist/README.md

@@ -0,0 +1,112 @@
+# Property Rental App
+
+A property rental sample React UI Bundle for Salesforce Experience Cloud. Demonstrates property listings, maintenance requests, and a dashboard with an app shell designed for external-facing deployment. Built with React, Vite, TypeScript, and Tailwind/shadcn.
+
+## What's included
+
+| Path                                                  | Description                                                                                                                                                                                                                                                                                                                                                       |
+| ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `force-app/main/default/uiBundles/propertyrentalapp/` | React UI Bundle (source, config, tests)                                                                                                                                                                                                                                                                                                                           |
+| `force-app/main/default/objects/`                     | 17 custom objects — Agent\_\_c, Application\_\_c, KPI_Snapshot\_\_c, Lease\_\_c, Maintenance_Request\_\_c, Maintenance_Worker\_\_c, Notification\_\_c, Payment\_\_c, Property\_\_c, Property_Cost\_\_c, Property_Feature\_\_c, Property_Image\_\_c, Property_Listing\_\_c, Property_Management_Company\_\_c, Property_Owner\_\_c, Property_Sale\_\_c, Tenant\_\_c |
+| `force-app/main/default/layouts/`                     | Page layouts for each custom object                                                                                                                                                                                                                                                                                                                               |
+| `force-app/main/default/permissionsets/`              | `Property_Management_Access` permission set                                                                                                                                                                                                                                                                                                                       |
+| `force-app/main/default/classes/`                     | Apex classes — `MaintenanceRequestListAction`, `MaintenanceRequestUpdatePriorityAction`                                                                                                                                                                                                                                                                           |
+| `force-app/main/default/cspTrustedSites/`             | CSP trusted sites for external resources (Google Fonts, Pexels, Unsplash, GitHub Avatars)                                                                                                                                                                                                                                                                         |
+| `force-app/main/default/data/`                        | Sample data (JSON) for all objects, importable via `sf data import tree`                                                                                                                                                                                                                                                                                          |
+| `force-app/main/default/digitalExperienceConfigs/`    | Experience Cloud site configuration                                                                                                                                                                                                                                                                                                                               |
+| `force-app/main/default/digitalExperiences/`          | Experience Cloud site definition                                                                                                                                                                                                                                                                                                                                  |
+| `force-app/main/default/networks/`                    | Experience Cloud network                                                                                                                                                                                                                                                                                                                                          |
+| `force-app/main/default/sites/`                       | Salesforce site                                                                                                                                                                                                                                                                                                                                                   |
+
+## Getting started
+
+Navigate to the UI Bundle and install dependencies:
+
+```bash
+cd force-app/main/default/uiBundles/propertyrentalapp
+npm install
+npm run dev
+```
+
+Opens at http://localhost:5173 by default. For build and test instructions, see the [UI Bundle README](force-app/main/default/uiBundles/propertyrentalapp/README.md).
+
+## Deploy
+
+### Deploy everything (metadata + Experience Cloud site + UI Bundle)
+
+```bash
+cd force-app/main/default/uiBundles/propertyrentalapp && npm install && npm run build && cd -
+sf project deploy start --source-dir force-app --target-org <alias>
+```
+
+### Deploy the UI Bundle only
+
+```bash
+cd force-app/main/default/uiBundles/propertyrentalapp && npm install && npm run build && cd -
+sf project deploy start --source-dir force-app/main/default/ui-bundles --target-org <alias>
+```
+
+### Deploy metadata only (objects, layouts, permission sets, Apex classes)
+
+```bash
+sf project deploy start \
+  --source-dir force-app/main/default/objects \
+  --source-dir force-app/main/default/layouts \
+  --source-dir force-app/main/default/permissionsets \
+  --source-dir force-app/main/default/classes \
+  --target-org <alias>
+```
+
+### Deploy Experience Cloud site only
+
+```bash
+sf project deploy start \
+  --source-dir force-app/main/default/digitalExperienceConfigs \
+  --source-dir force-app/main/default/digitalExperiences \
+  --source-dir force-app/main/default/networks \
+  --source-dir force-app/main/default/sites \
+  --target-org <alias>
+```
+
+Replace `<alias>` with your target org alias.
+
+## Import sample data
+
+```bash
+sf data import tree --plan force-app/main/default/data/data-plan.json --target-org <alias>
+```
+
+## Using setup-cli.mjs
+
+When this app is built (e.g. from the monorepo or from a published package), a `setup-cli.mjs` script is included at the project root. It runs the full setup in one go: login (if needed), deploy metadata, assign the `Property_Management_Access` permission set, prepare and import sample data, fetch GraphQL schema and run codegen, build the UI Bundle, and optionally start the dev server.
+
+Run from the **project root** (the directory that contains `force-app/`, `sfdx-project.json`, and `setup-cli.mjs`):
+
+```bash
+node setup-cli.mjs --target-org <alias>
+```
+
+Common options:
+
+| Option                   | Description                                                      |
+| ------------------------ | ---------------------------------------------------------------- |
+| `--skip-login`           | Skip browser login (org already authenticated)                   |
+| `--skip-data`            | Skip data preparation and import                                 |
+| `--skip-graphql`         | Skip GraphQL schema fetch and codegen                            |
+| `--skip-ui-bundle-build` | Skip `npm install` and UI Bundle build                           |
+| `--skip-dev`             | Do not start the dev server at the end                           |
+| `--permset <name>`       | Permission set to assign (default: `Property_Management_Access`) |
+| `--app <name>`           | Web app folder name when multiple exist                          |
+
+For all options: `node setup-cli.mjs --help`.
+
+## Configure Your Salesforce DX Project
+
+The `sfdx-project.json` file contains useful configuration information for your project. See [Salesforce DX Project Configuration](https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_ws_config.htm) in the _Salesforce DX Developer Guide_ for details about this file.
+
+## Read All About It
+
+- [Salesforce Extensions Documentation](https://developer.salesforce.com/tools/vscode/)
+- [Salesforce CLI Setup Guide](https://developer.salesforce.com/docs/atlas.en-us.sfdx_setup.meta/sfdx_setup/sfdx_setup_intro.htm)
+- [Salesforce DX Developer Guide](https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_intro.htm)
+- [Salesforce CLI Command Reference](https://developer.salesforce.com/docs/atlas.en-us.sfdx_cli_reference.meta/sfdx_cli_reference/cli_reference.htm)

package/dist/config/project-scratch-def.json

@@ -0,0 +1,13 @@
+{
+  "orgName": "My Saleforce Org",
+  "edition": "Developer",
+  "features": ["EnableSetPasswordInApi"],
+  "settings": {
+    "lightningExperienceSettings": {
+      "enableS1DesktopEnabled": true
+    },
+    "mobileSettings": {
+      "enableS1EncryptedStoragePref2": false
+    }
+  }
+}

package/dist/eslint.config.js

@@ -0,0 +1,7 @@
+/**
+ * ESLint 9 flat config for LWC and Aura.
+ * @see https://github.com/salesforce/eslint-config-lwc
+ */
+const lwcConfig = require("@salesforce/eslint-config-lwc");
+
+module.exports = [...lwcConfig.configs.recommended];

package/dist/force-app/main/default/classes/MaintenanceRequestTriggerHandler.cls

@@ -0,0 +1,69 @@
+public without sharing class MaintenanceRequestTriggerHandler {
+
+    /**
+     * Handles before insert logic for Maintenance Request records
+     * Automatically assigns workers based on request type and updates status to Assigned
+     */
+    public static void handleBeforeInsert(List<Maintenance_Request__c> newRequests) {
+        // Map to store request type to worker type mappings
+        Map<String, String> requestTypeToWorkerType = new Map<String, String>{
+            'Plumbing'    => 'Plumbing',
+            'Electrical'  => 'Electrical',
+            'HVAC'        => 'HVAC (Heating & Cooling)',
+            'Appliance'   => 'Appliance Repair',
+            'Carpentry'   => 'General Carpentry',
+            'Landscaping' => 'Landscaping / Grounds',
+            'Cleaning'    => 'Janitorial / Cleaning',
+            'Pest'        => 'Pest Control'
+        };
+
+        // Collect unique worker types needed
+        Set<String> workerTypesNeeded = new Set<String>();
+        for (Maintenance_Request__c request : newRequests) {
+            if (request.Type__c != null && requestTypeToWorkerType.containsKey(request.Type__c)) {
+                workerTypesNeeded.add(requestTypeToWorkerType.get(request.Type__c));
+            }
+        }
+
+        // Query for available workers by type
+        Map<String, List<Maintenance_Worker__c>> workersByType = new Map<String, List<Maintenance_Worker__c>>();
+        if (!workerTypesNeeded.isEmpty()) {
+            for (Maintenance_Worker__c worker : [
+                SELECT Id, Name, Type__c, Rating__c
+                FROM Maintenance_Worker__c
+                WHERE Type__c IN :workerTypesNeeded
+                AND IsActive__c = true
+                ORDER BY Rating__c DESC NULLS LAST, Name ASC
+            ]) {
+                if (!workersByType.containsKey(worker.Type__c)) {
+                    workersByType.put(worker.Type__c, new List<Maintenance_Worker__c>());
+                }
+                workersByType.get(worker.Type__c).add(worker);
+            }
+        }
+
+        // Assign workers to requests
+        for (Maintenance_Request__c request : newRequests) {
+            // Only process requests with 'New' status (or null, since 'New' is the default)
+            if ((request.Status__c == 'New' || request.Status__c == null) &&
+                request.Type__c != null && requestTypeToWorkerType.containsKey(request.Type__c)) {
+                String workerType = requestTypeToWorkerType.get(request.Type__c);
+
+                // Check if we have available workers for this type
+                if (workersByType.containsKey(workerType) && !workersByType.get(workerType).isEmpty()) {
+                    // Assign the first available worker (highest rated)
+                    Maintenance_Worker__c assignedWorker = workersByType.get(workerType).get(0);
+                    request.Assigned_Worker__c = assignedWorker.Id;
+                    request.Status__c = 'Assigned';
+
+                    // Set scheduled date to 3 days from now
+                    request.Scheduled__c = DateTime.now().addDays(3);
+
+                    // Rotate worker to end of list for round-robin assignment
+                    workersByType.get(workerType).remove(0);
+                    workersByType.get(workerType).add(assignedWorker);
+                }
+            }
+        }
+    }
+}

package/dist/force-app/main/default/classes/MaintenanceRequestTriggerHandler.cls-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
+    <apiVersion>66.0</apiVersion>
+    <status>Active</status>
+</ApexClass>

package/dist/force-app/main/default/classes/MaintenanceRequestTriggerHandler_Test.cls

@@ -0,0 +1,308 @@
+/**
+ * Test class for MaintenanceRequestTriggerHandler
+ * Validates automatic worker assignment, status updates to Assigned, and scheduled date setting
+ */
+@isTest
+private class MaintenanceRequestTriggerHandler_Test {
+
+    /**
+     * Setup test data for all test methods
+     */
+    @testSetup
+    static void setupTestData() {
+        // Create test maintenance workers with different specialties
+        List<Maintenance_Worker__c> workers = new List<Maintenance_Worker__c>{
+            new Maintenance_Worker__c(
+                Name = 'John Plumber',
+                Type__c = 'Plumbing',
+                IsActive__c = true,
+                Rating__c = 4.5,
+                Phone__c = '555-0001'
+            ),
+            new Maintenance_Worker__c(
+                Name = 'Jane Electrician',
+                Type__c = 'Electrical',
+                IsActive__c = true,
+                Rating__c = 4.8,
+                Phone__c = '555-0002'
+            ),
+            new Maintenance_Worker__c(
+                Name = 'Bob HVAC',
+                Type__c = 'HVAC (Heating & Cooling)',
+                IsActive__c = true,
+                Rating__c = 4.2,
+                Phone__c = '555-0003'
+            ),
+            new Maintenance_Worker__c(
+                Name = 'Alice Appliance',
+                Type__c = 'Appliance Repair',
+                IsActive__c = true,
+                Rating__c = 4.7,
+                Phone__c = '555-0004'
+            ),
+            new Maintenance_Worker__c(
+                Name = 'Charlie Pest',
+                Type__c = 'Pest Control',
+                IsActive__c = true,
+                Rating__c = 4.3,
+                Phone__c = '555-0005'
+            ),
+            new Maintenance_Worker__c(
+                Name = 'Inactive Worker',
+                Type__c = 'Plumbing',
+                IsActive__c = false,
+                Rating__c = 5.0,
+                Phone__c = '555-0006'
+            )
+        };
+        insert workers;
+    }
+
+    /**
+     * Test that plumbing requests are assigned to plumbing workers
+     */
+    @isTest
+    static void testPlumbingRequestAssignment() {
+        // Query for plumbing worker
+        Maintenance_Worker__c plumber = [SELECT Id FROM Maintenance_Worker__c WHERE Type__c = 'Plumbing' AND IsActive__c = true LIMIT 1];
+
+        Test.startTest();
+        Maintenance_Request__c request = new Maintenance_Request__c(
+            Type__c = 'Plumbing',
+            Description__c = 'Leaky faucet in bathroom',
+            Priority__c = 'Standard'
+        );
+        insert request;
+        Test.stopTest();
+
+        // Verify assignment
+        Maintenance_Request__c insertedRequest = [
+            SELECT Id, Assigned_Worker__c, Status__c, Scheduled__c, Type__c
+            FROM Maintenance_Request__c
+            WHERE Id = :request.Id
+        ];
+
+        System.assertEquals(plumber.Id, insertedRequest.Assigned_Worker__c, 'Worker should be assigned');
+        System.assertEquals('Assigned', insertedRequest.Status__c, 'Status should be Assigned');
+        System.assertNotEquals(null, insertedRequest.Scheduled__c, 'Scheduled date should be set');
+
+        // Verify scheduled date is approximately 3 days from now (within 1 minute tolerance)
+        DateTime expectedDate = DateTime.now().addDays(3);
+        Long timeDiff = Math.abs(insertedRequest.Scheduled__c.getTime() - expectedDate.getTime());
+        System.assert(timeDiff < 60000, 'Scheduled date should be 3 days from now');
+    }
+
+    /**
+     * Test that electrical requests are assigned to electrical workers
+     */
+    @isTest
+    static void testElectricalRequestAssignment() {
+        Maintenance_Worker__c electrician = [SELECT Id FROM Maintenance_Worker__c WHERE Type__c = 'Electrical' AND IsActive__c = true LIMIT 1];
+
+        Test.startTest();
+        Maintenance_Request__c request = new Maintenance_Request__c(
+            Type__c = 'Electrical',
+            Description__c = 'Outlet not working',
+            Priority__c = 'High (Same Day)'
+        );
+        insert request;
+        Test.stopTest();
+
+        Maintenance_Request__c insertedRequest = [
+            SELECT Id, Assigned_Worker__c, Status__c
+            FROM Maintenance_Request__c
+            WHERE Id = :request.Id
+        ];
+
+        System.assertEquals(electrician.Id, insertedRequest.Assigned_Worker__c, 'Electrician should be assigned');
+        System.assertEquals('Assigned', insertedRequest.Status__c, 'Status should be Assigned');
+    }
+
+    /**
+     * Test that HVAC requests are assigned to HVAC workers
+     */
+    @isTest
+    static void testHVACRequestAssignment() {
+        Maintenance_Worker__c hvacWorker = [SELECT Id FROM Maintenance_Worker__c WHERE Type__c = 'HVAC (Heating & Cooling)' AND IsActive__c = true LIMIT 1];
+
+        Test.startTest();
+        Maintenance_Request__c request = new Maintenance_Request__c(
+            Type__c = 'HVAC',
+            Description__c = 'AC not cooling',
+            Priority__c = 'High (Same Day)'
+        );
+        insert request;
+        Test.stopTest();
+
+        Maintenance_Request__c insertedRequest = [
+            SELECT Id, Assigned_Worker__c, Status__c
+            FROM Maintenance_Request__c
+            WHERE Id = :request.Id
+        ];
+
+        System.assertEquals(hvacWorker.Id, insertedRequest.Assigned_Worker__c, 'HVAC worker should be assigned');
+        System.assertEquals('Assigned', insertedRequest.Status__c, 'Status should be Assigned');
+    }
+
+    /**
+     * Test that appliance requests are assigned to appliance repair workers
+     */
+    @isTest
+    static void testApplianceRequestAssignment() {
+        Maintenance_Worker__c applianceWorker = [SELECT Id FROM Maintenance_Worker__c WHERE Type__c = 'Appliance Repair' AND IsActive__c = true LIMIT 1];
+
+        Test.startTest();
+        Maintenance_Request__c request = new Maintenance_Request__c(
+            Type__c = 'Appliance',
+            Description__c = 'Dishwasher not draining',
+            Priority__c = 'Standard'
+        );
+        insert request;
+        Test.stopTest();
+
+        Maintenance_Request__c insertedRequest = [
+            SELECT Id, Assigned_Worker__c, Status__c
+            FROM Maintenance_Request__c
+            WHERE Id = :request.Id
+        ];
+
+        System.assertEquals(applianceWorker.Id, insertedRequest.Assigned_Worker__c, 'Appliance worker should be assigned');
+        System.assertEquals('Assigned', insertedRequest.Status__c, 'Status should be Assigned');
+    }
+
+    /**
+     * Test that pest requests are assigned to pest control workers
+     */
+    @isTest
+    static void testPestRequestAssignment() {
+        Maintenance_Worker__c pestWorker = [SELECT Id FROM Maintenance_Worker__c WHERE Type__c = 'Pest Control' AND IsActive__c = true LIMIT 1];
+
+        Test.startTest();
+        Maintenance_Request__c request = new Maintenance_Request__c(
+            Type__c = 'Pest',
+            Description__c = 'Ants in kitchen',
+            Priority__c = 'Standard'
+        );
+        insert request;
+        Test.stopTest();
+
+        Maintenance_Request__c insertedRequest = [
+            SELECT Id, Assigned_Worker__c, Status__c
+            FROM Maintenance_Request__c
+            WHERE Id = :request.Id
+        ];
+
+        System.assertEquals(pestWorker.Id, insertedRequest.Assigned_Worker__c, 'Pest control worker should be assigned');
+        System.assertEquals('Assigned', insertedRequest.Status__c, 'Status should be Assigned');
+    }
+
+    /**
+     * Test bulk insert with multiple request types
+     */
+    @isTest
+    static void testBulkRequestAssignment() {
+        Test.startTest();
+        List<Maintenance_Request__c> requests = new List<Maintenance_Request__c>{
+            new Maintenance_Request__c(Type__c = 'Plumbing', Description__c = 'Leak 1', Priority__c = 'High (Same Day)'),
+            new Maintenance_Request__c(Type__c = 'Electrical', Description__c = 'Issue 1', Priority__c = 'Standard'),
+            new Maintenance_Request__c(Type__c = 'Plumbing', Description__c = 'Leak 2', Priority__c = 'Standard'),
+            new Maintenance_Request__c(Type__c = 'HVAC', Description__c = 'AC Issue', Priority__c = 'High (Same Day)'),
+            new Maintenance_Request__c(Type__c = 'Appliance', Description__c = 'Fridge Issue', Priority__c = 'Standard')
+        };
+        insert requests;
+        Test.stopTest();
+
+        List<Maintenance_Request__c> insertedRequests = [
+            SELECT Id, Assigned_Worker__c, Status__c, Type__c
+            FROM Maintenance_Request__c
+            WHERE Id IN :requests
+        ];
+
+        // Verify all requests were assigned
+        for (Maintenance_Request__c req : insertedRequests) {
+            System.assertNotEquals(null, req.Assigned_Worker__c, 'All requests should have assigned workers');
+            System.assertEquals('Assigned', req.Status__c, 'All requests should be Assigned');
+        }
+
+        System.assertEquals(5, insertedRequests.size(), 'All 5 requests should be inserted');
+    }
+
+    /**
+     * Test that requests without type are not assigned
+     */
+    @isTest
+    static void testRequestWithoutType() {
+        Test.startTest();
+        Maintenance_Request__c request = new Maintenance_Request__c(
+            Description__c = 'General maintenance',
+            Priority__c = 'Standard'
+        );
+        insert request;
+        Test.stopTest();
+
+        Maintenance_Request__c insertedRequest = [
+            SELECT Id, Assigned_Worker__c, Status__c
+            FROM Maintenance_Request__c
+            WHERE Id = :request.Id
+        ];
+
+        System.assertEquals(null, insertedRequest.Assigned_Worker__c, 'Worker should not be assigned without type');
+    }
+
+    /**
+     * Test that inactive workers are not assigned
+     */
+    @isTest
+    static void testInactiveWorkerNotAssigned() {
+        // Delete all active plumbing workers
+        delete [SELECT Id FROM Maintenance_Worker__c WHERE Type__c = 'Plumbing' AND IsActive__c = true];
+
+        Test.startTest();
+        Maintenance_Request__c request = new Maintenance_Request__c(
+            Type__c = 'Plumbing',
+            Description__c = 'Emergency leak',
+            Priority__c = 'High (Same Day)'
+        );
+        insert request;
+        Test.stopTest();
+
+        Maintenance_Request__c insertedRequest = [
+            SELECT Id, Assigned_Worker__c, Status__c
+            FROM Maintenance_Request__c
+            WHERE Id = :request.Id
+        ];
+
+        System.assertEquals(null, insertedRequest.Assigned_Worker__c, 'Inactive worker should not be assigned');
+    }
+
+    /**
+     * Test that requests with non-New status are not automatically processed
+     */
+    @isTest
+    static void testNonNewStatusNotProcessed() {
+        // Query for plumbing worker
+        Maintenance_Worker__c plumber = [SELECT Id FROM Maintenance_Worker__c WHERE Type__c = 'Plumbing' AND IsActive__c = true LIMIT 1];
+
+        Test.startTest();
+        // Create a request with status explicitly set to 'In Progress'
+        Maintenance_Request__c request = new Maintenance_Request__c(
+            Type__c = 'Plumbing',
+            Description__c = 'Manually assigned request',
+            Priority__c = 'Standard',
+            Status__c = 'In Progress'
+        );
+        insert request;
+        Test.stopTest();
+
+        // Verify the request was not processed by trigger (no worker assigned)
+        Maintenance_Request__c insertedRequest = [
+            SELECT Id, Assigned_Worker__c, Status__c, Scheduled__c
+            FROM Maintenance_Request__c
+            WHERE Id = :request.Id
+        ];
+
+        System.assertEquals(null, insertedRequest.Assigned_Worker__c, 'Worker should not be auto-assigned for non-New status');
+        System.assertEquals('In Progress', insertedRequest.Status__c, 'Status should remain as originally set');
+        System.assertEquals(null, insertedRequest.Scheduled__c, 'Scheduled date should not be set by trigger');
+    }
+}

package/dist/force-app/main/default/classes/MaintenanceRequestTriggerHandler_Test.cls-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
+    <apiVersion>66.0</apiVersion>
+    <status>Active</status>
+</ApexClass>

package/dist/force-app/main/default/classes/TenantTriggerHandler.cls

@@ -0,0 +1,77 @@
+/**
+ * Assigns Tenant_Maintenance_Access permission set to users linked to Tenant__c records.
+ * When a Tenant is created or updated with User__c set, the linked user gets the permission set.
+ */
+public with sharing class TenantTriggerHandler {
+
+    private static final String PERMISSION_SET_NAME = 'Tenant_Maintenance_Access';
+
+    /**
+     * Assign Tenant_Maintenance_Access to each user linked via Tenant__c.User__c.
+     * Insert: all records with User__c set.
+     * Update: records where User__c was set or changed to a non-null value.
+     */
+    public static void assignTenantMaintenanceAccess(List<Tenant__c> newList, Map<Id, Tenant__c> oldMap) {
+        Set<Id> userIds = new Set<Id>();
+        for (Tenant__c t : newList) {
+            if (t.User__c == null) {
+                continue;
+            }
+            if (oldMap == null) {
+                userIds.add(t.User__c);
+            } else {
+                Tenant__c oldRec = oldMap.get(t.Id);
+                if (oldRec == null || oldRec.User__c != t.User__c) {
+                    userIds.add(t.User__c);
+                }
+            }
+        }
+        if (userIds.isEmpty()) {
+            return;
+        }
+        assignTenantMaintenanceAccessAsync(new List<Id>(userIds));
+    }
+
+    @future
+    private static void assignTenantMaintenanceAccessAsync(List<Id> userIdsList) {
+        Set<Id> userIds = new Set<Id>(userIdsList);
+        if (userIds.isEmpty()) {
+            return;
+        }
+        List<PermissionSet> permSets = [
+            SELECT Id
+            FROM PermissionSet
+            WHERE Name = :PERMISSION_SET_NAME
+            AND IsOwnedByProfile = false
+            LIMIT 1
+        ];
+        if (permSets.isEmpty()) {
+            return;
+        }
+        Id permSetId = permSets[0].Id;
+
+        Set<Id> alreadyAssigned = new Set<Id>();
+        for (PermissionSetAssignment psa : [
+            SELECT AssigneeId
+            FROM PermissionSetAssignment
+            WHERE PermissionSetId = :permSetId
+            AND AssigneeId IN :userIds
+        ]) {
+            alreadyAssigned.add(psa.AssigneeId);
+        }
+
+        List<PermissionSetAssignment> toInsert = new List<PermissionSetAssignment>();
+        for (Id uid : userIds) {
+            if (alreadyAssigned.contains(uid)) {
+                continue;
+            }
+            toInsert.add(new PermissionSetAssignment(
+                PermissionSetId = permSetId,
+                AssigneeId = uid
+            ));
+        }
+        if (!toInsert.isEmpty()) {
+            insert toInsert;
+        }
+    }
+}

package/dist/force-app/main/default/classes/TenantTriggerHandler.cls-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
+    <apiVersion>66.0</apiVersion>
+    <status>Active</status>
+</ApexClass>