@tinyweb_dev/oe-meeting-react 0.1.0 → 0.3.0

package/dist/index.d.cts

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

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

@@ -8,7 +8,7 @@ import {
 // src/embed-protocol.ts
 var EMBED_PROTOCOL_VERSION = 1;
 var EMBED_MESSAGE_SOURCE = "oemeeting";
-var DEFAULT_EMBED_ORIGIN = "https://meet.oceanedu.org";
+var DEFAULT_EMBED_ORIGIN = "https://meet.ocean.edu.vn";
 var EmbedEventType = /* @__PURE__ */ ((EmbedEventType2) => {
   EmbedEventType2["READY"] = "oemeeting:ready";
   EmbedEventType2["JOINED"] = "oemeeting:joined";
@@ -17,6 +17,9 @@ var EmbedEventType = /* @__PURE__ */ ((EmbedEventType2) => {
   EmbedEventType2["PARTICIPANT_LEFT"] = "oemeeting:participant-left";
   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) => {
@@ -27,6 +30,8 @@ var EmbedCommandAction = /* @__PURE__ */ ((EmbedCommandAction2) => {
   EmbedCommandAction2["LEAVE"] = "leave";
   EmbedCommandAction2["TOGGLE_MIC"] = "toggleMic";
   EmbedCommandAction2["TOGGLE_CAMERA"] = "toggleCamera";
+  EmbedCommandAction2["OPEN_STAGE"] = "openStage";
+  EmbedCommandAction2["CLOSE_STAGE"] = "closeStage";
   return EmbedCommandAction2;
 })(EmbedCommandAction || {});
 var EmbedErrorCode = /* @__PURE__ */ ((EmbedErrorCode2) => {
@@ -36,9 +41,19 @@ var EmbedErrorCode = /* @__PURE__ */ ((EmbedErrorCode2) => {
   EmbedErrorCode2["ROOM_ACCESS_DENIED"] = "ROOM_ACCESS_DENIED";
   EmbedErrorCode2["CONNECTION_FAILED"] = "CONNECTION_FAILED";
   EmbedErrorCode2["PROTOCOL_MISMATCH"] = "PROTOCOL_MISMATCH";
+  EmbedErrorCode2["STAGE_ORIGIN_DENIED"] = "STAGE_ORIGIN_DENIED";
+  EmbedErrorCode2["STAGE_URL_INVALID"] = "STAGE_URL_INVALID";
+  EmbedErrorCode2["TRANSCRIPT_START_FAILED"] = "TRANSCRIPT_START_FAILED";
+  EmbedErrorCode2["RECORDING_START_FAILED"] = "RECORDING_START_FAILED";
   EmbedErrorCode2["UNKNOWN"] = "UNKNOWN";
   return EmbedErrorCode2;
 })(EmbedErrorCode || {});
+var MAX_STAGE_URL_LENGTH = 2048;
+var MAX_STAGE_TOOL_ID_LENGTH = 32;
+var STAGE_TOOL_ID_PATTERN = /^[a-z][a-z0-9._-]{0,31}$/;
+function isStageToolId(value) {
+  return typeof value === "string" && value.length > 0 && value.length <= MAX_STAGE_TOOL_ID_LENGTH && STAGE_TOOL_ID_PATTERN.test(value);
+}
 var EmbedQueryParam = /* @__PURE__ */ ((EmbedQueryParam2) => {
   EmbedQueryParam2["INSTANCE_ID"] = "instanceId";
   EmbedQueryParam2["HOST_ORIGIN"] = "hostOrigin";
@@ -48,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";
@@ -80,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 !== "") {
@@ -99,6 +125,31 @@ import {
   useRef
 } from "react";
 
+// src/openStage.ts
+function isValidStageUrl(url) {
+  if (url.length === 0 || url.length > MAX_STAGE_URL_LENGTH) return false;
+  try {
+    const parsed = new URL(url);
+    if (parsed.protocol === "https:") return true;
+    if (parsed.protocol === "http:") {
+      return parsed.hostname === "localhost" || parsed.hostname === "127.0.0.1";
+    }
+    return false;
+  } catch {
+    return false;
+  }
+}
+function normalizeOpenStageInput(input) {
+  const url = input.url.trim();
+  if (!isValidStageUrl(url)) return null;
+  const title = input.title?.trim();
+  return {
+    url,
+    ...title ? { title: title.slice(0, 200) } : {},
+    ...isStageToolId(input.tool) ? { tool: input.tool } : {}
+  };
+}
+
 // src/parseEmbedEvent.ts
 var EVENT_TYPES = new Set(Object.values(EmbedEventType));
 function isRecord(value) {
@@ -107,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 */:
@@ -123,6 +181,12 @@ function hasValidPayload(type, payload) {
       return typeof payload.roomSlug === "string" && typeof payload.endedAt === "string";
     case "oemeeting:error" /* ERROR */:
       return typeof payload.code === "string" && typeof payload.message === "string";
+    case "oemeeting:stage-changed" /* STAGE_CHANGED */:
+      return (payload.url === null || typeof payload.url === "string") && isOptionalString(payload.title) && isOptionalString(payload.tool) && isOptionalString(payload.openedBy);
+    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) {
@@ -144,7 +208,8 @@ function postCommand(options) {
     version: EMBED_PROTOCOL_VERSION,
     instanceId: options.instanceId,
     type: "oemeeting:command" /* COMMAND */,
-    action: options.action
+    action: options.action,
+    ...options.payload ? { payload: options.payload } : {}
   };
   frameWindow.postMessage(message, options.targetOrigin);
 }
@@ -186,17 +251,27 @@ function useOeMeeting(options) {
         case "oemeeting:error" /* ERROR */:
           callbacks.onError?.(embedEvent);
           break;
+        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);
     return () => window.removeEventListener("message", onMessage);
   }, [options.instanceId, options.targetOrigin]);
   const send = useCallback(
-    (action) => postCommand({
+    (action, payload) => postCommand({
       iframe: iframeRef.current,
       instanceId: options.instanceId,
       action,
-      targetOrigin: options.targetOrigin
+      targetOrigin: options.targetOrigin,
+      payload
     }),
     [options.instanceId, options.targetOrigin]
   );
@@ -209,10 +284,29 @@ function useOeMeeting(options) {
     () => send("toggleCamera" /* TOGGLE_CAMERA */),
     [send]
   );
+  const openStage = useCallback(
+    (input) => {
+      const normalized = normalizeOpenStageInput(input);
+      if (!normalized) return;
+      send("openStage" /* OPEN_STAGE */, normalized);
+    },
+    [send]
+  );
+  const closeStage = useCallback(
+    () => send("closeStage" /* CLOSE_STAGE */),
+    [send]
+  );
   const getIframe = useCallback(() => iframeRef.current, []);
   const handle = useMemo(
-    () => ({ leave, toggleMic, toggleCamera, getIframe }),
-    [getIframe, leave, toggleCamera, toggleMic]
+    () => ({
+      leave,
+      toggleMic,
+      toggleCamera,
+      openStage,
+      closeStage,
+      getIframe
+    }),
+    [closeStage, getIframe, leave, openStage, toggleCamera, toggleMic]
   );
   useImperativeHandle(options.handleRef, () => handle, [handle]);
   return { iframeRef, handle };
@@ -239,6 +333,8 @@ var OeMeeting = forwardRef(
       lang,
       autoJoin = true,
       hideLeave,
+      autoTranscribe,
+      autoRecord,
       title = "OE Meeting room",
       width = "100%",
       height = 640,
@@ -255,6 +351,9 @@ var OeMeeting = forwardRef(
       onParticipantLeft,
       onEnded,
       onError,
+      onStageChanged,
+      onTranscriptStarted,
+      onRecordingStarted,
       onEvent
     } = props;
     const reactId = useId();
@@ -275,11 +374,15 @@ var OeMeeting = forwardRef(
         lang,
         autoJoin,
         hideLeave,
+        autoTranscribe,
+        autoRecord,
         instanceId,
         hostOrigin
       }),
       [
         autoJoin,
+        autoRecord,
+        autoTranscribe,
         externalUserId,
         hideLeave,
         hostOrigin,
@@ -302,6 +405,9 @@ var OeMeeting = forwardRef(
       onParticipantLeft,
       onEnded,
       onError,
+      onStageChanged,
+      onTranscriptStarted,
+      onRecordingStarted,
       onEvent
     });
     const wrapperStyle = {
@@ -345,13 +451,19 @@ export {
   DEFAULT_IFRAME_ALLOW,
   EMBED_MESSAGE_SOURCE,
   EMBED_PROTOCOL_VERSION,
+  EmbedCaptureOutcome,
   EmbedCommandAction,
   EmbedCommandType,
   EmbedErrorCode,
   EmbedEventType,
   EmbedQueryParam,
+  MAX_STAGE_TOOL_ID_LENGTH,
+  MAX_STAGE_URL_LENGTH,
   OeMeeting,
   buildEmbedUrl,
+  isStageToolId,
+  isValidStageUrl,
+  normalizeOpenStageInput,
   parseEmbedEvent,
   useOeMeeting
 };