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

package/dist/force-app/main/default/webapplications/appreactsampleb2x/src/api/graphql-operations-types.ts

@@ -0,0 +1,296 @@
+/**
+ * Generated operation types for B2X GraphQL queries.
+ * Regenerate with codegen (e.g. npm run graphql:codegen) when schema or operations change.
+ */
+
+// ---- MaintenanceRequests ----
+export interface MaintenanceRequestsQueryVariables {
+	first: number;
+	after?: string | null;
+}
+
+export interface MaintenanceRequestsQuery {
+	uiapi?: {
+		query?: {
+			Maintenance_Request__c?: {
+				edges?: Array<{
+					node?: {
+						Id: string;
+						ApiName?: string | null;
+						Name?: { 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;
+						Scheduled__c?: { value?: unknown; displayValue?: string | null } | null;
+						User__r?: {
+							Name?: { value?: unknown; displayValue?: string | null } | null;
+						} | null;
+					} | null;
+				}> | null;
+				pageInfo?: {
+					hasNextPage?: boolean | null;
+					endCursor?: string | null;
+				} | null;
+			} | null;
+		} | null;
+	} | null;
+}
+
+// ---- PropertyListings ----
+/** Single-field condition; Property__r filters on related Property (name, address, bedrooms). */
+export type PropertyListingsWhereCondition = {
+	Name?: { like: string };
+	Listing_Status__c?: { like: string };
+	Listing_Price__c?: { gte?: number; lte?: number };
+	Property__r?: {
+		Name?: { like: string };
+		Address__c?: { like: string };
+		Bedrooms__c?: { gte?: number };
+	};
+};
+/** GraphQL ResultOrder values for orderBy (use ResultOrder.Asc / ResultOrder.Desc). */
+export const ResultOrder = {
+	Asc: "ASC",
+	Desc: "DESC",
+} as const;
+export type ResultOrder = (typeof ResultOrder)[keyof typeof ResultOrder];
+
+/** orderBy for Property_Listing__c (e.g. { Listing_Price__c: { order: ResultOrder.Asc } }). */
+export type PropertyListingsOrderBy = {
+	Listing_Price__c?: { order: ResultOrder };
+	Property__r?: { Bedrooms__c?: { order: ResultOrder } };
+};
+
+/** Where clause: condition, or { and: conditions[] }, or { or: conditions[] }. */
+export interface PropertyListingsQueryVariables {
+	where?:
+		| PropertyListingsWhereCondition
+		| { and: Array<PropertyListingsWhereCondition | { or: PropertyListingsWhereCondition[] }> }
+		| { or: PropertyListingsWhereCondition[] };
+	first: number;
+	after?: string | null;
+	orderBy?: PropertyListingsOrderBy | null;
+}
+
+export interface PropertyListingsQuery {
+	uiapi?: {
+		query?: {
+			Property_Listing__c?: {
+				edges?: Array<{
+					node?: {
+						Id: string;
+						ApiName?: string | null;
+						Name?: { value?: string | null; displayValue?: string | null } | null;
+						Listing_Price__c?: {
+							value?: number | null;
+							displayValue?: string | null;
+						} | null;
+						Listing_Status__c?: {
+							value?: string | null;
+							displayValue?: string | null;
+						} | null;
+						Property__c?: { value?: string | null; displayValue?: string | null } | null;
+						Property__r?: {
+							Name?: { value?: string | null; displayValue?: string | null } | null;
+							Address__c?: { value?: string | null; displayValue?: string | null } | null;
+							Bedrooms__c?: { value?: number | null; displayValue?: string | null } | null;
+						} | null;
+					} | null;
+					cursor?: string | null;
+				}> | null;
+				pageInfo?: {
+					hasNextPage?: boolean | null;
+					hasPreviousPage?: boolean | null;
+					startCursor?: string | null;
+					endCursor?: string | null;
+				} | null;
+				totalCount?: number | null;
+			} | null;
+		} | null;
+	} | null;
+}
+
+// ---- ListingById ----
+export interface ListingByIdQueryVariables {
+	listingId: string;
+}
+
+export interface ListingByIdQuery {
+	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;
+}
+
+// ---- PropertyById ----
+export interface PropertyByIdQueryVariables {
+	propertyId: string;
+}
+
+export interface PropertyByIdQuery {
+	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;
+						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;
+						Sq_Ft__c?: { value?: unknown; displayValue?: string | null } | null;
+						Description__c?: {
+							value?: string | null;
+							displayValue?: string | null;
+						} | null;
+					} | null;
+				}> | null;
+			} | null;
+		} | null;
+	} | null;
+}
+
+// ---- PropertyImages ----
+export interface PropertyImagesQueryVariables {
+	propertyId: string;
+}
+
+export interface PropertyImagesQuery {
+	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;
+}
+
+// ---- PropertyCosts ----
+export interface PropertyCostsQueryVariables {
+	propertyId: string;
+}
+
+export interface PropertyCostsQuery {
+	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;
+}
+
+// ---- PropertyFeatures ----
+export interface PropertyFeaturesQueryVariables {
+	propertyId: string;
+}
+
+export interface PropertyFeaturesQuery {
+	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;
+}
+
+// ---- GetUserInfo ----
+export interface GetUserInfoQuery {
+	uiapi?: {
+		query?: {
+			User?: {
+				edges?: Array<{
+					node?: {
+						Id: string;
+						Name?: { value?: string | null } | null;
+					} | null;
+				}> | null;
+			} | null;
+		} | null;
+	} | null;
+}

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

@@ -1,17 +1,22 @@
 /**
- * GraphQL client using getDataSDK (replaces legacy executeGraphQL from webapp-experimental).
+ * Thin GraphQL client: getDataSDK + data.graphql with centralized error handling.
+ * Use with gql-tagged queries and generated operation types for type-safe calls.
  */
 import { getDataSDK } from "@salesforce/sdk-data";
 
-export async function executeGraphQL<T>(
-	query: string,
-	variables?: Record<string, unknown>,
-): Promise<T> {
+export async function executeGraphQL<TData, TVariables = Record<string, unknown>>(
+	query: string | { kind: string; definitions: unknown[] },
+	variables?: TVariables,
+): Promise<TData> {
 	const data = await getDataSDK();
-	const response = await data.graphql?.<T>(query, variables);
+	// SDK types graphql() first param as string; at runtime it may accept gql DocumentNode too
+	const response = await data.graphql?.<TData>(
+		query as unknown as string,
+		variables as Record<string, unknown>,
+	);
 	if (response?.errors?.length) {
 		const msg = response.errors.map((e) => e.message).join("; ");
 		throw new Error(`GraphQL Error: ${msg}`);
 	}
-	return (response?.data ?? {}) as T;
+	return (response?.data ?? {}) as TData;
 }

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