@salesforce/platform-sdk 11.54.0 → 11.55.0

package/dist/core/index.d.ts

@@ -18,5 +18,5 @@ 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';
+export type { Plugin, AnyPlugin, AliasedPlugin, PluginsFor, PluginEntry, ExtendedSDK, LiteralName, UniquePluginNames, ValidAliasNames, } 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;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"}
+{"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,aAAa,EACb,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,eAAe,GACf,MAAM,gBAAgB,CAAC"}

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

@@ -1,9 +1,16 @@
 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
+ * 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
@@ -28,7 +35,8 @@ import { ExtendedSDK, PluginsFor } from './plugin-types';
  * 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 in `reservedNames` (names the caller declares off-limits),
+ * 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

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

@@ -1 +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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;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,CA0DrC"}
+{"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-types.d.ts

@@ -71,37 +71,74 @@ export type LiteralName<Name extends string> = string extends Name ? never : IsU
  */
 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.
+ * 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>[];
+export type PluginsFor<Base> = readonly (Plugin<Base, string, unknown> | AliasedPlugin<Plugin<Base, string, unknown>, string>)[];
 /**
- * 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.
+ * 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;
+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 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.
+ * 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<P extends AnyPlugin> = P["name"];
+type MountName<E extends PluginEntry> = E extends AnyAliasedPlugin ? E["as"] : PluginOf<E>["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.
+ * 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<P extends AnyPlugin> = Awaited<ReturnType<P["setup"]>>;
+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.
@@ -121,10 +158,8 @@ type Accumulate<Plugins extends readonly PluginEntry[]> = Plugins extends readon
 /**
  * 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`.
+ * {@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,
@@ -148,6 +183,21 @@ export type UniquePluginNames<Plugins extends readonly PluginEntry[]> = [
 ] 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];

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

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

package/dist/data/index.d.ts

@@ -1,4 +1,4 @@
-import { DataSDK, ExtendedSDK, Plugin, SDKOptions, UniquePluginNames } from '../core';
+import { DataSDK, ExtendedSDK, Plugin, PluginsFor, SDKOptions, UniquePluginNames, ValidAliasNames } from '../core';
 import { MosaicDataSDKOptions } from './mosaic';
 /**
  * A callback the host invokes for a given HTTP status (see {@link WebAppDataSDKOptions.onStatus}).
@@ -38,8 +38,12 @@ export type DataSDKPlugin<Name extends string = string, Api = unknown> = Plugin<
  * 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>;
+/**
+ * A DataSDK carrying every namespace contributed by an ordered plugin tuple.
+ * Entries may be bare plugins or `{ plugin, as }` aliases; each mounts under its
+ * effective key (the alias when present), so aliasing is reflected here for free.
+ */
+export type DataSDKWithPlugins<Plugins extends PluginsFor<DataSDK>> = ExtendedSDK<DataSDK, Plugins>;
 /**
  * Options for creating a DataSDK instance.
  */
@@ -54,7 +58,13 @@ export interface DataSDKOptions extends SDKOptions {
      * @example { instanceUrl: "https://my.salesforce.com", accessToken: "00D..." }
      */
     mosaic?: MosaicDataSDKOptions;
-    plugins?: readonly DataSDKPlugin[];
+    /**
+     * Plugins to attach. Each entry is a bare {@link DataSDKPlugin} (mounts under
+     * its own `name`) or a `{ plugin, as }` alias (mounts under `as`). Aliasing
+     * is the recourse when two plugins want the same key — e.g. two third-party
+     * labels plugins the consumer can't edit.
+     */
+    plugins?: PluginsFor<DataSDK>;
 }
 /**
  * Create and initialize a DataSDK instance based on the detected surface.
@@ -94,9 +104,9 @@ export interface DataSDKOptions extends SDKOptions {
  * }
  * ```
  */
-export declare function createDataSDK<const Plugins extends readonly DataSDKPlugin[] = []>(options?: Omit<DataSDKOptions, "plugins"> & {
+export declare function createDataSDK<const Plugins extends PluginsFor<DataSDK> = []>(options?: Omit<DataSDKOptions, "plugins"> & {
     plugins?: Plugins;
-} & UniquePluginNames<Plugins>): Promise<DataSDKWithPlugins<Plugins>>;
+} & UniquePluginNames<Plugins> & ValidAliasNames<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,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC3F,OAAO,EAAiB,KAAK,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAMpE;;;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;AAexC,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,EACX,OAAO,EACP,WAAW,EACX,MAAM,EACN,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,MAAM,SAAS,CAAC;AACjB,OAAO,EAAiB,KAAK,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAMpE;;;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;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,CAAC,OAAO,SAAS,UAAU,CAAC,OAAO,CAAC,IAAI,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAEpG;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,UAAU;IACjD;;;OAGG;IACH,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B;;;OAGG;IACH,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;CAC9B;AAqCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAiBH,wBAAgB,aAAa,CAAC,KAAK,CAAC,OAAO,SAAS,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,EAC3E,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,iBAAiB,CAAC,OAAO,CAAC,GAC7F,eAAe,CAAC,OAAO,CAAC,GACvB,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;AAexC,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,32 +1,32 @@
 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 M, setHeader as b } from "@conduit-client/service-fetch-network/v1";
-import { resolvedPromiseLike as u, ok as C, err as D, stableJSONStringify as Q, DataNotFoundError as j, UserVisibleError as z, deepFreeze as S, isUserVisibleError as W } from "@conduit-client/utils";
+import { buildServiceDescriptor as $, setHeader as b } from "@conduit-client/service-fetch-network/v1";
+import { resolvedPromiseLike as u, ok as C, err as D, stableJSONStringify as Q, DataNotFoundError as j, UserVisibleError as z, deepFreeze as g, isUserVisibleError as W } from "@conduit-client/utils";
 import { print as P, 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) {
+import { buildServiceDescriptor as te } from "@conduit-client/service-pubsub/v1";
+import { HttpCacheControlCommand as re } from "@conduit-client/command-http-cache-control/v1";
+function ne(t) {
   return (e) => {
-    const [t, n] = e;
-    if (typeof t == "string" && !t.startsWith("http")) {
-      const s = t.startsWith("/") ? t : `/${t}`;
-      return u([`${r}${s}`, n]);
+    const [r, n] = e;
+    if (typeof r == "string" && !r.startsWith("http")) {
+      const s = r.startsWith("/") ? r : `/${r}`;
+      return u([`${t}${s}`, n]);
     }
     return u(e);
   };
 }
-function se(r) {
-  return (e) => u(b("Authorization", `Bearer ${r}`, e));
+function se(t) {
+  return (e) => u(b("Authorization", `Bearer ${t}`, e));
 }
-function ae(r, e) {
-  const t = [];
-  return r && t.push(ne(r)), e && t.push(se(e)), M({
-    request: t
+function ae(t, e) {
+  const r = [];
+  return t && r.push(ne(t)), e && r.push(se(e)), $({
+    request: r
   }).service;
 }
 const oe = {
@@ -34,59 +34,59 @@ const oe = {
   Accept: "application/json",
   "X-Chatter-Entity-Encoding": "false"
 };
-function ie(r) {
-  if (r instanceof Headers) {
+function ie(t) {
+  if (t instanceof Headers) {
     const e = [];
-    return r.forEach((t, n) => e.push([n, t])), e;
+    return t.forEach((r, n) => e.push([n, r])), e;
   }
-  return Array.isArray(r) ? r.map(([e, t]) => [e, t]) : Object.entries(r);
+  return Array.isArray(t) ? t.map(([e, r]) => [e, r]) : Object.entries(t);
 }
-function $(r, e) {
-  if (e === void 0) return { ...r };
-  const t = { ...r }, n = /* @__PURE__ */ new Map();
-  for (const a of Object.keys(t)) n.set(a.toLowerCase(), a);
+function M(t, e) {
+  if (e === void 0) return { ...t };
+  const r = { ...t }, n = /* @__PURE__ */ new Map();
+  for (const a of Object.keys(r)) n.set(a.toLowerCase(), a);
   const s = /* @__PURE__ */ new Set();
   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));
+    c === void 0 ? (r[a] = i, n.set(o, a), s.add(o)) : s.has(o) ? r[c] = `${r[c]}, ${i}` : (r[c] = i, s.add(o));
   }
-  return t;
+  return r;
 }
-function L(r) {
-  return $(oe, r);
+function L(t) {
+  return M(oe, t);
 }
-function ce(r) {
-  if (r === void 0) return;
+function ce(t) {
+  if (t === void 0) return;
   const e = {};
-  return new Headers(r).forEach((t, n) => {
-    e[n] = t;
+  return new Headers(t).forEach((r, n) => {
+    e[n] = r;
   }), Object.keys(e).length > 0 ? e : void 0;
 }
-const v = () => {
+const S = () => {
 }, A = async () => {
 };
-function _(r) {
+function _(t) {
   try {
-    return C(B(r));
+    return C(B(t));
   } catch (e) {
-    return D(d(e));
+    return D(f(e));
   }
 }
-function k(r, e) {
-  const t = r.definitions.filter(
+function k(t, e) {
+  const r = t.definitions.filter(
     (n) => n.kind === "OperationDefinition"
   );
-  return t.length === 0 ? "unknown" : t.length === 1 ? e === void 0 || t[0].name?.value === e ? t[0].operation : "unknown" : e === void 0 ? "unknown" : t.find((n) => n.name?.value === e)?.operation ?? "unknown";
+  return r.length === 0 ? "unknown" : r.length === 1 ? e === void 0 || r[0].name?.value === e ? r[0].operation : "unknown" : e === void 0 ? "unknown" : r.find((n) => n.name?.value === e)?.operation ?? "unknown";
 }
-function d(r) {
-  if (r && typeof r == "object" && "data" in r) {
-    const e = r.data;
+function f(t) {
+  if (t && typeof t == "object" && "data" in t) {
+    const e = t.data;
     if (e && typeof e == "object" && "errors" in e && Array.isArray(e.errors))
       return e.errors;
   }
-  return r instanceof Error ? [{ message: r.message }] : typeof r == "string" ? [{ message: r }] : [{ message: "Unknown error" }];
+  return t instanceof Error ? [{ message: t.message }] : typeof t == "string" ? [{ message: t }] : [{ message: "Unknown error" }];
 }
-async function H(r, { mutation: e, variables: t, operationName: n, headers: s }) {
+async function H(t, { mutation: e, variables: r, operationName: n, headers: s }) {
   const a = _(e);
   if (a.isErr()) return { data: void 0, errors: a.error };
   const i = a.value, o = k(i, n);
@@ -100,9 +100,9 @@ async function H(r, { mutation: e, variables: t, operationName: n, headers: s })
       ]
     };
   try {
-    const c = await r({
+    const c = await t({
       query: P(i),
-      variables: t,
+      variables: r,
       operationName: n,
       headers: s
     });
@@ -111,12 +111,12 @@ async function H(r, { mutation: e, variables: t, operationName: n, headers: s })
       errors: c.errors
     };
   } catch (c) {
-    return { data: void 0, errors: d(c) };
+    return { data: void 0, errors: f(c) };
   }
 }
-function I(r) {
+function I(t) {
   function e(n, s, a, i) {
-    return r({
+    return t({
       query: P(n),
       variables: s,
       operationName: a,
@@ -126,10 +126,10 @@ function I(r) {
         data: o.data ?? void 0,
         errors: o.errors
       }),
-      (o) => ({ data: void 0, errors: d(o) })
+      (o) => ({ data: void 0, errors: f(o) })
     );
   }
-  async function t({
+  async function r({
     query: n,
     variables: s,
     operationName: a,
@@ -140,44 +140,44 @@ function I(r) {
       return {
         data: void 0,
         errors: o.error,
-        subscribe: () => v,
+        subscribe: () => S,
         refresh: A
       };
-    const c = o.value, f = k(c, a);
-    if (f !== "query")
+    const c = o.value, l = k(c, a);
+    if (l !== "query")
       return {
         data: void 0,
         errors: [
           {
-            message: `DataSDK.graphql.query() requires a GraphQL query, received ${f}.`
+            message: `DataSDK.graphql.query() requires a GraphQL query, received ${l}.`
           }
         ],
-        subscribe: () => v,
+        subscribe: () => S,
         refresh: A
       };
     const h = /* @__PURE__ */ new Set(), p = s, m = await e(c, p, a, i);
     return {
       data: m.data,
       errors: m.errors,
-      subscribe(l) {
-        return h.add(l), () => {
-          h.delete(l);
+      subscribe(d) {
+        return h.add(d), () => {
+          h.delete(d);
         };
       },
       async refresh() {
-        const l = await e(c, p, a, i);
-        for (const g of h) g(l);
+        const d = await e(c, p, a, i);
+        for (const v of h) v(d);
       }
     };
   }
   return {
-    query: t,
-    mutate: (n) => H(r, n)
+    query: r,
+    mutate: (n) => H(t, n)
   };
 }
 const ue = typeof __SF_API_VERSION__ < "u" ? __SF_API_VERSION__ : "65.0";
-function F(r = ue) {
-  return `/services/data/v${r}`;
+function F(t = ue) {
+  return `/services/data/v${t}`;
 }
 const he = {
   "Content-Type": "application/json",
@@ -188,33 +188,33 @@ class le {
   pathData;
   graphql;
   constructor(e) {
-    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));
+    const r = de(), n = fe(e?.instanceUrl ?? r.instanceUrl), s = e?.accessToken ?? r.accessToken;
+    this.pathData = F(e?.apiVersion ?? r.apiVersion), this.clientFetch = ae(n || void 0, s), this.graphql = I(this.executeRawGraphQL.bind(this));
   }
   async executeRawGraphQL({
     query: e,
-    variables: t,
+    variables: r,
     operationName: n,
     headers: s
   }) {
     return (await this.clientFetch(`${this.pathData}/graphql`, {
       method: "POST",
-      body: JSON.stringify({ query: e, variables: t, operationName: n }),
-      headers: $(he, s)
+      body: JSON.stringify({ query: e, variables: r, operationName: n }),
+      headers: M(he, s)
     })).json();
   }
 }
 function de() {
-  const r = globalThis.MOSAIC_ENV;
+  const t = globalThis.MOSAIC_ENV;
   return {
-    instanceUrl: r?.instanceUrl,
-    accessToken: r?.accessToken,
-    apiVersion: r?.apiVersion
+    instanceUrl: t?.instanceUrl,
+    accessToken: t?.accessToken,
+    apiVersion: t?.apiVersion
   };
 }
-function fe(r) {
-  if (!r || r === "/") return "";
-  let e = r;
+function fe(t) {
+  if (!t || t === "/") return "";
+  let e = t;
   return !e.startsWith("/") && !e.startsWith("http") && (e = `/${e}`), e.endsWith("/") && (e = e.slice(0, -1)), e;
 }
 const pe = "graphqlQuery";
@@ -230,12 +230,12 @@ class me {
    */
   async executeRawGraphQL({
     query: e,
-    variables: t,
+    variables: r,
     operationName: n
   }) {
     return (await window.openai.callTool(pe, {
       query: e,
-      ...t != null ? { variables: t } : {},
+      ...r != null ? { variables: r } : {},
       ...n != null ? { operationName: n } : {}
     })).structuredContent;
   }
@@ -243,39 +243,39 @@ class me {
 const ye = {
   graphql: !0,
   fetch: !0
-}, be = new Set(Object.keys(ye)), w = "Accept-Language", Se = (r) => {
+}, be = new Set(Object.keys(ye)), w = "Accept-Language", ge = (t) => {
   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));
-}, ve = "X-SFDC-Client-Name", ge = "X-SFDC-Client-Version", we = "@salesforce/platform-sdk", Ee = "11.54.0", Ce = (r) => {
-  let e = b(ve, we, r);
-  return e = b(ge, Ee, e), u(e);
+    return u(t);
+  const [r, n] = t;
+  return (r instanceof Request && !n?.headers ? r.headers.has(w) : new Headers(n?.headers).has(w)) ? u(t) : u(b(w, e, t));
+}, Se = "X-SFDC-Client-Name", ve = "X-SFDC-Client-Version", we = "@salesforce/platform-sdk", Ee = "11.55.0", Ce = (t) => {
+  let e = b(Se, we, t);
+  return e = b(ve, Ee, e), u(e);
 }, De = "X-CSRF-Token";
-function Ae(r, e = {}) {
-  const { protectedUrls: t = [], alwaysProtectedUrls: n = [] } = e;
+function Ae(t, e = {}) {
+  const { protectedUrls: r = [], 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 (R(n, o) || Pe(c) && R(t, o)) {
-      const h = await r.getToken();
+    if (R(n, o) || Pe(c) && R(r, o)) {
+      const h = await t.getToken();
       s = b(De, h, s);
     }
     return u(s);
   };
 }
-function Pe(r) {
-  const e = r.toLowerCase();
+function Pe(t) {
+  const e = t.toLowerCase();
   return e === "post" || e === "put" || e === "patch" || e === "delete";
 }
-function R(r, e) {
-  const t = new URL(e, globalThis.location?.href ?? "http://localhost");
-  return r.some((n) => t.pathname.includes(n));
+function R(t, e) {
+  const r = new URL(e, globalThis.location?.href ?? "http://localhost");
+  return t.some((n) => r.pathname.includes(n));
 }
-function _e(r, e = {}) {
-  const t = Ae(r, e);
+function _e(t, e = {}) {
+  const r = Ae(t, e);
   async function n(s) {
-    const a = await t(s);
+    const a = await r(s);
     return fetch(a[0], a[1]);
   }
   return (s, a) => a ? a.applyRetry(async () => n(s)) : n(s);
@@ -288,13 +288,13 @@ class Re extends J {
   /**
    * Determines if a failed request should be retried due to CSRF token issues.
    */
-  async shouldRetry(e, t) {
-    return t.attempt >= 1 ? !1 : ke.includes(e.status);
+  async shouldRetry(e, r) {
+    return r.attempt >= 1 ? !1 : ke.includes(e.status);
   }
   /**
    * CSRF token refresh should happen immediately with no delay.
    */
-  async calculateDelay(e, t) {
+  async calculateDelay(e, r) {
     return 0;
   }
   /**
@@ -303,13 +303,13 @@ class Re extends J {
    * @param _result - The failed response that triggered the retry (unused, already validated)
    * @param _context - Current retry context (unused but part of interface)
    */
-  async prepareRetry(e, t) {
+  async prepareRetry(e, r) {
     await this.csrfTokenManager.refreshToken();
   }
 }
 class qe {
-  constructor(e, t) {
-    this.endpoint = e, this.cacheName = t, this.tokenPromise = this.obtainToken();
+  constructor(e, r) {
+    this.endpoint = e, this.cacheName = r, this.tokenPromise = this.obtainToken();
   }
   tokenPromise;
   refreshPromise;
@@ -336,10 +336,10 @@ class qe {
    * @returns Promise that resolves to the CSRF token string
    */
   async obtainToken() {
-    let e = await this.withCache((s) => s.match(this.endpoint)), t = !1;
-    e || (e = await fetch(this.endpoint, { method: "get" }), t = !0);
+    let e = await this.withCache((s) => s.match(this.endpoint)), r = !1;
+    e || (e = await fetch(this.endpoint, { method: "get" }), r = !0);
     const n = (await e.clone().json()).csrfToken;
-    return t && await this.withCache((s) => s.put(this.endpoint, e)), n;
+    return r && await this.withCache((s) => s.put(this.endpoint, e)), n;
   }
   /**
    * Provides a safe way to interact with the Cache API with fallback for unsupported environments.
@@ -349,68 +349,68 @@ class qe {
    */
   async withCache(e) {
     if (this.cacheName && caches) {
-      const t = await caches.open(this.cacheName);
-      return e(t);
+      const r = await caches.open(this.cacheName);
+      return e(r);
     } else
       return;
   }
 }
 const q = /* @__PURE__ */ new Map();
-function Oe(r) {
-  const { endpoint: e, cacheName: t, ...n } = r.csrf;
+function Oe(t) {
+  const { endpoint: e, cacheName: r, ...n } = t.csrf;
   let s = q.get(e);
-  return s || (s = new qe(e, t), q.set(e, s)), M(
+  return s || (s = new qe(e, r), q.set(e, s)), $(
     {
       retry: _e(s, n),
-      request: [Ce, Se]
+      request: [Ce, ge]
     },
     X(new Re(s)).service
   ).service;
 }
 const O = /* @__PURE__ */ new Map();
-function Te(r) {
-  let e = O.get(r);
+function Te(t) {
+  let e = O.get(t);
   if (!e) {
-    const t = Y().service, n = ee(t).service, s = Z(t, n).service, a = re().service;
-    e = { cache: t, cacheController: s, pubSub: a }, O.set(r, e);
+    const r = Y().service, n = ee(r).service, s = Z(r, n).service, a = te().service;
+    e = { cache: r, cacheController: s, pubSub: a }, O.set(t, e);
   }
   return e;
 }
-function Ne(r, e) {
-  const t = Te(r);
+function Ne(t, e) {
+  const r = Te(t);
   return {
-    shared: t,
+    shared: r,
     services: {
-      cacheController: t.cacheController,
-      pubSub: t.pubSub,
+      cacheController: r.cacheController,
+      pubSub: r.pubSub,
       fetch: e
     }
   };
 }
 const T = 300;
-function Me(r, e) {
+function $e(t, e) {
   try {
-    return JSON.parse(JSON.stringify(r));
-  } catch (t) {
+    return JSON.parse(JSON.stringify(t));
+  } catch (r) {
     const n = e || "(anonymous)", s = new TypeError(
-      `HttpGraphQLResourceCacheControlCommand: variables for operation "${n}" must be JSON-serializable. ${t.message}`
+      `HttpGraphQLResourceCacheControlCommand: variables for operation "${n}" must be JSON-serializable. ${r.message}`
     );
-    throw s.cause = t, s;
+    throw s.cause = r, s;
   }
 }
-function $e(r) {
-  if (typeof r == "object" && r.type === "max-age") {
-    const e = r.maxAge;
+function Me(t) {
+  if (typeof t == "object" && t.type === "max-age") {
+    const e = t.maxAge;
     return Number.isFinite(e) && e >= 0 ? e : T;
   }
   return T;
 }
-class Le extends te {
-  constructor(e, t, n) {
-    super(t), this.url = n, this.query = e.query, this.normalizedOperationName = e.operationName ?? "", this.normalizedVariables = Me(
+class Le extends re {
+  constructor(e, r, n) {
+    super(r), this.url = n, this.query = e.query, this.normalizedOperationName = e.operationName ?? "", this.normalizedVariables = $e(
       e.variables ?? {},
       this.normalizedOperationName
-    ), this.cacheControl = e.cacheControl, this.resolvedMaxAge = $e(e.cacheControl), this.headers = e.headers, this.headersKey = ce(e.headers);
+    ), this.cacheControl = e.cacheControl, this.resolvedMaxAge = Me(e.cacheControl), this.headers = e.headers, this.headersKey = ce(e.headers);
   }
   query;
   normalizedVariables;
@@ -455,14 +455,14 @@ class Le extends te {
    * @returns result or error from the cache
    */
   readFromCache(e) {
-    const t = this.buildKey(), n = e.get(t)?.value;
+    const r = this.buildKey(), n = e.get(r)?.value;
     return n === void 0 ? u(D(new j())) : u(C(n));
   }
-  writeToCache(e, t) {
-    if (t.isOk() && t.value.data != null && Object.keys(t.value.data).length > 0) {
+  writeToCache(e, r) {
+    if (r.isOk() && r.value.data != null && Object.keys(r.value.data).length > 0) {
       const n = Math.floor(Date.now() / 1e3);
       e.set(this.buildKey(), {
-        value: t.value.data,
+        value: r.value.data,
         metadata: {
           cacheControl: {
             type: "max-age",
@@ -489,63 +489,63 @@ class Le extends te {
     return this.responseHasErrors(e) ? D(new z(e)) : C(e);
   }
 }
-function K(r) {
-  if (W(r) && r.data && typeof r.data == "object") {
-    const e = r.data;
+function K(t) {
+  if (W(t) && t.data && typeof t.data == "object") {
+    const e = t.data;
     if (e.data != null)
       return e.data;
   }
 }
-function He(r) {
+function He(t) {
   return (e) => {
     if (e.isOk()) {
-      const t = e.value;
-      S(t), r({ data: t, errors: void 0 });
+      const r = e.value;
+      g(r), t({ data: r, errors: void 0 });
     } else {
-      const t = K(e.error);
-      t && S(t), r({ data: t, errors: d(e.error) });
+      const r = K(e.error);
+      r && g(r), t({ data: r, errors: f(e.error) });
     }
   };
 }
-async function Ie(r) {
-  let e, t, n;
+async function Ie(t) {
+  let e, r, n;
   try {
-    const s = await r.execute();
-    s.isOk() ? (e = s.value.data, S(e), n = (a) => s.value.subscribe(a)) : (e = K(s.error.failure), e && S(e), t = d(s.error.failure), n = (a) => s.error.subscribe(a));
+    const s = await t.execute();
+    s.isOk() ? (e = s.value.data, g(e), n = (a) => s.value.subscribe(a)) : (e = K(s.error.failure), e && g(e), r = f(s.error.failure), n = (a) => s.error.subscribe(a));
   } catch (s) {
-    t = d(s);
+    r = f(s);
   }
   return {
     data: e,
-    errors: t,
+    errors: r,
     subscribe(s) {
-      return n ? n(He(s)) : v;
+      return n ? n(He(s)) : S;
     },
     async refresh() {
-      await r.refresh();
+      await t.refresh();
     }
   };
 }
-function E(r) {
+function E(t) {
   return {
     data: void 0,
-    errors: r,
-    subscribe: () => v,
+    errors: t,
+    subscribe: () => S,
     refresh: A
   };
 }
 function Fe({
-  bundle: r,
+  bundle: t,
   url: e,
-  executeRaw: t
+  executeRaw: r
 }) {
-  const { services: n } = r;
+  const { services: n } = t;
   async function s({
     query: a,
     variables: i,
     operationName: o,
     cacheControl: c,
-    headers: f
+    headers: l
   }) {
     const h = _(a);
     if (h.isErr()) return E(h.error);
@@ -556,27 +556,27 @@ function Fe({
           message: `DataSDK.graphql.query() requires a GraphQL query, received ${m}.`
         }
       ]);
-    let l;
+    let d;
     try {
-      l = new Le(
+      d = new Le(
         {
           query: P(p),
           variables: i,
           operationName: o,
           cacheControl: c,
-          headers: f
+          headers: l
         },
         n,
         e
       );
-    } catch (g) {
-      return E(d(g));
+    } catch (v) {
+      return E(f(v));
     }
-    return Ie(l);
+    return Ie(d);
   }
   return {
     query: s,
-    mutate: (a) => H(t, a)
+    mutate: (a) => H(r, a)
   };
 }
 const Ke = 1, Ue = `@salesforce/platform-sdk-data_v${Ke}`, U = F(), Ve = `${U}/ui-api`, N = `${U}/graphql`;
@@ -586,8 +586,8 @@ class xe {
   onStatus;
   graphql;
   constructor(e) {
-    const t = Ge();
-    this.baseUrl = Qe(e?.basePath ?? t.apiPath), this.onStatus = e?.onStatus ?? {}, this.clientFetch = Oe({
+    const r = Ge();
+    this.baseUrl = Qe(e?.basePath ?? r.apiPath), this.onStatus = e?.onStatus ?? {}, this.clientFetch = Oe({
       csrf: {
         endpoint: `${this.baseUrl}${Ve}/session/csrf`,
         cacheName: Ue,
@@ -602,8 +602,8 @@ class xe {
       executeRaw: this.executeRawGraphQL.bind(this)
     });
   }
-  async fetch(e, t) {
-    const n = this.applySalesforceBase(e), s = await this.clientFetch(n, t);
+  async fetch(e, r) {
+    const n = this.applySalesforceBase(e), s = await this.clientFetch(n, r);
     return await this.onStatus[s.status]?.(), s;
   }
   /**
@@ -614,13 +614,13 @@ class xe {
    */
   async executeRawGraphQL({
     query: e,
-    variables: t,
+    variables: r,
     operationName: n,
     headers: s
   }) {
     return (await this.fetch(N, {
       method: "POST",
-      body: JSON.stringify({ query: e, variables: t, operationName: n }),
+      body: JSON.stringify({ query: e, variables: r, operationName: n }),
       headers: L(s)
     })).json();
   }
@@ -632,8 +632,8 @@ class xe {
     if (typeof e == "string") {
       if (e.startsWith("http"))
         return e;
-      const t = e.startsWith("/") ? e : `/${e}`;
-      return `${this.baseUrl}${t}`;
+      const r = e.startsWith("/") ? e : `/${e}`;
+      return `${this.baseUrl}${r}`;
     }
     return e;
   }
@@ -643,32 +643,41 @@ function Ge() {
     apiPath: globalThis.SFDC_ENV?.apiPath
   };
 }
-function Qe(r) {
-  if (!r || r === "/") return "";
-  let e = r;
+function Qe(t) {
+  if (!t || t === "/") return "";
+  let e = t;
   return e.startsWith("/") || (e = `/${e}`), e.endsWith("/") && (e = e.slice(0, -1)), e;
 }
-async function je(r, e, t = /* @__PURE__ */ new Set()) {
+function je(t) {
+  const e = typeof t == "object" && t !== null && "setup" in t, r = e ? t : t.plugin, n = e ? r?.name : t.as;
+  if (typeof r?.setup != "function")
+    throw new Error("Plugin entry cannot attach: it is missing a setup function.");
+  if (typeof n != "string" || n.length === 0)
+    throw new Error(
+      e ? 'Plugin entry cannot attach: "name" must be a non-empty string.' : 'Plugin entry cannot attach: alias "as" must be a non-empty string.'
+    );
+  return { plugin: r, mountName: n };
+}
+async function ze(t, e, r = /* @__PURE__ */ new Set()) {
   if (e.length === 0)
-    return r;
-  const n = Object.create(r);
+    return t;
+  const n = Object.create(t);
   for (const s of e) {
-    if (t.has(s.name))
-      throw new Error(
-        `Plugin "${s.name}" cannot attach: "${s.name}" is a reserved SDK name.`
-      );
-    if (s.name in n)
+    const { plugin: a, mountName: i } = je(s), o = i === a.name ? `"${a.name}"` : `"${a.name}" (aliased as "${i}")`;
+    if (r.has(i))
+      throw new Error(`Plugin ${o} cannot attach: "${i}" is a reserved SDK name.`);
+    if (i in n)
       throw new Error(
-        `Plugin "${s.name}" cannot attach: "${s.name}" is already defined on the SDK.`
+        `Plugin ${o} cannot attach: "${i}" is already defined on the SDK.`
       );
-    let a;
+    let c;
     try {
-      a = await s.setup(n);
-    } catch (i) {
-      throw new Error(`Plugin "${s.name}" failed during setup.`, { cause: i });
+      c = await a.setup(n);
+    } catch (l) {
+      throw new Error(`Plugin ${o} failed during setup.`, { cause: l });
     }
-    Object.defineProperty(n, s.name, {
-      value: a,
+    Object.defineProperty(n, i, {
+      value: c,
       enumerable: !0,
       writable: !0,
       configurable: !0
@@ -676,23 +685,23 @@ async function je(r, e, t = /* @__PURE__ */ new Set()) {
   }
   return n;
 }
-function or(r, ...e) {
-  let t = r[0] ?? "";
+function it(t, ...e) {
+  let r = t[0] ?? "";
   for (let n = 0; n < e.length; n += 1)
-    t += String(e[n]) + (r[n + 1] ?? "");
-  return t;
+    r += String(e[n]) + (t[n + 1] ?? "");
+  return r;
 }
-const ir = G();
-async function ze(r) {
+const ct = G();
+async function We(t) {
   try {
-    switch (await V(r?.surface)) {
+    switch (await V(t?.surface)) {
       case y.OpenAI:
         return new me();
       case y.WebApp:
       case y.MicroFrontend:
-        return new xe(r?.webapp);
+        return new xe(t?.webapp);
       case y.Mosaic:
-        return new le(r?.mosaic);
+        return new le(t?.mosaic);
       case y.MCPApps:
         return {};
       default:
@@ -702,17 +711,17 @@ async function ze(r) {
     return {};
   }
 }
-function cr(r) {
+function ut(t) {
   return x(
     (async () => {
-      const e = await ze(r);
-      return je(e, r?.plugins ?? [], be);
+      const e = await We(t);
+      return ze(e, t?.plugins ?? [], be);
     })(),
     "createDataSDK"
   );
 }
 export {
-  cr as createDataSDK,
-  ir as defineDataPlugin,
-  or as gql
+  ut as createDataSDK,
+  ct as defineDataPlugin,
+  it as gql
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/platform-sdk",
-  "version": "11.54.0",
+  "version": "11.55.0",
   "license": "SEE LICENSE IN LICENSE.txt",
   "type": "module",
   "main": "./dist/index.js",
@@ -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.54.0",
+    "@salesforce/jsonrpc": "^11.55.0",
     "@salesforce/sf-embedding-bridge": "2.2.5-rc.2"
   },
   "peerDependencies": {