@salesforce/sdk-data 1.21.0 → 1.29.1

package/dist/index.d.ts

@@ -1,5 +1,10 @@
 import type { DataSDK } from "@salesforce/sdk-core";
-export declare const sdk: DataSDK;
+/**
+ * Create and initialize a DataSDK instance based on the detected surface
+ *
+ * @returns Promise resolving to an initialized DataSDK instance
+ */
+export declare function createDataSDK(): Promise<DataSDK>;
 export { gql } from "./gql.js";
-export type { DataSDK } from "@salesforce/sdk-core";
+export type { DataSDK, LabelRequest, ResourceUrlRequest, SchemaDescriptor, SchemaRequest, UserInfo, } from "@salesforce/sdk-core";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAiBpD,eAAO,MAAM,GAAG,SAAe,CAAC;AAChC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,YAAY,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAGpD;;;;GAIG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAetD;AAED,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,YAAY,EACX,OAAO,EACP,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,QAAQ,GACR,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -4,19 +4,26 @@
  * For full license text, see the LICENSE.txt file
  */
 import { getSurface, Surface } from "@salesforce/sdk-core";
-import { OpenAIDataSDK } from "./openai/index.js";
 import { WebAppDataSDK } from "./webapp/index.js";
-function initialize() {
+/**
+ * Create and initialize a DataSDK instance based on the detected surface
+ *
+ * @returns Promise resolving to an initialized DataSDK instance
+ */
+export async function createDataSDK() {
     const surface = getSurface();
     switch (surface) {
         case Surface.OpenAI:
-            return new OpenAIDataSDK();
-        case Surface.Webapp:
+            return {};
+        case Surface.WebApp:
         case Surface.MicroFrontend:
             return new WebAppDataSDK();
+        case Surface.SalesforceACC:
+            return {};
+        case Surface.MCPApps:
+            return {};
         default:
             return {};
     }
 }
-export const sdk = initialize();
 export { gql } from "./gql.js";

package/dist/webapp/index.d.ts

@@ -1,9 +1,5 @@
-/**
- * Copyright (c) 2026, Salesforce, Inc.,
- * All rights reserved.
- * For full license text, see the LICENSE.txt file
- */
 import type { DataSDK, GraphQLResponse } from "@salesforce/sdk-core";
+export declare const API_VERSION: string;
 /**
  * Data SDK implementation for web apps, which is based on making `fetch` calls to REST endpoints
  */

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/webapp/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGrE;;GAEG;AACH,qBAAa,aAAc,YAAW,OAAO;IACtC,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAK9E,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;CAG3E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/webapp/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAQrE,eAAO,MAAM,WAAW,QAA+B,CAAC;AAexD;;GAEG;AACH,qBAAa,aAAc,YAAW,OAAO;IACtC,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAaxE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;CAgBjF"}

package/dist/webapp/index.js

@@ -1,13 +1,78 @@
-import { baseDataClient, conduitClient } from "./clients.js";
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+import { ConduitClient } from "@conduit-client/salesforce-lightning-service-worker";
+const CACHE_VERSION = 1;
+const CACHE_NAME = `@salesforce/sdk-data_v${CACHE_VERSION}`;
+export const API_VERSION = __SF_API_VERSION__ || "65.0";
+const BASE = __SF_SERVER_BASE_PATH__ || "";
+const PATH_DATA = `/services/data/v${API_VERSION}`;
+const PATH_UIAPI = `${PATH_DATA}/ui-api`;
+ConduitClient.initialize({
+    csrf: {
+        endpoint: `${BASE}${PATH_UIAPI}/session/csrf`,
+        cacheName: CACHE_NAME,
+        protectedUrls: ["/services/data/v"],
+    },
+});
+const conduitClient = ConduitClient.instance();
 /**
  * Data SDK implementation for web apps, which is based on making `fetch` calls to REST endpoints
  */
 export class WebAppDataSDK {
     async graphql(query, variables) {
-        const res = await baseDataClient.post("/graphql", { query, variables });
+        const res = await this.fetch(`${PATH_DATA}/graphql`, {
+            method: "POST",
+            body: JSON.stringify({ query, variables }),
+            headers: {
+                "Content-Type": "application/json",
+                Accept: "application/json",
+            },
+        });
         return res.json();
     }
-    fetch(input, init) {
-        return conduitClient.fetch(input, init);
+    async fetch(input, init) {
+        const updatedInput = applySalesforceBase(input);
+        const response = await conduitClient.fetch(updatedInput, init);
+        // NOTE: In dev mode the server proxy owns authentication (adding, refreshing, etc., as needed).  If it
+        // fails to do so properly then the result will be a reload infinite loop. As for deployed mode, reload
+        // triggers the standard Salesforce authentication checks/flow.
+        if (response.status === 401 || response.status === 403) {
+            if (import.meta.env.PROD) {
+                window.location.reload();
+            }
+        }
+        return response;
+    }
+}
+/**
+ * If the url is relative, convert to it to an absolute Salesforce URL.  This is due to the way Code
+ * Builder deployments structure the url for Salesforce
+ *
+ * @param input
+ */
+function applySalesforceBase(input) {
+    // Handle string input
+    if (typeof input === "string") {
+        if (input.startsWith("http")) {
+            // already absolute, return as-is
+            return input;
+        }
+        // make absolute
+        return BASE + input;
+    }
+    // Handle Request input
+    if (input instanceof Request) {
+        const url = input.url;
+        if (url.startsWith("http")) {
+            // already absolute, return as-is
+            return input;
+        }
+        // make absolute
+        return new Request(BASE + url, input);
     }
+    // URLs require a protocol and domain, thus are already absolute
+    return input;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/sdk-data",
-  "version": "1.21.0",
+  "version": "1.29.1",
   "license": "SEE LICENSE IN LICENSE.txt",
   "type": "module",
   "main": "./dist/index.js",
@@ -27,7 +27,7 @@
   },
   "dependencies": {
     "@conduit-client/salesforce-lightning-service-worker": "^3.7.0",
-    "@salesforce/sdk-core": "^1.21.0"
+    "@salesforce/sdk-core": "^1.29.1"
   },
   "devDependencies": {
     "vitest": "^4.0.6"
@@ -35,5 +35,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "8a7b85936ce26a4200ee052fb09f981e738bdb89"
+  "gitHead": "a9638ee25f6b90f08f032bb06fabc218a3b0ebd4"
 }

package/dist/openai/index.d.ts

@@ -1,12 +0,0 @@
-/**
- * Copyright (c) 2026, Salesforce, Inc.,
- * All rights reserved.
- * For full license text, see the LICENSE.txt file
- */
-import type { DataSDK } from "@salesforce/sdk-core";
-/**
- * Data SDK implementation based on the existence of `window.openai`
- */
-export declare class OpenAIDataSDK implements DataSDK {
-}
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/openai/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD;;GAEG;AACH,qBAAa,aAAc,YAAW,OAAO;CAAG"}

package/dist/openai/index.js

@@ -1,5 +0,0 @@
-/**
- * Data SDK implementation based on the existence of `window.openai`
- */
-export class OpenAIDataSDK {
-}

package/dist/webapp/__tests__/clients.test.d.ts

@@ -1,7 +0,0 @@
-/**
- * Copyright (c) 2026, Salesforce, Inc.,
- * All rights reserved.
- * For full license text, see the LICENSE.txt file
- */
-export {};
-//# sourceMappingURL=clients.test.d.ts.map

package/dist/webapp/__tests__/clients.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"clients.test.d.ts","sourceRoot":"","sources":["../../../src/webapp/__tests__/clients.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/webapp/__tests__/clients.test.js

@@ -1,154 +0,0 @@
-/**
- * Copyright (c) 2026, Salesforce, Inc.,
- * All rights reserved.
- * For full license text, see the LICENSE.txt file
- */
-import { ConduitClient } from "@conduit-client/salesforce-lightning-service-worker";
-import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
-import { baseDataClient } from "../clients.js";
-vi.mock("@conduit-client/salesforce-lightning-service-worker", () => {
-    return {
-        ConduitClient: {
-            initialize: vi.fn(),
-            instance: vi.fn().mockReturnValue({ fetch: vi.fn() }),
-        },
-    };
-});
-// Mock window.location.reload
-const mockReload = vi.fn();
-vi.stubGlobal("window", {
-    location: { reload: mockReload },
-});
-describe("clients", () => {
-    let mockFetch;
-    beforeEach(() => {
-        const mockClient = vi.mocked(ConduitClient.instance());
-        mockFetch = mockClient.fetch;
-        mockFetch.mockClear();
-        mockReload.mockClear();
-    });
-    afterEach(() => {
-        vi.clearAllMocks();
-    });
-    it("should have configured ConduitClient", () => {
-        expect(ConduitClient.initialize).toHaveBeenCalledWith({
-            csrf: {
-                endpoint: "/services/data/v99.0/ui-api/session/csrf",
-                cacheName: "vibe-coding-starter-1",
-                protectedUrls: ["/services/data/v", "/lwr/apex/v"],
-            },
-        });
-    });
-    describe("HTTP methods", () => {
-        beforeEach(() => {
-            mockFetch.mockResolvedValue({
-                status: 200,
-                json: () => Promise.resolve({ success: true }),
-            });
-        });
-        it("should make GET requests", async () => {
-            await baseDataClient.get("/users");
-            expect(mockFetch).toHaveBeenCalledWith("/services/data/v99.0/users", {
-                method: "GET",
-                headers: {
-                    "Content-Type": "application/json",
-                    Accept: "application/json",
-                },
-            });
-        });
-        it("should make POST requests with JSON body", async () => {
-            const data = { name: "John" };
-            await baseDataClient.post("/users", data);
-            expect(mockFetch).toHaveBeenCalledWith("/services/data/v99.0/users", {
-                method: "POST",
-                body: JSON.stringify(data),
-                headers: {
-                    "Content-Type": "application/json",
-                    Accept: "application/json",
-                },
-            });
-        });
-        it("should make PUT requests with JSON body", async () => {
-            const data = { name: "John Updated" };
-            await baseDataClient.put("/users/1", data);
-            expect(mockFetch).toHaveBeenCalledWith("/services/data/v99.0/users/1", {
-                method: "PUT",
-                body: JSON.stringify(data),
-                headers: {
-                    "Content-Type": "application/json",
-                    Accept: "application/json",
-                },
-            });
-        });
-        it("should make PATCH requests with JSON body", async () => {
-            const data = { name: "John Patched" };
-            await baseDataClient.patch("/users/1", data);
-            expect(mockFetch).toHaveBeenCalledWith("/services/data/v99.0/users/1", {
-                method: "PATCH",
-                body: JSON.stringify(data),
-                headers: {
-                    "Content-Type": "application/json",
-                    Accept: "application/json",
-                },
-            });
-        });
-        it("should make DELETE requests", async () => {
-            await baseDataClient.delete("/users/1");
-            expect(mockFetch).toHaveBeenCalledWith("/services/data/v99.0/users/1", {
-                method: "DELETE",
-                headers: {
-                    "Content-Type": "application/json",
-                    Accept: "application/json",
-                },
-            });
-        });
-    });
-    describe("body processing", () => {
-        beforeEach(() => {
-            mockFetch.mockResolvedValue({
-                status: 200,
-                json: () => Promise.resolve({}),
-            });
-        });
-        it.each([
-            { name: "null", value: null },
-            { name: "undefined", value: undefined },
-            { name: "other", value: () => "dummy" },
-        ])("should return undefined for $name body", async ({ value }) => {
-            await baseDataClient.post("/users", value);
-            expect(mockFetch).toHaveBeenCalledWith("/services/data/v99.0/users", expect.objectContaining({ body: undefined }));
-        });
-        it("should use string bodies as is", async () => {
-            const data = "foobar";
-            await baseDataClient.post("/users", data);
-            expect(mockFetch).toHaveBeenCalledWith("/services/data/v99.0/users", expect.objectContaining({
-                body: "foobar",
-            }));
-        });
-        it("should stringify object bodies for JSON content-type", async () => {
-            const data = { name: "John" };
-            await baseDataClient.post("/users", data);
-            expect(mockFetch).toHaveBeenCalledWith("/services/data/v99.0/users", expect.objectContaining({
-                body: JSON.stringify(data),
-            }));
-        });
-        it("should not stringify non-object bodies", async () => {
-            const formData = new FormData();
-            await baseDataClient.post("/upload", formData);
-            expect(mockFetch).toHaveBeenCalledWith("/services/data/v99.0/upload", expect.objectContaining({
-                body: formData,
-            }));
-        });
-        it("should not stringify when content-type is not JSON", async () => {
-            const data = { name: "John" };
-            await baseDataClient.post("/users", data, {
-                headers: { "Content-Type": "multipart/form-data" },
-            });
-            // When content-type is not JSON and body is a plain object (not FormData/string),
-            // processBody returns undefined since it can't serialize non-JSON content
-            expect(mockFetch).toHaveBeenCalledWith("/services/data/v99.0/users", expect.objectContaining({
-                body: undefined,
-            }));
-        });
-    });
-});

package/dist/webapp/clients.d.ts

@@ -1,23 +0,0 @@
-/**
- * Copyright (c) 2026, Salesforce, Inc.,
- * All rights reserved.
- * For full license text, see the LICENSE.txt file
- */
-import { ConduitClient } from "@conduit-client/salesforce-lightning-service-worker";
-export declare const API_VERSION: string;
-export declare const conduitClient: ConduitClient;
-export declare class ApiClient {
-    private readonly baseURL;
-    private readonly defaultOptions;
-    constructor(baseURL: string, defaultOptions?: RequestInit);
-    private isJsonContentType;
-    private fetch;
-    private processBody;
-    post(url: string, body?: unknown, options?: RequestInit): Promise<Response>;
-    get(url: string, options?: RequestInit): Promise<Response>;
-    put(url: string, body?: unknown, options?: RequestInit): Promise<Response>;
-    patch(url: string, body?: unknown, options?: RequestInit): Promise<Response>;
-    delete(url: string, options?: RequestInit): Promise<Response>;
-}
-export declare const baseDataClient: ApiClient;
-//# sourceMappingURL=clients.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"clients.d.ts","sourceRoot":"","sources":["../../src/webapp/clients.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qDAAqD,CAAC;AAMpF,eAAO,MAAM,WAAW,QAA+B,CAAC;AAkBxD,eAAO,MAAM,aAAa,eAA2B,CAAC;AAEtD,qBAAa,SAAS;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAc;gBAEjC,OAAO,EAAE,MAAM,EAAE,cAAc,GAAE,WAAgB;IAY7D,OAAO,CAAC,iBAAiB;YASX,KAAK;IAenB,OAAO,CAAC,WAAW;IAab,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;AAED,eAAO,MAAM,cAAc,WAAwC,CAAC"}

package/dist/webapp/clients.js

@@ -1,100 +0,0 @@
-/**
- * Copyright (c) 2026, Salesforce, Inc.,
- * All rights reserved.
- * For full license text, see the LICENSE.txt file
- */
-import { ConduitClient } from "@conduit-client/salesforce-lightning-service-worker";
-// Project standard API version from environment variable with fallback
-export const API_VERSION = __SF_API_VERSION__ || "65.0";
-const BASE = __SF_SERVER_BASE_PATH__ || "";
-const SERVICES = `/services`;
-const DATA = `/data/v${API_VERSION}`;
-const UI_API = `/ui-api`;
-const CACHE_VERSION = 1;
-const CACHE_NAME = `vibe-coding-starter-${CACHE_VERSION}`;
-ConduitClient.initialize({
-    csrf: {
-        endpoint: BASE + SERVICES + DATA + UI_API + "/session/csrf",
-        cacheName: CACHE_NAME,
-        protectedUrls: ["/services/data/v", "/lwr/apex/v"],
-    },
-});
-export const conduitClient = ConduitClient.instance();
-export class ApiClient {
-    baseURL;
-    defaultOptions;
-    constructor(baseURL, defaultOptions = {}) {
-        this.baseURL = baseURL;
-        this.defaultOptions = {
-            ...defaultOptions,
-            headers: {
-                "Content-Type": "application/json",
-                Accept: "application/json",
-                ...(defaultOptions.headers || {}),
-            },
-        };
-    }
-    isJsonContentType(headers) {
-        // default to JSON if no headers specified
-        if (!headers)
-            return true;
-        const headersObj = new Headers(headers);
-        const contentType = headersObj.get("content-type");
-        return !contentType || contentType.includes("application/json");
-    }
-    async fetch(info, options = {}) {
-        const fullURL = info instanceof URL || info.startsWith("http") ? info : `${this.baseURL}${info}`;
-        const mergedOptions = {
-            ...this.defaultOptions,
-            ...options,
-            headers: {
-                ...this.defaultOptions.headers,
-                ...(options.headers || {}),
-            },
-        };
-        return await conduitClient.fetch(fullURL, mergedOptions);
-    }
-    processBody(body, options) {
-        if (body === undefined || body === null) {
-            return undefined;
-        }
-        else if (body instanceof FormData) {
-            return body;
-        }
-        else if (typeof body === "string") {
-            return body;
-        }
-        else if (typeof body === "object" && this.isJsonContentType(options.headers)) {
-            return JSON.stringify(body);
-        }
-        return undefined;
-    }
-    async post(url, body, options = {}) {
-        return this.fetch(url, {
-            method: "POST",
-            body: this.processBody(body, options),
-            ...options,
-        });
-    }
-    async get(url, options = {}) {
-        return this.fetch(url, { method: "GET", ...options });
-    }
-    async put(url, body, options = {}) {
-        return this.fetch(url, {
-            method: "PUT",
-            body: this.processBody(body, options),
-            ...options,
-        });
-    }
-    async patch(url, body, options = {}) {
-        return this.fetch(url, {
-            method: "PATCH",
-            body: this.processBody(body, options),
-            ...options,
-        });
-    }
-    async delete(url, options = {}) {
-        return this.fetch(url, { method: "DELETE", ...options });
-    }
-}
-export const baseDataClient = new ApiClient(BASE + SERVICES + DATA);