@jevelin/bridge 2.53.0

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
+ * Timeout length for Fetch Call for Valid Origins
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare const ORIGIN_LIST_FETCH_TIMEOUT_IN_MS: number;
+/**
+ * @hidden
+ * CDN endpoint of the list of valid origins
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare const validOriginsCdnEndpoint: URL;
+/**
+ * @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/dialogHelpers.d.ts

@@ -0,0 +1,32 @@
+import * as dialog from '../public/dialog/dialog';
+import { AdaptiveCardDialogInfo, BotAdaptiveCardDialogInfo } from '../public/interfaces';
+import { BotUrlDialogInfo, DialogInfo, DialogSize, UrlDialogInfo } from '../public/interfaces';
+import { ApiVersionNumber } from './telemetry';
+/**
+ * v2 APIs telemetry file: All of APIs in this capability file should send out API version v2 ONLY
+ */
+export declare const dialogTelemetryVersionNumber: ApiVersionNumber;
+export declare function updateResizeHelper(apiVersionTag: string, dimensions: DialogSize): void;
+export declare function urlOpenHelper(apiVersionTag: string, urlDialogInfo: UrlDialogInfo, submitHandler?: dialog.DialogSubmitHandler, messageFromChildHandler?: dialog.PostMessageChannel): void;
+export declare function botUrlOpenHelper(apiVersionTag: string, urlDialogInfo: BotUrlDialogInfo, submitHandler?: dialog.DialogSubmitHandler, messageFromChildHandler?: dialog.PostMessageChannel): void;
+export declare function urlSubmitHelper(apiVersionTag: string, result?: string | object, appIds?: string | string[]): void;
+/**
+ * @hidden
+ * Hide from docs
+ * --------
+ * Convert AdaptiveCardDialogInfo to DialogInfo to send the information to host in {@linkcode adaptiveCard.open} API.
+ *
+ * @internal
+ */
+export declare function getDialogInfoFromAdaptiveCardDialogInfo(adaptiveCardDialogInfo: AdaptiveCardDialogInfo): DialogInfo;
+/**
+ * @hidden
+ * Hide from docs
+ * --------
+ * Convert BotAdaptiveCardDialogInfo to DialogInfo to send the information to host in {@linkcode adaptiveCard.open} API.
+ *
+ * @internal
+ */
+export declare function getDialogInfoFromBotAdaptiveCardDialogInfo(botAdaptiveCardDialogInfo: BotAdaptiveCardDialogInfo): DialogInfo;
+export declare const storedMessages: string[];
+export declare function handleDialogMessage(message: string): void;

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,13 @@
+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;
+    static readonly teamsJsInstanceId: string;
+}

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

@@ -0,0 +1,101 @@
+import { Context } from '../public/app/app';
+import { FrameContexts } from '../public/constants';
+import { HostToAppPerformanceMetrics, 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 registerOnContextChangeHandler(apiVersionTag: string, handler: (context: Context) => void): void;
+/**
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function handleThemeChange(theme: string): void;
+/**
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function handleContextChange(context: Context): void;
+/**
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function registerHostToAppPerformanceMetricsHandler(handler: (metrics: HostToAppPerformanceMetrics) => void): void;
+/**
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function handleHostToAppPerformanceMetrics(metrics: HostToAppPerformanceMetrics): 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/hostToAppTelemetry.d.ts

@@ -0,0 +1,51 @@
+import { Debugger } from 'debug';
+import { UUID as MessageUUID } from '../public/uuidObject';
+import { CallbackInformation } from './interfaces';
+import { MessageRequest, MessageResponse } from './messageObjects';
+/**
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export default class HostToAppMessageDelayTelemetry {
+    private static callbackInformation;
+    /**
+     * @internal
+     * Limited to Microsoft-internal use
+     *
+     * Store information about a particular message.
+     * @param messageUUID The message id for the request.
+     * @param callbackInformation The information of the callback.
+     */
+    static storeCallbackInformation(messageUUID: MessageUUID, callbackInformation: CallbackInformation): void;
+    /**
+     * @internal
+     * Limited to Microsoft-internal use
+     */
+    static clearMessages(): void;
+    /**
+     * @internal
+     * Limited to Microsoft-internal use
+     */
+    static deleteMessageInformation(callbackId: MessageUUID): void;
+    /**
+     * @internal
+     * Limited to Microsoft-internal use
+     *
+     * Executes telemetry actions related to host to app performance metrics where event is raised in the host.
+     * @param message The request from the host.
+     * @param logger The logger in case an error occurs.
+     * @param endTime The ending time for calculating the elapsed time
+     */
+    static handleOneWayPerformanceMetrics(message: MessageRequest, logger: Debugger, endTime?: number): void;
+    /**
+     * @internal
+     * Limited to Microsoft-internal use
+     *
+     * Executes telemetry actions related to host to app performance metrics.
+     * @param callbackId The message id for the request.
+     * @param message The response from the host.
+     * @param logger The logger in case an error occurs.
+     * @param endTime The ending time for calculating the elapsed time
+     */
+    static handlePerformanceMetrics(callbackID: MessageUUID, message: MessageResponse, logger: Debugger, endTime?: number): void;
+}

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

@@ -0,0 +1,37 @@
+import { AppId } from '../public/appId';
+import { ValidatedSafeString } from '../public/validatedSafeString';
+/**
+ * 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 validateStringLength(potentialAppId: string): void;
+export declare function validateSafeContent(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;
+/**
+ * @hidden
+ * Checks if the incoming app id is an instance of AppId
+ * @param potentialAppId An object to check if it's an instance of AppId
+ * @throws Error with a message describing the violation
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function validateAppIdInstance(potentialAppId: AppId): void;
+/**
+ * @hidden
+ * Checks if the incoming string is an instance of ValidatedSafeString
+ * @param incomingString An object to check if it's an instance of ValidatedSafeString
+ * @throws Error with a message describing the violation
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function validateSafeStringInstance(incomingString: ValidatedSafeString): void;

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

@@ -0,0 +1,58 @@
+/**
+ * @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[];
+}
+/**
+ * @hidden
+ * Meant for providing information related to certain callback context.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export interface CallbackInformation {
+    name: string;
+    calledAt: number;
+}

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

@@ -0,0 +1,61 @@
+import { IBaseRuntime, Runtime } from '../public/runtime';
+/**
+ * Ensures `initialize` was called. This function does NOT verify that a response from Host was received and initialization completed.
+ *
+ * `ensureInitializeCalled` should only be used for APIs which:
+ * - work in all FrameContexts
+ * - are part of a required Capability
+ * - are suspected to be used directly after calling `initialize`, potentially without awaiting the `initialize` call itself
+ *
+ * For most APIs {@link ensureInitialized} is the right validation function to use instead.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function ensureInitializeCalled(): void;
+/**
+ * Ensures `initialize` was called and response from Host was received and processed and that `runtime` is initialized.
+ * If expected FrameContexts are provided, it also validates that the current FrameContext matches one of the expected ones.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function ensureInitialized(runtime: IBaseRuntime, ...expectedFrameContexts: string[]): runtime is Runtime;
+/**
+ * @hidden
+ * Checks whether the platform has knowledge of this API by doing a comparison
+ * on API required version and platform supported version of the SDK
+ *
+ * @param requiredVersion - SDK version required by the API
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function isCurrentSDKVersionAtLeast(requiredVersion?: string): boolean;
+/**
+ * @hidden
+ * Helper function to identify if host client is either android, ios, ipados, or visionOS
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function isHostClientMobile(): boolean;
+/**
+ * @hidden
+ * Helper function which indicates if current API is supported on mobile or not.
+ * @throws SdkError if host client is not android/ios or if the requiredVersion is not
+ *          supported by platform or not. Null is returned in case of success.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function throwExceptionIfMobileApiIsNotSupported(requiredVersion?: string): void;
+/**
+ * @hidden
+ * Processes the valid origins specifuied by the user, de-duplicates and converts them into a regexp
+ * which is used later for message source/origin validation
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function processAdditionalValidOrigins(validMessageOrigins: string[]): void;

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

@@ -0,0 +1,94 @@
+import * as marketplace from '../public/marketplace';
+/**
+ * @hidden
+ * deserialize the cart data:
+ * - convert url properties from string to URL
+ * @param cartItems The cart items
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function deserializeCart(cartData: any): marketplace.Cart;
+/**
+ * @hidden
+ * deserialize the cart items:
+ * - convert url properties from string to URL
+ * @param cartItems The cart items
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function deserializeCartItems(cartItemsData: any): marketplace.CartItem;
+/**
+ * @hidden
+ * serialize the cart items:
+ * - make URL properties to string
+ * @param cartItems The cart items
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare const serializeCartItems: (cartItems: marketplace.CartItem[]) => any;
+/**
+ * @hidden
+ * Validate the cart item properties are valid
+ * @param cartItems The cart items
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function validateCartItems(cartItems: marketplace.CartItem[]): void;
+/**
+ * @hidden
+ * Validate accessories
+ * @param accessoryItems The accessories to be validated
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function validateAccessoryItems(accessoryItems: marketplace.Item[] | undefined | null): void;
+/**
+ * @hidden
+ * Validate the basic cart item properties are valid
+ * @param basicCartItem The basic cart item
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function validateBasicCartItem(basicCartItem: marketplace.Item): void;
+/**
+ * @hidden
+ * Validate the id is valid
+ * @param id A uuid string
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function validateUuid(id: string | undefined | null): void;
+/**
+ * @hidden
+ * Validate the cart item properties are valid
+ * @param price The price to be validated
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function validatePrice(price: number): void;
+/**
+ * @hidden
+ * Validate quantity
+ * @param quantity The quantity to be validated
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function validateQuantity(quantity: number): void;
+/**
+ * @hidden
+ * Validate cart status
+ * @param cartStatus The cartStatus to be validated
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function validateCartStatus(cartStatus: marketplace.CartStatus): void;