@salesforce/platform-sdk 11.64.0 → 11.66.2

package/dist/data/shared/graphql/cache/services.d.ts

@@ -17,18 +17,18 @@ export interface CacheBundle {
     services: CacheServices;
 }
 /**
- * Module-level registry so all SDK instances targeting the same baseUrl
+ * Module-level registry so all SDK instances targeting the same host+version
  * share one cache + cacheController + pubSub — no redundant network
  * requests for identical queries across features.
  * Exported for test isolation only; not part of the public API.
  */
 export declare const cacheBundleRegistry: Map<string, SharedCacheBundle>;
 /**
- * Returns a CacheBundle for the given baseUrl. The shared cache infra
- * (cache, cacheController, pubSub) is deduplicated by baseUrl — all SDK
- * instances targeting the same host share cache state. The per-instance
- * networkFetch ensures cache misses route through the calling SDK's fetch
- * pipeline (CSRF, onStatus callbacks).
+ * Returns a CacheBundle for the given cacheKey. The shared cache infra (cache,
+ * cacheController, pubSub) is deduplicated by cacheKey — instances with the
+ * same key share cache state, while distinct keys get isolated stores. The
+ * per-instance networkFetch ensures cache misses route through the calling
+ * SDK's fetch pipeline (CSRF, onStatus callbacks).
  */
-export declare function buildCacheServices(baseUrl: string, networkFetch: FetchService): CacheBundle;
+export declare function buildCacheServices(cacheKey: string, networkFetch: FetchService): CacheBundle;
 //# sourceMappingURL=services.d.ts.map

package/dist/data/shared/graphql/cache/services.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../../../../src/data/shared/graphql/cache/services.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kCAAkC,CAAC;AAE9D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AAG5F,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAChG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAG5E;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,2BAA2B,GAAG,kBAAkB,GAAG,iBAAiB,CAAC;AAEjG,MAAM,WAAW,iBAAiB;IACjC,KAAK,EAAE,KAAK,CAAC;IACb,eAAe,EAAE,2BAA2B,CAAC,iBAAiB,CAAC,CAAC;IAChE,MAAM,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,WAAW;IAC3B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,QAAQ,EAAE,aAAa,CAAC;CACxB;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,gCAAuC,CAAC;AAexE;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,GAAG,WAAW,CAU3F"}
+{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../../../../src/data/shared/graphql/cache/services.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kCAAkC,CAAC;AAE9D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,0CAA0C,CAAC;AAG5F,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAChG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAG5E;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,2BAA2B,GAAG,kBAAkB,GAAG,iBAAiB,CAAC;AAEjG,MAAM,WAAW,iBAAiB;IACjC,KAAK,EAAE,KAAK,CAAC;IACb,eAAe,EAAE,2BAA2B,CAAC,iBAAiB,CAAC,CAAC;IAChE,MAAM,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,WAAW;IAC3B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,QAAQ,EAAE,aAAa,CAAC;CACxB;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,gCAAuC,CAAC;AAexE;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,GAAG,WAAW,CAU5F"}

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;IA8BpC,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,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"}

package/dist/{plugin-factory-BC3b3BOy.js → extension-factory-CJkfM4km.js}

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

package/dist/index.d.ts

@@ -6,7 +6,7 @@
 export * from './core';
 export { createChatSDK, type ChatSDKOptions, MCPAppsChatSDK, getChatSDK, getChatSDKSync, resetChatSDK, } from './chat';
 export { createViewSDK, type ViewSDKOptions, MCPAppsViewSDK, getViewSDK, getViewSDKSync, resetViewSDK, } from './view';
-export { createDataSDK, defineDataPlugin, type DataSDKOptions, type DataSDKPlugin, type DataSDKWithPlugins, type WebAppDataSDKOptions, type MosaicDataSDKOptions, type StatusCallback, type NodeOfConnection, gql, } from './data';
+export { createDataSDK, defineDataExtension, type DataSDKOptions, type DataSDKExtension, type DataSDKWithExtensions, 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';

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,gBAAgB,EAChB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,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,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,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,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,eAAe,EACf,YAAY,EACZ,aAAa,EACb,KAAK,SAAS,EACd,KAAK,gBAAgB,GACrB,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -1,10 +1,10 @@
-import { M as a, a as t, S as p, g as o, i as s, b as i, r as S } from "./surface-Dd2tqrPi.js";
+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 { g as c } from "./capabilities-5BWkCbcP.js";
-import { w as g } from "./sdk-promise-D0sy7OW1.js";
-import { c as l } from "./plugin-factory-BC3b3BOy.js";
-import { MCPAppsChatSDK as K, createChatSDK as x, getChatSDK as A, getChatSDKSync as C, resetChatSDK as d } from "./chat/index.js";
-import { MCPAppsViewSDK as P, createViewSDK as w, getViewSDK as y, getViewSDKSync as T, resetViewSDK as h } from "./view/index.js";
-import { createDataSDK as V, defineDataPlugin as b, gql as E } from "./data/index.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";
@@ -12,35 +12,35 @@ 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";
 export {
   K as MCPAppsChatSDK,
-  P as MCPAppsViewSDK,
-  a as McpAppsNotAvailableError,
-  t as McpAppsSession,
+  y as MCPAppsViewSDK,
+  t as McpAppsNotAvailableError,
+  a as McpAppsSession,
   j as PFT_META_KEY,
-  p as Surface,
+  o as Surface,
   N as TelemetryUploader,
   U as WebAppCurrentApp,
   k as createAnalytics,
-  x as createChatSDK,
-  V as createDataSDK,
+  l as createChatSDK,
+  P as createDataSDK,
+  g as createExtensionFactory,
   F as createLightningSDK,
-  l as createPluginFactory,
   z as createTelemetryTransport,
-  w as createViewSDK,
-  b as defineDataPlugin,
+  T as createViewSDK,
+  V as defineDataExtension,
   A as getChatSDK,
   C as getChatSDKSync,
   _ as getCurrentApp,
   c as getSurfaceCapabilities,
-  o as getVerifiedSurface,
-  y as getViewSDK,
-  T as getViewSDKSync,
-  E as gql,
+  p as getVerifiedSurface,
+  h as getViewSDK,
+  u as getViewSDKSync,
+  b as gql,
   s as initialize,
   i as isSfEmbeddingIframe,
   W as registerTelemetryUploader,
   d as resetChatSDK,
   S as resetSurface,
-  h as resetViewSDK,
+  E as resetViewSDK,
   B as validatePftId,
-  g as wrapSDKPromise
+  n as wrapSDKPromise
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/platform-sdk",
-  "version": "11.64.0",
+  "version": "11.66.2",
   "license": "SEE LICENSE IN LICENSE.txt",
   "type": "module",
   "main": "./dist/index.js",
@@ -26,8 +26,8 @@
       "data": [
         "./dist/data/index.d.ts"
       ],
-      "data/plugins": [
-        "./dist/data/plugins/index.d.ts"
+      "data/extensions": [
+        "./dist/data/extensions/index.d.ts"
       ],
       "lightning": [
         "./dist/lightning/index.d.ts"
@@ -75,10 +75,10 @@
       "import": "./dist/data/index.js",
       "default": "./dist/data/index.js"
     },
-    "./data/plugins": {
-      "types": "./dist/data/plugins/index.d.ts",
-      "import": "./dist/data/plugins/index.js",
-      "default": "./dist/data/plugins/index.js"
+    "./data/extensions": {
+      "types": "./dist/data/extensions/index.d.ts",
+      "import": "./dist/data/extensions/index.js",
+      "default": "./dist/data/extensions/index.js"
     },
     "./lightning": {
       "types": "./dist/lightning/index.d.ts",
@@ -134,7 +134,7 @@
     "@conduit-client/service-pubsub": "3.19.6",
     "@conduit-client/service-retry": "3.19.6",
     "@conduit-client/utils": "3.19.6",
-    "@salesforce/jsonrpc": "^11.64.0",
+    "@salesforce/jsonrpc": "^11.66.2",
     "@salesforce/sf-embedding-bridge": "2.2.5-rc.2"
   },
   "peerDependencies": {

package/dist/core/plugin-attach.d.ts

@@ -1,46 +0,0 @@
-import { ExtendedSDK, PluginsFor } from './plugin-types';
-/**
- * Run each plugin's `setup` in array order and mount the returned namespace
- * under the entry's effective mount name — its `name`, or its `as` alias when
- * the entry is `{ plugin, as }`. `setup` may be sync or async; each is `await`ed
- * before the next runs, so the ordering is deterministic.
- *
- * Aliasing rebinds only the mount key: `setup` still runs on the underlying
- * plugin, so two plugins that both declare `name: "labels"` can attach under
- * distinct keys (`{ plugin: a, as: "x" }`, `{ plugin: b, as: "y" }`). See
- * {@link resolveEntry} for the bare-vs-aliased narrowing and the loud guard
- * against a malformed entry from untyped JavaScript.
- *
- * Each `setup` receives the base SDK, and that is all the type promises it:
- * `setup(sdk)` is typed as `Base`, never the accumulating shape. Because every
- * namespace mounts onto one shared object (below), a later plugin *can* reach
- * an earlier plugin's namespace at runtime — but that reachability is an
- * untyped byproduct, not a WI-1 contract to build on. Typed cross-plugin
- * access (a plugin declaring the namespaces it needs and receiving them in
- * `setup`) is WI-3, via the reserved `Deps` seam on {@link Plugin}; until then,
- * author setups as independent.
- *
- * Atomic and non-mutating: namespaces mount onto a fresh object whose prototype
- * is `base`, so the base's own and inherited members resolve through the
- * prototype chain (and `instanceof` still holds) while `base` itself is never
- * written to. If any `setup` throws, the half-built object is simply discarded
- * and `base` is left pristine — there is nothing to roll back. This keeps
- * attach safe against a memoized/shared instance (e.g. the chat/view
- * singletons WI-4 introduces): each attach derives its own object, so a repeat
- * attach can never collide with a prior one. The empty-plugin case returns the
- * base instance unchanged.
- *
- * SDK-agnostic: `Base` is inferred from the passed instance, and `plugins` is
- * constrained to {@link PluginsFor}<Base> so only plugins compatible with this
- * base type may attach. The returned type is {@link ExtendedSDK}<Base, Plugins>
- * — the base plus each plugin's resolved namespace under its own key.
- *
- * Fail-loud: a malformed entry (no `setup`, or a non-string/empty mount name),
- * a mount name in `reservedNames` (names the caller declares off-limits),
- * already present on the base (own or inherited), or mounted earlier in this
- * same call throws before setup runs, and a `setup` that throws or rejects
- * surfaces as an error naming the plugin, chaining the original error via
- * `cause`.
- */
-export declare function attachPlugins<Base extends object, const Plugins extends PluginsFor<Base>>(base: Base, plugins: Plugins, reservedNames?: ReadonlySet<string>): Promise<ExtendedSDK<Base, Plugins>>;
-//# sourceMappingURL=plugin-attach.d.ts.map

package/dist/core/plugin-attach.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin-attach.d.ts","sourceRoot":"","sources":["../../src/core/plugin-attach.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAiB,WAAW,EAAU,UAAU,EAAE,MAAM,gBAAgB,CAAC;AA0CrF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAsB,aAAa,CAAC,IAAI,SAAS,MAAM,EAAE,KAAK,CAAC,OAAO,SAAS,UAAU,CAAC,IAAI,CAAC,EAC9F,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,OAAO,EAIhB,aAAa,GAAE,WAAW,CAAC,MAAM,CAAqB,GACpD,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAoErC"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"plugin-factory.d.ts","sourceRoot":"","sources":["../../src/core/plugin-factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,MACT,KAAK,CAAC,IAAI,SAAS,MAAM,EAAE,GAAG,EAC1D,QAAQ,MAAM,CAAC,GAAG,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,KACzC,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,CAGzB"}

package/dist/core/plugin-types.d.ts

@@ -1,208 +0,0 @@
-/**
- * Copyright (c) 2026, Salesforce, Inc.,
- * All rights reserved.
- * For full license text, see the LICENSE.txt file
- */
-/**
- * A plugin: a named namespace factory bound to a base SDK instance at attach
- * time. SDK-agnostic — `Sdk` is the base type this plugin's `setup` requires.
- *
- * The contract does not depend on any concrete SDK. Enforcement of a specific
- * SDK happens at attach time via {@link PluginsFor}: a plugin is attachable to
- * a base `B` only where `B` is assignable to `Sdk`. So authoring
- * `setup(sdk: DataSDK)` type-checks the plugin against DataSDK when it is
- * attached through `createDataSDK`, even though `Plugin` itself never imports
- * DataSDK.
- *
- * Reserved — `Deps` (inert in WI-1): the trailing type parameter is the seam
- * for WI-3 plugin dependencies. It defaults to `[]` and is referenced only
- * through `setup`'s parameter, as `Sdk & Accumulate<Deps>`. With the default
- * empty tuple `Accumulate<[]>` is `unknown`, and `Sdk & unknown` reduces to
- * `Sdk`, so `setup` sees exactly the base SDK — a three-argument
- * `Plugin<Sdk, Name, Api>` (see {@link AnyPlugin}, {@link PluginsFor}) is
- * unchanged and no WI-1 plugin's type shifts. There is no `deps` field yet, so
- * `attach` has no dependency to honor or silently drop.
- *
- * Threading it through `setup` (rather than leaving it dangling) is deliberate:
- * an unreferenced reserved type parameter is not free — it trips
- * `noUnusedLocals`. This makes the slot load-bearing while behaviorally a
- * no-op. WI-3's add-back is then a pure superset: add a `deps?: Deps` field and
- * populate the tuple, and the already-wired `setup` view lights up. The spike
- * notes the superset holds with or without this slot, so it is kept as an
- * explicit intent marker, not a forward-compat necessity.
- */
-export interface Plugin<Sdk, Name extends string, Api, Deps extends readonly AnyPlugin[] = []> {
-    /** The single namespace key this plugin mounts under (e.g. "labels"). */
-    name: Name;
-    /**
-     * Build the plugin API. Runs at attach time with the fully-resolved,
-     * instance-bound base SDK. May be synchronous or async — return the API
-     * directly, or a promise of it (e.g. to `await` a dynamic import or a
-     * capability handshake). The resolved `Api` is what mounts under `name`.
-     *
-     * `sdk` is `Sdk & Accumulate<Deps>`; with the reserved `Deps = []` this is
-     * just `Sdk` today (see the `Deps` note above). WI-3 populates `Deps` so a
-     * plugin's declared dependencies' namespaces appear here.
-     */
-    setup: (sdk: Sdk & Accumulate<Deps>) => Api | PromiseLike<Api>;
-}
-/** True iff `T` is a union of two or more members. */
-type IsUnion<T, U = T> = T extends unknown ? ([U] extends [T] ? false : true) : never;
-/**
- * Reject a `name` that is not a single string literal. A concrete literal
- * (`"labels"`) passes through unchanged; anything else collapses to `never`, so
- * the authoring helpers error at definition time rather than silently losing key
- * accumulation. See {@link createPluginFactory}.
- *
- * Two shapes are rejected, both of which would otherwise mount phantom keys:
- *   - a widened `string` (`string extends Name`) — no literal key to accumulate;
- *   - a union literal (`"a" | "b"`, e.g. from `name: cond ? "a" : "b"`) — this
- *     survives the `string extends Name` check, but {@link Accumulate}
- *     distributes over the union and types *both* `a` and `b` as present,
- *     non-optional members while `attach` mounts only one, leaving the other
- *     typed-present yet `undefined` at runtime. Requiring a single literal is
- *     what keeps the accumulated key set sound.
- */
-export type LiteralName<Name extends string> = string extends Name ? never : IsUnion<Name> extends true ? never : Name;
-/**
- * Any plugin, for use in constraints. `never` in the (contravariant) `Sdk`
- * slot makes every concrete `Plugin<...>` assignable to this — it is the top
- * type over the SDK parameter.
- */
-export type AnyPlugin = Plugin<never, string, unknown>;
-/**
- * Rebind a plugin's mount point: attach `plugin` under `as` instead of its own
- * `name`. This is the consumer's recourse for a collision they didn't cause —
- * two uneditable third-party plugins that both mount `sdk.labels` can each be
- * aliased to a distinct key. Aliasing rebinds the mount *key* only, never the
- * plugin's identity, which is what keeps identity-based dependency resolution
- * (a later WI) robust to it.
- *
- * `As` is intentionally the raw alias literal, NOT `LiteralName<As>`: pinning
- * `LiteralName` here would collapse the constraint form `AliasedPlugin<_,
- * string>` (used in {@link PluginsFor}) to `as: never` and reject every alias.
- * The widened/union-`as` guard is instead applied at the call boundary by
- * {@link ValidAliasNames}, exactly as {@link UniquePluginNames} guards mount
- * uniqueness there — the entry type stays permissive; the boundary validates.
- *
- * `name?: never; setup?: never` reject the mixed shape structurally, mirroring
- * the runtime discriminator. An object carrying a bare plugin's defining
- * members *and* `{ plugin, as }` satisfies both arms of {@link PluginEntry};
- * without these guards {@link MountName} (which tests the aliased arm first)
- * would key it under `as`, while `attach` — discriminating on `"setup" in
- * entry` — mounts the bare plugin under `name`. The `never` fields fail the
- * aliased arm for such an object, so it matches only {@link Plugin} and both
- * sides agree on `name`. Unlike the `LiteralName` case above, these are fixed
- * optional-never fields independent of `P`/`As`, so a real `{ plugin, as }`
- * entry (which omits them) leaves the `PluginsFor` constraint form intact.
- */
-export interface AliasedPlugin<P extends AnyPlugin, As extends string> {
-    plugin: P;
-    as: As;
-    name?: never;
-    setup?: never;
-}
-/** Any aliased entry, for use in unions/constraints (cf. {@link AnyPlugin}). */
-type AnyAliasedPlugin = AliasedPlugin<AnyPlugin, string>;
-/**
- * The `plugins: []` array constraint that enforces a concrete base SDK. A bare
- * `Plugin<Sdk, Name, Api>` — or an {@link AliasedPlugin} wrapping one — is a
- * member iff a `Base` value is assignable to the (inner) plugin's `setup`
- * parameter, i.e. the plugin asks for no more than `Base` provides (a plugin
- * that ignores the SDK, `Sdk = unknown`, is universally attachable).
- * `createDataSDK` binds `Base = DataSDK`; that is where DataSDK-specific
- * enforcement occurs.
- */
-export type PluginsFor<Base> = readonly (Plugin<Base, string, unknown> | AliasedPlugin<Plugin<Base, string, unknown>, string>)[];
-/**
- * What may appear in the `plugins: []` array: a bare plugin, or a bare plugin
- * wrapped with an `{ as }` alias. Everything downstream ({@link Accumulate},
- * {@link DuplicateMountName}, {@link ExtendedSDK}) is written against
- * `PluginEntry` and routes through {@link PluginOf}/{@link MountName}, so the
- * bare-vs-aliased distinction is resolved in exactly those two helpers and
- * nowhere else.
- */
-export type PluginEntry = AnyPlugin | AnyAliasedPlugin;
-/** The underlying plugin of an entry, whether it was passed bare or aliased. */
-type PluginOf<E extends PluginEntry> = E extends AnyAliasedPlugin ? E["plugin"] : E;
-/**
- * The literal key an entry mounts under: its alias `as` when aliased, else the
- * plugin's own `name`. This is the single place the effective mount key is
- * computed — all mount-name-keyed logic ({@link Accumulate},
- * {@link DuplicateMountName}) routes through it, so aliasing is transparent to
- * them: `[a, a]` (both mount `"labels"`) collides, but `[{ plugin: a, as: "x"
- * }, { plugin: a, as: "y" }]` resolves to distinct keys and does not.
- */
-type MountName<E extends PluginEntry> = E extends AnyAliasedPlugin ? E["as"] : PluginOf<E>["name"];
-/**
- * The resolved API an entry's plugin `setup` returns. `Awaited` unwraps the
- * async case so the mounted namespace is the settled value, never a promise.
- */
-type ApiOf<E extends PluginEntry> = Awaited<ReturnType<PluginOf<E>["setup"]>>;
-/**
- * Walk the plugin tuple left→right, intersecting `{ [name]: namespace }` per
- * entry. Namespaces are non-optional: presence is a static attach fact.
- *
- * This intersects unconditionally: a duplicate mount name would collapse to
- * `{ labels: A } & { labels: B }` here rather than erroring. Uniqueness is not
- * this type's job — it is enforced up front by {@link UniquePluginNames} at the
- * authoring boundary, with `attach`'s runtime guard as the backstop for tuples
- * built dynamically past the static check.
- */
-type Accumulate<Plugins extends readonly PluginEntry[]> = Plugins extends readonly [
-    infer Head extends PluginEntry,
-    ...infer Tail extends readonly PluginEntry[]
-] ? {
-    [K in MountName<Head>]: ApiOf<Head>;
-} & Accumulate<Tail> : unknown;
-/**
- * The first mount name that repeats in the tuple, or `never` if all are
- * distinct. Walks left→right accumulating seen names in `Seen`; the first
- * {@link MountName} already in `Seen` is the duplicate. Keyed on
- * {@link MountName}, so aliasing a clash apart is a valid recourse (see there).
- */
-type DuplicateMountName<Plugins extends readonly PluginEntry[], Seen = never> = Plugins extends readonly [
-    infer Head extends PluginEntry,
-    ...infer Tail extends readonly PluginEntry[]
-] ? [MountName<Head>] extends [Seen] ? MountName<Head> : DuplicateMountName<Tail, Seen | MountName<Head>> : never;
-/**
- * A constraint intersected into the `plugins` option to reject a tuple whose
- * mount names are not unique. Resolves to `unknown` (a no-op intersection) when
- * every mount name is distinct; otherwise to an object whose `plugins` field is
- * a human-readable error string, which makes the supplied array inassignable
- * and surfaces the message in the diagnostic.
- *
- * This moves the collision from a runtime throw (`attach` fail-loud) to a
- * compile error at the call site. The two are complementary, not redundant:
- * this catches statically-known tuples early with a clear message, while
- * `attach` still guards tuples assembled dynamically (e.g. `[...a, ...b]`)
- * whose duplicates a static check cannot see.
- */
-export type UniquePluginNames<Plugins extends readonly PluginEntry[]> = [
-    DuplicateMountName<Plugins>
-] extends [never] ? unknown : {
-    plugins: `Two plugins mount under "${DuplicateMountName<Plugins> & string}"; mount names must be unique.`;
-};
-/**
- * A constraint intersected into the `plugins` option to reject an aliased entry
- * whose `as` is not a single string literal — the same soundness bar
- * {@link LiteralName} applies to a plugin's `name` (see there for why a widened
- * or union `as` would mount a phantom namespace). Applied at the boundary rather
- * than on {@link AliasedPlugin} for the reason that type documents. Resolves to
- * `unknown` or an inassignable `{ plugins }` error exactly as
- * {@link UniquePluginNames} does.
- */
-export type ValidAliasNames<Plugins extends readonly PluginEntry[]> = Plugins extends readonly [
-    infer Head extends PluginEntry,
-    ...infer Tail extends readonly PluginEntry[]
-] ? Head extends AnyAliasedPlugin ? [LiteralName<Head["as"]>] extends [never] ? {
-    plugins: `An alias "as" must be a single string literal, not a widened or union type.`;
-} : ValidAliasNames<Tail> : ValidAliasNames<Tail> : unknown;
-/** Collapse an intersection into a single flat object type for readable hovers. */
-type Flatten<T> = {
-    [K in keyof T]: T[K];
-} & {};
-/** The base SDK plus every attached plugin's namespace. */
-export type ExtendedSDK<Base, Plugins extends readonly PluginEntry[]> = Flatten<Base & Accumulate<Plugins>>;
-export {};
-//# sourceMappingURL=plugin-types.d.ts.map

package/dist/core/plugin-types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin-types.d.ts","sourceRoot":"","sources":["../../src/core/plugin-types.ts"],"names":[],"mappings":"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"}

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

@@ -1,19 +0,0 @@
-/**
- * Copyright (c) 2026, Salesforce, Inc.,
- * All rights reserved.
- * For full license text, see the LICENSE.txt file
- */
-/**
- * First-party DataSDK plugin catalog. Import plugins from this subpath and
- * attach them via `createDataSDK({ plugins: [...] })`:
- *
- * ```typescript
- * import { createDataSDK } from "@salesforce/platform-sdk/data";
- * import { labelsPlugin } from "@salesforce/platform-sdk/data/plugins";
- *
- * const sdk = await createDataSDK({ plugins: [labelsPlugin({ namespace: "MyApp" })] });
- * ```
- */
-export { labelsPlugin } from './labels';
-export type { LabelsApi, LabelsOptions, LabelFallback } from './labels';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/data/plugins/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;GAUG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC"}

package/dist/data/plugins/labels/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/data/plugins/labels/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAA0B,KAAK,aAAa,EAAiB,MAAM,SAAS,CAAC;AACpF,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAEnE,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC7B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC;CACzB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,SAAS;IACzB;;;;;;OAMG;IACH,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACzE;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC5F;AAgBD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,YAAY,CAAC,MAAM,GAAE,aAAkB,GAAG,aAAa,CAAC,QAAQ,EAAE,SAAS,CAAC,CAsD3F"}

package/dist/data/plugins/labels/query.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../../src/data/plugins/labels/query.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,OAAO,EAAgB,MAAM,eAAe,CAAC;AAE3D;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,cAAc,GAAG,MAAM,CAAC;AAEnE;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAA4B,CAAC;AAiIlE,oEAAoE;AACpE,KAAK,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;AA6D/C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,aAAa,CAClC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,QAAQ,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAuBjC"}

package/dist/data/reserved.d.ts

@@ -1,3 +0,0 @@
-/** The names `DataSDK` declares, as a runtime lookup set. */
-export declare const DATA_SDK_RESERVED_NAMES: ReadonlySet<string>;
-//# sourceMappingURL=reserved.d.ts.map

package/dist/data/reserved.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"reserved.d.ts","sourceRoot":"","sources":["../../src/data/reserved.ts"],"names":[],"mappings":"AAmBA,6DAA6D;AAC7D,eAAO,MAAM,uBAAuB,EAAE,WAAW,CAAC,MAAM,CAA2C,CAAC"}