@salesforce/webapp-experimental 1.53.2 → 1.54.1

package/dist/api/clients.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clients.d.ts","sourceRoot":"","sources":["../../src/api/clients.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiBH,eAAO,MAAM,WAAW,QAA0E,CAAC;AAQnG,cAAM,SAAS;IACd,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAK7B;gBAEU,OAAO,EAAE,MAAM;IAI3B,OAAO,CAAC,iBAAiB;YASX,KAAK;IAgBnB,OAAO,CAAC,WAAW;IAgBb,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQ/E,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI9D,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQ9E,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQhF,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;CAGvE;AAGD,eAAO,MAAM,WAAW,WAA4B,CAAC"}
+{"version":3,"file":"clients.d.ts","sourceRoot":"","sources":["../../src/api/clients.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,eAAO,MAAM,WAAW,QAA0E,CAAC;AAQnG,cAAM,SAAS;IACd,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAK7B;gBAEU,OAAO,EAAE,MAAM;IAI3B,OAAO,CAAC,iBAAiB;YASX,KAAK;IAgBnB,OAAO,CAAC,WAAW;IAgBb,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQ/E,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAI9D,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQ9E,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQhF,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;CAGvE;AAGD,eAAO,MAAM,WAAW,WAA4B,CAAC"}

package/dist/api/clients.js

@@ -3,15 +3,7 @@
  * All rights reserved.
  * For full license text, see the LICENSE.txt file
  */
-import { createDataSDK } from "@salesforce/sdk-data";
-// Lazy-initialized SDK instance
-let sdkInstance = null;
-async function getSDK() {
-    if (!sdkInstance) {
-        sdkInstance = await createDataSDK();
-    }
-    return sdkInstance;
-}
+import { getDataSDK } from "./graphql.js";
 // Project standard API version from environment variable with fallback
 export const API_VERSION = typeof __SF_API_VERSION__ !== "undefined" ? __SF_API_VERSION__ : "65.0";
 const BASE_DATA_URL = `/services/data/v${API_VERSION}`;
@@ -47,7 +39,7 @@ class ApiClient {
                 ...(options.headers || {}),
             },
         };
-        const sdk = await getSDK();
+        const sdk = await getDataSDK();
         return await sdk.fetch(fullURL, mergedOptions);
     }
     processBody(body, options) {

package/dist/api/graphql.d.ts

@@ -3,18 +3,17 @@
  * All rights reserved.
  * For full license text, see the LICENSE.txt file
  */
+import { type DataSDK } from "@salesforce/sdk-data";
+/**
+ * Get a lazily-initialized DataSDK singleton.
+ *
+ * @returns The shared DataSDK instance
+ */
+export declare function getDataSDK(): Promise<DataSDK>;
 export type NodeOfConnection<T> = T extends {
     edges?: (infer E)[] | null;
 } | null ? E extends {
     node?: infer N;
 } | null ? N : never : never;
-/**
- * Execute a GraphQL query against the Salesforce GraphQL API
- *
- * @param query - The GraphQL query string
- * @param variables - Optional variables for the query
- * @returns The GraphQL response data
- */
-export declare function executeGraphQL<T, InputVariables = Record<string, unknown>>(query: string, variables?: InputVariables): Promise<T>;
 export { gql } from "@salesforce/sdk-data";
 //# sourceMappingURL=graphql.d.ts.map

package/dist/api/graphql.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graphql.d.ts","sourceRoot":"","sources":["../../src/api/graphql.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,CAAC,SAAS;IAC3C,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC;CAC3B,GAAG,IAAI,GACL,CAAC,SAAS;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,IAAI,GAClC,CAAC,GACD,KAAK,GACN,KAAK,CAAC;AAET;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/E,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,CAAC,CAAC,CAUZ;AACD,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"graphql.d.ts","sourceRoot":"","sources":["../../src/api/graphql.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAInE;;;;GAIG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAKnD;AAED,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,CAAC,SAAS;IAC3C,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC;CAC3B,GAAG,IAAI,GACL,CAAC,SAAS;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,IAAI,GAClC,CAAC,GACD,KAAK,GACN,KAAK,CAAC;AAET,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/api/graphql.js

@@ -4,28 +4,16 @@
  * For full license text, see the LICENSE.txt file
  */
 import { createDataSDK } from "@salesforce/sdk-data";
-// Lazy-initialized SDK instance
 let sdkInstance = null;
-async function getSDK() {
-    if (!sdkInstance) {
-        sdkInstance = await createDataSDK();
-    }
-    return sdkInstance;
-}
 /**
- * Execute a GraphQL query against the Salesforce GraphQL API
+ * Get a lazily-initialized DataSDK singleton.
  *
- * @param query - The GraphQL query string
- * @param variables - Optional variables for the query
- * @returns The GraphQL response data
+ * @returns The shared DataSDK instance
  */
-export async function executeGraphQL(query, variables) {
-    const sdk = await getSDK();
-    const { data, errors } = await sdk.graphql(query, variables);
-    if (errors?.length) {
-        const errorMessages = errors.map((e) => e.message).join("; ");
-        throw new Error(`GraphQL Error: ${errorMessages}`);
+export async function getDataSDK() {
+    if (!sdkInstance) {
+        sdkInstance = await createDataSDK();
     }
-    return data;
+    return sdkInstance;
 }
 export { gql } from "@salesforce/sdk-data";

package/dist/api/graphql.test.js

@@ -4,60 +4,27 @@
  * For full license text, see the LICENSE.txt file
  */
 import { describe, it, expect, vi, beforeEach } from "vitest";
-import { executeGraphQL } from "./graphql.js";
+import { getDataSDK } from "./graphql.js";
 const mockGraphQLFn = vi.fn();
+const mockFetchFn = vi.fn();
 vi.mock("@salesforce/sdk-data", () => ({
     createDataSDK: vi.fn(() => Promise.resolve({
         graphql: mockGraphQLFn,
+        fetch: mockFetchFn,
     })),
 }));
-describe("executeGraphQL", () => {
+describe("getDataSDK", () => {
     beforeEach(() => {
         vi.clearAllMocks();
     });
-    it("should successfully execute a GraphQL query", async () => {
-        const mockData = {
-            uiapi: {
-                query: {
-                    Account: {
-                        edges: [
-                            {
-                                node: {
-                                    Id: "001",
-                                    Name: { value: "Test Account" },
-                                },
-                            },
-                        ],
-                    },
-                },
-            },
-        };
-        mockGraphQLFn.mockResolvedValue({ data: mockData });
-        const query = "query { uiapi { query { Account { edges { node { Id Name { value } } } } } } }";
-        const result = await executeGraphQL(query);
-        expect(mockGraphQLFn).toHaveBeenCalledWith(query, undefined);
-        expect(result).toEqual(mockData);
+    it("should return a DataSDK instance", async () => {
+        const sdk = await getDataSDK();
+        expect(sdk).toBeDefined();
+        expect(sdk.graphql).toBeDefined();
     });
-    it("should handle GraphQL errors", async () => {
-        const mockErrors = [{ message: "Field not found" }, { message: "Invalid query" }];
-        mockGraphQLFn.mockResolvedValue({ errors: mockErrors });
-        const query = "query { invalid }";
-        await expect(executeGraphQL(query)).rejects.toThrow("GraphQL Error: Field not found; Invalid query");
-    });
-    it("should handle network errors", async () => {
-        mockGraphQLFn.mockRejectedValue({
-            status: 500,
-            message: "Network error",
-        });
-        const query = "query { test }";
-        await expect(executeGraphQL(query)).rejects.toThrow("Network error");
-    });
-    it("should pass variables to the GraphQL query", async () => {
-        const mockData = { test: "data" };
-        mockGraphQLFn.mockResolvedValue({ data: mockData });
-        const query = "query GetAccount($id: ID!) { account(id: $id) { name } }";
-        const variables = { id: "001" };
-        await executeGraphQL(query, variables);
-        expect(mockGraphQLFn).toHaveBeenCalledWith(query, variables);
+    it("should return the same instance on subsequent calls", async () => {
+        const sdk1 = await getDataSDK();
+        const sdk2 = await getDataSDK();
+        expect(sdk1).toBe(sdk2);
     });
 });

package/dist/api/index.d.ts

@@ -4,7 +4,7 @@
  * For full license text, see the LICENSE.txt file
  */
 export { uiApiClient } from "./clients.js";
-export { executeGraphQL } from "./graphql.js";
+export { getDataSDK } from "./graphql.js";
 export { getHighRevenueAccounts, type Account } from "./utils/accounts.js";
 export { getRecord, createRecord, updateRecord, deleteRecord } from "./utils/records.js";
 export { getCurrentUser } from "./utils/user.js";

package/dist/api/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9C,OAAO,EAAE,sBAAsB,EAAE,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE3E,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEzF,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,OAAO,EAAE,sBAAsB,EAAE,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE3E,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEzF,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/api/index.js

@@ -5,8 +5,8 @@
  */
 // Core clients
 export { uiApiClient } from "./clients.js";
-// GraphQL
-export { executeGraphQL } from "./graphql.js";
+// Data SDK
+export { getDataSDK } from "./graphql.js";
 // Utility functions
 export { getHighRevenueAccounts } from "./utils/accounts.js";
 export { getRecord, createRecord, updateRecord, deleteRecord } from "./utils/records.js";

package/dist/api/utils/accounts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"accounts.d.ts","sourceRoot":"","sources":["../../../src/api/utils/accounts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH,qDAAqD;AAErD,MAAM,MAAM,+BAA+B,GAAG;IAC7C,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF,qDAAqD;AACrD,MAAM,WAAW,OAAO;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IACxC,aAAa,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IACjD,QAAQ,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5C,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;CAC3C;AA6CD;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC3C,SAAS,EAAE,+BAA+B,GACxC,OAAO,CAAC,CAAC,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,CAAC,CAOzC"}
+{"version":3,"file":"accounts.d.ts","sourceRoot":"","sources":["../../../src/api/utils/accounts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH,qDAAqD;AAErD,MAAM,MAAM,+BAA+B,GAAG;IAC7C,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF,qDAAqD;AACrD,MAAM,WAAW,OAAO;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IACxC,aAAa,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IACjD,QAAQ,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5C,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;CAC3C;AA6CD;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC3C,SAAS,EAAE,+BAA+B,GACxC,OAAO,CAAC,CAAC,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,CAAC,CAazC"}

package/dist/api/utils/accounts.js

@@ -9,10 +9,10 @@
  * Use this pattern when implementing new data fetching utilities:
  * 1. Define TypeScript interfaces for the response shape
  * 2. Write the GraphQL query using UIAPI syntax
- * 3. Use executeGraphQL<T>() with proper typing
+ * 3. Use getDataSDK() then data.graphql?.() with proper typing
  * 4. Extract and return the relevant data from the response
  */
-import { executeGraphQL } from "../graphql.js";
+import { getDataSDK } from "../graphql.js";
 const HIGH_REVENUE_ACCOUNTS_QUERY = /* GraphQL */ `
 	query GetHighRevenueAccounts($minRevenue: Currency) {
 		uiapi {
@@ -51,6 +51,11 @@ const HIGH_REVENUE_ACCOUNTS_QUERY = /* GraphQL */ `
  * @returns Array of accounts matching the criteria
  */
 export async function getHighRevenueAccounts(variables) {
-    const response = await executeGraphQL(HIGH_REVENUE_ACCOUNTS_QUERY, variables);
-    return response.uiapi?.query?.Account?.edges?.map((edge) => edge?.node) || [];
+    const data = await getDataSDK();
+    const response = await data.graphql?.(HIGH_REVENUE_ACCOUNTS_QUERY, variables);
+    if (response?.errors?.length) {
+        const errorMessages = response.errors.map((e) => e.message).join("; ");
+        throw new Error(`GraphQL Error: ${errorMessages}`);
+    }
+    return response?.data?.uiapi?.query?.Account?.edges?.map((edge) => edge?.node) || [];
 }

package/dist/api/utils/user.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../../src/api/utils/user.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,UAAU,IAAI;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACb;AAmBD;;;;GAIG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAuB3D"}
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../../src/api/utils/user.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,UAAU,IAAI;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACb;AASD;;;;GAIG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAuB3D"}

package/dist/api/utils/user.js

@@ -3,16 +3,8 @@
  * All rights reserved.
  * For full license text, see the LICENSE.txt file
  */
-import { createDataSDK } from "@salesforce/sdk-data";
 import { API_VERSION } from "../clients.js";
-// Lazy-initialized SDK instance
-let sdkInstance = null;
-async function getSDK() {
-    if (!sdkInstance) {
-        sdkInstance = await createDataSDK();
-    }
-    return sdkInstance;
-}
+import { getDataSDK } from "../graphql.js";
 /**
  * Fetch current user information from Salesforce
  * Uses Chatter API to get current user details
@@ -20,7 +12,7 @@ async function getSDK() {
  */
 export async function getCurrentUser() {
     try {
-        const sdk = await getSDK();
+        const sdk = await getDataSDK();
         const response = await sdk.fetch(`/services/data/v${API_VERSION}/chatter/users/me`);
         if (!response.ok) {
             throw new Error(`HTTP ${response.status}`);

package/dist/api/utils/user.test.js

@@ -3,14 +3,14 @@
  * All rights reserved.
  * For full license text, see the LICENSE.txt file
  */
-import { createDataSDK } from "@salesforce/sdk-data";
 import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
 import { getCurrentUser } from "./user.js";
+const mockFetch = vi.fn();
 vi.mock("@salesforce/sdk-data", () => ({
-    createDataSDK: vi.fn(),
+    createDataSDK: vi.fn(() => Promise.resolve({
+        fetch: mockFetch,
+    })),
 }));
-const mockFetch = vi.fn();
-const mockSDK = { fetch: mockFetch };
 // Mock console.error to avoid noise in test output
 const mockConsoleError = vi.spyOn(console, "error").mockImplementation(() => {
     /* noop */
@@ -18,7 +18,6 @@ const mockConsoleError = vi.spyOn(console, "error").mockImplementation(() => {
 describe("User API Utils", () => {
     beforeEach(() => {
         vi.clearAllMocks();
-        vi.mocked(createDataSDK).mockResolvedValue(mockSDK);
     });
     afterEach(() => {
         mockConsoleError.mockClear();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@salesforce/webapp-experimental",
   "description": "[experimental] Core package for Salesforce Web Applications",
-  "version": "1.53.2",
+  "version": "1.54.1",
   "license": "SEE LICENSE IN LICENSE.txt",
   "type": "module",
   "main": "./dist/index.js",
@@ -45,7 +45,7 @@
   },
   "dependencies": {
     "@salesforce/core": "^8.23.4",
-    "@salesforce/sdk-data": "^1.53.2",
+    "@salesforce/sdk-data": "^1.54.1",
     "axios": "^1.7.7",
     "micromatch": "^4.0.8",
     "path-to-regexp": "^8.3.0"
@@ -61,5 +61,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "8866eb09bf1e24f023333d1ecc491a1e1a6c8904"
+  "gitHead": "6defeb0540e40000b92f0c88fc822cf8de1758b9"
 }