@microsoft/teams-js 2.30.0-beta.0 → 2.31.0-beta.0

package/README.md

@@ -24,7 +24,7 @@ To install the stable [version](https://learn.microsoft.com/javascript/api/overv
 
 ### Production
 
-You can reference these files directly [from here](https://res.cdn.office.net/teams-js/2.29.0/js/MicrosoftTeams.min.js) or point your package manager at them.
+You can reference these files directly [from here](https://res.cdn.office.net/teams-js/2.30.0/js/MicrosoftTeams.min.js) or point your package manager at them.
 
 ## Usage
 
@@ -45,13 +45,13 @@ Reference the library inside of your `.html` page using:
 ```html
 <!-- Microsoft Teams JavaScript API (via CDN) -->
 <script
-  src="https://res.cdn.office.net/teams-js/2.29.0/js/MicrosoftTeams.min.js"
-  integrity="sha384-HCj4C0CvWvv0xKWpolDpLs3Q2f8+k4AUwYACBrszhvquzHsIUz1ZB6z1KLIQTnSW"
+  src="https://res.cdn.office.net/teams-js/2.30.0/js/MicrosoftTeams.min.js"
+  integrity="sha384-8I0Bv4bWDPSX5ZYhJcChnvrBNoieX3zASTxmZ9URwnjEVx70hsrN0ZUy/C46u8dw"
   crossorigin="anonymous"
 ></script>
 
 <!-- Microsoft Teams JavaScript API (via npm) -->
-<script src="node_modules/@microsoft/teams-js@2.29.0/dist/MicrosoftTeams.min.js"></script>
+<script src="node_modules/@microsoft/teams-js@2.30.0/dist/MicrosoftTeams.min.js"></script>
 
 <!-- Microsoft Teams JavaScript API (via local) -->
 <script src="MicrosoftTeams.min.js"></script>

package/dist/esm/_virtual/__polyfill-node.os.js

@@ -0,0 +1 @@
+import*as o from"./_polyfill-node.os.js";import{getAugmentedNamespace as r}from"./_commonjsHelpers.js";var s=r(o);export{s as default};

package/dist/esm/_virtual/_polyfill-node.os.js

@@ -0,0 +1 @@
+import n from"./_polyfill-node.global.js";var r;function t(){if(void 0===r){var n=new ArrayBuffer(2),t=new Uint8Array(n),e=new Uint16Array(n);if(t[0]=1,t[1]=2,258===e[0])r="BE";else{if(513!==e[0])throw new Error("unable to figure out endianess");r="LE"}}return r}function e(){return void 0!==n.location?n.location.hostname:""}function o(){return[]}function u(){return 0}function i(){return Number.MAX_VALUE}function a(){return Number.MAX_VALUE}function f(){return[]}function c(){return"Browser"}function s(){return void 0!==n.navigator?n.navigator.appVersion:""}function m(){return{}}function l(){return{}}function p(){return"javascript"}function v(){return"browser"}function d(){return"/tmp"}var w=d,A="\n";function E(){return"$HOME"}var g={homedir:E,EOL:"\n",arch:p,platform:v,tmpdir:w,tmpDir:d,networkInterfaces:m,getNetworkInterfaces:l,release:s,type:c,cpus:f,totalmem:a,freemem:i,uptime:u,loadavg:o,hostname:e,endianness:t};export{A as EOL,p as arch,f as cpus,g as default,t as endianness,i as freemem,l as getNetworkInterfaces,E as homedir,e as hostname,o as loadavg,m as networkInterfaces,v as platform,s as release,d as tmpDir,w as tmpdir,a as totalmem,c as type,u as uptime};

package/dist/esm/node_modules/.pnpm/debug@4.3.5/node_modules/debug/src/node.js

@@ -1 +1 @@
-import{__module as t}from"../../../../../../_virtual/node.js";import e from"../../../../../../_virtual/__polyfill-node.tty.js";import s from"../../../../../../_virtual/__polyfill-node.util.js";import{__require as o}from"../../../../supports-color@8.1.1/node_modules/supports-color/browser.js";import{__require as r}from"./common.js";var n;function i(){return n||(n=1,function(t,n){const i=e,p=s;n.init=function(t){t.inspectOpts={};const e=Object.keys(n.inspectOpts);for(let s=0;s<e.length;s++)t.inspectOpts[e[s]]=n.inspectOpts[e[s]]},n.log=function(...t){return process.stderr.write(p.formatWithOptions(n.inspectOpts,...t)+"\n")},n.formatArgs=function(e){const{namespace:s,useColors:o}=this;if(o){const o=this.color,r="[3"+(o<8?o:"8;5;"+o),n=`  ${r};1m${s} `;e[0]=n+e[0].split("\n").join("\n"+n),e.push(r+"m+"+t.exports.humanize(this.diff)+"")}else e[0]=function(){if(n.inspectOpts.hideDate)return"";return(new Date).toISOString()+" "}()+s+" "+e[0]},n.save=function(t){t?process.env.DEBUG=t:delete process.env.DEBUG},n.load=function(){return process.env.DEBUG},n.useColors=function(){return"colors"in n.inspectOpts?Boolean(n.inspectOpts.colors):i.isatty(process.stderr.fd)},n.destroy=p.deprecate((()=>{}),"Instance method `debug.destroy()` is deprecated and no longer does anything. It will be removed in the next major version of `debug`."),n.colors=[6,2,3,4,5,1];try{const t=o();t&&(t.stderr||t).level>=2&&(n.colors=[20,21,26,27,32,33,38,39,40,41,42,43,44,45,56,57,62,63,68,69,74,75,76,77,78,79,80,81,92,93,98,99,112,113,128,129,134,135,148,149,160,161,162,163,164,165,166,167,168,169,170,171,172,173,178,179,184,185,196,197,198,199,200,201,202,203,204,205,206,207,208,209,214,215,220,221])}catch(t){}n.inspectOpts=Object.keys(process.env).filter((t=>/^debug_/i.test(t))).reduce(((t,e)=>{const s=e.substring(6).toLowerCase().replace(/_([a-z])/g,((t,e)=>e.toUpperCase()));let o=process.env[e];return o=!!/^(yes|on|true|enabled)$/i.test(o)||!/^(no|off|false|disabled)$/i.test(o)&&("null"===o?null:Number(o)),t[s]=o,t}),{}),t.exports=r()(n);const{formatters:c}=t.exports;c.o=function(t){return this.inspectOpts.colors=this.useColors,p.inspect(t,this.inspectOpts).split("\n").map((t=>t.trim())).join(" ")},c.O=function(t){return this.inspectOpts.colors=this.useColors,p.inspect(t,this.inspectOpts)}}(t,t.exports)),t.exports}export{i as __require};
+import{__module as t}from"../../../../../../_virtual/node.js";import e from"../../../../../../_virtual/__polyfill-node.tty.js";import s from"../../../../../../_virtual/__polyfill-node.util.js";import{__require as o}from"../../../../supports-color@7.2.0/node_modules/supports-color/index.js";import{__require as r}from"./common.js";var n;function i(){return n||(n=1,function(t,n){const i=e,p=s;n.init=function(t){t.inspectOpts={};const e=Object.keys(n.inspectOpts);for(let s=0;s<e.length;s++)t.inspectOpts[e[s]]=n.inspectOpts[e[s]]},n.log=function(...t){return process.stderr.write(p.formatWithOptions(n.inspectOpts,...t)+"\n")},n.formatArgs=function(e){const{namespace:s,useColors:o}=this;if(o){const o=this.color,r="[3"+(o<8?o:"8;5;"+o),n=`  ${r};1m${s} `;e[0]=n+e[0].split("\n").join("\n"+n),e.push(r+"m+"+t.exports.humanize(this.diff)+"")}else e[0]=function(){if(n.inspectOpts.hideDate)return"";return(new Date).toISOString()+" "}()+s+" "+e[0]},n.save=function(t){t?process.env.DEBUG=t:delete process.env.DEBUG},n.load=function(){return process.env.DEBUG},n.useColors=function(){return"colors"in n.inspectOpts?Boolean(n.inspectOpts.colors):i.isatty(process.stderr.fd)},n.destroy=p.deprecate((()=>{}),"Instance method `debug.destroy()` is deprecated and no longer does anything. It will be removed in the next major version of `debug`."),n.colors=[6,2,3,4,5,1];try{const t=o();t&&(t.stderr||t).level>=2&&(n.colors=[20,21,26,27,32,33,38,39,40,41,42,43,44,45,56,57,62,63,68,69,74,75,76,77,78,79,80,81,92,93,98,99,112,113,128,129,134,135,148,149,160,161,162,163,164,165,166,167,168,169,170,171,172,173,178,179,184,185,196,197,198,199,200,201,202,203,204,205,206,207,208,209,214,215,220,221])}catch(t){}n.inspectOpts=Object.keys(process.env).filter((t=>/^debug_/i.test(t))).reduce(((t,e)=>{const s=e.substring(6).toLowerCase().replace(/_([a-z])/g,((t,e)=>e.toUpperCase()));let o=process.env[e];return o=!!/^(yes|on|true|enabled)$/i.test(o)||!/^(no|off|false|disabled)$/i.test(o)&&("null"===o?null:Number(o)),t[s]=o,t}),{}),t.exports=r()(n);const{formatters:c}=t.exports;c.o=function(t){return this.inspectOpts.colors=this.useColors,p.inspect(t,this.inspectOpts).split("\n").map((t=>t.trim())).join(" ")},c.O=function(t){return this.inspectOpts.colors=this.useColors,p.inspect(t,this.inspectOpts)}}(t,t.exports)),t.exports}export{i as __require};

package/dist/esm/node_modules/.pnpm/has-flag@4.0.0/node_modules/has-flag/index.js

@@ -0,0 +1 @@
+var r,e;function t(){return e?r:(e=1,r=(r,e=process.argv)=>{const t=r.startsWith("-")?"":1===r.length?"-":"--",n=e.indexOf(t+r),s=e.indexOf("--");return-1!==n&&(-1===s||n<s)})}export{t as __require};

package/dist/esm/node_modules/.pnpm/supports-color@7.2.0/node_modules/supports-color/index.js

@@ -0,0 +1 @@
+import r from"../../../../../_virtual/__polyfill-node.os.js";import o from"../../../../../_virtual/__polyfill-node.tty.js";import{__require as e}from"../../../has-flag@4.0.0/node_modules/has-flag/index.js";var t,n;function i(){if(n)return t;n=1;const i=r,s=o,l=e(),{env:u}=process;let c;function R(r){return 0!==r&&{level:r,hasBasic:!0,has256:r>=2,has16m:r>=3}}function a(r,o){if(0===c)return 0;if(l("color=16m")||l("color=full")||l("color=truecolor"))return 3;if(l("color=256"))return 2;if(r&&!o&&void 0===c)return 0;const e=c||0;if("dumb"===u.TERM)return e;if("win32"===process.platform){const r=i.release().split(".");return Number(r[0])>=10&&Number(r[2])>=10586?Number(r[2])>=14931?3:2:1}if("CI"in u)return["TRAVIS","CIRCLECI","APPVEYOR","GITLAB_CI","GITHUB_ACTIONS","BUILDKITE"].some((r=>r in u))||"codeship"===u.CI_NAME?1:e;if("TEAMCITY_VERSION"in u)return/^(9\.(0*[1-9]\d*)\.|\d{2,}\.)/.test(u.TEAMCITY_VERSION)?1:0;if("truecolor"===u.COLORTERM)return 3;if("TERM_PROGRAM"in u){const r=parseInt((u.TERM_PROGRAM_VERSION||"").split(".")[0],10);switch(u.TERM_PROGRAM){case"iTerm.app":return r>=3?3:2;case"Apple_Terminal":return 2}}return/-256(color)?$/i.test(u.TERM)?2:/^screen|^xterm|^vt100|^vt220|^rxvt|color|ansi|cygwin|linux/i.test(u.TERM)||"COLORTERM"in u?1:e}return l("no-color")||l("no-colors")||l("color=false")||l("color=never")?c=0:(l("color")||l("colors")||l("color=true")||l("color=always"))&&(c=1),"FORCE_COLOR"in u&&(c="true"===u.FORCE_COLOR?1:"false"===u.FORCE_COLOR?0:0===u.FORCE_COLOR.length?1:Math.min(parseInt(u.FORCE_COLOR,10),3)),t={supportsColor:function(r){return R(a(r,r&&r.isTTY))},stdout:R(a(!0,s.isatty(1))),stderr:R(a(!0,s.isatty(2)))}}export{i as __require};

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

@@ -0,0 +1,2 @@
+export * from './private/index';
+export * from './public/index';

package/dist/esm/packages/teams-js/dts/internal/VideoFrameTypes.d.ts

@@ -0,0 +1,78 @@
+/**
+ * @beta
+ * @hidden
+ * Align with the W3C spec: https://www.w3.org/TR/webcodecs/
+ */
+export type VideoPixelFormat = 'BGRA' | 'BGRX' | 'I420' | 'I420A' | 'I422' | 'I444' | 'NV12' | 'RGBA' | 'RGBX';
+/**
+ * @beta
+ * @hidden
+ * Align with the W3C spec: https://www.w3.org/TR/webcodecs/
+ */
+export type AllowSharedBufferSource = ArrayBuffer | ArrayBufferView;
+/**
+ * @beta
+ * @hidden
+ * Align with the W3C spec: https://www.w3.org/TR/webcodecs/
+ */
+export type AlphaOption = 'discard' | 'keep';
+/**
+ * @beta
+ * @hidden
+ * Align with the W3C spec: https://www.w3.org/TR/webcodecs/
+ */
+export interface PlaneLayout {
+    /**
+     * The offset in bytes where the given plane begins within a BufferSource.
+     */
+    offset: number;
+    /**
+     * The number of bytes, including padding, used by each row of the plane within a BufferSource.
+     */
+    stride: number;
+}
+/**
+ * @beta
+ * @hidden
+ * Align with the W3C spec: https://www.w3.org/TR/webcodecs/
+ */
+export interface VideoFrameCopyToOptions {
+    /**
+     * The PlaneLayout for each plane in VideoFrame
+     */
+    layout?: PlaneLayout[] | undefined;
+    /**
+     * A DOMRectInit describing the rectangle of pixels to copy from the VideoFrame
+     */
+    rect?: DOMRectInit | undefined;
+}
+/**
+ * @beta
+ * @hidden
+ * Align with the W3C spec: https://www.w3.org/TR/webcodecs/
+ */
+export interface VideoFrameInit {
+    alpha?: AlphaOption | undefined;
+    displayHeight?: number | undefined;
+    displayWidth?: number | undefined;
+    duration?: number | undefined;
+    timestamp?: number | undefined;
+    visibleRect?: DOMRectInit | undefined;
+}
+/**
+ * @beta
+ * @hidden
+ * Align with the W3C spec: https://www.w3.org/TR/webcodecs/
+ */
+export interface VideoFrameBufferInit {
+    codedHeight: number;
+    codedWidth: number;
+    colorSpace?: VideoColorSpaceInit | undefined;
+    displayHeight?: number | undefined;
+    displayWidth?: number | undefined;
+    duration?: number | undefined;
+    format: VideoPixelFormat;
+    layout?: PlaneLayout[] | undefined;
+    timestamp: number;
+    visibleRect?: DOMRectInit | undefined;
+}

package/dist/esm/packages/teams-js/dts/internal/appHelpers.d.ts

@@ -0,0 +1,8 @@
+import * as app from '../public/app';
+export declare function appInitializeHelper(apiVersionTag: string, validMessageOrigins?: string[]): Promise<void>;
+export declare function notifyAppLoadedHelper(apiVersionTag: string): void;
+export declare function notifyExpectedFailureHelper(apiVersionTag: string, expectedFailureRequest: app.IExpectedFailureRequest): void;
+export declare function notifyFailureHelper(apiVersiontag: string, appInitializationFailedRequest: app.IFailedRequest): void;
+export declare function notifySuccessHelper(apiVersionTag: string): void;
+export declare function registerOnThemeChangeHandlerHelper(apiVersionTag: string, handler: app.themeHandler): void;
+export declare function openLinkHelper(apiVersionTag: string, deepLink: string): Promise<void>;

package/dist/esm/packages/teams-js/dts/internal/appIdValidation.d.ts

@@ -0,0 +1,16 @@
+/**
+ * This function can be used to validate if a string is a "valid" app id.
+ * Valid is a relative term, in this case. Truly valid app ids are UUIDs as documented in the schema:
+ * https://learn.microsoft.com/en-us/microsoftteams/platform/resources/schema/manifest-schema#id
+ * However, there are some older internal/hard-coded apps which violate this schema and use names like com.microsoft.teamspace.tab.youtube.
+ * For compatibility with these legacy apps, we unfortunately cannot securely and completely validate app ids as UUIDs. Based
+ * on this, the validation is limited to checking for script tags, length, and non-printable characters.
+ *
+ * @param potentialAppId A string to check if it's a "valid" app id
+ * @throws Error with a message describing the exact validation violation
+ */
+export declare function validateStringAsAppId(potentialAppId: string): void;
+export declare const minimumValidAppIdLength = 4;
+export declare const maximumValidAppIdLength = 256;
+export declare function isStringWithinAppIdLengthLimits(potentialAppId: string): boolean;
+export declare function doesStringContainNonPrintableCharacters(str: string): boolean;

package/dist/esm/packages/teams-js/dts/internal/communication.d.ts

@@ -0,0 +1,162 @@
+import { FrameContexts } from '../public/constants';
+import { ISerializable } from '../public/serializable.interface';
+import { NestedAppAuthRequest } from './nestedAppAuthUtils';
+import { ResponseHandler, SimpleType } from './responseHandler';
+/**
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare class Communication {
+    static currentWindow: Window | any;
+    static parentOrigin: string | null;
+    static parentWindow: Window | any;
+    static childWindow: Window | null;
+    static childOrigin: string | null;
+    static topWindow: Window | any;
+    static topOrigin: string | null;
+}
+/**
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+interface InitializeResponse {
+    context: FrameContexts;
+    clientType: string;
+    runtimeConfig: string;
+    clientSupportedSDKVersion: string;
+}
+/**
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function initializeCommunication(validMessageOrigins: string[] | undefined, apiVersionTag: string): Promise<InitializeResponse>;
+/**
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function uninitializeCommunication(): void;
+/**
+ * @deprecated This function is deprecated and will be removed in a future release. Please use {@link callFunctionInHostAndHandleResponse} or {@link callFunctionInHost} instead.
+ * @hidden
+ * Send a message to parent and then unwrap result. Uses nativeInterface on mobile to communicate with parent context
+ * Additional apiVersionTag parameter is added, which provides the ability to send api version number to parent
+ * for telemetry work.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function sendAndUnwrap<T>(apiVersionTag: string, actionName: string, ...args: any[]): Promise<T>;
+/**
+ * @deprecated This function is deprecated and will be removed in a future release. Please use {@link callFunctionInHostAndHandleResponse} or {@link callFunctionInHost} instead.
+ * @hidden
+ * Send a message to parent and then handle status and reason. Uses nativeInterface on mobile to communicate with parent context
+ * Additional apiVersionTag parameter is added, which provides the ability to send api version number to parent
+ * for telemetry work.
+ */
+export declare function sendAndHandleStatusAndReason(apiVersionTag: string, actionName: string, ...args: any[]): Promise<void>;
+/**
+ * @deprecated This function is deprecated and will be removed in a future release. Please use {@link callFunctionInHostAndHandleResponse} or {@link callFunctionInHost} instead.
+ * @hidden
+ * Send a message to parent and then handle status and reason with default error. Uses nativeInterface on mobile to communicate with parent context
+ * Additional apiVersionTag parameter is added, which provides the ability to send api version number to parent
+ * for telemetry work.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function sendAndHandleStatusAndReasonWithDefaultError(apiVersionTag: string, actionName: string, defaultError: string, ...args: any[]): Promise<void>;
+/**
+ * @deprecated This function is deprecated and will be removed in a future release. Please use {@link callFunctionInHostAndHandleResponse} or {@link callFunctionInHost} instead.
+ * @hidden
+ * Send a message to parent and then handle SDK error. Uses nativeInterface on mobile to communicate with parent context
+ * Additional apiVersionTag parameter is added, which provides the ability to send api version number to parent
+ * for telemetry work.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function sendAndHandleSdkError<T>(apiVersionTag: string, actionName: string, ...args: any[]): Promise<T>;
+/**
+ * @deprecated This function will no longer be exported in a future release. Please use {@link callFunctionInHostAndHandleResponse} or {@link callFunctionInHost} instead.
+ * @hidden
+ * Send a message to parent asynchronously. Uses nativeInterface on mobile to communicate with parent context
+ * Additional apiVersionTag parameter is added, which provides the ability to send api version number to parent
+ * for telemetry work.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function sendMessageToParentAsync<T>(apiVersionTag: string, actionName: string, args?: any[] | undefined): Promise<T>;
+/**
+ * Call a function in the host and receive a response. If the host returns an {@link SdkError} instead of a normal response, this function will throw a new Error containing the SdkError's information
+ *
+ * @param functionName The function name to call in the host.
+ * @param args A collection of data to pass to the host. This data must be an array of either simple types or objects that implement {@link ISerializable}.
+ * @param responseHandler When the host responds, this handler will validate and deserialize the response.
+ * @param apiVersionTag A unique tag used to identify the API version for telemetry purposes. This should be set using {@link getApiVersionTag}, which should be passed a unique string identifying the function being called by the app developer as well as a version number that is incremented whenever meaningful changes are made to that function.
+ * @param isResponseAReportableError This optional property can be used to override the default ErrorChecking this function uses to decide whether to throw the host response as a new Error. Specify this if your function needs to do any logic verifying that the object received is an error that goes beyond the logic found in {@link isSdkError}.
+ *
+ * @returns The response received from the host after deserialization.
+ *
+ * @throws An Error containing the SdkError information ({@link SdkError.errorCode} and {@link SdkError.message}) if the host returns an SdkError, or an Error if the response from the host is an unexpected format.
+ */
+export declare function callFunctionInHostAndHandleResponse<SerializedReturnValueFromHost, DeserializedReturnValueFromHost>(functionName: string, args: (SimpleType | ISerializable)[], responseHandler: ResponseHandler<SerializedReturnValueFromHost, DeserializedReturnValueFromHost>, apiVersionTag: string, isResponseAReportableError?: (response: unknown) => response is {
+    errorCode: number | string;
+    message?: string;
+}): Promise<DeserializedReturnValueFromHost>;
+/**
+ * Call a function in the host that receives either an {@link SdkError} or undefined as a response. If the host returns an {@link SdkError} this function will throw a new Error containing the SdkError's information.
+ *
+ * @param functionName The function name to call in the host.
+ * @param args A collection of data to pass to the host. This data must be an array of either simple types or objects that implement {@link ISerializable}.
+ * @param apiVersionTag A unique tag used to identify the API version for telemetry purposes. This should be set using {@link getApiVersionTag}, which should be passed a unique string identifying the function being called by the app developer as well as a version number that is incremented whenever meaningful changes are made to that function.
+ * @param isResponseAReportableError This optional property can be used to override the default ErrorChecking this function uses to decide whether to throw the host response as a new Error. Specify this is your function needs to do any logic verifying that the object received is an error that goes beyond the logic found in {@link isSdkError}.
+ *
+ * @throws An Error containing the SdkError information ({@link SdkError.errorCode} and {@link SdkError.message}) if the host returns an SdkError, or an Error if the response from the host is an unexpected format.
+ */
+export declare function callFunctionInHost(functionName: string, args: (SimpleType | ISerializable)[], apiVersionTag: string, isResponseAReportableError?: (response: unknown) => response is {
+    errorCode: number | string;
+    message?: string;
+}): Promise<void>;
+/**
+ * @hidden
+ * Send a message to parent requesting a MessageChannel Port.
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function requestPortFromParentWithVersion(apiVersionTag: string, actionName: string, args?: any[] | undefined): Promise<MessagePort>;
+/**
+ * @deprecated This function is deprecated and will be removed in a future release. Please use {@link callFunctionInHostAndHandleResponse} or {@link callFunctionInHost} instead.
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function sendMessageToParent(apiVersionTag: string, actionName: string, callback?: Function): void;
+/**
+ * @deprecated This function is deprecated and will be removed in a future release. Please use {@link callFunctionInHostAndHandleResponse} or {@link callFunctionInHost} instead.
+ * @hidden
+ * Send a message to parent. Uses nativeInterface on mobile to communicate with parent context
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function sendMessageToParent(apiVersionTag: string, actionName: string, args: any[] | undefined, callback?: Function): void;
+/**
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function sendNestedAuthRequestToTopWindow(message: string): NestedAppAuthRequest;
+/**
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function waitForMessageQueue(targetWindow: Window, callback: () => void): void;
+/**
+ * @hidden
+ * Send a custom message object that can be sent to child window,
+ * instead of a response message to a child
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function sendMessageEventToChild(actionName: string, args?: any[]): void;
+export {};

package/dist/esm/packages/teams-js/dts/internal/constants.d.ts

@@ -0,0 +1,146 @@
+/**
+ * @hidden
+ * The client version when all SDK APIs started to check platform compatibility for the APIs was 1.6.0.
+ * Modified to 2.0.1 which is hightest till now so that if any client doesn't pass version in initialize function, it will be set to highest.
+ * Mobile clients are passing versions, hence will be applicable to web and desktop clients only.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare const defaultSDKVersionForCompatCheck = "2.0.1";
+/**
+ * @hidden
+ * This is the client version when selectMedia API - VideoAndImage is supported on mobile.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare const videoAndImageMediaAPISupportVersion = "2.0.2";
+/**
+ * @hidden
+ * This is the client version when selectMedia API - Video with non-full screen mode is supported on mobile.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare const nonFullScreenVideoModeAPISupportVersion = "2.0.3";
+/**
+ * @hidden
+ * This is the client version when selectMedia API - ImageOutputFormats is supported on mobile.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare const imageOutputFormatsAPISupportVersion = "2.0.4";
+/**
+ * @hidden
+ * Minimum required client supported version for {@link getUserJoinedTeams} to be supported on {@link HostClientType.android}
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare const getUserJoinedTeamsSupportedAndroidClientVersion = "2.0.1";
+/**
+ * @hidden
+ * This is the client version when location APIs (getLocation and showLocation) are supported.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare const locationAPIsRequiredVersion = "1.9.0";
+/**
+ * @hidden
+ * This is the client version when permisisons are supported
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare const permissionsAPIsRequiredVersion = "2.0.1";
+/**
+ * @hidden
+ * This is the client version when people picker API is supported on mobile.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare const peoplePickerRequiredVersion = "2.0.0";
+/**
+ * @hidden
+ * This is the client version when captureImage API is supported on mobile.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare const captureImageMobileSupportVersion = "1.7.0";
+/**
+ * @hidden
+ * This is the client version when media APIs are supported on all three platforms ios, android and web.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare const mediaAPISupportVersion = "1.8.0";
+/**
+ * @hidden
+ * This is the client version when getMedia API is supported via Callbacks on all three platforms ios, android and web.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare const getMediaCallbackSupportVersion = "2.0.0";
+/**
+ * @hidden
+ * This is the client version when scanBarCode API is supported on mobile.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare const scanBarCodeAPIMobileSupportVersion = "1.9.0";
+/**
+ * @hidden
+ * Fallback list of valid origins
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare const validOriginsFallback: string[];
+/**
+ * @hidden
+ * CDN endpoint of the list of valid origins
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare const validOriginsCdnEndpoint: URL;
+/**
+ * @hidden
+ * USer specified message origins should satisfy this test
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare const userOriginUrlValidationRegExp: RegExp;
+/**
+ * @hidden
+ * The protocol used for deep links into Teams
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare const teamsDeepLinkProtocol = "https";
+/**
+ * @hidden
+ * The host used for deep links into Teams
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare const teamsDeepLinkHost = "teams.microsoft.com";
+/** @hidden */
+export declare const errorLibraryNotInitialized = "The library has not yet been initialized";
+/** @hidden */
+export declare const errorRuntimeNotInitialized = "The runtime has not yet been initialized";
+/** @hidden */
+export declare const errorRuntimeNotSupported = "The runtime version is not supported";
+/** @hidden */
+export declare const errorCallNotStarted = "The call was not properly started";

package/dist/esm/packages/teams-js/dts/internal/deepLinkConstants.d.ts

@@ -0,0 +1,26 @@
+/**
+ * App install dialog constants
+ */
+export declare const teamsDeepLinkUrlPathForAppInstall = "/l/app/";
+/**
+ * Calendar constants
+ */
+export declare const teamsDeepLinkUrlPathForCalendar = "/l/meeting/new";
+export declare const teamsDeepLinkAttendeesUrlParameterName = "attendees";
+export declare const teamsDeepLinkStartTimeUrlParameterName = "startTime";
+export declare const teamsDeepLinkEndTimeUrlParameterName = "endTime";
+export declare const teamsDeepLinkSubjectUrlParameterName = "subject";
+export declare const teamsDeepLinkContentUrlParameterName = "content";
+/**
+ * Call constants
+ */
+export declare const teamsDeepLinkUrlPathForCall = "/l/call/0/0";
+export declare const teamsDeepLinkSourceUrlParameterName = "source";
+export declare const teamsDeepLinkWithVideoUrlParameterName = "withVideo";
+/**
+ * Chat constants
+ */
+export declare const teamsDeepLinkUrlPathForChat = "/l/chat/0/0";
+export declare const teamsDeepLinkUsersUrlParameterName = "users";
+export declare const teamsDeepLinkTopicUrlParameterName = "topicName";
+export declare const teamsDeepLinkMessageUrlParameterName = "message";

package/dist/esm/packages/teams-js/dts/internal/deepLinkUtilities.d.ts

@@ -0,0 +1,4 @@
+export declare function createTeamsDeepLinkForChat(users: string[], topic?: string, message?: string): string;
+export declare function createTeamsDeepLinkForCall(targets: string[], withVideo?: boolean, source?: string): string;
+export declare function createTeamsDeepLinkForCalendar(attendees?: string[], startTime?: string, endTime?: string, subject?: string, content?: string): string;
+export declare function createTeamsDeepLinkForAppInstallDialog(appId: string): string;

package/dist/esm/packages/teams-js/dts/internal/emailAddressValidation.d.ts

@@ -0,0 +1 @@
+export declare function validateEmailAddress(emailString: string | null | undefined): void;

package/dist/esm/packages/teams-js/dts/internal/globalVars.d.ts

@@ -0,0 +1,12 @@
+import { FrameContexts } from '../public/constants';
+export declare class GlobalVars {
+    static initializeCalled: boolean;
+    static initializeCompleted: boolean;
+    static additionalValidOrigins: string[];
+    static initializePromise: Promise<void> | undefined;
+    static isFramelessWindow: boolean;
+    static frameContext: FrameContexts | undefined;
+    static hostClientType: string | undefined;
+    static clientSupportedSDKVersion: string;
+    static printCapabilityEnabled: boolean;
+}

package/dist/esm/packages/teams-js/dts/internal/handlers.d.ts

@@ -0,0 +1,80 @@
+import { FrameContexts } from '../public/constants';
+import { LoadContext, ResumeContext } from '../public/interfaces';
+/**
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function initializeHandlers(): void;
+/**
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function uninitializeHandlers(): void;
+/**
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function callHandler(name: string, args?: unknown[]): [true, unknown] | [false, undefined];
+/**
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function registerHandler(apiVersionTag: string, name: string, handler: Function, sendMessage?: boolean, args?: unknown[]): void;
+/**
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function removeHandler(name: string): void;
+/**
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function doesHandlerExist(name: string): boolean;
+/**
+ * @hidden
+ * Undocumented helper function with shared code between deprecated version and current version of register*Handler APIs
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ *
+ * @param apiVersionTag - The tag of the api version and name
+ * @param name - The name of the handler to register.
+ * @param handler - The handler to invoke.
+ * @param contexts - The context within which it is valid to register this handler.
+ * @param registrationHelper - The helper function containing logic pertaining to a specific version of the API.
+ */
+export declare function registerHandlerHelper(apiVersionTag: string, name: string, handler: Function, contexts: FrameContexts[], registrationHelper?: () => void): void;
+/**
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function registerOnThemeChangeHandler(apiVersionTag: string, handler: (theme: string) => void): void;
+/**
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function handleThemeChange(theme: string): void;
+/**
+ * @internal
+ * Limited to Microsoft-internal use
+ *
+ * @deprecated
+ */
+export declare function registerOnLoadHandler(apiVersionTag: string, handler: (context: LoadContext) => void): void;
+/**
+ * @internal
+ * Limited to Microsoft-internal use
+ *
+ * @deprecated
+ */
+export declare function registerBeforeUnloadHandler(apiVersionTag: string, handler: (readyToUnload: () => void) => boolean): void;
+/**
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function registerBeforeSuspendOrTerminateHandler(handler: () => Promise<void>): void;
+/**
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function registerOnResumeHandler(handler: (context: ResumeContext) => void): void;

package/dist/esm/packages/teams-js/dts/internal/interfaces.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @hidden
+ * Hide from docs
+ * Shim in definitions used for browser-compat
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export interface DOMMessageEvent {
+    origin?: any;
+    source?: any;
+    data?: any;
+    ports?: any;
+    originalEvent: DOMMessageEvent;
+}
+/**
+ * @hidden
+ * Hide from docs
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export interface TeamsNativeClient {
+    framelessPostMessage(msg: string): void;
+}
+/**
+ * @hidden
+ * Hide from docs
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export interface ExtendedWindow extends Window {
+    nativeInterface: TeamsNativeClient;
+    onNativeMessage(evt: DOMMessageEvent): void;
+}
+/**
+ * @hidden
+ * Meant for Message objects that are sent to children without id
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export interface DOMMessageEvent {
+    func: string;
+    args?: any[];
+}