@tinyweb_dev/oe-meeting-react 0.2.0 → 0.3.0

package/README.md

@@ -36,6 +36,8 @@ export function OnlineLesson({
       joinToken={joinToken}
       height="100vh"
       hideLeave
+      autoTranscribe
+      autoRecord
       onJoined={(event) => console.info('joined', event.payload)}
       onLeft={(event) => console.info('left', event.payload)}
     />
@@ -43,6 +45,24 @@ export function OnlineLesson({
 }
 ```
 
+## Transcript
+
+`autoTranscribe` bật transcript ngay khi embed kết nối. Transcript là tài sản
+cấp phòng: người đầu tiên vào bật lên, mọi người sau nhận
+`outcome: "already_running"`, và nó vẫn chạy khi người bật rời sớm. Kết quả đến
+qua `onTranscriptStarted`.
+
+Sau buổi học, backend OE.School lấy transcript bằng
+`GET /external-api/v1.0/rooms/:idOrSlug/transcript` (scope `transcripts:retrieve`).
+
+## Recording
+
+`autoRecord` tự ghi toàn bộ phòng khi embed kết nối và báo kết quả qua
+`onRecordingStarted`. Backend tích hợp lấy danh sách cùng URL tải tạm thời bằng
+`GET /external-api/v1.0/rooms/:idOrSlug/recordings` (scope
+`recordings:retrieve`). Thời hạn tải do `RECORDING_EXPIRATION_DAYS` cấu hình;
+bucket S3/MinIO phải có lifecycle rule cùng số ngày để xóa file thật.
+
 ## Bảo mật
 
 - `joinToken` phải được backend OE.School lấy server-to-server từ external API.

package/dist/index.cjs

@@ -24,6 +24,7 @@ __export(index_exports, {
   DEFAULT_IFRAME_ALLOW: () => DEFAULT_IFRAME_ALLOW,
   EMBED_MESSAGE_SOURCE: () => EMBED_MESSAGE_SOURCE,
   EMBED_PROTOCOL_VERSION: () => EMBED_PROTOCOL_VERSION,
+  EmbedCaptureOutcome: () => EmbedCaptureOutcome,
   EmbedCommandAction: () => EmbedCommandAction,
   EmbedCommandType: () => EmbedCommandType,
   EmbedErrorCode: () => EmbedErrorCode,
@@ -57,6 +58,8 @@ var EmbedEventType = /* @__PURE__ */ ((EmbedEventType2) => {
   EmbedEventType2["ENDED"] = "oemeeting:ended";
   EmbedEventType2["ERROR"] = "oemeeting:error";
   EmbedEventType2["STAGE_CHANGED"] = "oemeeting:stage-changed";
+  EmbedEventType2["TRANSCRIPT_STARTED"] = "oemeeting:transcript-started";
+  EmbedEventType2["RECORDING_STARTED"] = "oemeeting:recording-started";
   return EmbedEventType2;
 })(EmbedEventType || {});
 var EmbedCommandType = /* @__PURE__ */ ((EmbedCommandType2) => {
@@ -80,6 +83,8 @@ var EmbedErrorCode = /* @__PURE__ */ ((EmbedErrorCode2) => {
   EmbedErrorCode2["PROTOCOL_MISMATCH"] = "PROTOCOL_MISMATCH";
   EmbedErrorCode2["STAGE_ORIGIN_DENIED"] = "STAGE_ORIGIN_DENIED";
   EmbedErrorCode2["STAGE_URL_INVALID"] = "STAGE_URL_INVALID";
+  EmbedErrorCode2["TRANSCRIPT_START_FAILED"] = "TRANSCRIPT_START_FAILED";
+  EmbedErrorCode2["RECORDING_START_FAILED"] = "RECORDING_START_FAILED";
   EmbedErrorCode2["UNKNOWN"] = "UNKNOWN";
   return EmbedErrorCode2;
 })(EmbedErrorCode || {});
@@ -98,8 +103,17 @@ var EmbedQueryParam = /* @__PURE__ */ ((EmbedQueryParam2) => {
   EmbedQueryParam2["LANG"] = "lang";
   EmbedQueryParam2["AUTO_JOIN"] = "autoJoin";
   EmbedQueryParam2["HIDE_LEAVE"] = "hideLeave";
+  EmbedQueryParam2["AUTO_TRANSCRIBE"] = "autoTranscribe";
+  EmbedQueryParam2["AUTO_RECORD"] = "autoRecord";
   return EmbedQueryParam2;
 })(EmbedQueryParam || {});
+var EmbedCaptureOutcome = /* @__PURE__ */ ((EmbedCaptureOutcome2) => {
+  EmbedCaptureOutcome2["STARTED"] = "started";
+  EmbedCaptureOutcome2["ALREADY_RUNNING"] = "already_running";
+  EmbedCaptureOutcome2["DISABLED"] = "disabled";
+  EmbedCaptureOutcome2["FAILED"] = "failed";
+  return EmbedCaptureOutcome2;
+})(EmbedCaptureOutcome || {});
 
 // src/buildEmbedUrl.ts
 var QUERY_FLAG_ENABLED = "1";
@@ -130,7 +144,9 @@ function buildEmbedUrl(options) {
     ["externalUserId" /* EXTERNAL_USER_ID */, options.externalUserId],
     ["lang" /* LANG */, options.lang],
     ["autoJoin" /* AUTO_JOIN */, toFlag(options.autoJoin)],
-    ["hideLeave" /* HIDE_LEAVE */, toFlag(options.hideLeave)]
+    ["hideLeave" /* HIDE_LEAVE */, toFlag(options.hideLeave)],
+    ["autoTranscribe" /* AUTO_TRANSCRIBE */, toFlag(options.autoTranscribe)],
+    ["autoRecord" /* AUTO_RECORD */, toFlag(options.autoRecord)]
   ];
   for (const [key, value] of entries) {
     if (value !== void 0 && value !== "") {
@@ -176,6 +192,13 @@ function isRecord(value) {
 function isOptionalString(value) {
   return value === void 0 || typeof value === "string";
 }
+function isNullableString(value) {
+  return value === null || typeof value === "string";
+}
+var CAPTURE_OUTCOMES = new Set(Object.values(EmbedCaptureOutcome));
+function isCaptureOutcome(value) {
+  return typeof value === "string" && CAPTURE_OUTCOMES.has(value);
+}
 function hasValidPayload(type, payload) {
   switch (type) {
     case "oemeeting:ready" /* READY */:
@@ -194,6 +217,10 @@ function hasValidPayload(type, payload) {
       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);
+    case "oemeeting:transcript-started" /* TRANSCRIPT_STARTED */:
+      return typeof payload.roomSlug === "string" && isCaptureOutcome(payload.outcome) && isNullableString(payload.transcriptId) && isNullableString(payload.status);
+    case "oemeeting:recording-started" /* RECORDING_STARTED */:
+      return typeof payload.roomSlug === "string" && isCaptureOutcome(payload.outcome) && isNullableString(payload.recordingId) && isNullableString(payload.status);
   }
 }
 function parseEmbedEvent(data) {
@@ -261,6 +288,12 @@ function useOeMeeting(options) {
         case "oemeeting:stage-changed" /* STAGE_CHANGED */:
           callbacks.onStageChanged?.(embedEvent);
           break;
+        case "oemeeting:transcript-started" /* TRANSCRIPT_STARTED */:
+          callbacks.onTranscriptStarted?.(embedEvent);
+          break;
+        case "oemeeting:recording-started" /* RECORDING_STARTED */:
+          callbacks.onRecordingStarted?.(embedEvent);
+          break;
       }
     };
     window.addEventListener("message", onMessage);
@@ -334,6 +367,8 @@ var OeMeeting = (0, import_react2.forwardRef)(
       lang,
       autoJoin = true,
       hideLeave,
+      autoTranscribe,
+      autoRecord,
       title = "OE Meeting room",
       width = "100%",
       height = 640,
@@ -351,6 +386,8 @@ var OeMeeting = (0, import_react2.forwardRef)(
       onEnded,
       onError,
       onStageChanged,
+      onTranscriptStarted,
+      onRecordingStarted,
       onEvent
     } = props;
     const reactId = (0, import_react2.useId)();
@@ -371,11 +408,15 @@ var OeMeeting = (0, import_react2.forwardRef)(
         lang,
         autoJoin,
         hideLeave,
+        autoTranscribe,
+        autoRecord,
         instanceId,
         hostOrigin
       }),
       [
         autoJoin,
+        autoRecord,
+        autoTranscribe,
         externalUserId,
         hideLeave,
         hostOrigin,
@@ -399,6 +440,8 @@ var OeMeeting = (0, import_react2.forwardRef)(
       onEnded,
       onError,
       onStageChanged,
+      onTranscriptStarted,
+      onRecordingStarted,
       onEvent
     });
     const wrapperStyle = {
@@ -443,6 +486,7 @@ OeMeeting.displayName = "OeMeeting";
   DEFAULT_IFRAME_ALLOW,
   EMBED_MESSAGE_SOURCE,
   EMBED_PROTOCOL_VERSION,
+  EmbedCaptureOutcome,
   EmbedCommandAction,
   EmbedCommandType,
   EmbedErrorCode,

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/OeMeeting.tsx","../src/embed-protocol.ts","../src/buildEmbedUrl.ts","../src/useOeMeeting.ts","../src/openStage.ts","../src/parseEmbedEvent.ts"],"sourcesContent":["export { OeMeeting, DEFAULT_IFRAME_ALLOW } from './OeMeeting';\nexport { useOeMeeting } from './useOeMeeting';\nexport { buildEmbedUrl } from './buildEmbedUrl';\nexport { parseEmbedEvent } from './parseEmbedEvent';\nexport {\n  DEFAULT_EMBED_ORIGIN,\n  EMBED_MESSAGE_SOURCE,\n  EMBED_PROTOCOL_VERSION,\n  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"]}
+{"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  EmbedCaptureOutcome,\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  EmbedRecordingStartedPayload,\n  EmbedStageChangedPayload,\n  EmbedTranscriptStartedPayload,\n  OeMeetingHandle,\n  OeMeetingProps,\n  OpenStageInput,\n} from './types';\n","'use client';\n\nimport {\n  forwardRef,\n  useId,\n  useMemo,\n  type CSSProperties,\n} from 'react';\nimport { buildEmbedUrl } from './buildEmbedUrl';\nimport { DEFAULT_EMBED_ORIGIN } from './embed-protocol';\nimport type { OeMeetingHandle, OeMeetingProps } from './types';\nimport { useOeMeeting } from './useOeMeeting';\n\nexport const DEFAULT_IFRAME_ALLOW =\n  'camera; microphone; fullscreen; autoplay; display-capture; clipboard-write; encrypted-media';\n\nfunction toCssSize(value: number | string | undefined): string | undefined {\n  if (value === undefined) return undefined;\n  return typeof value === 'number' ? `${value}px` : value;\n}\n\nfunction getOrigin(value: string): string {\n  return new URL(value).origin;\n}\n\nexport const OeMeeting = forwardRef<OeMeetingHandle, OeMeetingProps>(\n  function OeMeeting(props, ref) {\n    const {\n      roomSlug,\n      joinToken,\n      userName,\n      externalUserId,\n      origin = DEFAULT_EMBED_ORIGIN,\n      lang,\n      autoJoin = true,\n      hideLeave,\n      autoTranscribe,\n      autoRecord,\n      title = 'OE Meeting room',\n      width = '100%',\n      height = 640,\n      className,\n      style,\n      iframeClassName,\n      iframeStyle,\n      allow = DEFAULT_IFRAME_ALLOW,\n      targetOrigin,\n      onReady,\n      onJoined,\n      onLeft,\n      onParticipantJoined,\n      onParticipantLeft,\n      onEnded,\n      onError,\n      onStageChanged,\n      onTranscriptStarted,\n      onRecordingStarted,\n      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          autoTranscribe,\n          autoRecord,\n          instanceId,\n          hostOrigin,\n        }),\n      [\n        autoJoin,\n        autoRecord,\n        autoTranscribe,\n        externalUserId,\n        hideLeave,\n        hostOrigin,\n        instanceId,\n        joinToken,\n        lang,\n        origin,\n        roomSlug,\n        userName,\n      ],\n    );\n    const { iframeRef } = useOeMeeting({\n      instanceId,\n      targetOrigin: resolvedTargetOrigin,\n      handleRef: ref,\n      onReady,\n      onJoined,\n      onLeft,\n      onParticipantJoined,\n      onParticipantLeft,\n      onEnded,\n      onError,\n      onStageChanged,\n      onTranscriptStarted,\n      onRecordingStarted,\n      onEvent,\n    });\n    const wrapperStyle: CSSProperties = {\n      width: toCssSize(width),\n      height: toCssSize(height),\n      ...style,\n    };\n    const frameStyle: CSSProperties = {\n      width: '100%',\n      height: '100%',\n      border: 0,\n      display: 'block',\n      ...iframeStyle,\n    };\n\n    return (\n      <div\n        className={className}\n        style={wrapperStyle}\n        data-oe-meeting-instance={instanceId}\n      >\n        <iframe\n          ref={iframeRef}\n          className={iframeClassName}\n          style={frameStyle}\n          src={src}\n          title={title}\n          allow={allow}\n          allowFullScreen\n          referrerPolicy=\"strict-origin-when-cross-origin\"\n        />\n      </div>\n    );\n  },\n);\n\nOeMeeting.displayName = 'OeMeeting';\n","export const EMBED_PROTOCOL_VERSION = 1 as const;\nexport const EMBED_MESSAGE_SOURCE = 'oemeeting' as const;\nexport const DEFAULT_EMBED_ORIGIN = 'https://meet.ocean.edu.vn';\n\nexport enum EmbedEventType {\n  READY = 'oemeeting:ready',\n  JOINED = 'oemeeting:joined',\n  LEFT = 'oemeeting:left',\n  PARTICIPANT_JOINED = 'oemeeting:participant-joined',\n  PARTICIPANT_LEFT = 'oemeeting:participant-left',\n  ENDED = 'oemeeting:ended',\n  ERROR = 'oemeeting:error',\n  STAGE_CHANGED = 'oemeeting:stage-changed',\n  TRANSCRIPT_STARTED = 'oemeeting:transcript-started',\n  RECORDING_STARTED = 'oemeeting:recording-started',\n}\n\nexport enum EmbedCommandType {\n  COMMAND = 'oemeeting:command',\n}\n\nexport enum EmbedCommandAction {\n  LEAVE = 'leave',\n  TOGGLE_MIC = 'toggleMic',\n  TOGGLE_CAMERA = 'toggleCamera',\n  OPEN_STAGE = 'openStage',\n  CLOSE_STAGE = 'closeStage',\n}\n\nexport enum EmbedErrorCode {\n  TOKEN_INVALID = 'TOKEN_INVALID',\n  TOKEN_EXPIRED = 'TOKEN_EXPIRED',\n  ROOM_NOT_FOUND = 'ROOM_NOT_FOUND',\n  ROOM_ACCESS_DENIED = 'ROOM_ACCESS_DENIED',\n  CONNECTION_FAILED = 'CONNECTION_FAILED',\n  PROTOCOL_MISMATCH = 'PROTOCOL_MISMATCH',\n  STAGE_ORIGIN_DENIED = 'STAGE_ORIGIN_DENIED',\n  STAGE_URL_INVALID = 'STAGE_URL_INVALID',\n  TRANSCRIPT_START_FAILED = 'TRANSCRIPT_START_FAILED',\n  RECORDING_START_FAILED = 'RECORDING_START_FAILED',\n  UNKNOWN = 'UNKNOWN',\n}\n\n/** Open host-owned tool id. Meeting does not catalog values. */\nexport type StageToolId = string;\n\nexport const MAX_STAGE_URL_LENGTH = 2048;\nexport const MAX_STAGE_TOOL_ID_LENGTH = 32;\n\nconst STAGE_TOOL_ID_PATTERN = /^[a-z][a-z0-9._-]{0,31}$/;\n\nexport function isStageToolId(value: unknown): value is StageToolId {\n  return (\n    typeof value === 'string' &&\n    value.length > 0 &&\n    value.length <= MAX_STAGE_TOOL_ID_LENGTH &&\n    STAGE_TOOL_ID_PATTERN.test(value)\n  );\n}\n\nexport enum EmbedQueryParam {\n  INSTANCE_ID = 'instanceId',\n  HOST_ORIGIN = 'hostOrigin',\n  JOIN_TOKEN = 'joinToken',\n  USER_NAME = 'userName',\n  EXTERNAL_USER_ID = 'externalUserId',\n  LANG = 'lang',\n  AUTO_JOIN = 'autoJoin',\n  HIDE_LEAVE = 'hideLeave',\n  AUTO_TRANSCRIBE = 'autoTranscribe',\n  AUTO_RECORD = 'autoRecord',\n}\n\n/**\n * What happened to the auto-transcribe request the embed made.\n *\n * `ALREADY_RUNNING` is the normal outcome for every participant after the\n * first, because the transcript is a room-level asset rather than a\n * per-participant one. `DISABLED` means the OE Meeting deployment has\n * transcription turned off.\n */\nexport enum EmbedCaptureOutcome {\n  STARTED = 'started',\n  ALREADY_RUNNING = 'already_running',\n  DISABLED = 'disabled',\n  FAILED = 'failed',\n}\n","import {\n  DEFAULT_EMBED_ORIGIN,\n  EmbedQueryParam,\n} from './embed-protocol';\nimport type { BuildEmbedUrlOptions } from './types';\n\nconst QUERY_FLAG_ENABLED = '1';\nconst QUERY_FLAG_DISABLED = '0';\n\nfunction toFlag(value: boolean | undefined): string | undefined {\n  if (value === undefined) return undefined;\n  return value ? QUERY_FLAG_ENABLED : QUERY_FLAG_DISABLED;\n}\n\nfunction normalizeOrigin(origin: string): string {\n  return origin.replace(/\\/+$/, '');\n}\n\nexport function buildEmbedUrl(options: BuildEmbedUrlOptions): string {\n  const roomSlug = options.roomSlug.trim();\n  const joinToken = options.joinToken.trim();\n  if (!roomSlug) {\n    throw new Error('OE Meeting embed requires a non-empty roomSlug.');\n  }\n  if (!joinToken) {\n    throw new Error('OE Meeting embed requires a non-empty joinToken.');\n  }\n\n  const origin = normalizeOrigin(options.origin ?? DEFAULT_EMBED_ORIGIN);\n  const url = new URL(`${origin}/embed/${encodeURIComponent(roomSlug)}`);\n  const entries: Array<[EmbedQueryParam, string | undefined]> = [\n    [EmbedQueryParam.INSTANCE_ID, options.instanceId],\n    [EmbedQueryParam.HOST_ORIGIN, options.hostOrigin],\n    [EmbedQueryParam.JOIN_TOKEN, joinToken],\n    [EmbedQueryParam.USER_NAME, options.userName],\n    [EmbedQueryParam.EXTERNAL_USER_ID, options.externalUserId],\n    [EmbedQueryParam.LANG, options.lang],\n    [EmbedQueryParam.AUTO_JOIN, toFlag(options.autoJoin)],\n    [EmbedQueryParam.HIDE_LEAVE, toFlag(options.hideLeave)],\n    [EmbedQueryParam.AUTO_TRANSCRIBE, toFlag(options.autoTranscribe)],\n    [EmbedQueryParam.AUTO_RECORD, toFlag(options.autoRecord)],\n  ];\n\n  for (const [key, value] of entries) {\n    if (value !== undefined && value !== '') {\n      url.searchParams.set(key, value);\n    }\n  }\n  return url.toString();\n}\n","import {\n  useCallback,\n  useEffect,\n  useImperativeHandle,\n  useMemo,\n  useRef,\n  type Ref,\n} from 'react';\nimport {\n  EMBED_MESSAGE_SOURCE,\n  EMBED_PROTOCOL_VERSION,\n  EmbedCommandAction,\n  EmbedCommandType,\n  EmbedEventType,\n} from './embed-protocol';\nimport { normalizeOpenStageInput } from './openStage';\nimport { parseEmbedEvent } from './parseEmbedEvent';\nimport type {\n  EmbedCommandMessage,\n  OeMeetingHandle,\n  OeMeetingProps,\n  OpenStageInput,\n} from './types';\n\ntype UseOeMeetingOptions = Pick<\n  OeMeetingProps,\n  | 'onReady'\n  | 'onJoined'\n  | 'onLeft'\n  | 'onParticipantJoined'\n  | 'onParticipantLeft'\n  | 'onEnded'\n  | 'onError'\n  | 'onStageChanged'\n  | 'onTranscriptStarted'\n  | 'onRecordingStarted'\n  | 'onEvent'\n> & {\n  instanceId: string;\n  targetOrigin: string;\n  handleRef?: Ref<OeMeetingHandle>;\n};\n\ninterface PostCommandOptions {\n  iframe: HTMLIFrameElement | null;\n  instanceId: string;\n  action: EmbedCommandAction;\n  targetOrigin: string;\n  payload?: OpenStageInput;\n}\n\nfunction postCommand(options: PostCommandOptions): void {\n  const frameWindow = options.iframe?.contentWindow;\n  if (!frameWindow) return;\n  const message: EmbedCommandMessage = {\n    source: EMBED_MESSAGE_SOURCE,\n    version: EMBED_PROTOCOL_VERSION,\n    instanceId: options.instanceId,\n    type: EmbedCommandType.COMMAND,\n    action: options.action,\n    ...(options.payload ? { payload: options.payload } : {}),\n  };\n  frameWindow.postMessage(message, options.targetOrigin);\n}\n\nexport function useOeMeeting(options: UseOeMeetingOptions) {\n  const iframeRef = useRef<HTMLIFrameElement | null>(null);\n  const callbacksRef = useRef(options);\n\n  useEffect(() => {\n    callbacksRef.current = options;\n  }, [options]);\n\n  useEffect(() => {\n    const onMessage = (event: MessageEvent<unknown>) => {\n      const frameWindow = iframeRef.current?.contentWindow;\n      if (\n        !frameWindow ||\n        event.source !== frameWindow ||\n        event.origin !== options.targetOrigin\n      ) {\n        return;\n      }\n      const embedEvent = parseEmbedEvent(event.data);\n      if (!embedEvent || embedEvent.instanceId !== options.instanceId) return;\n\n      const callbacks = callbacksRef.current;\n      callbacks.onEvent?.(embedEvent);\n      switch (embedEvent.type) {\n        case EmbedEventType.READY:\n          callbacks.onReady?.(embedEvent);\n          break;\n        case EmbedEventType.JOINED:\n          callbacks.onJoined?.(embedEvent);\n          break;\n        case EmbedEventType.LEFT:\n          callbacks.onLeft?.(embedEvent);\n          break;\n        case EmbedEventType.PARTICIPANT_JOINED:\n          callbacks.onParticipantJoined?.(embedEvent);\n          break;\n        case EmbedEventType.PARTICIPANT_LEFT:\n          callbacks.onParticipantLeft?.(embedEvent);\n          break;\n        case EmbedEventType.ENDED:\n          callbacks.onEnded?.(embedEvent);\n          break;\n        case EmbedEventType.ERROR:\n          callbacks.onError?.(embedEvent);\n          break;\n        case EmbedEventType.STAGE_CHANGED:\n          callbacks.onStageChanged?.(embedEvent);\n          break;\n        case EmbedEventType.TRANSCRIPT_STARTED:\n          callbacks.onTranscriptStarted?.(embedEvent);\n          break;\n        case EmbedEventType.RECORDING_STARTED:\n          callbacks.onRecordingStarted?.(embedEvent);\n          break;\n      }\n    };\n\n    window.addEventListener('message', onMessage);\n    return () => window.removeEventListener('message', onMessage);\n  }, [options.instanceId, options.targetOrigin]);\n\n  const send = useCallback(\n    (action: EmbedCommandAction, payload?: OpenStageInput) =>\n      postCommand({\n        iframe: iframeRef.current,\n        instanceId: options.instanceId,\n        action,\n        targetOrigin: options.targetOrigin,\n        payload,\n      }),\n    [options.instanceId, options.targetOrigin],\n  );\n  const leave = useCallback(() => send(EmbedCommandAction.LEAVE), [send]);\n  const toggleMic = useCallback(\n    () => send(EmbedCommandAction.TOGGLE_MIC),\n    [send],\n  );\n  const toggleCamera = useCallback(\n    () => send(EmbedCommandAction.TOGGLE_CAMERA),\n    [send],\n  );\n  const openStage = useCallback(\n    (input: OpenStageInput) => {\n      const normalized = normalizeOpenStageInput(input);\n      if (!normalized) return;\n      send(EmbedCommandAction.OPEN_STAGE, normalized);\n    },\n    [send],\n  );\n  const closeStage = useCallback(\n    () => send(EmbedCommandAction.CLOSE_STAGE),\n    [send],\n  );\n  const getIframe = useCallback(() => iframeRef.current, []);\n  const handle = useMemo<OeMeetingHandle>(\n    () => ({\n      leave,\n      toggleMic,\n      toggleCamera,\n      openStage,\n      closeStage,\n      getIframe,\n    }),\n    [closeStage, getIframe, leave, openStage, toggleCamera, toggleMic],\n  );\n\n  useImperativeHandle(options.handleRef, () => handle, [handle]);\n  return { iframeRef, handle };\n}\n","import { isStageToolId, MAX_STAGE_URL_LENGTH } from './embed-protocol';\nimport type { OpenStageInput } from './types';\n\nexport function isValidStageUrl(url: string): boolean {\n  if (url.length === 0 || url.length > MAX_STAGE_URL_LENGTH) return false;\n  try {\n    const parsed = new URL(url);\n    if (parsed.protocol === 'https:') return true;\n    if (parsed.protocol === 'http:') {\n      return (\n        parsed.hostname === 'localhost' || parsed.hostname === '127.0.0.1'\n      );\n    }\n    return false;\n  } catch {\n    return false;\n  }\n}\n\nexport function normalizeOpenStageInput(\n  input: OpenStageInput,\n): OpenStageInput | null {\n  const url = input.url.trim();\n  if (!isValidStageUrl(url)) return null;\n  const title = input.title?.trim();\n  return {\n    url,\n    ...(title ? { title: title.slice(0, 200) } : {}),\n    ...(isStageToolId(input.tool) ? { tool: input.tool } : {}),\n  };\n}\n","import {\n  EMBED_MESSAGE_SOURCE,\n  EMBED_PROTOCOL_VERSION,\n  EmbedCaptureOutcome,\n  EmbedEventType,\n} from './embed-protocol';\nimport type { EmbedEvent } from './types';\n\nconst EVENT_TYPES = new Set<string>(Object.values(EmbedEventType));\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n\nfunction isOptionalString(value: unknown): boolean {\n  return value === undefined || typeof value === 'string';\n}\n\nfunction isNullableString(value: unknown): boolean {\n  return value === null || typeof value === 'string';\n}\n\nconst CAPTURE_OUTCOMES = new Set<string>(Object.values(EmbedCaptureOutcome));\n\nfunction isCaptureOutcome(value: unknown): boolean {\n  return typeof value === 'string' && CAPTURE_OUTCOMES.has(value);\n}\n\nfunction hasValidPayload(\n  type: EmbedEventType,\n  payload: Record<string, unknown>,\n): boolean {\n  switch (type) {\n    case EmbedEventType.READY:\n      return typeof payload.roomSlug === 'string';\n    case EmbedEventType.JOINED:\n      return (\n        typeof payload.roomSlug === 'string' &&\n        typeof payload.identity === 'string' &&\n        isOptionalString(payload.name) &&\n        typeof payload.joinedAt === 'string'\n      );\n    case EmbedEventType.LEFT:\n      return (\n        typeof payload.roomSlug === 'string' &&\n        typeof payload.identity === 'string' &&\n        typeof payload.leftAt === 'string' &&\n        (payload.durationMs === undefined ||\n          typeof payload.durationMs === 'number')\n      );\n    case EmbedEventType.PARTICIPANT_JOINED:\n      return (\n        typeof payload.identity === 'string' &&\n        isOptionalString(payload.name) &&\n        typeof payload.participantCount === 'number'\n      );\n    case EmbedEventType.PARTICIPANT_LEFT:\n      return (\n        typeof payload.identity === 'string' &&\n        typeof payload.participantCount === 'number'\n      );\n    case EmbedEventType.ENDED:\n      return (\n        typeof payload.roomSlug === 'string' &&\n        typeof payload.endedAt === 'string'\n      );\n    case EmbedEventType.ERROR:\n      return (\n        typeof payload.code === 'string' &&\n        typeof payload.message === 'string'\n      );\n    case EmbedEventType.STAGE_CHANGED:\n      return (\n        (payload.url === null || typeof payload.url === 'string') &&\n        isOptionalString(payload.title) &&\n        isOptionalString(payload.tool) &&\n        isOptionalString(payload.openedBy)\n      );\n    case EmbedEventType.TRANSCRIPT_STARTED:\n      return (\n        typeof payload.roomSlug === 'string' &&\n        isCaptureOutcome(payload.outcome) &&\n        isNullableString(payload.transcriptId) &&\n        isNullableString(payload.status)\n      );\n    case EmbedEventType.RECORDING_STARTED:\n      return (\n        typeof payload.roomSlug === 'string' &&\n        isCaptureOutcome(payload.outcome) &&\n        isNullableString(payload.recordingId) &&\n        isNullableString(payload.status)\n      );\n  }\n}\n\nexport function parseEmbedEvent(data: unknown): EmbedEvent | null {\n  if (!isRecord(data)) return null;\n  if (\n    data.source !== EMBED_MESSAGE_SOURCE ||\n    data.version !== EMBED_PROTOCOL_VERSION ||\n    typeof data.instanceId !== 'string' ||\n    data.instanceId.length === 0 ||\n    typeof data.type !== 'string' ||\n    !EVENT_TYPES.has(data.type) ||\n    !isRecord(data.payload)\n  ) {\n    return null;\n  }\n\n  const type = data.type as EmbedEventType;\n  if (!hasValidPayload(type, data.payload)) return null;\n  return data as unknown as EmbedEvent;\n}\n"],"mappings":"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","names":["import_react","EmbedEventType","EmbedCommandType","EmbedCommandAction","EmbedErrorCode","EmbedQueryParam","EmbedCaptureOutcome","OeMeeting"]}

package/dist/index.d.cts

@@ -12,7 +12,9 @@ declare enum EmbedEventType {
     PARTICIPANT_LEFT = "oemeeting:participant-left",
     ENDED = "oemeeting:ended",
     ERROR = "oemeeting:error",
-    STAGE_CHANGED = "oemeeting:stage-changed"
+    STAGE_CHANGED = "oemeeting:stage-changed",
+    TRANSCRIPT_STARTED = "oemeeting:transcript-started",
+    RECORDING_STARTED = "oemeeting:recording-started"
 }
 declare enum EmbedCommandType {
     COMMAND = "oemeeting:command"
@@ -33,6 +35,8 @@ declare enum EmbedErrorCode {
     PROTOCOL_MISMATCH = "PROTOCOL_MISMATCH",
     STAGE_ORIGIN_DENIED = "STAGE_ORIGIN_DENIED",
     STAGE_URL_INVALID = "STAGE_URL_INVALID",
+    TRANSCRIPT_START_FAILED = "TRANSCRIPT_START_FAILED",
+    RECORDING_START_FAILED = "RECORDING_START_FAILED",
     UNKNOWN = "UNKNOWN"
 }
 /** Open host-owned tool id. Meeting does not catalog values. */
@@ -48,7 +52,23 @@ declare enum EmbedQueryParam {
     EXTERNAL_USER_ID = "externalUserId",
     LANG = "lang",
     AUTO_JOIN = "autoJoin",
-    HIDE_LEAVE = "hideLeave"
+    HIDE_LEAVE = "hideLeave",
+    AUTO_TRANSCRIBE = "autoTranscribe",
+    AUTO_RECORD = "autoRecord"
+}
+/**
+ * What happened to the auto-transcribe request the embed made.
+ *
+ * `ALREADY_RUNNING` is the normal outcome for every participant after the
+ * first, because the transcript is a room-level asset rather than a
+ * per-participant one. `DISABLED` means the OE Meeting deployment has
+ * transcription turned off.
+ */
+declare enum EmbedCaptureOutcome {
+    STARTED = "started",
+    ALREADY_RUNNING = "already_running",
+    DISABLED = "disabled",
+    FAILED = "failed"
 }
 
 interface EmbedMessageBase {
@@ -94,6 +114,27 @@ interface EmbedStageChangedPayload {
     tool?: StageToolId;
     openedBy?: string;
 }
+/**
+ * Reported once per meeting when `autoTranscribe` is set. Use `roomSlug` to
+ * fetch the transcript from your backend once the meeting ends.
+ *
+ * `transcriptId` is null when nothing was started (`DISABLED` or `FAILED`);
+ * pair a `FAILED` outcome with the `TRANSCRIPT_START_FAILED` error event for
+ * the reason.
+ */
+interface EmbedTranscriptStartedPayload {
+    roomSlug: string;
+    outcome: EmbedCaptureOutcome;
+    transcriptId: string | null;
+    status: string | null;
+}
+/** Reported after the embed handles an `autoRecord` request. */
+interface EmbedRecordingStartedPayload {
+    roomSlug: string;
+    outcome: EmbedCaptureOutcome;
+    recordingId: string | null;
+    status: string | null;
+}
 interface OpenStageInput {
     url: string;
     title?: string;
@@ -108,6 +149,8 @@ type EmbedEventPayloadMap = {
     [EmbedEventType.ENDED]: EmbedEndedPayload;
     [EmbedEventType.ERROR]: EmbedErrorPayload;
     [EmbedEventType.STAGE_CHANGED]: EmbedStageChangedPayload;
+    [EmbedEventType.TRANSCRIPT_STARTED]: EmbedTranscriptStartedPayload;
+    [EmbedEventType.RECORDING_STARTED]: EmbedRecordingStartedPayload;
 };
 type EmbedEventByType<T extends EmbedEventType> = EmbedMessageBase & {
     type: T;
@@ -141,6 +184,15 @@ interface OeMeetingProps {
     lang?: string;
     autoJoin?: boolean;
     hideLeave?: boolean;
+    /**
+     * Start the shared transcript as soon as the embed connects. The transcript
+     * is a room-level asset: the first participant to connect starts it and it
+     * keeps running after they leave. Retrieve it afterwards from your backend
+     * with `GET /external-api/v1.0/rooms/:idOrSlug/transcript`.
+     */
+    autoTranscribe?: boolean;
+    /** Start the shared room recording as soon as the embed connects. */
+    autoRecord?: boolean;
     title?: string;
     width?: number | string;
     height?: number | string;
@@ -158,6 +210,8 @@ interface OeMeetingProps {
     onEnded?: (event: EmbedEventOf<EmbedEventType.ENDED>) => void;
     onError?: (event: EmbedEventOf<EmbedEventType.ERROR>) => void;
     onStageChanged?: (event: EmbedEventOf<EmbedEventType.STAGE_CHANGED>) => void;
+    onTranscriptStarted?: (event: EmbedEventOf<EmbedEventType.TRANSCRIPT_STARTED>) => void;
+    onRecordingStarted?: (event: EmbedEventOf<EmbedEventType.RECORDING_STARTED>) => void;
     onEvent?: (event: EmbedEvent) => void;
 }
 interface BuildEmbedUrlOptions {
@@ -169,6 +223,8 @@ interface BuildEmbedUrlOptions {
     lang?: string;
     autoJoin?: boolean;
     hideLeave?: boolean;
+    autoTranscribe?: boolean;
+    autoRecord?: boolean;
     instanceId?: string;
     hostOrigin?: string;
 }
@@ -176,7 +232,7 @@ interface BuildEmbedUrlOptions {
 declare const DEFAULT_IFRAME_ALLOW = "camera; microphone; fullscreen; autoplay; display-capture; clipboard-write; encrypted-media";
 declare const OeMeeting: react.ForwardRefExoticComponent<OeMeetingProps & react.RefAttributes<OeMeetingHandle>>;
 
-type UseOeMeetingOptions = Pick<OeMeetingProps, 'onReady' | 'onJoined' | 'onLeft' | 'onParticipantJoined' | 'onParticipantLeft' | 'onEnded' | 'onError' | 'onStageChanged' | 'onEvent'> & {
+type UseOeMeetingOptions = Pick<OeMeetingProps, 'onReady' | 'onJoined' | 'onLeft' | 'onParticipantJoined' | 'onParticipantLeft' | 'onEnded' | 'onError' | 'onStageChanged' | 'onTranscriptStarted' | 'onRecordingStarted' | 'onEvent'> & {
     instanceId: string;
     targetOrigin: string;
     handleRef?: Ref<OeMeetingHandle>;
@@ -193,4 +249,4 @@ declare function parseEmbedEvent(data: unknown): EmbedEvent | null;
 declare function isValidStageUrl(url: string): boolean;
 declare function normalizeOpenStageInput(input: OpenStageInput): OpenStageInput | null;
 
-export { type BuildEmbedUrlOptions, DEFAULT_EMBED_ORIGIN, DEFAULT_IFRAME_ALLOW, EMBED_MESSAGE_SOURCE, EMBED_PROTOCOL_VERSION, 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 };
+export { type BuildEmbedUrlOptions, DEFAULT_EMBED_ORIGIN, DEFAULT_IFRAME_ALLOW, EMBED_MESSAGE_SOURCE, EMBED_PROTOCOL_VERSION, EmbedCaptureOutcome, EmbedCommandAction, type EmbedCommandMessage, EmbedCommandType, type EmbedEndedPayload, EmbedErrorCode, type EmbedErrorPayload, type EmbedEvent, type EmbedEventOf, type EmbedEventPayloadMap, EmbedEventType, type EmbedJoinedPayload, type EmbedLeftPayload, type EmbedMessageBase, type EmbedParticipantJoinedPayload, type EmbedParticipantLeftPayload, EmbedQueryParam, type EmbedReadyPayload, type EmbedRecordingStartedPayload, type EmbedStageChangedPayload, type EmbedTranscriptStartedPayload, MAX_STAGE_TOOL_ID_LENGTH, MAX_STAGE_URL_LENGTH, OeMeeting, type OeMeetingHandle, type OeMeetingProps, type OpenStageInput, type StageToolId, buildEmbedUrl, isStageToolId, isValidStageUrl, normalizeOpenStageInput, parseEmbedEvent, useOeMeeting };

package/dist/index.d.ts

@@ -12,7 +12,9 @@ declare enum EmbedEventType {
     PARTICIPANT_LEFT = "oemeeting:participant-left",
     ENDED = "oemeeting:ended",
     ERROR = "oemeeting:error",
-    STAGE_CHANGED = "oemeeting:stage-changed"
+    STAGE_CHANGED = "oemeeting:stage-changed",
+    TRANSCRIPT_STARTED = "oemeeting:transcript-started",
+    RECORDING_STARTED = "oemeeting:recording-started"
 }
 declare enum EmbedCommandType {
     COMMAND = "oemeeting:command"
@@ -33,6 +35,8 @@ declare enum EmbedErrorCode {
     PROTOCOL_MISMATCH = "PROTOCOL_MISMATCH",
     STAGE_ORIGIN_DENIED = "STAGE_ORIGIN_DENIED",
     STAGE_URL_INVALID = "STAGE_URL_INVALID",
+    TRANSCRIPT_START_FAILED = "TRANSCRIPT_START_FAILED",
+    RECORDING_START_FAILED = "RECORDING_START_FAILED",
     UNKNOWN = "UNKNOWN"
 }
 /** Open host-owned tool id. Meeting does not catalog values. */
@@ -48,7 +52,23 @@ declare enum EmbedQueryParam {
     EXTERNAL_USER_ID = "externalUserId",
     LANG = "lang",
     AUTO_JOIN = "autoJoin",
-    HIDE_LEAVE = "hideLeave"
+    HIDE_LEAVE = "hideLeave",
+    AUTO_TRANSCRIBE = "autoTranscribe",
+    AUTO_RECORD = "autoRecord"
+}
+/**
+ * What happened to the auto-transcribe request the embed made.
+ *
+ * `ALREADY_RUNNING` is the normal outcome for every participant after the
+ * first, because the transcript is a room-level asset rather than a
+ * per-participant one. `DISABLED` means the OE Meeting deployment has
+ * transcription turned off.
+ */
+declare enum EmbedCaptureOutcome {
+    STARTED = "started",
+    ALREADY_RUNNING = "already_running",
+    DISABLED = "disabled",
+    FAILED = "failed"
 }
 
 interface EmbedMessageBase {
@@ -94,6 +114,27 @@ interface EmbedStageChangedPayload {
     tool?: StageToolId;
     openedBy?: string;
 }
+/**
+ * Reported once per meeting when `autoTranscribe` is set. Use `roomSlug` to
+ * fetch the transcript from your backend once the meeting ends.
+ *
+ * `transcriptId` is null when nothing was started (`DISABLED` or `FAILED`);
+ * pair a `FAILED` outcome with the `TRANSCRIPT_START_FAILED` error event for
+ * the reason.
+ */
+interface EmbedTranscriptStartedPayload {
+    roomSlug: string;
+    outcome: EmbedCaptureOutcome;
+    transcriptId: string | null;
+    status: string | null;
+}
+/** Reported after the embed handles an `autoRecord` request. */
+interface EmbedRecordingStartedPayload {
+    roomSlug: string;
+    outcome: EmbedCaptureOutcome;
+    recordingId: string | null;
+    status: string | null;
+}
 interface OpenStageInput {
     url: string;
     title?: string;
@@ -108,6 +149,8 @@ type EmbedEventPayloadMap = {
     [EmbedEventType.ENDED]: EmbedEndedPayload;
     [EmbedEventType.ERROR]: EmbedErrorPayload;
     [EmbedEventType.STAGE_CHANGED]: EmbedStageChangedPayload;
+    [EmbedEventType.TRANSCRIPT_STARTED]: EmbedTranscriptStartedPayload;
+    [EmbedEventType.RECORDING_STARTED]: EmbedRecordingStartedPayload;
 };
 type EmbedEventByType<T extends EmbedEventType> = EmbedMessageBase & {
     type: T;
@@ -141,6 +184,15 @@ interface OeMeetingProps {
     lang?: string;
     autoJoin?: boolean;
     hideLeave?: boolean;
+    /**
+     * Start the shared transcript as soon as the embed connects. The transcript
+     * is a room-level asset: the first participant to connect starts it and it
+     * keeps running after they leave. Retrieve it afterwards from your backend
+     * with `GET /external-api/v1.0/rooms/:idOrSlug/transcript`.
+     */
+    autoTranscribe?: boolean;
+    /** Start the shared room recording as soon as the embed connects. */
+    autoRecord?: boolean;
     title?: string;
     width?: number | string;
     height?: number | string;
@@ -158,6 +210,8 @@ interface OeMeetingProps {
     onEnded?: (event: EmbedEventOf<EmbedEventType.ENDED>) => void;
     onError?: (event: EmbedEventOf<EmbedEventType.ERROR>) => void;
     onStageChanged?: (event: EmbedEventOf<EmbedEventType.STAGE_CHANGED>) => void;
+    onTranscriptStarted?: (event: EmbedEventOf<EmbedEventType.TRANSCRIPT_STARTED>) => void;
+    onRecordingStarted?: (event: EmbedEventOf<EmbedEventType.RECORDING_STARTED>) => void;
     onEvent?: (event: EmbedEvent) => void;
 }
 interface BuildEmbedUrlOptions {
@@ -169,6 +223,8 @@ interface BuildEmbedUrlOptions {
     lang?: string;
     autoJoin?: boolean;
     hideLeave?: boolean;
+    autoTranscribe?: boolean;
+    autoRecord?: boolean;
     instanceId?: string;
     hostOrigin?: string;
 }
@@ -176,7 +232,7 @@ interface BuildEmbedUrlOptions {
 declare const DEFAULT_IFRAME_ALLOW = "camera; microphone; fullscreen; autoplay; display-capture; clipboard-write; encrypted-media";
 declare const OeMeeting: react.ForwardRefExoticComponent<OeMeetingProps & react.RefAttributes<OeMeetingHandle>>;
 
-type UseOeMeetingOptions = Pick<OeMeetingProps, 'onReady' | 'onJoined' | 'onLeft' | 'onParticipantJoined' | 'onParticipantLeft' | 'onEnded' | 'onError' | 'onStageChanged' | 'onEvent'> & {
+type UseOeMeetingOptions = Pick<OeMeetingProps, 'onReady' | 'onJoined' | 'onLeft' | 'onParticipantJoined' | 'onParticipantLeft' | 'onEnded' | 'onError' | 'onStageChanged' | 'onTranscriptStarted' | 'onRecordingStarted' | 'onEvent'> & {
     instanceId: string;
     targetOrigin: string;
     handleRef?: Ref<OeMeetingHandle>;
@@ -193,4 +249,4 @@ declare function parseEmbedEvent(data: unknown): EmbedEvent | null;
 declare function isValidStageUrl(url: string): boolean;
 declare function normalizeOpenStageInput(input: OpenStageInput): OpenStageInput | null;
 
-export { type BuildEmbedUrlOptions, DEFAULT_EMBED_ORIGIN, DEFAULT_IFRAME_ALLOW, EMBED_MESSAGE_SOURCE, EMBED_PROTOCOL_VERSION, 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 };
+export { type BuildEmbedUrlOptions, DEFAULT_EMBED_ORIGIN, DEFAULT_IFRAME_ALLOW, EMBED_MESSAGE_SOURCE, EMBED_PROTOCOL_VERSION, EmbedCaptureOutcome, EmbedCommandAction, type EmbedCommandMessage, EmbedCommandType, type EmbedEndedPayload, EmbedErrorCode, type EmbedErrorPayload, type EmbedEvent, type EmbedEventOf, type EmbedEventPayloadMap, EmbedEventType, type EmbedJoinedPayload, type EmbedLeftPayload, type EmbedMessageBase, type EmbedParticipantJoinedPayload, type EmbedParticipantLeftPayload, EmbedQueryParam, type EmbedReadyPayload, type EmbedRecordingStartedPayload, type EmbedStageChangedPayload, type EmbedTranscriptStartedPayload, MAX_STAGE_TOOL_ID_LENGTH, MAX_STAGE_URL_LENGTH, OeMeeting, type OeMeetingHandle, type OeMeetingProps, type OpenStageInput, type StageToolId, buildEmbedUrl, isStageToolId, isValidStageUrl, normalizeOpenStageInput, parseEmbedEvent, useOeMeeting };

package/dist/index.js

@@ -18,6 +18,8 @@ var EmbedEventType = /* @__PURE__ */ ((EmbedEventType2) => {
   EmbedEventType2["ENDED"] = "oemeeting:ended";
   EmbedEventType2["ERROR"] = "oemeeting:error";
   EmbedEventType2["STAGE_CHANGED"] = "oemeeting:stage-changed";
+  EmbedEventType2["TRANSCRIPT_STARTED"] = "oemeeting:transcript-started";
+  EmbedEventType2["RECORDING_STARTED"] = "oemeeting:recording-started";
   return EmbedEventType2;
 })(EmbedEventType || {});
 var EmbedCommandType = /* @__PURE__ */ ((EmbedCommandType2) => {
@@ -41,6 +43,8 @@ var EmbedErrorCode = /* @__PURE__ */ ((EmbedErrorCode2) => {
   EmbedErrorCode2["PROTOCOL_MISMATCH"] = "PROTOCOL_MISMATCH";
   EmbedErrorCode2["STAGE_ORIGIN_DENIED"] = "STAGE_ORIGIN_DENIED";
   EmbedErrorCode2["STAGE_URL_INVALID"] = "STAGE_URL_INVALID";
+  EmbedErrorCode2["TRANSCRIPT_START_FAILED"] = "TRANSCRIPT_START_FAILED";
+  EmbedErrorCode2["RECORDING_START_FAILED"] = "RECORDING_START_FAILED";
   EmbedErrorCode2["UNKNOWN"] = "UNKNOWN";
   return EmbedErrorCode2;
 })(EmbedErrorCode || {});
@@ -59,8 +63,17 @@ var EmbedQueryParam = /* @__PURE__ */ ((EmbedQueryParam2) => {
   EmbedQueryParam2["LANG"] = "lang";
   EmbedQueryParam2["AUTO_JOIN"] = "autoJoin";
   EmbedQueryParam2["HIDE_LEAVE"] = "hideLeave";
+  EmbedQueryParam2["AUTO_TRANSCRIBE"] = "autoTranscribe";
+  EmbedQueryParam2["AUTO_RECORD"] = "autoRecord";
   return EmbedQueryParam2;
 })(EmbedQueryParam || {});
+var EmbedCaptureOutcome = /* @__PURE__ */ ((EmbedCaptureOutcome2) => {
+  EmbedCaptureOutcome2["STARTED"] = "started";
+  EmbedCaptureOutcome2["ALREADY_RUNNING"] = "already_running";
+  EmbedCaptureOutcome2["DISABLED"] = "disabled";
+  EmbedCaptureOutcome2["FAILED"] = "failed";
+  return EmbedCaptureOutcome2;
+})(EmbedCaptureOutcome || {});
 
 // src/buildEmbedUrl.ts
 var QUERY_FLAG_ENABLED = "1";
@@ -91,7 +104,9 @@ function buildEmbedUrl(options) {
     ["externalUserId" /* EXTERNAL_USER_ID */, options.externalUserId],
     ["lang" /* LANG */, options.lang],
     ["autoJoin" /* AUTO_JOIN */, toFlag(options.autoJoin)],
-    ["hideLeave" /* HIDE_LEAVE */, toFlag(options.hideLeave)]
+    ["hideLeave" /* HIDE_LEAVE */, toFlag(options.hideLeave)],
+    ["autoTranscribe" /* AUTO_TRANSCRIBE */, toFlag(options.autoTranscribe)],
+    ["autoRecord" /* AUTO_RECORD */, toFlag(options.autoRecord)]
   ];
   for (const [key, value] of entries) {
     if (value !== void 0 && value !== "") {
@@ -143,6 +158,13 @@ function isRecord(value) {
 function isOptionalString(value) {
   return value === void 0 || typeof value === "string";
 }
+function isNullableString(value) {
+  return value === null || typeof value === "string";
+}
+var CAPTURE_OUTCOMES = new Set(Object.values(EmbedCaptureOutcome));
+function isCaptureOutcome(value) {
+  return typeof value === "string" && CAPTURE_OUTCOMES.has(value);
+}
 function hasValidPayload(type, payload) {
   switch (type) {
     case "oemeeting:ready" /* READY */:
@@ -161,6 +183,10 @@ function hasValidPayload(type, payload) {
       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);
+    case "oemeeting:transcript-started" /* TRANSCRIPT_STARTED */:
+      return typeof payload.roomSlug === "string" && isCaptureOutcome(payload.outcome) && isNullableString(payload.transcriptId) && isNullableString(payload.status);
+    case "oemeeting:recording-started" /* RECORDING_STARTED */:
+      return typeof payload.roomSlug === "string" && isCaptureOutcome(payload.outcome) && isNullableString(payload.recordingId) && isNullableString(payload.status);
   }
 }
 function parseEmbedEvent(data) {
@@ -228,6 +254,12 @@ function useOeMeeting(options) {
         case "oemeeting:stage-changed" /* STAGE_CHANGED */:
           callbacks.onStageChanged?.(embedEvent);
           break;
+        case "oemeeting:transcript-started" /* TRANSCRIPT_STARTED */:
+          callbacks.onTranscriptStarted?.(embedEvent);
+          break;
+        case "oemeeting:recording-started" /* RECORDING_STARTED */:
+          callbacks.onRecordingStarted?.(embedEvent);
+          break;
       }
     };
     window.addEventListener("message", onMessage);
@@ -301,6 +333,8 @@ var OeMeeting = forwardRef(
       lang,
       autoJoin = true,
       hideLeave,
+      autoTranscribe,
+      autoRecord,
       title = "OE Meeting room",
       width = "100%",
       height = 640,
@@ -318,6 +352,8 @@ var OeMeeting = forwardRef(
       onEnded,
       onError,
       onStageChanged,
+      onTranscriptStarted,
+      onRecordingStarted,
       onEvent
     } = props;
     const reactId = useId();
@@ -338,11 +374,15 @@ var OeMeeting = forwardRef(
         lang,
         autoJoin,
         hideLeave,
+        autoTranscribe,
+        autoRecord,
         instanceId,
         hostOrigin
       }),
       [
         autoJoin,
+        autoRecord,
+        autoTranscribe,
         externalUserId,
         hideLeave,
         hostOrigin,
@@ -366,6 +406,8 @@ var OeMeeting = forwardRef(
       onEnded,
       onError,
       onStageChanged,
+      onTranscriptStarted,
+      onRecordingStarted,
       onEvent
     });
     const wrapperStyle = {
@@ -409,6 +451,7 @@ export {
   DEFAULT_IFRAME_ALLOW,
   EMBED_MESSAGE_SOURCE,
   EMBED_PROTOCOL_VERSION,
+  EmbedCaptureOutcome,
   EmbedCommandAction,
   EmbedCommandType,
   EmbedErrorCode,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/OeMeeting.tsx","../src/embed-protocol.ts","../src/buildEmbedUrl.ts","../src/useOeMeeting.ts","../src/openStage.ts","../src/parseEmbedEvent.ts"],"sourcesContent":["'use client';\n\nimport {\n  forwardRef,\n  useId,\n  useMemo,\n  type CSSProperties,\n} from 'react';\nimport { buildEmbedUrl } from './buildEmbedUrl';\nimport { DEFAULT_EMBED_ORIGIN } from './embed-protocol';\nimport type { OeMeetingHandle, OeMeetingProps } from './types';\nimport { useOeMeeting } from './useOeMeeting';\n\nexport const DEFAULT_IFRAME_ALLOW =\n  'camera; microphone; fullscreen; autoplay; display-capture; clipboard-write; encrypted-media';\n\nfunction toCssSize(value: number | string | undefined): string | undefined {\n  if (value === undefined) return undefined;\n  return typeof value === 'number' ? `${value}px` : value;\n}\n\nfunction getOrigin(value: string): string {\n  return new URL(value).origin;\n}\n\nexport const OeMeeting = forwardRef<OeMeetingHandle, OeMeetingProps>(\n  function OeMeeting(props, ref) {\n    const {\n      roomSlug,\n      joinToken,\n      userName,\n      externalUserId,\n      origin = DEFAULT_EMBED_ORIGIN,\n      lang,\n      autoJoin = true,\n      hideLeave,\n      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":";AAEA;AAAA,EACE;AAAA,EACA;AAAA,EACA,WAAAA;AAAA,OAEK;;;ACPA,IAAM,yBAAyB;AAC/B,IAAM,uBAAuB;AAC7B,IAAM,uBAAuB;AAE7B,IAAK,iBAAL,kBAAKC,oBAAL;AACL,EAAAA,gBAAA,WAAQ;AACR,EAAAA,gBAAA,YAAS;AACT,EAAAA,gBAAA,UAAO;AACP,EAAAA,gBAAA,wBAAqB;AACrB,EAAAA,gBAAA,sBAAmB;AACnB,EAAAA,gBAAA,WAAQ;AACR,EAAAA,gBAAA,WAAQ;AACR,EAAAA,gBAAA,mBAAgB;AARN,SAAAA;AAAA,GAAA;AAWL,IAAK,mBAAL,kBAAKC,sBAAL;AACL,EAAAA,kBAAA,aAAU;AADA,SAAAA;AAAA,GAAA;AAIL,IAAK,qBAAL,kBAAKC,wBAAL;AACL,EAAAA,oBAAA,WAAQ;AACR,EAAAA,oBAAA,gBAAa;AACb,EAAAA,oBAAA,mBAAgB;AAChB,EAAAA,oBAAA,gBAAa;AACb,EAAAA,oBAAA,iBAAc;AALJ,SAAAA;AAAA,GAAA;AAQL,IAAK,iBAAL,kBAAKC,oBAAL;AACL,EAAAA,gBAAA,mBAAgB;AAChB,EAAAA,gBAAA,mBAAgB;AAChB,EAAAA,gBAAA,oBAAiB;AACjB,EAAAA,gBAAA,wBAAqB;AACrB,EAAAA,gBAAA,uBAAoB;AACpB,EAAAA,gBAAA,uBAAoB;AACpB,EAAAA,gBAAA,yBAAsB;AACtB,EAAAA,gBAAA,uBAAoB;AACpB,EAAAA,gBAAA,aAAU;AATA,SAAAA;AAAA,GAAA;AAeL,IAAM,uBAAuB;AAC7B,IAAM,2BAA2B;AAExC,IAAM,wBAAwB;AAEvB,SAAS,cAAc,OAAsC;AAClE,SACE,OAAO,UAAU,YACjB,MAAM,SAAS,KACf,MAAM,UAAU,4BAChB,sBAAsB,KAAK,KAAK;AAEpC;AAEO,IAAK,kBAAL,kBAAKC,qBAAL;AACL,EAAAA,iBAAA,iBAAc;AACd,EAAAA,iBAAA,iBAAc;AACd,EAAAA,iBAAA,gBAAa;AACb,EAAAA,iBAAA,eAAY;AACZ,EAAAA,iBAAA,sBAAmB;AACnB,EAAAA,iBAAA,UAAO;AACP,EAAAA,iBAAA,eAAY;AACZ,EAAAA,iBAAA,gBAAa;AARH,SAAAA;AAAA,GAAA;;;AClDZ,IAAM,qBAAqB;AAC3B,IAAM,sBAAsB;AAE5B,SAAS,OAAO,OAAgD;AAC9D,MAAI,UAAU,OAAW,QAAO;AAChC,SAAO,QAAQ,qBAAqB;AACtC;AAEA,SAAS,gBAAgB,QAAwB;AAC/C,SAAO,OAAO,QAAQ,QAAQ,EAAE;AAClC;AAEO,SAAS,cAAc,SAAuC;AACnE,QAAM,WAAW,QAAQ,SAAS,KAAK;AACvC,QAAM,YAAY,QAAQ,UAAU,KAAK;AACzC,MAAI,CAAC,UAAU;AACb,UAAM,IAAI,MAAM,iDAAiD;AAAA,EACnE;AACA,MAAI,CAAC,WAAW;AACd,UAAM,IAAI,MAAM,kDAAkD;AAAA,EACpE;AAEA,QAAM,SAAS,gBAAgB,QAAQ,UAAU,oBAAoB;AACrE,QAAM,MAAM,IAAI,IAAI,GAAG,MAAM,UAAU,mBAAmB,QAAQ,CAAC,EAAE;AACrE,QAAM,UAAwD;AAAA,IAC5D,iCAA8B,QAAQ,UAAU;AAAA,IAChD,iCAA8B,QAAQ,UAAU;AAAA,IAChD,+BAA6B,SAAS;AAAA,IACtC,6BAA4B,QAAQ,QAAQ;AAAA,IAC5C,0CAAmC,QAAQ,cAAc;AAAA,IACzD,oBAAuB,QAAQ,IAAI;AAAA,IACnC,6BAA4B,OAAO,QAAQ,QAAQ,CAAC;AAAA,IACpD,+BAA6B,OAAO,QAAQ,SAAS,CAAC;AAAA,EACxD;AAEA,aAAW,CAAC,KAAK,KAAK,KAAK,SAAS;AAClC,QAAI,UAAU,UAAa,UAAU,IAAI;AACvC,UAAI,aAAa,IAAI,KAAK,KAAK;AAAA,IACjC;AAAA,EACF;AACA,SAAO,IAAI,SAAS;AACtB;;;AC/CA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;;;ACJA,SAAS,gBAAgB,KAAsB;AACpD,MAAI,IAAI,WAAW,KAAK,IAAI,SAAS,qBAAsB,QAAO;AAClE,MAAI;AACF,UAAM,SAAS,IAAI,IAAI,GAAG;AAC1B,QAAI,OAAO,aAAa,SAAU,QAAO;AACzC,QAAI,OAAO,aAAa,SAAS;AAC/B,aACE,OAAO,aAAa,eAAe,OAAO,aAAa;AAAA,IAE3D;AACA,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEO,SAAS,wBACd,OACuB;AACvB,QAAM,MAAM,MAAM,IAAI,KAAK;AAC3B,MAAI,CAAC,gBAAgB,GAAG,EAAG,QAAO;AAClC,QAAM,QAAQ,MAAM,OAAO,KAAK;AAChC,SAAO;AAAA,IACL;AAAA,IACA,GAAI,QAAQ,EAAE,OAAO,MAAM,MAAM,GAAG,GAAG,EAAE,IAAI,CAAC;AAAA,IAC9C,GAAI,cAAc,MAAM,IAAI,IAAI,EAAE,MAAM,MAAM,KAAK,IAAI,CAAC;AAAA,EAC1D;AACF;;;ACvBA,IAAM,cAAc,IAAI,IAAY,OAAO,OAAO,cAAc,CAAC;AAEjE,SAAS,SAAS,OAAkD;AAClE,SAAO,OAAO,UAAU,YAAY,UAAU;AAChD;AAEA,SAAS,iBAAiB,OAAyB;AACjD,SAAO,UAAU,UAAa,OAAO,UAAU;AACjD;AAEA,SAAS,gBACP,MACA,SACS;AACT,UAAQ,MAAM;AAAA,IACZ;AACE,aAAO,OAAO,QAAQ,aAAa;AAAA,IACrC;AACE,aACE,OAAO,QAAQ,aAAa,YAC5B,OAAO,QAAQ,aAAa,YAC5B,iBAAiB,QAAQ,IAAI,KAC7B,OAAO,QAAQ,aAAa;AAAA,IAEhC;AACE,aACE,OAAO,QAAQ,aAAa,YAC5B,OAAO,QAAQ,aAAa,YAC5B,OAAO,QAAQ,WAAW,aACzB,QAAQ,eAAe,UACtB,OAAO,QAAQ,eAAe;AAAA,IAEpC;AACE,aACE,OAAO,QAAQ,aAAa,YAC5B,iBAAiB,QAAQ,IAAI,KAC7B,OAAO,QAAQ,qBAAqB;AAAA,IAExC;AACE,aACE,OAAO,QAAQ,aAAa,YAC5B,OAAO,QAAQ,qBAAqB;AAAA,IAExC;AACE,aACE,OAAO,QAAQ,aAAa,YAC5B,OAAO,QAAQ,YAAY;AAAA,IAE/B;AACE,aACE,OAAO,QAAQ,SAAS,YACxB,OAAO,QAAQ,YAAY;AAAA,IAE/B;AACE,cACG,QAAQ,QAAQ,QAAQ,OAAO,QAAQ,QAAQ,aAChD,iBAAiB,QAAQ,KAAK,KAC9B,iBAAiB,QAAQ,IAAI,KAC7B,iBAAiB,QAAQ,QAAQ;AAAA,EAEvC;AACF;AAEO,SAAS,gBAAgB,MAAkC;AAChE,MAAI,CAAC,SAAS,IAAI,EAAG,QAAO;AAC5B,MACE,KAAK,WAAW,wBAChB,KAAK,YAAY,0BACjB,OAAO,KAAK,eAAe,YAC3B,KAAK,WAAW,WAAW,KAC3B,OAAO,KAAK,SAAS,YACrB,CAAC,YAAY,IAAI,KAAK,IAAI,KAC1B,CAAC,SAAS,KAAK,OAAO,GACtB;AACA,WAAO;AAAA,EACT;AAEA,QAAM,OAAO,KAAK;AAClB,MAAI,CAAC,gBAAgB,MAAM,KAAK,OAAO,EAAG,QAAO;AACjD,SAAO;AACT;;;AFtCA,SAAS,YAAY,SAAmC;AACtD,QAAM,cAAc,QAAQ,QAAQ;AACpC,MAAI,CAAC,YAAa;AAClB,QAAM,UAA+B;AAAA,IACnC,QAAQ;AAAA,IACR,SAAS;AAAA,IACT,YAAY,QAAQ;AAAA,IACpB;AAAA,IACA,QAAQ,QAAQ;AAAA,IAChB,GAAI,QAAQ,UAAU,EAAE,SAAS,QAAQ,QAAQ,IAAI,CAAC;AAAA,EACxD;AACA,cAAY,YAAY,SAAS,QAAQ,YAAY;AACvD;AAEO,SAAS,aAAa,SAA8B;AACzD,QAAM,YAAY,OAAiC,IAAI;AACvD,QAAM,eAAe,OAAO,OAAO;AAEnC,YAAU,MAAM;AACd,iBAAa,UAAU;AAAA,EACzB,GAAG,CAAC,OAAO,CAAC;AAEZ,YAAU,MAAM;AACd,UAAM,YAAY,CAAC,UAAiC;AAClD,YAAM,cAAc,UAAU,SAAS;AACvC,UACE,CAAC,eACD,MAAM,WAAW,eACjB,MAAM,WAAW,QAAQ,cACzB;AACA;AAAA,MACF;AACA,YAAM,aAAa,gBAAgB,MAAM,IAAI;AAC7C,UAAI,CAAC,cAAc,WAAW,eAAe,QAAQ,WAAY;AAEjE,YAAM,YAAY,aAAa;AAC/B,gBAAU,UAAU,UAAU;AAC9B,cAAQ,WAAW,MAAM;AAAA,QACvB;AACE,oBAAU,UAAU,UAAU;AAC9B;AAAA,QACF;AACE,oBAAU,WAAW,UAAU;AAC/B;AAAA,QACF;AACE,oBAAU,SAAS,UAAU;AAC7B;AAAA,QACF;AACE,oBAAU,sBAAsB,UAAU;AAC1C;AAAA,QACF;AACE,oBAAU,oBAAoB,UAAU;AACxC;AAAA,QACF;AACE,oBAAU,UAAU,UAAU;AAC9B;AAAA,QACF;AACE,oBAAU,UAAU,UAAU;AAC9B;AAAA,QACF;AACE,oBAAU,iBAAiB,UAAU;AACrC;AAAA,MACJ;AAAA,IACF;AAEA,WAAO,iBAAiB,WAAW,SAAS;AAC5C,WAAO,MAAM,OAAO,oBAAoB,WAAW,SAAS;AAAA,EAC9D,GAAG,CAAC,QAAQ,YAAY,QAAQ,YAAY,CAAC;AAE7C,QAAM,OAAO;AAAA,IACX,CAAC,QAA4B,YAC3B,YAAY;AAAA,MACV,QAAQ,UAAU;AAAA,MAClB,YAAY,QAAQ;AAAA,MACpB;AAAA,MACA,cAAc,QAAQ;AAAA,MACtB;AAAA,IACF,CAAC;AAAA,IACH,CAAC,QAAQ,YAAY,QAAQ,YAAY;AAAA,EAC3C;AACA,QAAM,QAAQ,YAAY,MAAM,wBAA6B,GAAG,CAAC,IAAI,CAAC;AACtE,QAAM,YAAY;AAAA,IAChB,MAAM,iCAAkC;AAAA,IACxC,CAAC,IAAI;AAAA,EACP;AACA,QAAM,eAAe;AAAA,IACnB,MAAM,uCAAqC;AAAA,IAC3C,CAAC,IAAI;AAAA,EACP;AACA,QAAM,YAAY;AAAA,IAChB,CAAC,UAA0B;AACzB,YAAM,aAAa,wBAAwB,KAAK;AAChD,UAAI,CAAC,WAAY;AACjB,yCAAoC,UAAU;AAAA,IAChD;AAAA,IACA,CAAC,IAAI;AAAA,EACP;AACA,QAAM,aAAa;AAAA,IACjB,MAAM,mCAAmC;AAAA,IACzC,CAAC,IAAI;AAAA,EACP;AACA,QAAM,YAAY,YAAY,MAAM,UAAU,SAAS,CAAC,CAAC;AACzD,QAAM,SAAS;AAAA,IACb,OAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA,CAAC,YAAY,WAAW,OAAO,WAAW,cAAc,SAAS;AAAA,EACnE;AAEA,sBAAoB,QAAQ,WAAW,MAAM,QAAQ,CAAC,MAAM,CAAC;AAC7D,SAAO,EAAE,WAAW,OAAO;AAC7B;;;AHzCQ;AA/GD,IAAM,uBACX;AAEF,SAAS,UAAU,OAAwD;AACzE,MAAI,UAAU,OAAW,QAAO;AAChC,SAAO,OAAO,UAAU,WAAW,GAAG,KAAK,OAAO;AACpD;AAEA,SAAS,UAAU,OAAuB;AACxC,SAAO,IAAI,IAAI,KAAK,EAAE;AACxB;AAEO,IAAM,YAAY;AAAA,EACvB,SAASC,WAAU,OAAO,KAAK;AAC7B,UAAM;AAAA,MACJ;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,SAAS;AAAA,MACT;AAAA,MACA,WAAW;AAAA,MACX;AAAA,MACA,QAAQ;AAAA,MACR,QAAQ;AAAA,MACR,SAAS;AAAA,MACT;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,QAAQ;AAAA,MACR;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,IAAI;AACJ,UAAM,UAAU,MAAM;AACtB,UAAM,aAAaC;AAAA,MACjB,MAAM,OAAO,QAAQ,QAAQ,MAAM,EAAE,CAAC;AAAA,MACtC,CAAC,OAAO;AAAA,IACV;AACA,UAAM,cAAcA,SAAQ,MAAM,UAAU,MAAM,GAAG,CAAC,MAAM,CAAC;AAC7D,UAAM,uBAAuB,gBAAgB;AAC7C,UAAM,aACJ,OAAO,WAAW,cAAc,SAAY,OAAO,SAAS;AAC9D,UAAM,MAAMA;AAAA,MACV,MACE,cAAc;AAAA,QACZ;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF,CAAC;AAAA,MACH;AAAA,QACE;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF;AACA,UAAM,EAAE,UAAU,IAAI,aAAa;AAAA,MACjC;AAAA,MACA,cAAc;AAAA,MACd,WAAW;AAAA,MACX;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AACD,UAAM,eAA8B;AAAA,MAClC,OAAO,UAAU,KAAK;AAAA,MACtB,QAAQ,UAAU,MAAM;AAAA,MACxB,GAAG;AAAA,IACL;AACA,UAAM,aAA4B;AAAA,MAChC,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,QAAQ;AAAA,MACR,SAAS;AAAA,MACT,GAAG;AAAA,IACL;AAEA,WACE;AAAA,MAAC;AAAA;AAAA,QACC;AAAA,QACA,OAAO;AAAA,QACP,4BAA0B;AAAA,QAE1B;AAAA,UAAC;AAAA;AAAA,YACC,KAAK;AAAA,YACL,WAAW;AAAA,YACX,OAAO;AAAA,YACP;AAAA,YACA;AAAA,YACA;AAAA,YACA,iBAAe;AAAA,YACf,gBAAe;AAAA;AAAA,QACjB;AAAA;AAAA,IACF;AAAA,EAEJ;AACF;AAEA,UAAU,cAAc;","names":["useMemo","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      autoTranscribe,\n      autoRecord,\n      title = 'OE Meeting room',\n      width = '100%',\n      height = 640,\n      className,\n      style,\n      iframeClassName,\n      iframeStyle,\n      allow = DEFAULT_IFRAME_ALLOW,\n      targetOrigin,\n      onReady,\n      onJoined,\n      onLeft,\n      onParticipantJoined,\n      onParticipantLeft,\n      onEnded,\n      onError,\n      onStageChanged,\n      onTranscriptStarted,\n      onRecordingStarted,\n      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          autoTranscribe,\n          autoRecord,\n          instanceId,\n          hostOrigin,\n        }),\n      [\n        autoJoin,\n        autoRecord,\n        autoTranscribe,\n        externalUserId,\n        hideLeave,\n        hostOrigin,\n        instanceId,\n        joinToken,\n        lang,\n        origin,\n        roomSlug,\n        userName,\n      ],\n    );\n    const { iframeRef } = useOeMeeting({\n      instanceId,\n      targetOrigin: resolvedTargetOrigin,\n      handleRef: ref,\n      onReady,\n      onJoined,\n      onLeft,\n      onParticipantJoined,\n      onParticipantLeft,\n      onEnded,\n      onError,\n      onStageChanged,\n      onTranscriptStarted,\n      onRecordingStarted,\n      onEvent,\n    });\n    const wrapperStyle: CSSProperties = {\n      width: toCssSize(width),\n      height: toCssSize(height),\n      ...style,\n    };\n    const frameStyle: CSSProperties = {\n      width: '100%',\n      height: '100%',\n      border: 0,\n      display: 'block',\n      ...iframeStyle,\n    };\n\n    return (\n      <div\n        className={className}\n        style={wrapperStyle}\n        data-oe-meeting-instance={instanceId}\n      >\n        <iframe\n          ref={iframeRef}\n          className={iframeClassName}\n          style={frameStyle}\n          src={src}\n          title={title}\n          allow={allow}\n          allowFullScreen\n          referrerPolicy=\"strict-origin-when-cross-origin\"\n        />\n      </div>\n    );\n  },\n);\n\nOeMeeting.displayName = 'OeMeeting';\n","export const EMBED_PROTOCOL_VERSION = 1 as const;\nexport const EMBED_MESSAGE_SOURCE = 'oemeeting' as const;\nexport const DEFAULT_EMBED_ORIGIN = 'https://meet.ocean.edu.vn';\n\nexport enum EmbedEventType {\n  READY = 'oemeeting:ready',\n  JOINED = 'oemeeting:joined',\n  LEFT = 'oemeeting:left',\n  PARTICIPANT_JOINED = 'oemeeting:participant-joined',\n  PARTICIPANT_LEFT = 'oemeeting:participant-left',\n  ENDED = 'oemeeting:ended',\n  ERROR = 'oemeeting:error',\n  STAGE_CHANGED = 'oemeeting:stage-changed',\n  TRANSCRIPT_STARTED = 'oemeeting:transcript-started',\n  RECORDING_STARTED = 'oemeeting:recording-started',\n}\n\nexport enum EmbedCommandType {\n  COMMAND = 'oemeeting:command',\n}\n\nexport enum EmbedCommandAction {\n  LEAVE = 'leave',\n  TOGGLE_MIC = 'toggleMic',\n  TOGGLE_CAMERA = 'toggleCamera',\n  OPEN_STAGE = 'openStage',\n  CLOSE_STAGE = 'closeStage',\n}\n\nexport enum EmbedErrorCode {\n  TOKEN_INVALID = 'TOKEN_INVALID',\n  TOKEN_EXPIRED = 'TOKEN_EXPIRED',\n  ROOM_NOT_FOUND = 'ROOM_NOT_FOUND',\n  ROOM_ACCESS_DENIED = 'ROOM_ACCESS_DENIED',\n  CONNECTION_FAILED = 'CONNECTION_FAILED',\n  PROTOCOL_MISMATCH = 'PROTOCOL_MISMATCH',\n  STAGE_ORIGIN_DENIED = 'STAGE_ORIGIN_DENIED',\n  STAGE_URL_INVALID = 'STAGE_URL_INVALID',\n  TRANSCRIPT_START_FAILED = 'TRANSCRIPT_START_FAILED',\n  RECORDING_START_FAILED = 'RECORDING_START_FAILED',\n  UNKNOWN = 'UNKNOWN',\n}\n\n/** Open host-owned tool id. Meeting does not catalog values. */\nexport type StageToolId = string;\n\nexport const MAX_STAGE_URL_LENGTH = 2048;\nexport const MAX_STAGE_TOOL_ID_LENGTH = 32;\n\nconst STAGE_TOOL_ID_PATTERN = /^[a-z][a-z0-9._-]{0,31}$/;\n\nexport function isStageToolId(value: unknown): value is StageToolId {\n  return (\n    typeof value === 'string' &&\n    value.length > 0 &&\n    value.length <= MAX_STAGE_TOOL_ID_LENGTH &&\n    STAGE_TOOL_ID_PATTERN.test(value)\n  );\n}\n\nexport enum EmbedQueryParam {\n  INSTANCE_ID = 'instanceId',\n  HOST_ORIGIN = 'hostOrigin',\n  JOIN_TOKEN = 'joinToken',\n  USER_NAME = 'userName',\n  EXTERNAL_USER_ID = 'externalUserId',\n  LANG = 'lang',\n  AUTO_JOIN = 'autoJoin',\n  HIDE_LEAVE = 'hideLeave',\n  AUTO_TRANSCRIBE = 'autoTranscribe',\n  AUTO_RECORD = 'autoRecord',\n}\n\n/**\n * What happened to the auto-transcribe request the embed made.\n *\n * `ALREADY_RUNNING` is the normal outcome for every participant after the\n * first, because the transcript is a room-level asset rather than a\n * per-participant one. `DISABLED` means the OE Meeting deployment has\n * transcription turned off.\n */\nexport enum EmbedCaptureOutcome {\n  STARTED = 'started',\n  ALREADY_RUNNING = 'already_running',\n  DISABLED = 'disabled',\n  FAILED = 'failed',\n}\n","import {\n  DEFAULT_EMBED_ORIGIN,\n  EmbedQueryParam,\n} from './embed-protocol';\nimport type { BuildEmbedUrlOptions } from './types';\n\nconst QUERY_FLAG_ENABLED = '1';\nconst QUERY_FLAG_DISABLED = '0';\n\nfunction toFlag(value: boolean | undefined): string | undefined {\n  if (value === undefined) return undefined;\n  return value ? QUERY_FLAG_ENABLED : QUERY_FLAG_DISABLED;\n}\n\nfunction normalizeOrigin(origin: string): string {\n  return origin.replace(/\\/+$/, '');\n}\n\nexport function buildEmbedUrl(options: BuildEmbedUrlOptions): string {\n  const roomSlug = options.roomSlug.trim();\n  const joinToken = options.joinToken.trim();\n  if (!roomSlug) {\n    throw new Error('OE Meeting embed requires a non-empty roomSlug.');\n  }\n  if (!joinToken) {\n    throw new Error('OE Meeting embed requires a non-empty joinToken.');\n  }\n\n  const origin = normalizeOrigin(options.origin ?? DEFAULT_EMBED_ORIGIN);\n  const url = new URL(`${origin}/embed/${encodeURIComponent(roomSlug)}`);\n  const entries: Array<[EmbedQueryParam, string | undefined]> = [\n    [EmbedQueryParam.INSTANCE_ID, options.instanceId],\n    [EmbedQueryParam.HOST_ORIGIN, options.hostOrigin],\n    [EmbedQueryParam.JOIN_TOKEN, joinToken],\n    [EmbedQueryParam.USER_NAME, options.userName],\n    [EmbedQueryParam.EXTERNAL_USER_ID, options.externalUserId],\n    [EmbedQueryParam.LANG, options.lang],\n    [EmbedQueryParam.AUTO_JOIN, toFlag(options.autoJoin)],\n    [EmbedQueryParam.HIDE_LEAVE, toFlag(options.hideLeave)],\n    [EmbedQueryParam.AUTO_TRANSCRIBE, toFlag(options.autoTranscribe)],\n    [EmbedQueryParam.AUTO_RECORD, toFlag(options.autoRecord)],\n  ];\n\n  for (const [key, value] of entries) {\n    if (value !== undefined && value !== '') {\n      url.searchParams.set(key, value);\n    }\n  }\n  return url.toString();\n}\n","import {\n  useCallback,\n  useEffect,\n  useImperativeHandle,\n  useMemo,\n  useRef,\n  type Ref,\n} from 'react';\nimport {\n  EMBED_MESSAGE_SOURCE,\n  EMBED_PROTOCOL_VERSION,\n  EmbedCommandAction,\n  EmbedCommandType,\n  EmbedEventType,\n} from './embed-protocol';\nimport { normalizeOpenStageInput } from './openStage';\nimport { parseEmbedEvent } from './parseEmbedEvent';\nimport type {\n  EmbedCommandMessage,\n  OeMeetingHandle,\n  OeMeetingProps,\n  OpenStageInput,\n} from './types';\n\ntype UseOeMeetingOptions = Pick<\n  OeMeetingProps,\n  | 'onReady'\n  | 'onJoined'\n  | 'onLeft'\n  | 'onParticipantJoined'\n  | 'onParticipantLeft'\n  | 'onEnded'\n  | 'onError'\n  | 'onStageChanged'\n  | 'onTranscriptStarted'\n  | 'onRecordingStarted'\n  | 'onEvent'\n> & {\n  instanceId: string;\n  targetOrigin: string;\n  handleRef?: Ref<OeMeetingHandle>;\n};\n\ninterface PostCommandOptions {\n  iframe: HTMLIFrameElement | null;\n  instanceId: string;\n  action: EmbedCommandAction;\n  targetOrigin: string;\n  payload?: OpenStageInput;\n}\n\nfunction postCommand(options: PostCommandOptions): void {\n  const frameWindow = options.iframe?.contentWindow;\n  if (!frameWindow) return;\n  const message: EmbedCommandMessage = {\n    source: EMBED_MESSAGE_SOURCE,\n    version: EMBED_PROTOCOL_VERSION,\n    instanceId: options.instanceId,\n    type: EmbedCommandType.COMMAND,\n    action: options.action,\n    ...(options.payload ? { payload: options.payload } : {}),\n  };\n  frameWindow.postMessage(message, options.targetOrigin);\n}\n\nexport function useOeMeeting(options: UseOeMeetingOptions) {\n  const iframeRef = useRef<HTMLIFrameElement | null>(null);\n  const callbacksRef = useRef(options);\n\n  useEffect(() => {\n    callbacksRef.current = options;\n  }, [options]);\n\n  useEffect(() => {\n    const onMessage = (event: MessageEvent<unknown>) => {\n      const frameWindow = iframeRef.current?.contentWindow;\n      if (\n        !frameWindow ||\n        event.source !== frameWindow ||\n        event.origin !== options.targetOrigin\n      ) {\n        return;\n      }\n      const embedEvent = parseEmbedEvent(event.data);\n      if (!embedEvent || embedEvent.instanceId !== options.instanceId) return;\n\n      const callbacks = callbacksRef.current;\n      callbacks.onEvent?.(embedEvent);\n      switch (embedEvent.type) {\n        case EmbedEventType.READY:\n          callbacks.onReady?.(embedEvent);\n          break;\n        case EmbedEventType.JOINED:\n          callbacks.onJoined?.(embedEvent);\n          break;\n        case EmbedEventType.LEFT:\n          callbacks.onLeft?.(embedEvent);\n          break;\n        case EmbedEventType.PARTICIPANT_JOINED:\n          callbacks.onParticipantJoined?.(embedEvent);\n          break;\n        case EmbedEventType.PARTICIPANT_LEFT:\n          callbacks.onParticipantLeft?.(embedEvent);\n          break;\n        case EmbedEventType.ENDED:\n          callbacks.onEnded?.(embedEvent);\n          break;\n        case EmbedEventType.ERROR:\n          callbacks.onError?.(embedEvent);\n          break;\n        case EmbedEventType.STAGE_CHANGED:\n          callbacks.onStageChanged?.(embedEvent);\n          break;\n        case EmbedEventType.TRANSCRIPT_STARTED:\n          callbacks.onTranscriptStarted?.(embedEvent);\n          break;\n        case EmbedEventType.RECORDING_STARTED:\n          callbacks.onRecordingStarted?.(embedEvent);\n          break;\n      }\n    };\n\n    window.addEventListener('message', onMessage);\n    return () => window.removeEventListener('message', onMessage);\n  }, [options.instanceId, options.targetOrigin]);\n\n  const send = useCallback(\n    (action: EmbedCommandAction, payload?: OpenStageInput) =>\n      postCommand({\n        iframe: iframeRef.current,\n        instanceId: options.instanceId,\n        action,\n        targetOrigin: options.targetOrigin,\n        payload,\n      }),\n    [options.instanceId, options.targetOrigin],\n  );\n  const leave = useCallback(() => send(EmbedCommandAction.LEAVE), [send]);\n  const toggleMic = useCallback(\n    () => send(EmbedCommandAction.TOGGLE_MIC),\n    [send],\n  );\n  const toggleCamera = useCallback(\n    () => send(EmbedCommandAction.TOGGLE_CAMERA),\n    [send],\n  );\n  const openStage = useCallback(\n    (input: OpenStageInput) => {\n      const normalized = normalizeOpenStageInput(input);\n      if (!normalized) return;\n      send(EmbedCommandAction.OPEN_STAGE, normalized);\n    },\n    [send],\n  );\n  const closeStage = useCallback(\n    () => send(EmbedCommandAction.CLOSE_STAGE),\n    [send],\n  );\n  const getIframe = useCallback(() => iframeRef.current, []);\n  const handle = useMemo<OeMeetingHandle>(\n    () => ({\n      leave,\n      toggleMic,\n      toggleCamera,\n      openStage,\n      closeStage,\n      getIframe,\n    }),\n    [closeStage, getIframe, leave, openStage, toggleCamera, toggleMic],\n  );\n\n  useImperativeHandle(options.handleRef, () => handle, [handle]);\n  return { iframeRef, handle };\n}\n","import { isStageToolId, MAX_STAGE_URL_LENGTH } from './embed-protocol';\nimport type { OpenStageInput } from './types';\n\nexport function isValidStageUrl(url: string): boolean {\n  if (url.length === 0 || url.length > MAX_STAGE_URL_LENGTH) return false;\n  try {\n    const parsed = new URL(url);\n    if (parsed.protocol === 'https:') return true;\n    if (parsed.protocol === 'http:') {\n      return (\n        parsed.hostname === 'localhost' || parsed.hostname === '127.0.0.1'\n      );\n    }\n    return false;\n  } catch {\n    return false;\n  }\n}\n\nexport function normalizeOpenStageInput(\n  input: OpenStageInput,\n): OpenStageInput | null {\n  const url = input.url.trim();\n  if (!isValidStageUrl(url)) return null;\n  const title = input.title?.trim();\n  return {\n    url,\n    ...(title ? { title: title.slice(0, 200) } : {}),\n    ...(isStageToolId(input.tool) ? { tool: input.tool } : {}),\n  };\n}\n","import {\n  EMBED_MESSAGE_SOURCE,\n  EMBED_PROTOCOL_VERSION,\n  EmbedCaptureOutcome,\n  EmbedEventType,\n} from './embed-protocol';\nimport type { EmbedEvent } from './types';\n\nconst EVENT_TYPES = new Set<string>(Object.values(EmbedEventType));\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n\nfunction isOptionalString(value: unknown): boolean {\n  return value === undefined || typeof value === 'string';\n}\n\nfunction isNullableString(value: unknown): boolean {\n  return value === null || typeof value === 'string';\n}\n\nconst CAPTURE_OUTCOMES = new Set<string>(Object.values(EmbedCaptureOutcome));\n\nfunction isCaptureOutcome(value: unknown): boolean {\n  return typeof value === 'string' && CAPTURE_OUTCOMES.has(value);\n}\n\nfunction hasValidPayload(\n  type: EmbedEventType,\n  payload: Record<string, unknown>,\n): boolean {\n  switch (type) {\n    case EmbedEventType.READY:\n      return typeof payload.roomSlug === 'string';\n    case EmbedEventType.JOINED:\n      return (\n        typeof payload.roomSlug === 'string' &&\n        typeof payload.identity === 'string' &&\n        isOptionalString(payload.name) &&\n        typeof payload.joinedAt === 'string'\n      );\n    case EmbedEventType.LEFT:\n      return (\n        typeof payload.roomSlug === 'string' &&\n        typeof payload.identity === 'string' &&\n        typeof payload.leftAt === 'string' &&\n        (payload.durationMs === undefined ||\n          typeof payload.durationMs === 'number')\n      );\n    case EmbedEventType.PARTICIPANT_JOINED:\n      return (\n        typeof payload.identity === 'string' &&\n        isOptionalString(payload.name) &&\n        typeof payload.participantCount === 'number'\n      );\n    case EmbedEventType.PARTICIPANT_LEFT:\n      return (\n        typeof payload.identity === 'string' &&\n        typeof payload.participantCount === 'number'\n      );\n    case EmbedEventType.ENDED:\n      return (\n        typeof payload.roomSlug === 'string' &&\n        typeof payload.endedAt === 'string'\n      );\n    case EmbedEventType.ERROR:\n      return (\n        typeof payload.code === 'string' &&\n        typeof payload.message === 'string'\n      );\n    case EmbedEventType.STAGE_CHANGED:\n      return (\n        (payload.url === null || typeof payload.url === 'string') &&\n        isOptionalString(payload.title) &&\n        isOptionalString(payload.tool) &&\n        isOptionalString(payload.openedBy)\n      );\n    case EmbedEventType.TRANSCRIPT_STARTED:\n      return (\n        typeof payload.roomSlug === 'string' &&\n        isCaptureOutcome(payload.outcome) &&\n        isNullableString(payload.transcriptId) &&\n        isNullableString(payload.status)\n      );\n    case EmbedEventType.RECORDING_STARTED:\n      return (\n        typeof payload.roomSlug === 'string' &&\n        isCaptureOutcome(payload.outcome) &&\n        isNullableString(payload.recordingId) &&\n        isNullableString(payload.status)\n      );\n  }\n}\n\nexport function parseEmbedEvent(data: unknown): EmbedEvent | null {\n  if (!isRecord(data)) return null;\n  if (\n    data.source !== EMBED_MESSAGE_SOURCE ||\n    data.version !== EMBED_PROTOCOL_VERSION ||\n    typeof data.instanceId !== 'string' ||\n    data.instanceId.length === 0 ||\n    typeof data.type !== 'string' ||\n    !EVENT_TYPES.has(data.type) ||\n    !isRecord(data.payload)\n  ) {\n    return null;\n  }\n\n  const type = data.type as EmbedEventType;\n  if (!hasValidPayload(type, data.payload)) return null;\n  return data as unknown as EmbedEvent;\n}\n"],"mappings":"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","names":["useMemo","EmbedEventType","EmbedCommandType","EmbedCommandAction","EmbedErrorCode","EmbedQueryParam","EmbedCaptureOutcome","OeMeeting","useMemo"]}

package/docs/BACKEND-INTEGRATION.md

@@ -8,6 +8,8 @@ OE Meeting cần cấp cho OE.School một application credential gồm:
 - `clientSecret`.
 - Scope `rooms:create` để tạo phòng.
 - Scope `rooms:retrieve` để đọc phòng và cấp join token.
+- Scope `transcripts:retrieve` để đọc transcript sau buổi học.
+- Scope `recordings:retrieve` để tải bản ghi sau buổi học.
 - Tùy nhu cầu quản trị: `rooms:update`, `rooms:delete`.
 
 Cấu hình ở backend OE.School, ví dụ:
@@ -123,7 +125,67 @@ Nên dùng identity có namespace, ví dụ `oe-school:user:<userId>`, để tr
 identity giữa các hệ thống tích hợp. Không dùng token phiên đăng nhập OE.School
 làm identity.
 
-### 2.3. Các endpoint quản trị khác
+### 2.3. Lấy transcript của buổi họp
+
+```http
+GET /external-api/v1.0/rooms/:idOrSlug/transcript
+```
+
+Scope: `transcripts:retrieve`. `:idOrSlug` là room id hoặc slug đã tạo ở 2.1 —
+cùng định danh mà OE.School đã lưu vào bản ghi buổi học.
+
+Response mẫu:
+
+```json
+{
+  "id": "8f1c0f2a-2c9e-4f2f-9a3b-1e6d5b0c7a11",
+  "roomId": "c4ac4f15-8417-4e19-a3dd-39de5697c19f",
+  "status": "completed",
+  "startedBy": null,
+  "startedByName": "Nguyen Van A",
+  "createdAt": "2026-08-17T02:00:12.000Z",
+  "endedAt": "2026-08-17T02:48:31.000Z",
+  "segments": [
+    {
+      "id": "0b0f9d54-1a2b-4c3d-8e9f-0a1b2c3d4e5f",
+      "participantIdentity": "oe-school:user:12345",
+      "participantName": "Nguyen Van A",
+      "text": "Chào cả lớp, hôm nay chúng ta học bài 3.",
+      "language": "vi",
+      "spokenAt": "2026-08-17T02:00:45.000Z"
+    }
+  ]
+}
+```
+
+| Field | Mô tả |
+|---|---|
+| `status` | `active` khi buổi học đang diễn ra, `paused` khi tạm dừng, `completed` sau khi phòng kết thúc. |
+| `segments` | Các câu nói đã chốt, sắp xếp tăng dần theo `spokenAt`. |
+| `startedBy` | `null` với phiên do embed tự bật (người tham gia là khách của OE.School, không có tài khoản OE Meeting). |
+
+Trả `404` khi phòng chưa từng có transcript nào. Transcript là tài sản cấp
+phòng: nếu OE.School dùng lại một room cho nhiều buổi, endpoint trả phiên gần
+nhất và các segment của phiên đó. Dùng một room cho mỗi buổi học (theo quy ước
+slug ở 2.1) để tránh nhập nhằng.
+
+Gọi endpoint này sau khi nhận sự kiện kết thúc buổi học. Agent transcriber chốt
+phiên (`status: "completed"`) khi phòng LiveKit đóng, nên gọi quá sớm sẽ nhận
+được transcript còn `active` và thiếu các câu cuối.
+
+### 2.4. Lấy bản ghi của buổi họp
+
+```http
+GET /external-api/v1.0/rooms/:idOrSlug/recordings
+```
+
+Scope: `recordings:retrieve`. Response trả `results` theo thứ tự mới nhất trước.
+Bản ghi có `status: "saved"` và chưa hết hạn sẽ có `downloadUrl` tạm thời;
+recording đang xử lý hoặc đã hết hạn trả `downloadUrl: null`. Hệ thống ngừng
+cho tải sau `RECORDING_EXPIRATION_DAYS`; cấu hình lifecycle S3/MinIO cùng số
+ngày trên prefix `RECORDING_OUTPUT_FOLDER` để file được xóa khỏi storage.
+
+### 2.5. Các endpoint quản trị khác
 
 | Method | Endpoint | Scope |
 |---|---|---|
@@ -151,6 +213,26 @@ interface JoinTokenResponse {
   token: string;
 }
 
+interface TranscriptSegment {
+  id: string;
+  participantIdentity: string | null;
+  participantName: string;
+  text: string;
+  language: string | null;
+  spokenAt: string;
+}
+
+interface MeetingTranscript {
+  id: string;
+  roomId: string;
+  status: 'active' | 'paused' | 'completed';
+  startedBy: string | null;
+  startedByName: string | null;
+  createdAt: string;
+  endedAt: string | null;
+  segments: TranscriptSegment[];
+}
+
 interface MeetingCredentials {
   apiUrl: string;
   clientId: string;
@@ -206,6 +288,13 @@ export class OeMeetingApi {
       }),
     });
   }
+
+  getLessonTranscript(roomSlug: string): Promise<MeetingTranscript> {
+    return this.request(
+      `/external-api/v1.0/rooms/${encodeURIComponent(roomSlug)}/transcript`,
+      { method: 'GET' },
+    );
+  }
 }
 ```
 

package/docs/REACT-INTEGRATION.md

@@ -119,6 +119,8 @@ này ở production. Khi chạy local, truyền URL frontend OE Meeting local, v
 | `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. |
+| `autoTranscribe` | `boolean` | `false` | Tự bật transcript dùng chung khi embed kết nối. |
+| `autoRecord` | `boolean` | `false` | Tự ghi toàn bộ phòng khi embed kết nối. |
 | `userName` | `string` | — | Thông tin tùy chọn truyền vào embed URL. |
 | `externalUserId` | `string` | — | External identity tùy chọn. |
 | `lang` | `string` | — | Ngôn ngữ giao diện. |
@@ -138,6 +140,8 @@ này ở production. Khi chạy local, truyền URL frontend OE Meeting local, v
 | `onParticipantLeft` | callback | — | Một participant khác rời phòng. |
 | `onEnded` | callback | — | Phòng kết thúc. |
 | `onError` | callback | — | Lỗi typed từ embed. |
+| `onTranscriptStarted` | callback | — | Kết quả của `autoTranscribe`. |
+| `onRecordingStarted` | callback | — | Kết quả của `autoRecord`. |
 | `onEvent` | callback | — | Nhận tất cả event protocol. |
 
 Không đặt `targetOrigin="*"`. SDK và iframe đều kiểm tra origin, source và
@@ -167,10 +171,66 @@ interface EmbedEventEnvelope<TPayload> {
 | `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 |
+| `TRANSCRIPT_STARTED` | `roomSlug`, `outcome`, `transcriptId` (`string` \| `null`), `status` (`string` \| `null`) | Đã emit khi bật `autoTranscribe` |
+| `RECORDING_STARTED` | `roomSlug`, `outcome`, `recordingId` (`string` \| `null`), `status` (`string` \| `null`) | Đã emit khi bật `autoRecord` |
 
 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.
 
+### 4.1. Tự động bật transcript
+
+```tsx
+<OeMeeting
+  roomSlug={access.roomSlug}
+  joinToken={access.joinToken}
+  autoTranscribe
+  onTranscriptStarted={(event) => {
+    console.info('transcript', event.payload.outcome, event.payload.transcriptId);
+  }}
+/>
+```
+
+Transcript là tài sản cấp phòng, không phải cấp participant: người đầu tiên kết
+nối bật nó lên, mọi người vào sau nhận `outcome: "already_running"`, và nó vẫn
+chạy khi người bật rời phòng sớm.
+
+| `outcome` | Ý nghĩa |
+|---|---|
+| `started` | Lần kết nối này đã bật lên. |
+| `already_running` | Đã chạy sẵn, trạng thái bình thường của mọi người vào sau. |
+| `disabled` | Deployment OE Meeting tắt transcript. |
+| `failed` | Không bật được; kèm theo một event `ERROR`. |
+
+Request bật transcript được xác thực bằng chính join token của participant, nên
+OE.School không cần thêm credential nào ở phía trình duyệt. Đổi lại, transcript
+chỉ bắt đầu khi có người thực sự vào phòng: một buổi học không ai vào sẽ không
+có transcript.
+
+### 4.2. Tự động ghi hình
+
+```tsx
+<OeMeeting
+  roomSlug={access.roomSlug}
+  joinToken={access.joinToken}
+  autoRecord
+  onRecordingStarted={(event) => {
+    console.info('recording', event.payload.outcome, event.payload.recordingId);
+  }}
+/>
+```
+
+Recording cũng là tài sản cấp phòng: người đầu tiên kết nối bật egress,
+mọi người vào sau nhận `outcome: "already_running"`. Local cần MinIO +
+LiveKit Egress (`docker compose --profile s3 up -d`).
+
+Lấy danh sách và URL tải sau buổi học bằng
+`GET /external-api/v1.0/rooms/:idOrSlug/recordings` từ backend OE.School —
+xem `BACKEND-INTEGRATION.md` mục 2.4. Đừng gọi external API từ trình duyệt:
+nó cần `X-Client-Secret`.
+
+Lấy transcript sau buổi học bằng `GET /external-api/v1.0/rooms/:idOrSlug/transcript`
+từ backend OE.School — xem `BACKEND-INTEGRATION.md` mục 2.3.
+
 ## 5. Điều khiển phòng từ trang cha
 
 ```tsx
@@ -231,6 +291,8 @@ export function MeetingWithControls(props: {
 | `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 |
+| `TRANSCRIPT_START_FAILED` | `autoTranscribe` không bật được transcript. | Không retry từ trang cha; kiểm tra agent transcriber. | Đã emit |
+| `RECORDING_START_FAILED` | `autoRecord` không bật được recording. | Không retry từ trang cha; kiểm tra LiveKit Egress và S3. | Đã emit |
 
 ## 7. Local development
 
@@ -294,7 +356,7 @@ về đúng origin đó.
 - OE Meeting chưa đồng bộ roster vào database; OE.School chịu trách nhiệm duyệt
   quyền trước mỗi lần cấp token.
 - Chưa có API thu hồi token đã cấp hoặc kick participant theo lesson attendance.
-- Protocol v1 chưa có recording events và token handshake qua `postMessage`.
+- Protocol v1 chưa có token handshake qua `postMessage`.
 - `autoJoin={false}` chưa có prejoin flow; phiên bản hiện tại yêu cầu auto join.
 - Các lỗi token/access chưa được phân loại riêng; frontend có thể nhận
   `CONNECTION_FAILED` cho các lỗi kết nối liên quan token.

package/package.json

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