@salesforce/webapp-template-app-react-sample-b2x-experimental 1.84.1 → 1.85.0

package/dist/force-app/main/default/webapplications/appreactsampleb2x/src/api/maintenanceRequestApi.ts

@@ -2,7 +2,12 @@
  * Maintenance_Request__c: list via GraphQL, create via createRecord.
  */
 import { createRecord } from "@salesforce/webapp-experimental/api";
-import { executeGraphQL } from "./graphqlClient";
+import { gql } from "@salesforce/sdk-data";
+import type {
+	MaintenanceRequestsQuery,
+	MaintenanceRequestsQueryVariables,
+} from "@/api/graphql-operations-types.js";
+import { executeGraphQL } from "@/api/graphqlClient.js";
 
 const OBJECT_API_NAME = "Maintenance_Request__c";
 
@@ -15,6 +20,8 @@ export interface MaintenanceRequestSummary {
 	priority: string | null;
 	status: string | null;
 	dateRequested: string | null;
+	/** Tenant / user the request is assigned to (from User__r lookup). */
+	tenantName: string | null;
 }
 
 function pick<T>(obj: T, key: keyof T): unknown {
@@ -30,33 +37,47 @@ function str(x: unknown): string | null {
 	return String(x);
 }
 
-type Node = {
+/** Node shape from MaintenanceRequests query (matches graphql-operations-types). */
+interface MaintenanceRequestNode {
 	Id: string;
 	ApiName?: string | null;
 	Name?: { value?: unknown; displayValue?: string | null } | null;
-	Title__c?: { value?: unknown; displayValue?: string | null } | null;
 	Description__c?: { value?: unknown; displayValue?: string | null } | null;
 	Type__c?: { value?: unknown; displayValue?: string | null } | null;
 	Priority__c?: { value?: unknown; displayValue?: string | null } | null;
 	Status__c?: { value?: unknown; displayValue?: string | null } | null;
-	Date_Requested__c?: { value?: unknown; displayValue?: string | null } | null;
-};
+	Scheduled__c?: { value?: unknown; displayValue?: string | null } | null;
+	User__r?: { Name?: { value?: unknown; displayValue?: string | null } | null } | null;
+}
 
-function nodeToSummary(node: Node): MaintenanceRequestSummary {
+function nodeToSummary(node: MaintenanceRequestNode): MaintenanceRequestSummary {
+	const desc = str(pick(node, "Description__c"));
+	const userRef = node.User__r as
+		| { Name?: { value?: unknown; displayValue?: string | null } }
+		| undefined;
+	const tenantName =
+		str(
+			userRef?.Name && typeof userRef.Name === "object"
+				? (userRef.Name as { value?: unknown }).value
+				: null,
+		) ??
+		str(userRef?.Name?.displayValue) ??
+		null;
 	return {
 		id: node.Id,
 		name:
 			str(pick(node, "Name")) ?? str((node.Name as { displayValue?: string | null })?.displayValue),
-		title: str(pick(node, "Title__c")),
-		description: str(pick(node, "Description__c")),
+		title: desc,
+		description: desc,
 		type: str(pick(node, "Type__c")),
 		priority: str(pick(node, "Priority__c")),
 		status: str(pick(node, "Status__c")),
-		dateRequested: str(pick(node, "Date_Requested__c")),
+		dateRequested: str(pick(node, "Scheduled__c")),
+		tenantName,
 	};
 }
 
-const MAINTENANCE_REQUESTS_QUERY = /* GraphQL */ `
+const MAINTENANCE_REQUESTS_QUERY = gql`
 	query MaintenanceRequests($first: Int!, $after: String) {
 		uiapi {
 			query {
@@ -69,10 +90,6 @@ const MAINTENANCE_REQUESTS_QUERY = /* GraphQL */ `
 								value
 								displayValue
 							}
-							Title__c {
-								value
-								displayValue
-							}
 							Description__c {
 								value
 								displayValue
@@ -89,10 +106,16 @@ const MAINTENANCE_REQUESTS_QUERY = /* GraphQL */ `
 								value
 								displayValue
 							}
-							Date_Requested__c {
+							Scheduled__c {
 								value
 								displayValue
 							}
+							User__r {
+								Name {
+									value
+									displayValue
+								}
+							}
 						}
 						cursor
 					}
@@ -106,28 +129,19 @@ const MAINTENANCE_REQUESTS_QUERY = /* GraphQL */ `
 	}
 `;
 
-interface MaintenanceRequestGraphQLResponse {
-	uiapi?: {
-		query?: {
-			Maintenance_Request__c?: {
-				edges?: ({ node?: Node | null } | null)[] | null;
-			} | null;
-		} | null;
-	} | null;
-}
-
 export async function queryMaintenanceRequests(
 	first: number = 50,
 	after: string | null = null,
 ): Promise<MaintenanceRequestSummary[]> {
-	const response = await executeGraphQL<MaintenanceRequestGraphQLResponse>(
-		MAINTENANCE_REQUESTS_QUERY,
-		{ first, after: after ?? null } as Record<string, unknown>,
-	);
+	const variables: MaintenanceRequestsQueryVariables = { first, after: after ?? null };
+	const response = await executeGraphQL<
+		MaintenanceRequestsQuery,
+		MaintenanceRequestsQueryVariables
+	>(MAINTENANCE_REQUESTS_QUERY, variables);
 	const edges = response.uiapi?.query?.Maintenance_Request__c?.edges ?? [];
 	const list: MaintenanceRequestSummary[] = [];
 	for (const e of edges) {
-		if (e?.node) list.push(nodeToSummary(e.node));
+		if (e?.node) list.push(nodeToSummary(e.node as MaintenanceRequestNode));
 	}
 	// Sort by date requested descending (newest first)
 	list.sort((a, b) => {
@@ -139,12 +153,11 @@ export async function queryMaintenanceRequests(
 }
 
 export interface CreateMaintenanceRequestInput {
-	Title__c: string;
-	Description__c?: string | null;
+	Description__c: string;
 	Type__c?: string | null;
 	Priority__c?: string;
 	Status__c?: string;
-	Date_Requested__c?: string | null;
+	Scheduled__c?: string | null;
 }
 
 function getRecordIdFromResponse(result: Record<string, unknown>): string {
@@ -159,16 +172,15 @@ function getRecordIdFromResponse(result: Record<string, unknown>): string {
 export async function createMaintenanceRequest(
 	input: CreateMaintenanceRequestInput,
 ): Promise<{ id: string }> {
-	const title = input.Title__c?.trim();
-	if (!title) throw new Error("Title is required");
+	const description = input.Description__c?.trim();
+	if (!description) throw new Error("Description is required");
 	const fields: Record<string, unknown> = {
-		Title__c: title,
+		Description__c: description,
 		Priority__c: input.Priority__c?.trim() || "Standard",
 		Status__c: input.Status__c?.trim() || "New",
 	};
-	if (input.Description__c?.trim()) fields.Description__c = input.Description__c.trim();
 	if (input.Type__c?.trim()) fields.Type__c = input.Type__c.trim();
-	if (input.Date_Requested__c?.trim()) fields.Date_Requested__c = input.Date_Requested__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

package/dist/force-app/main/default/webapplications/appreactsampleb2x/src/api/propertyDetailGraphQL.ts

@@ -2,10 +2,23 @@
  * GraphQL queries for Property_Listing__c detail and related Property__c data:
  * Property_Image__c, Property_Cost__c, Property_Feature__c.
  */
-import { executeGraphQL } from "./graphqlClient";
+import { gql } from "@salesforce/sdk-data";
+import type {
+	ListingByIdQuery,
+	ListingByIdQueryVariables,
+	PropertyByIdQuery,
+	PropertyByIdQueryVariables,
+	PropertyImagesQuery,
+	PropertyImagesQueryVariables,
+	PropertyCostsQuery,
+	PropertyCostsQueryVariables,
+	PropertyFeaturesQuery,
+	PropertyFeaturesQueryVariables,
+} from "@/api/graphql-operations-types.js";
+import { executeGraphQL } from "@/api/graphqlClient.js";
 
 // ---- Listing by Id ----
-const LISTING_QUERY = /* GraphQL */ `
+const LISTING_QUERY = gql`
 	query ListingById($listingId: ID!) {
 		uiapi {
 			query {
@@ -46,23 +59,11 @@ export interface ListingDetail {
 }
 
 export async function fetchListingById(listingId: string): Promise<ListingDetail | null> {
-	const res = await executeGraphQL<{
-		uiapi?: {
-			query?: {
-				Property_Listing__c?: {
-					edges?: Array<{
-						node?: {
-							Id: string;
-							Name?: { value?: string | null; displayValue?: string | null } | null;
-							Listing_Price__c?: { value?: unknown; displayValue?: string | null } | null;
-							Listing_Status__c?: { value?: string | null; displayValue?: string | null } | null;
-							Property__c?: { value?: string | null; displayValue?: string | null } | null;
-						} | null;
-					}> | null;
-				} | null;
-			} | null;
-		} | null;
-	}>(LISTING_QUERY, { listingId });
+	const variables: ListingByIdQueryVariables = { listingId };
+	const res = await executeGraphQL<ListingByIdQuery, ListingByIdQueryVariables>(
+		LISTING_QUERY,
+		variables,
+	);
 	const node = res.uiapi?.query?.Property_Listing__c?.edges?.[0]?.node;
 	if (!node) return null;
 	const prop = node.Property__c;
@@ -84,7 +85,7 @@ export async function fetchListingById(listingId: string): Promise<ListingDetail
 }
 
 // ---- Property by Id ----
-const PROPERTY_QUERY = /* GraphQL */ `
+const PROPERTY_QUERY = gql`
 	query PropertyById($propertyId: ID!) {
 		uiapi {
 			query {
@@ -100,7 +101,7 @@ const PROPERTY_QUERY = /* GraphQL */ `
 								value
 								displayValue
 							}
-							Property_Type__c {
+							Type__c {
 								value
 								displayValue
 							}
@@ -116,7 +117,7 @@ const PROPERTY_QUERY = /* GraphQL */ `
 								value
 								displayValue
 							}
-							Square_Footage__c {
+							Sq_Ft__c {
 								value
 								displayValue
 							}
@@ -145,27 +146,11 @@ export interface PropertyDetail {
 }
 
 export async function fetchPropertyById(propertyId: string): Promise<PropertyDetail | null> {
-	const res = await executeGraphQL<{
-		uiapi?: {
-			query?: {
-				Property__c?: {
-					edges?: Array<{
-						node?: {
-							Id: string;
-							Name?: { value?: string | null; displayValue?: string | null } | null;
-							Address__c?: { value?: string | null; displayValue?: string | null } | null;
-							Property_Type__c?: { value?: string | null; displayValue?: string | null } | null;
-							Monthly_Rent__c?: { value?: unknown; displayValue?: string | null } | null;
-							Bedrooms__c?: { value?: unknown; displayValue?: string | null } | null;
-							Bathrooms__c?: { value?: unknown; displayValue?: string | null } | null;
-							Square_Footage__c?: { value?: unknown; displayValue?: string | null } | null;
-							Description__c?: { value?: string | null; displayValue?: string | null } | null;
-						} | null;
-					}> | null;
-				} | null;
-			} | null;
-		} | null;
-	}>(PROPERTY_QUERY, { propertyId });
+	const variables: PropertyByIdQueryVariables = { propertyId };
+	const res = await executeGraphQL<PropertyByIdQuery, PropertyByIdQueryVariables>(
+		PROPERTY_QUERY,
+		variables,
+	);
 	const node = res.uiapi?.query?.Property__c?.edges?.[0]?.node;
 	if (!node) return null;
 	const v = (f: { value?: unknown; displayValue?: string | null } | null | undefined) =>
@@ -182,13 +167,13 @@ export async function fetchPropertyById(propertyId: string): Promise<PropertyDet
 				? String(node.Address__c.value)
 				: (node.Address__c?.displayValue ?? null),
 		propertyType:
-			node.Property_Type__c?.value != null
-				? String(node.Property_Type__c.value)
-				: (node.Property_Type__c?.displayValue ?? null),
+			node.Type__c?.value != null
+				? String(node.Type__c.value)
+				: (node.Type__c?.displayValue ?? null),
 		monthlyRent: v(node.Monthly_Rent__c),
 		bedrooms: v(node.Bedrooms__c),
 		bathrooms: v(node.Bathrooms__c),
-		squareFootage: v(node.Square_Footage__c),
+		squareFootage: v(node.Sq_Ft__c),
 		description:
 			node.Description__c?.value != null
 				? String(node.Description__c.value)
@@ -211,7 +196,7 @@ export async function fetchPropertyAddresses(
 }
 
 // ---- Property Images by Property Id ----
-const IMAGES_QUERY = /* GraphQL */ `
+const IMAGES_QUERY = gql`
 	query PropertyImages($propertyId: ID!) {
 		uiapi {
 			query {
@@ -257,24 +242,11 @@ export interface PropertyImageRecord {
 }
 
 export async function fetchImagesByPropertyId(propertyId: string): Promise<PropertyImageRecord[]> {
-	const res = await executeGraphQL<{
-		uiapi?: {
-			query?: {
-				Property_Image__c?: {
-					edges?: Array<{
-						node?: {
-							Id: string;
-							Name?: { value?: string | null; displayValue?: string | null } | null;
-							Image_URL__c?: { value?: string | null; displayValue?: string | null } | null;
-							Image_Type__c?: { value?: string | null; displayValue?: string | null } | null;
-							Display_Order__c?: { value?: unknown; displayValue?: string | null } | null;
-							Alt_Text__c?: { value?: string | null; displayValue?: string | null } | null;
-						} | null;
-					}> | null;
-				} | null;
-			} | null;
-		} | null;
-	}>(IMAGES_QUERY, { propertyId });
+	const variables: PropertyImagesQueryVariables = { propertyId };
+	const res = await executeGraphQL<PropertyImagesQuery, PropertyImagesQueryVariables>(
+		IMAGES_QUERY,
+		variables,
+	);
 	const edges = res.uiapi?.query?.Property_Image__c?.edges ?? [];
 	const list: PropertyImageRecord[] = [];
 	for (const e of edges) {
@@ -304,7 +276,7 @@ export async function fetchImagesByPropertyId(propertyId: string): Promise<Prope
 }
 
 // ---- Property Costs by Property Id ----
-const COSTS_QUERY = /* GraphQL */ `
+const COSTS_QUERY = gql`
 	query PropertyCosts($propertyId: ID!) {
 		uiapi {
 			query {
@@ -350,24 +322,11 @@ export interface PropertyCostRecord {
 }
 
 export async function fetchCostsByPropertyId(propertyId: string): Promise<PropertyCostRecord[]> {
-	const res = await executeGraphQL<{
-		uiapi?: {
-			query?: {
-				Property_Cost__c?: {
-					edges?: Array<{
-						node?: {
-							Id: string;
-							Cost_Category__c?: { value?: string | null; displayValue?: string | null } | null;
-							Cost_Amount__c?: { value?: unknown; displayValue?: string | null } | null;
-							Cost_Date__c?: { value?: string | null; displayValue?: string | null } | null;
-							Description__c?: { value?: string | null; displayValue?: string | null } | null;
-							Vendor__c?: { value?: string | null; displayValue?: string | null } | null;
-						} | null;
-					}> | null;
-				} | null;
-			} | null;
-		} | null;
-	}>(COSTS_QUERY, { propertyId });
+	const variables: PropertyCostsQueryVariables = { propertyId };
+	const res = await executeGraphQL<PropertyCostsQuery, PropertyCostsQueryVariables>(
+		COSTS_QUERY,
+		variables,
+	);
 	const edges = res.uiapi?.query?.Property_Cost__c?.edges ?? [];
 	const list: PropertyCostRecord[] = [];
 	for (const e of edges) {
@@ -404,7 +363,7 @@ export async function fetchCostsByPropertyId(propertyId: string): Promise<Proper
 }
 
 // ---- Property Features by Property Id ----
-const FEATURES_QUERY = /* GraphQL */ `
+const FEATURES_QUERY = gql`
 	query PropertyFeatures($propertyId: ID!) {
 		uiapi {
 			query {
@@ -442,22 +401,11 @@ export interface PropertyFeatureRecord {
 export async function fetchFeaturesByPropertyId(
 	propertyId: string,
 ): Promise<PropertyFeatureRecord[]> {
-	const res = await executeGraphQL<{
-		uiapi?: {
-			query?: {
-				Property_Feature__c?: {
-					edges?: Array<{
-						node?: {
-							Id: string;
-							Name?: { value?: string | null; displayValue?: string | null } | null;
-							Feature_Category__c?: { value?: string | null; displayValue?: string | null } | null;
-							Description__c?: { value?: string | null; displayValue?: string | null } | null;
-						} | null;
-					}> | null;
-				} | null;
-			} | null;
-		} | null;
-	}>(FEATURES_QUERY, { propertyId });
+	const variables: PropertyFeaturesQueryVariables = { propertyId };
+	const res = await executeGraphQL<PropertyFeaturesQuery, PropertyFeaturesQueryVariables>(
+		FEATURES_QUERY,
+		variables,
+	);
 	const edges = res.uiapi?.query?.Property_Feature__c?.edges ?? [];
 	const list: PropertyFeatureRecord[] = [];
 	for (const e of edges) {