@salesforce/sdk-view 1.114.0 → 1.115.0

package/dist/index.d.ts

@@ -17,5 +17,6 @@ export interface ViewSDKOptions extends SDKOptions {
  */
 export declare function createViewSDK(options?: ViewSDKOptions): Promise<ViewSDK>;
 export { MCPAppsViewSDK } from './mcpapps';
+export { getViewSDK, getViewSDKSync, resetViewSDK } from './singleton';
 export type { AlertOptions, ModalOptions, SDKOptions, Theme, ThemeMode, ToastOptions, ViewSDK, } from '@salesforce/sdk-core';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAIvF;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,UAAU;IACjD,iEAAiE;IACjE,OAAO,CAAC,EAAE,qBAAqB,CAAC;CAChC;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAyB9E;AAED,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C,YAAY,EACX,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,KAAK,EACL,SAAS,EACT,YAAY,EACZ,OAAO,GACP,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAIvF;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,UAAU;IACjD,iEAAiE;IACjE,OAAO,CAAC,EAAE,qBAAqB,CAAC;CAChC;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAyB9E;AAED,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEvE,YAAY,EACX,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,KAAK,EACL,SAAS,EACT,YAAY,EACZ,OAAO,GACP,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
-import { getSurface as l, Surface as a, McpAppsSession as d } from "@salesforce/sdk-core";
-function p(r) {
-  switch (r) {
+import { getSurface as p, Surface as a, McpAppsSession as f } from "@salesforce/sdk-core";
+function m(s) {
+  switch (s) {
     case "info":
       return "ℹ️";
     case "success":
@@ -13,26 +13,26 @@ function p(r) {
       return "ℹ️";
   }
 }
-function o(r, e) {
-  return `${p(e)} ${r}`;
+function c(s, e) {
+  return `${m(e)} ${s}`;
 }
-function c(r, e) {
-  const s = r.trim();
-  if (s === "")
+function l(s, e) {
+  const t = s.trim();
+  if (t === "")
     return { success: !0, value: void 0 };
-  const t = s.match(/^(\d+(?:\.\d+)?)(px)?$/);
-  if (!t || !t[1])
+  const n = t.match(/^(\d+(?:\.\d+)?)(px)?$/);
+  if (!n || !n[1])
     return {
       success: !1,
-      error: `Invalid ${e}: "${r}". Only pixel values are supported (e.g., "800px" or "800").`
+      error: `Invalid ${e}: "${s}". Only pixel values are supported (e.g., "800px" or "800").`
     };
-  const n = parseFloat(t[1]);
-  return n < 0 || !isFinite(n) ? {
+  const r = parseFloat(n[1]);
+  return r < 0 || !isFinite(r) ? {
     success: !1,
-    error: `Invalid ${e}: "${r}". Value must be a positive number.`
-  } : { success: !0, value: n };
+    error: `Invalid ${e}: "${s}". Value must be a positive number.`
+  } : { success: !0, value: r };
 }
-class m {
+class w {
   constructor(e) {
     this.session = e;
   }
@@ -41,14 +41,14 @@ class m {
    * @param message - The message text
    * @param level - The message severity level (defaults to "info")
    */
-  async sendMessage(e, s = "info") {
-    const t = o(e, s);
+  async sendMessage(e, t = "info") {
+    const n = c(e, t);
     await this.session.request("ui/message", {
       role: "user",
       content: [
         {
           type: "text",
-          text: t
+          text: n
         }
       ]
     });
@@ -66,25 +66,25 @@ class m {
     const e = this.session.getHostContext().theme;
     return e ? { mode: e } : null;
   }
-  async resize(e, s) {
-    const t = c(e, "width");
-    if (!t.success)
-      return Promise.reject(new Error(t.error));
-    const n = c(s, "height");
+  async resize(e, t) {
+    const n = l(e, "width");
     if (!n.success)
       return Promise.reject(new Error(n.error));
-    const i = {};
-    return t.value !== void 0 && (i.width = t.value), n.value !== void 0 && (i.height = n.value), this.session.sendNotification("ui/notifications/size-changed", i), Promise.resolve();
+    const r = l(t, "height");
+    if (!r.success)
+      return Promise.reject(new Error(r.error));
+    const o = {};
+    return n.value !== void 0 && (o.width = n.value), r.value !== void 0 && (o.height = r.value), this.session.sendNotification("ui/notifications/size-changed", o), Promise.resolve();
   }
 }
-class u {
+class d {
   async displayAlert(e) {
-    const s = e.level || "info", t = o(e.message, s);
-    await window.openai.sendFollowUpMessage({ prompt: t });
+    const t = e.level || "info", n = c(e.message, t);
+    await window.openai.sendFollowUpMessage({ prompt: n });
   }
   async displayToast(e) {
-    const s = e.level || "info", t = o(e.message, s);
-    await window.openai.sendFollowUpMessage({ prompt: t });
+    const t = e.level || "info", n = c(e.message, t);
+    await window.openai.sendFollowUpMessage({ prompt: n });
   }
   async displayModal(e) {
     await window.openai.requestModal({
@@ -97,24 +97,37 @@ class u {
     return e ? { mode: e } : null;
   }
 }
-async function w(r) {
-  switch (l(r?.surface)) {
+let i = null, u = null;
+function v(s) {
+  return i || (i = h(s).then((e) => (u = e, e))), i;
+}
+function y() {
+  return u;
+}
+function M() {
+  i = null, u = null;
+}
+async function h(s) {
+  switch (p(s?.surface)) {
     case a.OpenAI:
-      return new u();
+      return new d();
     case a.WebApp:
     case a.MicroFrontend:
       return {};
     case a.SalesforceACC:
       return {};
     case a.MCPApps: {
-      const s = await d.getInstance(r?.mcpApps);
-      return s.handshakeSucceeded ? new m(s) : window.openai ? new u() : {};
+      const t = await f.getInstance(s?.mcpApps);
+      return t.handshakeSucceeded ? new w(t) : window.openai ? new d() : {};
     }
     default:
       return {};
   }
 }
 export {
-  m as MCPAppsViewSDK,
-  w as createViewSDK
+  w as MCPAppsViewSDK,
+  h as createViewSDK,
+  v as getViewSDK,
+  y as getViewSDKSync,
+  M as resetViewSDK
 };

package/dist/singleton.d.ts

@@ -0,0 +1,32 @@
+import { ViewSDK } from '@salesforce/sdk-core';
+import { ViewSDKOptions } from './index';
+/**
+ * Get or create a singleton ViewSDK instance.
+ *
+ * The first caller may provide options (e.g. surface-specific configuration).
+ * Subsequent callers receive the same cached Promise regardless of arguments.
+ *
+ * The Promise itself is cached (not the resolved value) so concurrent callers
+ * do not race to create multiple instances.
+ *
+ * @param options - Optional configuration (only used on first call)
+ * @returns Promise resolving to the shared ViewSDK instance
+ */
+export declare function getViewSDK(options?: ViewSDKOptions): Promise<ViewSDK>;
+/**
+ * Synchronously get the singleton ViewSDK instance.
+ *
+ * Returns the resolved instance if {@link getViewSDK} has already been
+ * called and completed, or `null` if not yet initialized. Use this in
+ * contexts where async is not available (e.g., imperative mosaic components).
+ *
+ * @returns The singleton ViewSDK instance, or null if not yet ready
+ */
+export declare function getViewSDKSync(): ViewSDK | null;
+/**
+ * Reset the singleton ViewSDK cache.
+ *
+ * Useful for testing and session reset scenarios.
+ */
+export declare function resetViewSDK(): void;
+//# sourceMappingURL=singleton.d.ts.map

package/dist/singleton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"singleton.d.ts","sourceRoot":"","sources":["../src/singleton.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAK9C;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAQrE;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,IAAI,OAAO,GAAG,IAAI,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAGnC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/sdk-view",
-  "version": "1.114.0",
+  "version": "1.115.0",
   "license": "SEE LICENSE IN LICENSE.txt",
   "type": "module",
   "main": "./dist/index.js",
@@ -26,7 +26,7 @@
     "test:coverage": "vitest run --coverage"
   },
   "dependencies": {
-    "@salesforce/sdk-core": "^1.114.0"
+    "@salesforce/sdk-core": "^1.115.0"
   },
   "devDependencies": {
     "vite": "^7.3.1",