@tinyweb_dev/oe-meeting-react 0.5.0 → 0.6.0

package/dist/index.cjs

@@ -24,6 +24,7 @@ __export(index_exports, {
   DEFAULT_IFRAME_ALLOW: () => DEFAULT_IFRAME_ALLOW,
   EMBED_MESSAGE_SOURCE: () => EMBED_MESSAGE_SOURCE,
   EMBED_PROTOCOL_VERSION: () => EMBED_PROTOCOL_VERSION,
+  EmbedBackgroundType: () => EmbedBackgroundType,
   EmbedCapability: () => EmbedCapability,
   EmbedCaptureOutcome: () => EmbedCaptureOutcome,
   EmbedCommandAction: () => EmbedCommandAction,
@@ -32,14 +33,17 @@ __export(index_exports, {
   EmbedEventType: () => EmbedEventType,
   EmbedQueryParam: () => EmbedQueryParam,
   EmbedRole: () => EmbedRole,
+  MAX_BACKGROUND_URL_LENGTH: () => MAX_BACKGROUND_URL_LENGTH,
   MAX_STAGE_TOOL_ID_LENGTH: () => MAX_STAGE_TOOL_ID_LENGTH,
   MAX_STAGE_URL_LENGTH: () => MAX_STAGE_URL_LENGTH,
   OeMeeting: () => OeMeeting,
   buildEmbedUrl: () => buildEmbedUrl,
   isStageToolId: () => isStageToolId,
   isValidStageUrl: () => isValidStageUrl,
+  normalizeEmbedBackground: () => normalizeEmbedBackground,
   normalizeOpenStageInput: () => normalizeOpenStageInput,
   parseEmbedEvent: () => parseEmbedEvent,
+  serializeEmbedBackground: () => serializeEmbedBackground,
   useOeMeeting: () => useOeMeeting
 });
 module.exports = __toCommonJS(index_exports);
@@ -75,6 +79,7 @@ var EmbedCommandAction = /* @__PURE__ */ ((EmbedCommandAction2) => {
   EmbedCommandAction2["TOGGLE_CAMERA"] = "toggleCamera";
   EmbedCommandAction2["OPEN_STAGE"] = "openStage";
   EmbedCommandAction2["CLOSE_STAGE"] = "closeStage";
+  EmbedCommandAction2["SET_BACKGROUND"] = "setBackground";
   return EmbedCommandAction2;
 })(EmbedCommandAction || {});
 var EmbedErrorCode = /* @__PURE__ */ ((EmbedErrorCode2) => {
@@ -91,6 +96,16 @@ var EmbedErrorCode = /* @__PURE__ */ ((EmbedErrorCode2) => {
   EmbedErrorCode2["UNKNOWN"] = "UNKNOWN";
   return EmbedErrorCode2;
 })(EmbedErrorCode || {});
+var EmbedBackgroundType = /* @__PURE__ */ ((EmbedBackgroundType2) => {
+  EmbedBackgroundType2["BLUR"] = "blur";
+  EmbedBackgroundType2["IMAGE"] = "image";
+  EmbedBackgroundType2["NONE"] = "none";
+  return EmbedBackgroundType2;
+})(EmbedBackgroundType || {});
+var MAX_BACKGROUND_URL_LENGTH = 2048;
+var DEFAULT_BACKGROUND_BLUR_RADIUS = 10;
+var MIN_BACKGROUND_BLUR_RADIUS = 1;
+var MAX_BACKGROUND_BLUR_RADIUS = 50;
 var MAX_STAGE_URL_LENGTH = 2048;
 var MAX_STAGE_TOOL_ID_LENGTH = 32;
 var STAGE_TOOL_ID_PATTERN = /^[a-z][a-z0-9._-]{0,31}$/;
@@ -109,6 +124,7 @@ var EmbedQueryParam = /* @__PURE__ */ ((EmbedQueryParam2) => {
   EmbedQueryParam2["AUTO_CAMERA_OFF"] = "autoCameraOff";
   EmbedQueryParam2["AUTO_TRANSCRIBE"] = "autoTranscribe";
   EmbedQueryParam2["AUTO_RECORD"] = "autoRecord";
+  EmbedQueryParam2["BACKGROUND"] = "background";
   return EmbedQueryParam2;
 })(EmbedQueryParam || {});
 var EmbedCaptureOutcome = /* @__PURE__ */ ((EmbedCaptureOutcome2) => {
@@ -128,6 +144,62 @@ var EmbedCapability = /* @__PURE__ */ ((EmbedCapability2) => {
   return EmbedCapability2;
 })(EmbedCapability || {});
 
+// src/openStage.ts
+function isValidStageUrl(url) {
+  if (url.length === 0 || url.length > MAX_STAGE_URL_LENGTH) return false;
+  try {
+    const parsed = new URL(url);
+    if (parsed.protocol === "https:") return true;
+    if (parsed.protocol === "http:") {
+      return parsed.hostname === "localhost" || parsed.hostname === "127.0.0.1";
+    }
+    return false;
+  } catch {
+    return false;
+  }
+}
+function normalizeOpenStageInput(input) {
+  const url = input.url.trim();
+  if (!isValidStageUrl(url)) return null;
+  const title = input.title?.trim();
+  return {
+    url,
+    ...title ? { title: title.slice(0, 200) } : {},
+    ...isStageToolId(input.tool) ? { tool: input.tool } : {}
+  };
+}
+
+// src/background.ts
+var isValidBackgroundUrl = (url) => url.length > 0 && url.length <= MAX_BACKGROUND_URL_LENGTH && isValidStageUrl(url);
+var clampBlurRadius = (value) => Number.isFinite(value) ? Math.min(MAX_BACKGROUND_BLUR_RADIUS, Math.max(MIN_BACKGROUND_BLUR_RADIUS, Math.round(value))) : DEFAULT_BACKGROUND_BLUR_RADIUS;
+function normalizeEmbedBackground(input) {
+  const locked = input.locked === true ? { locked: true } : {};
+  if (input.type === "none" /* NONE */) {
+    return { type: "none" /* NONE */, ...locked };
+  }
+  if (input.type === "blur" /* BLUR */) {
+    return {
+      type: "blur" /* BLUR */,
+      blurRadius: clampBlurRadius(input.blurRadius ?? DEFAULT_BACKGROUND_BLUR_RADIUS),
+      ...locked
+    };
+  }
+  if (input.type === "image" /* IMAGE */) {
+    const url = input.url?.trim();
+    if (!url || !isValidBackgroundUrl(url)) return null;
+    return {
+      type: "image" /* IMAGE */,
+      url,
+      ...locked
+    };
+  }
+  return null;
+}
+function serializeEmbedBackground(input) {
+  const normalized = normalizeEmbedBackground(input);
+  return normalized ? JSON.stringify(normalized) : void 0;
+}
+
 // src/buildEmbedUrl.ts
 var QUERY_FLAG_ENABLED = "1";
 var QUERY_FLAG_DISABLED = "0";
@@ -149,6 +221,7 @@ function buildEmbedUrl(options) {
   }
   const origin = normalizeOrigin(options.origin ?? DEFAULT_EMBED_ORIGIN);
   const url = new URL(`${origin}/embed/${encodeURIComponent(roomSlug)}`);
+  const backgroundParam = options.background ? serializeEmbedBackground(options.background) : void 0;
   const entries = [
     ["instanceId" /* INSTANCE_ID */, options.instanceId],
     ["hostOrigin" /* HOST_ORIGIN */, options.hostOrigin],
@@ -160,7 +233,8 @@ function buildEmbedUrl(options) {
     ["hideLeave" /* HIDE_LEAVE */, toFlag(options.hideLeave)],
     ["autoCameraOff" /* AUTO_CAMERA_OFF */, toFlag(options.autoCameraOff)],
     ["autoTranscribe" /* AUTO_TRANSCRIBE */, toFlag(options.autoTranscribe)],
-    ["autoRecord" /* AUTO_RECORD */, toFlag(options.autoRecord)]
+    ["autoRecord" /* AUTO_RECORD */, toFlag(options.autoRecord)],
+    ["background" /* BACKGROUND */, backgroundParam]
   ];
   for (const [key, value] of entries) {
     if (value !== void 0 && value !== "") {
@@ -173,31 +247,6 @@ function buildEmbedUrl(options) {
 // src/useOeMeeting.ts
 var import_react = require("react");
 
-// src/openStage.ts
-function isValidStageUrl(url) {
-  if (url.length === 0 || url.length > MAX_STAGE_URL_LENGTH) return false;
-  try {
-    const parsed = new URL(url);
-    if (parsed.protocol === "https:") return true;
-    if (parsed.protocol === "http:") {
-      return parsed.hostname === "localhost" || parsed.hostname === "127.0.0.1";
-    }
-    return false;
-  } catch {
-    return false;
-  }
-}
-function normalizeOpenStageInput(input) {
-  const url = input.url.trim();
-  if (!isValidStageUrl(url)) return null;
-  const title = input.title?.trim();
-  return {
-    url,
-    ...title ? { title: title.slice(0, 200) } : {},
-    ...isStageToolId(input.tool) ? { tool: input.tool } : {}
-  };
-}
-
 // src/parseEmbedEvent.ts
 var EVENT_TYPES = new Set(Object.values(EmbedEventType));
 function isRecord(value) {
@@ -266,6 +315,7 @@ function postCommand(options) {
 function useOeMeeting(options) {
   const iframeRef = (0, import_react.useRef)(null);
   const callbacksRef = (0, import_react.useRef)(options);
+  const pendingBackgroundRef = (0, import_react.useRef)(null);
   (0, import_react.useEffect)(() => {
     callbacksRef.current = options;
   }, [options]);
@@ -282,6 +332,15 @@ function useOeMeeting(options) {
       switch (embedEvent.type) {
         case "oemeeting:ready" /* READY */:
           callbacks.onReady?.(embedEvent);
+          if (pendingBackgroundRef.current) {
+            postCommand({
+              iframe: iframeRef.current,
+              instanceId: options.instanceId,
+              action: "setBackground" /* SET_BACKGROUND */,
+              targetOrigin: options.targetOrigin,
+              payload: pendingBackgroundRef.current
+            });
+          }
           break;
         case "oemeeting:joined" /* JOINED */:
           callbacks.onJoined?.(embedEvent);
@@ -349,6 +408,16 @@ function useOeMeeting(options) {
     () => send("closeStage" /* CLOSE_STAGE */),
     [send]
   );
+  (0, import_react.useEffect)(() => {
+    if (!options.background) {
+      pendingBackgroundRef.current = null;
+      return;
+    }
+    const normalized = normalizeEmbedBackground(options.background);
+    if (!normalized) return;
+    pendingBackgroundRef.current = normalized;
+    send("setBackground" /* SET_BACKGROUND */, normalized);
+  }, [options.background, send]);
   const getIframe = (0, import_react.useCallback)(() => iframeRef.current, []);
   const handle = (0, import_react.useMemo)(
     () => ({
@@ -389,6 +458,7 @@ var OeMeeting = (0, import_react2.forwardRef)(
       autoCameraOff,
       autoTranscribe,
       autoRecord,
+      background,
       title = "OE Meeting room",
       width = "100%",
       height = 640,
@@ -419,6 +489,7 @@ var OeMeeting = (0, import_react2.forwardRef)(
     const embedOrigin = (0, import_react2.useMemo)(() => getOrigin(origin), [origin]);
     const resolvedTargetOrigin = targetOrigin ?? embedOrigin;
     const hostOrigin = typeof window === "undefined" ? void 0 : window.location.origin;
+    const initialBackgroundRef = (0, import_react2.useRef)(background);
     const src = (0, import_react2.useMemo)(
       () => buildEmbedUrl({
         roomSlug,
@@ -432,6 +503,7 @@ var OeMeeting = (0, import_react2.forwardRef)(
         autoCameraOff,
         autoTranscribe,
         autoRecord,
+        background: initialBackgroundRef.current,
         instanceId,
         hostOrigin
       }),
@@ -452,6 +524,7 @@ var OeMeeting = (0, import_react2.forwardRef)(
       ]
     );
     const { iframeRef } = useOeMeeting({
+      background,
       instanceId,
       targetOrigin: resolvedTargetOrigin,
       handleRef: ref,
@@ -510,6 +583,7 @@ OeMeeting.displayName = "OeMeeting";
   DEFAULT_IFRAME_ALLOW,
   EMBED_MESSAGE_SOURCE,
   EMBED_PROTOCOL_VERSION,
+  EmbedBackgroundType,
   EmbedCapability,
   EmbedCaptureOutcome,
   EmbedCommandAction,
@@ -518,14 +592,17 @@ OeMeeting.displayName = "OeMeeting";
   EmbedEventType,
   EmbedQueryParam,
   EmbedRole,
+  MAX_BACKGROUND_URL_LENGTH,
   MAX_STAGE_TOOL_ID_LENGTH,
   MAX_STAGE_URL_LENGTH,
   OeMeeting,
   buildEmbedUrl,
   isStageToolId,
   isValidStageUrl,
+  normalizeEmbedBackground,
   normalizeOpenStageInput,
   parseEmbedEvent,
+  serializeEmbedBackground,
   useOeMeeting
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/OeMeeting.tsx","../src/embed-protocol.ts","../src/buildEmbedUrl.ts","../src/useOeMeeting.ts","../src/openStage.ts","../src/parseEmbedEvent.ts"],"sourcesContent":["export { OeMeeting, DEFAULT_IFRAME_ALLOW } from './OeMeeting';\nexport { useOeMeeting } from './useOeMeeting';\nexport { buildEmbedUrl } from './buildEmbedUrl';\nexport { parseEmbedEvent } from './parseEmbedEvent';\nexport {\n  DEFAULT_EMBED_ORIGIN,\n  EMBED_MESSAGE_SOURCE,\n  EMBED_PROTOCOL_VERSION,\n  EmbedCapability,\n  EmbedCaptureOutcome,\n  EmbedCommandAction,\n  EmbedRole,\n  EmbedCommandType,\n  EmbedErrorCode,\n  EmbedEventType,\n  EmbedQueryParam,\n  isStageToolId,\n  MAX_STAGE_TOOL_ID_LENGTH,\n  MAX_STAGE_URL_LENGTH,\n} from './embed-protocol';\nexport type { EmbedPermissionMap, StageToolId } from './embed-protocol';\nexport { isValidStageUrl, normalizeOpenStageInput } from './openStage';\nexport type {\n  BuildEmbedUrlOptions,\n  EmbedCommandMessage,\n  EmbedEndedPayload,\n  EmbedErrorPayload,\n  EmbedEvent,\n  EmbedEventOf,\n  EmbedEventPayloadMap,\n  EmbedJoinedPayload,\n  EmbedLeftPayload,\n  EmbedMessageBase,\n  EmbedParticipantJoinedPayload,\n  EmbedParticipantLeftPayload,\n  EmbedReadyPayload,\n  EmbedRecordingSavedPayload,\n  EmbedRecordingStartedPayload,\n  EmbedStageChangedPayload,\n  EmbedTranscriptStartedPayload,\n  OeMeetingHandle,\n  OeMeetingProps,\n  OpenStageInput,\n} from './types';\n","'use client';\n\nimport {\n  forwardRef,\n  useId,\n  useMemo,\n  type CSSProperties,\n} from 'react';\nimport { buildEmbedUrl } from './buildEmbedUrl';\nimport { DEFAULT_EMBED_ORIGIN } from './embed-protocol';\nimport type { OeMeetingHandle, OeMeetingProps } from './types';\nimport { useOeMeeting } from './useOeMeeting';\n\nexport const DEFAULT_IFRAME_ALLOW =\n  'camera; microphone; fullscreen; autoplay; display-capture; clipboard-write; encrypted-media';\n\nfunction toCssSize(value: number | string | undefined): string | undefined {\n  if (value === undefined) return undefined;\n  return typeof value === 'number' ? `${value}px` : value;\n}\n\nfunction getOrigin(value: string): string {\n  return new URL(value).origin;\n}\n\nexport const OeMeeting = forwardRef<OeMeetingHandle, OeMeetingProps>(\n  function OeMeeting(props, ref) {\n    const {\n      roomSlug,\n      joinToken,\n      userName,\n      externalUserId,\n      origin = DEFAULT_EMBED_ORIGIN,\n      lang,\n      autoJoin = true,\n      hideLeave,\n      autoCameraOff,\n      autoTranscribe,\n      autoRecord,\n      title = 'OE Meeting room',\n      width = '100%',\n      height = 640,\n      className,\n      style,\n      iframeClassName,\n      iframeStyle,\n      allow = DEFAULT_IFRAME_ALLOW,\n      targetOrigin,\n      onReady,\n      onJoined,\n      onLeft,\n      onParticipantJoined,\n      onParticipantLeft,\n      onEnded,\n      onError,\n      onStageChanged,\n      onTranscriptStarted,\n      onRecordingStarted,\n      onRecordingSaved,\n      onEvent,\n    } = props;\n    const reactId = useId();\n    const instanceId = useMemo(\n      () => `oem-${reactId.replace(/:/g, '')}`,\n      [reactId],\n    );\n    const embedOrigin = useMemo(() => getOrigin(origin), [origin]);\n    const resolvedTargetOrigin = targetOrigin ?? embedOrigin;\n    const hostOrigin =\n      typeof window === 'undefined' ? undefined : window.location.origin;\n    const src = useMemo(\n      () =>\n        buildEmbedUrl({\n          roomSlug,\n          joinToken,\n          userName,\n          externalUserId,\n          origin,\n          lang,\n          autoJoin,\n          hideLeave,\n          autoCameraOff,\n          autoTranscribe,\n          autoRecord,\n          instanceId,\n          hostOrigin,\n        }),\n      [\n        autoJoin,\n        autoRecord,\n        autoTranscribe,\n        externalUserId,\n        hideLeave,\n        hostOrigin,\n        instanceId,\n        joinToken,\n        lang,\n        origin,\n        roomSlug,\n        autoCameraOff,\n        userName,\n      ],\n    );\n    const { iframeRef } = useOeMeeting({\n      instanceId,\n      targetOrigin: resolvedTargetOrigin,\n      handleRef: ref,\n      onReady,\n      onJoined,\n      onLeft,\n      onParticipantJoined,\n      onParticipantLeft,\n      onEnded,\n      onError,\n      onStageChanged,\n      onTranscriptStarted,\n      onRecordingStarted,\n      onRecordingSaved,\n      onEvent,\n    });\n    const wrapperStyle: CSSProperties = {\n      width: toCssSize(width),\n      height: toCssSize(height),\n      ...style,\n    };\n    const frameStyle: CSSProperties = {\n      width: '100%',\n      height: '100%',\n      border: 0,\n      display: 'block',\n      ...iframeStyle,\n    };\n\n    return (\n      <div\n        className={className}\n        style={wrapperStyle}\n        data-oe-meeting-instance={instanceId}\n      >\n        <iframe\n          ref={iframeRef}\n          className={iframeClassName}\n          style={frameStyle}\n          src={src}\n          title={title}\n          allow={allow}\n          allowFullScreen\n          referrerPolicy=\"strict-origin-when-cross-origin\"\n        />\n      </div>\n    );\n  },\n);\n\nOeMeeting.displayName = 'OeMeeting';\n","export const EMBED_PROTOCOL_VERSION = 1 as const;\nexport const EMBED_MESSAGE_SOURCE = 'oemeeting' as const;\nexport const DEFAULT_EMBED_ORIGIN = 'https://meet.ocean.edu.vn';\n\nexport enum EmbedEventType {\n  READY = 'oemeeting:ready',\n  JOINED = 'oemeeting:joined',\n  LEFT = 'oemeeting:left',\n  PARTICIPANT_JOINED = 'oemeeting:participant-joined',\n  PARTICIPANT_LEFT = 'oemeeting:participant-left',\n  ENDED = 'oemeeting:ended',\n  ERROR = 'oemeeting:error',\n  STAGE_CHANGED = 'oemeeting:stage-changed',\n  TRANSCRIPT_STARTED = 'oemeeting:transcript-started',\n  RECORDING_STARTED = 'oemeeting:recording-started',\n  RECORDING_SAVED = 'oemeeting:recording-saved',\n}\n\nexport enum EmbedCommandType {\n  COMMAND = 'oemeeting:command',\n}\n\nexport enum EmbedCommandAction {\n  LEAVE = 'leave',\n  TOGGLE_MIC = 'toggleMic',\n  TOGGLE_CAMERA = 'toggleCamera',\n  OPEN_STAGE = 'openStage',\n  CLOSE_STAGE = 'closeStage',\n}\n\nexport enum EmbedErrorCode {\n  TOKEN_INVALID = 'TOKEN_INVALID',\n  TOKEN_EXPIRED = 'TOKEN_EXPIRED',\n  ROOM_NOT_FOUND = 'ROOM_NOT_FOUND',\n  ROOM_ACCESS_DENIED = 'ROOM_ACCESS_DENIED',\n  CONNECTION_FAILED = 'CONNECTION_FAILED',\n  PROTOCOL_MISMATCH = 'PROTOCOL_MISMATCH',\n  STAGE_ORIGIN_DENIED = 'STAGE_ORIGIN_DENIED',\n  STAGE_URL_INVALID = 'STAGE_URL_INVALID',\n  TRANSCRIPT_START_FAILED = 'TRANSCRIPT_START_FAILED',\n  RECORDING_START_FAILED = 'RECORDING_START_FAILED',\n  UNKNOWN = 'UNKNOWN',\n}\n\n/** Open host-owned tool id. Meeting does not catalog values. */\nexport type StageToolId = string;\n\nexport const MAX_STAGE_URL_LENGTH = 2048;\nexport const MAX_STAGE_TOOL_ID_LENGTH = 32;\n\nconst STAGE_TOOL_ID_PATTERN = /^[a-z][a-z0-9._-]{0,31}$/;\n\nexport function isStageToolId(value: unknown): value is StageToolId {\n  return (\n    typeof value === 'string' &&\n    value.length > 0 &&\n    value.length <= MAX_STAGE_TOOL_ID_LENGTH &&\n    STAGE_TOOL_ID_PATTERN.test(value)\n  );\n}\n\nexport enum EmbedQueryParam {\n  INSTANCE_ID = 'instanceId',\n  HOST_ORIGIN = 'hostOrigin',\n  JOIN_TOKEN = 'joinToken',\n  USER_NAME = 'userName',\n  EXTERNAL_USER_ID = 'externalUserId',\n  LANG = 'lang',\n  AUTO_JOIN = 'autoJoin',\n  HIDE_LEAVE = 'hideLeave',\n  AUTO_CAMERA_OFF = 'autoCameraOff',\n  AUTO_TRANSCRIBE = 'autoTranscribe',\n  AUTO_RECORD = 'autoRecord',\n}\n\n/**\n * What happened to the auto-transcribe request the embed made.\n *\n * `ALREADY_RUNNING` is the normal outcome for every participant after the\n * first, because the transcript is a room-level asset rather than a\n * per-participant one. `DISABLED` means the OE Meeting deployment has\n * transcription turned off.\n */\nexport enum EmbedCaptureOutcome {\n  STARTED = 'started',\n  ALREADY_RUNNING = 'already_running',\n  DISABLED = 'disabled',\n  FAILED = 'failed',\n}\n\n/**\n * Role the host app assigns when minting a join token.\n * Keep values aligned with `EmbedRole` in the backend embed-permission enum.\n */\nexport enum EmbedRole {\n  OWNER = 'owner',\n  MEMBER = 'member',\n}\n\n/**\n * Capability the host app may grant per role. Meeting enforces this on the\n * join token, not on a React prop. `screenShare` is the only value today.\n */\nexport enum EmbedCapability {\n  SCREEN_SHARE = 'screenShare',\n}\n\nexport interface EmbedPermissionMap {\n  owner?: EmbedCapability[];\n  member?: EmbedCapability[];\n}\n","import {\n  DEFAULT_EMBED_ORIGIN,\n  EmbedQueryParam,\n} from './embed-protocol';\nimport type { BuildEmbedUrlOptions } from './types';\n\nconst QUERY_FLAG_ENABLED = '1';\nconst QUERY_FLAG_DISABLED = '0';\n\nfunction toFlag(value: boolean | undefined): string | undefined {\n  if (value === undefined) return undefined;\n  return value ? QUERY_FLAG_ENABLED : QUERY_FLAG_DISABLED;\n}\n\nfunction normalizeOrigin(origin: string): string {\n  return origin.replace(/\\/+$/, '');\n}\n\nexport function buildEmbedUrl(options: BuildEmbedUrlOptions): string {\n  const roomSlug = options.roomSlug.trim();\n  const joinToken = options.joinToken.trim();\n  if (!roomSlug) {\n    throw new Error('OE Meeting embed requires a non-empty roomSlug.');\n  }\n  if (!joinToken) {\n    throw new Error('OE Meeting embed requires a non-empty joinToken.');\n  }\n\n  const origin = normalizeOrigin(options.origin ?? DEFAULT_EMBED_ORIGIN);\n  const url = new URL(`${origin}/embed/${encodeURIComponent(roomSlug)}`);\n  const entries: Array<[EmbedQueryParam, string | undefined]> = [\n    [EmbedQueryParam.INSTANCE_ID, options.instanceId],\n    [EmbedQueryParam.HOST_ORIGIN, options.hostOrigin],\n    [EmbedQueryParam.JOIN_TOKEN, joinToken],\n    [EmbedQueryParam.USER_NAME, options.userName],\n    [EmbedQueryParam.EXTERNAL_USER_ID, options.externalUserId],\n    [EmbedQueryParam.LANG, options.lang],\n    [EmbedQueryParam.AUTO_JOIN, toFlag(options.autoJoin)],\n    [EmbedQueryParam.HIDE_LEAVE, toFlag(options.hideLeave)],\n    [EmbedQueryParam.AUTO_CAMERA_OFF, toFlag(options.autoCameraOff)],\n    [EmbedQueryParam.AUTO_TRANSCRIBE, toFlag(options.autoTranscribe)],\n    [EmbedQueryParam.AUTO_RECORD, toFlag(options.autoRecord)],\n  ];\n\n  for (const [key, value] of entries) {\n    if (value !== undefined && value !== '') {\n      url.searchParams.set(key, value);\n    }\n  }\n  return url.toString();\n}\n","import {\n  useCallback,\n  useEffect,\n  useImperativeHandle,\n  useMemo,\n  useRef,\n  type Ref,\n} from 'react';\nimport {\n  EMBED_MESSAGE_SOURCE,\n  EMBED_PROTOCOL_VERSION,\n  EmbedCommandAction,\n  EmbedCommandType,\n  EmbedEventType,\n} from './embed-protocol';\nimport { normalizeOpenStageInput } from './openStage';\nimport { parseEmbedEvent } from './parseEmbedEvent';\nimport type {\n  EmbedCommandMessage,\n  OeMeetingHandle,\n  OeMeetingProps,\n  OpenStageInput,\n} from './types';\n\ntype UseOeMeetingOptions = Pick<\n  OeMeetingProps,\n  | 'onReady'\n  | 'onJoined'\n  | 'onLeft'\n  | 'onParticipantJoined'\n  | 'onParticipantLeft'\n  | 'onEnded'\n  | 'onError'\n  | 'onStageChanged'\n  | 'onTranscriptStarted'\n  | 'onRecordingStarted'\n  | 'onRecordingSaved'\n  | 'onEvent'\n> & {\n  instanceId: string;\n  targetOrigin: string;\n  handleRef?: Ref<OeMeetingHandle>;\n};\n\ninterface PostCommandOptions {\n  iframe: HTMLIFrameElement | null;\n  instanceId: string;\n  action: EmbedCommandAction;\n  targetOrigin: string;\n  payload?: OpenStageInput;\n}\n\nfunction postCommand(options: PostCommandOptions): void {\n  const frameWindow = options.iframe?.contentWindow;\n  if (!frameWindow) return;\n  const message: EmbedCommandMessage = {\n    source: EMBED_MESSAGE_SOURCE,\n    version: EMBED_PROTOCOL_VERSION,\n    instanceId: options.instanceId,\n    type: EmbedCommandType.COMMAND,\n    action: options.action,\n    ...(options.payload ? { payload: options.payload } : {}),\n  };\n  frameWindow.postMessage(message, options.targetOrigin);\n}\n\nexport function useOeMeeting(options: UseOeMeetingOptions) {\n  const iframeRef = useRef<HTMLIFrameElement | null>(null);\n  const callbacksRef = useRef(options);\n\n  useEffect(() => {\n    callbacksRef.current = options;\n  }, [options]);\n\n  useEffect(() => {\n    const onMessage = (event: MessageEvent<unknown>) => {\n      const frameWindow = iframeRef.current?.contentWindow;\n      if (\n        !frameWindow ||\n        event.source !== frameWindow ||\n        event.origin !== options.targetOrigin\n      ) {\n        return;\n      }\n      const embedEvent = parseEmbedEvent(event.data);\n      if (!embedEvent || embedEvent.instanceId !== options.instanceId) return;\n\n      const callbacks = callbacksRef.current;\n      callbacks.onEvent?.(embedEvent);\n      switch (embedEvent.type) {\n        case EmbedEventType.READY:\n          callbacks.onReady?.(embedEvent);\n          break;\n        case EmbedEventType.JOINED:\n          callbacks.onJoined?.(embedEvent);\n          break;\n        case EmbedEventType.LEFT:\n          callbacks.onLeft?.(embedEvent);\n          break;\n        case EmbedEventType.PARTICIPANT_JOINED:\n          callbacks.onParticipantJoined?.(embedEvent);\n          break;\n        case EmbedEventType.PARTICIPANT_LEFT:\n          callbacks.onParticipantLeft?.(embedEvent);\n          break;\n        case EmbedEventType.ENDED:\n          callbacks.onEnded?.(embedEvent);\n          break;\n        case EmbedEventType.ERROR:\n          callbacks.onError?.(embedEvent);\n          break;\n        case EmbedEventType.STAGE_CHANGED:\n          callbacks.onStageChanged?.(embedEvent);\n          break;\n        case EmbedEventType.TRANSCRIPT_STARTED:\n          callbacks.onTranscriptStarted?.(embedEvent);\n          break;\n        case EmbedEventType.RECORDING_STARTED:\n          callbacks.onRecordingStarted?.(embedEvent);\n          break;\n        case EmbedEventType.RECORDING_SAVED:\n          callbacks.onRecordingSaved?.(embedEvent);\n          break;\n      }\n    };\n\n    window.addEventListener('message', onMessage);\n    return () => window.removeEventListener('message', onMessage);\n  }, [options.instanceId, options.targetOrigin]);\n\n  const send = useCallback(\n    (action: EmbedCommandAction, payload?: OpenStageInput) =>\n      postCommand({\n        iframe: iframeRef.current,\n        instanceId: options.instanceId,\n        action,\n        targetOrigin: options.targetOrigin,\n        payload,\n      }),\n    [options.instanceId, options.targetOrigin],\n  );\n  const leave = useCallback(() => send(EmbedCommandAction.LEAVE), [send]);\n  const toggleMic = useCallback(\n    () => send(EmbedCommandAction.TOGGLE_MIC),\n    [send],\n  );\n  const toggleCamera = useCallback(\n    () => send(EmbedCommandAction.TOGGLE_CAMERA),\n    [send],\n  );\n  const openStage = useCallback(\n    (input: OpenStageInput) => {\n      const normalized = normalizeOpenStageInput(input);\n      if (!normalized) return;\n      send(EmbedCommandAction.OPEN_STAGE, normalized);\n    },\n    [send],\n  );\n  const closeStage = useCallback(\n    () => send(EmbedCommandAction.CLOSE_STAGE),\n    [send],\n  );\n  const getIframe = useCallback(() => iframeRef.current, []);\n  const handle = useMemo<OeMeetingHandle>(\n    () => ({\n      leave,\n      toggleMic,\n      toggleCamera,\n      openStage,\n      closeStage,\n      getIframe,\n    }),\n    [closeStage, getIframe, leave, openStage, toggleCamera, toggleMic],\n  );\n\n  useImperativeHandle(options.handleRef, () => handle, [handle]);\n  return { iframeRef, handle };\n}\n","import { isStageToolId, MAX_STAGE_URL_LENGTH } from './embed-protocol';\nimport type { OpenStageInput } from './types';\n\nexport function isValidStageUrl(url: string): boolean {\n  if (url.length === 0 || url.length > MAX_STAGE_URL_LENGTH) return false;\n  try {\n    const parsed = new URL(url);\n    if (parsed.protocol === 'https:') return true;\n    if (parsed.protocol === 'http:') {\n      return (\n        parsed.hostname === 'localhost' || parsed.hostname === '127.0.0.1'\n      );\n    }\n    return false;\n  } catch {\n    return false;\n  }\n}\n\nexport function normalizeOpenStageInput(\n  input: OpenStageInput,\n): OpenStageInput | null {\n  const url = input.url.trim();\n  if (!isValidStageUrl(url)) return null;\n  const title = input.title?.trim();\n  return {\n    url,\n    ...(title ? { title: title.slice(0, 200) } : {}),\n    ...(isStageToolId(input.tool) ? { tool: input.tool } : {}),\n  };\n}\n","import {\n  EMBED_MESSAGE_SOURCE,\n  EMBED_PROTOCOL_VERSION,\n  EmbedCaptureOutcome,\n  EmbedEventType,\n} from './embed-protocol';\nimport type { EmbedEvent } from './types';\n\nconst EVENT_TYPES = new Set<string>(Object.values(EmbedEventType));\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n\nfunction isOptionalString(value: unknown): boolean {\n  return value === undefined || typeof value === 'string';\n}\n\nfunction isNullableString(value: unknown): boolean {\n  return value === null || typeof value === 'string';\n}\n\nconst CAPTURE_OUTCOMES = new Set<string>(Object.values(EmbedCaptureOutcome));\n\nfunction isCaptureOutcome(value: unknown): boolean {\n  return typeof value === 'string' && CAPTURE_OUTCOMES.has(value);\n}\n\nfunction hasValidPayload(\n  type: EmbedEventType,\n  payload: Record<string, unknown>,\n): boolean {\n  switch (type) {\n    case EmbedEventType.READY:\n      return typeof payload.roomSlug === 'string';\n    case EmbedEventType.JOINED:\n      return (\n        typeof payload.roomSlug === 'string' &&\n        typeof payload.identity === 'string' &&\n        isOptionalString(payload.name) &&\n        typeof payload.joinedAt === 'string'\n      );\n    case EmbedEventType.LEFT:\n      return (\n        typeof payload.roomSlug === 'string' &&\n        typeof payload.identity === 'string' &&\n        typeof payload.leftAt === 'string' &&\n        (payload.durationMs === undefined ||\n          typeof payload.durationMs === 'number')\n      );\n    case EmbedEventType.PARTICIPANT_JOINED:\n      return (\n        typeof payload.identity === 'string' &&\n        isOptionalString(payload.name) &&\n        typeof payload.participantCount === 'number'\n      );\n    case EmbedEventType.PARTICIPANT_LEFT:\n      return (\n        typeof payload.identity === 'string' &&\n        typeof payload.participantCount === 'number'\n      );\n    case EmbedEventType.ENDED:\n      return (\n        typeof payload.roomSlug === 'string' &&\n        typeof payload.endedAt === 'string'\n      );\n    case EmbedEventType.ERROR:\n      return (\n        typeof payload.code === 'string' &&\n        typeof payload.message === 'string'\n      );\n    case EmbedEventType.STAGE_CHANGED:\n      return (\n        (payload.url === null || typeof payload.url === 'string') &&\n        isOptionalString(payload.title) &&\n        isOptionalString(payload.tool) &&\n        isOptionalString(payload.openedBy)\n      );\n    case EmbedEventType.TRANSCRIPT_STARTED:\n      return (\n        typeof payload.roomSlug === 'string' &&\n        isCaptureOutcome(payload.outcome) &&\n        isNullableString(payload.transcriptId) &&\n        isNullableString(payload.status)\n      );\n    case EmbedEventType.RECORDING_STARTED:\n      return (\n        typeof payload.roomSlug === 'string' &&\n        isCaptureOutcome(payload.outcome) &&\n        isNullableString(payload.recordingId) &&\n        isNullableString(payload.status)\n      );\n    case EmbedEventType.RECORDING_SAVED:\n      return (\n        typeof payload.roomSlug === 'string' &&\n        typeof payload.savedAt === 'string'\n      );\n  }\n}\n\nexport function parseEmbedEvent(data: unknown): EmbedEvent | null {\n  if (!isRecord(data)) return null;\n  if (\n    data.source !== EMBED_MESSAGE_SOURCE ||\n    data.version !== EMBED_PROTOCOL_VERSION ||\n    typeof data.instanceId !== 'string' ||\n    data.instanceId.length === 0 ||\n    typeof data.type !== 'string' ||\n    !EVENT_TYPES.has(data.type) ||\n    !isRecord(data.payload)\n  ) {\n    return null;\n  }\n\n  const type = data.type as EmbedEventType;\n  if (!hasValidPayload(type, data.payload)) return null;\n  return data as unknown as EmbedEvent;\n}\n"],"mappings":"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","names":["import_react","EmbedEventType","EmbedCommandType","EmbedCommandAction","EmbedErrorCode","EmbedQueryParam","EmbedCaptureOutcome","EmbedRole","EmbedCapability","OeMeeting"]}
+{"version":3,"sources":["../src/index.ts","../src/OeMeeting.tsx","../src/embed-protocol.ts","../src/openStage.ts","../src/background.ts","../src/buildEmbedUrl.ts","../src/useOeMeeting.ts","../src/parseEmbedEvent.ts"],"sourcesContent":["export { OeMeeting, DEFAULT_IFRAME_ALLOW } from './OeMeeting';\nexport { useOeMeeting } from './useOeMeeting';\nexport { buildEmbedUrl } from './buildEmbedUrl';\nexport { parseEmbedEvent } from './parseEmbedEvent';\nexport {\n  DEFAULT_EMBED_ORIGIN,\n  EMBED_MESSAGE_SOURCE,\n  EMBED_PROTOCOL_VERSION,\n  EmbedCapability,\n  EmbedCaptureOutcome,\n  EmbedBackgroundType,\n  EmbedCommandAction,\n  EmbedRole,\n  EmbedCommandType,\n  EmbedErrorCode,\n  EmbedEventType,\n  EmbedQueryParam,\n  isStageToolId,\n  MAX_BACKGROUND_URL_LENGTH,\n  MAX_STAGE_TOOL_ID_LENGTH,\n  MAX_STAGE_URL_LENGTH,\n} from './embed-protocol';\nexport type { EmbedBackground, EmbedPermissionMap, StageToolId } from './embed-protocol';\nexport { isValidStageUrl, normalizeOpenStageInput } from './openStage';\nexport { normalizeEmbedBackground, serializeEmbedBackground } from './background';\nexport type {\n  BuildEmbedUrlOptions,\n  EmbedCommandMessage,\n  EmbedEndedPayload,\n  EmbedErrorPayload,\n  EmbedEvent,\n  EmbedEventOf,\n  EmbedEventPayloadMap,\n  EmbedJoinedPayload,\n  EmbedLeftPayload,\n  EmbedMessageBase,\n  EmbedParticipantJoinedPayload,\n  EmbedParticipantLeftPayload,\n  EmbedReadyPayload,\n  EmbedRecordingSavedPayload,\n  EmbedRecordingStartedPayload,\n  EmbedStageChangedPayload,\n  EmbedTranscriptStartedPayload,\n  OeMeetingHandle,\n  OeMeetingProps,\n  OpenStageInput,\n} from './types';\n","'use client';\n\nimport {\n  forwardRef,\n  useId,\n  useMemo,\n  useRef,\n  type CSSProperties,\n} from 'react';\nimport { buildEmbedUrl } from './buildEmbedUrl';\nimport { DEFAULT_EMBED_ORIGIN } from './embed-protocol';\nimport type { OeMeetingHandle, OeMeetingProps } from './types';\nimport { useOeMeeting } from './useOeMeeting';\n\nexport const DEFAULT_IFRAME_ALLOW =\n  'camera; microphone; fullscreen; autoplay; display-capture; clipboard-write; encrypted-media';\n\nfunction toCssSize(value: number | string | undefined): string | undefined {\n  if (value === undefined) return undefined;\n  return typeof value === 'number' ? `${value}px` : value;\n}\n\nfunction getOrigin(value: string): string {\n  return new URL(value).origin;\n}\n\nexport const OeMeeting = forwardRef<OeMeetingHandle, OeMeetingProps>(\n  function OeMeeting(props, ref) {\n    const {\n      roomSlug,\n      joinToken,\n      userName,\n      externalUserId,\n      origin = DEFAULT_EMBED_ORIGIN,\n      lang,\n      autoJoin = true,\n      hideLeave,\n      autoCameraOff,\n      autoTranscribe,\n      autoRecord,\n      background,\n      title = 'OE Meeting room',\n      width = '100%',\n      height = 640,\n      className,\n      style,\n      iframeClassName,\n      iframeStyle,\n      allow = DEFAULT_IFRAME_ALLOW,\n      targetOrigin,\n      onReady,\n      onJoined,\n      onLeft,\n      onParticipantJoined,\n      onParticipantLeft,\n      onEnded,\n      onError,\n      onStageChanged,\n      onTranscriptStarted,\n      onRecordingStarted,\n      onRecordingSaved,\n      onEvent,\n    } = props;\n    const reactId = useId();\n    const instanceId = useMemo(\n      () => `oem-${reactId.replace(/:/g, '')}`,\n      [reactId],\n    );\n    const embedOrigin = useMemo(() => getOrigin(origin), [origin]);\n    const resolvedTargetOrigin = targetOrigin ?? embedOrigin;\n    const hostOrigin =\n      typeof window === 'undefined' ? undefined : window.location.origin;\n    // Only the mount-time background rides the embed URL. Later prop changes\n    // travel as `setBackground` commands (useOeMeeting); rebuilding src would\n    // reload the whole meeting mid-session.\n    const initialBackgroundRef = useRef(background);\n    const src = useMemo(\n      () =>\n        buildEmbedUrl({\n          roomSlug,\n          joinToken,\n          userName,\n          externalUserId,\n          origin,\n          lang,\n          autoJoin,\n          hideLeave,\n          autoCameraOff,\n          autoTranscribe,\n          autoRecord,\n          background: initialBackgroundRef.current,\n          instanceId,\n          hostOrigin,\n        }),\n      [\n        autoJoin,\n        autoRecord,\n        autoTranscribe,\n        externalUserId,\n        hideLeave,\n        hostOrigin,\n        instanceId,\n        joinToken,\n        lang,\n        origin,\n        roomSlug,\n        autoCameraOff,\n        userName,\n      ],\n    );\n    const { iframeRef } = useOeMeeting({\n      background,\n      instanceId,\n      targetOrigin: resolvedTargetOrigin,\n      handleRef: ref,\n      onReady,\n      onJoined,\n      onLeft,\n      onParticipantJoined,\n      onParticipantLeft,\n      onEnded,\n      onError,\n      onStageChanged,\n      onTranscriptStarted,\n      onRecordingStarted,\n      onRecordingSaved,\n      onEvent,\n    });\n    const wrapperStyle: CSSProperties = {\n      width: toCssSize(width),\n      height: toCssSize(height),\n      ...style,\n    };\n    const frameStyle: CSSProperties = {\n      width: '100%',\n      height: '100%',\n      border: 0,\n      display: 'block',\n      ...iframeStyle,\n    };\n\n    return (\n      <div\n        className={className}\n        style={wrapperStyle}\n        data-oe-meeting-instance={instanceId}\n      >\n        <iframe\n          ref={iframeRef}\n          className={iframeClassName}\n          style={frameStyle}\n          src={src}\n          title={title}\n          allow={allow}\n          allowFullScreen\n          referrerPolicy=\"strict-origin-when-cross-origin\"\n        />\n      </div>\n    );\n  },\n);\n\nOeMeeting.displayName = 'OeMeeting';\n","export const EMBED_PROTOCOL_VERSION = 1 as const;\nexport const EMBED_MESSAGE_SOURCE = 'oemeeting' as const;\nexport const DEFAULT_EMBED_ORIGIN = 'https://meet.ocean.edu.vn';\n\nexport enum EmbedEventType {\n  READY = 'oemeeting:ready',\n  JOINED = 'oemeeting:joined',\n  LEFT = 'oemeeting:left',\n  PARTICIPANT_JOINED = 'oemeeting:participant-joined',\n  PARTICIPANT_LEFT = 'oemeeting:participant-left',\n  ENDED = 'oemeeting:ended',\n  ERROR = 'oemeeting:error',\n  STAGE_CHANGED = 'oemeeting:stage-changed',\n  TRANSCRIPT_STARTED = 'oemeeting:transcript-started',\n  RECORDING_STARTED = 'oemeeting:recording-started',\n  RECORDING_SAVED = 'oemeeting:recording-saved',\n}\n\nexport enum EmbedCommandType {\n  COMMAND = 'oemeeting:command',\n}\n\nexport enum EmbedCommandAction {\n  LEAVE = 'leave',\n  TOGGLE_MIC = 'toggleMic',\n  TOGGLE_CAMERA = 'toggleCamera',\n  OPEN_STAGE = 'openStage',\n  CLOSE_STAGE = 'closeStage',\n  SET_BACKGROUND = 'setBackground',\n}\n\nexport enum EmbedErrorCode {\n  TOKEN_INVALID = 'TOKEN_INVALID',\n  TOKEN_EXPIRED = 'TOKEN_EXPIRED',\n  ROOM_NOT_FOUND = 'ROOM_NOT_FOUND',\n  ROOM_ACCESS_DENIED = 'ROOM_ACCESS_DENIED',\n  CONNECTION_FAILED = 'CONNECTION_FAILED',\n  PROTOCOL_MISMATCH = 'PROTOCOL_MISMATCH',\n  STAGE_ORIGIN_DENIED = 'STAGE_ORIGIN_DENIED',\n  STAGE_URL_INVALID = 'STAGE_URL_INVALID',\n  TRANSCRIPT_START_FAILED = 'TRANSCRIPT_START_FAILED',\n  RECORDING_START_FAILED = 'RECORDING_START_FAILED',\n  UNKNOWN = 'UNKNOWN',\n}\n\n/**\n * Host-controlled camera background applied to this embed's local user only.\n * `none` clears any active background effect. The host app enforces who may\n * set it; the meeting does not interpret roles for this value.\n */\nexport enum EmbedBackgroundType {\n  BLUR = 'blur',\n  IMAGE = 'image',\n  NONE = 'none',\n}\n\nexport const MAX_BACKGROUND_URL_LENGTH = 2048;\nexport const DEFAULT_BACKGROUND_BLUR_RADIUS = 10;\nexport const MIN_BACKGROUND_BLUR_RADIUS = 1;\nexport const MAX_BACKGROUND_BLUR_RADIUS = 50;\n\nexport interface EmbedBackground {\n  type: EmbedBackgroundType;\n  /** BLUR only. Defaults to `DEFAULT_BACKGROUND_BLUR_RADIUS`, clamped 1-50. */\n  blurRadius?: number;\n  /** IMAGE only. http(s) URL, max `MAX_BACKGROUND_URL_LENGTH`. */\n  url?: string;\n  /** When true the embed user cannot change blur/virtual backgrounds. */\n  locked?: boolean;\n}\n\n/** Open host-owned tool id. Meeting does not catalog values. */\nexport type StageToolId = string;\n\nexport const MAX_STAGE_URL_LENGTH = 2048;\nexport const MAX_STAGE_TOOL_ID_LENGTH = 32;\n\nconst STAGE_TOOL_ID_PATTERN = /^[a-z][a-z0-9._-]{0,31}$/;\n\nexport function isStageToolId(value: unknown): value is StageToolId {\n  return (\n    typeof value === 'string' &&\n    value.length > 0 &&\n    value.length <= MAX_STAGE_TOOL_ID_LENGTH &&\n    STAGE_TOOL_ID_PATTERN.test(value)\n  );\n}\n\nexport enum EmbedQueryParam {\n  INSTANCE_ID = 'instanceId',\n  HOST_ORIGIN = 'hostOrigin',\n  JOIN_TOKEN = 'joinToken',\n  USER_NAME = 'userName',\n  EXTERNAL_USER_ID = 'externalUserId',\n  LANG = 'lang',\n  AUTO_JOIN = 'autoJoin',\n  HIDE_LEAVE = 'hideLeave',\n  AUTO_CAMERA_OFF = 'autoCameraOff',\n  AUTO_TRANSCRIBE = 'autoTranscribe',\n  AUTO_RECORD = 'autoRecord',\n  BACKGROUND = 'background',\n}\n\n/**\n * What happened to the auto-transcribe request the embed made.\n *\n * `ALREADY_RUNNING` is the normal outcome for every participant after the\n * first, because the transcript is a room-level asset rather than a\n * per-participant one. `DISABLED` means the OE Meeting deployment has\n * transcription turned off.\n */\nexport enum EmbedCaptureOutcome {\n  STARTED = 'started',\n  ALREADY_RUNNING = 'already_running',\n  DISABLED = 'disabled',\n  FAILED = 'failed',\n}\n\n/**\n * Role the host app assigns when minting a join token.\n * Keep values aligned with `EmbedRole` in the backend embed-permission enum.\n */\nexport enum EmbedRole {\n  OWNER = 'owner',\n  MEMBER = 'member',\n}\n\n/**\n * Capability the host app may grant per role. Meeting enforces this on the\n * join token, not on a React prop. `screenShare` is the only value today.\n */\nexport enum EmbedCapability {\n  SCREEN_SHARE = 'screenShare',\n}\n\nexport interface EmbedPermissionMap {\n  owner?: EmbedCapability[];\n  member?: EmbedCapability[];\n}\n","import { isStageToolId, MAX_STAGE_URL_LENGTH } from './embed-protocol';\nimport type { OpenStageInput } from './types';\n\nexport function isValidStageUrl(url: string): boolean {\n  if (url.length === 0 || url.length > MAX_STAGE_URL_LENGTH) return false;\n  try {\n    const parsed = new URL(url);\n    if (parsed.protocol === 'https:') return true;\n    if (parsed.protocol === 'http:') {\n      return (\n        parsed.hostname === 'localhost' || parsed.hostname === '127.0.0.1'\n      );\n    }\n    return false;\n  } catch {\n    return false;\n  }\n}\n\nexport function normalizeOpenStageInput(\n  input: OpenStageInput,\n): OpenStageInput | null {\n  const url = input.url.trim();\n  if (!isValidStageUrl(url)) return null;\n  const title = input.title?.trim();\n  return {\n    url,\n    ...(title ? { title: title.slice(0, 200) } : {}),\n    ...(isStageToolId(input.tool) ? { tool: input.tool } : {}),\n  };\n}\n","import { isValidStageUrl } from './openStage';\nimport {\n  DEFAULT_BACKGROUND_BLUR_RADIUS,\n  EmbedBackgroundType,\n  MAX_BACKGROUND_BLUR_RADIUS,\n  MAX_BACKGROUND_URL_LENGTH,\n  MIN_BACKGROUND_BLUR_RADIUS,\n  type EmbedBackground,\n} from './embed-protocol';\n\n/** Same http(s) policy as the stage URL, including the localhost exception. */\nconst isValidBackgroundUrl = (url: string): boolean =>\n  url.length > 0 &&\n  url.length <= MAX_BACKGROUND_URL_LENGTH &&\n  isValidStageUrl(url);\n\nconst clampBlurRadius = (value: number): number =>\n  Number.isFinite(value)\n    ? Math.min(MAX_BACKGROUND_BLUR_RADIUS, Math.max(MIN_BACKGROUND_BLUR_RADIUS, Math.round(value)))\n    : DEFAULT_BACKGROUND_BLUR_RADIUS;\n\n/**\n * Validate and normalize a host-provided background. Returns null for invalid\n * input so callers can silently drop it, mirroring `normalizeOpenStageInput`.\n */\nexport function normalizeEmbedBackground(\n  input: EmbedBackground,\n): EmbedBackground | null {\n  const locked = input.locked === true ? { locked: true } : {};\n\n  if (input.type === EmbedBackgroundType.NONE) {\n    return { type: EmbedBackgroundType.NONE, ...locked };\n  }\n\n  if (input.type === EmbedBackgroundType.BLUR) {\n    return {\n      type: EmbedBackgroundType.BLUR,\n      blurRadius: clampBlurRadius(input.blurRadius ?? DEFAULT_BACKGROUND_BLUR_RADIUS),\n      ...locked,\n    };\n  }\n\n  if (input.type === EmbedBackgroundType.IMAGE) {\n    const url = input.url?.trim();\n    if (!url || !isValidBackgroundUrl(url)) return null;\n    return {\n      type: EmbedBackgroundType.IMAGE,\n      url,\n      ...locked,\n    };\n  }\n\n  return null;\n}\n\n/** JSON wire format shared by the `background` query param and the command payload. */\nexport function serializeEmbedBackground(\n  input: EmbedBackground,\n): string | undefined {\n  const normalized = normalizeEmbedBackground(input);\n  return normalized ? JSON.stringify(normalized) : undefined;\n}\n","import {\n  DEFAULT_EMBED_ORIGIN,\n  EmbedQueryParam,\n} from './embed-protocol';\nimport { serializeEmbedBackground } from './background';\nimport type { BuildEmbedUrlOptions } from './types';\n\nconst QUERY_FLAG_ENABLED = '1';\nconst QUERY_FLAG_DISABLED = '0';\n\nfunction toFlag(value: boolean | undefined): string | undefined {\n  if (value === undefined) return undefined;\n  return value ? QUERY_FLAG_ENABLED : QUERY_FLAG_DISABLED;\n}\n\nfunction normalizeOrigin(origin: string): string {\n  return origin.replace(/\\/+$/, '');\n}\n\nexport function buildEmbedUrl(options: BuildEmbedUrlOptions): string {\n  const roomSlug = options.roomSlug.trim();\n  const joinToken = options.joinToken.trim();\n  if (!roomSlug) {\n    throw new Error('OE Meeting embed requires a non-empty roomSlug.');\n  }\n  if (!joinToken) {\n    throw new Error('OE Meeting embed requires a non-empty joinToken.');\n  }\n\n  const origin = normalizeOrigin(options.origin ?? DEFAULT_EMBED_ORIGIN);\n  const url = new URL(`${origin}/embed/${encodeURIComponent(roomSlug)}`);\n  const backgroundParam = options.background\n    ? serializeEmbedBackground(options.background)\n    : undefined;\n\n  const entries: Array<[EmbedQueryParam, string | undefined]> = [\n    [EmbedQueryParam.INSTANCE_ID, options.instanceId],\n    [EmbedQueryParam.HOST_ORIGIN, options.hostOrigin],\n    [EmbedQueryParam.JOIN_TOKEN, joinToken],\n    [EmbedQueryParam.USER_NAME, options.userName],\n    [EmbedQueryParam.EXTERNAL_USER_ID, options.externalUserId],\n    [EmbedQueryParam.LANG, options.lang],\n    [EmbedQueryParam.AUTO_JOIN, toFlag(options.autoJoin)],\n    [EmbedQueryParam.HIDE_LEAVE, toFlag(options.hideLeave)],\n    [EmbedQueryParam.AUTO_CAMERA_OFF, toFlag(options.autoCameraOff)],\n    [EmbedQueryParam.AUTO_TRANSCRIBE, toFlag(options.autoTranscribe)],\n    [EmbedQueryParam.AUTO_RECORD, toFlag(options.autoRecord)],\n    [EmbedQueryParam.BACKGROUND, backgroundParam],\n  ];\n\n  for (const [key, value] of entries) {\n    if (value !== undefined && value !== '') {\n      url.searchParams.set(key, value);\n    }\n  }\n  return url.toString();\n}\n","import {\n  useCallback,\n  useEffect,\n  useImperativeHandle,\n  useMemo,\n  useRef,\n  type Ref,\n} from 'react';\nimport {\n  EMBED_MESSAGE_SOURCE,\n  EMBED_PROTOCOL_VERSION,\n  EmbedCommandAction,\n  EmbedCommandType,\n  EmbedEventType,\n} from './embed-protocol';\nimport { normalizeEmbedBackground } from './background';\nimport { normalizeOpenStageInput } from './openStage';\nimport { parseEmbedEvent } from './parseEmbedEvent';\nimport type {\n  EmbedCommandMessage,\n  OeMeetingHandle,\n  OeMeetingProps,\n  OpenStageInput,\n} from './types';\nimport type { EmbedBackground } from './embed-protocol';\n\ntype UseOeMeetingOptions = Pick<\n  OeMeetingProps,\n  | 'onReady'\n  | 'onJoined'\n  | 'onLeft'\n  | 'onParticipantJoined'\n  | 'onParticipantLeft'\n  | 'onEnded'\n  | 'onError'\n  | 'onStageChanged'\n  | 'onTranscriptStarted'\n  | 'onRecordingStarted'\n  | 'onRecordingSaved'\n  | 'onEvent'\n  | 'background'\n> & {\n  instanceId: string;\n  targetOrigin: string;\n  handleRef?: Ref<OeMeetingHandle>;\n};\n\ninterface PostCommandOptions {\n  iframe: HTMLIFrameElement | null;\n  instanceId: string;\n  action: EmbedCommandAction;\n  targetOrigin: string;\n  payload?: OpenStageInput | EmbedBackground;\n}\n\nfunction postCommand(options: PostCommandOptions): void {\n  const frameWindow = options.iframe?.contentWindow;\n  if (!frameWindow) return;\n  const message: EmbedCommandMessage = {\n    source: EMBED_MESSAGE_SOURCE,\n    version: EMBED_PROTOCOL_VERSION,\n    instanceId: options.instanceId,\n    type: EmbedCommandType.COMMAND,\n    action: options.action,\n    ...(options.payload ? { payload: options.payload } : {}),\n  };\n  frameWindow.postMessage(message, options.targetOrigin);\n}\n\nexport function useOeMeeting(options: UseOeMeetingOptions) {\n  const iframeRef = useRef<HTMLIFrameElement | null>(null);\n  const callbacksRef = useRef(options);\n  // Last background the host set. Resent on READY: commands posted before the\n  // iframe bridge mounts are dropped by the browser.\n  const pendingBackgroundRef = useRef<EmbedBackground | null>(null);\n\n  useEffect(() => {\n    callbacksRef.current = options;\n  }, [options]);\n\n  useEffect(() => {\n    const onMessage = (event: MessageEvent<unknown>) => {\n      const frameWindow = iframeRef.current?.contentWindow;\n      if (\n        !frameWindow ||\n        event.source !== frameWindow ||\n        event.origin !== options.targetOrigin\n      ) {\n        return;\n      }\n      const embedEvent = parseEmbedEvent(event.data);\n      if (!embedEvent || embedEvent.instanceId !== options.instanceId) return;\n\n      const callbacks = callbacksRef.current;\n      callbacks.onEvent?.(embedEvent);\n      switch (embedEvent.type) {\n        case EmbedEventType.READY:\n          callbacks.onReady?.(embedEvent);\n          if (pendingBackgroundRef.current) {\n            postCommand({\n              iframe: iframeRef.current,\n              instanceId: options.instanceId,\n              action: EmbedCommandAction.SET_BACKGROUND,\n              targetOrigin: options.targetOrigin,\n              payload: pendingBackgroundRef.current,\n            });\n          }\n          break;\n        case EmbedEventType.JOINED:\n          callbacks.onJoined?.(embedEvent);\n          break;\n        case EmbedEventType.LEFT:\n          callbacks.onLeft?.(embedEvent);\n          break;\n        case EmbedEventType.PARTICIPANT_JOINED:\n          callbacks.onParticipantJoined?.(embedEvent);\n          break;\n        case EmbedEventType.PARTICIPANT_LEFT:\n          callbacks.onParticipantLeft?.(embedEvent);\n          break;\n        case EmbedEventType.ENDED:\n          callbacks.onEnded?.(embedEvent);\n          break;\n        case EmbedEventType.ERROR:\n          callbacks.onError?.(embedEvent);\n          break;\n        case EmbedEventType.STAGE_CHANGED:\n          callbacks.onStageChanged?.(embedEvent);\n          break;\n        case EmbedEventType.TRANSCRIPT_STARTED:\n          callbacks.onTranscriptStarted?.(embedEvent);\n          break;\n        case EmbedEventType.RECORDING_STARTED:\n          callbacks.onRecordingStarted?.(embedEvent);\n          break;\n        case EmbedEventType.RECORDING_SAVED:\n          callbacks.onRecordingSaved?.(embedEvent);\n          break;\n      }\n    };\n\n    window.addEventListener('message', onMessage);\n    return () => window.removeEventListener('message', onMessage);\n  }, [options.instanceId, options.targetOrigin]);\n\n  const send = useCallback(\n    (\n      action: EmbedCommandAction,\n      payload?: OpenStageInput | EmbedBackground\n    ) =>\n      postCommand({\n        iframe: iframeRef.current,\n        instanceId: options.instanceId,\n        action,\n        targetOrigin: options.targetOrigin,\n        payload,\n      }),\n    [options.instanceId, options.targetOrigin],\n  );\n  const leave = useCallback(() => send(EmbedCommandAction.LEAVE), [send]);\n  const toggleMic = useCallback(\n    () => send(EmbedCommandAction.TOGGLE_MIC),\n    [send],\n  );\n  const toggleCamera = useCallback(\n    () => send(EmbedCommandAction.TOGGLE_CAMERA),\n    [send],\n  );\n  const openStage = useCallback(\n    (input: OpenStageInput) => {\n      const normalized = normalizeOpenStageInput(input);\n      if (!normalized) return;\n      send(EmbedCommandAction.OPEN_STAGE, normalized);\n    },\n    [send],\n  );\n  const closeStage = useCallback(\n    () => send(EmbedCommandAction.CLOSE_STAGE),\n    [send],\n  );\n\n  useEffect(() => {\n    if (!options.background) {\n      pendingBackgroundRef.current = null;\n      return;\n    }\n    const normalized = normalizeEmbedBackground(options.background);\n    if (!normalized) return;\n    pendingBackgroundRef.current = normalized;\n    send(EmbedCommandAction.SET_BACKGROUND, normalized);\n  }, [options.background, send]);\n  const getIframe = useCallback(() => iframeRef.current, []);\n  const handle = useMemo<OeMeetingHandle>(\n    () => ({\n      leave,\n      toggleMic,\n      toggleCamera,\n      openStage,\n      closeStage,\n      getIframe,\n    }),\n    [closeStage, getIframe, leave, openStage, toggleCamera, toggleMic],\n  );\n\n  useImperativeHandle(options.handleRef, () => handle, [handle]);\n  return { iframeRef, handle };\n}\n","import {\n  EMBED_MESSAGE_SOURCE,\n  EMBED_PROTOCOL_VERSION,\n  EmbedCaptureOutcome,\n  EmbedEventType,\n} from './embed-protocol';\nimport type { EmbedEvent } from './types';\n\nconst EVENT_TYPES = new Set<string>(Object.values(EmbedEventType));\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n\nfunction isOptionalString(value: unknown): boolean {\n  return value === undefined || typeof value === 'string';\n}\n\nfunction isNullableString(value: unknown): boolean {\n  return value === null || typeof value === 'string';\n}\n\nconst CAPTURE_OUTCOMES = new Set<string>(Object.values(EmbedCaptureOutcome));\n\nfunction isCaptureOutcome(value: unknown): boolean {\n  return typeof value === 'string' && CAPTURE_OUTCOMES.has(value);\n}\n\nfunction hasValidPayload(\n  type: EmbedEventType,\n  payload: Record<string, unknown>,\n): boolean {\n  switch (type) {\n    case EmbedEventType.READY:\n      return typeof payload.roomSlug === 'string';\n    case EmbedEventType.JOINED:\n      return (\n        typeof payload.roomSlug === 'string' &&\n        typeof payload.identity === 'string' &&\n        isOptionalString(payload.name) &&\n        typeof payload.joinedAt === 'string'\n      );\n    case EmbedEventType.LEFT:\n      return (\n        typeof payload.roomSlug === 'string' &&\n        typeof payload.identity === 'string' &&\n        typeof payload.leftAt === 'string' &&\n        (payload.durationMs === undefined ||\n          typeof payload.durationMs === 'number')\n      );\n    case EmbedEventType.PARTICIPANT_JOINED:\n      return (\n        typeof payload.identity === 'string' &&\n        isOptionalString(payload.name) &&\n        typeof payload.participantCount === 'number'\n      );\n    case EmbedEventType.PARTICIPANT_LEFT:\n      return (\n        typeof payload.identity === 'string' &&\n        typeof payload.participantCount === 'number'\n      );\n    case EmbedEventType.ENDED:\n      return (\n        typeof payload.roomSlug === 'string' &&\n        typeof payload.endedAt === 'string'\n      );\n    case EmbedEventType.ERROR:\n      return (\n        typeof payload.code === 'string' &&\n        typeof payload.message === 'string'\n      );\n    case EmbedEventType.STAGE_CHANGED:\n      return (\n        (payload.url === null || typeof payload.url === 'string') &&\n        isOptionalString(payload.title) &&\n        isOptionalString(payload.tool) &&\n        isOptionalString(payload.openedBy)\n      );\n    case EmbedEventType.TRANSCRIPT_STARTED:\n      return (\n        typeof payload.roomSlug === 'string' &&\n        isCaptureOutcome(payload.outcome) &&\n        isNullableString(payload.transcriptId) &&\n        isNullableString(payload.status)\n      );\n    case EmbedEventType.RECORDING_STARTED:\n      return (\n        typeof payload.roomSlug === 'string' &&\n        isCaptureOutcome(payload.outcome) &&\n        isNullableString(payload.recordingId) &&\n        isNullableString(payload.status)\n      );\n    case EmbedEventType.RECORDING_SAVED:\n      return (\n        typeof payload.roomSlug === 'string' &&\n        typeof payload.savedAt === 'string'\n      );\n  }\n}\n\nexport function parseEmbedEvent(data: unknown): EmbedEvent | null {\n  if (!isRecord(data)) return null;\n  if (\n    data.source !== EMBED_MESSAGE_SOURCE ||\n    data.version !== EMBED_PROTOCOL_VERSION ||\n    typeof data.instanceId !== 'string' ||\n    data.instanceId.length === 0 ||\n    typeof data.type !== 'string' ||\n    !EVENT_TYPES.has(data.type) ||\n    !isRecord(data.payload)\n  ) {\n    return null;\n  }\n\n  const type = data.type as EmbedEventType;\n  if (!hasValidPayload(type, data.payload)) return null;\n  return data as unknown as EmbedEvent;\n}\n"],"mappings":"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","names":["import_react","EmbedEventType","EmbedCommandType","EmbedCommandAction","EmbedErrorCode","EmbedBackgroundType","EmbedQueryParam","EmbedCaptureOutcome","EmbedRole","EmbedCapability","OeMeeting"]}

package/dist/index.d.cts

@@ -25,7 +25,8 @@ declare enum EmbedCommandAction {
     TOGGLE_MIC = "toggleMic",
     TOGGLE_CAMERA = "toggleCamera",
     OPEN_STAGE = "openStage",
-    CLOSE_STAGE = "closeStage"
+    CLOSE_STAGE = "closeStage",
+    SET_BACKGROUND = "setBackground"
 }
 declare enum EmbedErrorCode {
     TOKEN_INVALID = "TOKEN_INVALID",
@@ -40,6 +41,26 @@ declare enum EmbedErrorCode {
     RECORDING_START_FAILED = "RECORDING_START_FAILED",
     UNKNOWN = "UNKNOWN"
 }
+/**
+ * Host-controlled camera background applied to this embed's local user only.
+ * `none` clears any active background effect. The host app enforces who may
+ * set it; the meeting does not interpret roles for this value.
+ */
+declare enum EmbedBackgroundType {
+    BLUR = "blur",
+    IMAGE = "image",
+    NONE = "none"
+}
+declare const MAX_BACKGROUND_URL_LENGTH = 2048;
+interface EmbedBackground {
+    type: EmbedBackgroundType;
+    /** BLUR only. Defaults to `DEFAULT_BACKGROUND_BLUR_RADIUS`, clamped 1-50. */
+    blurRadius?: number;
+    /** IMAGE only. http(s) URL, max `MAX_BACKGROUND_URL_LENGTH`. */
+    url?: string;
+    /** When true the embed user cannot change blur/virtual backgrounds. */
+    locked?: boolean;
+}
 /** Open host-owned tool id. Meeting does not catalog values. */
 type StageToolId = string;
 declare const MAX_STAGE_URL_LENGTH = 2048;
@@ -56,7 +77,8 @@ declare enum EmbedQueryParam {
     HIDE_LEAVE = "hideLeave",
     AUTO_CAMERA_OFF = "autoCameraOff",
     AUTO_TRANSCRIBE = "autoTranscribe",
-    AUTO_RECORD = "autoRecord"
+    AUTO_RECORD = "autoRecord",
+    BACKGROUND = "background"
 }
 /**
  * What happened to the auto-transcribe request the embed made.
@@ -197,7 +219,7 @@ type EmbedEventOf<T extends EmbedEventType> = Extract<EmbedEvent, {
 type EmbedCommandMessage = EmbedMessageBase & {
     type: 'oemeeting:command';
     action: EmbedCommandAction;
-    payload?: OpenStageInput;
+    payload?: OpenStageInput | EmbedBackground;
 };
 interface OeMeetingHandle {
     leave: () => void;
@@ -231,6 +253,14 @@ interface OeMeetingProps {
     autoTranscribe?: boolean;
     /** Start the shared room recording as soon as the embed connects. */
     autoRecord?: boolean;
+    /**
+     * Apply a camera background to this embed's local user (blur / image /
+     * none), optionally locking their own background choices. Pass the same
+     * value for every participant to brand an event. The initial value rides
+     * the embed URL; later changes are sent as a `setBackground` command once
+     * the embed is ready. Invalid input is ignored.
+     */
+    background?: EmbedBackground;
     title?: string;
     width?: number | string;
     height?: number | string;
@@ -270,6 +300,7 @@ interface BuildEmbedUrlOptions {
     autoCameraOff?: boolean;
     autoTranscribe?: boolean;
     autoRecord?: boolean;
+    background?: EmbedBackground;
     instanceId?: string;
     hostOrigin?: string;
 }
@@ -277,7 +308,7 @@ interface BuildEmbedUrlOptions {
 declare const DEFAULT_IFRAME_ALLOW = "camera; microphone; fullscreen; autoplay; display-capture; clipboard-write; encrypted-media";
 declare const OeMeeting: react.ForwardRefExoticComponent<OeMeetingProps & react.RefAttributes<OeMeetingHandle>>;
 
-type UseOeMeetingOptions = Pick<OeMeetingProps, 'onReady' | 'onJoined' | 'onLeft' | 'onParticipantJoined' | 'onParticipantLeft' | 'onEnded' | 'onError' | 'onStageChanged' | 'onTranscriptStarted' | 'onRecordingStarted' | 'onRecordingSaved' | 'onEvent'> & {
+type UseOeMeetingOptions = Pick<OeMeetingProps, 'onReady' | 'onJoined' | 'onLeft' | 'onParticipantJoined' | 'onParticipantLeft' | 'onEnded' | 'onError' | 'onStageChanged' | 'onTranscriptStarted' | 'onRecordingStarted' | 'onRecordingSaved' | 'onEvent' | 'background'> & {
     instanceId: string;
     targetOrigin: string;
     handleRef?: Ref<OeMeetingHandle>;
@@ -294,4 +325,12 @@ declare function parseEmbedEvent(data: unknown): EmbedEvent | null;
 declare function isValidStageUrl(url: string): boolean;
 declare function normalizeOpenStageInput(input: OpenStageInput): OpenStageInput | null;
 
-export { type BuildEmbedUrlOptions, DEFAULT_EMBED_ORIGIN, DEFAULT_IFRAME_ALLOW, EMBED_MESSAGE_SOURCE, EMBED_PROTOCOL_VERSION, EmbedCapability, EmbedCaptureOutcome, EmbedCommandAction, type EmbedCommandMessage, EmbedCommandType, type EmbedEndedPayload, EmbedErrorCode, type EmbedErrorPayload, type EmbedEvent, type EmbedEventOf, type EmbedEventPayloadMap, EmbedEventType, type EmbedJoinedPayload, type EmbedLeftPayload, type EmbedMessageBase, type EmbedParticipantJoinedPayload, type EmbedParticipantLeftPayload, type EmbedPermissionMap, EmbedQueryParam, type EmbedReadyPayload, type EmbedRecordingSavedPayload, type EmbedRecordingStartedPayload, EmbedRole, type EmbedStageChangedPayload, type EmbedTranscriptStartedPayload, MAX_STAGE_TOOL_ID_LENGTH, MAX_STAGE_URL_LENGTH, OeMeeting, type OeMeetingHandle, type OeMeetingProps, type OpenStageInput, type StageToolId, buildEmbedUrl, isStageToolId, isValidStageUrl, normalizeOpenStageInput, parseEmbedEvent, useOeMeeting };
+/**
+ * Validate and normalize a host-provided background. Returns null for invalid
+ * input so callers can silently drop it, mirroring `normalizeOpenStageInput`.
+ */
+declare function normalizeEmbedBackground(input: EmbedBackground): EmbedBackground | null;
+/** JSON wire format shared by the `background` query param and the command payload. */
+declare function serializeEmbedBackground(input: EmbedBackground): string | undefined;
+
+export { type BuildEmbedUrlOptions, DEFAULT_EMBED_ORIGIN, DEFAULT_IFRAME_ALLOW, EMBED_MESSAGE_SOURCE, EMBED_PROTOCOL_VERSION, type EmbedBackground, EmbedBackgroundType, EmbedCapability, EmbedCaptureOutcome, EmbedCommandAction, type EmbedCommandMessage, EmbedCommandType, type EmbedEndedPayload, EmbedErrorCode, type EmbedErrorPayload, type EmbedEvent, type EmbedEventOf, type EmbedEventPayloadMap, EmbedEventType, type EmbedJoinedPayload, type EmbedLeftPayload, type EmbedMessageBase, type EmbedParticipantJoinedPayload, type EmbedParticipantLeftPayload, type EmbedPermissionMap, EmbedQueryParam, type EmbedReadyPayload, type EmbedRecordingSavedPayload, type EmbedRecordingStartedPayload, EmbedRole, type EmbedStageChangedPayload, type EmbedTranscriptStartedPayload, MAX_BACKGROUND_URL_LENGTH, MAX_STAGE_TOOL_ID_LENGTH, MAX_STAGE_URL_LENGTH, OeMeeting, type OeMeetingHandle, type OeMeetingProps, type OpenStageInput, type StageToolId, buildEmbedUrl, isStageToolId, isValidStageUrl, normalizeEmbedBackground, normalizeOpenStageInput, parseEmbedEvent, serializeEmbedBackground, useOeMeeting };

package/dist/index.d.ts

@@ -25,7 +25,8 @@ declare enum EmbedCommandAction {
     TOGGLE_MIC = "toggleMic",
     TOGGLE_CAMERA = "toggleCamera",
     OPEN_STAGE = "openStage",
-    CLOSE_STAGE = "closeStage"
+    CLOSE_STAGE = "closeStage",
+    SET_BACKGROUND = "setBackground"
 }
 declare enum EmbedErrorCode {
     TOKEN_INVALID = "TOKEN_INVALID",
@@ -40,6 +41,26 @@ declare enum EmbedErrorCode {
     RECORDING_START_FAILED = "RECORDING_START_FAILED",
     UNKNOWN = "UNKNOWN"
 }
+/**
+ * Host-controlled camera background applied to this embed's local user only.
+ * `none` clears any active background effect. The host app enforces who may
+ * set it; the meeting does not interpret roles for this value.
+ */
+declare enum EmbedBackgroundType {
+    BLUR = "blur",
+    IMAGE = "image",
+    NONE = "none"
+}
+declare const MAX_BACKGROUND_URL_LENGTH = 2048;
+interface EmbedBackground {
+    type: EmbedBackgroundType;
+    /** BLUR only. Defaults to `DEFAULT_BACKGROUND_BLUR_RADIUS`, clamped 1-50. */
+    blurRadius?: number;
+    /** IMAGE only. http(s) URL, max `MAX_BACKGROUND_URL_LENGTH`. */
+    url?: string;
+    /** When true the embed user cannot change blur/virtual backgrounds. */
+    locked?: boolean;
+}
 /** Open host-owned tool id. Meeting does not catalog values. */
 type StageToolId = string;
 declare const MAX_STAGE_URL_LENGTH = 2048;
@@ -56,7 +77,8 @@ declare enum EmbedQueryParam {
     HIDE_LEAVE = "hideLeave",
     AUTO_CAMERA_OFF = "autoCameraOff",
     AUTO_TRANSCRIBE = "autoTranscribe",
-    AUTO_RECORD = "autoRecord"
+    AUTO_RECORD = "autoRecord",
+    BACKGROUND = "background"
 }
 /**
  * What happened to the auto-transcribe request the embed made.
@@ -197,7 +219,7 @@ type EmbedEventOf<T extends EmbedEventType> = Extract<EmbedEvent, {
 type EmbedCommandMessage = EmbedMessageBase & {
     type: 'oemeeting:command';
     action: EmbedCommandAction;
-    payload?: OpenStageInput;
+    payload?: OpenStageInput | EmbedBackground;
 };
 interface OeMeetingHandle {
     leave: () => void;
@@ -231,6 +253,14 @@ interface OeMeetingProps {
     autoTranscribe?: boolean;
     /** Start the shared room recording as soon as the embed connects. */
     autoRecord?: boolean;
+    /**
+     * Apply a camera background to this embed's local user (blur / image /
+     * none), optionally locking their own background choices. Pass the same
+     * value for every participant to brand an event. The initial value rides
+     * the embed URL; later changes are sent as a `setBackground` command once
+     * the embed is ready. Invalid input is ignored.
+     */
+    background?: EmbedBackground;
     title?: string;
     width?: number | string;
     height?: number | string;
@@ -270,6 +300,7 @@ interface BuildEmbedUrlOptions {
     autoCameraOff?: boolean;
     autoTranscribe?: boolean;
     autoRecord?: boolean;
+    background?: EmbedBackground;
     instanceId?: string;
     hostOrigin?: string;
 }
@@ -277,7 +308,7 @@ interface BuildEmbedUrlOptions {
 declare const DEFAULT_IFRAME_ALLOW = "camera; microphone; fullscreen; autoplay; display-capture; clipboard-write; encrypted-media";
 declare const OeMeeting: react.ForwardRefExoticComponent<OeMeetingProps & react.RefAttributes<OeMeetingHandle>>;
 
-type UseOeMeetingOptions = Pick<OeMeetingProps, 'onReady' | 'onJoined' | 'onLeft' | 'onParticipantJoined' | 'onParticipantLeft' | 'onEnded' | 'onError' | 'onStageChanged' | 'onTranscriptStarted' | 'onRecordingStarted' | 'onRecordingSaved' | 'onEvent'> & {
+type UseOeMeetingOptions = Pick<OeMeetingProps, 'onReady' | 'onJoined' | 'onLeft' | 'onParticipantJoined' | 'onParticipantLeft' | 'onEnded' | 'onError' | 'onStageChanged' | 'onTranscriptStarted' | 'onRecordingStarted' | 'onRecordingSaved' | 'onEvent' | 'background'> & {
     instanceId: string;
     targetOrigin: string;
     handleRef?: Ref<OeMeetingHandle>;
@@ -294,4 +325,12 @@ declare function parseEmbedEvent(data: unknown): EmbedEvent | null;
 declare function isValidStageUrl(url: string): boolean;
 declare function normalizeOpenStageInput(input: OpenStageInput): OpenStageInput | null;
 
-export { type BuildEmbedUrlOptions, DEFAULT_EMBED_ORIGIN, DEFAULT_IFRAME_ALLOW, EMBED_MESSAGE_SOURCE, EMBED_PROTOCOL_VERSION, EmbedCapability, EmbedCaptureOutcome, EmbedCommandAction, type EmbedCommandMessage, EmbedCommandType, type EmbedEndedPayload, EmbedErrorCode, type EmbedErrorPayload, type EmbedEvent, type EmbedEventOf, type EmbedEventPayloadMap, EmbedEventType, type EmbedJoinedPayload, type EmbedLeftPayload, type EmbedMessageBase, type EmbedParticipantJoinedPayload, type EmbedParticipantLeftPayload, type EmbedPermissionMap, EmbedQueryParam, type EmbedReadyPayload, type EmbedRecordingSavedPayload, type EmbedRecordingStartedPayload, EmbedRole, type EmbedStageChangedPayload, type EmbedTranscriptStartedPayload, MAX_STAGE_TOOL_ID_LENGTH, MAX_STAGE_URL_LENGTH, OeMeeting, type OeMeetingHandle, type OeMeetingProps, type OpenStageInput, type StageToolId, buildEmbedUrl, isStageToolId, isValidStageUrl, normalizeOpenStageInput, parseEmbedEvent, useOeMeeting };
+/**
+ * Validate and normalize a host-provided background. Returns null for invalid
+ * input so callers can silently drop it, mirroring `normalizeOpenStageInput`.
+ */
+declare function normalizeEmbedBackground(input: EmbedBackground): EmbedBackground | null;
+/** JSON wire format shared by the `background` query param and the command payload. */
+declare function serializeEmbedBackground(input: EmbedBackground): string | undefined;
+
+export { type BuildEmbedUrlOptions, DEFAULT_EMBED_ORIGIN, DEFAULT_IFRAME_ALLOW, EMBED_MESSAGE_SOURCE, EMBED_PROTOCOL_VERSION, type EmbedBackground, EmbedBackgroundType, EmbedCapability, EmbedCaptureOutcome, EmbedCommandAction, type EmbedCommandMessage, EmbedCommandType, type EmbedEndedPayload, EmbedErrorCode, type EmbedErrorPayload, type EmbedEvent, type EmbedEventOf, type EmbedEventPayloadMap, EmbedEventType, type EmbedJoinedPayload, type EmbedLeftPayload, type EmbedMessageBase, type EmbedParticipantJoinedPayload, type EmbedParticipantLeftPayload, type EmbedPermissionMap, EmbedQueryParam, type EmbedReadyPayload, type EmbedRecordingSavedPayload, type EmbedRecordingStartedPayload, EmbedRole, type EmbedStageChangedPayload, type EmbedTranscriptStartedPayload, MAX_BACKGROUND_URL_LENGTH, MAX_STAGE_TOOL_ID_LENGTH, MAX_STAGE_URL_LENGTH, OeMeeting, type OeMeetingHandle, type OeMeetingProps, type OpenStageInput, type StageToolId, buildEmbedUrl, isStageToolId, isValidStageUrl, normalizeEmbedBackground, normalizeOpenStageInput, parseEmbedEvent, serializeEmbedBackground, useOeMeeting };

package/dist/index.js

@@ -2,7 +2,8 @@
 import {
   forwardRef,
   useId,
-  useMemo as useMemo2
+  useMemo as useMemo2,
+  useRef as useRef2
 } from "react";
 
 // src/embed-protocol.ts
@@ -33,6 +34,7 @@ var EmbedCommandAction = /* @__PURE__ */ ((EmbedCommandAction2) => {
   EmbedCommandAction2["TOGGLE_CAMERA"] = "toggleCamera";
   EmbedCommandAction2["OPEN_STAGE"] = "openStage";
   EmbedCommandAction2["CLOSE_STAGE"] = "closeStage";
+  EmbedCommandAction2["SET_BACKGROUND"] = "setBackground";
   return EmbedCommandAction2;
 })(EmbedCommandAction || {});
 var EmbedErrorCode = /* @__PURE__ */ ((EmbedErrorCode2) => {
@@ -49,6 +51,16 @@ var EmbedErrorCode = /* @__PURE__ */ ((EmbedErrorCode2) => {
   EmbedErrorCode2["UNKNOWN"] = "UNKNOWN";
   return EmbedErrorCode2;
 })(EmbedErrorCode || {});
+var EmbedBackgroundType = /* @__PURE__ */ ((EmbedBackgroundType2) => {
+  EmbedBackgroundType2["BLUR"] = "blur";
+  EmbedBackgroundType2["IMAGE"] = "image";
+  EmbedBackgroundType2["NONE"] = "none";
+  return EmbedBackgroundType2;
+})(EmbedBackgroundType || {});
+var MAX_BACKGROUND_URL_LENGTH = 2048;
+var DEFAULT_BACKGROUND_BLUR_RADIUS = 10;
+var MIN_BACKGROUND_BLUR_RADIUS = 1;
+var MAX_BACKGROUND_BLUR_RADIUS = 50;
 var MAX_STAGE_URL_LENGTH = 2048;
 var MAX_STAGE_TOOL_ID_LENGTH = 32;
 var STAGE_TOOL_ID_PATTERN = /^[a-z][a-z0-9._-]{0,31}$/;
@@ -67,6 +79,7 @@ var EmbedQueryParam = /* @__PURE__ */ ((EmbedQueryParam2) => {
   EmbedQueryParam2["AUTO_CAMERA_OFF"] = "autoCameraOff";
   EmbedQueryParam2["AUTO_TRANSCRIBE"] = "autoTranscribe";
   EmbedQueryParam2["AUTO_RECORD"] = "autoRecord";
+  EmbedQueryParam2["BACKGROUND"] = "background";
   return EmbedQueryParam2;
 })(EmbedQueryParam || {});
 var EmbedCaptureOutcome = /* @__PURE__ */ ((EmbedCaptureOutcome2) => {
@@ -86,6 +99,62 @@ var EmbedCapability = /* @__PURE__ */ ((EmbedCapability2) => {
   return EmbedCapability2;
 })(EmbedCapability || {});
 
+// src/openStage.ts
+function isValidStageUrl(url) {
+  if (url.length === 0 || url.length > MAX_STAGE_URL_LENGTH) return false;
+  try {
+    const parsed = new URL(url);
+    if (parsed.protocol === "https:") return true;
+    if (parsed.protocol === "http:") {
+      return parsed.hostname === "localhost" || parsed.hostname === "127.0.0.1";
+    }
+    return false;
+  } catch {
+    return false;
+  }
+}
+function normalizeOpenStageInput(input) {
+  const url = input.url.trim();
+  if (!isValidStageUrl(url)) return null;
+  const title = input.title?.trim();
+  return {
+    url,
+    ...title ? { title: title.slice(0, 200) } : {},
+    ...isStageToolId(input.tool) ? { tool: input.tool } : {}
+  };
+}
+
+// src/background.ts
+var isValidBackgroundUrl = (url) => url.length > 0 && url.length <= MAX_BACKGROUND_URL_LENGTH && isValidStageUrl(url);
+var clampBlurRadius = (value) => Number.isFinite(value) ? Math.min(MAX_BACKGROUND_BLUR_RADIUS, Math.max(MIN_BACKGROUND_BLUR_RADIUS, Math.round(value))) : DEFAULT_BACKGROUND_BLUR_RADIUS;
+function normalizeEmbedBackground(input) {
+  const locked = input.locked === true ? { locked: true } : {};
+  if (input.type === "none" /* NONE */) {
+    return { type: "none" /* NONE */, ...locked };
+  }
+  if (input.type === "blur" /* BLUR */) {
+    return {
+      type: "blur" /* BLUR */,
+      blurRadius: clampBlurRadius(input.blurRadius ?? DEFAULT_BACKGROUND_BLUR_RADIUS),
+      ...locked
+    };
+  }
+  if (input.type === "image" /* IMAGE */) {
+    const url = input.url?.trim();
+    if (!url || !isValidBackgroundUrl(url)) return null;
+    return {
+      type: "image" /* IMAGE */,
+      url,
+      ...locked
+    };
+  }
+  return null;
+}
+function serializeEmbedBackground(input) {
+  const normalized = normalizeEmbedBackground(input);
+  return normalized ? JSON.stringify(normalized) : void 0;
+}
+
 // src/buildEmbedUrl.ts
 var QUERY_FLAG_ENABLED = "1";
 var QUERY_FLAG_DISABLED = "0";
@@ -107,6 +176,7 @@ function buildEmbedUrl(options) {
   }
   const origin = normalizeOrigin(options.origin ?? DEFAULT_EMBED_ORIGIN);
   const url = new URL(`${origin}/embed/${encodeURIComponent(roomSlug)}`);
+  const backgroundParam = options.background ? serializeEmbedBackground(options.background) : void 0;
   const entries = [
     ["instanceId" /* INSTANCE_ID */, options.instanceId],
     ["hostOrigin" /* HOST_ORIGIN */, options.hostOrigin],
@@ -118,7 +188,8 @@ function buildEmbedUrl(options) {
     ["hideLeave" /* HIDE_LEAVE */, toFlag(options.hideLeave)],
     ["autoCameraOff" /* AUTO_CAMERA_OFF */, toFlag(options.autoCameraOff)],
     ["autoTranscribe" /* AUTO_TRANSCRIBE */, toFlag(options.autoTranscribe)],
-    ["autoRecord" /* AUTO_RECORD */, toFlag(options.autoRecord)]
+    ["autoRecord" /* AUTO_RECORD */, toFlag(options.autoRecord)],
+    ["background" /* BACKGROUND */, backgroundParam]
   ];
   for (const [key, value] of entries) {
     if (value !== void 0 && value !== "") {
@@ -137,31 +208,6 @@ import {
   useRef
 } from "react";
 
-// src/openStage.ts
-function isValidStageUrl(url) {
-  if (url.length === 0 || url.length > MAX_STAGE_URL_LENGTH) return false;
-  try {
-    const parsed = new URL(url);
-    if (parsed.protocol === "https:") return true;
-    if (parsed.protocol === "http:") {
-      return parsed.hostname === "localhost" || parsed.hostname === "127.0.0.1";
-    }
-    return false;
-  } catch {
-    return false;
-  }
-}
-function normalizeOpenStageInput(input) {
-  const url = input.url.trim();
-  if (!isValidStageUrl(url)) return null;
-  const title = input.title?.trim();
-  return {
-    url,
-    ...title ? { title: title.slice(0, 200) } : {},
-    ...isStageToolId(input.tool) ? { tool: input.tool } : {}
-  };
-}
-
 // src/parseEmbedEvent.ts
 var EVENT_TYPES = new Set(Object.values(EmbedEventType));
 function isRecord(value) {
@@ -230,6 +276,7 @@ function postCommand(options) {
 function useOeMeeting(options) {
   const iframeRef = useRef(null);
   const callbacksRef = useRef(options);
+  const pendingBackgroundRef = useRef(null);
   useEffect(() => {
     callbacksRef.current = options;
   }, [options]);
@@ -246,6 +293,15 @@ function useOeMeeting(options) {
       switch (embedEvent.type) {
         case "oemeeting:ready" /* READY */:
           callbacks.onReady?.(embedEvent);
+          if (pendingBackgroundRef.current) {
+            postCommand({
+              iframe: iframeRef.current,
+              instanceId: options.instanceId,
+              action: "setBackground" /* SET_BACKGROUND */,
+              targetOrigin: options.targetOrigin,
+              payload: pendingBackgroundRef.current
+            });
+          }
           break;
         case "oemeeting:joined" /* JOINED */:
           callbacks.onJoined?.(embedEvent);
@@ -313,6 +369,16 @@ function useOeMeeting(options) {
     () => send("closeStage" /* CLOSE_STAGE */),
     [send]
   );
+  useEffect(() => {
+    if (!options.background) {
+      pendingBackgroundRef.current = null;
+      return;
+    }
+    const normalized = normalizeEmbedBackground(options.background);
+    if (!normalized) return;
+    pendingBackgroundRef.current = normalized;
+    send("setBackground" /* SET_BACKGROUND */, normalized);
+  }, [options.background, send]);
   const getIframe = useCallback(() => iframeRef.current, []);
   const handle = useMemo(
     () => ({
@@ -353,6 +419,7 @@ var OeMeeting = forwardRef(
       autoCameraOff,
       autoTranscribe,
       autoRecord,
+      background,
       title = "OE Meeting room",
       width = "100%",
       height = 640,
@@ -383,6 +450,7 @@ var OeMeeting = forwardRef(
     const embedOrigin = useMemo2(() => getOrigin(origin), [origin]);
     const resolvedTargetOrigin = targetOrigin ?? embedOrigin;
     const hostOrigin = typeof window === "undefined" ? void 0 : window.location.origin;
+    const initialBackgroundRef = useRef2(background);
     const src = useMemo2(
       () => buildEmbedUrl({
         roomSlug,
@@ -396,6 +464,7 @@ var OeMeeting = forwardRef(
         autoCameraOff,
         autoTranscribe,
         autoRecord,
+        background: initialBackgroundRef.current,
         instanceId,
         hostOrigin
       }),
@@ -416,6 +485,7 @@ var OeMeeting = forwardRef(
       ]
     );
     const { iframeRef } = useOeMeeting({
+      background,
       instanceId,
       targetOrigin: resolvedTargetOrigin,
       handleRef: ref,
@@ -473,6 +543,7 @@ export {
   DEFAULT_IFRAME_ALLOW,
   EMBED_MESSAGE_SOURCE,
   EMBED_PROTOCOL_VERSION,
+  EmbedBackgroundType,
   EmbedCapability,
   EmbedCaptureOutcome,
   EmbedCommandAction,
@@ -481,14 +552,17 @@ export {
   EmbedEventType,
   EmbedQueryParam,
   EmbedRole,
+  MAX_BACKGROUND_URL_LENGTH,
   MAX_STAGE_TOOL_ID_LENGTH,
   MAX_STAGE_URL_LENGTH,
   OeMeeting,
   buildEmbedUrl,
   isStageToolId,
   isValidStageUrl,
+  normalizeEmbedBackground,
   normalizeOpenStageInput,
   parseEmbedEvent,
+  serializeEmbedBackground,
   useOeMeeting
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/OeMeeting.tsx","../src/embed-protocol.ts","../src/buildEmbedUrl.ts","../src/useOeMeeting.ts","../src/openStage.ts","../src/parseEmbedEvent.ts"],"sourcesContent":["'use client';\n\nimport {\n  forwardRef,\n  useId,\n  useMemo,\n  type CSSProperties,\n} from 'react';\nimport { buildEmbedUrl } from './buildEmbedUrl';\nimport { DEFAULT_EMBED_ORIGIN } from './embed-protocol';\nimport type { OeMeetingHandle, OeMeetingProps } from './types';\nimport { useOeMeeting } from './useOeMeeting';\n\nexport const DEFAULT_IFRAME_ALLOW =\n  'camera; microphone; fullscreen; autoplay; display-capture; clipboard-write; encrypted-media';\n\nfunction toCssSize(value: number | string | undefined): string | undefined {\n  if (value === undefined) return undefined;\n  return typeof value === 'number' ? `${value}px` : value;\n}\n\nfunction getOrigin(value: string): string {\n  return new URL(value).origin;\n}\n\nexport const OeMeeting = forwardRef<OeMeetingHandle, OeMeetingProps>(\n  function OeMeeting(props, ref) {\n    const {\n      roomSlug,\n      joinToken,\n      userName,\n      externalUserId,\n      origin = DEFAULT_EMBED_ORIGIN,\n      lang,\n      autoJoin = true,\n      hideLeave,\n      autoCameraOff,\n      autoTranscribe,\n      autoRecord,\n      title = 'OE Meeting room',\n      width = '100%',\n      height = 640,\n      className,\n      style,\n      iframeClassName,\n      iframeStyle,\n      allow = DEFAULT_IFRAME_ALLOW,\n      targetOrigin,\n      onReady,\n      onJoined,\n      onLeft,\n      onParticipantJoined,\n      onParticipantLeft,\n      onEnded,\n      onError,\n      onStageChanged,\n      onTranscriptStarted,\n      onRecordingStarted,\n      onRecordingSaved,\n      onEvent,\n    } = props;\n    const reactId = useId();\n    const instanceId = useMemo(\n      () => `oem-${reactId.replace(/:/g, '')}`,\n      [reactId],\n    );\n    const embedOrigin = useMemo(() => getOrigin(origin), [origin]);\n    const resolvedTargetOrigin = targetOrigin ?? embedOrigin;\n    const hostOrigin =\n      typeof window === 'undefined' ? undefined : window.location.origin;\n    const src = useMemo(\n      () =>\n        buildEmbedUrl({\n          roomSlug,\n          joinToken,\n          userName,\n          externalUserId,\n          origin,\n          lang,\n          autoJoin,\n          hideLeave,\n          autoCameraOff,\n          autoTranscribe,\n          autoRecord,\n          instanceId,\n          hostOrigin,\n        }),\n      [\n        autoJoin,\n        autoRecord,\n        autoTranscribe,\n        externalUserId,\n        hideLeave,\n        hostOrigin,\n        instanceId,\n        joinToken,\n        lang,\n        origin,\n        roomSlug,\n        autoCameraOff,\n        userName,\n      ],\n    );\n    const { iframeRef } = useOeMeeting({\n      instanceId,\n      targetOrigin: resolvedTargetOrigin,\n      handleRef: ref,\n      onReady,\n      onJoined,\n      onLeft,\n      onParticipantJoined,\n      onParticipantLeft,\n      onEnded,\n      onError,\n      onStageChanged,\n      onTranscriptStarted,\n      onRecordingStarted,\n      onRecordingSaved,\n      onEvent,\n    });\n    const wrapperStyle: CSSProperties = {\n      width: toCssSize(width),\n      height: toCssSize(height),\n      ...style,\n    };\n    const frameStyle: CSSProperties = {\n      width: '100%',\n      height: '100%',\n      border: 0,\n      display: 'block',\n      ...iframeStyle,\n    };\n\n    return (\n      <div\n        className={className}\n        style={wrapperStyle}\n        data-oe-meeting-instance={instanceId}\n      >\n        <iframe\n          ref={iframeRef}\n          className={iframeClassName}\n          style={frameStyle}\n          src={src}\n          title={title}\n          allow={allow}\n          allowFullScreen\n          referrerPolicy=\"strict-origin-when-cross-origin\"\n        />\n      </div>\n    );\n  },\n);\n\nOeMeeting.displayName = 'OeMeeting';\n","export const EMBED_PROTOCOL_VERSION = 1 as const;\nexport const EMBED_MESSAGE_SOURCE = 'oemeeting' as const;\nexport const DEFAULT_EMBED_ORIGIN = 'https://meet.ocean.edu.vn';\n\nexport enum EmbedEventType {\n  READY = 'oemeeting:ready',\n  JOINED = 'oemeeting:joined',\n  LEFT = 'oemeeting:left',\n  PARTICIPANT_JOINED = 'oemeeting:participant-joined',\n  PARTICIPANT_LEFT = 'oemeeting:participant-left',\n  ENDED = 'oemeeting:ended',\n  ERROR = 'oemeeting:error',\n  STAGE_CHANGED = 'oemeeting:stage-changed',\n  TRANSCRIPT_STARTED = 'oemeeting:transcript-started',\n  RECORDING_STARTED = 'oemeeting:recording-started',\n  RECORDING_SAVED = 'oemeeting:recording-saved',\n}\n\nexport enum EmbedCommandType {\n  COMMAND = 'oemeeting:command',\n}\n\nexport enum EmbedCommandAction {\n  LEAVE = 'leave',\n  TOGGLE_MIC = 'toggleMic',\n  TOGGLE_CAMERA = 'toggleCamera',\n  OPEN_STAGE = 'openStage',\n  CLOSE_STAGE = 'closeStage',\n}\n\nexport enum EmbedErrorCode {\n  TOKEN_INVALID = 'TOKEN_INVALID',\n  TOKEN_EXPIRED = 'TOKEN_EXPIRED',\n  ROOM_NOT_FOUND = 'ROOM_NOT_FOUND',\n  ROOM_ACCESS_DENIED = 'ROOM_ACCESS_DENIED',\n  CONNECTION_FAILED = 'CONNECTION_FAILED',\n  PROTOCOL_MISMATCH = 'PROTOCOL_MISMATCH',\n  STAGE_ORIGIN_DENIED = 'STAGE_ORIGIN_DENIED',\n  STAGE_URL_INVALID = 'STAGE_URL_INVALID',\n  TRANSCRIPT_START_FAILED = 'TRANSCRIPT_START_FAILED',\n  RECORDING_START_FAILED = 'RECORDING_START_FAILED',\n  UNKNOWN = 'UNKNOWN',\n}\n\n/** Open host-owned tool id. Meeting does not catalog values. */\nexport type StageToolId = string;\n\nexport const MAX_STAGE_URL_LENGTH = 2048;\nexport const MAX_STAGE_TOOL_ID_LENGTH = 32;\n\nconst STAGE_TOOL_ID_PATTERN = /^[a-z][a-z0-9._-]{0,31}$/;\n\nexport function isStageToolId(value: unknown): value is StageToolId {\n  return (\n    typeof value === 'string' &&\n    value.length > 0 &&\n    value.length <= MAX_STAGE_TOOL_ID_LENGTH &&\n    STAGE_TOOL_ID_PATTERN.test(value)\n  );\n}\n\nexport enum EmbedQueryParam {\n  INSTANCE_ID = 'instanceId',\n  HOST_ORIGIN = 'hostOrigin',\n  JOIN_TOKEN = 'joinToken',\n  USER_NAME = 'userName',\n  EXTERNAL_USER_ID = 'externalUserId',\n  LANG = 'lang',\n  AUTO_JOIN = 'autoJoin',\n  HIDE_LEAVE = 'hideLeave',\n  AUTO_CAMERA_OFF = 'autoCameraOff',\n  AUTO_TRANSCRIBE = 'autoTranscribe',\n  AUTO_RECORD = 'autoRecord',\n}\n\n/**\n * What happened to the auto-transcribe request the embed made.\n *\n * `ALREADY_RUNNING` is the normal outcome for every participant after the\n * first, because the transcript is a room-level asset rather than a\n * per-participant one. `DISABLED` means the OE Meeting deployment has\n * transcription turned off.\n */\nexport enum EmbedCaptureOutcome {\n  STARTED = 'started',\n  ALREADY_RUNNING = 'already_running',\n  DISABLED = 'disabled',\n  FAILED = 'failed',\n}\n\n/**\n * Role the host app assigns when minting a join token.\n * Keep values aligned with `EmbedRole` in the backend embed-permission enum.\n */\nexport enum EmbedRole {\n  OWNER = 'owner',\n  MEMBER = 'member',\n}\n\n/**\n * Capability the host app may grant per role. Meeting enforces this on the\n * join token, not on a React prop. `screenShare` is the only value today.\n */\nexport enum EmbedCapability {\n  SCREEN_SHARE = 'screenShare',\n}\n\nexport interface EmbedPermissionMap {\n  owner?: EmbedCapability[];\n  member?: EmbedCapability[];\n}\n","import {\n  DEFAULT_EMBED_ORIGIN,\n  EmbedQueryParam,\n} from './embed-protocol';\nimport type { BuildEmbedUrlOptions } from './types';\n\nconst QUERY_FLAG_ENABLED = '1';\nconst QUERY_FLAG_DISABLED = '0';\n\nfunction toFlag(value: boolean | undefined): string | undefined {\n  if (value === undefined) return undefined;\n  return value ? QUERY_FLAG_ENABLED : QUERY_FLAG_DISABLED;\n}\n\nfunction normalizeOrigin(origin: string): string {\n  return origin.replace(/\\/+$/, '');\n}\n\nexport function buildEmbedUrl(options: BuildEmbedUrlOptions): string {\n  const roomSlug = options.roomSlug.trim();\n  const joinToken = options.joinToken.trim();\n  if (!roomSlug) {\n    throw new Error('OE Meeting embed requires a non-empty roomSlug.');\n  }\n  if (!joinToken) {\n    throw new Error('OE Meeting embed requires a non-empty joinToken.');\n  }\n\n  const origin = normalizeOrigin(options.origin ?? DEFAULT_EMBED_ORIGIN);\n  const url = new URL(`${origin}/embed/${encodeURIComponent(roomSlug)}`);\n  const entries: Array<[EmbedQueryParam, string | undefined]> = [\n    [EmbedQueryParam.INSTANCE_ID, options.instanceId],\n    [EmbedQueryParam.HOST_ORIGIN, options.hostOrigin],\n    [EmbedQueryParam.JOIN_TOKEN, joinToken],\n    [EmbedQueryParam.USER_NAME, options.userName],\n    [EmbedQueryParam.EXTERNAL_USER_ID, options.externalUserId],\n    [EmbedQueryParam.LANG, options.lang],\n    [EmbedQueryParam.AUTO_JOIN, toFlag(options.autoJoin)],\n    [EmbedQueryParam.HIDE_LEAVE, toFlag(options.hideLeave)],\n    [EmbedQueryParam.AUTO_CAMERA_OFF, toFlag(options.autoCameraOff)],\n    [EmbedQueryParam.AUTO_TRANSCRIBE, toFlag(options.autoTranscribe)],\n    [EmbedQueryParam.AUTO_RECORD, toFlag(options.autoRecord)],\n  ];\n\n  for (const [key, value] of entries) {\n    if (value !== undefined && value !== '') {\n      url.searchParams.set(key, value);\n    }\n  }\n  return url.toString();\n}\n","import {\n  useCallback,\n  useEffect,\n  useImperativeHandle,\n  useMemo,\n  useRef,\n  type Ref,\n} from 'react';\nimport {\n  EMBED_MESSAGE_SOURCE,\n  EMBED_PROTOCOL_VERSION,\n  EmbedCommandAction,\n  EmbedCommandType,\n  EmbedEventType,\n} from './embed-protocol';\nimport { normalizeOpenStageInput } from './openStage';\nimport { parseEmbedEvent } from './parseEmbedEvent';\nimport type {\n  EmbedCommandMessage,\n  OeMeetingHandle,\n  OeMeetingProps,\n  OpenStageInput,\n} from './types';\n\ntype UseOeMeetingOptions = Pick<\n  OeMeetingProps,\n  | 'onReady'\n  | 'onJoined'\n  | 'onLeft'\n  | 'onParticipantJoined'\n  | 'onParticipantLeft'\n  | 'onEnded'\n  | 'onError'\n  | 'onStageChanged'\n  | 'onTranscriptStarted'\n  | 'onRecordingStarted'\n  | 'onRecordingSaved'\n  | 'onEvent'\n> & {\n  instanceId: string;\n  targetOrigin: string;\n  handleRef?: Ref<OeMeetingHandle>;\n};\n\ninterface PostCommandOptions {\n  iframe: HTMLIFrameElement | null;\n  instanceId: string;\n  action: EmbedCommandAction;\n  targetOrigin: string;\n  payload?: OpenStageInput;\n}\n\nfunction postCommand(options: PostCommandOptions): void {\n  const frameWindow = options.iframe?.contentWindow;\n  if (!frameWindow) return;\n  const message: EmbedCommandMessage = {\n    source: EMBED_MESSAGE_SOURCE,\n    version: EMBED_PROTOCOL_VERSION,\n    instanceId: options.instanceId,\n    type: EmbedCommandType.COMMAND,\n    action: options.action,\n    ...(options.payload ? { payload: options.payload } : {}),\n  };\n  frameWindow.postMessage(message, options.targetOrigin);\n}\n\nexport function useOeMeeting(options: UseOeMeetingOptions) {\n  const iframeRef = useRef<HTMLIFrameElement | null>(null);\n  const callbacksRef = useRef(options);\n\n  useEffect(() => {\n    callbacksRef.current = options;\n  }, [options]);\n\n  useEffect(() => {\n    const onMessage = (event: MessageEvent<unknown>) => {\n      const frameWindow = iframeRef.current?.contentWindow;\n      if (\n        !frameWindow ||\n        event.source !== frameWindow ||\n        event.origin !== options.targetOrigin\n      ) {\n        return;\n      }\n      const embedEvent = parseEmbedEvent(event.data);\n      if (!embedEvent || embedEvent.instanceId !== options.instanceId) return;\n\n      const callbacks = callbacksRef.current;\n      callbacks.onEvent?.(embedEvent);\n      switch (embedEvent.type) {\n        case EmbedEventType.READY:\n          callbacks.onReady?.(embedEvent);\n          break;\n        case EmbedEventType.JOINED:\n          callbacks.onJoined?.(embedEvent);\n          break;\n        case EmbedEventType.LEFT:\n          callbacks.onLeft?.(embedEvent);\n          break;\n        case EmbedEventType.PARTICIPANT_JOINED:\n          callbacks.onParticipantJoined?.(embedEvent);\n          break;\n        case EmbedEventType.PARTICIPANT_LEFT:\n          callbacks.onParticipantLeft?.(embedEvent);\n          break;\n        case EmbedEventType.ENDED:\n          callbacks.onEnded?.(embedEvent);\n          break;\n        case EmbedEventType.ERROR:\n          callbacks.onError?.(embedEvent);\n          break;\n        case EmbedEventType.STAGE_CHANGED:\n          callbacks.onStageChanged?.(embedEvent);\n          break;\n        case EmbedEventType.TRANSCRIPT_STARTED:\n          callbacks.onTranscriptStarted?.(embedEvent);\n          break;\n        case EmbedEventType.RECORDING_STARTED:\n          callbacks.onRecordingStarted?.(embedEvent);\n          break;\n        case EmbedEventType.RECORDING_SAVED:\n          callbacks.onRecordingSaved?.(embedEvent);\n          break;\n      }\n    };\n\n    window.addEventListener('message', onMessage);\n    return () => window.removeEventListener('message', onMessage);\n  }, [options.instanceId, options.targetOrigin]);\n\n  const send = useCallback(\n    (action: EmbedCommandAction, payload?: OpenStageInput) =>\n      postCommand({\n        iframe: iframeRef.current,\n        instanceId: options.instanceId,\n        action,\n        targetOrigin: options.targetOrigin,\n        payload,\n      }),\n    [options.instanceId, options.targetOrigin],\n  );\n  const leave = useCallback(() => send(EmbedCommandAction.LEAVE), [send]);\n  const toggleMic = useCallback(\n    () => send(EmbedCommandAction.TOGGLE_MIC),\n    [send],\n  );\n  const toggleCamera = useCallback(\n    () => send(EmbedCommandAction.TOGGLE_CAMERA),\n    [send],\n  );\n  const openStage = useCallback(\n    (input: OpenStageInput) => {\n      const normalized = normalizeOpenStageInput(input);\n      if (!normalized) return;\n      send(EmbedCommandAction.OPEN_STAGE, normalized);\n    },\n    [send],\n  );\n  const closeStage = useCallback(\n    () => send(EmbedCommandAction.CLOSE_STAGE),\n    [send],\n  );\n  const getIframe = useCallback(() => iframeRef.current, []);\n  const handle = useMemo<OeMeetingHandle>(\n    () => ({\n      leave,\n      toggleMic,\n      toggleCamera,\n      openStage,\n      closeStage,\n      getIframe,\n    }),\n    [closeStage, getIframe, leave, openStage, toggleCamera, toggleMic],\n  );\n\n  useImperativeHandle(options.handleRef, () => handle, [handle]);\n  return { iframeRef, handle };\n}\n","import { isStageToolId, MAX_STAGE_URL_LENGTH } from './embed-protocol';\nimport type { OpenStageInput } from './types';\n\nexport function isValidStageUrl(url: string): boolean {\n  if (url.length === 0 || url.length > MAX_STAGE_URL_LENGTH) return false;\n  try {\n    const parsed = new URL(url);\n    if (parsed.protocol === 'https:') return true;\n    if (parsed.protocol === 'http:') {\n      return (\n        parsed.hostname === 'localhost' || parsed.hostname === '127.0.0.1'\n      );\n    }\n    return false;\n  } catch {\n    return false;\n  }\n}\n\nexport function normalizeOpenStageInput(\n  input: OpenStageInput,\n): OpenStageInput | null {\n  const url = input.url.trim();\n  if (!isValidStageUrl(url)) return null;\n  const title = input.title?.trim();\n  return {\n    url,\n    ...(title ? { title: title.slice(0, 200) } : {}),\n    ...(isStageToolId(input.tool) ? { tool: input.tool } : {}),\n  };\n}\n","import {\n  EMBED_MESSAGE_SOURCE,\n  EMBED_PROTOCOL_VERSION,\n  EmbedCaptureOutcome,\n  EmbedEventType,\n} from './embed-protocol';\nimport type { EmbedEvent } from './types';\n\nconst EVENT_TYPES = new Set<string>(Object.values(EmbedEventType));\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n\nfunction isOptionalString(value: unknown): boolean {\n  return value === undefined || typeof value === 'string';\n}\n\nfunction isNullableString(value: unknown): boolean {\n  return value === null || typeof value === 'string';\n}\n\nconst CAPTURE_OUTCOMES = new Set<string>(Object.values(EmbedCaptureOutcome));\n\nfunction isCaptureOutcome(value: unknown): boolean {\n  return typeof value === 'string' && CAPTURE_OUTCOMES.has(value);\n}\n\nfunction hasValidPayload(\n  type: EmbedEventType,\n  payload: Record<string, unknown>,\n): boolean {\n  switch (type) {\n    case EmbedEventType.READY:\n      return typeof payload.roomSlug === 'string';\n    case EmbedEventType.JOINED:\n      return (\n        typeof payload.roomSlug === 'string' &&\n        typeof payload.identity === 'string' &&\n        isOptionalString(payload.name) &&\n        typeof payload.joinedAt === 'string'\n      );\n    case EmbedEventType.LEFT:\n      return (\n        typeof payload.roomSlug === 'string' &&\n        typeof payload.identity === 'string' &&\n        typeof payload.leftAt === 'string' &&\n        (payload.durationMs === undefined ||\n          typeof payload.durationMs === 'number')\n      );\n    case EmbedEventType.PARTICIPANT_JOINED:\n      return (\n        typeof payload.identity === 'string' &&\n        isOptionalString(payload.name) &&\n        typeof payload.participantCount === 'number'\n      );\n    case EmbedEventType.PARTICIPANT_LEFT:\n      return (\n        typeof payload.identity === 'string' &&\n        typeof payload.participantCount === 'number'\n      );\n    case EmbedEventType.ENDED:\n      return (\n        typeof payload.roomSlug === 'string' &&\n        typeof payload.endedAt === 'string'\n      );\n    case EmbedEventType.ERROR:\n      return (\n        typeof payload.code === 'string' &&\n        typeof payload.message === 'string'\n      );\n    case EmbedEventType.STAGE_CHANGED:\n      return (\n        (payload.url === null || typeof payload.url === 'string') &&\n        isOptionalString(payload.title) &&\n        isOptionalString(payload.tool) &&\n        isOptionalString(payload.openedBy)\n      );\n    case EmbedEventType.TRANSCRIPT_STARTED:\n      return (\n        typeof payload.roomSlug === 'string' &&\n        isCaptureOutcome(payload.outcome) &&\n        isNullableString(payload.transcriptId) &&\n        isNullableString(payload.status)\n      );\n    case EmbedEventType.RECORDING_STARTED:\n      return (\n        typeof payload.roomSlug === 'string' &&\n        isCaptureOutcome(payload.outcome) &&\n        isNullableString(payload.recordingId) &&\n        isNullableString(payload.status)\n      );\n    case EmbedEventType.RECORDING_SAVED:\n      return (\n        typeof payload.roomSlug === 'string' &&\n        typeof payload.savedAt === 'string'\n      );\n  }\n}\n\nexport function parseEmbedEvent(data: unknown): EmbedEvent | null {\n  if (!isRecord(data)) return null;\n  if (\n    data.source !== EMBED_MESSAGE_SOURCE ||\n    data.version !== EMBED_PROTOCOL_VERSION ||\n    typeof data.instanceId !== 'string' ||\n    data.instanceId.length === 0 ||\n    typeof data.type !== 'string' ||\n    !EVENT_TYPES.has(data.type) ||\n    !isRecord(data.payload)\n  ) {\n    return null;\n  }\n\n  const type = data.type as EmbedEventType;\n  if (!hasValidPayload(type, data.payload)) return null;\n  return data as unknown as EmbedEvent;\n}\n"],"mappings":"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","names":["useMemo","EmbedEventType","EmbedCommandType","EmbedCommandAction","EmbedErrorCode","EmbedQueryParam","EmbedCaptureOutcome","EmbedRole","EmbedCapability","OeMeeting","useMemo"]}
+{"version":3,"sources":["../src/OeMeeting.tsx","../src/embed-protocol.ts","../src/openStage.ts","../src/background.ts","../src/buildEmbedUrl.ts","../src/useOeMeeting.ts","../src/parseEmbedEvent.ts"],"sourcesContent":["'use client';\n\nimport {\n  forwardRef,\n  useId,\n  useMemo,\n  useRef,\n  type CSSProperties,\n} from 'react';\nimport { buildEmbedUrl } from './buildEmbedUrl';\nimport { DEFAULT_EMBED_ORIGIN } from './embed-protocol';\nimport type { OeMeetingHandle, OeMeetingProps } from './types';\nimport { useOeMeeting } from './useOeMeeting';\n\nexport const DEFAULT_IFRAME_ALLOW =\n  'camera; microphone; fullscreen; autoplay; display-capture; clipboard-write; encrypted-media';\n\nfunction toCssSize(value: number | string | undefined): string | undefined {\n  if (value === undefined) return undefined;\n  return typeof value === 'number' ? `${value}px` : value;\n}\n\nfunction getOrigin(value: string): string {\n  return new URL(value).origin;\n}\n\nexport const OeMeeting = forwardRef<OeMeetingHandle, OeMeetingProps>(\n  function OeMeeting(props, ref) {\n    const {\n      roomSlug,\n      joinToken,\n      userName,\n      externalUserId,\n      origin = DEFAULT_EMBED_ORIGIN,\n      lang,\n      autoJoin = true,\n      hideLeave,\n      autoCameraOff,\n      autoTranscribe,\n      autoRecord,\n      background,\n      title = 'OE Meeting room',\n      width = '100%',\n      height = 640,\n      className,\n      style,\n      iframeClassName,\n      iframeStyle,\n      allow = DEFAULT_IFRAME_ALLOW,\n      targetOrigin,\n      onReady,\n      onJoined,\n      onLeft,\n      onParticipantJoined,\n      onParticipantLeft,\n      onEnded,\n      onError,\n      onStageChanged,\n      onTranscriptStarted,\n      onRecordingStarted,\n      onRecordingSaved,\n      onEvent,\n    } = props;\n    const reactId = useId();\n    const instanceId = useMemo(\n      () => `oem-${reactId.replace(/:/g, '')}`,\n      [reactId],\n    );\n    const embedOrigin = useMemo(() => getOrigin(origin), [origin]);\n    const resolvedTargetOrigin = targetOrigin ?? embedOrigin;\n    const hostOrigin =\n      typeof window === 'undefined' ? undefined : window.location.origin;\n    // Only the mount-time background rides the embed URL. Later prop changes\n    // travel as `setBackground` commands (useOeMeeting); rebuilding src would\n    // reload the whole meeting mid-session.\n    const initialBackgroundRef = useRef(background);\n    const src = useMemo(\n      () =>\n        buildEmbedUrl({\n          roomSlug,\n          joinToken,\n          userName,\n          externalUserId,\n          origin,\n          lang,\n          autoJoin,\n          hideLeave,\n          autoCameraOff,\n          autoTranscribe,\n          autoRecord,\n          background: initialBackgroundRef.current,\n          instanceId,\n          hostOrigin,\n        }),\n      [\n        autoJoin,\n        autoRecord,\n        autoTranscribe,\n        externalUserId,\n        hideLeave,\n        hostOrigin,\n        instanceId,\n        joinToken,\n        lang,\n        origin,\n        roomSlug,\n        autoCameraOff,\n        userName,\n      ],\n    );\n    const { iframeRef } = useOeMeeting({\n      background,\n      instanceId,\n      targetOrigin: resolvedTargetOrigin,\n      handleRef: ref,\n      onReady,\n      onJoined,\n      onLeft,\n      onParticipantJoined,\n      onParticipantLeft,\n      onEnded,\n      onError,\n      onStageChanged,\n      onTranscriptStarted,\n      onRecordingStarted,\n      onRecordingSaved,\n      onEvent,\n    });\n    const wrapperStyle: CSSProperties = {\n      width: toCssSize(width),\n      height: toCssSize(height),\n      ...style,\n    };\n    const frameStyle: CSSProperties = {\n      width: '100%',\n      height: '100%',\n      border: 0,\n      display: 'block',\n      ...iframeStyle,\n    };\n\n    return (\n      <div\n        className={className}\n        style={wrapperStyle}\n        data-oe-meeting-instance={instanceId}\n      >\n        <iframe\n          ref={iframeRef}\n          className={iframeClassName}\n          style={frameStyle}\n          src={src}\n          title={title}\n          allow={allow}\n          allowFullScreen\n          referrerPolicy=\"strict-origin-when-cross-origin\"\n        />\n      </div>\n    );\n  },\n);\n\nOeMeeting.displayName = 'OeMeeting';\n","export const EMBED_PROTOCOL_VERSION = 1 as const;\nexport const EMBED_MESSAGE_SOURCE = 'oemeeting' as const;\nexport const DEFAULT_EMBED_ORIGIN = 'https://meet.ocean.edu.vn';\n\nexport enum EmbedEventType {\n  READY = 'oemeeting:ready',\n  JOINED = 'oemeeting:joined',\n  LEFT = 'oemeeting:left',\n  PARTICIPANT_JOINED = 'oemeeting:participant-joined',\n  PARTICIPANT_LEFT = 'oemeeting:participant-left',\n  ENDED = 'oemeeting:ended',\n  ERROR = 'oemeeting:error',\n  STAGE_CHANGED = 'oemeeting:stage-changed',\n  TRANSCRIPT_STARTED = 'oemeeting:transcript-started',\n  RECORDING_STARTED = 'oemeeting:recording-started',\n  RECORDING_SAVED = 'oemeeting:recording-saved',\n}\n\nexport enum EmbedCommandType {\n  COMMAND = 'oemeeting:command',\n}\n\nexport enum EmbedCommandAction {\n  LEAVE = 'leave',\n  TOGGLE_MIC = 'toggleMic',\n  TOGGLE_CAMERA = 'toggleCamera',\n  OPEN_STAGE = 'openStage',\n  CLOSE_STAGE = 'closeStage',\n  SET_BACKGROUND = 'setBackground',\n}\n\nexport enum EmbedErrorCode {\n  TOKEN_INVALID = 'TOKEN_INVALID',\n  TOKEN_EXPIRED = 'TOKEN_EXPIRED',\n  ROOM_NOT_FOUND = 'ROOM_NOT_FOUND',\n  ROOM_ACCESS_DENIED = 'ROOM_ACCESS_DENIED',\n  CONNECTION_FAILED = 'CONNECTION_FAILED',\n  PROTOCOL_MISMATCH = 'PROTOCOL_MISMATCH',\n  STAGE_ORIGIN_DENIED = 'STAGE_ORIGIN_DENIED',\n  STAGE_URL_INVALID = 'STAGE_URL_INVALID',\n  TRANSCRIPT_START_FAILED = 'TRANSCRIPT_START_FAILED',\n  RECORDING_START_FAILED = 'RECORDING_START_FAILED',\n  UNKNOWN = 'UNKNOWN',\n}\n\n/**\n * Host-controlled camera background applied to this embed's local user only.\n * `none` clears any active background effect. The host app enforces who may\n * set it; the meeting does not interpret roles for this value.\n */\nexport enum EmbedBackgroundType {\n  BLUR = 'blur',\n  IMAGE = 'image',\n  NONE = 'none',\n}\n\nexport const MAX_BACKGROUND_URL_LENGTH = 2048;\nexport const DEFAULT_BACKGROUND_BLUR_RADIUS = 10;\nexport const MIN_BACKGROUND_BLUR_RADIUS = 1;\nexport const MAX_BACKGROUND_BLUR_RADIUS = 50;\n\nexport interface EmbedBackground {\n  type: EmbedBackgroundType;\n  /** BLUR only. Defaults to `DEFAULT_BACKGROUND_BLUR_RADIUS`, clamped 1-50. */\n  blurRadius?: number;\n  /** IMAGE only. http(s) URL, max `MAX_BACKGROUND_URL_LENGTH`. */\n  url?: string;\n  /** When true the embed user cannot change blur/virtual backgrounds. */\n  locked?: boolean;\n}\n\n/** Open host-owned tool id. Meeting does not catalog values. */\nexport type StageToolId = string;\n\nexport const MAX_STAGE_URL_LENGTH = 2048;\nexport const MAX_STAGE_TOOL_ID_LENGTH = 32;\n\nconst STAGE_TOOL_ID_PATTERN = /^[a-z][a-z0-9._-]{0,31}$/;\n\nexport function isStageToolId(value: unknown): value is StageToolId {\n  return (\n    typeof value === 'string' &&\n    value.length > 0 &&\n    value.length <= MAX_STAGE_TOOL_ID_LENGTH &&\n    STAGE_TOOL_ID_PATTERN.test(value)\n  );\n}\n\nexport enum EmbedQueryParam {\n  INSTANCE_ID = 'instanceId',\n  HOST_ORIGIN = 'hostOrigin',\n  JOIN_TOKEN = 'joinToken',\n  USER_NAME = 'userName',\n  EXTERNAL_USER_ID = 'externalUserId',\n  LANG = 'lang',\n  AUTO_JOIN = 'autoJoin',\n  HIDE_LEAVE = 'hideLeave',\n  AUTO_CAMERA_OFF = 'autoCameraOff',\n  AUTO_TRANSCRIBE = 'autoTranscribe',\n  AUTO_RECORD = 'autoRecord',\n  BACKGROUND = 'background',\n}\n\n/**\n * What happened to the auto-transcribe request the embed made.\n *\n * `ALREADY_RUNNING` is the normal outcome for every participant after the\n * first, because the transcript is a room-level asset rather than a\n * per-participant one. `DISABLED` means the OE Meeting deployment has\n * transcription turned off.\n */\nexport enum EmbedCaptureOutcome {\n  STARTED = 'started',\n  ALREADY_RUNNING = 'already_running',\n  DISABLED = 'disabled',\n  FAILED = 'failed',\n}\n\n/**\n * Role the host app assigns when minting a join token.\n * Keep values aligned with `EmbedRole` in the backend embed-permission enum.\n */\nexport enum EmbedRole {\n  OWNER = 'owner',\n  MEMBER = 'member',\n}\n\n/**\n * Capability the host app may grant per role. Meeting enforces this on the\n * join token, not on a React prop. `screenShare` is the only value today.\n */\nexport enum EmbedCapability {\n  SCREEN_SHARE = 'screenShare',\n}\n\nexport interface EmbedPermissionMap {\n  owner?: EmbedCapability[];\n  member?: EmbedCapability[];\n}\n","import { isStageToolId, MAX_STAGE_URL_LENGTH } from './embed-protocol';\nimport type { OpenStageInput } from './types';\n\nexport function isValidStageUrl(url: string): boolean {\n  if (url.length === 0 || url.length > MAX_STAGE_URL_LENGTH) return false;\n  try {\n    const parsed = new URL(url);\n    if (parsed.protocol === 'https:') return true;\n    if (parsed.protocol === 'http:') {\n      return (\n        parsed.hostname === 'localhost' || parsed.hostname === '127.0.0.1'\n      );\n    }\n    return false;\n  } catch {\n    return false;\n  }\n}\n\nexport function normalizeOpenStageInput(\n  input: OpenStageInput,\n): OpenStageInput | null {\n  const url = input.url.trim();\n  if (!isValidStageUrl(url)) return null;\n  const title = input.title?.trim();\n  return {\n    url,\n    ...(title ? { title: title.slice(0, 200) } : {}),\n    ...(isStageToolId(input.tool) ? { tool: input.tool } : {}),\n  };\n}\n","import { isValidStageUrl } from './openStage';\nimport {\n  DEFAULT_BACKGROUND_BLUR_RADIUS,\n  EmbedBackgroundType,\n  MAX_BACKGROUND_BLUR_RADIUS,\n  MAX_BACKGROUND_URL_LENGTH,\n  MIN_BACKGROUND_BLUR_RADIUS,\n  type EmbedBackground,\n} from './embed-protocol';\n\n/** Same http(s) policy as the stage URL, including the localhost exception. */\nconst isValidBackgroundUrl = (url: string): boolean =>\n  url.length > 0 &&\n  url.length <= MAX_BACKGROUND_URL_LENGTH &&\n  isValidStageUrl(url);\n\nconst clampBlurRadius = (value: number): number =>\n  Number.isFinite(value)\n    ? Math.min(MAX_BACKGROUND_BLUR_RADIUS, Math.max(MIN_BACKGROUND_BLUR_RADIUS, Math.round(value)))\n    : DEFAULT_BACKGROUND_BLUR_RADIUS;\n\n/**\n * Validate and normalize a host-provided background. Returns null for invalid\n * input so callers can silently drop it, mirroring `normalizeOpenStageInput`.\n */\nexport function normalizeEmbedBackground(\n  input: EmbedBackground,\n): EmbedBackground | null {\n  const locked = input.locked === true ? { locked: true } : {};\n\n  if (input.type === EmbedBackgroundType.NONE) {\n    return { type: EmbedBackgroundType.NONE, ...locked };\n  }\n\n  if (input.type === EmbedBackgroundType.BLUR) {\n    return {\n      type: EmbedBackgroundType.BLUR,\n      blurRadius: clampBlurRadius(input.blurRadius ?? DEFAULT_BACKGROUND_BLUR_RADIUS),\n      ...locked,\n    };\n  }\n\n  if (input.type === EmbedBackgroundType.IMAGE) {\n    const url = input.url?.trim();\n    if (!url || !isValidBackgroundUrl(url)) return null;\n    return {\n      type: EmbedBackgroundType.IMAGE,\n      url,\n      ...locked,\n    };\n  }\n\n  return null;\n}\n\n/** JSON wire format shared by the `background` query param and the command payload. */\nexport function serializeEmbedBackground(\n  input: EmbedBackground,\n): string | undefined {\n  const normalized = normalizeEmbedBackground(input);\n  return normalized ? JSON.stringify(normalized) : undefined;\n}\n","import {\n  DEFAULT_EMBED_ORIGIN,\n  EmbedQueryParam,\n} from './embed-protocol';\nimport { serializeEmbedBackground } from './background';\nimport type { BuildEmbedUrlOptions } from './types';\n\nconst QUERY_FLAG_ENABLED = '1';\nconst QUERY_FLAG_DISABLED = '0';\n\nfunction toFlag(value: boolean | undefined): string | undefined {\n  if (value === undefined) return undefined;\n  return value ? QUERY_FLAG_ENABLED : QUERY_FLAG_DISABLED;\n}\n\nfunction normalizeOrigin(origin: string): string {\n  return origin.replace(/\\/+$/, '');\n}\n\nexport function buildEmbedUrl(options: BuildEmbedUrlOptions): string {\n  const roomSlug = options.roomSlug.trim();\n  const joinToken = options.joinToken.trim();\n  if (!roomSlug) {\n    throw new Error('OE Meeting embed requires a non-empty roomSlug.');\n  }\n  if (!joinToken) {\n    throw new Error('OE Meeting embed requires a non-empty joinToken.');\n  }\n\n  const origin = normalizeOrigin(options.origin ?? DEFAULT_EMBED_ORIGIN);\n  const url = new URL(`${origin}/embed/${encodeURIComponent(roomSlug)}`);\n  const backgroundParam = options.background\n    ? serializeEmbedBackground(options.background)\n    : undefined;\n\n  const entries: Array<[EmbedQueryParam, string | undefined]> = [\n    [EmbedQueryParam.INSTANCE_ID, options.instanceId],\n    [EmbedQueryParam.HOST_ORIGIN, options.hostOrigin],\n    [EmbedQueryParam.JOIN_TOKEN, joinToken],\n    [EmbedQueryParam.USER_NAME, options.userName],\n    [EmbedQueryParam.EXTERNAL_USER_ID, options.externalUserId],\n    [EmbedQueryParam.LANG, options.lang],\n    [EmbedQueryParam.AUTO_JOIN, toFlag(options.autoJoin)],\n    [EmbedQueryParam.HIDE_LEAVE, toFlag(options.hideLeave)],\n    [EmbedQueryParam.AUTO_CAMERA_OFF, toFlag(options.autoCameraOff)],\n    [EmbedQueryParam.AUTO_TRANSCRIBE, toFlag(options.autoTranscribe)],\n    [EmbedQueryParam.AUTO_RECORD, toFlag(options.autoRecord)],\n    [EmbedQueryParam.BACKGROUND, backgroundParam],\n  ];\n\n  for (const [key, value] of entries) {\n    if (value !== undefined && value !== '') {\n      url.searchParams.set(key, value);\n    }\n  }\n  return url.toString();\n}\n","import {\n  useCallback,\n  useEffect,\n  useImperativeHandle,\n  useMemo,\n  useRef,\n  type Ref,\n} from 'react';\nimport {\n  EMBED_MESSAGE_SOURCE,\n  EMBED_PROTOCOL_VERSION,\n  EmbedCommandAction,\n  EmbedCommandType,\n  EmbedEventType,\n} from './embed-protocol';\nimport { normalizeEmbedBackground } from './background';\nimport { normalizeOpenStageInput } from './openStage';\nimport { parseEmbedEvent } from './parseEmbedEvent';\nimport type {\n  EmbedCommandMessage,\n  OeMeetingHandle,\n  OeMeetingProps,\n  OpenStageInput,\n} from './types';\nimport type { EmbedBackground } from './embed-protocol';\n\ntype UseOeMeetingOptions = Pick<\n  OeMeetingProps,\n  | 'onReady'\n  | 'onJoined'\n  | 'onLeft'\n  | 'onParticipantJoined'\n  | 'onParticipantLeft'\n  | 'onEnded'\n  | 'onError'\n  | 'onStageChanged'\n  | 'onTranscriptStarted'\n  | 'onRecordingStarted'\n  | 'onRecordingSaved'\n  | 'onEvent'\n  | 'background'\n> & {\n  instanceId: string;\n  targetOrigin: string;\n  handleRef?: Ref<OeMeetingHandle>;\n};\n\ninterface PostCommandOptions {\n  iframe: HTMLIFrameElement | null;\n  instanceId: string;\n  action: EmbedCommandAction;\n  targetOrigin: string;\n  payload?: OpenStageInput | EmbedBackground;\n}\n\nfunction postCommand(options: PostCommandOptions): void {\n  const frameWindow = options.iframe?.contentWindow;\n  if (!frameWindow) return;\n  const message: EmbedCommandMessage = {\n    source: EMBED_MESSAGE_SOURCE,\n    version: EMBED_PROTOCOL_VERSION,\n    instanceId: options.instanceId,\n    type: EmbedCommandType.COMMAND,\n    action: options.action,\n    ...(options.payload ? { payload: options.payload } : {}),\n  };\n  frameWindow.postMessage(message, options.targetOrigin);\n}\n\nexport function useOeMeeting(options: UseOeMeetingOptions) {\n  const iframeRef = useRef<HTMLIFrameElement | null>(null);\n  const callbacksRef = useRef(options);\n  // Last background the host set. Resent on READY: commands posted before the\n  // iframe bridge mounts are dropped by the browser.\n  const pendingBackgroundRef = useRef<EmbedBackground | null>(null);\n\n  useEffect(() => {\n    callbacksRef.current = options;\n  }, [options]);\n\n  useEffect(() => {\n    const onMessage = (event: MessageEvent<unknown>) => {\n      const frameWindow = iframeRef.current?.contentWindow;\n      if (\n        !frameWindow ||\n        event.source !== frameWindow ||\n        event.origin !== options.targetOrigin\n      ) {\n        return;\n      }\n      const embedEvent = parseEmbedEvent(event.data);\n      if (!embedEvent || embedEvent.instanceId !== options.instanceId) return;\n\n      const callbacks = callbacksRef.current;\n      callbacks.onEvent?.(embedEvent);\n      switch (embedEvent.type) {\n        case EmbedEventType.READY:\n          callbacks.onReady?.(embedEvent);\n          if (pendingBackgroundRef.current) {\n            postCommand({\n              iframe: iframeRef.current,\n              instanceId: options.instanceId,\n              action: EmbedCommandAction.SET_BACKGROUND,\n              targetOrigin: options.targetOrigin,\n              payload: pendingBackgroundRef.current,\n            });\n          }\n          break;\n        case EmbedEventType.JOINED:\n          callbacks.onJoined?.(embedEvent);\n          break;\n        case EmbedEventType.LEFT:\n          callbacks.onLeft?.(embedEvent);\n          break;\n        case EmbedEventType.PARTICIPANT_JOINED:\n          callbacks.onParticipantJoined?.(embedEvent);\n          break;\n        case EmbedEventType.PARTICIPANT_LEFT:\n          callbacks.onParticipantLeft?.(embedEvent);\n          break;\n        case EmbedEventType.ENDED:\n          callbacks.onEnded?.(embedEvent);\n          break;\n        case EmbedEventType.ERROR:\n          callbacks.onError?.(embedEvent);\n          break;\n        case EmbedEventType.STAGE_CHANGED:\n          callbacks.onStageChanged?.(embedEvent);\n          break;\n        case EmbedEventType.TRANSCRIPT_STARTED:\n          callbacks.onTranscriptStarted?.(embedEvent);\n          break;\n        case EmbedEventType.RECORDING_STARTED:\n          callbacks.onRecordingStarted?.(embedEvent);\n          break;\n        case EmbedEventType.RECORDING_SAVED:\n          callbacks.onRecordingSaved?.(embedEvent);\n          break;\n      }\n    };\n\n    window.addEventListener('message', onMessage);\n    return () => window.removeEventListener('message', onMessage);\n  }, [options.instanceId, options.targetOrigin]);\n\n  const send = useCallback(\n    (\n      action: EmbedCommandAction,\n      payload?: OpenStageInput | EmbedBackground\n    ) =>\n      postCommand({\n        iframe: iframeRef.current,\n        instanceId: options.instanceId,\n        action,\n        targetOrigin: options.targetOrigin,\n        payload,\n      }),\n    [options.instanceId, options.targetOrigin],\n  );\n  const leave = useCallback(() => send(EmbedCommandAction.LEAVE), [send]);\n  const toggleMic = useCallback(\n    () => send(EmbedCommandAction.TOGGLE_MIC),\n    [send],\n  );\n  const toggleCamera = useCallback(\n    () => send(EmbedCommandAction.TOGGLE_CAMERA),\n    [send],\n  );\n  const openStage = useCallback(\n    (input: OpenStageInput) => {\n      const normalized = normalizeOpenStageInput(input);\n      if (!normalized) return;\n      send(EmbedCommandAction.OPEN_STAGE, normalized);\n    },\n    [send],\n  );\n  const closeStage = useCallback(\n    () => send(EmbedCommandAction.CLOSE_STAGE),\n    [send],\n  );\n\n  useEffect(() => {\n    if (!options.background) {\n      pendingBackgroundRef.current = null;\n      return;\n    }\n    const normalized = normalizeEmbedBackground(options.background);\n    if (!normalized) return;\n    pendingBackgroundRef.current = normalized;\n    send(EmbedCommandAction.SET_BACKGROUND, normalized);\n  }, [options.background, send]);\n  const getIframe = useCallback(() => iframeRef.current, []);\n  const handle = useMemo<OeMeetingHandle>(\n    () => ({\n      leave,\n      toggleMic,\n      toggleCamera,\n      openStage,\n      closeStage,\n      getIframe,\n    }),\n    [closeStage, getIframe, leave, openStage, toggleCamera, toggleMic],\n  );\n\n  useImperativeHandle(options.handleRef, () => handle, [handle]);\n  return { iframeRef, handle };\n}\n","import {\n  EMBED_MESSAGE_SOURCE,\n  EMBED_PROTOCOL_VERSION,\n  EmbedCaptureOutcome,\n  EmbedEventType,\n} from './embed-protocol';\nimport type { EmbedEvent } from './types';\n\nconst EVENT_TYPES = new Set<string>(Object.values(EmbedEventType));\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n\nfunction isOptionalString(value: unknown): boolean {\n  return value === undefined || typeof value === 'string';\n}\n\nfunction isNullableString(value: unknown): boolean {\n  return value === null || typeof value === 'string';\n}\n\nconst CAPTURE_OUTCOMES = new Set<string>(Object.values(EmbedCaptureOutcome));\n\nfunction isCaptureOutcome(value: unknown): boolean {\n  return typeof value === 'string' && CAPTURE_OUTCOMES.has(value);\n}\n\nfunction hasValidPayload(\n  type: EmbedEventType,\n  payload: Record<string, unknown>,\n): boolean {\n  switch (type) {\n    case EmbedEventType.READY:\n      return typeof payload.roomSlug === 'string';\n    case EmbedEventType.JOINED:\n      return (\n        typeof payload.roomSlug === 'string' &&\n        typeof payload.identity === 'string' &&\n        isOptionalString(payload.name) &&\n        typeof payload.joinedAt === 'string'\n      );\n    case EmbedEventType.LEFT:\n      return (\n        typeof payload.roomSlug === 'string' &&\n        typeof payload.identity === 'string' &&\n        typeof payload.leftAt === 'string' &&\n        (payload.durationMs === undefined ||\n          typeof payload.durationMs === 'number')\n      );\n    case EmbedEventType.PARTICIPANT_JOINED:\n      return (\n        typeof payload.identity === 'string' &&\n        isOptionalString(payload.name) &&\n        typeof payload.participantCount === 'number'\n      );\n    case EmbedEventType.PARTICIPANT_LEFT:\n      return (\n        typeof payload.identity === 'string' &&\n        typeof payload.participantCount === 'number'\n      );\n    case EmbedEventType.ENDED:\n      return (\n        typeof payload.roomSlug === 'string' &&\n        typeof payload.endedAt === 'string'\n      );\n    case EmbedEventType.ERROR:\n      return (\n        typeof payload.code === 'string' &&\n        typeof payload.message === 'string'\n      );\n    case EmbedEventType.STAGE_CHANGED:\n      return (\n        (payload.url === null || typeof payload.url === 'string') &&\n        isOptionalString(payload.title) &&\n        isOptionalString(payload.tool) &&\n        isOptionalString(payload.openedBy)\n      );\n    case EmbedEventType.TRANSCRIPT_STARTED:\n      return (\n        typeof payload.roomSlug === 'string' &&\n        isCaptureOutcome(payload.outcome) &&\n        isNullableString(payload.transcriptId) &&\n        isNullableString(payload.status)\n      );\n    case EmbedEventType.RECORDING_STARTED:\n      return (\n        typeof payload.roomSlug === 'string' &&\n        isCaptureOutcome(payload.outcome) &&\n        isNullableString(payload.recordingId) &&\n        isNullableString(payload.status)\n      );\n    case EmbedEventType.RECORDING_SAVED:\n      return (\n        typeof payload.roomSlug === 'string' &&\n        typeof payload.savedAt === 'string'\n      );\n  }\n}\n\nexport function parseEmbedEvent(data: unknown): EmbedEvent | null {\n  if (!isRecord(data)) return null;\n  if (\n    data.source !== EMBED_MESSAGE_SOURCE ||\n    data.version !== EMBED_PROTOCOL_VERSION ||\n    typeof data.instanceId !== 'string' ||\n    data.instanceId.length === 0 ||\n    typeof data.type !== 'string' ||\n    !EVENT_TYPES.has(data.type) ||\n    !isRecord(data.payload)\n  ) {\n    return null;\n  }\n\n  const type = data.type as EmbedEventType;\n  if (!hasValidPayload(type, data.payload)) return null;\n  return data as unknown as EmbedEvent;\n}\n"],"mappings":";AAEA;AAAA,EACE;AAAA,EACA;AAAA,EACA,WAAAA;AAAA,EACA,UAAAC;AAAA,OAEK;;;ACRA,IAAM,yBAAyB;AAC/B,IAAM,uBAAuB;AAC7B,IAAM,uBAAuB;AAE7B,IAAK,iBAAL,kBAAKC,oBAAL;AACL,EAAAA,gBAAA,WAAQ;AACR,EAAAA,gBAAA,YAAS;AACT,EAAAA,gBAAA,UAAO;AACP,EAAAA,gBAAA,wBAAqB;AACrB,EAAAA,gBAAA,sBAAmB;AACnB,EAAAA,gBAAA,WAAQ;AACR,EAAAA,gBAAA,WAAQ;AACR,EAAAA,gBAAA,mBAAgB;AAChB,EAAAA,gBAAA,wBAAqB;AACrB,EAAAA,gBAAA,uBAAoB;AACpB,EAAAA,gBAAA,qBAAkB;AAXR,SAAAA;AAAA,GAAA;AAcL,IAAK,mBAAL,kBAAKC,sBAAL;AACL,EAAAA,kBAAA,aAAU;AADA,SAAAA;AAAA,GAAA;AAIL,IAAK,qBAAL,kBAAKC,wBAAL;AACL,EAAAA,oBAAA,WAAQ;AACR,EAAAA,oBAAA,gBAAa;AACb,EAAAA,oBAAA,mBAAgB;AAChB,EAAAA,oBAAA,gBAAa;AACb,EAAAA,oBAAA,iBAAc;AACd,EAAAA,oBAAA,oBAAiB;AANP,SAAAA;AAAA,GAAA;AASL,IAAK,iBAAL,kBAAKC,oBAAL;AACL,EAAAA,gBAAA,mBAAgB;AAChB,EAAAA,gBAAA,mBAAgB;AAChB,EAAAA,gBAAA,oBAAiB;AACjB,EAAAA,gBAAA,wBAAqB;AACrB,EAAAA,gBAAA,uBAAoB;AACpB,EAAAA,gBAAA,uBAAoB;AACpB,EAAAA,gBAAA,yBAAsB;AACtB,EAAAA,gBAAA,uBAAoB;AACpB,EAAAA,gBAAA,6BAA0B;AAC1B,EAAAA,gBAAA,4BAAyB;AACzB,EAAAA,gBAAA,aAAU;AAXA,SAAAA;AAAA,GAAA;AAmBL,IAAK,sBAAL,kBAAKC,yBAAL;AACL,EAAAA,qBAAA,UAAO;AACP,EAAAA,qBAAA,WAAQ;AACR,EAAAA,qBAAA,UAAO;AAHG,SAAAA;AAAA,GAAA;AAML,IAAM,4BAA4B;AAClC,IAAM,iCAAiC;AACvC,IAAM,6BAA6B;AACnC,IAAM,6BAA6B;AAenC,IAAM,uBAAuB;AAC7B,IAAM,2BAA2B;AAExC,IAAM,wBAAwB;AAEvB,SAAS,cAAc,OAAsC;AAClE,SACE,OAAO,UAAU,YACjB,MAAM,SAAS,KACf,MAAM,UAAU,4BAChB,sBAAsB,KAAK,KAAK;AAEpC;AAEO,IAAK,kBAAL,kBAAKC,qBAAL;AACL,EAAAA,iBAAA,iBAAc;AACd,EAAAA,iBAAA,iBAAc;AACd,EAAAA,iBAAA,gBAAa;AACb,EAAAA,iBAAA,eAAY;AACZ,EAAAA,iBAAA,sBAAmB;AACnB,EAAAA,iBAAA,UAAO;AACP,EAAAA,iBAAA,eAAY;AACZ,EAAAA,iBAAA,gBAAa;AACb,EAAAA,iBAAA,qBAAkB;AAClB,EAAAA,iBAAA,qBAAkB;AAClB,EAAAA,iBAAA,iBAAc;AACd,EAAAA,iBAAA,gBAAa;AAZH,SAAAA;AAAA,GAAA;AAuBL,IAAK,sBAAL,kBAAKC,yBAAL;AACL,EAAAA,qBAAA,aAAU;AACV,EAAAA,qBAAA,qBAAkB;AAClB,EAAAA,qBAAA,cAAW;AACX,EAAAA,qBAAA,YAAS;AAJC,SAAAA;AAAA,GAAA;AAWL,IAAK,YAAL,kBAAKC,eAAL;AACL,EAAAA,WAAA,WAAQ;AACR,EAAAA,WAAA,YAAS;AAFC,SAAAA;AAAA,GAAA;AASL,IAAK,kBAAL,kBAAKC,qBAAL;AACL,EAAAA,iBAAA,kBAAe;AADL,SAAAA;AAAA,GAAA;;;AChIL,SAAS,gBAAgB,KAAsB;AACpD,MAAI,IAAI,WAAW,KAAK,IAAI,SAAS,qBAAsB,QAAO;AAClE,MAAI;AACF,UAAM,SAAS,IAAI,IAAI,GAAG;AAC1B,QAAI,OAAO,aAAa,SAAU,QAAO;AACzC,QAAI,OAAO,aAAa,SAAS;AAC/B,aACE,OAAO,aAAa,eAAe,OAAO,aAAa;AAAA,IAE3D;AACA,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEO,SAAS,wBACd,OACuB;AACvB,QAAM,MAAM,MAAM,IAAI,KAAK;AAC3B,MAAI,CAAC,gBAAgB,GAAG,EAAG,QAAO;AAClC,QAAM,QAAQ,MAAM,OAAO,KAAK;AAChC,SAAO;AAAA,IACL;AAAA,IACA,GAAI,QAAQ,EAAE,OAAO,MAAM,MAAM,GAAG,GAAG,EAAE,IAAI,CAAC;AAAA,IAC9C,GAAI,cAAc,MAAM,IAAI,IAAI,EAAE,MAAM,MAAM,KAAK,IAAI,CAAC;AAAA,EAC1D;AACF;;;ACnBA,IAAM,uBAAuB,CAAC,QAC5B,IAAI,SAAS,KACb,IAAI,UAAU,6BACd,gBAAgB,GAAG;AAErB,IAAM,kBAAkB,CAAC,UACvB,OAAO,SAAS,KAAK,IACjB,KAAK,IAAI,4BAA4B,KAAK,IAAI,4BAA4B,KAAK,MAAM,KAAK,CAAC,CAAC,IAC5F;AAMC,SAAS,yBACd,OACwB;AACxB,QAAM,SAAS,MAAM,WAAW,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAC;AAE3D,MAAI,MAAM,4BAAmC;AAC3C,WAAO,EAAE,yBAAgC,GAAG,OAAO;AAAA,EACrD;AAEA,MAAI,MAAM,4BAAmC;AAC3C,WAAO;AAAA,MACL;AAAA,MACA,YAAY,gBAAgB,MAAM,cAAc,8BAA8B;AAAA,MAC9E,GAAG;AAAA,IACL;AAAA,EACF;AAEA,MAAI,MAAM,8BAAoC;AAC5C,UAAM,MAAM,MAAM,KAAK,KAAK;AAC5B,QAAI,CAAC,OAAO,CAAC,qBAAqB,GAAG,EAAG,QAAO;AAC/C,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA,GAAG;AAAA,IACL;AAAA,EACF;AAEA,SAAO;AACT;AAGO,SAAS,yBACd,OACoB;AACpB,QAAM,aAAa,yBAAyB,KAAK;AACjD,SAAO,aAAa,KAAK,UAAU,UAAU,IAAI;AACnD;;;ACtDA,IAAM,qBAAqB;AAC3B,IAAM,sBAAsB;AAE5B,SAAS,OAAO,OAAgD;AAC9D,MAAI,UAAU,OAAW,QAAO;AAChC,SAAO,QAAQ,qBAAqB;AACtC;AAEA,SAAS,gBAAgB,QAAwB;AAC/C,SAAO,OAAO,QAAQ,QAAQ,EAAE;AAClC;AAEO,SAAS,cAAc,SAAuC;AACnE,QAAM,WAAW,QAAQ,SAAS,KAAK;AACvC,QAAM,YAAY,QAAQ,UAAU,KAAK;AACzC,MAAI,CAAC,UAAU;AACb,UAAM,IAAI,MAAM,iDAAiD;AAAA,EACnE;AACA,MAAI,CAAC,WAAW;AACd,UAAM,IAAI,MAAM,kDAAkD;AAAA,EACpE;AAEA,QAAM,SAAS,gBAAgB,QAAQ,UAAU,oBAAoB;AACrE,QAAM,MAAM,IAAI,IAAI,GAAG,MAAM,UAAU,mBAAmB,QAAQ,CAAC,EAAE;AACrE,QAAM,kBAAkB,QAAQ,aAC5B,yBAAyB,QAAQ,UAAU,IAC3C;AAEJ,QAAM,UAAwD;AAAA,IAC5D,iCAA8B,QAAQ,UAAU;AAAA,IAChD,iCAA8B,QAAQ,UAAU;AAAA,IAChD,+BAA6B,SAAS;AAAA,IACtC,6BAA4B,QAAQ,QAAQ;AAAA,IAC5C,0CAAmC,QAAQ,cAAc;AAAA,IACzD,oBAAuB,QAAQ,IAAI;AAAA,IACnC,6BAA4B,OAAO,QAAQ,QAAQ,CAAC;AAAA,IACpD,+BAA6B,OAAO,QAAQ,SAAS,CAAC;AAAA,IACtD,wCAAkC,OAAO,QAAQ,aAAa,CAAC;AAAA,IAC/D,yCAAkC,OAAO,QAAQ,cAAc,CAAC;AAAA,IAChE,iCAA8B,OAAO,QAAQ,UAAU,CAAC;AAAA,IACxD,gCAA6B,eAAe;AAAA,EAC9C;AAEA,aAAW,CAAC,KAAK,KAAK,KAAK,SAAS;AAClC,QAAI,UAAU,UAAa,UAAU,IAAI;AACvC,UAAI,aAAa,IAAI,KAAK,KAAK;AAAA,IACjC;AAAA,EACF;AACA,SAAO,IAAI,SAAS;AACtB;;;ACxDA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;;;ACCP,IAAM,cAAc,IAAI,IAAY,OAAO,OAAO,cAAc,CAAC;AAEjE,SAAS,SAAS,OAAkD;AAClE,SAAO,OAAO,UAAU,YAAY,UAAU;AAChD;AAEA,SAAS,iBAAiB,OAAyB;AACjD,SAAO,UAAU,UAAa,OAAO,UAAU;AACjD;AAEA,SAAS,iBAAiB,OAAyB;AACjD,SAAO,UAAU,QAAQ,OAAO,UAAU;AAC5C;AAEA,IAAM,mBAAmB,IAAI,IAAY,OAAO,OAAO,mBAAmB,CAAC;AAE3E,SAAS,iBAAiB,OAAyB;AACjD,SAAO,OAAO,UAAU,YAAY,iBAAiB,IAAI,KAAK;AAChE;AAEA,SAAS,gBACP,MACA,SACS;AACT,UAAQ,MAAM;AAAA,IACZ;AACE,aAAO,OAAO,QAAQ,aAAa;AAAA,IACrC;AACE,aACE,OAAO,QAAQ,aAAa,YAC5B,OAAO,QAAQ,aAAa,YAC5B,iBAAiB,QAAQ,IAAI,KAC7B,OAAO,QAAQ,aAAa;AAAA,IAEhC;AACE,aACE,OAAO,QAAQ,aAAa,YAC5B,OAAO,QAAQ,aAAa,YAC5B,OAAO,QAAQ,WAAW,aACzB,QAAQ,eAAe,UACtB,OAAO,QAAQ,eAAe;AAAA,IAEpC;AACE,aACE,OAAO,QAAQ,aAAa,YAC5B,iBAAiB,QAAQ,IAAI,KAC7B,OAAO,QAAQ,qBAAqB;AAAA,IAExC;AACE,aACE,OAAO,QAAQ,aAAa,YAC5B,OAAO,QAAQ,qBAAqB;AAAA,IAExC;AACE,aACE,OAAO,QAAQ,aAAa,YAC5B,OAAO,QAAQ,YAAY;AAAA,IAE/B;AACE,aACE,OAAO,QAAQ,SAAS,YACxB,OAAO,QAAQ,YAAY;AAAA,IAE/B;AACE,cACG,QAAQ,QAAQ,QAAQ,OAAO,QAAQ,QAAQ,aAChD,iBAAiB,QAAQ,KAAK,KAC9B,iBAAiB,QAAQ,IAAI,KAC7B,iBAAiB,QAAQ,QAAQ;AAAA,IAErC;AACE,aACE,OAAO,QAAQ,aAAa,YAC5B,iBAAiB,QAAQ,OAAO,KAChC,iBAAiB,QAAQ,YAAY,KACrC,iBAAiB,QAAQ,MAAM;AAAA,IAEnC;AACE,aACE,OAAO,QAAQ,aAAa,YAC5B,iBAAiB,QAAQ,OAAO,KAChC,iBAAiB,QAAQ,WAAW,KACpC,iBAAiB,QAAQ,MAAM;AAAA,IAEnC;AACE,aACE,OAAO,QAAQ,aAAa,YAC5B,OAAO,QAAQ,YAAY;AAAA,EAEjC;AACF;AAEO,SAAS,gBAAgB,MAAkC;AAChE,MAAI,CAAC,SAAS,IAAI,EAAG,QAAO;AAC5B,MACE,KAAK,WAAW,wBAChB,KAAK,YAAY,0BACjB,OAAO,KAAK,eAAe,YAC3B,KAAK,WAAW,WAAW,KAC3B,OAAO,KAAK,SAAS,YACrB,CAAC,YAAY,IAAI,KAAK,IAAI,KAC1B,CAAC,SAAS,KAAK,OAAO,GACtB;AACA,WAAO;AAAA,EACT;AAEA,QAAM,OAAO,KAAK;AAClB,MAAI,CAAC,gBAAgB,MAAM,KAAK,OAAO,EAAG,QAAO;AACjD,SAAO;AACT;;;AD9DA,SAAS,YAAY,SAAmC;AACtD,QAAM,cAAc,QAAQ,QAAQ;AACpC,MAAI,CAAC,YAAa;AAClB,QAAM,UAA+B;AAAA,IACnC,QAAQ;AAAA,IACR,SAAS;AAAA,IACT,YAAY,QAAQ;AAAA,IACpB;AAAA,IACA,QAAQ,QAAQ;AAAA,IAChB,GAAI,QAAQ,UAAU,EAAE,SAAS,QAAQ,QAAQ,IAAI,CAAC;AAAA,EACxD;AACA,cAAY,YAAY,SAAS,QAAQ,YAAY;AACvD;AAEO,SAAS,aAAa,SAA8B;AACzD,QAAM,YAAY,OAAiC,IAAI;AACvD,QAAM,eAAe,OAAO,OAAO;AAGnC,QAAM,uBAAuB,OAA+B,IAAI;AAEhE,YAAU,MAAM;AACd,iBAAa,UAAU;AAAA,EACzB,GAAG,CAAC,OAAO,CAAC;AAEZ,YAAU,MAAM;AACd,UAAM,YAAY,CAAC,UAAiC;AAClD,YAAM,cAAc,UAAU,SAAS;AACvC,UACE,CAAC,eACD,MAAM,WAAW,eACjB,MAAM,WAAW,QAAQ,cACzB;AACA;AAAA,MACF;AACA,YAAM,aAAa,gBAAgB,MAAM,IAAI;AAC7C,UAAI,CAAC,cAAc,WAAW,eAAe,QAAQ,WAAY;AAEjE,YAAM,YAAY,aAAa;AAC/B,gBAAU,UAAU,UAAU;AAC9B,cAAQ,WAAW,MAAM;AAAA,QACvB;AACE,oBAAU,UAAU,UAAU;AAC9B,cAAI,qBAAqB,SAAS;AAChC,wBAAY;AAAA,cACV,QAAQ,UAAU;AAAA,cAClB,YAAY,QAAQ;AAAA,cACpB;AAAA,cACA,cAAc,QAAQ;AAAA,cACtB,SAAS,qBAAqB;AAAA,YAChC,CAAC;AAAA,UACH;AACA;AAAA,QACF;AACE,oBAAU,WAAW,UAAU;AAC/B;AAAA,QACF;AACE,oBAAU,SAAS,UAAU;AAC7B;AAAA,QACF;AACE,oBAAU,sBAAsB,UAAU;AAC1C;AAAA,QACF;AACE,oBAAU,oBAAoB,UAAU;AACxC;AAAA,QACF;AACE,oBAAU,UAAU,UAAU;AAC9B;AAAA,QACF;AACE,oBAAU,UAAU,UAAU;AAC9B;AAAA,QACF;AACE,oBAAU,iBAAiB,UAAU;AACrC;AAAA,QACF;AACE,oBAAU,sBAAsB,UAAU;AAC1C;AAAA,QACF;AACE,oBAAU,qBAAqB,UAAU;AACzC;AAAA,QACF;AACE,oBAAU,mBAAmB,UAAU;AACvC;AAAA,MACJ;AAAA,IACF;AAEA,WAAO,iBAAiB,WAAW,SAAS;AAC5C,WAAO,MAAM,OAAO,oBAAoB,WAAW,SAAS;AAAA,EAC9D,GAAG,CAAC,QAAQ,YAAY,QAAQ,YAAY,CAAC;AAE7C,QAAM,OAAO;AAAA,IACX,CACE,QACA,YAEA,YAAY;AAAA,MACV,QAAQ,UAAU;AAAA,MAClB,YAAY,QAAQ;AAAA,MACpB;AAAA,MACA,cAAc,QAAQ;AAAA,MACtB;AAAA,IACF,CAAC;AAAA,IACH,CAAC,QAAQ,YAAY,QAAQ,YAAY;AAAA,EAC3C;AACA,QAAM,QAAQ,YAAY,MAAM,wBAA6B,GAAG,CAAC,IAAI,CAAC;AACtE,QAAM,YAAY;AAAA,IAChB,MAAM,iCAAkC;AAAA,IACxC,CAAC,IAAI;AAAA,EACP;AACA,QAAM,eAAe;AAAA,IACnB,MAAM,uCAAqC;AAAA,IAC3C,CAAC,IAAI;AAAA,EACP;AACA,QAAM,YAAY;AAAA,IAChB,CAAC,UAA0B;AACzB,YAAM,aAAa,wBAAwB,KAAK;AAChD,UAAI,CAAC,WAAY;AACjB,yCAAoC,UAAU;AAAA,IAChD;AAAA,IACA,CAAC,IAAI;AAAA,EACP;AACA,QAAM,aAAa;AAAA,IACjB,MAAM,mCAAmC;AAAA,IACzC,CAAC,IAAI;AAAA,EACP;AAEA,YAAU,MAAM;AACd,QAAI,CAAC,QAAQ,YAAY;AACvB,2BAAqB,UAAU;AAC/B;AAAA,IACF;AACA,UAAM,aAAa,yBAAyB,QAAQ,UAAU;AAC9D,QAAI,CAAC,WAAY;AACjB,yBAAqB,UAAU;AAC/B,+CAAwC,UAAU;AAAA,EACpD,GAAG,CAAC,QAAQ,YAAY,IAAI,CAAC;AAC7B,QAAM,YAAY,YAAY,MAAM,UAAU,SAAS,CAAC,CAAC;AACzD,QAAM,SAAS;AAAA,IACb,OAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA,CAAC,YAAY,WAAW,OAAO,WAAW,cAAc,SAAS;AAAA,EACnE;AAEA,sBAAoB,QAAQ,WAAW,MAAM,QAAQ,CAAC,MAAM,CAAC;AAC7D,SAAO,EAAE,WAAW,OAAO;AAC7B;;;AL3DQ;AArID,IAAM,uBACX;AAEF,SAAS,UAAU,OAAwD;AACzE,MAAI,UAAU,OAAW,QAAO;AAChC,SAAO,OAAO,UAAU,WAAW,GAAG,KAAK,OAAO;AACpD;AAEA,SAAS,UAAU,OAAuB;AACxC,SAAO,IAAI,IAAI,KAAK,EAAE;AACxB;AAEO,IAAM,YAAY;AAAA,EACvB,SAASC,WAAU,OAAO,KAAK;AAC7B,UAAM;AAAA,MACJ;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,SAAS;AAAA,MACT;AAAA,MACA,WAAW;AAAA,MACX;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,QAAQ;AAAA,MACR,QAAQ;AAAA,MACR,SAAS;AAAA,MACT;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,QAAQ;AAAA,MACR;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,IAAI;AACJ,UAAM,UAAU,MAAM;AACtB,UAAM,aAAaC;AAAA,MACjB,MAAM,OAAO,QAAQ,QAAQ,MAAM,EAAE,CAAC;AAAA,MACtC,CAAC,OAAO;AAAA,IACV;AACA,UAAM,cAAcA,SAAQ,MAAM,UAAU,MAAM,GAAG,CAAC,MAAM,CAAC;AAC7D,UAAM,uBAAuB,gBAAgB;AAC7C,UAAM,aACJ,OAAO,WAAW,cAAc,SAAY,OAAO,SAAS;AAI9D,UAAM,uBAAuBC,QAAO,UAAU;AAC9C,UAAM,MAAMD;AAAA,MACV,MACE,cAAc;AAAA,QACZ;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,YAAY,qBAAqB;AAAA,QACjC;AAAA,QACA;AAAA,MACF,CAAC;AAAA,MACH;AAAA,QACE;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF;AACA,UAAM,EAAE,UAAU,IAAI,aAAa;AAAA,MACjC;AAAA,MACA;AAAA,MACA,cAAc;AAAA,MACd,WAAW;AAAA,MACX;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AACD,UAAM,eAA8B;AAAA,MAClC,OAAO,UAAU,KAAK;AAAA,MACtB,QAAQ,UAAU,MAAM;AAAA,MACxB,GAAG;AAAA,IACL;AACA,UAAM,aAA4B;AAAA,MAChC,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,QAAQ;AAAA,MACR,SAAS;AAAA,MACT,GAAG;AAAA,IACL;AAEA,WACE;AAAA,MAAC;AAAA;AAAA,QACC;AAAA,QACA,OAAO;AAAA,QACP,4BAA0B;AAAA,QAE1B;AAAA,UAAC;AAAA;AAAA,YACC,KAAK;AAAA,YACL,WAAW;AAAA,YACX,OAAO;AAAA,YACP;AAAA,YACA;AAAA,YACA;AAAA,YACA,iBAAe;AAAA,YACf,gBAAe;AAAA;AAAA,QACjB;AAAA;AAAA,IACF;AAAA,EAEJ;AACF;AAEA,UAAU,cAAc;","names":["useMemo","useRef","EmbedEventType","EmbedCommandType","EmbedCommandAction","EmbedErrorCode","EmbedBackgroundType","EmbedQueryParam","EmbedCaptureOutcome","EmbedRole","EmbedCapability","OeMeeting","useMemo","useRef"]}

package/docs/BACKEND-INTEGRATION.md

@@ -53,7 +53,9 @@ Request:
   "name": "Lesson 98765 - 2026-08-17",
   "slug": "oe-school-lesson-98765",
   "access_level": "restricted",
-  "configuration": {}
+  "configuration": {
+    "speakerDiarization": true
+  }
 }
 ```
 
@@ -62,8 +64,7 @@ Request:
 | `name` | Có | Tên hiển thị, tối đa 500 ký tự. |
 | `slug` | Không | Khóa ổn định của phòng, tối đa 100 ký tự. Nếu bỏ trống, server sinh từ `name`. |
 | `access_level` | Không | Nên luôn dùng `restricted`; external API mặc định là `restricted`. |
-| `configuration` | Không | Cấu hình mở rộng của phòng. |
-
+| `configuration` | Không | Cấu hình mở rộng. `speakerDiarization: true` bảo agent tách người nói. Mặc định tắt. Gửi trên lần tạo phòng, hoặc lần tạo lại cùng slug. |
 Response mẫu:
 
 ```json
@@ -211,7 +212,7 @@ Response mẫu:
 | Field | Mô tả |
 |---|---|
 | `status` | `active` khi buổi học đang diễn ra, `paused` khi tạm dừng, `completed` sau khi phòng kết thúc. |
-| `segments` | Các câu nói đã chốt, sắp xếp tăng dần theo `spokenAt`. |
+| `segments` | Các câu nói đã chốt, sắp xếp tăng dần theo `spokenAt`. Client chưa bật `speakerDiarization` nhận đúng shape cũ, không có `speakerId`. |
 | `startedBy` | `null` với phiên do embed tự bật (người tham gia là khách của OE.School, không có tài khoản OE Meeting). |
 
 Trả `404` khi phòng chưa từng có transcript nào. Transcript là tài sản cấp
@@ -219,6 +220,38 @@ phòng: nếu OE.School dùng lại một room cho nhiều buổi, endpoint tr
 nhất và các segment của phiên đó. Dùng một room cho mỗi buổi học (theo quy ước
 slug ở 2.1) để tránh nhập nhằng.
 
+Với phòng đã tạo với `speakerDiarization: true`, mỗi segment có thêm field
+`speakerId` — nhãn giọng nói Soniox gán trong phạm vi một audio track (mic
+chung, tab share). Hai giọng trên một mic sẽ ra `"1"`, `"2"` xen kẽ:
+
+```json
+"segments": [
+  {
+    "id": "0b0f9d54-1a2b-4c3d-8e9f-0a1b2c3d4e5f",
+    "participantIdentity": "oe-school:user:12345",
+    "participantName": "Nguyen Van A",
+    "speakerId": "1",
+    "text": "Chào cả lớp, hôm nay chúng ta học bài 3.",
+    "language": "vi",
+    "spokenAt": "2026-08-17T02:00:45.000Z"
+  },
+  {
+    "id": "1c2d3e4f-...",
+    "participantIdentity": "oe-school:user:12345",
+    "participantName": "Nguyen Van A",
+    "speakerId": "2",
+    "text": "Khoan, cho em hỏi bài 3 ạ.",
+    "language": "vi",
+    "spokenAt": "2026-08-17T02:00:52.000Z"
+  }
+]
+```
+
+`speakerId` là nhãn giọng, không phải tên người: mọi segment vẫn mang
+`participantName` của chủ track. Muốn tên thật cho từng giọng phải tự map
+ngoài hệ thống. Nhãn chỉ phân biệt trong phạm vi một track, không phải toàn
+phòng, và không có trên live caption trong lúc họp.
+
 Gọi endpoint này sau event `ENDED` (`onEnded` trên React SDK). Agent transcriber
 chốt phiên (`status: "completed"`) khi phòng LiveKit đóng, nên gọi quá sớm sẽ
 nhận được transcript còn `active` và thiếu các câu cuối. Poll tới khi
@@ -271,6 +304,7 @@ interface TranscriptSegment {
   id: string;
   participantIdentity: string | null;
   participantName: string;
+  speakerId?: string;
   text: string;
   language: string | null;
   spokenAt: string;

package/docs/REACT-INTEGRATION.md

@@ -130,6 +130,7 @@ này ở production. Khi chạy local, truyền URL frontend OE Meeting local, v
 | `autoCameraOff` | `boolean` | `false` | Vào phòng với camera tắt: màn prejoin khởi tạo camera đang tắt và phòng không phát video lúc kết nối. Người dùng vẫn có thể bật lại thủ công. |
 | `autoTranscribe` | `boolean` | `false` | Tự bật transcript dùng chung khi embed kết nối. |
 | `autoRecord` | `boolean` | `false` | Tự ghi toàn bộ phòng khi embed kết nối. |
+| `background` | `EmbedBackground` | — | Áp background camera (blur / ảnh / none) cho user của iframe này, kèm tuỳ chọn khóa lựa chọn nền của người dùng. Dùng để branding sự kiện: host app truyền cùng một giá trị cho mọi người tham gia. Giá trị ban đầu đi theo embed URL; đổi prop sau mount được gửi vào iframe dưới dạng command `setBackground` (buffer đến khi embed ready). Input không hợp lệ bị bỏ qua. |
 | `userName` | `string` | — | Thông tin tùy chọn truyền vào embed URL. |
 | `externalUserId` | `string` | — | External identity tùy chọn. |
 | `lang` | `string` | — | Ngôn ngữ giao diện. |
@@ -157,6 +158,45 @@ này ở production. Khi chạy local, truyền URL frontend OE Meeting local, v
 Không đặt `targetOrigin="*"`. SDK và iframe đều kiểm tra origin, source và
 `instanceId` trước khi xử lý message.
 
+### 3.0.1. Background chung cho sự kiện (`background`)
+
+```tsx
+import { EmbedBackgroundType } from '@tinyweb_dev/oe-meeting-react'
+
+// Ảnh branding cho mọi người tham gia, người dùng không đổi được
+<OeMeeting
+  roomSlug="event-room"
+  joinToken={token}
+  background={{
+    type: EmbedBackgroundType.IMAGE,
+    url: 'https://cdn.example.com/event-brand.jpg',
+    locked: true,
+  }}
+/>
+
+// Blur nhẹ, người dùng vẫn tự đổi được
+background={{ type: EmbedBackgroundType.BLUR, blurRadius: 5 }}
+
+// Bỏ background đang áp (mở khóa nếu đang khóa)
+background={{ type: EmbedBackgroundType.NONE }}
+```
+
+Quy tắc:
+
+- `type: 'blur'` | `'image'` | `'none'`. `blurRadius` mặc định 10, clamp 1–50;
+  `url` phải là http(s) (http chỉ cho localhost) và ≤ 2048 ký tự.
+- **Ảnh cross-origin tự đi qua proxy của meeting backend** (`GET /api/v1.0/embed/background-image`): host app truyền URL ảnh công khai bất kỳ, **không cần CORS/ACAO** trên host ảnh. Proxy bảo vệ cho production: join token, DNS pin chặn rebinding, redirect validate lại từng hop (tối đa 3), chặn IP private/loopback/link-local (IPv4+IPv6), chỉ `image/*` ≤ 10MB, rate limit theo identity (mặc định 30/phút), cache 10 phút (budget 32MB). Ops: `EMBED_BACKGROUND_PROXY_ENABLED` (kill switch), `EMBED_BACKGROUND_PROXY_ALLOWED_HOSTS` (allowlist hostname, tùy chọn), `EMBED_BACKGROUND_PROXY_RATE_LIMIT`. URL same-origin với meeting tải trực tiếp. URL không tải được bị bỏ qua an toàn (nền không áp, khóa mở, camera vẫn chạy).
+- `locked: true` vô hiệu hóa chọn blur/nền trong panel Effects của người dùng
+  (cả prejoin lẫn trong phòng); `false`/không truyền thì chỉ là mặc định ban đầu.
+- Meeting không kiểm tra role: chỉ tác động lên iframe của chính người đó,
+  nên host app tự enforce "ai được set" (vd chỉ dashboard của owner).
+- Đồng bộ tới mọi người tham gia là việc host app: hãy render cùng một giá trị
+  `background` trên mọi phiên embed và đẩy update qua kênh realtime của bạn
+  khi owner đổi giữa buổi. Người vào phòng trực tiếp (không qua embed) không
+  nhận được background này.
+- Command `setBackground` gửi trong lúc prejoin (`autoJoin={false}`, chưa bấm
+  Join) bị mất — giá trị ban đầu qua URL vẫn đúng.
+
 ## 3.1. Phân quyền theo role
 
 `<OeMeeting>` không có prop quyền. Quyền nằm trong `joinToken`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tinyweb_dev/oe-meeting-react",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "React SDK to embed OE Meeting rooms via iframe and postMessage",
   "publishConfig": {
     "access": "public"