@jevelin/bridge 2.53.0

package/dist/esm/packages/teams-js/dts/public/dialog/url/parentCommunication.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Subcapability that allows communication between the dialog and the parent app.
+ *
+ * @remarks
+ * Note that dialog can be invoked from parentless scenarios e.g. Search Message Extensions. The subcapability `parentCommunication` is not supported in such scenarios.
+ *
+ * @module
+ */
+import { PostMessageChannel } from '../dialog';
+/**
+ *  Send message to the parent from dialog
+ *
+ * @remarks
+ * This function is only intended to be called from code running within the dialog. Calling it from outside the dialog will have no effect.
+ *
+ * @param message - The message to send to the parent
+ */
+export declare function sendMessageToParentFromDialog(message: any): void;
+/**
+ *  Send message to the dialog from the parent
+ *
+ * @param message - The message to send
+ */
+export declare function sendMessageToDialog(message: any): void;
+/**
+ * Register a listener that will be triggered when a message is received from the app that opened the dialog.
+ *
+ * @remarks
+ * This function is only intended to be called from code running within the dialog. Calling it from outside the dialog will have no effect.
+ *
+ * @param listener - The listener that will be triggered.
+ */
+export declare function registerOnMessageFromParent(listener: PostMessageChannel): void;
+/**
+ * Checks if dialog.url.parentCommunication capability is supported by the host
+ *
+ * @returns boolean to represent whether dialog.url.parentCommunication capability is supported
+ *
+ * @throws Error if {@linkcode app.initialize} has not successfully completed
+ */
+export declare function isSupported(): boolean;

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

@@ -0,0 +1,54 @@
+import { BotUrlDialogInfo, DialogInfo, UrlDialogInfo } from '../../interfaces';
+import { DialogSubmitHandler, PostMessageChannel } from '../dialog';
+import * as bot from './bot';
+import * as parentCommunication from './parentCommunication';
+/**
+ * Allows app to open a url based dialog.
+ *
+ * @remarks
+ * This function cannot be called from inside of a dialog
+ *
+ * @param urlDialogInfo - An object containing the parameters of the dialog module.
+ * @param submitHandler - Handler that triggers when a dialog calls the {@linkcode submit} function or when the user closes the dialog.
+ * @param messageFromChildHandler - Handler that triggers if dialog sends a message to the app.
+ */
+export declare function open(urlDialogInfo: UrlDialogInfo, submitHandler?: DialogSubmitHandler, messageFromChildHandler?: PostMessageChannel): void;
+/**
+ * Submit the dialog module and close the dialog
+ *
+ * @remarks
+ * This function is only intended to be called from code running within the dialog. Calling it from outside the dialog will have no effect.
+ *
+ * @param result - The result to be sent to the bot or the app. Typically a JSON object or a serialized version of it,
+ *  If this function is called from a dialog while {@link M365ContentAction} is set in the context object by the host, result will be ignored
+ *
+ * @param appIds - Valid application(s) that can receive the result of the submitted dialogs. Specifying this parameter helps prevent malicious apps from retrieving the dialog result. Multiple app IDs can be specified because a web app from a single underlying domain can power multiple apps across different environments and branding schemes.
+ */
+export declare function submit(result?: string | object, appIds?: string | string[]): void;
+/**
+ * Checks if dialog.url module is supported by the host
+ *
+ * @returns boolean to represent whether dialog.url module is supported
+ *
+ * @throws Error if {@linkcode app.initialize} has not successfully completed
+ */
+export declare function isSupported(): boolean;
+/**
+ * @hidden
+ *
+ * Convert UrlDialogInfo to DialogInfo to send the information to host in {@linkcode open} API.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function getDialogInfoFromUrlDialogInfo(urlDialogInfo: UrlDialogInfo): DialogInfo;
+/**
+ * @hidden
+ *
+ * Convert BotUrlDialogInfo to DialogInfo to send the information to host in {@linkcode bot.open} API.
+ *
+ * @internal
+ * Limited to Microsoft-internal use
+ */
+export declare function getDialogInfoFromBotUrlDialogInfo(botUrlDialogInfo: BotUrlDialogInfo): DialogInfo;
+export { bot, parentCommunication };

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

@@ -0,0 +1,12 @@
+/**
+ * Represents a validated email.
+ */
+export declare class EmailAddress {
+    /** Represents the input email address string */
+    private readonly val;
+    constructor(val: string);
+    /**
+     * Retrieve the validated email address as a string.
+     */
+    toString(): string;
+}

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

@@ -0,0 +1,130 @@
+/**
+ * Module for launching external apps and receiving results.
+ *
+ * Provides a generic mechanism to:
+ * - Launch another app with parameters and wait for a result
+ * - Open another app (fire-and-forget)
+ * - Check if a target app is installed
+ *
+ * @module
+ */
+/**
+ * Android-specific intent configuration.
+ */
+export interface AndroidIntentConfig {
+    /** Intent action (e.g., "android.intent.action.VIEW") */
+    action?: string;
+    /** Target package name (e.g., "com.example.app") */
+    package?: string;
+    /** Intent data URI (e.g., "upi://pay?...") */
+    data?: string;
+    /** MIME type (e.g., "application/json") */
+    type?: string;
+    /** Intent category */
+    category?: string;
+    /** Extra key-value pairs to pass with the intent */
+    extras?: Record<string, string | number | boolean>;
+}
+/**
+ * iOS-specific URL scheme configuration.
+ */
+export interface IOSUrlConfig {
+    /** URL scheme to open (e.g., "exampleapp://action?param=value") */
+    url: string;
+    /** Callback URL that the external app redirects back to (default: "org.jevelin.app://externalapp-callback") */
+    callbackUrl?: string;
+}
+/**
+ * Parameters for launching an external app.
+ */
+export interface ExternalAppLaunchParams {
+    /** Android-specific intent configuration */
+    android?: AndroidIntentConfig;
+    /** iOS-specific URL configuration */
+    ios?: IOSUrlConfig;
+    /** Maximum time to wait for result in milliseconds (default: 60000, 0 = no timeout) */
+    timeout?: number;
+}
+/**
+ * Result from an external app launch.
+ */
+export interface ExternalAppResult {
+    /** Whether the external app returned a successful result */
+    success: boolean;
+    /** Result data from the external app (key-value pairs) */
+    data?: Record<string, string>;
+    /** Error reason if success is false: "cancelled", "timeout", "not_installed" */
+    error?: string;
+}
+/**
+ * Result from checking if an app is installed.
+ */
+export interface ExternalAppInstalledResult {
+    /** Whether the target app is currently installed on the user's device. */
+    installed: boolean;
+}
+/**
+ * Launches an external app and waits for a result.
+ *
+ * On Android, this uses `startActivityForResult` with the provided intent.
+ * On iOS, this opens a URL scheme and waits for a callback URL redirect.
+ *
+ * @param params - Platform-specific launch parameters
+ * @returns A Promise resolving with the result from the external app
+ * @throws Error if the capability is not supported
+ *
+ * @example
+ * ```typescript
+ * // Launch a UPI payment app
+ * const result = await externalApp.launch({
+ *   android: {
+ *     action: "android.intent.action.VIEW",
+ *     data: "upi://pay?pa=merchant@upi&am=500"
+ *   },
+ *   ios: {
+ *     url: "gpay://upi/pay?pa=merchant@upi&am=500",
+ *     callbackUrl: "org.jevelin.app://payment-callback"
+ *   },
+ *   timeout: 120000
+ * });
+ *
+ * if (result.success) {
+ *   processPayment(result.data);
+ * }
+ * ```
+ */
+export declare function launch(params: ExternalAppLaunchParams): Promise<ExternalAppResult>;
+/**
+ * Opens an external app without waiting for a result (fire-and-forget).
+ *
+ * @param params - Platform-specific open parameters
+ * @returns A Promise resolving with success/failure of opening
+ *
+ * @example
+ * ```typescript
+ * await externalApp.open({
+ *   android: { action: "android.intent.action.VIEW", data: "https://wa.me/919999" },
+ *   ios: { url: "whatsapp://send?phone=919999" }
+ * });
+ * ```
+ */
+export declare function open(params: ExternalAppLaunchParams): Promise<ExternalAppResult>;
+/**
+ * Checks if a target app is installed on the device.
+ *
+ * @param params - Platform-specific identifiers to check
+ * @returns A Promise resolving with installation status
+ *
+ * @example
+ * ```typescript
+ * const { installed } = await externalApp.isInstalled({
+ *   android: { package: "com.example.paymentapp" },
+ *   ios: { url: "paymentapp://" }
+ * });
+ * ```
+ */
+export declare function isInstalled(params: ExternalAppLaunchParams): Promise<ExternalAppInstalledResult>;
+/**
+ * Checks if the externalApp capability is supported by the host.
+ */
+export declare function isSupported(): boolean;

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

@@ -0,0 +1,44 @@
+/**
+ * This function enables child proxying communication for apps that still needs it.
+ *
+ * @deprecated Child proxying is considered an insecure feature and will be removed in future releases.
+ */
+export declare function activateChildProxyingCommunication(): void;
+/**
+ * @hidden
+ * @internal
+ * Limited to Microsoft-internal use.
+ */
+export declare function isChildProxyingEnabled(): boolean;
+/**
+ * @hidden
+ * @internal
+ * Limited to Microsoft-internal use.
+ */
+export declare function resetBuildFeatureFlags(): void;
+/**
+ * Feature flags to activate or deactivate certain features at runtime for an app.
+ */
+export interface RuntimeFeatureFlags {
+    /**
+     * Disables origin validation for responses to child windows. When enabled, this flag bypasses security checks that verify the origin of child window that receives the response.
+     *
+     * Default: false
+     */
+    disableEnforceOriginMatchForChildResponses: boolean;
+}
+/**
+ * @returns The current state of the runtime feature flags.
+ */
+export declare function getCurrentFeatureFlagsState(): RuntimeFeatureFlags;
+/**
+ * It sets the runtime feature flags to the new feature flags provided.
+ * @param featureFlags The new feature flags to set.
+ */
+export declare function setFeatureFlagsState(featureFlags: RuntimeFeatureFlags): void;
+/**
+ * It overwrites all the feature flags in the runtime feature flags object with the new feature flags provided.
+ * @param newFeatureFlags The new feature flags to set.
+ * @returns The current state of the runtime feature flags.
+ */
+export declare function overwriteFeatureFlagsState(newFeatureFlags: Partial<RuntimeFeatureFlags>): RuntimeFeatureFlags;

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

@@ -0,0 +1,68 @@
+/**
+ * Module to interact with the geoLocation module-specific part of the SDK. This is the newer version of location module.
+ *
+ * @beta
+ * @module
+ */
+import * as map from './map';
+/**
+ * Data struture to represent the location information
+ *
+ * @beta
+ */
+export interface Location {
+    /**
+        Latitude of the location
+        */
+    latitude: number;
+    /**
+        Longitude of the location
+        */
+    longitude: number;
+    /**
+        Accuracy describes the maximum distance in meters from the captured coordinates to the possible actual location
+        @remarks
+        This property is only in scope for mobile
+        */
+    accuracy?: number;
+    /**
+        Time stamp when the location was captured
+        */
+    timestamp?: number;
+}
+/**
+ * Fetches current user coordinates
+ * @returns Promise that will resolve with {@link geoLocation.Location} object or reject with an error. Function can also throw a NOT_SUPPORTED_ON_PLATFORM error
+ *
+ * @beta
+ */
+export declare function getCurrentLocation(): Promise<Location>;
+/**
+ * Checks whether or not location has user permission
+ *
+ * @returns Promise that will resolve with true if the user had granted the app permission to location information, or with false otherwise,
+ * In case of an error, promise will reject with the error. Function can also throw a NOT_SUPPORTED_ON_PLATFORM error
+ *
+ * @beta
+ */
+export declare function hasPermission(): Promise<boolean>;
+/**
+ * Requests user permission for location
+ *
+ * @returns true if the user consented permission for location, false otherwise
+ * @returns Promise that will resolve with true if the user consented permission for location, or with false otherwise,
+ * In case of an error, promise will reject with the error. Function can also throw a NOT_SUPPORTED_ON_PLATFORM error
+ *
+ * @beta
+ */
+export declare function requestPermission(): Promise<boolean>;
+/**
+ * Checks if geoLocation capability is supported by the host
+ * @returns boolean to represent whether geoLocation is supported
+ *
+ * @throws Error if {@linkcode app.initialize} has not successfully completed
+ *
+ * @beta
+ */
+export declare function isSupported(): boolean;
+export { map };

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

@@ -0,0 +1,33 @@
+/**
+ * Module to interact with the location on map module-specific part of the SDK.
+ *
+ * @beta
+ * @module
+ */
+import { Location } from './geoLocation';
+/**
+ * Allows user to choose location on map
+ *
+ * @returns Promise that will resolve with {@link geoLocation.Location} object chosen by the user or reject with an error. Function can also throw a NOT_SUPPORTED_ON_PLATFORM error
+ *
+ * @beta
+ */
+export declare function chooseLocation(): Promise<Location>;
+/**
+ * Shows the location on map corresponding to the given coordinates
+ *
+ * @param location - Location to be shown on the map
+ * @returns Promise that resolves when the location dialog has been closed or reject with an error. Function can also throw a NOT_SUPPORTED_ON_PLATFORM error
+ *
+ * @beta
+ */
+export declare function showLocation(location: Location): Promise<void>;
+/**
+ * Checks if geoLocation.map capability is supported by the host
+ * @returns boolean to represent whether geoLocation.map is supported
+ *
+ * @throws Error if {@linkcode app.initialize} has not successfully completed
+ *
+ * @beta
+ */
+export declare function isSupported(): boolean;

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

@@ -0,0 +1,42 @@
+/**
+ * Module for triggering native haptic feedback.
+ *
+ * Provides access to the device's haptic engine (Taptic Engine on iOS,
+ * vibration motor on Android) for tactile responses to user actions.
+ *
+ * @module
+ */
+/**
+ * The type of haptic feedback to trigger.
+ *
+ * - `success` — Indicates a successful action (e.g., payment confirmed)
+ * - `error` — Indicates a failure (e.g., transaction declined)
+ * - `warning` — Indicates a cautionary state (e.g., low balance)
+ * - `impact` — A physical impact feel (e.g., button press, drag snap)
+ * - `selection` — A light tick for selection changes (e.g., picker scroll)
+ */
+export type HapticType = 'success' | 'error' | 'warning' | 'impact' | 'selection';
+/**
+ * Triggers a haptic vibration on the device.
+ *
+ * @param type - The type of haptic feedback. Defaults to "impact" if not specified.
+ * @returns A Promise that resolves when the haptic has been triggered.
+ * @throws Error if the capability is not supported.
+ *
+ * @example
+ * ```typescript
+ * // On successful payment
+ * await haptics.vibrate('success');
+ *
+ * // On form validation error
+ * await haptics.vibrate('error');
+ *
+ * // On picker value change
+ * await haptics.vibrate('selection');
+ * ```
+ */
+export declare function vibrate(type?: HapticType): Promise<void>;
+/**
+ * Checks if the haptics capability is supported by the host.
+ */
+export declare function isSupported(): boolean;

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

@@ -0,0 +1,57 @@
+export * as authentication from './authentication';
+export { ChannelType, DialogDimension, FrameContexts, HostClientType, HostName, RenderingSurfaces, TaskModuleDimension, TeamType, UserTeamRole, } from './constants';
+export { ActionInfo, ActionObjectType, AdaptiveCardVersion, AdaptiveCardDialogInfo, AppState, BaseActionObject, BotAdaptiveCardDialogInfo, BotUrlDialogInfo, Context, DeepLinkParameters, DialogInfo, DialogSize, EduType, ErrorCode, FileOpenPreference, FrameContext, FrameInfo, HostMemoryMetrics, HostToAppFrameMemoryMetrics, HostToAppPerformanceMetrics, LoadContext, LocaleInfo, M365ContentAction, ResumeContext, SdkError, SecondaryId, SecondaryM365ContentIdName, ShareDeepLinkParameters, TabInformation, TabInstance, TabInstanceParameters, TaskInfo, TeamInformation, UrlDialogInfo, } from './interfaces';
+export * as app from './app/app';
+export { AppId } from './appId';
+export * as appPerformanceMetrics from './appPerformanceMetrics';
+export { EmailAddress } from './emailAddress';
+export * as appInstallDialog from './appInstallDialog';
+export * as barCode from './barCode';
+export * as chat from './chat';
+export { OpenGroupChatRequest, OpenSingleChatRequest } from './chat';
+export * as clipboard from './clipboard';
+export * as dialog from './dialog/dialog';
+export { activateChildProxyingCommunication, getCurrentFeatureFlagsState, overwriteFeatureFlagsState, RuntimeFeatureFlags, setFeatureFlagsState, } from './featureFlags';
+export * as nestedAppAuth from './nestedAppAuth';
+export * as geoLocation from './geoLocation/geoLocation';
+export { getAdaptiveCardSchemaVersion } from './adaptiveCards';
+export * as pages from './pages/pages';
+export { addEventListnerFunctionType, ChildAppWindow, IAppWindow, onCompleteFunctionType, ParentAppWindow, } from './appWindow';
+export * as menus from './menus';
+export * as media from './media';
+export * as secondaryBrowser from './secondaryBrowser';
+export * as location from './location';
+export * as meeting from './meeting/meeting';
+export * as monetization from './monetization';
+export * as calendar from './calendar';
+export * as mail from './mail/mail';
+export * as teamsCore from './teamsAPIs';
+export * as people from './people';
+export * as profile from './profile';
+export * as videoEffects from './videoEffects';
+export * as search from './search';
+export * as sharing from './sharing/sharing';
+export * as stageView from './stageView/stageView';
+export { ValidatedSafeString } from './validatedSafeString';
+export { version } from './version';
+export * as visualMedia from './visualMedia/visualMedia';
+export * as webStorage from './webStorage';
+export * as offlineStorage from './offlineStorage/offlineStorage';
+export * as security from './security';
+export * as connectivity from './connectivity';
+export * as haptics from './haptics';
+export * as badge from './badge';
+export * as externalApp from './externalApp';
+export * as call from './call';
+export * as appInitialization from './appInitialization';
+export * as thirdPartyCloudStorage from './thirdPartyCloudStorage';
+export { callbackFunctionType, enablePrintCapability, executeDeepLink, executeDeepLinkOnCompleteFunctionType, getContext, getContextCallbackFunctionType, getMruTabInstances, getTabInstances, getTabInstancesCallbackFunctionType, initialize, initializeWithFrameContext, print, registerAppButtonClickHandler, registerAppButtonHoverEnterHandler, registerAppButtonHoverLeaveHandler, registerBackButtonHandler, registerBackButtonHandlerFunctionType, registerBeforeUnloadHandler, registerChangeSettingsHandler, registerFocusEnterHandler, registerFullScreenHandler, registerFullScreenHandlerFunctionType, registerOnLoadHandler, registerOnThemeChangeHandler, registerOnThemeChangeHandlerFunctionType, setFrameContext, shareDeepLink, } from './publicAPIs';
+export { navigateBack, navigateCrossDomain, navigateToTab, onCompleteHandlerFunctionType, returnFocus, } from './navigation';
+export { UUID } from './uuidObject';
+export * as settings from './settings';
+export * as tasks from './tasks';
+export * as liveShare from './liveShareHost';
+export { LiveShareHost } from './liveShareHost';
+export * as marketplace from './marketplace';
+export { ISerializable } from './serializable.interface';
+export * as shortcutRelay from './shortcutRelay';