@salesforce/platform-sdk 11.49.4 → 11.50.0

package/dist/core/index.d.ts

@@ -17,4 +17,6 @@ export type { McpAppsHostContext, McpAppsSessionOptions } from './mcpapps-sessio
 export { getSurfaceCapabilities } from './capabilities';
 export type { SurfaceCapabilities } from './capabilities';
 export { wrapSDKPromise } from './sdk-promise';
+export { createPluginFactory } from './plugin-factory';
+export type { Plugin, AnyPlugin, PluginsFor, PluginEntry, ExtendedSDK, LiteralName, UniquePluginNames, } from './plugin-types';
 //# sourceMappingURL=index.d.ts.map

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,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"}
+{"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;AAO/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,YAAY,EACX,MAAM,EACN,SAAS,EACT,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,iBAAiB,GACjB,MAAM,gBAAgB,CAAC"}

package/dist/core/index.js

@@ -1,14 +1,16 @@
-import { M as r, a as s, S as i, g as p, i as f, b as o, r as t } from "../surface-Dd2tqrPi.js";
-import { g as c } from "../capabilities-5BWkCbcP.js";
+import { M as r, a as s, S as i, g as o, i as p, b as t, r as f } from "../surface-Dd2tqrPi.js";
+import { g as S } from "../capabilities-5BWkCbcP.js";
 import { w as g } from "../sdk-promise-D0sy7OW1.js";
+import { c as u } from "../plugin-factory-BC3b3BOy.js";
 export {
   r as McpAppsNotAvailableError,
   s as McpAppsSession,
   i as Surface,
-  c as getSurfaceCapabilities,
-  p as getVerifiedSurface,
-  f as initialize,
-  o as isSfEmbeddingIframe,
-  t as resetSurface,
+  u as createPluginFactory,
+  S as getSurfaceCapabilities,
+  o as getVerifiedSurface,
+  p as initialize,
+  t as isSfEmbeddingIframe,
+  f as resetSurface,
   g as wrapSDKPromise
 };

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

@@ -0,0 +1,37 @@
+import { ExtendedSDK, PluginsFor } from './plugin-types';
+/**
+ * Run each plugin's `setup` in array order and mount the returned namespace
+ * under the plugin's `name`. `setup` may be sync or async; each is `await`ed
+ * before the next runs, so the ordering is deterministic.
+ *
+ * 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 name 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): Promise<ExtendedSDK<Base, Plugins>>;
+//# sourceMappingURL=plugin-attach.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-attach.d.ts","sourceRoot":"","sources":["../../src/core/plugin-attach.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAsB,aAAa,CAAC,IAAI,SAAS,MAAM,EAAE,KAAK,CAAC,OAAO,SAAS,UAAU,CAAC,IAAI,CAAC,EAC9F,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,OAAO,GACd,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CA2DrC"}

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

@@ -0,0 +1,42 @@
+import { LiteralName, Plugin } from './plugin-types';
+/**
+ * Bind a plugin authoring helper to one SDK surface, so authors never annotate
+ * `setup`'s parameter. `createPluginFactory<Sdk>()` captures the base SDK once
+ * and returns a definer; each call to that definer infers only the plugin's
+ * literal `Name` and its `Api`, with `setup(sdk)` already typed as `Sdk`:
+ *
+ * ```ts
+ * const defineDataPlugin = createPluginFactory<DataSDK>();
+ * const labels = defineDataPlugin({ name: "labels", setup: (sdk) => ({ ... }) });
+ * ```
+ *
+ * `createDataSDK` exposes the DataSDK-bound definer as `defineDataPlugin`. 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 `definePlugin<Sdk, Name, Api>`?
+ *
+ * The obvious alternative is one generic function whose caller fixes the SDK:
+ * `definePlugin<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 plugin. And a *forgotten*
+ * annotation does not error — it silently infers `Sdk = unknown`, a
+ * universally-attachable binding that slips a surface-specific plugin past the
+ * per-surface {@link PluginsFor} 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 plugin object. `Sdk` is fixed before
+ * any plugin 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 createPluginFactory<Sdk>(): <const Name extends string, Api>(plugin: Plugin<Sdk, LiteralName<Name>, Api>) => Plugin<Sdk, Name, Api>;
+//# sourceMappingURL=plugin-factory.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,158 @@
+/**
+ * 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>;
+/**
+ * The `plugins: []` array constraint that enforces a concrete base SDK. A
+ * `Plugin<Sdk, Name, Api>` is a member iff a `Base` value is assignable
+ * to its `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>[];
+/**
+ * What may appear in the `plugins: []` array. A one-member alias today — bare
+ * plugins only — and deliberately the seam for WI-5 aliasing: that WI widens it
+ * to `AnyPlugin | AnyAliasedPlugin` so two uneditable third-party plugins that
+ * both want the same namespace (e.g. `sdk.labels`) each get a mount recourse.
+ * Everything downstream ({@link Accumulate}, {@link ExtendedSDK}) is written
+ * against `PluginEntry`, so the union lands here and nowhere else.
+ */
+export type PluginEntry = AnyPlugin;
+/**
+ * The literal key a plugin mounts under. Today that is exactly its `name`;
+ * WI-5 aliasing resolves an entry's `as` over `name` here, so this stays the
+ * single place the effective mount key is computed. All mount-name-keyed logic
+ * ({@link Accumulate}, {@link DuplicateMountName}) routes through this rather
+ * than reading `name` directly, so aliased entries resolve correctly for free
+ * once WI-5 lands.
+ */
+type MountName<P extends AnyPlugin> = P["name"];
+/**
+ * The resolved API a plugin's `setup` returns. `Awaited` unwraps the async
+ * case so the mounted namespace is the settled value, never a promise.
+ */
+type ApiOf<P extends AnyPlugin> = Awaited<ReturnType<P["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 `MountName`,
+ * not raw `name`, so WI-5 aliasing is a valid recourse: `[a, a]` (both mount
+ * `"labels"`) reports `"labels"`, but `[{ plugin: a, as: "x" }, { plugin: a, as:
+ * "y" }]` resolves to distinct mount names and reports `never`.
+ */
+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.`;
+};
+/** 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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-types.d.ts","sourceRoot":"","sources":["../../src/core/plugin-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,MAAM,CAAC,GAAG,EAAE,IAAI,SAAS,MAAM,EAAE,GAAG,EAAE,IAAI,SAAS,SAAS,SAAS,EAAE,GAAG,EAAE;IAC5F,yEAAyE;IACzE,IAAI,EAAE,IAAI,CAAC;IACX;;;;;;;;;OASG;IACH,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;CAC/D;AAED,sDAAsD;AACtD,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC;AAEtF;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,WAAW,CAAC,IAAI,SAAS,MAAM,IAAI,MAAM,SAAS,IAAI,GAC/D,KAAK,GACL,OAAO,CAAC,IAAI,CAAC,SAAS,IAAI,GACzB,KAAK,GACL,IAAI,CAAC;AAET;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAEvD;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,CAAC,IAAI,IAAI,SAAS,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;AAExE;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,CAAC;AAEpC;;;;;;;GAOG;AACH,KAAK,SAAS,CAAC,CAAC,SAAS,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhD;;;GAGG;AACH,KAAK,KAAK,CAAC,CAAC,SAAS,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAElE;;;;;;;;;GASG;AACH,KAAK,UAAU,CAAC,OAAO,SAAS,SAAS,WAAW,EAAE,IAAI,OAAO,SAAS,SAAS;IAClF,MAAM,IAAI,SAAS,WAAW;IAC9B,GAAG,MAAM,IAAI,SAAS,SAAS,WAAW,EAAE;CAC5C,GACE;KAAG,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC;CAAE,GAAG,UAAU,CAAC,IAAI,CAAC,GAC1D,OAAO,CAAC;AAEX;;;;;;;GAOG;AACH,KAAK,kBAAkB,CACtB,OAAO,SAAS,SAAS,WAAW,EAAE,EACtC,IAAI,GAAG,KAAK,IACT,OAAO,SAAS,SAAS;IAC5B,MAAM,IAAI,SAAS,WAAW;IAC9B,GAAG,MAAM,IAAI,SAAS,SAAS,WAAW,EAAE;CAC5C,GACE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,GAC/B,SAAS,CAAC,IAAI,CAAC,GACf,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,GACjD,KAAK,CAAC;AAET;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,iBAAiB,CAAC,OAAO,SAAS,SAAS,WAAW,EAAE,IAAI;IACvE,kBAAkB,CAAC,OAAO,CAAC;CAC3B,SAAS,CAAC,KAAK,CAAC,GACd,OAAO,GACP;IACA,OAAO,EAAE,4BAA4B,kBAAkB,CAAC,OAAO,CAAC,GAC/D,MAAM,gCAAgC,CAAC;CACxC,CAAC;AAEJ,mFAAmF;AACnF,KAAK,OAAO,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG,EAAE,CAAC;AAEhD,2DAA2D;AAC3D,MAAM,MAAM,WAAW,CAAC,IAAI,EAAE,OAAO,SAAS,SAAS,WAAW,EAAE,IAAI,OAAO,CAC9E,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,CAC1B,CAAC"}

package/dist/data/index.d.ts

@@ -1,4 +1,4 @@
-import { DataSDK, SDKOptions } from '../core';
+import { DataSDK, ExtendedSDK, Plugin, SDKOptions, UniquePluginNames } from '../core';
 import { MosaicDataSDKOptions } from './mosaic';
 /**
  * A callback the host invokes for a given HTTP status (see {@link WebAppDataSDKOptions.onStatus}).
@@ -21,6 +21,25 @@ export interface WebAppDataSDKOptions {
     onStatus?: Partial<Record<number, StatusCallback>>;
 }
 export type { MosaicDataSDKOptions };
+/**
+ * A plugin authored for the DataSDK surface: {@link Plugin} with the base SDK
+ * pre-applied to `DataSDK`. Author these with {@link defineDataPlugin}.
+ */
+export type DataSDKPlugin<Name extends string = string, Api = unknown> = Plugin<DataSDK, Name, Api>;
+/**
+ * Author a DataSDK plugin without annotating `setup`'s parameter — the base
+ * SDK is bound to `DataSDK`, so `setup(sdk)` infers `sdk: DataSDK`. This is the
+ * recommended way to author DataSDK plugins.
+ *
+ * Because `DataSDK` is fixed here, an author can never forget the annotation
+ * and silently get `Sdk = unknown` — the universally-attachable binding that
+ * would slip a DataSDK-only plugin past the per-surface `PluginsFor` guard.
+ * Equivalent to the internal `definePlugin` with `Sdk = DataSDK` pre-applied;
+ * see {@link createPluginFactory} for the underlying mechanism.
+ */
+export declare const defineDataPlugin: <const Name extends string, Api>(plugin: Plugin<DataSDK, import('..').LiteralName<Name>, Api, []>) => Plugin<DataSDK, Name, Api, []>;
+/** A DataSDK carrying every namespace contributed by an ordered plugin tuple. */
+export type DataSDKWithPlugins<Plugins extends readonly DataSDKPlugin[]> = ExtendedSDK<DataSDK, Plugins>;
 /**
  * Options for creating a DataSDK instance.
  */
@@ -35,16 +54,22 @@ export interface DataSDKOptions extends SDKOptions {
      * @example { instanceUrl: "https://my.salesforce.com", accessToken: "00D..." }
      */
     mosaic?: MosaicDataSDKOptions;
+    plugins?: readonly DataSDKPlugin[];
 }
 /**
  * Create and initialize a DataSDK instance based on the detected surface.
  *
- * @param options - Optional configuration including surface override and web app options
- * @returns Promise resolving to an initialized DataSDK instance
+ * @param options - Optional configuration including surface override, web app
+ *   options, and plugins to attach
+ * @returns Promise resolving to an initialized DataSDK, extended per plugin
  *
  * @remarks
  * Each call creates a new instance; options are applied to every call.
  *
+ * When `plugins` is supplied, the result type accumulates each plugin's
+ * namespace under its own key (see {@link DataSDKWithPlugins}); otherwise it is
+ * a plain {@link DataSDK}.
+ *
  * If the surface is unusable (e.g. MCPApps handshake never succeeded, or detection throws),
  * the function resolves to a bare `{}` rather than rejecting, so the host still renders.
  * Feature-detect `sdk.graphql` / `sdk.fetch` before use.
@@ -69,7 +94,9 @@ export interface DataSDKOptions extends SDKOptions {
  * }
  * ```
  */
-export declare function createDataSDK(options?: DataSDKOptions): Promise<DataSDK>;
+export declare function createDataSDK<const Plugins extends readonly DataSDKPlugin[] = []>(options?: Omit<DataSDKOptions, "plugins"> & {
+    plugins?: Plugins;
+} & UniquePluginNames<Plugins>): Promise<DataSDKWithPlugins<Plugins>>;
 export { gql } from './gql';
 export type { CacheControl, DataSDK, DataSDKGraphQL, GraphQLError, GraphQLRawDocument, GraphQLRequest, GraphQLRequestHeaders, GraphQLResponse, MutateOptions, MutationResult, QueryOptions, QueryResult, QuerySubscriber, SDKOptions, Unsubscribe, } from '../core';
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAiB,KAAK,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAIpE;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;CACnD;AAED,YAAY,EAAE,oBAAoB,EAAE,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,UAAU;IACjD;;;OAGG;IACH,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B;;;OAGG;IACH,MAAM,CAAC,EAAE,oBAAoB,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CA2BxE;AAED,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,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,UAAU,EACV,WAAW,GACX,MAAM,SAAS,CAAC;AAEjB;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,CAAC,SAAS;IAC3C,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC;CAC3B,GAAG,IAAI,GACL,CAAC,SAAS;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,IAAI,GAClC,CAAC,GACD,KAAK,GACN,KAAK,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC3F,OAAO,EAAiB,KAAK,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAKpE;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;CACnD;AAED,YAAY,EAAE,oBAAoB,EAAE,CAAC;AAErC;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM,EAAE,GAAG,GAAG,OAAO,IAAI,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;AAEpG;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,sIAAiC,CAAC;AAE/D,iFAAiF;AACjF,MAAM,MAAM,kBAAkB,CAAC,OAAO,SAAS,SAAS,aAAa,EAAE,IAAI,WAAW,CACrF,OAAO,EACP,OAAO,CACP,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,UAAU;IACjD;;;OAGG;IACH,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B;;;OAGG;IACH,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,OAAO,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;CACnC;AAqCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAkBH,wBAAgB,aAAa,CAAC,KAAK,CAAC,OAAO,SAAS,SAAS,aAAa,EAAE,GAAG,EAAE,EAChF,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,iBAAiB,CAAC,OAAO,CAAC,GAC5F,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;AAcxC,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,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,UAAU,EACV,WAAW,GACX,MAAM,SAAS,CAAC;AAEjB;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,CAAC,SAAS;IAC3C,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC;CAC3B,GAAG,IAAI,GACL,CAAC,SAAS;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,IAAI,GAClC,CAAC,GACD,KAAK,GACN,KAAK,CAAC"}

package/dist/data/index.js

@@ -1,15 +1,16 @@
-import { g as x, S as y } from "../surface-Dd2tqrPi.js";
-import { w as G } from "../sdk-promise-D0sy7OW1.js";
+import { g as V, S as y } from "../surface-Dd2tqrPi.js";
+import { w as x } from "../sdk-promise-D0sy7OW1.js";
+import { c as G } from "../plugin-factory-BC3b3BOy.js";
 import { buildServiceDescriptor as L, setHeader as b } from "@conduit-client/service-fetch-network/v1";
-import { resolvedPromiseLike as u, ok as E, err as D, stableJSONStringify as K, DataNotFoundError as Q, UserVisibleError as z, deepFreeze as v, isUserVisibleError as j } from "@conduit-client/utils";
-import { print as k, parse as W } from "@conduit-client/onestore-graphql-parser/v1";
-import { RetryPolicy as B, buildServiceDescriptor as J } from "@conduit-client/service-retry/v1";
-import { buildServiceDescriptor as X } from "@conduit-client/service-cache/v1";
-import { buildServiceDescriptor as Y } from "@conduit-client/service-cache-control/v1";
-import { buildInMemoryCacheInclusionPolicyService as Z } from "@conduit-client/service-cache-inclusion-policy/v1";
-import { buildServiceDescriptor as ee } from "@conduit-client/service-pubsub/v1";
-import { HttpCacheControlCommand as re } from "@conduit-client/command-http-cache-control/v1";
-function te(r) {
+import { resolvedPromiseLike as u, ok as C, err as D, stableJSONStringify as Q, DataNotFoundError as z, UserVisibleError as j, deepFreeze as v, isUserVisibleError as W } from "@conduit-client/utils";
+import { print as A, parse as B } from "@conduit-client/onestore-graphql-parser/v1";
+import { RetryPolicy as J, buildServiceDescriptor as X } from "@conduit-client/service-retry/v1";
+import { buildServiceDescriptor as Y } from "@conduit-client/service-cache/v1";
+import { buildServiceDescriptor as Z } from "@conduit-client/service-cache-control/v1";
+import { buildInMemoryCacheInclusionPolicyService as ee } from "@conduit-client/service-cache-inclusion-policy/v1";
+import { buildServiceDescriptor as re } from "@conduit-client/service-pubsub/v1";
+import { HttpCacheControlCommand as te } from "@conduit-client/command-http-cache-control/v1";
+function ne(r) {
   return (e) => {
     const [t, n] = e;
     if (typeof t == "string" && !t.startsWith("http")) {
@@ -19,21 +20,21 @@ function te(r) {
     return u(e);
   };
 }
-function ne(r) {
+function se(r) {
   return (e) => u(b("Authorization", `Bearer ${r}`, e));
 }
-function se(r, e) {
+function ae(r, e) {
   const t = [];
-  return r && t.push(te(r)), e && t.push(ne(e)), L({
+  return r && t.push(ne(r)), e && t.push(se(e)), L({
     request: t
   }).service;
 }
-const ae = {
+const oe = {
   "Content-Type": "application/json",
   Accept: "application/json",
   "X-Chatter-Entity-Encoding": "false"
 };
-function oe(r) {
+function ie(r) {
   if (r instanceof Headers) {
     const e = [];
     return r.forEach((t, n) => e.push([n, t])), e;
@@ -45,33 +46,33 @@ function M(r, e) {
   const t = { ...r }, n = /* @__PURE__ */ new Map();
   for (const a of Object.keys(t)) n.set(a.toLowerCase(), a);
   const s = /* @__PURE__ */ new Set();
-  for (const [a, i] of oe(e)) {
+  for (const [a, i] of ie(e)) {
     const o = a.toLowerCase(), c = n.get(o);
     c === void 0 ? (t[a] = i, n.set(o, a), s.add(o)) : s.has(o) ? t[c] = `${t[c]}, ${i}` : (t[c] = i, s.add(o));
   }
   return t;
 }
-function H(r) {
-  return M(ae, r);
+function $(r) {
+  return M(oe, r);
 }
-function ie(r) {
+function ce(r) {
   if (r === void 0) return;
   const e = {};
   return new Headers(r).forEach((t, n) => {
     e[n] = t;
   }), Object.keys(e).length > 0 ? e : void 0;
 }
-const S = () => {
-}, A = async () => {
+const g = () => {
+}, P = async () => {
 };
-function q(r) {
+function k(r) {
   try {
-    return E(W(r));
+    return C(B(r));
   } catch (e) {
     return D(d(e));
   }
 }
-function T(r, e) {
+function q(r, e) {
   const t = r.definitions.filter(
     (n) => n.kind === "OperationDefinition"
   );
@@ -85,10 +86,10 @@ function d(r) {
   }
   return r instanceof Error ? [{ message: r.message }] : typeof r == "string" ? [{ message: r }] : [{ message: "Unknown error" }];
 }
-async function I(r, { mutation: e, variables: t, operationName: n, headers: s }) {
-  const a = q(e);
+async function H(r, { mutation: e, variables: t, operationName: n, headers: s }) {
+  const a = k(e);
   if (a.isErr()) return { data: void 0, errors: a.error };
-  const i = a.value, o = T(i, n);
+  const i = a.value, o = q(i, n);
   if (o !== "mutation")
     return {
       data: void 0,
@@ -100,7 +101,7 @@ async function I(r, { mutation: e, variables: t, operationName: n, headers: s })
     };
   try {
     const c = await r({
-      query: k(i),
+      query: A(i),
       variables: t,
       operationName: n,
       headers: s
@@ -113,10 +114,10 @@ async function I(r, { mutation: e, variables: t, operationName: n, headers: s })
     return { data: void 0, errors: d(c) };
   }
 }
-function $(r) {
+function I(r) {
   function e(n, s, a, i) {
     return r({
-      query: k(n),
+      query: A(n),
       variables: s,
       operationName: a,
       headers: i
@@ -134,15 +135,15 @@ function $(r) {
     operationName: a,
     headers: i
   }) {
-    const o = q(n);
+    const o = k(n);
     if (o.isErr())
       return {
         data: void 0,
         errors: o.error,
-        subscribe: () => S,
-        refresh: A
+        subscribe: () => g,
+        refresh: P
       };
-    const c = o.value, f = T(c, a);
+    const c = o.value, f = q(c, a);
     if (f !== "query")
       return {
         data: void 0,
@@ -151,8 +152,8 @@ function $(r) {
             message: `DataSDK.graphql.query() requires a GraphQL query, received ${f}.`
           }
         ],
-        subscribe: () => S,
-        refresh: A
+        subscribe: () => g,
+        refresh: P
       };
     const h = /* @__PURE__ */ new Set(), p = s, m = await e(c, p, a, i);
     return {
@@ -165,30 +166,30 @@ function $(r) {
       },
       async refresh() {
         const l = await e(c, p, a, i);
-        for (const g of h) g(l);
+        for (const S of h) S(l);
       }
     };
   }
   return {
     query: t,
-    mutate: (n) => I(r, n)
+    mutate: (n) => H(r, n)
   };
 }
-const ce = typeof __SF_API_VERSION__ < "u" ? __SF_API_VERSION__ : "65.0";
-function F(r = ce) {
+const ue = typeof __SF_API_VERSION__ < "u" ? __SF_API_VERSION__ : "65.0";
+function F(r = ue) {
   return `/services/data/v${r}`;
 }
-const ue = {
+const he = {
   "Content-Type": "application/json",
   Accept: "application/json"
 };
-class he {
+class le {
   clientFetch;
   pathData;
   graphql;
   constructor(e) {
-    const t = le(), n = de(e?.instanceUrl ?? t.instanceUrl), s = e?.accessToken ?? t.accessToken;
-    this.pathData = F(e?.apiVersion ?? t.apiVersion), this.clientFetch = se(n || void 0, s), this.graphql = $(this.executeRawGraphQL.bind(this));
+    const t = de(), n = fe(e?.instanceUrl ?? t.instanceUrl), s = e?.accessToken ?? t.accessToken;
+    this.pathData = F(e?.apiVersion ?? t.apiVersion), this.clientFetch = ae(n || void 0, s), this.graphql = I(this.executeRawGraphQL.bind(this));
   }
   async executeRawGraphQL({
     query: e,
@@ -199,11 +200,11 @@ class he {
     return (await this.clientFetch(`${this.pathData}/graphql`, {
       method: "POST",
       body: JSON.stringify({ query: e, variables: t, operationName: n }),
-      headers: M(ue, s)
+      headers: M(he, s)
     })).json();
   }
 }
-function le() {
+function de() {
   const r = globalThis.MOSAIC_ENV;
   return {
     instanceUrl: r?.instanceUrl,
@@ -211,16 +212,16 @@ function le() {
     apiVersion: r?.apiVersion
   };
 }
-function de(r) {
+function fe(r) {
   if (!r || r === "/") return "";
   let e = r;
   return !e.startsWith("/") && !e.startsWith("http") && (e = `/${e}`), e.endsWith("/") && (e = e.slice(0, -1)), e;
 }
-const fe = "graphqlQuery";
-class pe {
+const pe = "graphqlQuery";
+class me {
   graphql;
   constructor() {
-    this.graphql = $(this.executeRawGraphQL.bind(this));
+    this.graphql = I(this.executeRawGraphQL.bind(this));
   }
   /**
    * The `headers` request option is intentionally not forwarded: this surface
@@ -232,43 +233,43 @@ class pe {
     variables: t,
     operationName: n
   }) {
-    return (await window.openai.callTool(fe, {
+    return (await window.openai.callTool(pe, {
       query: e,
       ...t != null ? { variables: t } : {},
       ...n != null ? { operationName: n } : {}
     })).structuredContent;
   }
 }
-const w = "Accept-Language", me = (r) => {
+const w = "Accept-Language", ye = (r) => {
   const e = globalThis.SFDC_ENV?.language;
   if (!e)
     return u(r);
   const [t, n] = r;
   return (t instanceof Request && !n?.headers ? t.headers.has(w) : new Headers(n?.headers).has(w)) ? u(r) : u(b(w, e, r));
-}, ye = "X-SFDC-Client-Name", be = "X-SFDC-Client-Version", ve = "@salesforce/platform-sdk", Se = "11.49.4", ge = (r) => {
-  let e = b(ye, ve, r);
-  return e = b(be, Se, e), u(e);
-}, we = "X-CSRF-Token";
+}, be = "X-SFDC-Client-Name", ve = "X-SFDC-Client-Version", ge = "@salesforce/platform-sdk", Se = "11.50.0", we = (r) => {
+  let e = b(be, ge, r);
+  return e = b(ve, Se, e), u(e);
+}, Ee = "X-CSRF-Token";
 function Ce(r, e = {}) {
   const { protectedUrls: t = [], alwaysProtectedUrls: n = [] } = e;
   return async (s) => {
     const [a, i] = s, o = a instanceof Request ? a.url : a instanceof URL ? a.href : a, c = i?.method ?? (a instanceof Request ? a.method : void 0) ?? "GET";
-    if (_(n, o) || Ee(c) && _(t, o)) {
+    if (O(n, o) || De(c) && O(t, o)) {
       const h = await r.getToken();
-      s = b(we, h, s);
+      s = b(Ee, h, s);
     }
     return u(s);
   };
 }
-function Ee(r) {
+function De(r) {
   const e = r.toLowerCase();
   return e === "post" || e === "put" || e === "patch" || e === "delete";
 }
-function _(r, e) {
+function O(r, e) {
   const t = new URL(e, globalThis.location?.href ?? "http://localhost");
   return r.some((n) => t.pathname.includes(n));
 }
-function De(r, e = {}) {
+function Pe(r, e = {}) {
   const t = Ce(r, e);
   async function n(s) {
     const a = await t(s);
@@ -277,7 +278,7 @@ function De(r, e = {}) {
   return (s, a) => a ? a.applyRetry(async () => n(s)) : n(s);
 }
 const Ae = [400, 401, 403];
-class ke extends B {
+class ke extends J {
   constructor(e) {
     super(e), this.csrfTokenManager = e;
   }
@@ -351,29 +352,29 @@ class qe {
       return;
   }
 }
-const O = /* @__PURE__ */ new Map();
-function Te(r) {
+const T = /* @__PURE__ */ new Map();
+function Oe(r) {
   const { endpoint: e, cacheName: t, ...n } = r.csrf;
-  let s = O.get(e);
-  return s || (s = new qe(e, t), O.set(e, s)), L(
+  let s = T.get(e);
+  return s || (s = new qe(e, t), T.set(e, s)), L(
     {
-      retry: De(s, n),
-      request: [ge, me]
+      retry: Pe(s, n),
+      request: [we, ye]
     },
-    J(new ke(s)).service
+    X(new ke(s)).service
   ).service;
 }
-const P = /* @__PURE__ */ new Map();
-function _e(r) {
-  let e = P.get(r);
+const _ = /* @__PURE__ */ new Map();
+function Te(r) {
+  let e = _.get(r);
   if (!e) {
-    const t = X().service, n = Z(t).service, s = Y(t, n).service, a = ee().service;
-    e = { cache: t, cacheController: s, pubSub: a }, P.set(r, e);
+    const t = Y().service, n = ee(t).service, s = Z(t, n).service, a = re().service;
+    e = { cache: t, cacheController: s, pubSub: a }, _.set(r, e);
   }
   return e;
 }
-function Oe(r, e) {
-  const t = _e(r);
+function _e(r, e) {
+  const t = Te(r);
   return {
     shared: t,
     services: {
@@ -384,7 +385,7 @@ function Oe(r, e) {
   };
 }
 const R = 300;
-function Pe(r, e) {
+function Re(r, e) {
   try {
     return JSON.parse(JSON.stringify(r));
   } catch (t) {
@@ -394,19 +395,19 @@ function Pe(r, e) {
     throw s.cause = t, s;
   }
 }
-function Re(r) {
+function Ne(r) {
   if (typeof r == "object" && r.type === "max-age") {
     const e = r.maxAge;
     return Number.isFinite(e) && e >= 0 ? e : R;
   }
   return R;
 }
-class Ne extends re {
+class Le extends te {
   constructor(e, t, n) {
-    super(t), this.url = n, this.query = e.query, this.normalizedOperationName = e.operationName ?? "", this.normalizedVariables = Pe(
+    super(t), this.url = n, this.query = e.query, this.normalizedOperationName = e.operationName ?? "", this.normalizedVariables = Re(
       e.variables ?? {},
       this.normalizedOperationName
-    ), this.cacheControl = e.cacheControl, this.resolvedMaxAge = Re(e.cacheControl), this.headers = e.headers, this.headersKey = ie(e.headers);
+    ), this.cacheControl = e.cacheControl, this.resolvedMaxAge = Ne(e.cacheControl), this.headers = e.headers, this.headersKey = ce(e.headers);
   }
   query;
   normalizedVariables;
@@ -420,7 +421,7 @@ class Ne extends re {
       this.url,
       {
         method: "POST",
-        headers: H(this.headers),
+        headers: $(this.headers),
         body: JSON.stringify({
           query: this.query,
           variables: this.normalizedVariables,
@@ -435,7 +436,7 @@ class Ne extends re {
       variables: this.normalizedVariables,
       operationName: this.normalizedOperationName
     };
-    return this.headersKey !== void 0 && (e.headers = this.headersKey), K(e);
+    return this.headersKey !== void 0 && (e.headers = this.headersKey), Q(e);
   }
   /**
    * Reads from the cache and returns the cache result or error
@@ -452,7 +453,7 @@ class Ne extends re {
    */
   readFromCache(e) {
     const t = this.buildKey(), n = e.get(t)?.value;
-    return n === void 0 ? u(D(new Q())) : u(E(n));
+    return n === void 0 ? u(D(new z())) : u(C(n));
   }
   writeToCache(e, t) {
     if (t.isOk() && t.value.data != null && Object.keys(t.value.data).length > 0) {
@@ -482,17 +483,17 @@ class Ne extends re {
     return e.errors && e.errors.length > 0;
   }
   processFetchReturnValue(e) {
-    return this.responseHasErrors(e) ? D(new z(e)) : E(e);
+    return this.responseHasErrors(e) ? D(new j(e)) : C(e);
   }
 }
 function U(r) {
-  if (j(r) && r.data && typeof r.data == "object") {
+  if (W(r) && r.data && typeof r.data == "object") {
     const e = r.data;
     if (e.data != null)
       return e.data;
   }
 }
-function Le(r) {
+function Me(r) {
   return (e) => {
     if (e.isOk()) {
       const t = e.value;
@@ -503,7 +504,7 @@ function Le(r) {
     }
   };
 }
-async function Me(r) {
+async function $e(r) {
   let e, t, n;
   try {
     const s = await r.execute();
@@ -515,19 +516,19 @@ async function Me(r) {
     data: e,
     errors: t,
     subscribe(s) {
-      return n ? n(Le(s)) : S;
+      return n ? n(Me(s)) : g;
     },
     async refresh() {
       await r.refresh();
     }
   };
 }
-function C(r) {
+function E(r) {
   return {
     data: void 0,
     errors: r,
-    subscribe: () => S,
-    refresh: A
+    subscribe: () => g,
+    refresh: P
   };
 }
 function He({
@@ -543,20 +544,20 @@ function He({
     cacheControl: c,
     headers: f
   }) {
-    const h = q(a);
-    if (h.isErr()) return C(h.error);
-    const p = h.value, m = T(p, o);
+    const h = k(a);
+    if (h.isErr()) return E(h.error);
+    const p = h.value, m = q(p, o);
     if (m !== "query")
-      return C([
+      return E([
         {
           message: `DataSDK.graphql.query() requires a GraphQL query, received ${m}.`
         }
       ]);
     let l;
     try {
-      l = new Ne(
+      l = new Le(
         {
-          query: k(p),
+          query: A(p),
           variables: i,
           operationName: o,
           cacheControl: c,
@@ -565,33 +566,33 @@ function He({
         n,
         e
       );
-    } catch (g) {
-      return C(d(g));
+    } catch (S) {
+      return E(d(S));
     }
-    return Me(l);
+    return $e(l);
   }
   return {
     query: s,
-    mutate: (a) => I(t, a)
+    mutate: (a) => H(t, a)
   };
 }
-const Ie = 1, $e = `@salesforce/platform-sdk-data_v${Ie}`, V = F(), Fe = `${V}/ui-api`, N = `${V}/graphql`;
-class Ue {
+const Ie = 1, Fe = `@salesforce/platform-sdk-data_v${Ie}`, K = F(), Ue = `${K}/ui-api`, N = `${K}/graphql`;
+class Ke {
   baseUrl;
   clientFetch;
   onStatus;
   graphql;
   constructor(e) {
     const t = Ve();
-    this.baseUrl = xe(e?.basePath ?? t.apiPath), this.onStatus = e?.onStatus ?? {}, this.clientFetch = Te({
+    this.baseUrl = xe(e?.basePath ?? t.apiPath), this.onStatus = e?.onStatus ?? {}, this.clientFetch = Oe({
       csrf: {
-        endpoint: `${this.baseUrl}${Fe}/session/csrf`,
-        cacheName: $e,
+        endpoint: `${this.baseUrl}${Ue}/session/csrf`,
+        cacheName: Fe,
         protectedUrls: ["services/data/v", "services/apexrest"],
         alwaysProtectedUrls: ["services/apexrest"]
       }
     });
-    const n = (a, i) => this.fetch(a, i), s = Oe(this.baseUrl, n);
+    const n = (a, i) => this.fetch(a, i), s = _e(this.baseUrl, n);
     this.graphql = He({
       bundle: s,
       url: N,
@@ -617,7 +618,7 @@ class Ue {
     return (await this.fetch(N, {
       method: "POST",
       body: JSON.stringify({ query: e, variables: t, operationName: n }),
-      headers: H(s)
+      headers: $(s)
     })).json();
   }
   /**
@@ -644,37 +645,67 @@ function xe(r) {
   let e = r;
   return e.startsWith("/") || (e = `/${e}`), e.endsWith("/") && (e = e.slice(0, -1)), e;
 }
-function er(r, ...e) {
+async function Ge(r, e) {
+  if (e.length === 0)
+    return r;
+  const t = Object.create(r);
+  for (const n of e) {
+    if (n.name in t)
+      throw new Error(
+        `Plugin "${n.name}" cannot attach: "${n.name}" is already defined on the SDK.`
+      );
+    let s;
+    try {
+      s = await n.setup(t);
+    } catch (a) {
+      throw new Error(`Plugin "${n.name}" failed during setup.`, { cause: a });
+    }
+    Object.defineProperty(t, n.name, {
+      value: s,
+      enumerable: !0,
+      writable: !0,
+      configurable: !0
+    });
+  }
+  return t;
+}
+function sr(r, ...e) {
   let t = r[0] ?? "";
   for (let n = 0; n < e.length; n += 1)
     t += String(e[n]) + (r[n + 1] ?? "");
   return t;
 }
-function rr(r) {
-  return G(
-    (async () => {
-      try {
-        switch (await x(r?.surface)) {
-          case y.OpenAI:
-            return new pe();
-          case y.WebApp:
-          case y.MicroFrontend:
-            return new Ue(r?.webapp);
-          case y.Mosaic:
-            return new he(r?.mosaic);
-          case y.MCPApps:
-            return {};
-          default:
-            return {};
-        }
-      } catch {
+const ar = G();
+async function Qe(r) {
+  try {
+    switch (await V(r?.surface)) {
+      case y.OpenAI:
+        return new me();
+      case y.WebApp:
+      case y.MicroFrontend:
+        return new Ke(r?.webapp);
+      case y.Mosaic:
+        return new le(r?.mosaic);
+      case y.MCPApps:
         return {};
-      }
+      default:
+        return {};
+    }
+  } catch {
+    return {};
+  }
+}
+function or(r) {
+  return x(
+    (async () => {
+      const e = await Qe(r);
+      return Ge(e, r?.plugins ?? []);
     })(),
     "createDataSDK"
   );
 }
 export {
-  rr as createDataSDK,
-  er as gql
+  or as createDataSDK,
+  ar as defineDataPlugin,
+  sr as gql
 };

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, type DataSDKOptions, type WebAppDataSDKOptions, type MosaicDataSDKOptions, type StatusCallback, type NodeOfConnection, gql, } from './data';
+export { createDataSDK, defineDataPlugin, type DataSDKOptions, type DataSDKPlugin, type DataSDKWithPlugins, 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,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,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,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"}

package/dist/index.js

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

package/dist/plugin-factory-BC3b3BOy.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/platform-sdk",
-  "version": "11.49.4",
+  "version": "11.50.0",
   "license": "SEE LICENSE IN LICENSE.txt",
   "type": "module",
   "main": "./dist/index.js",
@@ -111,10 +111,10 @@
     "build": "vite build",
     "clean": "rm -rf dist",
     "dev": "vite build --watch",
-    "test": "vitest run && npm run test:examples",
+    "test": "vitest run --typecheck && npm run test:examples",
     "test:examples": "tsx scripts/check-examples.mts",
     "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage"
+    "test:coverage": "vitest run --coverage --typecheck"
   },
   "dependencies": {
     "@conduit-client/command-http-cache-control": "3.19.6",
@@ -126,7 +126,7 @@
     "@conduit-client/service-pubsub": "3.19.6",
     "@conduit-client/service-retry": "3.19.6",
     "@conduit-client/utils": "3.19.6",
-    "@salesforce/jsonrpc": "^11.49.4",
+    "@salesforce/jsonrpc": "^11.50.0",
     "@salesforce/sf-embedding-bridge": "2.2.5-rc.2"
   },
   "peerDependencies": {