@salesforce/platform-sdk 11.44.4 → 11.45.0

package/dist/data/index.js

@@ -245,7 +245,7 @@ const w = "Accept-Language", me = (r) => {
     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.44.4", ge = (r) => {
+}, ye = "X-SFDC-Client-Name", be = "X-SFDC-Client-Version", ve = "@salesforce/platform-sdk", Se = "11.45.0", ge = (r) => {
   let e = b(ye, ve, r);
   return e = b(be, Se, e), u(e);
 }, we = "X-CSRF-Token";

package/dist/i18n/index.d.ts

@@ -6,7 +6,7 @@
 export { fetchI18nContext, createSalesforceDetector, reloadI18nContext, } from './salesforce-detector';
 export type { I18nContext } from './salesforce-detector';
 export { SalesforceBackend } from './salesforce-backend';
-export type { SalesforceBackendOptions } from './salesforce-backend';
+export type { SalesforceBackendOptions, LabelFallback } from './salesforce-backend';
 export { createI18nFormatters } from './locale-format';
 export type { I18nFormatters } from './locale-format';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/i18n/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACN,gBAAgB,EAChB,wBAAwB,EACxB,iBAAiB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/i18n/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACN,gBAAgB,EAChB,wBAAwB,EACxB,iBAAiB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EAAE,wBAAwB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/i18n/index.js

@@ -1,9 +1,9 @@
-let s = null;
-async function f(a) {
-  if (s) return s;
-  if (!a.graphql)
+let l = null;
+async function f(n) {
+  if (l) return l;
+  if (!n.graphql)
     throw new Error("Data SDK GraphQL surface unavailable");
-  const t = await a.graphql.query({
+  const r = await n.graphql.query({
     operationName: "I18nDetect",
     query: `
 			query I18nDetect {
@@ -21,29 +21,29 @@ async function f(a) {
 			}
 		`
   });
-  if (!t.data)
+  if (!r.data)
     throw new Error(
-      `I18nDetect query failed: ${JSON.stringify(t.errors ?? "no data, no errors")}`
+      `I18nDetect query failed: ${JSON.stringify(r.errors ?? "no data, no errors")}`
     );
-  const e = t.data.uiapi.platform.i18n;
-  return s = e, e;
+  const e = r.data.uiapi.platform.i18n;
+  return l = e, e;
 }
-async function h(a) {
-  return s = null, f(a);
+async function b(n) {
+  return l = null, f(n);
 }
-function b(a) {
+function g(n) {
   return {
     type: "languageDetector",
     detect() {
-      return s?.lang;
+      return l?.lang;
     }
   };
 }
-const d = `
-	query Labels($ns: String!, $names: [String!]!, $locale: String) {
+const d = "BASE_VALUE", m = `
+	query Labels($ns: String!, $names: [String!]!, $locale: String, $fallback: LabelFallback) {
 		uiapi {
 			platform {
-				labels(namespace: $ns, names: $names, locale: $locale) {
+				labels(namespace: $ns, names: $names, locale: $locale, fallback: $fallback) {
 					name
 					value
 					resolvedLocale
@@ -52,53 +52,58 @@ const d = `
 			}
 		}
 	}
-`, m = 100;
-function p(a, t) {
-  const e = [...new Set(a)], r = [];
-  for (let n = 0; n < e.length; n += t)
-    r.push(e.slice(n, n + t));
-  return r;
+`, p = 100;
+function h(n, r) {
+  const e = [...new Set(n)], t = [];
+  for (let a = 0; a < e.length; a += r)
+    t.push(e.slice(a, a + r));
+  return t;
 }
-function y(a) {
-  const t = {};
-  for (const e of a) {
-    const r = e.indexOf(":");
-    if (r === -1) continue;
-    const n = e.slice(0, r), o = e.slice(r + 1);
-    (t[n] ??= []).push(o);
+function y(n) {
+  const r = {};
+  for (const e of n) {
+    const t = e.indexOf(":");
+    if (t === -1) continue;
+    const a = e.slice(0, t), o = e.slice(t + 1);
+    (r[a] ??= []).push(o);
   }
-  return t;
+  return r;
 }
-class g {
+class w {
   type = "backend";
   static type = "backend";
   options = { dataSDK: {} };
   grouped = {};
-  init(t, e) {
+  init(r, e) {
     this.options = e, this.grouped = y(e.labelManifest ?? []);
   }
-  read(t, e, r) {
-    this.loadLabels(t, e).then((n) => r(null, n)).catch((n) => r(n, !1));
+  read(r, e, t) {
+    this.loadLabels(r, e).then((a) => t(null, a)).catch((a) => t(a, !1));
   }
-  async loadLabels(t, e) {
-    const r = this.grouped[e];
-    if (!r?.length) return {};
-    const { graphql: n } = this.options.dataSDK;
-    if (!n)
+  async loadLabels(r, e) {
+    const t = this.grouped[e];
+    if (!t?.length) return {};
+    const { graphql: a } = this.options.dataSDK;
+    if (!a)
       throw new Error("Data SDK GraphQL surface unavailable");
-    const o = p(r, m), u = await Promise.all(
-      o.map((c) => this.queryBatch(n, e, c, t))
+    const o = h(t, p), u = await Promise.all(
+      o.map((c) => this.queryBatch(a, e, c, r))
     ), i = {};
     for (const c of u)
-      for (const l of c)
-        l.value != null && (i[l.name] = l.value);
+      for (const s of c)
+        s.value != null && (i[s.name] = s.value);
     return i;
   }
-  async queryBatch(t, e, r, n) {
-    const o = await t.query({
+  async queryBatch(r, e, t, a) {
+    const o = await r.query({
       operationName: "Labels",
-      query: d,
-      variables: { ns: e, names: r, locale: n }
+      query: m,
+      variables: {
+        ns: e,
+        names: t,
+        locale: a,
+        fallback: this.options.labelFallback ?? d
+      }
     });
     if (!o.data)
       throw new Error(
@@ -107,36 +112,36 @@ class g {
     return o.data.uiapi.platform.labels;
   }
 }
-function w(a) {
-  const t = a.locale.replace(/_/g, "-") || void 0;
+function L(n) {
+  const r = n.locale.replace(/_/g, "-") || void 0;
   return {
-    formatDate(e, r) {
-      return new Intl.DateTimeFormat(t, {
-        timeZone: a.timeZone || void 0,
-        ...r
+    formatDate(e, t) {
+      return new Intl.DateTimeFormat(r, {
+        timeZone: n.timeZone || void 0,
+        ...t
       }).format(e);
     },
-    formatNumber(e, r) {
-      return new Intl.NumberFormat(t, r).format(e);
+    formatNumber(e, t) {
+      return new Intl.NumberFormat(r, t).format(e);
     },
-    formatCurrency(e, r) {
-      const n = r?.currency ?? a.currency;
-      if (!n)
+    formatCurrency(e, t) {
+      const a = t?.currency ?? n.currency;
+      if (!a)
         throw new Error(
           "createI18nFormatters: formatCurrency requires a currency code, but the i18n context did not provide one and none was passed in options."
         );
-      return new Intl.NumberFormat(t, {
+      return new Intl.NumberFormat(r, {
         style: "currency",
-        ...r,
-        currency: n
+        ...t,
+        currency: a
       }).format(e);
     }
   };
 }
 export {
-  g as SalesforceBackend,
-  w as createI18nFormatters,
-  b as createSalesforceDetector,
+  w as SalesforceBackend,
+  L as createI18nFormatters,
+  g as createSalesforceDetector,
   f as fetchI18nContext,
-  h as reloadI18nContext
+  b as reloadI18nContext
 };

package/dist/i18n/salesforce-backend.d.ts

@@ -1,7 +1,25 @@
 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; `USER_DEFAULT` returns the
+ * logged-in user's language first; `NONE` returns nothing.
+ */
+export type LabelFallback = "BASE_VALUE" | "USER_DEFAULT" | "NONE";
 export interface SalesforceBackendOptions {
     dataSDK: DataSDK;
     labelManifest?: string[];
+    /**
+     * Fallback strategy for labels with no translation for the requested locale.
+     * Defaults to `BASE_VALUE`. Pass `USER_DEFAULT` for the server's old behavior
+     * (prefer the user's language), for example on a guest / b2c site. Pass `NONE`
+     * to suppress fallback entirely: a label with no matching translation is then
+     * absent from the result map.
+     *
+     * Note: the GraphQL `labels()` server default is `USER_DEFAULT`; this SDK opts
+     * into `BASE_VALUE` because it resolves an explicit target locale, so direct
+     * GraphQL callers and the SDK intentionally differ on the default.
+     */
+    labelFallback?: LabelFallback;
 }
 type ReadCallback = (err: unknown, data: Record<string, string> | false) => void;
 export declare class SalesforceBackend {

package/dist/i18n/salesforce-backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"salesforce-backend.d.ts","sourceRoot":"","sources":["../../src/i18n/salesforce-backend.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,MAAM,WAAW,wBAAwB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAeD,KAAK,YAAY,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,KAAK,IAAI,CAAC;AA0CjF,qBAAa,iBAAiB;IAC7B,IAAI,EAAG,SAAS,CAAU;IAC1B,MAAM,CAAC,IAAI,EAAG,SAAS,CAAU;IAEjC,OAAO,CAAC,OAAO,CAA6C;IAC5D,OAAO,CAAC,OAAO,CAAgC;IAE/C,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,wBAAwB,GAAG,IAAI;IAKjE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI;YAMzD,UAAU;YA2BV,UAAU;CAuBxB"}
+{"version":3,"file":"salesforce-backend.d.ts","sourceRoot":"","sources":["../../src/i18n/salesforce-backend.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,cAAc,GAAG,MAAM,CAAC;AASnE,MAAM,WAAW,wBAAwB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB;;;;;;;;;;OAUG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;CAC9B;AAeD,KAAK,YAAY,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,KAAK,IAAI,CAAC;AA0CjF,qBAAa,iBAAiB;IAC7B,IAAI,EAAG,SAAS,CAAU;IAC1B,MAAM,CAAC,IAAI,EAAG,SAAS,CAAU;IAEjC,OAAO,CAAC,OAAO,CAA6C;IAC5D,OAAO,CAAC,OAAO,CAAgC;IAE/C,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,wBAAwB,GAAG,IAAI;IAKjE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI;YAMzD,UAAU;YA2BV,UAAU;CA4BxB"}

package/package.json

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