@salesforce/sdk-core 1.130.0 → 1.130.2

package/dist/data.d.ts

@@ -14,14 +14,18 @@ export interface GraphQLResponse<T> {
         path?: string[];
     }[];
 }
+export interface GraphQLRequest<V = Record<string, unknown>> {
+    query: string;
+    variables?: V;
+    operationName?: string;
+}
 export interface DataSDK {
     /**
      * Run a GraphQL query
      *
-     * @param query
-     * @param variables
+     * @param request - The GraphQL request options (query, variables, operationName)
      */
-    graphql?: <T, V = Record<string, unknown>>(query: string, variables?: V) => Promise<GraphQLResponse<T>>;
+    graphql?: <T, V = Record<string, unknown>>(request: GraphQLRequest<V>) => Promise<GraphQLResponse<T>>;
     /**
      * Make a request using the Fetch API.
      *

package/dist/data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../src/data.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,eAAe,CAAC,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC;IACR,MAAM,CAAC,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAC/C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KAChB,EAAE,CAAC;CACJ;AAED,MAAM,WAAW,OAAO;IACvB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxC,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,CAAC,KACT,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;IAEjC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACrB"}
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../src/data.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,eAAe,CAAC,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC;IACR,MAAM,CAAC,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAC/C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KAChB,EAAE,CAAC;CACJ;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,CAAC,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,OAAO;IACvB;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,KACtB,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;IAEjC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACrB"}

package/dist/index.d.ts

@@ -8,7 +8,7 @@ export type { ACCConnection, ACCPanelCallbacks, ACCPreReceiveArgs } from './acc-
 export type { SDKOptions } from './options';
 export type { HostContext, HostStyles, ChatMessage, ChatSDK, DeviceCapabilities, DisplayMode, ResourceRequest, SafeAreaInsets, ToolCall, ToolState, } from './chat';
 export type { AlertOptions, MessageLevel, ModalOptions, ToastOptions, Theme, ThemeMode, ViewSDK, } from './view';
-export type { DataSDK, GraphQLResponse } from './data';
+export type { DataSDK, GraphQLRequest, GraphQLResponse } from './data';
 export type { LightningSDK, LMSMessage, LMSSubscription, MessageChannel } from './lightning';
 export type { OpenAISDK, SalesforceACCSDK } from './platforms';
 export type { JsonRpcBase, JsonRpcRequest, JsonRpcError, JsonRpcSuccessResponse, JsonRpcErrorResponse, JsonRpcResponse, JsonRpcNotification, JsonRpcMessage, JsonRpcPendingRequest, JsonRpcPendingRequestMap, } from './jsonrpc';
@@ -18,4 +18,5 @@ export { McpAppsSession } from './mcpapps-session';
 export type { McpAppsHostContext, McpAppsSessionOptions } from './mcpapps-session';
 export { getSurfaceCapabilities } from './capabilities';
 export type { SurfaceCapabilities } from './capabilities';
+export { wrapSDKPromise } from './sdk-promise';
 //# 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":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGhD,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGvF,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAG5C,YAAY,EACX,WAAW,EACX,UAAU,EACV,WAAW,EACX,OAAO,EACP,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,cAAc,EACd,QAAQ,EACR,SAAS,GACT,MAAM,QAAQ,CAAC;AAGhB,YAAY,EACX,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,KAAK,EACL,SAAS,EACT,OAAO,GACP,MAAM,QAAQ,CAAC;AAGhB,YAAY,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAGvD,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7F,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/D,YAAY,EACX,WAAW,EACX,cAAc,EACd,YAAY,EACZ,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,wBAAwB,GACxB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACN,aAAa,EACb,wBAAwB,EACxB,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,GAChB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAGnF,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGhD,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGvF,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAG5C,YAAY,EACX,WAAW,EACX,UAAU,EACV,WAAW,EACX,OAAO,EACP,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,cAAc,EACd,QAAQ,EACR,SAAS,GACT,MAAM,QAAQ,CAAC;AAGhB,YAAY,EACX,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,KAAK,EACL,SAAS,EACT,OAAO,GACP,MAAM,QAAQ,CAAC;AAGhB,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAGvE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7F,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/D,YAAY,EACX,WAAW,EACX,cAAc,EACd,YAAY,EACZ,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,wBAAwB,GACxB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACN,aAAa,EACb,wBAAwB,EACxB,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,GAChB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAGnF,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAG1D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -1,4 +1,4 @@
-var o = /* @__PURE__ */ ((e) => (e.WebApp = "WebApp", e.MicroFrontend = "Micro-Frontend", e.OpenAI = "OpenAI", e.SalesforceACC = "Salesforce-ACC", e.MCPApps = "MCP-Apps", e.Mosaic = "Mosaic", e))(o || {});
+var r = /* @__PURE__ */ ((e) => (e.WebApp = "WebApp", e.MicroFrontend = "Micro-Frontend", e.OpenAI = "OpenAI", e.SalesforceACC = "Salesforce-ACC", e.MCPApps = "MCP-Apps", e.Mosaic = "Mosaic", e))(r || {});
 const d = f();
 function f() {
   if (typeof window > "u")
@@ -14,7 +14,7 @@ function f() {
   const e = window;
   return e.$A || e.Aura ? "Salesforce-ACC" : "WebApp";
 }
-function w(e) {
+function S(e) {
   return e ?? d;
 }
 function l(e) {
@@ -75,7 +75,7 @@ class T {
     }
     if (g(t)) {
       const n = this.notificationHandlers.get(t.method);
-      n && n.forEach((i) => i(t.params));
+      n && n.forEach((o) => o(t.params));
     }
   };
   /**
@@ -92,17 +92,17 @@ class T {
    * });
    */
   request(s, t) {
-    const n = this.nextRequestId++, i = {
+    const n = this.nextRequestId++, o = {
       jsonrpc: "2.0",
       id: n,
       method: s,
       params: t
     };
-    return new Promise((c, a) => {
+    return new Promise((i, c) => {
       this.pending.set(n, {
-        resolve: c,
-        reject: a
-      }), window.parent?.postMessage(i, "*");
+        resolve: i,
+        reject: c
+      }), window.parent?.postMessage(o, "*");
     });
   }
   /**
@@ -137,8 +137,8 @@ class T {
     window.parent?.postMessage(n, "*");
   }
 }
-const C = 500, M = "2026-01-26";
-class r extends T {
+const M = 500, C = "2026-01-26";
+class a extends T {
   static initPromise = null;
   hostCtx = {};
   _handshakeSucceeded = !1;
@@ -149,17 +149,17 @@ class r extends T {
    * calls reuse the same session and handshake result.
    */
   static async getInstance(s) {
-    return r.initPromise || (r.initPromise = (async () => {
-      const t = new r();
+    return a.initPromise || (a.initPromise = (async () => {
+      const t = new a();
       return await t.handshake(s), t;
-    })()), r.initPromise;
+    })()), a.initPromise;
   }
   /**
    * Reset the singleton (for testing only).
    * @internal
    */
   static resetInstance() {
-    r.initPromise = null;
+    a.initPromise = null;
   }
   /**
    * Perform the ui/initialize → hostContext → ui/notifications/initialized handshake.
@@ -169,20 +169,20 @@ class r extends T {
    * still render (graceful degradation for non-SEP-1865 hosts).
    */
   async handshake(s) {
-    const t = s?.handshakeTimeoutMs ?? C, n = s?.appInfo ?? { name: "mcp-app", version: "1.0.0" };
+    const t = s?.handshakeTimeoutMs ?? M, n = s?.appInfo ?? { name: "mcp-app", version: "1.0.0" };
     try {
-      const i = /* @__PURE__ */ Symbol("timeout"), c = await Promise.race([
+      const o = /* @__PURE__ */ Symbol("timeout"), i = await Promise.race([
         this.request("ui/initialize", {
-          protocolVersion: M,
+          protocolVersion: C,
           appInfo: n,
           appCapabilities: {}
         }),
-        new Promise((a) => setTimeout(() => a(i), t))
+        new Promise((c) => setTimeout(() => c(o), t))
       ]);
-      c !== i && (this.hostCtx = c.hostContext ?? {}, this._handshakeSucceeded = !0, this.registerNotificationHandler("ui/notifications/host-context-changed", (a) => {
+      i !== o && (this.hostCtx = i.hostContext ?? {}, this._handshakeSucceeded = !0, this.registerNotificationHandler("ui/notifications/host-context-changed", (c) => {
         this.hostCtx = {
           ...this.hostCtx,
-          ...a
+          ...c
         };
       }), this.sendNotification("ui/notifications/initialized"));
     } catch {
@@ -209,7 +209,7 @@ class r extends T {
     super.registerNotificationHandler(s, t);
   }
 }
-const A = {
+const y = {
   callTool: !0,
   sendMessageToHost: !0,
   readResource: !0,
@@ -229,7 +229,7 @@ const A = {
   // TODO
   getTheme: !0,
   resize: !0
-}, m = {
+}, w = {
   callTool: !0,
   sendMessageToHost: !0,
   readResource: !1,
@@ -248,7 +248,7 @@ const A = {
   displayModal: !0,
   getTheme: !0,
   resize: !1
-}, y = {
+}, m = {
   callTool: !1,
   sendMessageToHost: !0,
   readResource: !1,
@@ -267,7 +267,7 @@ const A = {
   displayModal: !1,
   getTheme: !0,
   resize: !1
-}, I = {
+}, A = {
   callTool: !1,
   sendMessageToHost: !1,
   readResource: !1,
@@ -287,31 +287,47 @@ const A = {
   getTheme: !1,
   resize: !1
 };
-function S(e) {
+function b(e) {
   switch (e) {
-    case o.MCPApps:
-      return { ...A };
-    case o.OpenAI:
-      return { ...m };
-    case o.SalesforceACC:
+    case r.MCPApps:
       return { ...y };
-    case o.Mosaic:
-    case o.WebApp:
-    case o.MicroFrontend:
+    case r.OpenAI:
+      return { ...w };
+    case r.SalesforceACC:
+      return { ...m };
+    case r.Mosaic:
+    case r.WebApp:
+    case r.MicroFrontend:
     default:
-      return { ...I };
+      return { ...A };
   }
 }
+const I = /* @__PURE__ */ new Set(["then", "catch", "finally"]);
+function R(e, s) {
+  return new Proxy(e, {
+    get(t, n, o) {
+      if (typeof n == "symbol" || I.has(n)) {
+        const i = Reflect.get(t, n, o);
+        return typeof i == "function" ? i.bind(t) : i;
+      }
+      throw new TypeError(
+        `\`${s}()\` returns a Promise — did you forget to await it?
+Use \`const sdk = await ${s}();\` before accessing SDK methods.`
+      );
+    }
+  });
+}
 export {
   T as JsonRpcClient,
-  r as McpAppsSession,
-  o as Surface,
-  w as getSurface,
-  S as getSurfaceCapabilities,
+  a as McpAppsSession,
+  r as Surface,
+  S as getSurface,
+  b as getSurfaceCapabilities,
   l as isJsonRpcBase,
   u as isJsonRpcErrorResponse,
   g as isJsonRpcNotification,
   P as isJsonRpcRequest,
   h as isJsonRpcResponse,
-  p as isJsonRpcSuccessResponse
+  p as isJsonRpcSuccessResponse,
+  R as wrapSDKPromise
 };

package/dist/sdk-promise.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+/**
+ * Wraps an SDK factory Promise in a Proxy that throws a clear error if a
+ * non-Promise method is accessed, guiding callers who forgot to `await`.
+ *
+ * Symbol-keyed properties (e.g. Symbol.toStringTag, Symbol.iterator) are
+ * always forwarded so the value continues to behave as a proper thenable.
+ */
+export declare function wrapSDKPromise<T>(promise: Promise<T>, factoryName: string): Promise<T>;
+//# sourceMappingURL=sdk-promise.d.ts.map

package/dist/sdk-promise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-promise.d.ts","sourceRoot":"","sources":["../src/sdk-promise.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAetF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/sdk-core",
-  "version": "1.130.0",
+  "version": "1.130.2",
   "license": "SEE LICENSE IN LICENSE.txt",
   "type": "module",
   "main": "./dist/index.js",