@salesforce/platform-sdk 11.37.1 → 11.39.0

package/dist/app/index.d.ts

@@ -0,0 +1,24 @@
+import { CurrentApp, SDKOptions } from '../core';
+/**
+ * Options for querying the current app.
+ */
+export interface CurrentAppOptions extends SDKOptions {
+}
+/**
+ * Get the current (running) app based on the detected surface.
+ *
+ * There is exactly one running app, so this queries the ambient one rather than
+ * constructing a client. Its identity is backed by `SFDC_ENV`, which the runtime
+ * injects only on the {@link Surface.WebApp} surface today (an internally-hosted
+ * MicroFrontend is the natural next surface). On every other surface — and when
+ * the surface is unusable — the returned {@link CurrentApp} has `identity`
+ * `undefined`, mirroring how the Data/Chat SDKs degrade rather than failing the
+ * host.
+ *
+ * @param options - Optional configuration including surface override
+ * @returns Promise resolving to the current app
+ */
+export declare function getCurrentApp(options?: CurrentAppOptions): Promise<CurrentApp>;
+export { WebAppCurrentApp } from './webapp';
+export type { AppIdentity, CurrentApp } from '../core';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/app/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGtD;;GAEG;AAEH,MAAM,WAAW,iBAAkB,SAAQ,UAAU;CAAG;AAExD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAoB9E;AAED,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC"}

package/dist/app/index.js

@@ -0,0 +1,36 @@
+import { g as n, S as c } from "../surface-Dd2tqrPi.js";
+import { w as s } from "../sdk-promise-D0sy7OW1.js";
+const p = "c";
+class u {
+  identity;
+  constructor() {
+    const e = globalThis.SFDC_ENV, r = e?.appName;
+    if (!r)
+      return;
+    const a = e?.namespace || p;
+    this.identity = {
+      namespace: a,
+      appName: r,
+      // Namespace first, "__" separator — the UIBundle record's qualified name.
+      qualifiedName: `${a}__${r}`,
+      // Authoritative record Id from the server injector; absent in local-dev.
+      bundleId: e?.bundleId
+    };
+  }
+}
+function f(t) {
+  return s(
+    (async () => {
+      try {
+        return await n(t?.surface) === c.WebApp ? new u() : {};
+      } catch {
+        return {};
+      }
+    })(),
+    "getCurrentApp"
+  );
+}
+export {
+  u as WebAppCurrentApp,
+  f as getCurrentApp
+};

package/dist/app/webapp.d.ts

@@ -0,0 +1,10 @@
+import { AppIdentity, CurrentApp } from '../core';
+/**
+ * Current-app implementation for web apps: reads the identity the runtime
+ * injected into `globalThis.SFDC_ENV` and composes the qualified name.
+ */
+export declare class WebAppCurrentApp implements CurrentApp {
+    readonly identity?: AppIdentity;
+    constructor();
+}
+//# sourceMappingURL=webapp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webapp.d.ts","sourceRoot":"","sources":["../../src/app/webapp.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAKvD;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,UAAU;IAClD,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC;;CAuBhC"}

package/dist/core/app.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+/**
+ * Identity of the running UIBundle (web app), derived from the values the
+ * runtime injects into `globalThis.SFDC_ENV`.
+ *
+ * The {@link qualifiedName} — `namespace__appName` — is the platform-addressable
+ * name of the UIBundle record (namespace first, `__` separator, namespace kept
+ * in its original mixed case). It is composed at runtime from the two stored
+ * fields; it is **not** the auto-assigned 18-char record Id. Consumers such as
+ * CMS search that key off the UIBundle identity use this value.
+ */
+export interface AppIdentity {
+    /**
+     * Namespace prefix in its original mixed case (e.g., "MyNs"). Falls back to
+     * "c" when the org has no registered namespace.
+     */
+    namespace: string;
+    /** Developer (app) name of the UIBundle (e.g., "MyBundle"). */
+    appName: string;
+    /**
+     * Platform-addressable qualified name `namespace__appName`
+     * (e.g., "MyNs__MyBundle", or "c__MyBundle" with no registered namespace).
+     */
+    qualifiedName: string;
+    /**
+     * Authoritative UIBundle **record Id**, injected by the core server (owned
+     * by App Fabric) into `SFDC_ENV`. Explicitly **not** {@link qualifiedName}
+     * and **not** {@link appName}. `undefined` when the runtime does not inject
+     * it — local development, and every non-WebApp surface.
+     */
+    bundleId?: string;
+}
+/**
+ * The current (running) app: the single, ambient app the code is executing
+ * inside. There is exactly one, so it is queried — not constructed.
+ *
+ * Its {@link identity} is only meaningful on surfaces where the runtime injects
+ * `SFDC_ENV` (the {@link Surface.WebApp} surface today). On every other surface
+ * {@link identity} is absent, mirroring how the other SDKs degrade when a surface
+ * cannot back their capability.
+ */
+export interface CurrentApp {
+    /** The running app's identity, or `undefined` on surfaces without `SFDC_ENV`. */
+    readonly identity?: AppIdentity;
+}
+//# sourceMappingURL=app.d.ts.map

package/dist/core/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/core/app.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAW;IAC3B;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IAC1B,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC;CAChC"}

package/dist/core/index.d.ts

@@ -6,6 +6,7 @@
 export { Surface, getVerifiedSurface, initialize, isSfEmbeddingIframe, resetSurface, } from './surface';
 export type { InitializeOptions } from './surface';
 export type { SDKOptions } from './options';
+export type { AppIdentity, CurrentApp } from './app';
 export type { HostContext, HostStyles, ChatMessage, ChatSDK, ContentBlock, DeviceCapabilities, DisplayMode, ResourceRequest, SafeAreaInsets, SetWidgetStateOptions, ToolCall, ToolState, } from './chat';
 export type { AlertOptions, MessageLevel, ModalOptions, ToastOptions, Theme, ThemeMode, UiState, UiStyles, ViewSDK, } from './view';
 export type { CacheControl, DataSDK, DataSDKGraphQL, GraphQLError, GraphQLRawDocument, GraphQLRequest, GraphQLRequestHeaders, GraphQLResponse, MutateOptions, MutationResult, QueryOptions, QueryResult, QuerySubscriber, Unsubscribe, } from './data';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACN,OAAO,EACP,kBAAkB,EAClB,UAAU,EACV,mBAAmB,EACnB,YAAY,GACZ,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAGnD,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAG5C,YAAY,EACX,WAAW,EACX,UAAU,EACV,WAAW,EACX,OAAO,EACP,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,QAAQ,EACR,SAAS,GACT,MAAM,QAAQ,CAAC;AAGhB,YAAY,EACX,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,KAAK,EACL,SAAS,EACT,OAAO,EACP,QAAQ,EACR,OAAO,GACP,MAAM,QAAQ,CAAC;AAGhB,YAAY,EACX,YAAY,EACZ,OAAO,EACP,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,cAAc,EACd,YAAY,EACZ,WAAW,EACX,eAAe,EACf,WAAW,GACX,MAAM,QAAQ,CAAC;AAGhB,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7F,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,EAAE,wBAAwB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC7E,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACN,OAAO,EACP,kBAAkB,EAClB,UAAU,EACV,mBAAmB,EACnB,YAAY,GACZ,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAGnD,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAG5C,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAGrD,YAAY,EACX,WAAW,EACX,UAAU,EACV,WAAW,EACX,OAAO,EACP,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,QAAQ,EACR,SAAS,GACT,MAAM,QAAQ,CAAC;AAGhB,YAAY,EACX,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,KAAK,EACL,SAAS,EACT,OAAO,EACP,QAAQ,EACR,OAAO,GACP,MAAM,QAAQ,CAAC;AAGhB,YAAY,EACX,YAAY,EACZ,OAAO,EACP,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,cAAc,EACd,YAAY,EACZ,WAAW,EACX,eAAe,EACf,WAAW,GACX,MAAM,QAAQ,CAAC;AAGhB,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7F,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,EAAE,wBAAwB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC7E,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/data/index.js

@@ -239,7 +239,7 @@ class fe {
     })).structuredContent;
   }
 }
-const pe = "X-SFDC-Client-Name", me = "X-SFDC-Client-Version", ye = "@salesforce/platform-sdk", be = "11.37.1", ve = (r) => {
+const pe = "X-SFDC-Client-Name", me = "X-SFDC-Client-Version", ye = "@salesforce/platform-sdk", be = "11.39.0", ve = (r) => {
   let e = b(pe, ye, r);
   return e = b(me, be, e), u(e);
 }, Se = "X-CSRF-Token";

package/dist/index.d.ts

@@ -8,6 +8,7 @@ export { createChatSDK, type ChatSDKOptions, MCPAppsChatSDK, getChatSDK, getChat
 export { createViewSDK, type ViewSDKOptions, MCPAppsViewSDK, getViewSDK, getViewSDKSync, resetViewSDK, } from './view';
 export { createDataSDK, type DataSDKOptions, type WebAppDataSDKOptions, type MosaicDataSDKOptions, type StatusCallback, type NodeOfConnection, gql, } from './data';
 export { createLightningSDK, type LightningSDKOptions } from './lightning';
+export { getCurrentApp, type CurrentAppOptions, type AppIdentity, type CurrentApp, WebAppCurrentApp, } from './app';
 export { createTelemetryTransport, registerTelemetryUploader, TelemetryUploader, type TelemetryTransport, type TelemetryTransportOptions, type EnvelopeEntry, type EnvelopeMetadata, type TelemetryUploaderOptions, type OnEnvelopeCallback, type FlushReason, type TelemetryUploadContext, type TelemetryUploaderErrorContext, type InstrumentedAppLike, type DisposeOptions, } from './telemetry';
 export { AXL_PFT_ID, createAnalytics, PFT_META_KEY, validatePftId, type Analytics, type AnalyticsOptions, } from './analytics';
 //# 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,cAAc,QAAQ,CAAC;AAGvB,OAAO,EACN,aAAa,EACb,KAAK,cAAc,EACnB,cAAc,EACd,UAAU,EACV,cAAc,EACd,YAAY,GACZ,MAAM,QAAQ,CAAC;AAGhB,OAAO,EACN,aAAa,EACb,KAAK,cAAc,EACnB,cAAc,EACd,UAAU,EACV,cAAc,EACd,YAAY,GACZ,MAAM,QAAQ,CAAC;AAGhB,OAAO,EACN,aAAa,EACb,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,GAAG,GACH,MAAM,QAAQ,CAAC;AAGhB,OAAO,EAAE,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAG3E,OAAO,EACN,wBAAwB,EACxB,yBAAyB,EACzB,iBAAiB,EACjB,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,sBAAsB,EAC3B,KAAK,6BAA6B,EAClC,KAAK,mBAAmB,EACxB,KAAK,cAAc,GACnB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACN,UAAU,EACV,eAAe,EACf,YAAY,EACZ,aAAa,EACb,KAAK,SAAS,EACd,KAAK,gBAAgB,GACrB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,QAAQ,CAAC;AAGvB,OAAO,EACN,aAAa,EACb,KAAK,cAAc,EACnB,cAAc,EACd,UAAU,EACV,cAAc,EACd,YAAY,GACZ,MAAM,QAAQ,CAAC;AAGhB,OAAO,EACN,aAAa,EACb,KAAK,cAAc,EACnB,cAAc,EACd,UAAU,EACV,cAAc,EACd,YAAY,GACZ,MAAM,QAAQ,CAAC;AAGhB,OAAO,EACN,aAAa,EACb,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,GAAG,GACH,MAAM,QAAQ,CAAC;AAGhB,OAAO,EAAE,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAG3E,OAAO,EACN,aAAa,EACb,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,gBAAgB,GAChB,MAAM,OAAO,CAAC;AAGf,OAAO,EACN,wBAAwB,EACxB,yBAAyB,EACzB,iBAAiB,EACjB,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,sBAAsB,EAC3B,KAAK,6BAA6B,EAClC,KAAK,mBAAmB,EACxB,KAAK,cAAc,GACnB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACN,UAAU,EACV,eAAe,EACf,YAAY,EACZ,aAAa,EACb,KAAK,SAAS,EACd,KAAK,gBAAgB,GACrB,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -1,41 +1,44 @@
-import { M as a, a as t, S as s, g as o, i, b as p, r as S } from "./surface-Dd2tqrPi.js";
+import { M as a, a as t, S as p, g as s, i as o, b as i, r as S } from "./surface-Dd2tqrPi.js";
 import { g as c } from "./capabilities-5BWkCbcP.js";
 import { w as D } from "./sdk-promise-D0sy7OW1.js";
-import { MCPAppsChatSDK as g, createChatSDK as l, getChatSDK as x, getChatSDKSync as n, resetChatSDK as A } from "./chat/index.js";
+import { MCPAppsChatSDK as K, createChatSDK as l, getChatSDK as A, getChatSDKSync as n, resetChatSDK as x } from "./chat/index.js";
 import { MCPAppsViewSDK as T, createViewSDK as d, getViewSDK as w, getViewSDKSync as P, resetViewSDK as h } from "./view/index.js";
-import { createDataSDK as M, gql as V } from "./data/index.js";
-import { createLightningSDK as u } from "./lightning/index.js";
-import { c as _ } from "./transport-D9QstWle.js";
-import { T as I, r as F } from "./TelemetryUploader-DKkdppe9.js";
-import { A as U, P as q, c as z, v as N } from "./analytics-xqWfpWnv.js";
+import { createDataSDK as y, gql as M } from "./data/index.js";
+import { createLightningSDK as b } from "./lightning/index.js";
+import { WebAppCurrentApp as _, getCurrentApp as v } from "./app/index.js";
+import { c as F } from "./transport-D9QstWle.js";
+import { T as U, r as q } from "./TelemetryUploader-DKkdppe9.js";
+import { A as N, P as W, c as X, v as Y } from "./analytics-xqWfpWnv.js";
 export {
-  U as AXL_PFT_ID,
-  g as MCPAppsChatSDK,
+  N as AXL_PFT_ID,
+  K as MCPAppsChatSDK,
   T as MCPAppsViewSDK,
   a as McpAppsNotAvailableError,
   t as McpAppsSession,
-  q as PFT_META_KEY,
-  s as Surface,
-  I as TelemetryUploader,
-  z as createAnalytics,
+  W as PFT_META_KEY,
+  p as Surface,
+  U as TelemetryUploader,
+  _ as WebAppCurrentApp,
+  X as createAnalytics,
   l as createChatSDK,
-  M as createDataSDK,
-  u as createLightningSDK,
-  _ as createTelemetryTransport,
+  y as createDataSDK,
+  b as createLightningSDK,
+  F as createTelemetryTransport,
   d as createViewSDK,
-  x as getChatSDK,
+  A as getChatSDK,
   n as getChatSDKSync,
+  v as getCurrentApp,
   c as getSurfaceCapabilities,
-  o as getVerifiedSurface,
+  s as getVerifiedSurface,
   w as getViewSDK,
   P as getViewSDKSync,
-  V as gql,
-  i as initialize,
-  p as isSfEmbeddingIframe,
-  F as registerTelemetryUploader,
-  A as resetChatSDK,
+  M as gql,
+  o as initialize,
+  i as isSfEmbeddingIframe,
+  q as registerTelemetryUploader,
+  x as resetChatSDK,
   S as resetSurface,
   h as resetViewSDK,
-  N as validatePftId,
+  Y as validatePftId,
   D as wrapSDKPromise
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/platform-sdk",
-  "version": "11.37.1",
+  "version": "11.39.0",
   "license": "SEE LICENSE IN LICENSE.txt",
   "type": "module",
   "main": "./dist/index.js",
@@ -27,6 +27,9 @@
       "lightning": [
         "./dist/lightning/index.d.ts"
       ],
+      "app": [
+        "./dist/app/index.d.ts"
+      ],
       "telemetry": [
         "./dist/telemetry/index.d.ts"
       ],
@@ -72,6 +75,11 @@
       "import": "./dist/lightning/index.js",
       "default": "./dist/lightning/index.js"
     },
+    "./app": {
+      "types": "./dist/app/index.d.ts",
+      "import": "./dist/app/index.js",
+      "default": "./dist/app/index.js"
+    },
     "./telemetry": {
       "types": "./dist/telemetry/index.d.ts",
       "import": "./dist/telemetry/index.js",
@@ -115,7 +123,7 @@
     "@conduit-client/service-pubsub": "3.19.6",
     "@conduit-client/service-retry": "3.19.6",
     "@conduit-client/utils": "3.19.6",
-    "@salesforce/jsonrpc": "^11.37.1",
+    "@salesforce/jsonrpc": "^11.39.0",
     "@salesforce/sf-embedding-bridge": "2.2.5-rc.2"
   },
   "peerDependencies": {