@jevelin/bridge 2.53.0

package/dist/esm/packages/teams-js/dts/private/videoEffectsEx.d.ts

@@ -0,0 +1,250 @@
+/**
+ * @hidden
+ * Extended video API
+ * @internal
+ * Limited to Microsoft-internal use
+ * @beta
+ * @module
+ */
+import { DefaultVideoEffectCallBack as VideoEffectCallBack } from '../internal/videoEffectsUtils';
+import * as videoEffects from '../public/videoEffects';
+export declare const frameProcessingTimeoutInMs = 2000;
+/**
+ * @hidden
+ * Error level when notifying errors to the host, the host will decide what to do acording to the error level.
+ * @beta
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare enum ErrorLevel {
+    Fatal = "fatal",
+    Warn = "warn"
+}
+/**
+ * @hidden
+ * Video frame configuration supplied to the host to customize the generated video frame parameters
+ * @beta
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export interface VideoFrameConfig extends videoEffects.VideoFrameConfig {
+    /**
+     * @hidden
+     * Flag to indicate use camera stream to synthesize video frame or not.
+     * Default value is true.
+     * @beta
+     *
+     * @internal
+     * Limited to Microsoft-internal use
+     */
+    requireCameraStream?: boolean;
+    /**
+     * @hidden
+     * Machine learning model to run in the host to do audio inference for you
+     * @beta
+     *
+     * @internal
+     * Limited to Microsoft-internal use
+     */
+    audioInferenceModel?: ArrayBuffer;
+    /**
+     * @hidden
+     * Specifies additional capabilities that should be applied to the video frame
+     * @beta
+     *
+     * @internal
+     * Limited to Microsoft-internal use
+     */
+    requiredCapabilities?: string[];
+}
+/**
+ * @hidden
+ * Represents a video frame
+ * @beta
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export interface VideoBufferData extends videoEffects.VideoBufferData {
+    /**
+     * @hidden
+     * The model output if you passed in an {@linkcode VideoFrameConfig.audioInferenceModel}
+     * @beta
+     *
+     * @internal
+     * Limited to Microsoft-internal use
+     */
+    audioInferenceResult?: Uint8Array;
+}
+/**
+ * @hidden
+ * The callback will be called on every frame when running on the supported host.
+ * We require the frame rate of the video to be at least 22fps for 720p, thus the callback should process a frame timely.
+ * The video app should call `notifyVideoFrameProcessed` to notify a successfully processed video frame.
+ * The video app should call `notifyError` to notify a failure. When the failures accumulate to a certain number(determined by the host), the host will see the app is "frozen" and give the user the option to close the app.
+ * @beta
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export type VideoBufferHandler = (videoBufferData: VideoBufferData, notifyVideoFrameProcessed: () => void, notifyError: (errorMessage: string) => void) => void;
+/**
+ * @hidden
+ * Video frame data extracted from the media stream. More properties may be added in the future.
+ * @beta
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export type VideoFrameData = videoEffects.VideoFrameData & {
+    /**
+     * @hidden
+     * The model output if you passed in an {@linkcode VideoFrameConfig.audioInferenceModel}
+     * @beta
+     *
+     * @internal
+     * Limited to Microsoft-internal use
+     */
+    audioInferenceResult?: Uint8Array;
+    /**
+     * @hidden
+     * Additional metadata determined by capabilities specified in {@linkcode VideoFrameConfig.requiredCapabilities}
+     * @beta
+     *
+     * @internal
+     * Limited to Microsoft-internal use
+     */
+    attributes?: ReadonlyMap<string, Uint8Array>;
+};
+/**
+ * @hidden
+ * The callback will be called on every frame when running on the supported host.
+ * We require the frame rate of the video to be at least 22fps for 720p, thus the callback should process a frame timely.
+ * The video app should resolve the promise to notify a successfully processed video frame.
+ * The video app should reject the promise to notify a failure. When the failures accumulate to a certain number(determined by the host), the host will see the app is "frozen" and give the user the option to close the app.
+ * @beta
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export type VideoFrameHandler = (receivedVideoFrame: VideoFrameData) => Promise<videoEffects.VideoFrame>;
+/**
+ * @hidden
+ * @beta
+ * Callbacks and configuration supplied to the host to process the video frames.
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export type RegisterForVideoFrameParameters = {
+    /**
+     * Callback function to process the video frames extracted from a media stream.
+     */
+    videoFrameHandler: VideoFrameHandler;
+    /**
+     * Callback function to process the video frames shared by the host.
+     */
+    videoBufferHandler: VideoBufferHandler;
+    /**
+     * Video frame configuration supplied to the host to customize the generated video frame parameters, like format
+     */
+    config: VideoFrameConfig;
+};
+/**
+ * @hidden
+ * Register to process video frames
+ * @beta
+ *
+ * @param parameters - Callbacks and configuration to process the video frames. A host may support either {@link VideoFrameHandler} or {@link VideoBufferHandler}, but not both.
+ * To ensure the video effect works on all supported hosts, the video app must provide both {@link VideoFrameHandler} and {@link VideoBufferHandler}.
+ * The host will choose the appropriate callback based on the host's capability.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function registerForVideoFrame(parameters: RegisterForVideoFrameParameters): void;
+/**
+ * @hidden
+ * Video extension should call this to notify host that the current selected effect parameter changed.
+ * If it's pre-meeting, host will call videoEffectCallback immediately then use the videoEffect.
+ * If it's the in-meeting scenario, we will call videoEffectCallback when apply button clicked.
+ * @beta
+ * @param effectChangeType - the effect change type.
+ * @param effectId - Newly selected effect id. {@linkcode VideoEffectCallBack}
+ * @param effectParam Variant for the newly selected effect. {@linkcode VideoEffectCallBack}
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function notifySelectedVideoEffectChanged(effectChangeType: videoEffects.EffectChangeType, effectId: string | undefined, effectParam?: string): void;
+/**
+ * @hidden
+ * Register the video effect callback, host uses this to notify the video extension the new video effect will by applied
+ * @beta
+ * @param callback - The VideoEffectCallback to invoke when registerForVideoEffect has completed
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function registerForVideoEffect(callback: VideoEffectCallBack): void;
+/**
+ * @hidden
+ * Personalized video effect
+ * @beta
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export interface PersonalizedEffect {
+    /**
+     * Personalized effect id
+     */
+    id: string;
+    /**
+     * Display name
+     */
+    name: string;
+    /**
+     * Effect type defined by app
+     */
+    type: string;
+    /**
+     * Data URI of the thumbnail image content encoded in ASCII format using the base64 scheme
+     */
+    thumbnail: string;
+}
+/**
+ * @hidden
+ * Send personalized effects to Teams client
+ * @beta
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function updatePersonalizedEffects(effects: PersonalizedEffect[]): void;
+/**
+ * @hidden
+ *
+ * Checks if video capability is supported by the host
+ * @beta
+ *
+ * @throws Error if {@linkcode app.initialize} has not successfully completed
+ *
+ * @returns boolean to represent whether the video capability is supported
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function isSupported(): boolean;
+/**
+ * @hidden
+ * Sending fatal error notification to host. Call this function only when your app meets fatal error and can't continue.
+ * The host will stop the video pipeline and terminate this session, and optionally, show an error message to the user.
+ * @beta
+ * @param errorMessage - The error message that will be sent to the host
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function notifyFatalError(errorMessage: string): void;

package/dist/esm/packages/teams-js/dts/private/widgetHosting/widgetContext.d.ts

@@ -0,0 +1,121 @@
+import { RenderingSurfaces } from '../../public';
+export interface ISecurityPolicy {
+    connectDomains?: string[];
+    resourceDomains?: string[];
+    isTrusted?: boolean;
+}
+export type Theme = 'light' | 'dark';
+export type SafeAreaInsets = {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+};
+export type SafeArea = {
+    insets: SafeAreaInsets;
+};
+export type DeviceType = 'mobile' | 'tablet' | 'desktop' | 'unknown';
+export type UserAgent = {
+    device: {
+        type: DeviceType;
+    };
+    capabilities: {
+        hover: boolean;
+        touch: boolean;
+    };
+};
+/**
+ * Options for requesting a modal dialog
+ */
+export interface IModalOptions {
+    /** Unique identifier for the modal */
+    id: string;
+    /** Title at the top of the modal window */
+    title?: string;
+    /** Inner HTML string inserted into the modal's body */
+    content: string;
+    /** Preferred modal width in pixels */
+    width?: number;
+    /** Preferred modal height in pixels */
+    height?: number;
+}
+/**
+ * Response from requesting a modal dialog
+ */
+export interface IModalResponse {
+    /** A DOM element representing the modal's root */
+    modalElement: HTMLElement;
+}
+/** Declare generic JSON - serializable structure */
+export interface JSONObject {
+    [key: string]: JSONValue;
+}
+export interface JSONArray extends Array<JSONValue> {
+}
+export type JSONValue = string | number | boolean | null | JSONObject | JSONArray;
+/** Display mode */
+export type DisplayMode = 'pip' | 'inline' | 'fullscreen';
+/**
+ * MCP-compatible tool input structure following OpenAI MCP server specification
+ */
+export interface IToolInput {
+    /** The name of the tool to call */
+    name: string;
+    /** Arguments passed to the tool as key-value pairs */
+    arguments?: Record<string, unknown>;
+}
+/**
+ * MCP-compatible tool output structure matching exact MCP schema
+ */
+export interface IToolOutput {
+    /** Whether the tool call resulted in an error */
+    isError?: boolean;
+    /** Array of content blocks returned by the tool */
+    content: Array<{
+        /** Type of content block */
+        type: 'text' | 'image' | 'resource';
+        /** Text content (for type: 'text') */
+        text?: string;
+        /** Image data (for type: 'image') */
+        data?: string;
+        /** MIME type (for type: 'image') */
+        mimeType?: string;
+        /** Resource URI (for type: 'resource') */
+        uri?: string;
+        /** Optional metadata for any content type */
+        annotations?: {
+            /** Audience for this content (user, assistant) */
+            audience?: Array<'user' | 'assistant'>;
+            /** Priority level */
+            priority?: number;
+        };
+    }>;
+    /** UI widget data */
+    structuredContent?: unknown;
+    /** MCP metadata object */
+    _meta?: Record<string, unknown>;
+}
+/**
+ * Widget context similar to IWidgetHost structure - simplified for widget rendering
+ */
+export interface IWidgetContext {
+    /** Unique identifier for the widget instance */
+    widgetId: string;
+    /** Widget HTML content to render */
+    html: string;
+    /** widget domain that developer has registered their app to */
+    domain: string;
+    /** Content Security policy for the widget */
+    securityPolicy?: ISecurityPolicy;
+    /** OpenAI-compatible object with widget globals and API functions */
+    openai: {
+        theme?: Theme;
+        userAgent?: UserAgent;
+        locale?: string;
+        displayMode?: DisplayMode;
+        safeArea?: SafeArea;
+        maxHeight?: number;
+        view?: RenderingSurfaces;
+        widgetState?: JSONValue;
+    };
+}

package/dist/esm/packages/teams-js/dts/private/widgetHosting/widgetHosting.d.ts

@@ -0,0 +1,101 @@
+/**
+ * @beta
+ * @hidden
+ * User information required by specific apps
+ * @internal
+ * Limited to Microsoft-internal use
+ * @module
+ */
+import { DisplayMode, IModalOptions, IModalResponse, IToolInput, IToolOutput, JSONValue } from './widgetContext';
+/**
+ * @hidden
+ * @internal
+ * Limited to Microsoft-internal use
+ * @beta
+ * @returns boolean to represent whether widgetHosting capability is supported
+ *
+ * @throws Error if {@linkcode app.initialize} has not successfully completed
+ */
+export declare function isSupported(): boolean;
+export declare function callTool(widgetId: string, input: IToolInput): Promise<IToolOutput>;
+/**
+ * @beta
+ * @hidden
+ * Sends a follow-up message to the host
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function sendFollowUpMessage(widgetId: string, args: {
+    prompt: string;
+}): Promise<void>;
+/**
+ * @beta
+ * @hidden
+ * Requests a specific display mode for the widget
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function requestDisplayMode(widgetId: string, args: {
+    mode: DisplayMode;
+}): Promise<void>;
+/**
+ * @beta
+ * @hidden
+ * Requests a modal dialog to be displayed
+ * @internal
+ * Limited to Microsoft-internal use
+ * @param widgetId - The unique identifier for the widget
+ * @param options - Configuration options for the modal
+ * @returns A DOM element representing the modal's root
+ */
+export declare function requestModal(widgetId: string, options: IModalOptions): Promise<IModalResponse>;
+/**
+ * @beta
+ * @hidden
+ * Notifies the host about the intrinsic height of the widget content
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function notifyIntrinsicHeight(widgetId: string, height: number): void;
+/**
+ * @beta
+ * @hidden
+ * Notifies the host about content size changes
+ * @internal
+ * Limited to Microsoft-internal use
+ * @param widgetId - The unique identifier for the widget
+ * @param width - The width of the content in pixels
+ * @param height - The height of the content in pixels
+ */
+export declare function contentSizeChanged(widgetId: string, width: number, height: number): void;
+/**
+ * @beta
+ * @hidden
+ * Sets the widget state
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function setWidgetState(widgetId: string, state: JSONValue): Promise<void>;
+/**
+ * @beta
+ * @hidden
+ * Opens an external URL
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function openExternal(widgetId: string, payload: {
+    href: string;
+}): void;
+/** Modal close handler function type */
+export type ModalCloseHandlerType = (modalId: string) => void;
+/**
+ * @hidden
+ * @beta
+ * Registers a handler to be called when a modal is closed.
+ * This handler will be called when the user closes a modal or when .close() is invoked.
+ * @param handler - The handler for modal close events.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function registerModalCloseHandler(handler: ModalCloseHandlerType): void;

package/dist/esm/packages/teams-js/dts/public/adaptiveCards.d.ts

@@ -0,0 +1,6 @@
+import { AdaptiveCardVersion } from './interfaces';
+/**
+ * @returns The {@linkcode AdaptiveCardVersion} representing the Adaptive Card schema
+ * version supported by the host, or undefined if the host does not support Adaptive Cards
+ */
+export declare function getAdaptiveCardSchemaVersion(): AdaptiveCardVersion | undefined;