@salesforce/webapp-template-feature-micro-frontend 1.58.0 → 1.58.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -29,10 +29,10 @@ For a GraphQL operation named `GetHighRevenueAccounts`:
29
29
  ## Core Types & Function Signatures
30
30
 
31
31
  ### getDataSDK Function
32
- Available from `@salesforce/webapp-experimental/api`:
32
+ Available from `@salesforce/sdk-data`:
33
33
 
34
34
  ```typescript
35
- import { getDataSDK } from '@salesforce/webapp-experimental/api';
35
+ import { getDataSDK } from '@salesforce/sdk-data';
36
36
 
37
37
  const data = await getDataSDK();
38
38
  const response = await data.graphql?.<ResponseType, VariablesType>(query, variables);
@@ -89,10 +89,10 @@ const result = response?.data;
89
89
  For mutation-specific partial responses, see `docs/generate-mutation-query.md` which covers `PARTIAL` and `FAILED` status handling workflows.
90
90
 
91
91
  ### gql Template Tag
92
- Also available from `@salesforce/webapp-experimental/api` for inline query definitions:
92
+ Also available from `@salesforce/sdk-data` for inline query definitions:
93
93
 
94
94
  ```typescript
95
- import { gql } from '@salesforce/webapp-experimental/api';
95
+ import { gql } from '@salesforce/sdk-data';
96
96
 
97
97
  const MY_QUERY = gql`
98
98
  query MyQuery {
@@ -109,7 +109,7 @@ The `gql` tag is a template literal that allows defining GraphQL queries inline
109
109
  Extract the node type from a connection (edges/node pattern):
110
110
 
111
111
  ```typescript
112
- import { type NodeOfConnection } from '@salesforce/webapp-experimental/api';
112
+ import { type NodeOfConnection } from '@salesforce/sdk-data';
113
113
 
114
114
  // Extract Account node type from the query response
115
115
  type AccountNode = NodeOfConnection<
@@ -180,7 +180,7 @@ This generates types in `graphql-operations-types.ts`:
180
180
 
181
181
  #### Step 3: Import and Use
182
182
  ```typescript
183
- import { getDataSDK, type NodeOfConnection } from '@salesforce/webapp-experimental/api';
183
+ import { getDataSDK, type NodeOfConnection } from '@salesforce/sdk-data';
184
184
  import MY_QUERY from './query/myQuery.graphql?raw';
185
185
  import type {
186
186
  GetMyDataQuery,
@@ -232,7 +232,7 @@ export async function getMyData(
232
232
  For simpler queries without variables or when colocation is preferred:
233
233
 
234
234
  ```typescript
235
- import { getDataSDK, gql } from '@salesforce/webapp-experimental/api';
235
+ import { getDataSDK, gql } from '@salesforce/sdk-data';
236
236
  import { type CurrentUserQuery } from '../graphql-operations-types';
237
237
 
238
238
  const CURRENT_USER_QUERY = gql`
@@ -359,7 +359,7 @@ fragment ContactFields on Account {
359
359
 
360
360
  ### Usage
361
361
  ```typescript
362
- import { getDataSDK } from '@salesforce/webapp-experimental/api';
362
+ import { getDataSDK } from '@salesforce/sdk-data';
363
363
  import QUERY from './query/getAccountDetails.graphql?raw';
364
364
  import type {
365
365
  GetAccountDetailsQuery,
@@ -123,7 +123,7 @@ Before implementing data access, **MUST** verify `orchestrate_lds_data_requireme
123
123
 
124
124
  ## Data Access Rules (CRITICAL)
125
125
 
126
- - MANDATORY: Use the DataSDK (`getDataSDK()` from `@salesforce/webapp-experimental/api`) for all API calls from React. The SDK handles authentication and CSRF token management. Do NOT use `axios` or raw `fetch` for Salesforce API calls.
126
+ - MANDATORY: Use the DataSDK (`getDataSDK()` from `@salesforce/sdk-data`) for all API calls from React. The SDK handles authentication and CSRF token management. Do NOT use `axios` or raw `fetch` for Salesforce API calls.
127
127
 
128
128
  ### Data Access Workflow (MANDATORY)
129
129
 
@@ -161,7 +161,7 @@ The following code examples serve as reference patterns for React applications.
161
161
  GraphQL query example:
162
162
 
163
163
  ```typescript
164
- import { getDataSDK, gql } from '@salesforce/webapp-experimental/api';
164
+ import { getDataSDK, gql } from '@salesforce/sdk-data';
165
165
 
166
166
  const GET_ACCOUNT = gql`
167
167
  query GetAccount($id: ID!) {
@@ -195,7 +195,7 @@ const account = response?.data;
195
195
  GraphQL mutation example:
196
196
 
197
197
  ```typescript
198
- import { getDataSDK, gql } from '@salesforce/webapp-experimental/api';
198
+ import { getDataSDK, gql } from '@salesforce/sdk-data';
199
199
 
200
200
  const UPDATE_ACCOUNT = gql`
201
201
  mutation UpdateAccount($id: ID!, $name: String!) {
@@ -231,7 +231,7 @@ if (result?.errors?.length) {
231
231
  UI API example (using the SDK's fetch):
232
232
 
233
233
  ```typescript
234
- import { getDataSDK } from '@salesforce/webapp-experimental/api';
234
+ import { getDataSDK } from '@salesforce/sdk-data';
235
235
 
236
236
  async function fetchRecord(recordId: string) {
237
237
  const data = await getDataSDK();
@@ -257,7 +257,7 @@ Einstein LLM Gateway provides AI and generative capabilities for your React appl
257
257
  ### Einstein LLM Gateway Pattern
258
258
 
259
259
  ```typescript
260
- import { getDataSDK } from '@salesforce/webapp-experimental/api';
260
+ import { getDataSDK } from '@salesforce/sdk-data';
261
261
 
262
262
  async function callEinsteinGenerations({ prompt, model = 'gpt-4', signal }: {
263
263
  prompt: string;
@@ -136,10 +136,10 @@ interface Account extends SalesforceRecord {
136
136
  ```
137
137
 
138
138
  ### GraphQL via DataSDK
139
- Use `getDataSDK()` from `@salesforce/webapp-experimental/api` for all GraphQL operations. The SDK handles authentication and CSRF token management:
139
+ Use `getDataSDK()` from `@salesforce/sdk-data` for all GraphQL operations. The SDK handles authentication and CSRF token management:
140
140
 
141
141
  ```typescript
142
- import { getDataSDK } from '@salesforce/webapp-experimental/api';
142
+ import { getDataSDK } from '@salesforce/sdk-data';
143
143
 
144
144
  const data = await getDataSDK();
145
145
  const response = await data.graphql?.<GetAccountsQuery>(QUERY, variables);
package/dist/CHANGELOG.md CHANGED
@@ -3,6 +3,25 @@
3
3
  All notable changes to this project will be documented in this file.
4
4
  See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
5
5
 
6
+ ## [1.58.2](https://github.com/salesforce-experience-platform-emu/webapps/compare/v1.58.1...v1.58.2) (2026-02-26)
7
+
8
+
9
+ ### Bug Fixes
10
+
11
+ * moving all sdk usages from api to sdk-data @W-21338965 ([#173](https://github.com/salesforce-experience-platform-emu/webapps/issues/173)) ([23c9479](https://github.com/salesforce-experience-platform-emu/webapps/commit/23c94794e0c72e30d85313f908b52274e4a59979))
12
+
13
+
14
+
15
+
16
+
17
+ ## [1.58.1](https://github.com/salesforce-experience-platform-emu/webapps/compare/v1.58.0...v1.58.1) (2026-02-26)
18
+
19
+ **Note:** Version bump only for package @salesforce/webapp-template-base-sfdx-project-experimental
20
+
21
+
22
+
23
+
24
+
6
25
  # [1.58.0](https://github.com/salesforce-experience-platform-emu/webapps/compare/v1.57.0...v1.58.0) (2026-02-26)
7
26
 
8
27
  **Note:** Version bump only for package @salesforce/webapp-template-base-sfdx-project-experimental
package/dist/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@salesforce/webapp-template-base-sfdx-project-experimental",
3
- "version": "1.58.0",
3
+ "version": "1.58.2",
4
4
  "description": "Base SFDX project template",
5
5
  "private": true,
6
6
  "files": [
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@salesforce/webapp-template-feature-micro-frontend",
3
- "version": "1.58.0",
3
+ "version": "1.58.2",
4
4
  "description": "Micro Frontend generation feature for Web Applications",
5
5
  "license": "SEE LICENSE IN LICENSE.txt",
6
6
  "author": "",
@@ -18,8 +18,8 @@
18
18
  "clean": "rm -rf dist"
19
19
  },
20
20
  "devDependencies": {
21
- "@salesforce/micro-frontends-experimental": "^1.58.0",
22
- "@salesforce/webapp-experimental": "^1.58.0",
21
+ "@salesforce/micro-frontends-experimental": "^1.58.2",
22
+ "@salesforce/webapp-experimental": "^1.58.2",
23
23
  "@types/react": "^19.2.7",
24
24
  "@types/react-dom": "^19.2.3",
25
25
  "react-dom": "^19.2.1",
@@ -38,5 +38,5 @@
38
38
  }
39
39
  }
40
40
  },
41
- "gitHead": "444ed5b9e2ae4154064d316b06ce9a8be6831b0c"
41
+ "gitHead": "0dda7fdd05f5b8fd9870e57cc796663555166a90"
42
42
  }
@@ -1,116 +0,0 @@
1
- export type Maybe<T> = T | null;
2
- export type InputMaybe<T> = Maybe<T>;
3
- export type Exact<T extends { [key: string]: unknown }> = {
4
- [K in keyof T]: T[K];
5
- };
6
- export type MakeOptional<T, K extends keyof T> = Omit<T, K> & {
7
- [SubKey in K]?: Maybe<T[SubKey]>;
8
- };
9
- export type MakeMaybe<T, K extends keyof T> = Omit<T, K> & {
10
- [SubKey in K]: Maybe<T[SubKey]>;
11
- };
12
- export type MakeEmpty<
13
- T extends { [key: string]: unknown },
14
- K extends keyof T,
15
- > = { [_ in K]?: never };
16
- export type Incremental<T> =
17
- | T
18
- | {
19
- [P in keyof T]?: P extends ' $fragmentName' | '__typename' ? T[P] : never;
20
- };
21
- /** All built-in and custom scalars, mapped to their actual values */
22
- export type Scalars = {
23
- ID: { input: string; output: string };
24
- String: { input: string; output: string };
25
- Boolean: { input: boolean; output: boolean };
26
- Int: { input: number; output: number };
27
- Float: { input: number; output: number };
28
- Base64: { input: string; output: string };
29
- Currency: { input: number | string; output: number };
30
- Date: { input: string; output: string };
31
- DateTime: { input: string; output: string };
32
- Double: { input: number | string; output: number };
33
- Email: { input: string; output: string };
34
- EncryptedString: { input: string; output: string };
35
- /** Can be set to an ID or a Reference to the result of another mutation operation. */
36
- IdOrRef: { input: string; output: string };
37
- Latitude: { input: number | string; output: number };
38
- /** A 64-bit signed integer */
39
- Long: { input: number; output: number };
40
- LongTextArea: { input: string; output: string };
41
- Longitude: { input: number | string; output: number };
42
- MultiPicklist: { input: string; output: string };
43
- Percent: { input: number | string; output: number };
44
- PhoneNumber: { input: string; output: string };
45
- Picklist: { input: string; output: string };
46
- RichTextArea: { input: string; output: string };
47
- TextArea: { input: string; output: string };
48
- Time: { input: string; output: string };
49
- Url: { input: string; output: string };
50
- };
51
-
52
- export enum DataType {
53
- Address = 'ADDRESS',
54
- Anytype = 'ANYTYPE',
55
- Base64 = 'BASE64',
56
- Boolean = 'BOOLEAN',
57
- Combobox = 'COMBOBOX',
58
- Complexvalue = 'COMPLEXVALUE',
59
- Currency = 'CURRENCY',
60
- Date = 'DATE',
61
- Datetime = 'DATETIME',
62
- Double = 'DOUBLE',
63
- Email = 'EMAIL',
64
- Encryptedstring = 'ENCRYPTEDSTRING',
65
- Int = 'INT',
66
- Json = 'JSON',
67
- Junctionidlist = 'JUNCTIONIDLIST',
68
- Location = 'LOCATION',
69
- Long = 'LONG',
70
- Multipicklist = 'MULTIPICKLIST',
71
- Percent = 'PERCENT',
72
- Phone = 'PHONE',
73
- Picklist = 'PICKLIST',
74
- Reference = 'REFERENCE',
75
- String = 'STRING',
76
- Textarea = 'TEXTAREA',
77
- Time = 'TIME',
78
- Url = 'URL',
79
- }
80
-
81
- export enum FieldExtraTypeInfo {
82
- ExternalLookup = 'EXTERNAL_LOOKUP',
83
- ImageUrl = 'IMAGE_URL',
84
- IndirectLookup = 'INDIRECT_LOOKUP',
85
- Personname = 'PERSONNAME',
86
- Plaintextarea = 'PLAINTEXTAREA',
87
- Richtextarea = 'RICHTEXTAREA',
88
- SwitchablePersonname = 'SWITCHABLE_PERSONNAME',
89
- }
90
-
91
- export enum ResultOrder {
92
- Asc = 'ASC',
93
- Desc = 'DESC',
94
- }
95
-
96
- export type GetHighRevenueAccountsQueryVariables = Exact<{
97
- minRevenue?: InputMaybe<Scalars['Currency']['input']>;
98
- }>;
99
-
100
- export type GetHighRevenueAccountsQuery = {
101
- uiapi: {
102
- query: {
103
- Account?: {
104
- edges?: Array<{
105
- node?: {
106
- Id: string;
107
- Name?: { value?: string | null } | null;
108
- AnnualRevenue?: { value?: number | null } | null;
109
- Industry?: { value?: string | null } | null;
110
- Website?: { value?: string | null } | null;
111
- } | null;
112
- } | null> | null;
113
- } | null;
114
- };
115
- };
116
- };
@@ -1,41 +0,0 @@
1
- import { getDataSDK } from '@salesforce/webapp-experimental/api';
2
- import HIGH_REVENUE_ACCOUNTS_QUERY from './query/highRevenueAccountsQuery.graphql?raw';
3
- import type {
4
- GetHighRevenueAccountsQuery,
5
- GetHighRevenueAccountsQueryVariables,
6
- } from '../graphql-operations-types';
7
-
8
- type AccountNode = NonNullable<
9
- NonNullable<
10
- NonNullable<
11
- NonNullable<
12
- GetHighRevenueAccountsQuery['uiapi']['query']['Account']
13
- >['edges']
14
- >[number]
15
- >['node']
16
- >;
17
-
18
- /**
19
- * Fetch accounts with annual revenue greater than the specified amount
20
- *
21
- * @param minRevenue - Minimum annual revenue threshold (default: 100000)
22
- * @returns Array of accounts matching the criteria
23
- */
24
- export async function getHighRevenueAccounts(
25
- variables: GetHighRevenueAccountsQueryVariables
26
- ): Promise<(AccountNode | null | undefined)[]> {
27
- const data = await getDataSDK();
28
- const response = await data.graphql?.<
29
- GetHighRevenueAccountsQuery,
30
- GetHighRevenueAccountsQueryVariables
31
- >(HIGH_REVENUE_ACCOUNTS_QUERY, variables);
32
-
33
- if (response?.errors?.length) {
34
- const errorMessages = response.errors.map(e => e.message).join('; ');
35
- throw new Error(`GraphQL Error: ${errorMessages}`);
36
- }
37
-
38
- return (
39
- response?.data?.uiapi?.query?.Account?.edges?.map(edge => edge?.node) || []
40
- );
41
- }
@@ -1,29 +0,0 @@
1
- query GetHighRevenueAccounts($minRevenue: Currency) {
2
- uiapi {
3
- query {
4
- Account(
5
- where: { AnnualRevenue: { gt: $minRevenue } }
6
- orderBy: { AnnualRevenue: { order: DESC } }
7
- first: 50
8
- ) {
9
- edges {
10
- node {
11
- Id
12
- Name {
13
- value
14
- }
15
- AnnualRevenue {
16
- value
17
- }
18
- Industry {
19
- value
20
- }
21
- Website {
22
- value
23
- }
24
- }
25
- }
26
- }
27
- }
28
- }
29
- }