@tinyweb_dev/oe-meeting-react 0.1.0 → 0.2.0

package/INTEGRATION.md

@@ -10,7 +10,7 @@ SSO bằng join token và trao đổi typed events/commands với iframe.
 - [Tích hợp React SDK](docs/REACT-INTEGRATION.md): component `OeMeeting`, props,
   events, commands, xử lý lỗi và local development.
 - [README package](README.md): ví dụ sử dụng nhanh và public API.
-- [Release npm](docs/RELEASE.md): cấu hình `NPM_TOKEN`, dry-run và quy trình
+- [Release npm](docs/RELEASE.md): Trusted Publishing (OIDC), dry-run và quy trình
   phát hành bằng tag.
 
 ## Kiến trúc
@@ -32,7 +32,7 @@ OE Meeting external API
   │ Trả roomSlug + joinToken cho browser
   ▼
 <OeMeeting roomSlug={roomSlug} joinToken={joinToken} />
-  └─ iframe https://meet.oceanedu.org/embed/:roomSlug
+  └─ iframe https://meet.ocean.edu.vn/embed/:roomSlug
 ```
 
 ## Access control hai lớp
@@ -58,9 +58,9 @@ OE.School hoặc secret manager.
 ## Production endpoint
 
 ```text
-Meeting origin: https://meet.oceanedu.org
-External API:   https://meet.oceanedu.org/external-api/v1.0
-Embed route:    https://meet.oceanedu.org/embed/:roomSlug
+Meeting origin: https://meet.ocean.edu.vn
+External API:   https://meet.ocean.edu.vn/external-api/v1.0
+Embed route:    https://meet.ocean.edu.vn/embed/:roomSlug
 ```
 
 ## Checklist nhanh

package/README.md

@@ -7,7 +7,7 @@ React SDK để nhúng phòng OE Meeting vào OE.School hoặc hệ thống LMS
 - [Tổng quan và checklist](INTEGRATION.md)
 - [Backend OE.School: external API, roster và join token](docs/BACKEND-INTEGRATION.md)
 - [Frontend OE.School: React component, events và commands](docs/REACT-INTEGRATION.md)
-- [Quy trình release npm và cấu hình `NPM_TOKEN`](docs/RELEASE.md)
+- [Quy trình release npm (OIDC Trusted Publishing)](docs/RELEASE.md)
 
 ## Ví dụ nhanh
 
@@ -52,5 +52,7 @@ export function OnlineLesson({
 
 ## Imperative API
 
-`OeMeetingHandle` cung cấp `leave()`, `toggleMic()`, `toggleCamera()` và
-`getIframe()`.
+`OeMeetingHandle` cung cấp `leave()`, `toggleMic()`, `toggleCamera()`,
+`openStage()`, `closeStage()` và `getIframe()`. Host giữ nội dung tool
+(trang PDF, nét vẽ); Meeting chỉ sync URL Stage. Host stamp
+`attributes.stage` (`open` \| `follow`) nếu cần hạn chế origin OPEN/CLOSE.

package/dist/index.cjs

@@ -29,8 +29,13 @@ __export(index_exports, {
   EmbedErrorCode: () => EmbedErrorCode,
   EmbedEventType: () => EmbedEventType,
   EmbedQueryParam: () => EmbedQueryParam,
+  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,
+  normalizeOpenStageInput: () => normalizeOpenStageInput,
   parseEmbedEvent: () => parseEmbedEvent,
   useOeMeeting: () => useOeMeeting
 });
@@ -42,7 +47,7 @@ var import_react2 = require("react");
 // src/embed-protocol.ts
 var EMBED_PROTOCOL_VERSION = 1;
 var EMBED_MESSAGE_SOURCE = "oemeeting";
-var DEFAULT_EMBED_ORIGIN = "https://meet.oceanedu.org";
+var DEFAULT_EMBED_ORIGIN = "https://meet.ocean.edu.vn";
 var EmbedEventType = /* @__PURE__ */ ((EmbedEventType2) => {
   EmbedEventType2["READY"] = "oemeeting:ready";
   EmbedEventType2["JOINED"] = "oemeeting:joined";
@@ -51,6 +56,7 @@ var EmbedEventType = /* @__PURE__ */ ((EmbedEventType2) => {
   EmbedEventType2["PARTICIPANT_LEFT"] = "oemeeting:participant-left";
   EmbedEventType2["ENDED"] = "oemeeting:ended";
   EmbedEventType2["ERROR"] = "oemeeting:error";
+  EmbedEventType2["STAGE_CHANGED"] = "oemeeting:stage-changed";
   return EmbedEventType2;
 })(EmbedEventType || {});
 var EmbedCommandType = /* @__PURE__ */ ((EmbedCommandType2) => {
@@ -61,6 +67,8 @@ var EmbedCommandAction = /* @__PURE__ */ ((EmbedCommandAction2) => {
   EmbedCommandAction2["LEAVE"] = "leave";
   EmbedCommandAction2["TOGGLE_MIC"] = "toggleMic";
   EmbedCommandAction2["TOGGLE_CAMERA"] = "toggleCamera";
+  EmbedCommandAction2["OPEN_STAGE"] = "openStage";
+  EmbedCommandAction2["CLOSE_STAGE"] = "closeStage";
   return EmbedCommandAction2;
 })(EmbedCommandAction || {});
 var EmbedErrorCode = /* @__PURE__ */ ((EmbedErrorCode2) => {
@@ -70,9 +78,17 @@ var EmbedErrorCode = /* @__PURE__ */ ((EmbedErrorCode2) => {
   EmbedErrorCode2["ROOM_ACCESS_DENIED"] = "ROOM_ACCESS_DENIED";
   EmbedErrorCode2["CONNECTION_FAILED"] = "CONNECTION_FAILED";
   EmbedErrorCode2["PROTOCOL_MISMATCH"] = "PROTOCOL_MISMATCH";
+  EmbedErrorCode2["STAGE_ORIGIN_DENIED"] = "STAGE_ORIGIN_DENIED";
+  EmbedErrorCode2["STAGE_URL_INVALID"] = "STAGE_URL_INVALID";
   EmbedErrorCode2["UNKNOWN"] = "UNKNOWN";
   return EmbedErrorCode2;
 })(EmbedErrorCode || {});
+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}$/;
+function isStageToolId(value) {
+  return typeof value === "string" && value.length > 0 && value.length <= MAX_STAGE_TOOL_ID_LENGTH && STAGE_TOOL_ID_PATTERN.test(value);
+}
 var EmbedQueryParam = /* @__PURE__ */ ((EmbedQueryParam2) => {
   EmbedQueryParam2["INSTANCE_ID"] = "instanceId";
   EmbedQueryParam2["HOST_ORIGIN"] = "hostOrigin";
@@ -127,6 +143,31 @@ 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) {
@@ -151,6 +192,8 @@ function hasValidPayload(type, payload) {
       return typeof payload.roomSlug === "string" && typeof payload.endedAt === "string";
     case "oemeeting:error" /* ERROR */:
       return typeof payload.code === "string" && typeof payload.message === "string";
+    case "oemeeting:stage-changed" /* STAGE_CHANGED */:
+      return (payload.url === null || typeof payload.url === "string") && isOptionalString(payload.title) && isOptionalString(payload.tool) && isOptionalString(payload.openedBy);
   }
 }
 function parseEmbedEvent(data) {
@@ -172,7 +215,8 @@ function postCommand(options) {
     version: EMBED_PROTOCOL_VERSION,
     instanceId: options.instanceId,
     type: "oemeeting:command" /* COMMAND */,
-    action: options.action
+    action: options.action,
+    ...options.payload ? { payload: options.payload } : {}
   };
   frameWindow.postMessage(message, options.targetOrigin);
 }
@@ -214,17 +258,21 @@ function useOeMeeting(options) {
         case "oemeeting:error" /* ERROR */:
           callbacks.onError?.(embedEvent);
           break;
+        case "oemeeting:stage-changed" /* STAGE_CHANGED */:
+          callbacks.onStageChanged?.(embedEvent);
+          break;
       }
     };
     window.addEventListener("message", onMessage);
     return () => window.removeEventListener("message", onMessage);
   }, [options.instanceId, options.targetOrigin]);
   const send = (0, import_react.useCallback)(
-    (action) => postCommand({
+    (action, payload) => postCommand({
       iframe: iframeRef.current,
       instanceId: options.instanceId,
       action,
-      targetOrigin: options.targetOrigin
+      targetOrigin: options.targetOrigin,
+      payload
     }),
     [options.instanceId, options.targetOrigin]
   );
@@ -237,10 +285,29 @@ function useOeMeeting(options) {
     () => send("toggleCamera" /* TOGGLE_CAMERA */),
     [send]
   );
+  const openStage = (0, import_react.useCallback)(
+    (input) => {
+      const normalized = normalizeOpenStageInput(input);
+      if (!normalized) return;
+      send("openStage" /* OPEN_STAGE */, normalized);
+    },
+    [send]
+  );
+  const closeStage = (0, import_react.useCallback)(
+    () => send("closeStage" /* CLOSE_STAGE */),
+    [send]
+  );
   const getIframe = (0, import_react.useCallback)(() => iframeRef.current, []);
   const handle = (0, import_react.useMemo)(
-    () => ({ leave, toggleMic, toggleCamera, getIframe }),
-    [getIframe, leave, toggleCamera, toggleMic]
+    () => ({
+      leave,
+      toggleMic,
+      toggleCamera,
+      openStage,
+      closeStage,
+      getIframe
+    }),
+    [closeStage, getIframe, leave, openStage, toggleCamera, toggleMic]
   );
   (0, import_react.useImperativeHandle)(options.handleRef, () => handle, [handle]);
   return { iframeRef, handle };
@@ -283,6 +350,7 @@ var OeMeeting = (0, import_react2.forwardRef)(
       onParticipantLeft,
       onEnded,
       onError,
+      onStageChanged,
       onEvent
     } = props;
     const reactId = (0, import_react2.useId)();
@@ -330,6 +398,7 @@ var OeMeeting = (0, import_react2.forwardRef)(
       onParticipantLeft,
       onEnded,
       onError,
+      onStageChanged,
       onEvent
     });
     const wrapperStyle = {
@@ -379,8 +448,13 @@ OeMeeting.displayName = "OeMeeting";
   EmbedErrorCode,
   EmbedEventType,
   EmbedQueryParam,
+  MAX_STAGE_TOOL_ID_LENGTH,
+  MAX_STAGE_URL_LENGTH,
   OeMeeting,
   buildEmbedUrl,
+  isStageToolId,
+  isValidStageUrl,
+  normalizeOpenStageInput,
   parseEmbedEvent,
   useOeMeeting
 });

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/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  EmbedCommandAction,\n  EmbedCommandType,\n  EmbedErrorCode,\n  EmbedEventType,\n  EmbedQueryParam,\n} from './embed-protocol';\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  OeMeetingHandle,\n  OeMeetingProps,\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      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      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          instanceId,\n          hostOrigin,\n        }),\n      [\n        autoJoin,\n        externalUserId,\n        hideLeave,\n        hostOrigin,\n        instanceId,\n        joinToken,\n        lang,\n        origin,\n        roomSlug,\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      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.oceanedu.org';\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}\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}\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  UNKNOWN = 'UNKNOWN',\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}\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  ];\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 { parseEmbedEvent } from './parseEmbedEvent';\nimport type {\n  EmbedCommandMessage,\n  OeMeetingHandle,\n  OeMeetingProps,\n} from './types';\n\ntype UseOeMeetingOptions = Pick<\n  OeMeetingProps,\n  | 'onReady'\n  | 'onJoined'\n  | 'onLeft'\n  | 'onParticipantJoined'\n  | 'onParticipantLeft'\n  | 'onEnded'\n  | 'onError'\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}\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  };\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      }\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) =>\n      postCommand({\n        iframe: iframeRef.current,\n        instanceId: options.instanceId,\n        action,\n        targetOrigin: options.targetOrigin,\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 getIframe = useCallback(() => iframeRef.current, []);\n  const handle = useMemo<OeMeetingHandle>(\n    () => ({ leave, toggleMic, toggleCamera, getIframe }),\n    [getIframe, leave, 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  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 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  }\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","OeMeeting"]}
+{"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  EmbedCommandAction,\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 { 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  EmbedStageChangedPayload,\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      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      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          instanceId,\n          hostOrigin,\n        }),\n      [\n        autoJoin,\n        externalUserId,\n        hideLeave,\n        hostOrigin,\n        instanceId,\n        joinToken,\n        lang,\n        origin,\n        roomSlug,\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      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}\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  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}\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  ];\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  | '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      }\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  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 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  }\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","OeMeeting"]}

package/dist/index.d.cts

@@ -3,7 +3,7 @@ import { CSSProperties, Ref } from 'react';
 
 declare const EMBED_PROTOCOL_VERSION: 1;
 declare const EMBED_MESSAGE_SOURCE: "oemeeting";
-declare const DEFAULT_EMBED_ORIGIN = "https://meet.oceanedu.org";
+declare const DEFAULT_EMBED_ORIGIN = "https://meet.ocean.edu.vn";
 declare enum EmbedEventType {
     READY = "oemeeting:ready",
     JOINED = "oemeeting:joined",
@@ -11,7 +11,8 @@ declare enum EmbedEventType {
     PARTICIPANT_JOINED = "oemeeting:participant-joined",
     PARTICIPANT_LEFT = "oemeeting:participant-left",
     ENDED = "oemeeting:ended",
-    ERROR = "oemeeting:error"
+    ERROR = "oemeeting:error",
+    STAGE_CHANGED = "oemeeting:stage-changed"
 }
 declare enum EmbedCommandType {
     COMMAND = "oemeeting:command"
@@ -19,7 +20,9 @@ declare enum EmbedCommandType {
 declare enum EmbedCommandAction {
     LEAVE = "leave",
     TOGGLE_MIC = "toggleMic",
-    TOGGLE_CAMERA = "toggleCamera"
+    TOGGLE_CAMERA = "toggleCamera",
+    OPEN_STAGE = "openStage",
+    CLOSE_STAGE = "closeStage"
 }
 declare enum EmbedErrorCode {
     TOKEN_INVALID = "TOKEN_INVALID",
@@ -28,8 +31,15 @@ declare enum EmbedErrorCode {
     ROOM_ACCESS_DENIED = "ROOM_ACCESS_DENIED",
     CONNECTION_FAILED = "CONNECTION_FAILED",
     PROTOCOL_MISMATCH = "PROTOCOL_MISMATCH",
+    STAGE_ORIGIN_DENIED = "STAGE_ORIGIN_DENIED",
+    STAGE_URL_INVALID = "STAGE_URL_INVALID",
     UNKNOWN = "UNKNOWN"
 }
+/** Open host-owned tool id. Meeting does not catalog values. */
+type StageToolId = string;
+declare const MAX_STAGE_URL_LENGTH = 2048;
+declare const MAX_STAGE_TOOL_ID_LENGTH = 32;
+declare function isStageToolId(value: unknown): value is StageToolId;
 declare enum EmbedQueryParam {
     INSTANCE_ID = "instanceId",
     HOST_ORIGIN = "hostOrigin",
@@ -78,6 +88,17 @@ interface EmbedErrorPayload {
     code: EmbedErrorCode | string;
     message: string;
 }
+interface EmbedStageChangedPayload {
+    url: string | null;
+    title?: string;
+    tool?: StageToolId;
+    openedBy?: string;
+}
+interface OpenStageInput {
+    url: string;
+    title?: string;
+    tool?: StageToolId;
+}
 type EmbedEventPayloadMap = {
     [EmbedEventType.READY]: EmbedReadyPayload;
     [EmbedEventType.JOINED]: EmbedJoinedPayload;
@@ -86,6 +107,7 @@ type EmbedEventPayloadMap = {
     [EmbedEventType.PARTICIPANT_LEFT]: EmbedParticipantLeftPayload;
     [EmbedEventType.ENDED]: EmbedEndedPayload;
     [EmbedEventType.ERROR]: EmbedErrorPayload;
+    [EmbedEventType.STAGE_CHANGED]: EmbedStageChangedPayload;
 };
 type EmbedEventByType<T extends EmbedEventType> = EmbedMessageBase & {
     type: T;
@@ -100,11 +122,14 @@ type EmbedEventOf<T extends EmbedEventType> = Extract<EmbedEvent, {
 type EmbedCommandMessage = EmbedMessageBase & {
     type: 'oemeeting:command';
     action: EmbedCommandAction;
+    payload?: OpenStageInput;
 };
 interface OeMeetingHandle {
     leave: () => void;
     toggleMic: () => void;
     toggleCamera: () => void;
+    openStage: (input: OpenStageInput) => void;
+    closeStage: () => void;
     getIframe: () => HTMLIFrameElement | null;
 }
 interface OeMeetingProps {
@@ -132,6 +157,7 @@ interface OeMeetingProps {
     onParticipantLeft?: (event: EmbedEventOf<EmbedEventType.PARTICIPANT_LEFT>) => void;
     onEnded?: (event: EmbedEventOf<EmbedEventType.ENDED>) => void;
     onError?: (event: EmbedEventOf<EmbedEventType.ERROR>) => void;
+    onStageChanged?: (event: EmbedEventOf<EmbedEventType.STAGE_CHANGED>) => void;
     onEvent?: (event: EmbedEvent) => void;
 }
 interface BuildEmbedUrlOptions {
@@ -150,7 +176,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' | 'onEvent'> & {
+type UseOeMeetingOptions = Pick<OeMeetingProps, 'onReady' | 'onJoined' | 'onLeft' | 'onParticipantJoined' | 'onParticipantLeft' | 'onEnded' | 'onError' | 'onStageChanged' | 'onEvent'> & {
     instanceId: string;
     targetOrigin: string;
     handleRef?: Ref<OeMeetingHandle>;
@@ -164,4 +190,7 @@ declare function buildEmbedUrl(options: BuildEmbedUrlOptions): string;
 
 declare function parseEmbedEvent(data: unknown): EmbedEvent | null;
 
-export { type BuildEmbedUrlOptions, DEFAULT_EMBED_ORIGIN, DEFAULT_IFRAME_ALLOW, EMBED_MESSAGE_SOURCE, EMBED_PROTOCOL_VERSION, 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, EmbedQueryParam, type EmbedReadyPayload, OeMeeting, type OeMeetingHandle, type OeMeetingProps, buildEmbedUrl, parseEmbedEvent, useOeMeeting };
+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, 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, EmbedQueryParam, type EmbedReadyPayload, type EmbedStageChangedPayload, MAX_STAGE_TOOL_ID_LENGTH, MAX_STAGE_URL_LENGTH, OeMeeting, type OeMeetingHandle, type OeMeetingProps, type OpenStageInput, type StageToolId, buildEmbedUrl, isStageToolId, isValidStageUrl, normalizeOpenStageInput, parseEmbedEvent, useOeMeeting };

package/dist/index.d.ts

@@ -3,7 +3,7 @@ import { CSSProperties, Ref } from 'react';
 
 declare const EMBED_PROTOCOL_VERSION: 1;
 declare const EMBED_MESSAGE_SOURCE: "oemeeting";
-declare const DEFAULT_EMBED_ORIGIN = "https://meet.oceanedu.org";
+declare const DEFAULT_EMBED_ORIGIN = "https://meet.ocean.edu.vn";
 declare enum EmbedEventType {
     READY = "oemeeting:ready",
     JOINED = "oemeeting:joined",
@@ -11,7 +11,8 @@ declare enum EmbedEventType {
     PARTICIPANT_JOINED = "oemeeting:participant-joined",
     PARTICIPANT_LEFT = "oemeeting:participant-left",
     ENDED = "oemeeting:ended",
-    ERROR = "oemeeting:error"
+    ERROR = "oemeeting:error",
+    STAGE_CHANGED = "oemeeting:stage-changed"
 }
 declare enum EmbedCommandType {
     COMMAND = "oemeeting:command"
@@ -19,7 +20,9 @@ declare enum EmbedCommandType {
 declare enum EmbedCommandAction {
     LEAVE = "leave",
     TOGGLE_MIC = "toggleMic",
-    TOGGLE_CAMERA = "toggleCamera"
+    TOGGLE_CAMERA = "toggleCamera",
+    OPEN_STAGE = "openStage",
+    CLOSE_STAGE = "closeStage"
 }
 declare enum EmbedErrorCode {
     TOKEN_INVALID = "TOKEN_INVALID",
@@ -28,8 +31,15 @@ declare enum EmbedErrorCode {
     ROOM_ACCESS_DENIED = "ROOM_ACCESS_DENIED",
     CONNECTION_FAILED = "CONNECTION_FAILED",
     PROTOCOL_MISMATCH = "PROTOCOL_MISMATCH",
+    STAGE_ORIGIN_DENIED = "STAGE_ORIGIN_DENIED",
+    STAGE_URL_INVALID = "STAGE_URL_INVALID",
     UNKNOWN = "UNKNOWN"
 }
+/** Open host-owned tool id. Meeting does not catalog values. */
+type StageToolId = string;
+declare const MAX_STAGE_URL_LENGTH = 2048;
+declare const MAX_STAGE_TOOL_ID_LENGTH = 32;
+declare function isStageToolId(value: unknown): value is StageToolId;
 declare enum EmbedQueryParam {
     INSTANCE_ID = "instanceId",
     HOST_ORIGIN = "hostOrigin",
@@ -78,6 +88,17 @@ interface EmbedErrorPayload {
     code: EmbedErrorCode | string;
     message: string;
 }
+interface EmbedStageChangedPayload {
+    url: string | null;
+    title?: string;
+    tool?: StageToolId;
+    openedBy?: string;
+}
+interface OpenStageInput {
+    url: string;
+    title?: string;
+    tool?: StageToolId;
+}
 type EmbedEventPayloadMap = {
     [EmbedEventType.READY]: EmbedReadyPayload;
     [EmbedEventType.JOINED]: EmbedJoinedPayload;
@@ -86,6 +107,7 @@ type EmbedEventPayloadMap = {
     [EmbedEventType.PARTICIPANT_LEFT]: EmbedParticipantLeftPayload;
     [EmbedEventType.ENDED]: EmbedEndedPayload;
     [EmbedEventType.ERROR]: EmbedErrorPayload;
+    [EmbedEventType.STAGE_CHANGED]: EmbedStageChangedPayload;
 };
 type EmbedEventByType<T extends EmbedEventType> = EmbedMessageBase & {
     type: T;
@@ -100,11 +122,14 @@ type EmbedEventOf<T extends EmbedEventType> = Extract<EmbedEvent, {
 type EmbedCommandMessage = EmbedMessageBase & {
     type: 'oemeeting:command';
     action: EmbedCommandAction;
+    payload?: OpenStageInput;
 };
 interface OeMeetingHandle {
     leave: () => void;
     toggleMic: () => void;
     toggleCamera: () => void;
+    openStage: (input: OpenStageInput) => void;
+    closeStage: () => void;
     getIframe: () => HTMLIFrameElement | null;
 }
 interface OeMeetingProps {
@@ -132,6 +157,7 @@ interface OeMeetingProps {
     onParticipantLeft?: (event: EmbedEventOf<EmbedEventType.PARTICIPANT_LEFT>) => void;
     onEnded?: (event: EmbedEventOf<EmbedEventType.ENDED>) => void;
     onError?: (event: EmbedEventOf<EmbedEventType.ERROR>) => void;
+    onStageChanged?: (event: EmbedEventOf<EmbedEventType.STAGE_CHANGED>) => void;
     onEvent?: (event: EmbedEvent) => void;
 }
 interface BuildEmbedUrlOptions {
@@ -150,7 +176,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' | 'onEvent'> & {
+type UseOeMeetingOptions = Pick<OeMeetingProps, 'onReady' | 'onJoined' | 'onLeft' | 'onParticipantJoined' | 'onParticipantLeft' | 'onEnded' | 'onError' | 'onStageChanged' | 'onEvent'> & {
     instanceId: string;
     targetOrigin: string;
     handleRef?: Ref<OeMeetingHandle>;
@@ -164,4 +190,7 @@ declare function buildEmbedUrl(options: BuildEmbedUrlOptions): string;
 
 declare function parseEmbedEvent(data: unknown): EmbedEvent | null;
 
-export { type BuildEmbedUrlOptions, DEFAULT_EMBED_ORIGIN, DEFAULT_IFRAME_ALLOW, EMBED_MESSAGE_SOURCE, EMBED_PROTOCOL_VERSION, 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, EmbedQueryParam, type EmbedReadyPayload, OeMeeting, type OeMeetingHandle, type OeMeetingProps, buildEmbedUrl, parseEmbedEvent, useOeMeeting };
+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, 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, EmbedQueryParam, type EmbedReadyPayload, type EmbedStageChangedPayload, MAX_STAGE_TOOL_ID_LENGTH, MAX_STAGE_URL_LENGTH, OeMeeting, type OeMeetingHandle, type OeMeetingProps, type OpenStageInput, type StageToolId, buildEmbedUrl, isStageToolId, isValidStageUrl, normalizeOpenStageInput, parseEmbedEvent, useOeMeeting };

package/dist/index.js

@@ -8,7 +8,7 @@ import {
 // src/embed-protocol.ts
 var EMBED_PROTOCOL_VERSION = 1;
 var EMBED_MESSAGE_SOURCE = "oemeeting";
-var DEFAULT_EMBED_ORIGIN = "https://meet.oceanedu.org";
+var DEFAULT_EMBED_ORIGIN = "https://meet.ocean.edu.vn";
 var EmbedEventType = /* @__PURE__ */ ((EmbedEventType2) => {
   EmbedEventType2["READY"] = "oemeeting:ready";
   EmbedEventType2["JOINED"] = "oemeeting:joined";
@@ -17,6 +17,7 @@ var EmbedEventType = /* @__PURE__ */ ((EmbedEventType2) => {
   EmbedEventType2["PARTICIPANT_LEFT"] = "oemeeting:participant-left";
   EmbedEventType2["ENDED"] = "oemeeting:ended";
   EmbedEventType2["ERROR"] = "oemeeting:error";
+  EmbedEventType2["STAGE_CHANGED"] = "oemeeting:stage-changed";
   return EmbedEventType2;
 })(EmbedEventType || {});
 var EmbedCommandType = /* @__PURE__ */ ((EmbedCommandType2) => {
@@ -27,6 +28,8 @@ var EmbedCommandAction = /* @__PURE__ */ ((EmbedCommandAction2) => {
   EmbedCommandAction2["LEAVE"] = "leave";
   EmbedCommandAction2["TOGGLE_MIC"] = "toggleMic";
   EmbedCommandAction2["TOGGLE_CAMERA"] = "toggleCamera";
+  EmbedCommandAction2["OPEN_STAGE"] = "openStage";
+  EmbedCommandAction2["CLOSE_STAGE"] = "closeStage";
   return EmbedCommandAction2;
 })(EmbedCommandAction || {});
 var EmbedErrorCode = /* @__PURE__ */ ((EmbedErrorCode2) => {
@@ -36,9 +39,17 @@ var EmbedErrorCode = /* @__PURE__ */ ((EmbedErrorCode2) => {
   EmbedErrorCode2["ROOM_ACCESS_DENIED"] = "ROOM_ACCESS_DENIED";
   EmbedErrorCode2["CONNECTION_FAILED"] = "CONNECTION_FAILED";
   EmbedErrorCode2["PROTOCOL_MISMATCH"] = "PROTOCOL_MISMATCH";
+  EmbedErrorCode2["STAGE_ORIGIN_DENIED"] = "STAGE_ORIGIN_DENIED";
+  EmbedErrorCode2["STAGE_URL_INVALID"] = "STAGE_URL_INVALID";
   EmbedErrorCode2["UNKNOWN"] = "UNKNOWN";
   return EmbedErrorCode2;
 })(EmbedErrorCode || {});
+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}$/;
+function isStageToolId(value) {
+  return typeof value === "string" && value.length > 0 && value.length <= MAX_STAGE_TOOL_ID_LENGTH && STAGE_TOOL_ID_PATTERN.test(value);
+}
 var EmbedQueryParam = /* @__PURE__ */ ((EmbedQueryParam2) => {
   EmbedQueryParam2["INSTANCE_ID"] = "instanceId";
   EmbedQueryParam2["HOST_ORIGIN"] = "hostOrigin";
@@ -99,6 +110,31 @@ 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) {
@@ -123,6 +159,8 @@ function hasValidPayload(type, payload) {
       return typeof payload.roomSlug === "string" && typeof payload.endedAt === "string";
     case "oemeeting:error" /* ERROR */:
       return typeof payload.code === "string" && typeof payload.message === "string";
+    case "oemeeting:stage-changed" /* STAGE_CHANGED */:
+      return (payload.url === null || typeof payload.url === "string") && isOptionalString(payload.title) && isOptionalString(payload.tool) && isOptionalString(payload.openedBy);
   }
 }
 function parseEmbedEvent(data) {
@@ -144,7 +182,8 @@ function postCommand(options) {
     version: EMBED_PROTOCOL_VERSION,
     instanceId: options.instanceId,
     type: "oemeeting:command" /* COMMAND */,
-    action: options.action
+    action: options.action,
+    ...options.payload ? { payload: options.payload } : {}
   };
   frameWindow.postMessage(message, options.targetOrigin);
 }
@@ -186,17 +225,21 @@ function useOeMeeting(options) {
         case "oemeeting:error" /* ERROR */:
           callbacks.onError?.(embedEvent);
           break;
+        case "oemeeting:stage-changed" /* STAGE_CHANGED */:
+          callbacks.onStageChanged?.(embedEvent);
+          break;
       }
     };
     window.addEventListener("message", onMessage);
     return () => window.removeEventListener("message", onMessage);
   }, [options.instanceId, options.targetOrigin]);
   const send = useCallback(
-    (action) => postCommand({
+    (action, payload) => postCommand({
       iframe: iframeRef.current,
       instanceId: options.instanceId,
       action,
-      targetOrigin: options.targetOrigin
+      targetOrigin: options.targetOrigin,
+      payload
     }),
     [options.instanceId, options.targetOrigin]
   );
@@ -209,10 +252,29 @@ function useOeMeeting(options) {
     () => send("toggleCamera" /* TOGGLE_CAMERA */),
     [send]
   );
+  const openStage = useCallback(
+    (input) => {
+      const normalized = normalizeOpenStageInput(input);
+      if (!normalized) return;
+      send("openStage" /* OPEN_STAGE */, normalized);
+    },
+    [send]
+  );
+  const closeStage = useCallback(
+    () => send("closeStage" /* CLOSE_STAGE */),
+    [send]
+  );
   const getIframe = useCallback(() => iframeRef.current, []);
   const handle = useMemo(
-    () => ({ leave, toggleMic, toggleCamera, getIframe }),
-    [getIframe, leave, toggleCamera, toggleMic]
+    () => ({
+      leave,
+      toggleMic,
+      toggleCamera,
+      openStage,
+      closeStage,
+      getIframe
+    }),
+    [closeStage, getIframe, leave, openStage, toggleCamera, toggleMic]
   );
   useImperativeHandle(options.handleRef, () => handle, [handle]);
   return { iframeRef, handle };
@@ -255,6 +317,7 @@ var OeMeeting = forwardRef(
       onParticipantLeft,
       onEnded,
       onError,
+      onStageChanged,
       onEvent
     } = props;
     const reactId = useId();
@@ -302,6 +365,7 @@ var OeMeeting = forwardRef(
       onParticipantLeft,
       onEnded,
       onError,
+      onStageChanged,
       onEvent
     });
     const wrapperStyle = {
@@ -350,8 +414,13 @@ export {
   EmbedErrorCode,
   EmbedEventType,
   EmbedQueryParam,
+  MAX_STAGE_TOOL_ID_LENGTH,
+  MAX_STAGE_URL_LENGTH,
   OeMeeting,
   buildEmbedUrl,
+  isStageToolId,
+  isValidStageUrl,
+  normalizeOpenStageInput,
   parseEmbedEvent,
   useOeMeeting
 };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/OeMeeting.tsx","../src/embed-protocol.ts","../src/buildEmbedUrl.ts","../src/useOeMeeting.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      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      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          instanceId,\n          hostOrigin,\n        }),\n      [\n        autoJoin,\n        externalUserId,\n        hideLeave,\n        hostOrigin,\n        instanceId,\n        joinToken,\n        lang,\n        origin,\n        roomSlug,\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      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.oceanedu.org';\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}\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}\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  UNKNOWN = 'UNKNOWN',\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}\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  ];\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 { parseEmbedEvent } from './parseEmbedEvent';\nimport type {\n  EmbedCommandMessage,\n  OeMeetingHandle,\n  OeMeetingProps,\n} from './types';\n\ntype UseOeMeetingOptions = Pick<\n  OeMeetingProps,\n  | 'onReady'\n  | 'onJoined'\n  | 'onLeft'\n  | 'onParticipantJoined'\n  | 'onParticipantLeft'\n  | 'onEnded'\n  | 'onError'\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}\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  };\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      }\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) =>\n      postCommand({\n        iframe: iframeRef.current,\n        instanceId: options.instanceId,\n        action,\n        targetOrigin: options.targetOrigin,\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 getIframe = useCallback(() => iframeRef.current, []);\n  const handle = useMemo<OeMeetingHandle>(\n    () => ({ leave, toggleMic, toggleCamera, getIframe }),\n    [getIframe, leave, 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  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 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  }\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","OeMeeting","useMemo"]}
+{"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      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      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          instanceId,\n          hostOrigin,\n        }),\n      [\n        autoJoin,\n        externalUserId,\n        hideLeave,\n        hostOrigin,\n        instanceId,\n        joinToken,\n        lang,\n        origin,\n        roomSlug,\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      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}\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  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}\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  ];\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  | '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      }\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  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 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  }\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","OeMeeting","useMemo"]}

package/docs/BACKEND-INTEGRATION.md

@@ -13,7 +13,7 @@ OE Meeting cần cấp cho OE.School một application credential gồm:
 Cấu hình ở backend OE.School, ví dụ:
 
 ```dotenv
-OE_MEETING_API_URL=https://meet.oceanedu.org
+OE_MEETING_API_URL=https://meet.ocean.edu.vn
 OE_MEETING_CLIENT_ID=oe-school
 OE_MEETING_CLIENT_SECRET=<secret-from-secret-manager>
 ```
@@ -27,7 +27,7 @@ vào repository.
 Base URL production:
 
 ```text
-https://meet.oceanedu.org/external-api/v1.0
+https://meet.ocean.edu.vn/external-api/v1.0
 ```
 
 Mọi request server-to-server phải gửi:

package/docs/REACT-INTEGRATION.md

@@ -93,7 +93,7 @@ export function OnlineLesson({ lessonId }: { lessonId: string }) {
     <OeMeeting
       roomSlug={access.roomSlug}
       joinToken={access.joinToken}
-      origin="https://meet.oceanedu.org"
+      origin="https://meet.ocean.edu.vn"
       width="100%"
       height="calc(100vh - 64px)"
       hideLeave
@@ -106,7 +106,7 @@ export function OnlineLesson({ lessonId }: { lessonId: string }) {
 }
 ```
 
-`origin` có giá trị mặc định là `https://meet.oceanedu.org`, nên có thể bỏ prop
+`origin` có giá trị mặc định là `https://meet.ocean.edu.vn`, nên có thể bỏ prop
 này ở production. Khi chạy local, truyền URL frontend OE Meeting local, ví dụ
 `http://localhost:5173`.
 
@@ -116,7 +116,7 @@ này ở production. Khi chạy local, truyền URL frontend OE Meeting local, v
 |---|---|---|---|
 | `roomSlug` | `string` | Bắt buộc | Slug phòng do backend trả về. |
 | `joinToken` | `string` | Bắt buộc | Token cấp riêng cho user hiện tại. |
-| `origin` | `string` | `https://meet.oceanedu.org` | Origin của OE Meeting. |
+| `origin` | `string` | `https://meet.ocean.edu.vn` | Origin của OE Meeting. |
 | `autoJoin` | `boolean` | `true` | Phiên bản hiện tại chỉ hỗ trợ `true`. |
 | `hideLeave` | `boolean` | `false` | Ẩn nút rời phòng trong iframe. |
 | `userName` | `string` | — | Thông tin tùy chọn truyền vào embed URL. |
@@ -166,6 +166,7 @@ interface EmbedEventEnvelope<TPayload> {
 | `PARTICIPANT_LEFT` | `identity`, `participantCount` | Đã emit |
 | `ERROR` | `code`, `message` | Đã emit |
 | `ENDED` | `roomSlug`, `endedAt` | Đã khai báo, chưa có nguồn emit |
+| `STAGE_CHANGED` | `url` (`string` \| `null`), `title?`, `tool?`, `openedBy?` | Đã emit |
 
 Có thể dùng `onEvent` để gửi analytics tập trung, nhưng không log join token,
 iframe URL đầy đủ hoặc dữ liệu nhạy cảm.
@@ -213,6 +214,8 @@ export function MeetingWithControls(props: {
 - `leave()`.
 - `toggleMic()`.
 - `toggleCamera()`.
+- `openStage({ url, title?, tool? })` — ignore nếu `attributes.stage=follow`.
+- `closeStage()` — opener, `stage=open`, hoặc admin room.
 - `getIframe()`.
 
 ## 6. Error codes
@@ -226,14 +229,16 @@ export function MeetingWithControls(props: {
 | `ROOM_NOT_FOUND` | Phòng không tồn tại. | Tạo/đồng bộ lại phòng của lesson. | Đã khai báo, chưa phân loại riêng |
 | `ROOM_ACCESS_DENIED` | User không có quyền. | Không retry tự động; hiển thị thông báo phù hợp. | Đã khai báo, chưa phân loại riêng |
 | `PROTOCOL_MISMATCH` | SDK và embed khác version. | Đồng bộ phiên bản SDK/OE Meeting. | Đã khai báo, chưa emit |
+| `STAGE_ORIGIN_DENIED` | Origin URL Stage không nằm allowlist. | Dùng origin đã khai báo (`hostOrigin` / `VITE_STAGE_ALLOWED_ORIGINS`). | Đã emit |
+| `STAGE_URL_INVALID` | URL Stage thiếu hoặc không hợp lệ. | Chỉ `https` (hoặc `http` localhost). | Đã emit |
 
 ## 7. Local development
 
-Giả sử OE Meeting frontend chạy tại `http://localhost:5173`:
+Frontend OE Meeting mặc định chạy cổng `3000`.
 
 ```tsx
 <OeMeeting
-  origin="http://localhost:5173"
+  origin="http://localhost:3000"
   roomSlug={roomSlug}
   joinToken={joinToken}
 />
@@ -266,7 +271,7 @@ về đúng origin đó.
 ### Frontend OE.School
 
 - [ ] Chỉ render `OeMeeting` sau khi nhận `roomSlug` và `joinToken`.
-- [ ] Production dùng origin `https://meet.oceanedu.org`.
+- [ ] Production dùng origin `https://meet.ocean.edu.vn`.
 - [ ] Có trạng thái loading, forbidden, token expired và connection failed.
 - [ ] Không dùng `targetOrigin="*"`.
 - [ ] Camera/microphone hoạt động trong iframe.

package/docs/RELEASE.md

@@ -1,36 +1,39 @@
 # Release npm — `@tinyweb_dev/oe-meeting-react`
 
 Workflow [`release_npm.yml`](../../../../.github/workflows/release_npm.yml) build,
-typecheck, test, kiểm tra tarball và publish React SDK lên npm.
+typecheck, test, kiểm tra tarball và publish React SDK lên npm bằng
+**npm Trusted Publishing (OIDC)** — không dùng long-lived `NPM_TOKEN`.
 
 ## Chuẩn bị một lần
 
 ### 1. Kiểm tra npm organization
 
-Tài khoản phát hành phải có quyền publish package public trong scope
-`@tinyweb_dev`.
+Tài khoản maintainer phải có quyền cấu hình Trusted Publisher cho package
+public trong scope `@tinyweb_dev`.
 
-### 2. Tạo npm access token
+### 2. Cấu hình Trusted Publisher trên npmjs.com
 
-Tạo automation/granular access token trên npm với quyền read/write package
-`@tinyweb_dev/oe-meeting-react`.
-
-### 3. Thêm GitHub Actions secret
-
-Trong repository `tinyweb-01/oe-meeting`, mở:
+Trên npmjs.com, mở package (hoặc org) `@tinyweb_dev/oe-meeting-react` →
+**Trusted Publisher** / **Publishing access**:
 
 ```text
-Settings → Secrets and variables → Actions → New repository secret
+Organization or user: tinyweb-01
+Repository:           oe-meeting
+Workflow filename:    release_npm.yml
+Allowed actions:      npm publish
 ```
 
-Tạo secret:
+Không cần GitHub secret `NPM_TOKEN`. Workflow dùng OIDC (`id-token: write`)
+và npm CLI >= 11.5.1 trên Node >= 22.14.
 
-```text
-Name:  NPM_TOKEN
-Value: <npm-access-token>
-```
+Granular access token (GAT) bypass-2FA không còn phù hợp cho CI publish
+([npm v12 / GAT deprecation](https://github.blog/changelog/2026-07-08-npm-install-time-security-and-gat-bypass2fa-deprecation/)).
+
+### 3. Publish lần đầu (package chưa tồn tại)
 
-Không ghi token vào source, workflow, log hoặc file `.npmrc` trong repository.
+Nếu package chưa có trên registry, tạo Trusted Publisher ở cấp org
+`@tinyweb_dev` trỏ đúng GitHub repo/workflow ở trên, rồi chạy release.
+Không commit token vào source, workflow, log hoặc file `.npmrc`.
 
 ## Kiểm thử pipeline không publish
 
@@ -43,7 +46,7 @@ dry_run = true
 Workflow sẽ chạy đầy đủ build, typecheck, test, `npm pack` và
 `npm publish --dry-run`; không upload package.
 
-Có thể kiểm tra tương đương ở local:
+Có thể kiểm tra tương đương ở local (local publish vẫn cần 2FA tương tác):
 
 ```bash
 cd src/sdk
@@ -105,12 +108,20 @@ bản mới.
 một commit/ref đã review và package version chưa tồn tại trên npm. Luồng tag vẫn
 là cách phát hành chuẩn vì tạo dấu mốc release rõ ràng trong Git.
 
+Local publish (maintainer + 2FA):
+
+```bash
+cd src/sdk/react
+npm publish --access public
+```
+
 ## Troubleshooting
 
 | Lỗi | Nguyên nhân thường gặp | Cách xử lý |
 |---|---|---|
-| `ENEEDAUTH` / `E401` | Thiếu, hết hạn hoặc sai `NPM_TOKEN` | Tạo token mới và cập nhật GitHub secret. |
-| `E403` | Token không có quyền scope/package hoặc npm yêu cầu 2FA policy khác | Kiểm tra quyền granular token và organization. |
+| `E404` trên `PUT .../oe-meeting-react` | Token/GAT bị từ chối (npm trả 404 thay vì 401/403), hoặc chưa cấu hình Trusted Publisher | Cấu hình OIDC Trusted Publisher; không dùng `NPM_TOKEN` bypass-2FA. |
+| `ENEEDAUTH` / `E401` | OIDC chưa được npm chấp nhận, hoặc local thiếu login | Kiểm tra Trusted Publisher khớp org/repo/workflow; local thì `npm login` + 2FA. |
+| `E403` | Publisher không có quyền scope/package | Kiểm tra quyền org `@tinyweb_dev` và Trusted Publisher. |
 | Tag không khớp version | Tag và `package.json` khác nhau | Tăng version, commit rồi tạo tag đúng convention. |
 | Version đã tồn tại | Npm không cho overwrite | Tăng patch/minor/major version. |
 | Build/typecheck/test fail | Source chưa đạt release gate | Fix lỗi; không bỏ qua gate publish. |

package/package.json

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