@salesforce/platform-sdk 11.58.0 → 11.59.0

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,aAAa,EACb,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,eAAe,GACf,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;AAQ/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/data/index.js

@@ -282,7 +282,7 @@ const Se = {
     return u(t);
   const [r, n] = t;
   return (r instanceof Request && !n?.headers ? r.headers.has(v) : new Headers(n?.headers).has(v)) ? u(t) : u(b(v, e, t));
-}, Ce = "X-SFDC-Client-Name", De = "X-SFDC-Client-Version", Pe = "@salesforce/platform-sdk", Ae = "11.58.0", Oe = (t) => {
+}, Ce = "X-SFDC-Client-Name", De = "X-SFDC-Client-Version", Pe = "@salesforce/platform-sdk", Ae = "11.59.0", Oe = (t) => {
   let e = b(Ce, Pe, t);
   return e = b(De, Ae, e), u(e);
 }, Te = "X-CSRF-Token";

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

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

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

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

package/dist/data/plugins/index.js

@@ -0,0 +1,84 @@
+import { defineDataPlugin as b } from "../index.js";
+const m = "BASE_VALUE", p = `
+	query Labels($namespace: String, $names: [String!]!, $locale: String, $fallback: LabelFallback) {
+		uiapi {
+			platform {
+				labels(namespace: $namespace, names: $names, locale: $locale, fallback: $fallback) {
+					name
+					value
+				}
+			}
+		}
+	}
+`, L = /* @__PURE__ */ new Set(["TRANSLATION_NOT_FOUND", "LABEL_NOT_FOUND"]), f = ["uiapi", "platform", "labels"];
+function E(n) {
+  const e = n.path;
+  return e?.length !== f.length + 1 ? !1 : f.every((s, l) => e[l] === s) && typeof e[f.length] == "number";
+}
+function d(n) {
+  const e = n.extensions?.code;
+  return e != null && L.has(e) && E(n);
+}
+const h = 100;
+function g(n, e) {
+  const s = [...new Set(n)], l = [];
+  for (let r = 0; r < s.length; r += e)
+    l.push(s.slice(r, r + e));
+  return l;
+}
+async function y(n, e, s, l, r) {
+  const t = { names: s, fallback: r };
+  e != null && (t.namespace = e), l != null && (t.locale = l);
+  const a = await n.query({
+    operationName: "Labels",
+    query: p,
+    variables: t
+  }), o = a.errors?.filter((i) => !d(i));
+  if (o?.length)
+    throw new Error(`Labels query failed: ${JSON.stringify(o)}`);
+  const c = a.data?.uiapi?.platform?.labels;
+  if (c == null)
+    throw new Error(
+      `Labels query failed: ${JSON.stringify(a.errors ?? "no labels in response")}`
+    );
+  return c;
+}
+async function A(n, e, s, l, r) {
+  const t = g(s, h), a = await Promise.all(
+    t.map((c) => y(n, e, c, l, r))
+  ), o = {};
+  for (const c of a)
+    for (const i of c)
+      i?.value != null && (o[i.name] = i.value);
+  return o;
+}
+function u(n) {
+  const e = n?.trim();
+  return e || void 0;
+}
+function _(n = {}) {
+  const e = { ...n };
+  return b({
+    name: "labels",
+    setup: (s) => {
+      const l = s.graphql;
+      if (!l)
+        return {};
+      const r = async (t, a) => {
+        const o = u(a?.namespace) ?? u(e.namespace), c = u(a?.locale) ?? u(e.locale), i = a?.fallback ?? e.fallback ?? m;
+        return A(l, o, t, c, i);
+      };
+      return {
+        async get(t, a) {
+          return (await r([t], a))[t];
+        },
+        async getAll(t, a) {
+          return r(t, a);
+        }
+      };
+    }
+  });
+}
+export {
+  _ as labelsPlugin
+};

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

@@ -0,0 +1,98 @@
+import { LabelFallback } from './query';
+import { DataSDKPlugin } from '../../index';
+export type { LabelFallback };
+/**
+ * Where labels are read from and how they resolve. Supplied once when the
+ * plugin is configured (`labelsPlugin({ namespace: "MyApp" })`) to set defaults,
+ * and again per call ({@link LabelsApi.get}/{@link LabelsApi.getAll}) to override
+ * them for that call. Each field resolves independently as `call ?? config ??
+ * built-in default`.
+ */
+export interface LabelsOptions {
+    /**
+     * The custom-label namespace to read from (the GraphQL `labels(namespace:)`
+     * argument). Omit it — or pass an empty string — at both configure and call
+     * sites to let the server apply its default namespace, `"c"` (the standard
+     * custom-label namespace). An empty per-call value defers to the configured
+     * namespace, exactly as omitting it does.
+     */
+    namespace?: string;
+    /**
+     * Target locale (e.g. `"fr"`, `"en-US"`). Omit it — or pass an empty string —
+     * to let the server resolve the logged-in user's locale (the default). An
+     * empty per-call value defers to the configured locale, exactly as omitting
+     * it does.
+     */
+    locale?: string;
+    /**
+     * How the server resolves a label with no translation for {@link locale}.
+     * Defaults to `"BASE_VALUE"` (the org-default value). @see {@link LabelFallback}
+     */
+    fallback?: LabelFallback;
+}
+/**
+ * The `labels` namespace mounted on the DataSDK. Both methods resolve labels in
+ * a namespace (configured or per-call) and report an unresolved label as a miss
+ * — `undefined` from {@link get}, an absent key from {@link getAll}. The caller
+ * decides what a miss means; fall back to the name with
+ * `await sdk.labels.get?.(name) ?? name`.
+ *
+ * The methods are optional, mirroring the {@link DataSDK.graphql} namespace they
+ * depend on: a surface whose DataSDK has no `graphql` cannot fetch labels, so
+ * `get`/`getAll` are absent there. Feature-detect (`sdk.labels.get?.(name)`) or
+ * narrow once, exactly as you would `sdk.graphql`.
+ */
+export interface LabelsApi {
+    /**
+     * Resolve a single label. Returns its value, or `undefined` if the server did
+     * not resolve it. Absent when the surface's DataSDK has no `graphql`.
+     *
+     * @param name - The label name (developer name) to resolve.
+     * @param options - Per-call overrides of the configured {@link LabelsOptions}.
+     */
+    get?(name: string, options?: LabelsOptions): Promise<string | undefined>;
+    /**
+     * Resolve many labels in one batched load. Returns a map keyed only by the
+     * names that resolved; a name that was not resolved is absent from the map
+     * (symmetric with {@link get} returning `undefined`), so `Object.keys` reflects
+     * exactly what the server supplied. Absent when the surface's DataSDK has no
+     * `graphql`.
+     *
+     * Intended for a bounded label set (an app's manifest — dozens to low
+     * hundreds). Names are deduped and split into batches of 100 (the server's
+     * per-call cap) that are fetched concurrently, so a very large input issues a
+     * proportional number of simultaneous requests; batch, cache, or throttle
+     * upstream if you expect to resolve thousands at once.
+     *
+     * @param names - The label names to resolve. Deduped and batched internally;
+     *   order and duplicates in the input do not matter.
+     * @param options - Per-call overrides of the configured {@link LabelsOptions}.
+     */
+    getAll?(names: readonly string[], options?: LabelsOptions): Promise<Record<string, string>>;
+}
+/**
+ * A first-party DataSDK plugin that mounts a `labels` namespace for reading
+ * custom labels. Attach it via `createDataSDK({ plugins: [labelsPlugin()] })`,
+ * then call `sdk.labels.get?.(name)` / `sdk.labels.getAll?.(names)` — the
+ * methods are optional, absent on a surface whose DataSDK has no `graphql`.
+ *
+ * Requires org API v264 or later (the release that introduced the
+ * `uiapi.platform.labels` GraphQL shape this plugin queries).
+ *
+ * @param config - Default {@link LabelsOptions} for every call; each field is
+ *   overridable per call. Omit `namespace` (here and per call) to read from the
+ *   server's default namespace, `"c"`.
+ *
+ * @example
+ * ```typescript
+ * import { createDataSDK } from "@salesforce/platform-sdk/data";
+ * import { labelsPlugin } from "@salesforce/platform-sdk/data/plugins";
+ *
+ * const sdk = await createDataSDK({ plugins: [labelsPlugin({ namespace: "MyApp" })] });
+ * const greeting = (await sdk.labels.get?.("greeting")) ?? "greeting"; // uses "MyApp"; ?? name if you want the key
+ * const french = await sdk.labels.get?.("greeting", { locale: "fr" }); // string | undefined
+ * const many = await sdk.labels.getAll?.(["greeting", "farewell"]);    // only resolved names
+ * ```
+ */
+export declare function labelsPlugin(config?: LabelsOptions): DataSDKPlugin<"labels", LabelsApi>;
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,42 @@
+import { DataSDK } from '../../../core';
+/**
+ * How the server resolves a label with no translation for the requested locale.
+ * `BASE_VALUE` returns the org-default (base) value directly; `USER_DEFAULT`
+ * falls back to the logged-in user's language first, then the base value; `NONE`
+ * does not fall back — a label with no translation for the locale comes back as
+ * a null slot ({@link queryBatch} classifies its indexed error as a miss, not a
+ * failure), so the name surfaces as absent rather than as a fallback value.
+ */
+export type LabelFallback = "BASE_VALUE" | "USER_DEFAULT" | "NONE";
+/**
+ * Return the org-default (base) value when a label has no translation for the
+ * requested locale, instead of the logged-in user's language (the server's
+ * `USER_DEFAULT` behavior). The plugin resolves an explicit target locale, so it
+ * opts into `BASE_VALUE`.
+ */
+export declare const DEFAULT_LABEL_FALLBACK: LabelFallback;
+/** The DataSDK `graphql` namespace with its optionality removed. */
+type GraphQL = NonNullable<DataSDK["graphql"]>;
+/**
+ * Resolve `names` in `namespace` to their label values.
+ *
+ * Dedupes and batches into `labels()` calls of at most 100 names (the server
+ * cap), fanning the batches out in parallel. Batches cover disjoint names, so
+ * `Promise.all` is safe; it also stays all-or-nothing — a single failed batch
+ * ({@link queryBatch} throws on any non-miss GraphQL error) rejects the whole
+ * load rather than returning a partial map that hides the failure.
+ *
+ * Returns a map keyed by the requested name. A *miss* — an unknown name, or no
+ * translation when `fallback` is `NONE` — comes back as a null slot (its indexed
+ * error already classified as a miss by {@link queryBatch}) and is dropped from
+ * the map, so this returns only the names the server actually resolved.
+ *
+ * @param namespace - Label namespace, or `undefined` to let the server apply
+ *   its default namespace (`"c"`; the GraphQL `namespace` arg is nullable and
+ *   defaulted, so the variable is omitted when this is `undefined`).
+ * @param locale - Target locale, or `undefined` to let the server resolve the
+ *   logged-in user's locale (the GraphQL `locale` arg is nullable).
+ */
+export declare function resolveLabels(graphql: GraphQL, namespace: string | undefined, names: readonly string[], locale: string | undefined, fallback: LabelFallback): Promise<Record<string, string>>;
+export {};
+//# sourceMappingURL=query.d.ts.map

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

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

package/package.json

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