@microsoft/teams-js 2.4.0-beta.2 → 2.4.0-beta.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,10 +1,4 @@
1
1
  // Generated by dts-bundle v0.7.3
2
- // Dependencies for this module:
3
- // ../@fluidframework/azure-client
4
- // ../@fluidframework/fluid-static
5
-
6
- import type { AzureConnectionConfig, AzureContainerServices, ITelemetryBaseLogger } from '@fluidframework/azure-client';
7
- import type { ContainerSchema, IFluidContainer } from '@fluidframework/fluid-static';
8
2
 
9
3
  /**
10
4
  * @hidden
@@ -6901,281 +6895,3 @@ export namespace tasks {
6901
6895
  function getDefaultSizeIfNotProvided(taskInfo: TaskInfo): TaskInfo;
6902
6896
  }
6903
6897
 
6904
- /**
6905
- * Namespace to interact with the Live Share module-specific part of the SDK.
6906
- *
6907
- * @beta
6908
- */
6909
- export namespace liveShare {
6910
- /**
6911
- * Options used to configure the Live Share client.
6912
- *
6913
- * @beta
6914
- */
6915
- interface LiveShareOptions {
6916
- /**
6917
- * Optional. Configuration to use when connecting to a custom Azure Fluid Relay instance.
6918
- */
6919
- readonly connection?: AzureConnectionConfig;
6920
- /**
6921
- * Optional. A logger instance to receive diagnostic messages.
6922
- */
6923
- readonly logger?: ITelemetryBaseLogger;
6924
- /**
6925
- * Optional. Function to lookup the ID of the container to use for local testing.
6926
- *
6927
- * @remarks
6928
- * The default implementation attempts to retrieve the containerId from the `window.location.hash`.
6929
- *
6930
- * If the function returns 'undefined' a new container will be created.
6931
- * @returns ID of the container to connect to or `undefined` if a new container should be created.
6932
- */
6933
- readonly getLocalTestContainerId?: () => string | undefined;
6934
- /**
6935
- * Optional. Function to save the ID of a newly created local test container.
6936
- *
6937
- * @remarks
6938
- * The default implementation updates `window.location.hash` with the ID of the newly created
6939
- * container.
6940
- * @param containerId The ID of the container that was created.
6941
- */
6942
- readonly setLocalTestContainerId?: (containerId: string) => void;
6943
- }
6944
- /**
6945
- * Initializes the Live Share client.
6946
- * @param options Optional. Configuration options passed to the Live Share client.
6947
- *
6948
- * @beta
6949
- */
6950
- function initialize(options?: LiveShareOptions): Promise<void>;
6951
- /**
6952
- * Connects to the fluid container for the current teams context.
6953
- *
6954
- * @remarks
6955
- * The first client joining the container will create the container resulting in the
6956
- * `onContainerFirstCreated` callback being called. This callback can be used to set the initial
6957
- * state of of the containers object prior to the container being attached.
6958
- * @param fluidContainerSchema Fluid objects to create.
6959
- * @param onContainerFirstCreated Optional. Callback that's called when the container is first created.
6960
- * @returns The fluid `container` and `services` objects to use along with a `created` flag that if true means the container had to be created.
6961
- *
6962
- * @beta
6963
- */
6964
- function joinContainer(fluidContainerSchema: ContainerSchema, onContainerFirstCreated?: (container: IFluidContainer) => void): Promise<{
6965
- container: IFluidContainer;
6966
- services: AzureContainerServices;
6967
- created: boolean;
6968
- }>;
6969
- /**
6970
- * @hidden
6971
- * Hide from docs
6972
- * ------
6973
- * Returns the LiveShareHost object. Called by existing apps that use the TeamsFluidClient
6974
- * directly. This prevents existing apps from breaking and will be removed when Live Share
6975
- * goes GA.
6976
- *
6977
- * @beta
6978
- */
6979
- function getHost(): LiveShareHost;
6980
- }
6981
-
6982
- /**
6983
- * @hidden
6984
- * @internal
6985
- * Limited to Microsoft-internal use
6986
- * ------
6987
- * Allowed roles during a meeting.
6988
- */
6989
- export enum UserMeetingRole {
6990
- guest = "Guest",
6991
- attendee = "Attendee",
6992
- presenter = "Presenter",
6993
- organizer = "Organizer"
6994
- }
6995
- /**
6996
- * @hidden
6997
- * @internal
6998
- * Limited to Microsoft-internal use
6999
- * ------
7000
- * State of the current Live Share sessions backing fluid container.
7001
- */
7002
- export enum ContainerState {
7003
- /**
7004
- * The call to `LiveShareHost.setContainerId()` successfully created the container mapping
7005
- * for the current Live Share session.
7006
- */
7007
- added = "Added",
7008
- /**
7009
- * A container mapping for the current Live Share Session already exists and should be used
7010
- * when joining the sessions Fluid container.
7011
- */
7012
- alreadyExists = "AlreadyExists",
7013
- /**
7014
- * The call to `LiveShareHost.setContainerId()` failed to create the container mapping due to
7015
- * another client having already set the container ID for the current Live Share session.
7016
- */
7017
- conflict = "Conflict",
7018
- /**
7019
- * A container mapping for the current Live Share session doesn't exist yet.
7020
- */
7021
- notFound = "NotFound"
7022
- }
7023
- /**
7024
- * @hidden
7025
- * @internal
7026
- * Limited to Microsoft-internal use
7027
- * ------
7028
- * Returned from `LiveShareHost.get/setFluidContainerId()` to specify the container mapping for the
7029
- * current Live Share session.
7030
- */
7031
- export interface IFluidContainerInfo {
7032
- /**
7033
- * State of the containerId mapping.
7034
- */
7035
- containerState: ContainerState;
7036
- /**
7037
- * ID of the container to join for the meeting. Undefined if the container hasn't been
7038
- * created yet.
7039
- */
7040
- containerId: string | undefined;
7041
- /**
7042
- * If true, the local client should create the container and then save the created containers
7043
- * ID to the mapping service.
7044
- */
7045
- shouldCreate: boolean;
7046
- /**
7047
- * If `containerId` is undefined and `shouldCreate` is false, the container isn't ready but
7048
- * another client is creating it. The local client should wait the specified amount of time and
7049
- * then ask for the container info again.
7050
- */
7051
- retryAfter: number;
7052
- }
7053
- /**
7054
- * @hidden
7055
- * @internal
7056
- * Limited to Microsoft-internal use
7057
- * ------
7058
- * Returned from `LiveShareHost.getNtpTime()` to specify the global timestamp for the current
7059
- * Live Share session.
7060
- */
7061
- export interface INtpTimeInfo {
7062
- /**
7063
- * ISO 8601 formatted server time. For example: '2019-09-07T15:50-04:00'
7064
- */
7065
- ntpTime: string;
7066
- /**
7067
- * Server time expressed as the number of milliseconds since the ECMAScript epoch.
7068
- */
7069
- ntpTimeInUTC: number;
7070
- }
7071
- /**
7072
- * @hidden
7073
- * @internal
7074
- * Limited to Microsoft-internal use
7075
- * ------
7076
- * Returned from `LiveShareHost.getFluidTenantInfo()` to specify the Fluid service to use for the
7077
- * current Live Share session.
7078
- */
7079
- export interface IFluidTenantInfo {
7080
- /**
7081
- * The Fluid Tenant ID Live Share should use.
7082
- */
7083
- tenantId: string;
7084
- /**
7085
- * The Fluid service endpoint Live Share should use.
7086
- */
7087
- serviceEndpoint?: string;
7088
- /**
7089
- * @deprecated
7090
- * As of Fluid 1.0 this configuration information has been deprecated in favor of
7091
- * `serviceEndpoint`.
7092
- */
7093
- ordererEndpoint: string;
7094
- /**
7095
- * @deprecated
7096
- * As of Fluid 1.0 this configuration information has been deprecated in favor of
7097
- * `serviceEndpoint`.
7098
- */
7099
- storageEndpoint: string;
7100
- }
7101
- /**
7102
- * @hidden
7103
- * @internal
7104
- * Limited to Microsoft-internal use
7105
- * ------
7106
- * Interface for hosting a Live Share session within a client like Teams.
7107
- */
7108
- export class LiveShareHost {
7109
- /**
7110
- * @hidden
7111
- * @internal
7112
- * Limited to Microsoft-internal use
7113
- * ------
7114
- * Returns the Fluid Tenant connection info for user's current context.
7115
- */
7116
- getFluidTenantInfo(): Promise<IFluidTenantInfo>;
7117
- /**
7118
- * @hidden
7119
- * @internal
7120
- * Limited to Microsoft-internal use
7121
- * ------
7122
- * Returns the fluid access token for mapped container Id.
7123
- *
7124
- * @param containerId Fluid's container Id for the request. Undefined for new containers.
7125
- * @returns token for connecting to Fluid's session.
7126
- */
7127
- getFluidToken(containerId?: string): Promise<string>;
7128
- /**
7129
- * @hidden
7130
- * @internal
7131
- * Limited to Microsoft-internal use
7132
- * ------
7133
- * Returns the ID of the fluid container associated with the user's current context.
7134
- */
7135
- getFluidContainerId(): Promise<IFluidContainerInfo>;
7136
- /**
7137
- * @hidden
7138
- * @internal
7139
- * Limited to Microsoft-internal use
7140
- * ------
7141
- * Sets the ID of the fluid container associated with the current context.
7142
- *
7143
- * @remarks
7144
- * If this returns false, the client should delete the container they created and then call
7145
- * `getFluidContainerId()` to get the ID of the container being used.
7146
- * @param containerId ID of the fluid container the client created.
7147
- * @returns A data structure with a `containerState` indicating the success or failure of the request.
7148
- */
7149
- setFluidContainerId(containerId: string): Promise<IFluidContainerInfo>;
7150
- /**
7151
- * @hidden
7152
- * @internal
7153
- * Limited to Microsoft-internal use
7154
- * ------
7155
- * Returns the shared clock server's current time.
7156
- */
7157
- getNtpTime(): Promise<INtpTimeInfo>;
7158
- /**
7159
- * @hidden
7160
- * @internal
7161
- * Limited to Microsoft-internal use
7162
- * ------
7163
- * Associates the fluid client ID with a set of user roles.
7164
- *
7165
- * @param clientId The ID for the current user's Fluid client. Changes on reconnects.
7166
- * @returns The roles for the current user.
7167
- */
7168
- registerClientId(clientId: string): Promise<UserMeetingRole[]>;
7169
- /**
7170
- * @hidden
7171
- * @internal
7172
- * Limited to Microsoft-internal use
7173
- * ------
7174
- * Returns the roles associated with a client ID.
7175
- *
7176
- * @param clientId The Client ID the message was received from.
7177
- * @returns The roles for a given client. Returns `undefined` if the client ID hasn't been registered yet.
7178
- */
7179
- getClientRoles(clientId: string): Promise<UserMeetingRole[] | undefined>;
7180
- }
7181
-