@proteos/component-sdk 0.55.0 → 0.57.0

package/dist/{chunk-RTYCYWKC.js → chunk-CHUMJ4XR.js}

@@ -9,5 +9,5 @@ function isRuntimeMessage(data) {
 }
 
 export { COMPONENT_OVERLAY_Z_INDEX, MESSAGE_SOURCE, isHostMessage, isRuntimeMessage };
-//# sourceMappingURL=chunk-RTYCYWKC.js.map
-//# sourceMappingURL=chunk-RTYCYWKC.js.map
+//# sourceMappingURL=chunk-CHUMJ4XR.js.map
+//# sourceMappingURL=chunk-CHUMJ4XR.js.map

package/dist/chunk-CHUMJ4XR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/protocol.ts"],"names":[],"mappings":";AAUO,IAAM,cAAA,GAAiB;AAuBvB,IAAM,yBAAA,GAA4B;AA8LlC,SAAS,cAAc,IAAA,EAA8C;AAC1E,EAAA,OACE,OAAO,IAAA,KAAS,QAAA,IAChB,IAAA,KAAS,IAAA,IACR,KAA8B,MAAA,KAAW,cAAA,IAC1C,OAAQ,IAAA,CAA4B,IAAA,KAAS,QAAA;AAEjD;AAEO,SAAS,iBAAiB,IAAA,EAAiD;AAChF,EAAA,OACE,OAAO,IAAA,KAAS,QAAA,IAChB,IAAA,KAAS,IAAA,IACR,KAA8B,MAAA,KAAW,cAAA,IAC1C,OAAQ,IAAA,CAA4B,IAAA,KAAS,QAAA;AAEjD","file":"chunk-CHUMJ4XR.js","sourcesContent":["// postMessage protocol between the host page and the component-runtime iframe.\n// This is the single source of truth for the wire contract: the host renderer\n// (clients/web .../component-frame.tsx), the runtime shell\n// (clients/web/component-runtime/shell.tsx), and the author-facing hooks\n// (this package's RuntimeProvider / useNavigate) all import these same types so\n// every end stays in lockstep.\n//\n// Every message carries `source: MESSAGE_SOURCE` so we can ignore the unrelated\n// postMessage traffic that shares the window (OIDC silent-renew, Vite HMR, …).\n\nexport const MESSAGE_SOURCE = 'proteos-component-runtime' as const\n\n/**\n * z-index the component iframe is promoted to while one of its own overlays\n * (modal, popover, menu, select, tooltip) is open. The iframe goes\n * `position: fixed; inset: 0` at this z so the overlay — which portals to the\n * IFRAME's body and would otherwise clip at the frame's box — can paint over\n * the rest of the page.\n *\n * Host z ladder this slots into:\n *   50    @proteos/ui Modal / Tooltip / ImageLightbox (default tier)\n *   1000+ full-page panel stack (scrim 1000, panels 1001+n)\n *   1090  peek scrim   1100  peek panel, ask-proteos window\n *   1150  ← THIS\n *   1200  menu popover, command palette, action dialog, component modal\n *   1300  select popover\n *\n * Above the peek/full-page surfaces a component can live on, below the global\n * host chrome. Note the cap: inside a peek (a `fixed` + z-index ancestor) the\n * promoted iframe paints within that 1100 stacking context — it covers the\n * peek's own content and everything under it, but host chrome at 1200+ still\n * wins. That is the intended layering, not a bug.\n */\nexport const COMPONENT_OVERLAY_Z_INDEX = 1150\n\n/** Viewport-relative box of the iframe's in-flow placeholder, in CSS px. */\nexport interface OverlayRect {\n  top: number\n  left: number\n  width: number\n  height: number\n}\n\nexport interface PageContext {\n  record?: Record<string, unknown>\n  entity?: { slug: string; [key: string]: unknown }\n  params?: Record<string, unknown>\n  /** The signed-in viewer (absent on public pages and offline previews). The\n   *  host resolves `{{ current_user.* }}` and the bare `current_user` prop\n   *  sentinel against it before posting props. */\n  current_user?: { id: string; email: string; given_name: string; family_name: string }\n  [key: string]: unknown\n}\n\n// ── Host → runtime ──────────────────────────────────────────────────────────\n\nexport interface InitMessage {\n  type: 'INIT'\n  /** Raw bearer token (the OIDC `id_token`). The runtime's ProteosClient\n   *  prepends `Bearer ` when building the Authorization header, so the host\n   *  sends the token verbatim — NOT a full `Bearer …` header value.\n   *  Empty string in public mode (`isPublic: true`). */\n  authToken: string\n  /** API origin the bundle endpoint + SDK calls resolve against. */\n  apiBaseUrl: string\n  /** Resolved props for the component (Liquid templating happens host-side). */\n  props: Record<string, unknown>\n  pageCtx: PageContext\n  /** PUBLIC mode: the component renders on an unauthenticated public page.\n   *  The shell fetches the bundle from the public endpoint (no bearer) and\n   *  injects a restricted sdk — only `functions.actions.invokePublic` reaches\n   *  the platform. Requires `orgId`. */\n  isPublic?: boolean\n  /** Org id for public mode — public endpoints carry the org in the path\n   *  because there is no token to scope from. */\n  orgId?: string\n  /** Set when this frame is the CONTENT of a host component modal (opened by\n   *  another component via OPEN_MODAL). The component reads it through\n   *  `useModalHost()` and closes with a result by posting MODAL_RESULT with\n   *  this id. Absent on ordinary page-hosted frames. */\n  modalRequestId?: string\n}\n\nexport interface AuthRefreshMessage {\n  type: 'AUTH_REFRESH'\n  token: string\n}\n\nexport interface DataInvalidateMessage {\n  type: 'DATA_INVALIDATE'\n  queryKey?: unknown[]\n}\n\n/** Where the iframe's in-flow box sits in the host viewport. Sent while the\n *  frame is promoted (OVERLAY_STATE open) so the runtime can keep its content\n *  parked at the original rect while the iframe itself covers the viewport —\n *  and re-sent when the host window resizes under an open overlay. */\nexport interface OverlayRectMessage {\n  type: 'OVERLAY_RECT'\n  rect: OverlayRect\n}\n\n/** Resolution of an OPEN_MODAL request: the host modal closed. `result` is the\n *  value the modal's component passed to MODAL_RESULT, and is absent when the\n *  modal was dismissed (backdrop / Esc / ×). */\nexport interface ModalClosedMessage {\n  type: 'MODAL_CLOSED'\n  requestId: string\n  result?: unknown\n}\n\nexport type HostMessage =\n  | InitMessage\n  | AuthRefreshMessage\n  | DataInvalidateMessage\n  | OverlayRectMessage\n  | ModalClosedMessage\n\n// ── Runtime → host ──────────────────────────────────────────────────────────\n\nexport interface ReadyMessage {\n  type: 'READY'\n}\n\nexport interface ResizeMessage {\n  type: 'RESIZE'\n  height: number\n}\n\nexport interface NavigateMessage {\n  type: 'NAVIGATE'\n  to: string\n}\n\n/** Open an in-app path in a peek (slide-over) panel instead of full-page\n *  navigation. Same `/…` in-app path grammar as NAVIGATE; the host decides\n *  what can peek (today: platform pages) and falls back to NAVIGATE otherwise. */\nexport interface OpenPeekMessage {\n  type: 'OPEN_PEEK'\n  to: string\n}\n\n/** Ask the host to open a prepared call: the host shows the conversation brief's\n *  preview (its softphone owns the dial) and lets the user place the call.\n *  Ignored on public pages and on hosts without a softphone. */\nexport interface OpenCallMessage {\n  type: 'OPEN_CALL'\n  /** The conversation brief to preview and dial from. */\n  conversationBriefId: string\n}\n\n/** The runtime has (or no longer has) an overlay open and needs the host to\n *  promote (or restore) the iframe. See {@link COMPONENT_OVERLAY_Z_INDEX}.\n *\n *  Same-origin today, so the runtime applies the promotion styles to its own\n *  `window.frameElement` synchronously (pre-paint, no flicker) and this message\n *  is the host's cue to MIRROR that state into React — gate RESIZE, hold the\n *  placeholder height, start posting OVERLAY_RECT. When components move to a\n *  dedicated origin the runtime can no longer touch the frame and this message\n *  becomes the actuation instead; the runtime hides its overlay until the\n *  answering OVERLAY_RECT arrives. */\nexport interface OverlayStateMessage {\n  type: 'OVERLAY_STATE'\n  open: boolean\n}\n\n/** Ask the host to open ANOTHER component in a central modal, above everything\n *  this frame could reach on its own. The host answers with MODAL_CLOSED\n *  carrying the same `requestId`. */\nexport interface OpenModalMessage {\n  type: 'OPEN_MODAL'\n  /** Correlates the eventual MODAL_CLOSED. Generated by the opener. */\n  requestId: string\n  /** Slug of the component to mount inside the modal. */\n  componentSlug: string\n  /** Props for that component (already literal values — no Liquid). */\n  props?: Record<string, unknown>\n  /** Optional modal heading. */\n  title?: string\n}\n\n/** Escape was pressed with focus inside the iframe, and nothing in the runtime\n *  consumed it.\n *\n *  Keyboard events don't cross the iframe boundary, and react-aria binds its\n *  Escape handling to the overlay element in its own React tree — so a\n *  host-rendered dialog CANNOT see Escape once the user has clicked into a\n *  component. The runtime forwards it so the host can dismiss on the user's\n *  behalf. Not sent while the runtime has its own overlay open: that overlay\n *  owns Escape. */\nexport interface EscapePressedMessage {\n  type: 'ESCAPE_PRESSED'\n}\n\n/** Posted by the component INSIDE a host modal to close it with a value. The\n *  `requestId` is the one INIT carried as `modalRequestId`. */\nexport interface ModalResultMessage {\n  type: 'MODAL_RESULT'\n  requestId: string\n  result?: unknown\n}\n\nexport interface ErrorMessage {\n  type: 'ERROR'\n  message: string\n  stack?: string\n}\n\nexport type RuntimeMessage =\n  | ReadyMessage\n  | ResizeMessage\n  | NavigateMessage\n  | OpenPeekMessage\n  | OpenCallMessage\n  | OverlayStateMessage\n  | OpenModalMessage\n  | ModalResultMessage\n  | EscapePressedMessage\n  | ErrorMessage\n\n// Wire envelope: the message plus the source discriminator.\nexport type Envelope<T> = T & { source: typeof MESSAGE_SOURCE }\n\nexport function isHostMessage(data: unknown): data is Envelope<HostMessage> {\n  return (\n    typeof data === 'object' &&\n    data !== null &&\n    (data as { source?: unknown }).source === MESSAGE_SOURCE &&\n    typeof (data as { type?: unknown }).type === 'string'\n  )\n}\n\nexport function isRuntimeMessage(data: unknown): data is Envelope<RuntimeMessage> {\n  return (\n    typeof data === 'object' &&\n    data !== null &&\n    (data as { source?: unknown }).source === MESSAGE_SOURCE &&\n    typeof (data as { type?: unknown }).type === 'string'\n  )\n}\n"]}

package/dist/{chunk-IPYKNCDU.cjs → chunk-HKILZLGW.cjs}

@@ -14,5 +14,5 @@ exports.COMPONENT_OVERLAY_Z_INDEX = COMPONENT_OVERLAY_Z_INDEX;
 exports.MESSAGE_SOURCE = MESSAGE_SOURCE;
 exports.isHostMessage = isHostMessage;
 exports.isRuntimeMessage = isRuntimeMessage;
-//# sourceMappingURL=chunk-IPYKNCDU.cjs.map
-//# sourceMappingURL=chunk-IPYKNCDU.cjs.map
+//# sourceMappingURL=chunk-HKILZLGW.cjs.map
+//# sourceMappingURL=chunk-HKILZLGW.cjs.map

package/dist/chunk-HKILZLGW.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/protocol.ts"],"names":[],"mappings":";;;AAUO,IAAM,cAAA,GAAiB;AAuBvB,IAAM,yBAAA,GAA4B;AA8LlC,SAAS,cAAc,IAAA,EAA8C;AAC1E,EAAA,OACE,OAAO,IAAA,KAAS,QAAA,IAChB,IAAA,KAAS,IAAA,IACR,KAA8B,MAAA,KAAW,cAAA,IAC1C,OAAQ,IAAA,CAA4B,IAAA,KAAS,QAAA;AAEjD;AAEO,SAAS,iBAAiB,IAAA,EAAiD;AAChF,EAAA,OACE,OAAO,IAAA,KAAS,QAAA,IAChB,IAAA,KAAS,IAAA,IACR,KAA8B,MAAA,KAAW,cAAA,IAC1C,OAAQ,IAAA,CAA4B,IAAA,KAAS,QAAA;AAEjD","file":"chunk-HKILZLGW.cjs","sourcesContent":["// postMessage protocol between the host page and the component-runtime iframe.\n// This is the single source of truth for the wire contract: the host renderer\n// (clients/web .../component-frame.tsx), the runtime shell\n// (clients/web/component-runtime/shell.tsx), and the author-facing hooks\n// (this package's RuntimeProvider / useNavigate) all import these same types so\n// every end stays in lockstep.\n//\n// Every message carries `source: MESSAGE_SOURCE` so we can ignore the unrelated\n// postMessage traffic that shares the window (OIDC silent-renew, Vite HMR, …).\n\nexport const MESSAGE_SOURCE = 'proteos-component-runtime' as const\n\n/**\n * z-index the component iframe is promoted to while one of its own overlays\n * (modal, popover, menu, select, tooltip) is open. The iframe goes\n * `position: fixed; inset: 0` at this z so the overlay — which portals to the\n * IFRAME's body and would otherwise clip at the frame's box — can paint over\n * the rest of the page.\n *\n * Host z ladder this slots into:\n *   50    @proteos/ui Modal / Tooltip / ImageLightbox (default tier)\n *   1000+ full-page panel stack (scrim 1000, panels 1001+n)\n *   1090  peek scrim   1100  peek panel, ask-proteos window\n *   1150  ← THIS\n *   1200  menu popover, command palette, action dialog, component modal\n *   1300  select popover\n *\n * Above the peek/full-page surfaces a component can live on, below the global\n * host chrome. Note the cap: inside a peek (a `fixed` + z-index ancestor) the\n * promoted iframe paints within that 1100 stacking context — it covers the\n * peek's own content and everything under it, but host chrome at 1200+ still\n * wins. That is the intended layering, not a bug.\n */\nexport const COMPONENT_OVERLAY_Z_INDEX = 1150\n\n/** Viewport-relative box of the iframe's in-flow placeholder, in CSS px. */\nexport interface OverlayRect {\n  top: number\n  left: number\n  width: number\n  height: number\n}\n\nexport interface PageContext {\n  record?: Record<string, unknown>\n  entity?: { slug: string; [key: string]: unknown }\n  params?: Record<string, unknown>\n  /** The signed-in viewer (absent on public pages and offline previews). The\n   *  host resolves `{{ current_user.* }}` and the bare `current_user` prop\n   *  sentinel against it before posting props. */\n  current_user?: { id: string; email: string; given_name: string; family_name: string }\n  [key: string]: unknown\n}\n\n// ── Host → runtime ──────────────────────────────────────────────────────────\n\nexport interface InitMessage {\n  type: 'INIT'\n  /** Raw bearer token (the OIDC `id_token`). The runtime's ProteosClient\n   *  prepends `Bearer ` when building the Authorization header, so the host\n   *  sends the token verbatim — NOT a full `Bearer …` header value.\n   *  Empty string in public mode (`isPublic: true`). */\n  authToken: string\n  /** API origin the bundle endpoint + SDK calls resolve against. */\n  apiBaseUrl: string\n  /** Resolved props for the component (Liquid templating happens host-side). */\n  props: Record<string, unknown>\n  pageCtx: PageContext\n  /** PUBLIC mode: the component renders on an unauthenticated public page.\n   *  The shell fetches the bundle from the public endpoint (no bearer) and\n   *  injects a restricted sdk — only `functions.actions.invokePublic` reaches\n   *  the platform. Requires `orgId`. */\n  isPublic?: boolean\n  /** Org id for public mode — public endpoints carry the org in the path\n   *  because there is no token to scope from. */\n  orgId?: string\n  /** Set when this frame is the CONTENT of a host component modal (opened by\n   *  another component via OPEN_MODAL). The component reads it through\n   *  `useModalHost()` and closes with a result by posting MODAL_RESULT with\n   *  this id. Absent on ordinary page-hosted frames. */\n  modalRequestId?: string\n}\n\nexport interface AuthRefreshMessage {\n  type: 'AUTH_REFRESH'\n  token: string\n}\n\nexport interface DataInvalidateMessage {\n  type: 'DATA_INVALIDATE'\n  queryKey?: unknown[]\n}\n\n/** Where the iframe's in-flow box sits in the host viewport. Sent while the\n *  frame is promoted (OVERLAY_STATE open) so the runtime can keep its content\n *  parked at the original rect while the iframe itself covers the viewport —\n *  and re-sent when the host window resizes under an open overlay. */\nexport interface OverlayRectMessage {\n  type: 'OVERLAY_RECT'\n  rect: OverlayRect\n}\n\n/** Resolution of an OPEN_MODAL request: the host modal closed. `result` is the\n *  value the modal's component passed to MODAL_RESULT, and is absent when the\n *  modal was dismissed (backdrop / Esc / ×). */\nexport interface ModalClosedMessage {\n  type: 'MODAL_CLOSED'\n  requestId: string\n  result?: unknown\n}\n\nexport type HostMessage =\n  | InitMessage\n  | AuthRefreshMessage\n  | DataInvalidateMessage\n  | OverlayRectMessage\n  | ModalClosedMessage\n\n// ── Runtime → host ──────────────────────────────────────────────────────────\n\nexport interface ReadyMessage {\n  type: 'READY'\n}\n\nexport interface ResizeMessage {\n  type: 'RESIZE'\n  height: number\n}\n\nexport interface NavigateMessage {\n  type: 'NAVIGATE'\n  to: string\n}\n\n/** Open an in-app path in a peek (slide-over) panel instead of full-page\n *  navigation. Same `/…` in-app path grammar as NAVIGATE; the host decides\n *  what can peek (today: platform pages) and falls back to NAVIGATE otherwise. */\nexport interface OpenPeekMessage {\n  type: 'OPEN_PEEK'\n  to: string\n}\n\n/** Ask the host to open a prepared call: the host shows the conversation brief's\n *  preview (its softphone owns the dial) and lets the user place the call.\n *  Ignored on public pages and on hosts without a softphone. */\nexport interface OpenCallMessage {\n  type: 'OPEN_CALL'\n  /** The conversation brief to preview and dial from. */\n  conversationBriefId: string\n}\n\n/** The runtime has (or no longer has) an overlay open and needs the host to\n *  promote (or restore) the iframe. See {@link COMPONENT_OVERLAY_Z_INDEX}.\n *\n *  Same-origin today, so the runtime applies the promotion styles to its own\n *  `window.frameElement` synchronously (pre-paint, no flicker) and this message\n *  is the host's cue to MIRROR that state into React — gate RESIZE, hold the\n *  placeholder height, start posting OVERLAY_RECT. When components move to a\n *  dedicated origin the runtime can no longer touch the frame and this message\n *  becomes the actuation instead; the runtime hides its overlay until the\n *  answering OVERLAY_RECT arrives. */\nexport interface OverlayStateMessage {\n  type: 'OVERLAY_STATE'\n  open: boolean\n}\n\n/** Ask the host to open ANOTHER component in a central modal, above everything\n *  this frame could reach on its own. The host answers with MODAL_CLOSED\n *  carrying the same `requestId`. */\nexport interface OpenModalMessage {\n  type: 'OPEN_MODAL'\n  /** Correlates the eventual MODAL_CLOSED. Generated by the opener. */\n  requestId: string\n  /** Slug of the component to mount inside the modal. */\n  componentSlug: string\n  /** Props for that component (already literal values — no Liquid). */\n  props?: Record<string, unknown>\n  /** Optional modal heading. */\n  title?: string\n}\n\n/** Escape was pressed with focus inside the iframe, and nothing in the runtime\n *  consumed it.\n *\n *  Keyboard events don't cross the iframe boundary, and react-aria binds its\n *  Escape handling to the overlay element in its own React tree — so a\n *  host-rendered dialog CANNOT see Escape once the user has clicked into a\n *  component. The runtime forwards it so the host can dismiss on the user's\n *  behalf. Not sent while the runtime has its own overlay open: that overlay\n *  owns Escape. */\nexport interface EscapePressedMessage {\n  type: 'ESCAPE_PRESSED'\n}\n\n/** Posted by the component INSIDE a host modal to close it with a value. The\n *  `requestId` is the one INIT carried as `modalRequestId`. */\nexport interface ModalResultMessage {\n  type: 'MODAL_RESULT'\n  requestId: string\n  result?: unknown\n}\n\nexport interface ErrorMessage {\n  type: 'ERROR'\n  message: string\n  stack?: string\n}\n\nexport type RuntimeMessage =\n  | ReadyMessage\n  | ResizeMessage\n  | NavigateMessage\n  | OpenPeekMessage\n  | OpenCallMessage\n  | OverlayStateMessage\n  | OpenModalMessage\n  | ModalResultMessage\n  | EscapePressedMessage\n  | ErrorMessage\n\n// Wire envelope: the message plus the source discriminator.\nexport type Envelope<T> = T & { source: typeof MESSAGE_SOURCE }\n\nexport function isHostMessage(data: unknown): data is Envelope<HostMessage> {\n  return (\n    typeof data === 'object' &&\n    data !== null &&\n    (data as { source?: unknown }).source === MESSAGE_SOURCE &&\n    typeof (data as { type?: unknown }).type === 'string'\n  )\n}\n\nexport function isRuntimeMessage(data: unknown): data is Envelope<RuntimeMessage> {\n  return (\n    typeof data === 'object' &&\n    data !== null &&\n    (data as { source?: unknown }).source === MESSAGE_SOURCE &&\n    typeof (data as { type?: unknown }).type === 'string'\n  )\n}\n"]}

package/dist/index.cjs

@@ -1,21 +1,21 @@
 'use strict';
 
-var chunkIPYKNCDU_cjs = require('./chunk-IPYKNCDU.cjs');
+var chunkHKILZLGW_cjs = require('./chunk-HKILZLGW.cjs');
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 
 var RuntimeContext = react.createContext(null);
 function postNavigate(to) {
-  const envelope = { source: chunkIPYKNCDU_cjs.MESSAGE_SOURCE, type: "NAVIGATE", to };
+  const envelope = { source: chunkHKILZLGW_cjs.MESSAGE_SOURCE, type: "NAVIGATE", to };
   window.parent?.postMessage(envelope, "*");
 }
 function postOpenPeek(to) {
-  const envelope = { source: chunkIPYKNCDU_cjs.MESSAGE_SOURCE, type: "OPEN_PEEK", to };
+  const envelope = { source: chunkHKILZLGW_cjs.MESSAGE_SOURCE, type: "OPEN_PEEK", to };
   window.parent?.postMessage(envelope, "*");
 }
 function openCall(conversationBriefId) {
   const envelope = {
-    source: chunkIPYKNCDU_cjs.MESSAGE_SOURCE,
+    source: chunkHKILZLGW_cjs.MESSAGE_SOURCE,
     type: "OPEN_CALL",
     conversationBriefId
   };
@@ -32,7 +32,7 @@ function ensureModalListener() {
   modalListenerAttached = true;
   window.addEventListener("message", (event) => {
     const data = event.data;
-    if (!chunkIPYKNCDU_cjs.isHostMessage(data) || data.type !== "MODAL_CLOSED") return;
+    if (!chunkHKILZLGW_cjs.isHostMessage(data) || data.type !== "MODAL_CLOSED") return;
     const resolve = pendingModals.get(data.requestId);
     if (!resolve) return;
     pendingModals.delete(data.requestId);
@@ -49,7 +49,7 @@ function openModal(componentSlug, props, options) {
   ensureModalListener();
   const requestId = newRequestId();
   const envelope = {
-    source: chunkIPYKNCDU_cjs.MESSAGE_SOURCE,
+    source: chunkHKILZLGW_cjs.MESSAGE_SOURCE,
     type: "OPEN_MODAL",
     requestId,
     componentSlug,
@@ -63,7 +63,7 @@ function openModal(componentSlug, props, options) {
 }
 function postModalResult(requestId, result) {
   const envelope = {
-    source: chunkIPYKNCDU_cjs.MESSAGE_SOURCE,
+    source: chunkHKILZLGW_cjs.MESSAGE_SOURCE,
     type: "MODAL_RESULT",
     requestId,
     ...result !== void 0 ? { result } : {}
@@ -183,19 +183,19 @@ function useFillViewportHeight(options = {}) {
 
 Object.defineProperty(exports, "COMPONENT_OVERLAY_Z_INDEX", {
   enumerable: true,
-  get: function () { return chunkIPYKNCDU_cjs.COMPONENT_OVERLAY_Z_INDEX; }
+  get: function () { return chunkHKILZLGW_cjs.COMPONENT_OVERLAY_Z_INDEX; }
 });
 Object.defineProperty(exports, "MESSAGE_SOURCE", {
   enumerable: true,
-  get: function () { return chunkIPYKNCDU_cjs.MESSAGE_SOURCE; }
+  get: function () { return chunkHKILZLGW_cjs.MESSAGE_SOURCE; }
 });
 Object.defineProperty(exports, "isHostMessage", {
   enumerable: true,
-  get: function () { return chunkIPYKNCDU_cjs.isHostMessage; }
+  get: function () { return chunkHKILZLGW_cjs.isHostMessage; }
 });
 Object.defineProperty(exports, "isRuntimeMessage", {
   enumerable: true,
-  get: function () { return chunkIPYKNCDU_cjs.isRuntimeMessage; }
+  get: function () { return chunkHKILZLGW_cjs.isRuntimeMessage; }
 });
 exports.RuntimeProvider = RuntimeProvider;
 exports.useApiBaseUrl = useApiBaseUrl;

package/dist/index.js

@@ -1,5 +1,5 @@
-import { MESSAGE_SOURCE, isHostMessage } from './chunk-RTYCYWKC.js';
-export { COMPONENT_OVERLAY_Z_INDEX, MESSAGE_SOURCE, isHostMessage, isRuntimeMessage } from './chunk-RTYCYWKC.js';
+import { MESSAGE_SOURCE, isHostMessage } from './chunk-CHUMJ4XR.js';
+export { COMPONENT_OVERLAY_Z_INDEX, MESSAGE_SOURCE, isHostMessage, isRuntimeMessage } from './chunk-CHUMJ4XR.js';
 import { createContext, useMemo, useContext, useCallback, useState, useEffect } from 'react';
 import { jsx } from 'react/jsx-runtime';
 

package/dist/protocol.cjs

@@ -1,24 +1,24 @@
 'use strict';
 
-var chunkIPYKNCDU_cjs = require('./chunk-IPYKNCDU.cjs');
+var chunkHKILZLGW_cjs = require('./chunk-HKILZLGW.cjs');
 
 
 
 Object.defineProperty(exports, "COMPONENT_OVERLAY_Z_INDEX", {
   enumerable: true,
-  get: function () { return chunkIPYKNCDU_cjs.COMPONENT_OVERLAY_Z_INDEX; }
+  get: function () { return chunkHKILZLGW_cjs.COMPONENT_OVERLAY_Z_INDEX; }
 });
 Object.defineProperty(exports, "MESSAGE_SOURCE", {
   enumerable: true,
-  get: function () { return chunkIPYKNCDU_cjs.MESSAGE_SOURCE; }
+  get: function () { return chunkHKILZLGW_cjs.MESSAGE_SOURCE; }
 });
 Object.defineProperty(exports, "isHostMessage", {
   enumerable: true,
-  get: function () { return chunkIPYKNCDU_cjs.isHostMessage; }
+  get: function () { return chunkHKILZLGW_cjs.isHostMessage; }
 });
 Object.defineProperty(exports, "isRuntimeMessage", {
   enumerable: true,
-  get: function () { return chunkIPYKNCDU_cjs.isRuntimeMessage; }
+  get: function () { return chunkHKILZLGW_cjs.isRuntimeMessage; }
 });
 //# sourceMappingURL=protocol.cjs.map
 //# sourceMappingURL=protocol.cjs.map

package/dist/protocol.d.cts

@@ -35,6 +35,15 @@ interface PageContext {
         [key: string]: unknown;
     };
     params?: Record<string, unknown>;
+    /** The signed-in viewer (absent on public pages and offline previews). The
+     *  host resolves `{{ current_user.* }}` and the bare `current_user` prop
+     *  sentinel against it before posting props. */
+    current_user?: {
+        id: string;
+        email: string;
+        given_name: string;
+        family_name: string;
+    };
     [key: string]: unknown;
 }
 interface InitMessage {

package/dist/protocol.d.ts

@@ -35,6 +35,15 @@ interface PageContext {
         [key: string]: unknown;
     };
     params?: Record<string, unknown>;
+    /** The signed-in viewer (absent on public pages and offline previews). The
+     *  host resolves `{{ current_user.* }}` and the bare `current_user` prop
+     *  sentinel against it before posting props. */
+    current_user?: {
+        id: string;
+        email: string;
+        given_name: string;
+        family_name: string;
+    };
     [key: string]: unknown;
 }
 interface InitMessage {

package/dist/protocol.js

@@ -1,3 +1,3 @@
-export { COMPONENT_OVERLAY_Z_INDEX, MESSAGE_SOURCE, isHostMessage, isRuntimeMessage } from './chunk-RTYCYWKC.js';
+export { COMPONENT_OVERLAY_Z_INDEX, MESSAGE_SOURCE, isHostMessage, isRuntimeMessage } from './chunk-CHUMJ4XR.js';
 //# sourceMappingURL=protocol.js.map
 //# sourceMappingURL=protocol.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proteos/component-sdk",
-  "version": "0.55.0",
+  "version": "0.57.0",
   "license": "Apache-2.0",
   "description": "Typed runtime hooks for authoring Proteos custom components — the SDK you import inside a component bundle.",
   "repository": {
@@ -42,7 +42,7 @@
     "src"
   ],
   "dependencies": {
-    "@proteos/sdk": "^0.55.0"
+    "@proteos/sdk": "^0.57.0"
   },
   "peerDependencies": {
     "@tanstack/react-query": ">=5.0.0",

package/src/protocol.ts

@@ -45,6 +45,10 @@ export interface PageContext {
   record?: Record<string, unknown>
   entity?: { slug: string; [key: string]: unknown }
   params?: Record<string, unknown>
+  /** The signed-in viewer (absent on public pages and offline previews). The
+   *  host resolves `{{ current_user.* }}` and the bare `current_user` prop
+   *  sentinel against it before posting props. */
+  current_user?: { id: string; email: string; given_name: string; family_name: string }
   [key: string]: unknown
 }
 

package/dist/chunk-IPYKNCDU.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/protocol.ts"],"names":[],"mappings":";;;AAUO,IAAM,cAAA,GAAiB;AAuBvB,IAAM,yBAAA,GAA4B;AA0LlC,SAAS,cAAc,IAAA,EAA8C;AAC1E,EAAA,OACE,OAAO,IAAA,KAAS,QAAA,IAChB,IAAA,KAAS,IAAA,IACR,KAA8B,MAAA,KAAW,cAAA,IAC1C,OAAQ,IAAA,CAA4B,IAAA,KAAS,QAAA;AAEjD;AAEO,SAAS,iBAAiB,IAAA,EAAiD;AAChF,EAAA,OACE,OAAO,IAAA,KAAS,QAAA,IAChB,IAAA,KAAS,IAAA,IACR,KAA8B,MAAA,KAAW,cAAA,IAC1C,OAAQ,IAAA,CAA4B,IAAA,KAAS,QAAA;AAEjD","file":"chunk-IPYKNCDU.cjs","sourcesContent":["// postMessage protocol between the host page and the component-runtime iframe.\n// This is the single source of truth for the wire contract: the host renderer\n// (clients/web .../component-frame.tsx), the runtime shell\n// (clients/web/component-runtime/shell.tsx), and the author-facing hooks\n// (this package's RuntimeProvider / useNavigate) all import these same types so\n// every end stays in lockstep.\n//\n// Every message carries `source: MESSAGE_SOURCE` so we can ignore the unrelated\n// postMessage traffic that shares the window (OIDC silent-renew, Vite HMR, …).\n\nexport const MESSAGE_SOURCE = 'proteos-component-runtime' as const\n\n/**\n * z-index the component iframe is promoted to while one of its own overlays\n * (modal, popover, menu, select, tooltip) is open. The iframe goes\n * `position: fixed; inset: 0` at this z so the overlay — which portals to the\n * IFRAME's body and would otherwise clip at the frame's box — can paint over\n * the rest of the page.\n *\n * Host z ladder this slots into:\n *   50    @proteos/ui Modal / Tooltip / ImageLightbox (default tier)\n *   1000+ full-page panel stack (scrim 1000, panels 1001+n)\n *   1090  peek scrim   1100  peek panel, ask-proteos window\n *   1150  ← THIS\n *   1200  menu popover, command palette, action dialog, component modal\n *   1300  select popover\n *\n * Above the peek/full-page surfaces a component can live on, below the global\n * host chrome. Note the cap: inside a peek (a `fixed` + z-index ancestor) the\n * promoted iframe paints within that 1100 stacking context — it covers the\n * peek's own content and everything under it, but host chrome at 1200+ still\n * wins. That is the intended layering, not a bug.\n */\nexport const COMPONENT_OVERLAY_Z_INDEX = 1150\n\n/** Viewport-relative box of the iframe's in-flow placeholder, in CSS px. */\nexport interface OverlayRect {\n  top: number\n  left: number\n  width: number\n  height: number\n}\n\nexport interface PageContext {\n  record?: Record<string, unknown>\n  entity?: { slug: string; [key: string]: unknown }\n  params?: Record<string, unknown>\n  [key: string]: unknown\n}\n\n// ── Host → runtime ──────────────────────────────────────────────────────────\n\nexport interface InitMessage {\n  type: 'INIT'\n  /** Raw bearer token (the OIDC `id_token`). The runtime's ProteosClient\n   *  prepends `Bearer ` when building the Authorization header, so the host\n   *  sends the token verbatim — NOT a full `Bearer …` header value.\n   *  Empty string in public mode (`isPublic: true`). */\n  authToken: string\n  /** API origin the bundle endpoint + SDK calls resolve against. */\n  apiBaseUrl: string\n  /** Resolved props for the component (Liquid templating happens host-side). */\n  props: Record<string, unknown>\n  pageCtx: PageContext\n  /** PUBLIC mode: the component renders on an unauthenticated public page.\n   *  The shell fetches the bundle from the public endpoint (no bearer) and\n   *  injects a restricted sdk — only `functions.actions.invokePublic` reaches\n   *  the platform. Requires `orgId`. */\n  isPublic?: boolean\n  /** Org id for public mode — public endpoints carry the org in the path\n   *  because there is no token to scope from. */\n  orgId?: string\n  /** Set when this frame is the CONTENT of a host component modal (opened by\n   *  another component via OPEN_MODAL). The component reads it through\n   *  `useModalHost()` and closes with a result by posting MODAL_RESULT with\n   *  this id. Absent on ordinary page-hosted frames. */\n  modalRequestId?: string\n}\n\nexport interface AuthRefreshMessage {\n  type: 'AUTH_REFRESH'\n  token: string\n}\n\nexport interface DataInvalidateMessage {\n  type: 'DATA_INVALIDATE'\n  queryKey?: unknown[]\n}\n\n/** Where the iframe's in-flow box sits in the host viewport. Sent while the\n *  frame is promoted (OVERLAY_STATE open) so the runtime can keep its content\n *  parked at the original rect while the iframe itself covers the viewport —\n *  and re-sent when the host window resizes under an open overlay. */\nexport interface OverlayRectMessage {\n  type: 'OVERLAY_RECT'\n  rect: OverlayRect\n}\n\n/** Resolution of an OPEN_MODAL request: the host modal closed. `result` is the\n *  value the modal's component passed to MODAL_RESULT, and is absent when the\n *  modal was dismissed (backdrop / Esc / ×). */\nexport interface ModalClosedMessage {\n  type: 'MODAL_CLOSED'\n  requestId: string\n  result?: unknown\n}\n\nexport type HostMessage =\n  | InitMessage\n  | AuthRefreshMessage\n  | DataInvalidateMessage\n  | OverlayRectMessage\n  | ModalClosedMessage\n\n// ── Runtime → host ──────────────────────────────────────────────────────────\n\nexport interface ReadyMessage {\n  type: 'READY'\n}\n\nexport interface ResizeMessage {\n  type: 'RESIZE'\n  height: number\n}\n\nexport interface NavigateMessage {\n  type: 'NAVIGATE'\n  to: string\n}\n\n/** Open an in-app path in a peek (slide-over) panel instead of full-page\n *  navigation. Same `/…` in-app path grammar as NAVIGATE; the host decides\n *  what can peek (today: platform pages) and falls back to NAVIGATE otherwise. */\nexport interface OpenPeekMessage {\n  type: 'OPEN_PEEK'\n  to: string\n}\n\n/** Ask the host to open a prepared call: the host shows the conversation brief's\n *  preview (its softphone owns the dial) and lets the user place the call.\n *  Ignored on public pages and on hosts without a softphone. */\nexport interface OpenCallMessage {\n  type: 'OPEN_CALL'\n  /** The conversation brief to preview and dial from. */\n  conversationBriefId: string\n}\n\n/** The runtime has (or no longer has) an overlay open and needs the host to\n *  promote (or restore) the iframe. See {@link COMPONENT_OVERLAY_Z_INDEX}.\n *\n *  Same-origin today, so the runtime applies the promotion styles to its own\n *  `window.frameElement` synchronously (pre-paint, no flicker) and this message\n *  is the host's cue to MIRROR that state into React — gate RESIZE, hold the\n *  placeholder height, start posting OVERLAY_RECT. When components move to a\n *  dedicated origin the runtime can no longer touch the frame and this message\n *  becomes the actuation instead; the runtime hides its overlay until the\n *  answering OVERLAY_RECT arrives. */\nexport interface OverlayStateMessage {\n  type: 'OVERLAY_STATE'\n  open: boolean\n}\n\n/** Ask the host to open ANOTHER component in a central modal, above everything\n *  this frame could reach on its own. The host answers with MODAL_CLOSED\n *  carrying the same `requestId`. */\nexport interface OpenModalMessage {\n  type: 'OPEN_MODAL'\n  /** Correlates the eventual MODAL_CLOSED. Generated by the opener. */\n  requestId: string\n  /** Slug of the component to mount inside the modal. */\n  componentSlug: string\n  /** Props for that component (already literal values — no Liquid). */\n  props?: Record<string, unknown>\n  /** Optional modal heading. */\n  title?: string\n}\n\n/** Escape was pressed with focus inside the iframe, and nothing in the runtime\n *  consumed it.\n *\n *  Keyboard events don't cross the iframe boundary, and react-aria binds its\n *  Escape handling to the overlay element in its own React tree — so a\n *  host-rendered dialog CANNOT see Escape once the user has clicked into a\n *  component. The runtime forwards it so the host can dismiss on the user's\n *  behalf. Not sent while the runtime has its own overlay open: that overlay\n *  owns Escape. */\nexport interface EscapePressedMessage {\n  type: 'ESCAPE_PRESSED'\n}\n\n/** Posted by the component INSIDE a host modal to close it with a value. The\n *  `requestId` is the one INIT carried as `modalRequestId`. */\nexport interface ModalResultMessage {\n  type: 'MODAL_RESULT'\n  requestId: string\n  result?: unknown\n}\n\nexport interface ErrorMessage {\n  type: 'ERROR'\n  message: string\n  stack?: string\n}\n\nexport type RuntimeMessage =\n  | ReadyMessage\n  | ResizeMessage\n  | NavigateMessage\n  | OpenPeekMessage\n  | OpenCallMessage\n  | OverlayStateMessage\n  | OpenModalMessage\n  | ModalResultMessage\n  | EscapePressedMessage\n  | ErrorMessage\n\n// Wire envelope: the message plus the source discriminator.\nexport type Envelope<T> = T & { source: typeof MESSAGE_SOURCE }\n\nexport function isHostMessage(data: unknown): data is Envelope<HostMessage> {\n  return (\n    typeof data === 'object' &&\n    data !== null &&\n    (data as { source?: unknown }).source === MESSAGE_SOURCE &&\n    typeof (data as { type?: unknown }).type === 'string'\n  )\n}\n\nexport function isRuntimeMessage(data: unknown): data is Envelope<RuntimeMessage> {\n  return (\n    typeof data === 'object' &&\n    data !== null &&\n    (data as { source?: unknown }).source === MESSAGE_SOURCE &&\n    typeof (data as { type?: unknown }).type === 'string'\n  )\n}\n"]}

package/dist/chunk-RTYCYWKC.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/protocol.ts"],"names":[],"mappings":";AAUO,IAAM,cAAA,GAAiB;AAuBvB,IAAM,yBAAA,GAA4B;AA0LlC,SAAS,cAAc,IAAA,EAA8C;AAC1E,EAAA,OACE,OAAO,IAAA,KAAS,QAAA,IAChB,IAAA,KAAS,IAAA,IACR,KAA8B,MAAA,KAAW,cAAA,IAC1C,OAAQ,IAAA,CAA4B,IAAA,KAAS,QAAA;AAEjD;AAEO,SAAS,iBAAiB,IAAA,EAAiD;AAChF,EAAA,OACE,OAAO,IAAA,KAAS,QAAA,IAChB,IAAA,KAAS,IAAA,IACR,KAA8B,MAAA,KAAW,cAAA,IAC1C,OAAQ,IAAA,CAA4B,IAAA,KAAS,QAAA;AAEjD","file":"chunk-RTYCYWKC.js","sourcesContent":["// postMessage protocol between the host page and the component-runtime iframe.\n// This is the single source of truth for the wire contract: the host renderer\n// (clients/web .../component-frame.tsx), the runtime shell\n// (clients/web/component-runtime/shell.tsx), and the author-facing hooks\n// (this package's RuntimeProvider / useNavigate) all import these same types so\n// every end stays in lockstep.\n//\n// Every message carries `source: MESSAGE_SOURCE` so we can ignore the unrelated\n// postMessage traffic that shares the window (OIDC silent-renew, Vite HMR, …).\n\nexport const MESSAGE_SOURCE = 'proteos-component-runtime' as const\n\n/**\n * z-index the component iframe is promoted to while one of its own overlays\n * (modal, popover, menu, select, tooltip) is open. The iframe goes\n * `position: fixed; inset: 0` at this z so the overlay — which portals to the\n * IFRAME's body and would otherwise clip at the frame's box — can paint over\n * the rest of the page.\n *\n * Host z ladder this slots into:\n *   50    @proteos/ui Modal / Tooltip / ImageLightbox (default tier)\n *   1000+ full-page panel stack (scrim 1000, panels 1001+n)\n *   1090  peek scrim   1100  peek panel, ask-proteos window\n *   1150  ← THIS\n *   1200  menu popover, command palette, action dialog, component modal\n *   1300  select popover\n *\n * Above the peek/full-page surfaces a component can live on, below the global\n * host chrome. Note the cap: inside a peek (a `fixed` + z-index ancestor) the\n * promoted iframe paints within that 1100 stacking context — it covers the\n * peek's own content and everything under it, but host chrome at 1200+ still\n * wins. That is the intended layering, not a bug.\n */\nexport const COMPONENT_OVERLAY_Z_INDEX = 1150\n\n/** Viewport-relative box of the iframe's in-flow placeholder, in CSS px. */\nexport interface OverlayRect {\n  top: number\n  left: number\n  width: number\n  height: number\n}\n\nexport interface PageContext {\n  record?: Record<string, unknown>\n  entity?: { slug: string; [key: string]: unknown }\n  params?: Record<string, unknown>\n  [key: string]: unknown\n}\n\n// ── Host → runtime ──────────────────────────────────────────────────────────\n\nexport interface InitMessage {\n  type: 'INIT'\n  /** Raw bearer token (the OIDC `id_token`). The runtime's ProteosClient\n   *  prepends `Bearer ` when building the Authorization header, so the host\n   *  sends the token verbatim — NOT a full `Bearer …` header value.\n   *  Empty string in public mode (`isPublic: true`). */\n  authToken: string\n  /** API origin the bundle endpoint + SDK calls resolve against. */\n  apiBaseUrl: string\n  /** Resolved props for the component (Liquid templating happens host-side). */\n  props: Record<string, unknown>\n  pageCtx: PageContext\n  /** PUBLIC mode: the component renders on an unauthenticated public page.\n   *  The shell fetches the bundle from the public endpoint (no bearer) and\n   *  injects a restricted sdk — only `functions.actions.invokePublic` reaches\n   *  the platform. Requires `orgId`. */\n  isPublic?: boolean\n  /** Org id for public mode — public endpoints carry the org in the path\n   *  because there is no token to scope from. */\n  orgId?: string\n  /** Set when this frame is the CONTENT of a host component modal (opened by\n   *  another component via OPEN_MODAL). The component reads it through\n   *  `useModalHost()` and closes with a result by posting MODAL_RESULT with\n   *  this id. Absent on ordinary page-hosted frames. */\n  modalRequestId?: string\n}\n\nexport interface AuthRefreshMessage {\n  type: 'AUTH_REFRESH'\n  token: string\n}\n\nexport interface DataInvalidateMessage {\n  type: 'DATA_INVALIDATE'\n  queryKey?: unknown[]\n}\n\n/** Where the iframe's in-flow box sits in the host viewport. Sent while the\n *  frame is promoted (OVERLAY_STATE open) so the runtime can keep its content\n *  parked at the original rect while the iframe itself covers the viewport —\n *  and re-sent when the host window resizes under an open overlay. */\nexport interface OverlayRectMessage {\n  type: 'OVERLAY_RECT'\n  rect: OverlayRect\n}\n\n/** Resolution of an OPEN_MODAL request: the host modal closed. `result` is the\n *  value the modal's component passed to MODAL_RESULT, and is absent when the\n *  modal was dismissed (backdrop / Esc / ×). */\nexport interface ModalClosedMessage {\n  type: 'MODAL_CLOSED'\n  requestId: string\n  result?: unknown\n}\n\nexport type HostMessage =\n  | InitMessage\n  | AuthRefreshMessage\n  | DataInvalidateMessage\n  | OverlayRectMessage\n  | ModalClosedMessage\n\n// ── Runtime → host ──────────────────────────────────────────────────────────\n\nexport interface ReadyMessage {\n  type: 'READY'\n}\n\nexport interface ResizeMessage {\n  type: 'RESIZE'\n  height: number\n}\n\nexport interface NavigateMessage {\n  type: 'NAVIGATE'\n  to: string\n}\n\n/** Open an in-app path in a peek (slide-over) panel instead of full-page\n *  navigation. Same `/…` in-app path grammar as NAVIGATE; the host decides\n *  what can peek (today: platform pages) and falls back to NAVIGATE otherwise. */\nexport interface OpenPeekMessage {\n  type: 'OPEN_PEEK'\n  to: string\n}\n\n/** Ask the host to open a prepared call: the host shows the conversation brief's\n *  preview (its softphone owns the dial) and lets the user place the call.\n *  Ignored on public pages and on hosts without a softphone. */\nexport interface OpenCallMessage {\n  type: 'OPEN_CALL'\n  /** The conversation brief to preview and dial from. */\n  conversationBriefId: string\n}\n\n/** The runtime has (or no longer has) an overlay open and needs the host to\n *  promote (or restore) the iframe. See {@link COMPONENT_OVERLAY_Z_INDEX}.\n *\n *  Same-origin today, so the runtime applies the promotion styles to its own\n *  `window.frameElement` synchronously (pre-paint, no flicker) and this message\n *  is the host's cue to MIRROR that state into React — gate RESIZE, hold the\n *  placeholder height, start posting OVERLAY_RECT. When components move to a\n *  dedicated origin the runtime can no longer touch the frame and this message\n *  becomes the actuation instead; the runtime hides its overlay until the\n *  answering OVERLAY_RECT arrives. */\nexport interface OverlayStateMessage {\n  type: 'OVERLAY_STATE'\n  open: boolean\n}\n\n/** Ask the host to open ANOTHER component in a central modal, above everything\n *  this frame could reach on its own. The host answers with MODAL_CLOSED\n *  carrying the same `requestId`. */\nexport interface OpenModalMessage {\n  type: 'OPEN_MODAL'\n  /** Correlates the eventual MODAL_CLOSED. Generated by the opener. */\n  requestId: string\n  /** Slug of the component to mount inside the modal. */\n  componentSlug: string\n  /** Props for that component (already literal values — no Liquid). */\n  props?: Record<string, unknown>\n  /** Optional modal heading. */\n  title?: string\n}\n\n/** Escape was pressed with focus inside the iframe, and nothing in the runtime\n *  consumed it.\n *\n *  Keyboard events don't cross the iframe boundary, and react-aria binds its\n *  Escape handling to the overlay element in its own React tree — so a\n *  host-rendered dialog CANNOT see Escape once the user has clicked into a\n *  component. The runtime forwards it so the host can dismiss on the user's\n *  behalf. Not sent while the runtime has its own overlay open: that overlay\n *  owns Escape. */\nexport interface EscapePressedMessage {\n  type: 'ESCAPE_PRESSED'\n}\n\n/** Posted by the component INSIDE a host modal to close it with a value. The\n *  `requestId` is the one INIT carried as `modalRequestId`. */\nexport interface ModalResultMessage {\n  type: 'MODAL_RESULT'\n  requestId: string\n  result?: unknown\n}\n\nexport interface ErrorMessage {\n  type: 'ERROR'\n  message: string\n  stack?: string\n}\n\nexport type RuntimeMessage =\n  | ReadyMessage\n  | ResizeMessage\n  | NavigateMessage\n  | OpenPeekMessage\n  | OpenCallMessage\n  | OverlayStateMessage\n  | OpenModalMessage\n  | ModalResultMessage\n  | EscapePressedMessage\n  | ErrorMessage\n\n// Wire envelope: the message plus the source discriminator.\nexport type Envelope<T> = T & { source: typeof MESSAGE_SOURCE }\n\nexport function isHostMessage(data: unknown): data is Envelope<HostMessage> {\n  return (\n    typeof data === 'object' &&\n    data !== null &&\n    (data as { source?: unknown }).source === MESSAGE_SOURCE &&\n    typeof (data as { type?: unknown }).type === 'string'\n  )\n}\n\nexport function isRuntimeMessage(data: unknown): data is Envelope<RuntimeMessage> {\n  return (\n    typeof data === 'object' &&\n    data !== null &&\n    (data as { source?: unknown }).source === MESSAGE_SOURCE &&\n    typeof (data as { type?: unknown }).type === 'string'\n  )\n}\n"]}