@salesforce/platform-sdk 11.71.4 → 12.0.0

package/dist/data/mosaic/index.d.ts

@@ -31,6 +31,7 @@ export interface MosaicDataSDKOptions {
 export declare class MosaicDataSDK implements DataSDK {
     private readonly clientFetch;
     private readonly pathData;
+    readonly apiVersion: string;
     readonly graphql: DataSDKGraphQL;
     constructor(options?: MosaicDataSDKOptions);
     private executeRawGraphQL;

package/dist/data/mosaic/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/data/mosaic/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAmC,MAAM,YAAY,CAAC;AAe3F;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACpC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,qBAAa,aAAc,YAAW,OAAO;IAC5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAe;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;gBAErB,OAAO,CAAC,EAAE,oBAAoB;YAa5B,iBAAiB;CAe/B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/data/mosaic/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAmC,MAAM,YAAY,CAAC;AAe3F;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACpC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,qBAAa,aAAc,YAAW,OAAO;IAC5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAe;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;gBAErB,OAAO,CAAC,EAAE,oBAAoB;YAc5B,iBAAiB;CAe/B"}

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

@@ -8,6 +8,7 @@ export declare class WebAppDataSDK implements DataSDK {
     private readonly pathData;
     private readonly clientFetch;
     private readonly onStatus;
+    readonly apiVersion: string;
     readonly graphql: DataSDKGraphQL;
     constructor(options?: WebAppDataSDKOptions);
     fetch(input: string | URL | Request, init?: RequestInit): Promise<Response>;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/data/webapp/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAmC,MAAM,YAAY,CAAC;AAC3F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAWrD;;GAEG;AACH,qBAAa,aAAc,YAAW,OAAO;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAe;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyD;IAClF,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;gBAErB,OAAO,CAAC,EAAE,oBAAoB;IAkCpC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAUjF;;;;;OAKG;YACW,iBAAiB;IAgB/B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;CAa3B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/data/webapp/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAmC,MAAM,YAAY,CAAC;AAC3F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAWrD;;GAEG;AACH,qBAAa,aAAc,YAAW,OAAO;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAe;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyD;IAClF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;gBAErB,OAAO,CAAC,EAAE,oBAAoB;IAmCpC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAUjF;;;;;OAKG;YACW,iBAAiB;IAgB/B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;CAa3B"}

package/dist/index.js

@@ -1,46 +1,44 @@
-import { M as t, a, S as o, g as p, i as s, b as i, r as S } from "./surface-Dd2tqrPi.js";
+import { M as t, a, 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-CCBqEXMt.js";
-import { w as n } from "./sdk-promise-D0sy7OW1.js";
-import { c as g } from "./extension-factory-CJkfM4km.js";
-import { MCPAppsChatSDK as K, createChatSDK as l, getChatSDK as A, getChatSDKSync as C, resetChatSDK as d } from "./chat/index.js";
-import { MCPAppsViewSDK as y, createViewSDK as T, getViewSDK as h, getViewSDKSync as u, resetViewSDK as E } from "./view/index.js";
-import { createDataSDK as P, defineDataExtension as V, gql as b } from "./data/index.js";
-import { createLightningSDK as F } from "./lightning/index.js";
-import { WebAppCurrentApp as U, getCurrentApp as _ } from "./app/index.js";
-import { c as z } from "./transport-D9QstWle.js";
-import { T as N, r as W } from "./TelemetryUploader-DKkdppe9.js";
-import { P as j, c as k, v as B } from "./analytics-Dpz22kda.js";
+import { w as D } from "./sdk-promise-D0sy7OW1.js";
+import { MCPAppsChatSDK as n, createChatSDK as K, getChatSDK as l, getChatSDKSync as x, resetChatSDK as A } from "./chat/index.js";
+import { MCPAppsViewSDK as d, createViewSDK as w, getViewSDK as T, getViewSDKSync as h, resetViewSDK as u } from "./view/index.js";
+import { createDataSDK as M, defineDataExtension as P, gql as V } from "./data/index.js";
+import { createLightningSDK as E } from "./lightning/index.js";
+import { WebAppCurrentApp as I, getCurrentApp as U } from "./app/index.js";
+import { c as q } from "./transport-D9QstWle.js";
+import { T as F, r as L } from "./TelemetryUploader-DKkdppe9.js";
+import { P as W, c as Y, v as j } from "./analytics-Dpz22kda.js";
 export {
-  K as MCPAppsChatSDK,
-  y as MCPAppsViewSDK,
+  n as MCPAppsChatSDK,
+  d as MCPAppsViewSDK,
   t as McpAppsNotAvailableError,
   a as McpAppsSession,
-  j as PFT_META_KEY,
-  o as Surface,
-  N as TelemetryUploader,
-  U as WebAppCurrentApp,
-  k as createAnalytics,
-  l as createChatSDK,
-  P as createDataSDK,
-  g as createExtensionFactory,
-  F as createLightningSDK,
-  z as createTelemetryTransport,
-  T as createViewSDK,
-  V as defineDataExtension,
-  A as getChatSDK,
-  C as getChatSDKSync,
-  _ as getCurrentApp,
+  W as PFT_META_KEY,
+  p as Surface,
+  F as TelemetryUploader,
+  I as WebAppCurrentApp,
+  Y as createAnalytics,
+  K as createChatSDK,
+  M as createDataSDK,
+  E as createLightningSDK,
+  q as createTelemetryTransport,
+  w as createViewSDK,
+  P as defineDataExtension,
+  l as getChatSDK,
+  x as getChatSDKSync,
+  U as getCurrentApp,
   c as getSurfaceCapabilities,
-  p as getVerifiedSurface,
-  h as getViewSDK,
-  u as getViewSDKSync,
-  b as gql,
-  s as initialize,
+  s as getVerifiedSurface,
+  T as getViewSDK,
+  h as getViewSDKSync,
+  V as gql,
+  o as initialize,
   i as isSfEmbeddingIframe,
-  W as registerTelemetryUploader,
-  d as resetChatSDK,
+  L as registerTelemetryUploader,
+  A as resetChatSDK,
   S as resetSurface,
-  E as resetViewSDK,
-  B as validatePftId,
-  n as wrapSDKPromise
+  u as resetViewSDK,
+  j as validatePftId,
+  D as wrapSDKPromise
 };

package/docs/data/04-surfaces-and-guards.md

@@ -15,7 +15,18 @@ and `fetch` (the escape hatch; see [01-grounding-and-precedence.md](./01-groundi
 for which door to pick). Both are **optional**: a surface that doesn't support data operations
 resolves to a bare `{}` rather than throwing (see `DataSDK` in `dist/core/data.d.ts`). This page is
 the residue: how to guard that optionality, what `.fetch` is and how it differs from `.graphql`, how
-to read `errors`, and the per-surface options.
+to read `errors`, the resolved `apiVersion`, and the per-surface options.
+
+## `apiVersion` — the resolved adapter version
+
+`sdk.apiVersion` is the optional, read-only Salesforce API version selected by the resolved surface
+adapter. WebApp and Mosaic expose it and derive their data request paths from that same value;
+`apiVersion: "63.0"`, for example, produces paths under `/services/data/v63.0`. Tool-backed OpenAI
+and degraded surfaces do not expose a comparable org request version, so the property is absent.
+
+Use this property when behavior depends on the adapter's effective Salesforce API version. Do not
+recover the version by parsing a GraphQL or REST URL: those paths are downstream products of the
+version selection, not the version interface.
 
 ## `sdk.graphql!` vs guard — a surface decision
 
@@ -120,9 +131,9 @@ if (!result.data && result.errors?.length) {
 `createDataSDK(options)` takes a `DataSDKOptions` bag; the fields you set depend on the surface. The
 declarations own the field lists — this is just the routing:
 
-- **WebApp** — `WebAppDataSDKOptions` (`options.webapp`): `basePath`, and `onStatus` per-HTTP-status
-  callbacks (each a `StatusCallback`) for cases like re-authenticating on a `401`. This is the
-  cached surface — see [02-caching-and-freshness.md](./02-caching-and-freshness.md).
+- **WebApp** — `WebAppDataSDKOptions` (`options.webapp`): `basePath`, `apiVersion`, and `onStatus`
+  per-HTTP-status callbacks (each a `StatusCallback`) for cases like re-authenticating on a `401`.
+  This is the cached surface — see [02-caching-and-freshness.md](./02-caching-and-freshness.md).
 - **Mosaic** — `MosaicDataSDKOptions` (`options.mosaic`): server-side (Node) auth via `instanceUrl` /
   `accessToken` / `apiVersion`. Uncached.
 - **OpenAI** — no surface options bag; delegates to an MCP tool. Uncached, and it exposes no header

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/platform-sdk",
-  "version": "11.71.4",
+  "version": "12.0.0",
   "license": "SEE LICENSE IN LICENSE.txt",
   "type": "module",
   "main": "./dist/index.js",
@@ -139,7 +139,7 @@
     "@conduit-client/service-pubsub": "3.19.6",
     "@conduit-client/service-retry": "3.19.6",
     "@conduit-client/utils": "3.19.6",
-    "@salesforce/jsonrpc": "^11.71.4",
+    "@salesforce/jsonrpc": "^12.0.0",
     "@salesforce/sf-embedding-bridge": "2.2.5-rc.2"
   },
   "peerDependencies": {

package/dist/core/extension-factory.d.ts

@@ -1,42 +0,0 @@
-import { LiteralName, Extension } from './extension-types';
-/**
- * Bind a extension authoring helper to one SDK surface, so authors never annotate
- * `setup`'s parameter. `createExtensionFactory<Sdk>()` captures the base SDK once
- * and returns a definer; each call to that definer infers only the extension's
- * literal `Name` and its `Api`, with `setup(sdk)` already typed as `Sdk`:
- *
- * ```ts
- * const defineDataExtension = createExtensionFactory<DataSDK>();
- * const labels = defineDataExtension({ name: "labels", setup: (sdk) => ({ ... }) });
- * ```
- *
- * `createDataSDK` exposes the DataSDK-bound definer as `defineDataExtension`. This
- * factory is also the public escape hatch for a surface with no first-party
- * definer yet, or for an author's own SDK.
- *
- * ## Why a curried factory, and not a single `defineExtension<Sdk, Name, Api>`?
- *
- * The obvious alternative is one generic function whose caller fixes the SDK:
- * `defineExtension<DataSDK>({ name, setup })`. TypeScript does not allow it —
- * type-argument lists are all-or-nothing per call, so supplying `Sdk` forces
- * you to also supply `Name` and `Api` (`Expected 3 type arguments, but got 1`),
- * which throws away the very inference that makes the helper worth using. That
- * leaves only one way to keep `Sdk` implicit at the value call: annotate the
- * parameter (`setup: (sdk: DataSDK) => ...`) on every extension. And a *forgotten*
- * annotation does not error — it silently infers `Sdk = unknown`, a
- * universally-attachable binding that slips a surface-specific extension past the
- * per-surface {@link ExtensionsFor} guard.
- *
- * Currying dodges both problems. The outer call takes `Sdk` as its only type
- * argument and no value arguments, so nothing forces `Name`/`Api` to be spelled
- * out; the inner call infers those from the extension object. `Sdk` is fixed before
- * any extension is written, so it can be neither forgotten nor widened — the
- * footgun is designed out rather than documented around.
- *
- * The returned definer is identity at runtime. It carries the {@link LiteralName}
- * guard, which rejects a widened `string` name at definition time: without a
- * concrete literal there is no key to accumulate onto the extended SDK, so
- * failing loud here beats a silently dropped namespace downstream.
- */
-export declare function createExtensionFactory<Sdk>(): <const Name extends string, Api>(extension: Extension<Sdk, LiteralName<Name>, Api>) => Extension<Sdk, Name, Api>;
-//# sourceMappingURL=extension-factory.d.ts.map

package/dist/core/extension-factory.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"extension-factory.d.ts","sourceRoot":"","sources":["../../src/core/extension-factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,MACT,KAAK,CAAC,IAAI,SAAS,MAAM,EAAE,GAAG,EAC7D,WAAW,SAAS,CAAC,GAAG,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,KAC/C,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,CAG5B"}

package/dist/extension-factory-CJkfM4km.js

@@ -1,8 +0,0 @@
-function t() {
-  return function(n) {
-    return n;
-  };
-}
-export {
-  t as c
-};