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

package/dist/force-app/main/default/uiBundles/propertyrentalapp/src/api/graphqlClient.ts

@@ -0,0 +1,25 @@
+/**
+ * Thin GraphQL client: createDataSDK + data.graphql with centralized error handling.
+ * Use with gql-tagged queries and generated operation types for type-safe calls.
+ */
+import { createDataSDK } from '@salesforce/sdk-data';
+
+export async function executeGraphQL<TData, TVariables>(
+  query: string,
+  variables?: TVariables
+): Promise<TData> {
+  const data = await createDataSDK();
+  // SDK types graphql() first param as string; at runtime it may accept gql DocumentNode too
+  const response = await data.graphql?.<TData, TVariables>(query, variables);
+
+  if (!response) {
+    throw new Error('GraphQL response is undefined');
+  }
+
+  if (response?.errors?.length) {
+    const msg = response.errors.map(e => e.message).join('; ');
+    throw new Error(`GraphQL Error: ${msg}`);
+  }
+
+  return response.data;
+}

package/dist/force-app/main/default/uiBundles/propertyrentalapp/src/api/leads/leadApi.ts

@@ -0,0 +1,78 @@
+/**
+ * Create Lead records in Salesforce for Contact Us form and newsletter signup.
+ * Uses the standard Lead object (FirstName, LastName, Email, Phone, Company, Description, LeadSource).
+ */
+import { createRecord } from "@salesforce/ui-bundle/api";
+
+const OBJECT_API_NAME = "Lead";
+
+const LEAD_SOURCE_WEBSITE = "Website";
+const LEAD_SOURCE_NEWSLETTER = "Website Newsletter";
+
+function getRecordIdFromResponse(result: Record<string, unknown>): string {
+	const id =
+		typeof result.id === "string"
+			? result.id
+			: (result.fields as Record<string, { value?: string }> | undefined)?.Id?.value;
+	if (!id) throw new Error("Create succeeded but no record id returned");
+	return id;
+}
+
+export interface ContactUsInput extends UserInfo {
+	Subject?: string;
+	Message: string;
+}
+
+export interface UserInfo {
+	FirstName: string;
+	LastName: string;
+	Email: string;
+	Phone?: string;
+}
+
+/**
+ * Creates a Lead from the Contact Us form. Uses Company for subject, Description for message.
+ */
+export async function createContactUsLead(input: ContactUsInput): Promise<{ id: string }> {
+	const fields: Record<string, unknown> = {
+		Company: (input.Subject ?? "Contact Us").trim() || "Contact Us",
+		Description: input.Message.trim() || "",
+		LeadSource: LEAD_SOURCE_WEBSITE,
+	};
+	if (input.FirstName?.trim()) {
+		fields.FirstName = input.FirstName.trim();
+	}
+	if (input.LastName?.trim()) {
+		fields.LastName = input.LastName.trim();
+	}
+	if (input.Email?.trim()) {
+		fields.Email = input.Email.trim();
+	}
+	if (input.Phone?.trim()) {
+		fields.Phone = input.Phone.trim();
+	}
+	const result = (await createRecord(OBJECT_API_NAME, fields)) as unknown as Record<
+		string,
+		unknown
+	>;
+	return { id: getRecordIdFromResponse(result) };
+}
+
+/**
+ * Creates a Lead for newsletter/email signup. LastName and Company set to placeholders so Lead is valid.
+ */
+export async function createNewsletterLead(email: string): Promise<{ id: string }> {
+	const trimmed = email.trim();
+	if (!trimmed) throw new Error("Email is required");
+	const fields: Record<string, unknown> = {
+		LastName: "Newsletter Subscriber",
+		Company: "Website",
+		Email: trimmed,
+		LeadSource: LEAD_SOURCE_NEWSLETTER,
+	};
+	const result = (await createRecord(OBJECT_API_NAME, fields)) as unknown as Record<
+		string,
+		unknown
+	>;
+	return { id: getRecordIdFromResponse(result) };
+}

package/dist/force-app/main/default/uiBundles/propertyrentalapp/src/api/maintenanceRequests/maintenanceRequestApi.ts

@@ -0,0 +1,74 @@
+/**
+ * Maintenance_Request__c: list via GraphQL, create via createRecord.
+ */
+import { createRecord } from "@salesforce/ui-bundle/api";
+import MAINTENANCE_REQUESTS_QUERY from "./query/maintenanceRequests.graphql?raw";
+import type {
+	MaintenanceRequestsQuery,
+	MaintenanceRequestsQueryVariables,
+} from "@/api/graphql-operations-types.js";
+import {
+	searchObjects,
+	type ObjectSearchOptions,
+} from "@/features/object-search/api/objectSearchService";
+
+const OBJECT_API_NAME = "Maintenance_Request__c";
+
+export type MaintenanceRequestSearchResult = NonNullable<
+	MaintenanceRequestsQuery["uiapi"]["query"]["Maintenance_Request__c"]
+>;
+
+export type MaintenanceRequestNode = NonNullable<
+	NonNullable<NonNullable<MaintenanceRequestSearchResult["edges"]>[number]>["node"]
+>;
+
+export type MaintenanceRequestSearchOptions = ObjectSearchOptions<
+	MaintenanceRequestsQueryVariables["where"],
+	MaintenanceRequestsQueryVariables["orderBy"]
+>;
+
+export async function searchMaintenanceRequests(
+	options: MaintenanceRequestSearchOptions = {},
+): Promise<MaintenanceRequestSearchResult> {
+	return searchObjects<
+		MaintenanceRequestSearchResult,
+		MaintenanceRequestsQuery,
+		MaintenanceRequestsQueryVariables
+	>(MAINTENANCE_REQUESTS_QUERY, OBJECT_API_NAME, options);
+}
+
+export interface CreateMaintenanceRequestInput {
+	Description__c: string;
+	Type__c?: string | null;
+	Priority__c?: string;
+	Status__c?: string;
+	Scheduled__c?: string | null;
+}
+
+function getRecordIdFromResponse(result: Record<string, unknown>): string {
+	const id =
+		typeof result.id === "string"
+			? result.id
+			: (result.fields as Record<string, { value?: string }> | undefined)?.Id?.value;
+	if (!id) throw new Error("Create succeeded but no record id returned");
+	return id;
+}
+
+export async function createMaintenanceRequest(
+	input: CreateMaintenanceRequestInput,
+): Promise<{ id: string }> {
+	const description = input.Description__c?.trim();
+	if (!description) throw new Error("Description is required");
+	const fields: Record<string, unknown> = {
+		Description__c: description,
+		Priority__c: input.Priority__c?.trim() || "Standard",
+		Status__c: input.Status__c?.trim() || "New",
+	};
+	if (input.Type__c?.trim()) fields.Type__c = input.Type__c.trim();
+	if (input.Scheduled__c?.trim()) fields.Scheduled__c = input.Scheduled__c.trim();
+	const result = (await createRecord(OBJECT_API_NAME, fields)) as unknown as Record<
+		string,
+		unknown
+	>;
+	return { id: getRecordIdFromResponse(result) };
+}

package/dist/force-app/main/default/uiBundles/propertyrentalapp/src/api/maintenanceRequests/query/maintenanceRequests.graphql

@@ -0,0 +1,60 @@
+query MaintenanceRequests(
+	$first: Int
+	$after: String
+	$where: Maintenance_Request__c_Filter
+	$orderBy: Maintenance_Request__c_OrderBy
+) {
+	uiapi {
+		query {
+			Maintenance_Request__c(first: $first, after: $after, where: $where, orderBy: $orderBy) {
+				edges {
+					node {
+						Id
+						ApiName
+						Name @optional {
+							value
+							displayValue
+						}
+						Description__c @optional {
+							value
+							displayValue
+						}
+						Type__c @optional {
+							value
+							displayValue
+						}
+						Priority__c @optional {
+							value
+							displayValue
+						}
+						Status__c @optional {
+							value
+							displayValue
+						}
+						Scheduled__c @optional {
+							value
+							displayValue
+						}
+						User__r @optional {
+							Name @optional {
+								value
+								displayValue
+							}
+						}
+						Property__r @optional {
+							Address__c @optional {
+								value
+								displayValue
+							}
+						}
+					}
+					cursor
+				}
+				pageInfo {
+					hasNextPage
+					endCursor
+				}
+			}
+		}
+	}
+}

package/dist/force-app/main/default/uiBundles/propertyrentalapp/src/api/properties/propertyDetailGraphQL.ts

@@ -0,0 +1,75 @@
+/**
+ * GraphQL queries for property detail and related data.
+ */
+import LISTING_QUERY from "./query/listingById.graphql?raw";
+import PROPERTY_DETAIL_QUERY from "./query/propertyDetailById.graphql?raw";
+import PROPERTY_ADDRESSES_BY_IDS_QUERY from "./query/propertyAddressesByIds.graphql?raw";
+import type {
+	ListingByIdQuery,
+	ListingByIdQueryVariables,
+	PropertyDetailByIdQuery,
+	PropertyDetailByIdQueryVariables,
+	PropertyAddressesByIdsQuery,
+	PropertyAddressesByIdsQueryVariables,
+} from "@/api/graphql-operations-types.js";
+import { executeGraphQL } from "@/api/graphqlClient.js";
+
+// ---- Listing by Id (used by usePropertyDetail fallback for listing ID routes) ----
+
+export type ListingDetail = NonNullable<
+	NonNullable<
+		NonNullable<ListingByIdQuery["uiapi"]["query"]["Property_Listing__c"]>["edges"]
+	>[number]
+>["node"];
+
+export async function fetchListingById(listingId: string): Promise<ListingDetail | null> {
+	const variables: ListingByIdQueryVariables = { listingId };
+	const res = await executeGraphQL<ListingByIdQuery, ListingByIdQueryVariables>(
+		LISTING_QUERY,
+		variables,
+	);
+	return res.uiapi?.query?.Property_Listing__c?.edges?.[0]?.node ?? null;
+}
+
+// ---- Property Detail (single query with all relationships) ----
+
+export type PropertyDetailNode = NonNullable<
+	NonNullable<
+		NonNullable<PropertyDetailByIdQuery["uiapi"]["query"]["Property__c"]>["edges"]
+	>[number]
+>["node"];
+
+export async function fetchPropertyDetailById(
+	propertyId: string,
+): Promise<PropertyDetailNode | null> {
+	const variables: PropertyDetailByIdQueryVariables = { propertyId };
+	const res = await executeGraphQL<PropertyDetailByIdQuery, PropertyDetailByIdQueryVariables>(
+		PROPERTY_DETAIL_QUERY,
+		variables,
+	);
+	return res.uiapi?.query?.Property__c?.edges?.[0]?.node ?? null;
+}
+
+/** Fetch Address__c for multiple properties (for map markers). Returns id -> address. */
+export async function fetchPropertyAddresses(
+	propertyIds: string[],
+): Promise<Record<string, string>> {
+	const uniq = [...new Set(propertyIds)].filter(Boolean);
+	if (uniq.length === 0) return {};
+
+	const res = await executeGraphQL<
+		PropertyAddressesByIdsQuery,
+		PropertyAddressesByIdsQueryVariables
+	>(PROPERTY_ADDRESSES_BY_IDS_QUERY, { propertyIds: uniq });
+	const edges = res.uiapi?.query?.Property__c?.edges ?? [];
+	const entries = edges.map((edge) => {
+		const n = edge?.node;
+		if (!n) return null;
+		const address =
+			n.Address__c?.value != null
+				? String(n.Address__c.value)
+				: (n.Address__c?.displayValue ?? null);
+		return address ? ([n.Id, address] as const) : null;
+	});
+	return Object.fromEntries(entries.filter((e): e is readonly [string, string] => e != null));
+}

package/dist/force-app/main/default/uiBundles/propertyrentalapp/src/api/properties/propertyNodeUtils.ts

@@ -0,0 +1,29 @@
+import type { PropertySearchNode } from "./propertySearchService";
+
+const AMENITIES_SEPARATOR = " | ";
+
+/** Pick the primary (or first available) image URL from the child images. */
+export function extractPrimaryImageUrl(node: PropertySearchNode): string | null {
+	const images = (node.Property_Images__r?.edges ?? []).flatMap((e) => (e?.node ? [e.node] : []));
+	if (images.length === 0) return null;
+	const primary =
+		images.find((i) => (i.Image_Type__c?.value ?? "").toLowerCase() === "primary") ??
+		images.find((i) => Boolean(i.Image_URL__c?.value));
+	return primary?.Image_URL__c?.value ?? null;
+}
+
+/** Join feature descriptions into a single amenities string. */
+export function extractAmenities(node: PropertySearchNode): string {
+	const features = (node.Property_Features__r?.edges ?? []).flatMap((e) =>
+		e?.node ? [e.node] : [],
+	);
+	return features
+		.map((f) => f.Description__c?.value)
+		.filter((d): d is string => d != null && d.trim() !== "")
+		.join(AMENITIES_SEPARATOR);
+}
+
+/** Extract the address string from a property node. */
+export function extractAddress(node: PropertySearchNode): string | null {
+	return node.Address__c?.value ?? node.Address__c?.displayValue ?? null;
+}

package/dist/force-app/main/default/uiBundles/propertyrentalapp/src/api/properties/propertySearchService.ts

@@ -0,0 +1,56 @@
+import SEARCH_PROPERTIES_QUERY from "./query/searchProperties.graphql?raw";
+import DISTINCT_STATUS_QUERY from "./query/distinctPropertyStatus.graphql?raw";
+import DISTINCT_TYPE_QUERY from "./query/distinctPropertyType.graphql?raw";
+import {
+	searchObjects,
+	fetchDistinctValues,
+	type ObjectSearchOptions,
+	type PicklistOption,
+} from "../../features/object-search/api/objectSearchService";
+import type {
+	SearchPropertiesQuery,
+	SearchPropertiesQueryVariables,
+	DistinctPropertyStatusQuery,
+	DistinctPropertyTypeQuery,
+} from "../graphql-operations-types";
+
+export type PropertySearchResult = NonNullable<
+	SearchPropertiesQuery["uiapi"]["query"]["Property__c"]
+>;
+
+export type PropertySearchNode = NonNullable<
+	NonNullable<NonNullable<PropertySearchResult["edges"]>[number]>["node"]
+>;
+
+export type PropertySearchOptions = ObjectSearchOptions<
+	SearchPropertiesQueryVariables["where"],
+	SearchPropertiesQueryVariables["orderBy"]
+>;
+
+export type { PicklistOption };
+
+export async function searchProperties(
+	options: PropertySearchOptions = {},
+): Promise<PropertySearchResult> {
+	return searchObjects<PropertySearchResult, SearchPropertiesQuery, SearchPropertiesQueryVariables>(
+		SEARCH_PROPERTIES_QUERY,
+		"Property__c",
+		options,
+	);
+}
+
+export async function fetchDistinctPropertyStatus(): Promise<PicklistOption[]> {
+	return fetchDistinctValues<DistinctPropertyStatusQuery>(
+		DISTINCT_STATUS_QUERY,
+		"Property__c",
+		"Status__c",
+	);
+}
+
+export async function fetchDistinctPropertyType(): Promise<PicklistOption[]> {
+	return fetchDistinctValues<DistinctPropertyTypeQuery>(
+		DISTINCT_TYPE_QUERY,
+		"Property__c",
+		"Type__c",
+	);
+}

package/dist/force-app/main/default/uiBundles/propertyrentalapp/src/api/properties/query/distinctPropertyStatus.graphql

@@ -0,0 +1,19 @@
+query DistinctPropertyStatus {
+	uiapi {
+		aggregate {
+			Property__c(groupBy: { Status__c: { group: true } }) {
+				edges {
+					node {
+						aggregate {
+							Status__c {
+								value
+								displayValue
+								label
+							}
+						}
+					}
+				}
+			}
+		}
+	}
+}

package/dist/force-app/main/default/uiBundles/propertyrentalapp/src/api/properties/query/distinctPropertyType.graphql

@@ -0,0 +1,19 @@
+query DistinctPropertyType {
+	uiapi {
+		aggregate {
+			Property__c(groupBy: { Type__c: { group: true } }) {
+				edges {
+					node {
+						aggregate {
+							Type__c {
+								value
+								displayValue
+								label
+							}
+						}
+					}
+				}
+			}
+		}
+	}
+}

package/dist/force-app/main/default/uiBundles/propertyrentalapp/src/api/properties/query/listingById.graphql

@@ -0,0 +1,29 @@
+query ListingById($listingId: ID!) {
+	uiapi {
+		query {
+			Property_Listing__c(where: { Id: { eq: $listingId } }, first: 1) {
+				edges {
+					node {
+						Id
+						Name @optional {
+							value
+							displayValue
+						}
+						Listing_Price__c @optional {
+							value
+							displayValue
+						}
+						Listing_Status__c @optional {
+							value
+							displayValue
+						}
+						Property__c @optional {
+							value
+							displayValue
+						}
+					}
+				}
+			}
+		}
+	}
+}

package/dist/force-app/main/default/uiBundles/propertyrentalapp/src/api/properties/query/propertyAddressesByIds.graphql

@@ -0,0 +1,17 @@
+query PropertyAddressesByIds($propertyIds: [ID!]) {
+	uiapi {
+		query {
+			Property__c(where: { Id: { in: $propertyIds } }, first: 2000) {
+				edges {
+					node {
+						Id
+						Address__c @optional {
+							value
+							displayValue
+						}
+					}
+				}
+			}
+		}
+	}
+}

package/dist/force-app/main/default/uiBundles/propertyrentalapp/src/api/properties/query/propertyDetailById.graphql

@@ -0,0 +1,124 @@
+query PropertyDetailById($propertyId: ID!) {
+	uiapi {
+		query {
+			Property__c(where: { Id: { eq: $propertyId } }, first: 1) {
+				edges {
+					node {
+						Id
+						Name @optional {
+							value
+							displayValue
+						}
+						Address__c @optional {
+							value
+							displayValue
+						}
+						Coordinates__Latitude__s @optional {
+							value
+						}
+						Coordinates__Longitude__s @optional {
+							value
+						}
+						Type__c @optional {
+							value
+							displayValue
+						}
+						Monthly_Rent__c @optional {
+							value
+							displayValue
+						}
+						Bedrooms__c @optional {
+							value
+							displayValue
+						}
+						Bathrooms__c @optional {
+							value
+							displayValue
+						}
+						Sq_Ft__c @optional {
+							value
+							displayValue
+						}
+						Description__c @optional {
+							value
+							displayValue
+						}
+						Property_Images__r(first: 50, orderBy: { Display_Order__c: { order: ASC } }) {
+							edges {
+								node {
+									Id
+									Name @optional {
+										value
+									}
+									Image_URL__c @optional {
+										value
+									}
+									Image_Type__c @optional {
+										value
+									}
+									Display_Order__c @optional {
+										value
+									}
+									Alt_Text__c @optional {
+										value
+									}
+								}
+							}
+						}
+						Property_Features__r(first: 100) {
+							edges {
+								node {
+									Id
+									Name @optional {
+										value
+									}
+									Feature_Category__c @optional {
+										value
+									}
+									Description__c @optional {
+										value
+									}
+								}
+							}
+						}
+						Property_Costs__r(first: 100) {
+							edges {
+								node {
+									Id
+									Cost_Category__c @optional {
+										value
+									}
+									Cost_Amount__c @optional {
+										value
+									}
+									Cost_Date__c @optional {
+										value
+									}
+									Description__c @optional {
+										value
+									}
+								}
+							}
+						}
+						Property_Listings__r(first: 10) {
+							edges {
+								node {
+									Id
+									Name @optional {
+										value
+									}
+									Listing_Price__c @optional {
+										value
+									}
+									Listing_Status__c @optional {
+										value
+									}
+								}
+							}
+						}
+					}
+				}
+			}
+		}
+	}
+}

package/dist/force-app/main/default/uiBundles/propertyrentalapp/src/api/properties/query/searchProperties.graphql

@@ -0,0 +1,85 @@
+query SearchProperties(
+	$first: Int
+	$after: String
+	$where: Property__c_Filter
+	$orderBy: Property__c_OrderBy
+) {
+	uiapi {
+		query {
+			Property__c(first: $first, after: $after, where: $where, orderBy: $orderBy) {
+				edges {
+					node {
+						Id
+						Name {
+							value
+							displayValue
+						}
+						Address__c {
+							value
+							displayValue
+						}
+						Status__c {
+							value
+							displayValue
+						}
+						Type__c {
+							value
+							displayValue
+						}
+						Monthly_Rent__c {
+							value
+							displayValue
+						}
+						Bedrooms__c {
+							value
+							displayValue
+						}
+						Coordinates__Latitude__s {
+							value
+						}
+						Coordinates__Longitude__s {
+							value
+						}
+						CreatedDate {
+							value
+							displayValue
+						}
+						Property_Images__r(first: 5, orderBy: { Display_Order__c: { order: ASC } }) {
+							edges {
+								node {
+									Id
+									Image_URL__c {
+										value
+									}
+									Image_Type__c {
+										value
+									}
+									Display_Order__c {
+										value
+									}
+								}
+							}
+						}
+						Property_Features__r(first: 20) {
+							edges {
+								node {
+									Id
+									Description__c {
+										value
+									}
+								}
+							}
+						}
+					}
+				}
+				pageInfo {
+					hasNextPage
+					hasPreviousPage
+					endCursor
+					startCursor
+				}
+				totalCount
+			}
+		}
+	}
+}