@salesforce/webapp-template-feature-graphql-experimental 1.58.1 → 1.58.2

package/README.md

@@ -74,7 +74,7 @@ cp rules/graphql-data-access-rule.md ~/.clinerules/
 
 The base React app includes reference examples:
 
-- `src/api/graphql.ts` — Core `getDataSDK()` singleton and GraphQL utilities
+- `@salesforce/sdk-data` — Core `getDataSDK()`, `gql`, and `NodeOfConnection`
 - `src/api/utils/accounts.ts` — Pattern 1 (external `.graphql` file + codegen types)
 - `src/api/utils/user.ts` — Pattern 2 (inline `gql` tag)
 - `src/components/AccountsTable.tsx` — Component using GraphQL to fetch and render Accounts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/webapp-template-feature-graphql-experimental",
-  "version": "1.58.1",
+  "version": "1.58.2",
   "description": "GraphQL documentation, agent skills, and rules for Salesforce web applications",
   "license": "SEE LICENSE IN LICENSE.txt",
   "author": "",
@@ -16,5 +16,5 @@
   "scripts": {
     "clean": "echo 'No build artifacts to clean'"
   },
-  "gitHead": "3ca21b4efdb09c459fac018f54284b3637fc02e7"
+  "gitHead": "0dda7fdd05f5b8fd9870e57cc796663555166a90"
 }

package/rules/graphql-data-access-rule.md

@@ -36,10 +36,10 @@ For a GraphQL operation named `GetHighRevenueAccounts`:
 
 ### getDataSDK Function
 
-Available from `@salesforce/webapp-experimental/api`:
+Available from `@salesforce/sdk-data`:
 
 ```typescript
-import { getDataSDK } from "@salesforce/webapp-experimental/api";
+import { getDataSDK } from "@salesforce/sdk-data";
 
 const data = await getDataSDK();
 const response = await data.graphql?.<ResponseType, VariablesType>(query, variables);
@@ -49,10 +49,10 @@ const response = await data.graphql?.<ResponseType, VariablesType>(query, variab
 
 ### gql Template Tag
 
-Also available from `@salesforce/webapp-experimental/api` for inline query definitions:
+Also available from `@salesforce/sdk-data` for inline query definitions:
 
 ```typescript
-import { gql } from "@salesforce/webapp-experimental/api";
+import { gql } from "@salesforce/sdk-data";
 
 const MY_QUERY = gql`
   query MyQuery {
@@ -120,7 +120,7 @@ For mutation-specific partial responses, see `docs/generate-mutation-query.md` w
 Extract the node type from a connection (edges/node pattern):
 
 ```typescript
-import { type NodeOfConnection } from "@salesforce/webapp-experimental/api";
+import { type NodeOfConnection } from "@salesforce/sdk-data";
 
 // Extract Account node type from the query response
 type AccountNode = NodeOfConnection<GetHighRevenueAccountsQuery["uiapi"]["query"]["Account"]>;
@@ -196,7 +196,7 @@ This generates types in `graphql-operations-types.ts`:
 #### Step 3: Import and Use
 
 ```typescript
-import { getDataSDK, type NodeOfConnection } from "@salesforce/webapp-experimental/api";
+import { getDataSDK, type NodeOfConnection } from "@salesforce/sdk-data";
 import MY_QUERY from "./query/myQuery.graphql?raw";
 import type { GetMyDataQuery, GetMyDataQueryVariables } from "../graphql-operations-types";
 
@@ -249,7 +249,7 @@ export async function getMyData(variables: GetMyDataQueryVariables): Promise<MyN
 For simpler queries without variables or when colocation is preferred:
 
 ```typescript
-import { getDataSDK, gql } from "@salesforce/webapp-experimental/api";
+import { getDataSDK, gql } from "@salesforce/sdk-data";
 import { type CurrentUserQuery } from "../graphql-operations-types";
 
 const CURRENT_USER_QUERY = gql`
@@ -369,7 +369,7 @@ fragment ContactFields on Account {
 ### Usage
 
 ```typescript
-import { getDataSDK } from "@salesforce/webapp-experimental/api";
+import { getDataSDK } from "@salesforce/sdk-data";
 import QUERY from "./query/getAccountDetails.graphql?raw";
 import type {
   GetAccountDetailsQuery,

package/skills/graphql-data-access/SKILL.md

@@ -25,7 +25,7 @@ The base React app (`base-react-app`) ships with all GraphQL dependencies and to
 
 Before using this skill, ensure:
 
-1. The `@salesforce/webapp-experimental/api` package is available (provides `getDataSDK`, `gql`, `NodeOfConnection`)
+1. The `@salesforce/sdk-data` package is available (provides `getDataSDK`, `gql`, `NodeOfConnection`)
 2. A `schema.graphql` file exists at the project root. If missing, generate it:
    ```bash
    npm run graphql:schema
@@ -96,7 +96,7 @@ This updates `src/api/graphql-operations-types.ts` with:
 
 ```typescript
 // Pattern 1
-import { getDataSDK, type NodeOfConnection } from "@salesforce/webapp-experimental/api";
+import { getDataSDK, type NodeOfConnection } from "@salesforce/sdk-data";
 import MY_QUERY from "./query/myQuery.graphql?raw";
 import type { GetMyDataQuery, GetMyDataQueryVariables } from "../graphql-operations-types";
 
@@ -120,7 +120,7 @@ export async function getMyData(variables: GetMyDataQueryVariables): Promise<MyN
 
 ```typescript
 // Pattern 2
-import { getDataSDK, gql } from "@salesforce/webapp-experimental/api";
+import { getDataSDK, gql } from "@salesforce/sdk-data";
 import type { MySimpleQuery } from "../graphql-operations-types";
 
 const MY_QUERY = gql`