@salesforce/platform-sdk 11.4.7 → 11.5.0

package/dist/core/view.d.ts

@@ -93,6 +93,19 @@ export interface ModalOptions {
  * alerts, toast notifications, modal dialogs, and managing application state. All methods
  * are optional and may not be available depending on the runtime surface.
  *
+ * ## Events
+ *
+ * A ViewSDK is a DOM {@link EventTarget}: the event API is the native
+ * `addEventListener` / `removeEventListener` / `dispatchEvent`. On surfaces backed by a
+ * host bridge (e.g. the embedded MicroFrontend surface), `dispatchEvent` both notifies
+ * local listeners and forwards the event to the host, and events pushed by the host are
+ * re-dispatched onto the SDK so `addEventListener` hears them too — one unified stream of
+ * host-pushed and same-document events.
+ *
+ * The `EventTarget` members are declared via {@link Partial} so that surfaces without an
+ * event bus (e.g. the WebApp/Mosaic degraded SDK, which is a bare `{}`) still satisfy the
+ * type. Feature-detect before use: `viewSDK.dispatchEvent?.(...)`.
+ *
  * @example
  * ```typescript
  * const viewSDK = await createViewSDK();
@@ -103,11 +116,17 @@ export interface ModalOptions {
  *   level: 'success'
  * });
  *
+ * // Listen for events (host-pushed or same-document) and dispatch your own
+ * viewSDK.addEventListener?.('user-action', (e) => {
+ *   console.log('received:', (e as CustomEvent).detail);
+ * });
+ * viewSDK.dispatchEvent?.(new CustomEvent('user-action', { detail: { action: 'click' } }));
+ *
  * // Mark application as having unsaved changes
  * await viewSDK.markDirtyState?.();
  * ```
  */
-export interface ViewSDK {
+export type ViewSDK = Partial<EventTarget> & {
     /**
      * Display an alert message in the host environment
      *
@@ -225,26 +244,6 @@ export interface ViewSDK {
      * ```
      */
     clearDirtyState?(label?: string): Promise<void>;
-    /**
-     * Dispatch a custom event to the host environment
-     *
-     * This allows the application to send custom events with associated data to the
-     * host. The host can listen for these events and respond accordingly.
-     *
-     * @param event - The event name/type to dispatch
-     * @param data - Associated event data as key-value pairs
-     * @returns Promise that resolves when the event is dispatched
-     *
-     * @example
-     * ```typescript
-     * await viewSDK.dispatchEvent?.('user-action', {
-     *   action: 'click',
-     *   buttonId: 'submit',
-     *   timestamp: Date.now()
-     * });
-     * ```
-     */
-    dispatchEvent?(event: string, data: Record<string, unknown>): Promise<void>;
     /**
      * Get UI properties from the host and subscribe to changes
      *
@@ -310,5 +309,5 @@ export interface ViewSDK {
      * ```
      */
     getTheme?(): Theme | null;
-}
+};
 //# sourceMappingURL=view.d.ts.map

package/dist/core/view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../src/core/view.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,KAAK;IACrB,IAAI,EAAE,SAAS,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC5B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC5B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC5B;;;;;;;;OAQG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,OAAO;IACvB;;;;;;;;;;;;;;;;OAgBG;IACH,YAAY,CAAC,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD;;;;;;;;;;;;;;;;;OAiBG;IACH,YAAY,CAAC,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,YAAY,CAAC,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD;;;;;;;;;;;;;;OAcG;IACH,UAAU,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,cAAc,CAAC,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C;;;;;;;;;;;;;;;;;;OAkBG;IACH,eAAe,CAAC,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD;;;;;;;;;;;;;;;;;;OAkBG;IACH,aAAa,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5E;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,UAAU,CAAC,IAAI;QACd,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QACxC,SAAS,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,KAAK,IAAI,CAAC;KACxE,CAAC;IAEF;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtD;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,IAAI,KAAK,GAAG,IAAI,CAAC;CAC1B"}
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../src/core/view.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,KAAK;IACrB,IAAI,EAAE,SAAS,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC5B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC5B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC5B;;;;;;;;OAQG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG;IAC5C;;;;;;;;;;;;;;;;OAgBG;IACH,YAAY,CAAC,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD;;;;;;;;;;;;;;;;;OAiBG;IACH,YAAY,CAAC,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,YAAY,CAAC,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD;;;;;;;;;;;;;;OAcG;IACH,UAAU,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,cAAc,CAAC,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C;;;;;;;;;;;;;;;;;;OAkBG;IACH,eAAe,CAAC,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,UAAU,CAAC,IAAI;QACd,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QACxC,SAAS,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,KAAK,IAAI,CAAC;KACxE,CAAC;IAEF;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtD;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,IAAI,KAAK,GAAG,IAAI,CAAC;CAC1B,CAAC"}

package/dist/data/index.js

@@ -196,7 +196,7 @@ class ie {
     })).structuredContent;
   }
 }
-const ce = "X-SFDC-Client-Name", ue = "X-SFDC-Client-Version", he = "@salesforce/platform-sdk", le = "11.4.7", de = (t) => {
+const ce = "X-SFDC-Client-Name", ue = "X-SFDC-Client-Version", he = "@salesforce/platform-sdk", le = "11.5.0", de = (t) => {
   let e = y(ce, he, t);
   return e = y(ue, le, e), u(e);
 }, pe = "X-CSRF-Token";

package/dist/view/embedding.d.ts

@@ -1,15 +1,73 @@
 import { ViewSDK } from '../core';
 /** Pixel-only dimension string: bare number or `Npx`. The empty string is allowed so a caller can omit one axis. */
 export type PixelSize = `${number}` | `${number}px` | "";
-/** ViewSDK for the sf-embedding surface; wraps bridge wire-layer primitives. */
-export declare class EmbeddingViewSDK implements ViewSDK {
+/**
+ * ViewSDK for the sf-embedding surface; wraps bridge wire-layer primitives.
+ *
+ * This SDK **is** a DOM {@link EventTarget}: the public event API is the native
+ * `addEventListener` / `removeEventListener` / `dispatchEvent`. Events flow through it in
+ * both directions and are unified into a single stream:
+ *
+ * - **Outbound** — {@link dispatchEvent} both notifies local listeners (via the native
+ *   {@link EventTarget}) *and* forwards the event to the host over the wire.
+ * - **Inbound** — events the host pushes over the wire are re-dispatched onto this
+ *   `EventTarget`, so `addEventListener` consumers hear host-pushed and same-document
+ *   events alike.
+ *
+ * The wire is host-trusted; same-document dispatches are not. Consumers that must trust
+ * the origin of an event should validate its payload rather than assume it came from the
+ * host.
+ */
+export declare class EmbeddingViewSDK extends EventTarget implements ViewSDK {
     private readonly session;
     static create(): Promise<EmbeddingViewSDK>;
     private constructor();
+    /**
+     * Dispatch a custom event.
+     *
+     * Overrides {@link EventTarget.dispatchEvent} to be symmetric across both channels an
+     * embedded bundle can reach: it forwards the event to the host over the wire **and**
+     * notifies local listeners on this `EventTarget`. A {@link CustomEvent}'s `detail` is
+     * the payload sent to the host; a plain `Event` (no `detail`) is delivered to local
+     * listeners only, since there is nothing to carry over the wire.
+     *
+     * A bundle's own dispatch reaches its own listeners exactly once — synchronously, here
+     * — and is not echoed back: the host does not relay a bundle's own dispatch down the
+     * wire to the originating iframe (inbound re-dispatch goes through `super.dispatchEvent`,
+     * never back out through this override).
+     *
+     * @param event - The event to dispatch. Use a {@link CustomEvent} to carry a payload.
+     * @returns `false` if the event is cancelable and a listener called `preventDefault()`,
+     *   otherwise `true` (native {@link EventTarget} semantics).
+     */
+    dispatchEvent(event: Event): boolean;
     markDirtyState(label?: string): Promise<void>;
     clearDirtyState(label?: string): Promise<void>;
     /** Resize the embedded surface. Pass `""` for either axis to leave it unchanged; both empty is a no-op. */
     resize(width: PixelSize, height: PixelSize): Promise<void>;
+    /**
+     * Send an event to the host over the wire. Private wire-layer plumbing; the public
+     * entry point is {@link dispatchEvent}, which calls this in addition to notifying
+     * local listeners.
+     */
+    private dispatchHostEvent;
+    /**
+     * Open the host's event stream and pipe inbound host-pushed events onto this
+     * `EventTarget`, so `addEventListener` consumers hear them alongside same-document
+     * dispatches. Private wire-layer plumbing, opened once per session — the bridge
+     * delivers a single stream and per-type fan-out is the native `EventTarget`'s job
+     * ("one subscription per session").
+     *
+     * Inbound events are re-dispatched through `super.dispatchEvent`, not the
+     * {@link dispatchEvent} override, so a host push notifies local listeners without
+     * being echoed straight back up the wire.
+     *
+     * Best-effort: if the subscription cannot be opened, inbound host events simply do not
+     * arrive; outbound {@link dispatchEvent} and every other method still work. The wire is
+     * not explicitly torn down — it lives for the session and is released when the bridge
+     * is disposed.
+     */
+    private subscribeToHostEvent;
     private setDirty;
 }
 //# sourceMappingURL=embedding.d.ts.map

package/dist/view/embedding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"embedding.d.ts","sourceRoot":"","sources":["../../src/view/embedding.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAMvC,oHAAoH;AACpH,MAAM,MAAM,SAAS,GAAG,GAAG,MAAM,EAAE,GAAG,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC;AAEzD,gFAAgF;AAChF,qBAAa,gBAAiB,YAAW,OAAO;IAM3B,OAAO,CAAC,QAAQ,CAAC,OAAO;WAL/B,MAAM,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAKhD,OAAO;IAED,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,eAAe,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD,2GAA2G;IACrG,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAYhE,OAAO,CAAC,QAAQ;CAOhB"}
+{"version":3,"file":"embedding.d.ts","sourceRoot":"","sources":["../../src/view/embedding.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAMvC,oHAAoH;AACpH,MAAM,MAAM,SAAS,GAAG,GAAG,MAAM,EAAE,GAAG,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC;AAEzD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,gBAAiB,SAAQ,WAAY,YAAW,OAAO;IAQ/C,OAAO,CAAC,QAAQ,CAAC,OAAO;WAP/B,MAAM,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAOhD,OAAO;IAIP;;;;;;;;;;;;;;;;;OAiBG;IACM,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IA0BvC,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,eAAe,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD,2GAA2G;IACrG,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAYhE;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;;;;;;;;;;;;;;OAeG;YACW,oBAAoB;IAyBlC,OAAO,CAAC,QAAQ;CAOhB"}

package/dist/view/index.js

@@ -1,7 +1,7 @@
-import { g as w, S as a, a as h } from "../surface-Dd2tqrPi.js";
-import { w as m } from "../sdk-promise-D0sy7OW1.js";
-import { requireSharedSession as f } from "../sf-embedding/index.js";
-function p(n) {
+import { g as h, S as i, a as p } from "../surface-Dd2tqrPi.js";
+import { w } from "../sdk-promise-D0sy7OW1.js";
+import { requireSharedSession as m } from "../sf-embedding/index.js";
+function f(n) {
   switch (n) {
     case "info":
       return "ℹ️";
@@ -15,33 +15,67 @@ function p(n) {
       return "ℹ️";
   }
 }
-function u(n, e) {
-  return `${p(e)} ${n}`;
+function l(n, e) {
+  return `${f(e)} ${n}`;
 }
 function o(n, e) {
-  const t = n.trim();
-  if (t === "")
+  const s = n.trim();
+  if (s === "")
     return { success: !0, value: void 0 };
-  const s = t.match(/^(\d+(?:\.\d+)?)(px)?$/);
-  if (!s || !s[1])
+  const t = s.match(/^(\d+(?:\.\d+)?)(px)?$/);
+  if (!t || !t[1])
     return {
       success: !1,
       error: `Invalid ${e}: "${n}". Only pixel values are supported (e.g., "800px" or "800").`
     };
-  const r = parseFloat(s[1]);
+  const r = parseFloat(t[1]);
   return r < 0 || !isFinite(r) ? {
     success: !1,
     error: `Invalid ${e}: "${n}". Value must be a positive number.`
   } : { success: !0, value: r };
 }
-const g = "trackdirtystate";
-class l {
+const v = "trackdirtystate";
+class u extends EventTarget {
   constructor(e) {
-    this.session = e;
+    super(), this.session = e;
   }
   static async create() {
-    const e = await f("EmbeddingViewSDK");
-    return new l(e);
+    const e = await m("EmbeddingViewSDK"), s = new u(e);
+    return await s.subscribeToHostEvent(), s;
+  }
+  /**
+   * Dispatch a custom event.
+   *
+   * Overrides {@link EventTarget.dispatchEvent} to be symmetric across both channels an
+   * embedded bundle can reach: it forwards the event to the host over the wire **and**
+   * notifies local listeners on this `EventTarget`. A {@link CustomEvent}'s `detail` is
+   * the payload sent to the host; a plain `Event` (no `detail`) is delivered to local
+   * listeners only, since there is nothing to carry over the wire.
+   *
+   * A bundle's own dispatch reaches its own listeners exactly once — synchronously, here
+   * — and is not echoed back: the host does not relay a bundle's own dispatch down the
+   * wire to the originating iframe (inbound re-dispatch goes through `super.dispatchEvent`,
+   * never back out through this override).
+   *
+   * @param event - The event to dispatch. Use a {@link CustomEvent} to carry a payload.
+   * @returns `false` if the event is cancelable and a listener called `preventDefault()`,
+   *   otherwise `true` (native {@link EventTarget} semantics).
+   */
+  dispatchEvent(e) {
+    if (e instanceof CustomEvent)
+      try {
+        this.dispatchHostEvent(e.type, e.detail, {
+          bubbles: e.bubbles,
+          composed: e.composed,
+          cancelable: e.cancelable
+        });
+      } catch (s) {
+        console.warn(
+          `[EmbeddingViewSDK] wire dispatch failed for "${e.type}"; local listeners will still fire`,
+          s
+        );
+      }
+    return super.dispatchEvent(e);
   }
   async markDirtyState(e) {
     this.setDirty(!0, e);
@@ -50,25 +84,70 @@ class l {
     this.setDirty(!1, e);
   }
   /** Resize the embedded surface. Pass `""` for either axis to leave it unchanged; both empty is a no-op. */
-  async resize(e, t) {
-    const s = o(e, "width");
-    if (!s.success) throw new Error(s.error);
-    const r = o(t, "height");
+  async resize(e, s) {
+    const t = o(e, "width");
+    if (!t.success) throw new Error(t.error);
+    const r = o(s, "height");
     if (!r.success) throw new Error(r.error);
-    s.value === void 0 && r.value === void 0 || this.session.bridge.sendResize({
-      ...s.value !== void 0 ? { width: s.value } : {},
+    t.value === void 0 && r.value === void 0 || this.session.bridge.sendResize({
+      ...t.value !== void 0 ? { width: t.value } : {},
       ...r.value !== void 0 ? { height: r.value } : {}
     });
   }
-  setDirty(e, t) {
-    this.session.bridge.sendEventDispatch(g, {
+  /**
+   * Send an event to the host over the wire. Private wire-layer plumbing; the public
+   * entry point is {@link dispatchEvent}, which calls this in addition to notifying
+   * local listeners.
+   */
+  dispatchHostEvent(e, s, t) {
+    this.session.bridge.sendEventDispatch(e, s, t);
+  }
+  /**
+   * Open the host's event stream and pipe inbound host-pushed events onto this
+   * `EventTarget`, so `addEventListener` consumers hear them alongside same-document
+   * dispatches. Private wire-layer plumbing, opened once per session — the bridge
+   * delivers a single stream and per-type fan-out is the native `EventTarget`'s job
+   * ("one subscription per session").
+   *
+   * Inbound events are re-dispatched through `super.dispatchEvent`, not the
+   * {@link dispatchEvent} override, so a host push notifies local listeners without
+   * being echoed straight back up the wire.
+   *
+   * Best-effort: if the subscription cannot be opened, inbound host events simply do not
+   * arrive; outbound {@link dispatchEvent} and every other method still work. The wire is
+   * not explicitly torn down — it lives for the session and is released when the bridge
+   * is disposed.
+   */
+  async subscribeToHostEvent() {
+    const e = this.session.bridge;
+    e.onEventDispatch((s) => {
+      super.dispatchEvent(
+        new CustomEvent(s.eventType, {
+          detail: s.detail,
+          bubbles: s.bubbles ?? !0,
+          composed: s.composed ?? !0,
+          cancelable: s.cancelable ?? !1
+        })
+      );
+    });
+    try {
+      await e.sendEventSubscribe();
+    } catch (s) {
+      console.warn(
+        "[EmbeddingViewSDK] host event subscription failed; inbound host events will not be delivered",
+        s
+      );
+    }
+  }
+  setDirty(e, s) {
+    this.session.bridge.sendEventDispatch(v, {
       isDirty: e,
       instanceId: this.session.hostMetaData.instanceId,
-      label: t ?? ""
+      label: s ?? ""
     });
   }
 }
-class v {
+class g {
   constructor(e) {
     this.session = e;
   }
@@ -77,14 +156,14 @@ class v {
    * @param message - The message text
    * @param level - The message severity level (defaults to "info")
    */
-  async sendMessage(e, t = "info") {
-    const s = u(e, t);
+  async sendMessage(e, s = "info") {
+    const t = l(e, s);
     await this.session.request("ui/message", {
       role: "user",
       content: [
         {
           type: "text",
-          text: s
+          text: t
         }
       ]
     });
@@ -102,25 +181,25 @@ class v {
     const e = this.session.getHostContext().theme;
     return e ? { mode: e } : null;
   }
-  async resize(e, t) {
-    const s = o(e, "width");
-    if (!s.success)
-      return Promise.reject(new Error(s.error));
-    const r = o(t, "height");
+  async resize(e, s) {
+    const t = o(e, "width");
+    if (!t.success)
+      return Promise.reject(new Error(t.error));
+    const r = o(s, "height");
     if (!r.success)
       return Promise.reject(new Error(r.error));
     const c = {};
-    return s.value !== void 0 && (c.width = s.value), r.value !== void 0 && (c.height = r.value), this.session.sendNotification("ui/notifications/size-changed", c), Promise.resolve();
+    return t.value !== void 0 && (c.width = t.value), r.value !== void 0 && (c.height = r.value), this.session.sendNotification("ui/notifications/size-changed", c), Promise.resolve();
   }
 }
-class y {
+class b {
   async displayAlert(e) {
-    const t = e.level || "info", s = u(e.message, t);
-    await window.openai.sendFollowUpMessage({ prompt: s });
+    const s = e.level || "info", t = l(e.message, s);
+    await window.openai.sendFollowUpMessage({ prompt: t });
   }
   async displayToast(e) {
-    const t = e.level || "info", s = u(e.message, t);
-    await window.openai.sendFollowUpMessage({ prompt: s });
+    const s = e.level || "info", t = l(e.message, s);
+    await window.openai.sendFollowUpMessage({ prompt: t });
   }
   async displayModal(e) {
     await window.openai.requestModal({
@@ -133,31 +212,31 @@ class y {
     return e ? { mode: e } : null;
   }
 }
-let i = null, d = null;
-function A(n) {
-  return i || (i = S(n).then((e) => (d = e, e))), i;
+let a = null, d = null;
+function M(n) {
+  return a || (a = y(n).then((e) => (d = e, e))), a;
 }
-function E() {
+function T() {
   return d;
 }
-function I() {
-  i = null, d = null;
+function V() {
+  a = null, d = null;
 }
-function S(n) {
-  return m(
+function y(n) {
+  return w(
     (async () => {
       try {
-        switch (await w(n?.surface)) {
-          case a.OpenAI:
-            return new y();
-          case a.WebApp:
-          case a.Mosaic:
+        switch (await h(n?.surface)) {
+          case i.OpenAI:
+            return new b();
+          case i.WebApp:
+          case i.Mosaic:
             return {};
-          case a.MicroFrontend:
-            return await l.create();
-          case a.MCPApps: {
-            const t = await h.getInstance();
-            return new v(t);
+          case i.MicroFrontend:
+            return await u.create();
+          case i.MCPApps: {
+            const s = await p.getInstance();
+            return new g(s);
           }
           default:
             return {};
@@ -170,9 +249,9 @@ function S(n) {
   );
 }
 export {
-  v as MCPAppsViewSDK,
-  S as createViewSDK,
-  A as getViewSDK,
-  E as getViewSDKSync,
-  I as resetViewSDK
+  g as MCPAppsViewSDK,
+  y as createViewSDK,
+  M as getViewSDK,
+  T as getViewSDKSync,
+  V as resetViewSDK
 };

package/package.json

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