@salesforce/templates 66.10.2 → 66.10.4

package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/package.json

@@ -18,8 +18,8 @@
     "graphql:schema": "node scripts/get-graphql-schema.mjs"
   },
   "dependencies": {
-    "@salesforce/platform-sdk": "^10.12.2",
-    "@salesforce/ui-bundle": "^10.12.2",
+    "@salesforce/platform-sdk": "^10.24.0",
+    "@salesforce/ui-bundle": "^10.24.0",
     "@tailwindcss/vite": "^4.1.17",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
@@ -45,7 +45,8 @@
     "@graphql-eslint/eslint-plugin": "^4.1.0",
     "@graphql-tools/utils": "^11.0.0",
     "@playwright/test": "^1.49.0",
-    "@salesforce/vite-plugin-ui-bundle": "^10.12.2",
+    "@salesforce/graphiti": "^10.24.0",
+    "@salesforce/vite-plugin-ui-bundle": "^10.24.0",
     "@testing-library/jest-dom": "^6.6.3",
     "@testing-library/react": "^16.1.0",
     "@testing-library/user-event": "^14.5.2",

package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/scripts/get-graphql-schema.mjs

@@ -15,13 +15,16 @@ import { buildClientSchema, getIntrospectionQuery, printSchema } from 'graphql';
 import { pruneSchema } from '@graphql-tools/utils';
 
 const DEFAULT_SCHEMA_PATH = '../../../../../schema.graphql';
+const TARGET_ORG = process.env.SF_TARGET_ORG || undefined;
 
 async function executeSalesforceGraphQLQuery(query, variables, operationName) {
-  const {
-    rawInstanceUrl: instanceUrl,
-    apiVersion,
-    accessToken,
-  } = await getOrgInfo();
+  const orgInfo = await getOrgInfo(TARGET_ORG);
+  if (!orgInfo) {
+    throw new Error(
+      'Could not resolve a Salesforce org. Set SF_TARGET_ORG or a default org.'
+    );
+  }
+  const { rawInstanceUrl: instanceUrl, apiVersion, accessToken } = orgInfo;
 
   const targetUrl = `${instanceUrl}/services/data/v${apiVersion}/graphql`;
 

package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/api/graphqlClient.ts

@@ -1,19 +1,35 @@
 /**
- * Thin GraphQL client: createDataSDK + sdk.graphql.query with centralized
- * error handling. Use with gql-tagged queries and generated operation types
- * for type-safe calls.
+ * Thin GraphQL client: createDataSDK + sdk.graphql with centralized error
+ * handling. Mutations are routed to sdk.graphql.mutate and everything else to
+ * sdk.graphql.query (the SDK rejects an operation sent to the wrong method).
+ * Use with gql-tagged queries and generated operation types for type-safe calls.
  */
 import { createDataSDK } from '@salesforce/platform-sdk';
 
+/**
+ * True when the operation's first definition is a `mutation`. Strips GraphQL
+ * comments first so a leading `# ...` line can't mask the keyword. Queries
+ * (named or anonymous `{ ... }` shorthand) and subscriptions fall through to
+ * query().
+ */
+function isMutation(operation: string): boolean {
+  return /^\s*mutation\b/.test(operation.replace(/#[^\n\r]*/g, ''));
+}
+
 export async function executeGraphQL<TData, TVariables>(
-  query: string,
+  operation: string,
   variables?: TVariables
 ): Promise<TData> {
   const data = await createDataSDK();
-  const result = await data.graphql!.query<TData, TVariables>({
-    query: query,
-    variables: variables,
-  });
+  const result = isMutation(operation)
+    ? await data.graphql!.mutate<TData, TVariables>({
+        mutation: operation,
+        variables: variables,
+      })
+    : await data.graphql!.query<TData, TVariables>({
+        query: operation,
+        variables: variables,
+      });
 
   if (result.errors?.length) {
     const msg = result.errors.map(e => e.message).join('; ');

package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/components/AgentforceConversationClient.tsx

@@ -69,6 +69,7 @@ export function AgentforceConversationClient({
 	width,
 	height,
 	styleTokens,
+	isFileBased,
 	salesforceOrigin,
 	frontdoorUrl,
 	onReady,
@@ -89,10 +90,21 @@ export function AgentforceConversationClient({
 			...(agentId !== undefined && { agentId }),
 			...(agentLabel !== undefined && { agentLabel }),
 			...(styleTokens !== undefined && { styleTokens }),
+			...(isFileBased !== undefined && { isFileBased }),
 			renderingConfig,
 			channel: "Vibes",
 		};
-	}, [agentId, agentLabel, inlineProp, headerEnabled, showHeaderIcon, width, height, styleTokens]);
+	}, [
+		agentId,
+		agentLabel,
+		inlineProp,
+		headerEnabled,
+		showHeaderIcon,
+		width,
+		height,
+		styleTokens,
+		isFileBased,
+	]);
 
 	const inline = normalizedAgentforceClientConfig?.renderingConfig?.mode === "inline";
 

package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/pages/AccountObjectDetailPage.tsx

@@ -156,7 +156,9 @@ function AccountDetailContent({ account }: { account: AccountNode }) {
 							<FieldItem label="Industry">{fieldValue(account.Industry)}</FieldItem>
 							<FieldItem label="Annual Revenue">{fieldValue(account.AnnualRevenue)}</FieldItem>
 						</FieldRow>
-						<FieldItem label="Description">{fieldValue(account.Description)}</FieldItem>
+						<dl>
+							<FieldItem label="Description">{fieldValue(account.Description)}</FieldItem>
+						</dl>
 					</Section>
 
 					<Separator />
@@ -216,7 +218,7 @@ function FieldItem({ label, children }: { label: string; children: React.ReactNo
 }
 
 function FieldRow({ children }: { children: React.ReactNode }) {
-	return <div className="grid grid-cols-2 gap-x-8 gap-y-4">{children}</div>;
+	return <dl className="grid grid-cols-2 gap-x-8 gap-y-4">{children}</dl>;
 }
 
 function Section({ title, children }: { title: string; children: React.ReactNode }) {

package/lib/templates/project/reactinternalapp/_p_/_m_/_w_/_a_/src/types/conversation.ts

@@ -33,6 +33,7 @@ export interface AgentforceConversationClientProps {
 	height?: string | number;
 	/** Theme overrides for the chat UI. */
 	styleTokens?: StyleTokens;
+	isFileBased?: boolean;
 	/** Optional. If not provided, resolved internally (e.g. from /__lo/frontdoor in dev, window.location.origin in prod). */
 	salesforceOrigin?: string;
 	/** Optional. If not provided, resolved internally in dev via /__lo/frontdoor. */

package/lib/templates/project/reactinternalapp/_p_/_m_/permissionsets/reactinternalapp_Access.permissionset-meta.xml

@@ -6,4 +6,8 @@
     </applicationVisibilities>
     <hasActivationRequired>false</hasActivationRequired>
     <label>reactinternalapp Access</label>
+    <userPermissions>
+        <enabled>true</enabled>
+        <name>ApiEnabled</name>
+    </userPermissions>
 </PermissionSet>

package/lib/templates/project/reactinternalapp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/ui-bundle-template-base-sfdx-project",
-  "version": "10.12.2",
+  "version": "10.24.0",
   "description": "Base SFDX project template",
   "license": "SEE LICENSE IN LICENSE.txt",
   "publishConfig": {
@@ -11,6 +11,7 @@
     "build": "echo 'No build required for base-sfdx-project'",
     "clean": "echo 'No clean required for base-sfdx-project'",
     "lint": "eslint --no-error-on-unmatched-pattern **/{aura,lwc}/**/*.js",
+    "validate:org-setup-config": "node scripts/validate-org-setup-config.mjs",
     "test": "npm run test:unit",
     "test:coverage": "npm run test",
     "test:unit": "sfdx-lwc-jest -- --passWithNoTests",
@@ -22,6 +23,9 @@
     "precommit": "lint-staged",
     "setup": "node scripts/org-setup.mjs"
   },
+  "dependencies": {
+    "zod": "^3.24.1"
+  },
   "devDependencies": {
     "@lwc/eslint-plugin-lwc": "^3.3.0",
     "@prettier/plugin-xml": "^3.2.2",

package/lib/templates/project/reactinternalapp/scripts/org-setup-config-schema.mjs

@@ -0,0 +1,96 @@
+/**
+ * Shared schema + validator for org-setup.config.json (W-23043729).
+ *
+ * Authored ONCE, used at TWO moments:
+ *   (a) build / CI time — `scripts/validate-org-setup-config.mjs` validates every
+ *       org-setup.config.json this repo ships, failing the build on any violation.
+ *   (b) setup runtime — `org-setup.mjs` calls `validateConfig` once in main(),
+ *       before any step runs, to catch the developer's local post-scaffold edits.
+ *
+ * `validateConfig` is pure: it parses + validates and RETURNS a result. Each call
+ * site owns its own print/exit, so the build gate can report every bad file and
+ * the runtime can exit immediately — and the validator stays unit-testable.
+ *
+ * The zod schema uses `.strict()` at every level so unknown keys (e.g. the
+ * `permsetAssignment` singular typo) are rejected rather than silently ignored.
+ */
+
+import { z } from 'zod';
+
+/** Closed set of assignee values — no arbitrary usernames. */
+const Assignee = z.enum(['currentUser', 'guestUser', 'skip']);
+
+// No siteName: for guestUser the site is derived from the single
+// networks/<siteName>.network-meta.xml the app ships (see spec §5.2).
+const Assignment = z
+  .object({
+    assignee: Assignee,
+  })
+  .strict();
+
+export const ConfigSchema = z
+  .object({
+    permsetAssignments: z
+      .object({
+        // guestUser is valid here — siteName is derived, not per-assignment.
+        defaultAssignee: Assignee.default('skip'),
+        assignments: z.record(z.string(), Assignment).default({}),
+      })
+      .strict()
+      .optional(),
+    role: z
+      .object({
+        assignee: z.literal('currentUser'), // only value the role code honors
+        roleName: z.string().min(1),
+      })
+      .strict()
+      .optional(),
+    selfRegistration: z
+      .object({
+        // No siteName: the site is derived from the single
+        // networks/<siteName>.network-meta.xml the app ships (see spec §5.2),
+        // exactly like the guestUser permset path.
+        selfRegProfile: z.string().min(1),
+        accountName: z.string().min(1),
+      })
+      .strict()
+      .optional(),
+  })
+  .strict();
+
+/**
+ * Render a single zod issue as a "path: message" line. Empty path (a root-level
+ * problem) renders as "<root>: message".
+ */
+function formatIssue(issue) {
+  const path = issue.path.length > 0 ? issue.path.join('.') : '<root>';
+  return `${path}: ${issue.message}`;
+}
+
+/**
+ * Parse + validate a raw org-setup.config.json string.
+ *
+ * @param {string} rawText  raw file contents (not yet JSON-parsed)
+ * @param {string} [configPath]  path used only for error messages
+ * @returns {{ ok: true, data: object } | { ok: false, errors: string[] }}
+ *   On success, `data` is the parsed + defaulted config. On failure, `errors`
+ *   is a non-empty list of human-readable messages (JSON parse error or zod
+ *   issues). The caller decides whether to print/exit.
+ */
+export function validateConfig(rawText, configPath) {
+  const where = configPath ? ` (${configPath})` : '';
+
+  let parsed;
+  try {
+    parsed = JSON.parse(rawText);
+  } catch (err) {
+    return { ok: false, errors: [`malformed JSON${where}: ${err.message}`] };
+  }
+
+  const result = ConfigSchema.safeParse(parsed);
+  if (!result.success) {
+    return { ok: false, errors: result.error.issues.map(formatIssue) };
+  }
+
+  return { ok: true, data: result.data };
+}