\n `);\n }\n }\n\n // if we have more than one line we add the second line\n if (this.view !== 'oneline') {\n const text = this.getTextFromProperty(person, this.line2Property);\n if (this.hasTemplate('line2')) {\n // Render the line2 template\n const template = this.renderTemplate('line2', { person });\n details.push(html`\n
\n `);\n }\n }\n }\n\n // if we have a third or fourth line we add the third line\n if (this.view === 'threelines' || this.view === 'fourlines') {\n const text = this.getTextFromProperty(person, this.line3Property);\n if (this.hasTemplate('line3')) {\n // Render the line3 template\n const template = this.renderTemplate('line3', { person });\n details.push(html`\n
\n `);\n }\n }\n }\n\n // add the fourth line if necessary\n if (this.view === 'fourlines') {\n const text = this.getTextFromProperty(person, this.line4Property);\n if (this.hasTemplate('line4')) {\n // Render the line4 template\n const template = this.renderTemplate('line4', { person });\n details.push(html`\n
\n ${flyoutContent}\n `;\n }\n\n /**\n * Render the flyout menu content.\n *\n * @protected\n * @returns {TemplateResult}\n * @memberof MgtPerson\n */\n protected renderFlyoutContent(personDetails: IDynamicPerson, image: string, presence: Presence): TemplateResult {\n this.fireCustomEvent('flyout-content-rendered');\n return (\n this.renderTemplate('person-card', { person: personDetails, personImage: image }) ||\n mgtHtml`\n \n `\n );\n }\n\n protected args() {\n return [\n this.providerState,\n this.verticalLayout,\n this.view,\n this.fallbackDetails,\n this.line1Property,\n this.line2Property,\n this.line3Property,\n this.line4Property,\n this.fetchImage,\n this.avatarType,\n this.userId,\n this.personQuery,\n this.disableImageFetch,\n this.showPresence,\n this.personPresence,\n this.personDetails\n ];\n }\n\n /**\n * load state into the component.\n *\n * @protected\n * @returns\n * @memberof MgtPerson\n */\n protected async loadState() {\n const provider = Providers.globalProvider;\n if (!provider || provider.state === ProviderState.Loading) {\n return;\n }\n\n if (provider && provider.state === ProviderState.SignedOut) {\n this.personDetailsInternal = null;\n return;\n }\n\n const graph = provider.graph.forComponent(this);\n\n if ((this.verticalLayout && this.view !== 'fourlines') || this.fallbackDetails) {\n this.line2Property = 'email';\n }\n\n // Prepare person props\n let personProps = [\n ...defaultPersonProperties,\n this.line1Property,\n this.line2Property,\n this.line3Property,\n this.line4Property\n ];\n personProps = personProps.filter(email => email !== 'email');\n\n let details = this.personDetailsInternal || this.personDetails;\n if (details) {\n if (\n !details.personImage &&\n this.fetchImage &&\n this.avatarType === 'photo' &&\n !this.personImage &&\n !this._fetchedImage\n ) {\n let image: string;\n if ('groupTypes' in details) {\n image = await getGroupImage(graph, details);\n } else {\n image = await getPersonImage(graph, details, MgtPerson.config.useContactApis);\n }\n if (image) {\n details.personImage = image;\n this._fetchedImage = image;\n }\n }\n } else if (this.userId || this.personQuery === 'me') {\n // Use userId or 'me' query to get the person and image\n let person: IDynamicPerson;\n if (this.avatarType === 'photo' && !this.disableImageFetch) {\n person = await getUserWithPhoto(graph, this.userId, personProps);\n } else {\n if (this.personQuery === 'me') {\n person = await getMe(graph, personProps);\n } else {\n person = await getUser(graph, this.userId, personProps);\n }\n }\n this.personDetailsInternal = person;\n this.personDetails = person;\n this._fetchedImage = this.getImage();\n } else if (this.personQuery) {\n // Use the personQuery to find our person.\n let people = await findPeople(graph, this.personQuery, 1);\n\n if (!people || people.length === 0) {\n people = (await findUsers(graph, this.personQuery, 1)) || [];\n }\n\n if (people?.length) {\n this.personDetailsInternal = people[0];\n this.personDetails = people[0];\n if (this.avatarType === 'photo' && !this.disableImageFetch) {\n const image = await getPersonImage(graph, people[0], MgtPerson.config.useContactApis);\n\n if (image) {\n this.personDetailsInternal.personImage = image;\n this.personDetails.personImage = image;\n this._fetchedImage = image;\n }\n }\n }\n }\n\n details = this.personDetailsInternal || this.personDetails || this.fallbackDetails;\n\n // populate presence\n const defaultPresence: Presence = {\n activity: 'Offline',\n availability: 'Offline',\n id: null\n };\n\n if (this.showPresence && !this.personPresence && !this._fetchedPresence) {\n try {\n if (details) {\n // setting userId to 'me' ensures only the presence.read permission is required\n const userId = this.personQuery !== 'me' ? details?.id : null;\n this._fetchedPresence = await getUserPresence(graph, userId);\n } else {\n this._fetchedPresence = defaultPresence;\n }\n } catch (_) {\n // set up a default Presence in case beta api changes or getting error code\n this._fetchedPresence = defaultPresence;\n }\n }\n }\n\n /**\n * Gets the user initials\n *\n * @protected\n * @returns {string}\n * @memberof MgtPerson\n */\n protected getInitials(person?: IDynamicPerson): string {\n if (!person) {\n person = this.personDetailsInternal;\n }\n\n if (isContact(person)) {\n return person.initials;\n }\n\n let initials = '';\n if (isUser(person)) {\n initials += person.givenName?.[0]?.toUpperCase() ?? '';\n initials += person.surname?.[0]?.toUpperCase() ?? '';\n }\n\n if (!initials && person.displayName) {\n const name = person.displayName.split(/\\s+/);\n for (let i = 0; i < 2 && i < name.length; i++) {\n if (name[i][0] && this.isLetter(name[i][0])) {\n initials += name[i][0].toUpperCase();\n }\n }\n }\n\n return initials;\n }\n\n private getImage(): string {\n if (this.personImage) {\n return this.personImage;\n }\n\n if (this._fetchedImage) {\n return this._fetchedImage;\n }\n\n const person = this.personDetailsInternal || this.personDetails;\n return person?.personImage ? person.personImage : null;\n }\n\n private isLetter(char: string) {\n try {\n return char.match(new RegExp('\\\\p{L}', 'u'));\n } catch (e) {\n return char.toLowerCase() !== char.toUpperCase();\n }\n }\n\n private getTextFromProperty(personDetailsInternal: IDynamicPerson, prop: string): string {\n if (!prop || prop.length === 0) {\n return null;\n }\n\n const properties = prop.trim().split(',');\n let text: string;\n let i = 0;\n\n while (!text && i < properties.length) {\n const currentProp = properties[i].trim();\n switch (currentProp) {\n case 'mail':\n case 'email':\n text = getEmailFromGraphEntity(personDetailsInternal);\n break;\n default:\n text = personDetailsInternal[currentProp] as string;\n }\n i++;\n }\n\n return text;\n }\n\n private isLargeAvatar() {\n return (\n this.avatarSize === 'large' || (this.avatarSize === 'auto' && this.view !== 'image' && this.view !== 'oneline')\n );\n }\n\n private isNoLine() {\n return this.view === 'image';\n }\n\n private isOneLine() {\n return this.view === 'oneline';\n }\n\n private isTwoLines() {\n return this.view === 'twolines';\n }\n\n private isThreeLines() {\n return this.view === 'threelines';\n }\n\n private isFourLines() {\n return this.view === 'fourlines';\n }\n\n private isVertical() {\n return this.verticalLayout;\n }\n\n private readonly handleMouseClick = (e: MouseEvent) => {\n const element = e.target as HTMLElement;\n // todo: fix for disambiguation\n if (\n this.personCardInteraction === 'click' &&\n element.tagName !== `${customElementHelper.prefix}-PERSON-CARD`.toUpperCase()\n ) {\n this.showPersonCard();\n }\n };\n\n private readonly handleKeyDown = (e: KeyboardEvent) => {\n const personEl = this.renderRoot.querySelector('.person-root');\n // enter activates and focuses on person-card\n if (e) {\n if (e.key === 'Enter') {\n this.showPersonCard();\n const flyout = this.flyout;\n if (flyout?.isOpen) {\n this._keyBoardFocus = debounce(() => {\n const personCardEl = flyout.querySelector('.mgt-person-card');\n personCardEl.setAttribute('tabindex', '0');\n personCardEl.focus();\n }, 500);\n this._keyBoardFocus();\n }\n personEl.blur();\n }\n if (this.personCardInteraction !== 'none') {\n if (e.key === 'Escape' && personEl) {\n this.hidePersonCard();\n personEl.focus();\n }\n }\n }\n };\n\n private readonly handleMouseEnter = () => {\n clearTimeout(this._mouseEnterTimeout);\n clearTimeout(this._mouseLeaveTimeout);\n if (this.personCardInteraction !== 'hover') {\n return;\n }\n this._mouseEnterTimeout = window.setTimeout(this.showPersonCard, 500);\n };\n\n private readonly handleMouseLeave = () => {\n clearTimeout(this._mouseEnterTimeout);\n clearTimeout(this._mouseLeaveTimeout);\n this._mouseLeaveTimeout = window.setTimeout(this.hidePersonCard, 500);\n };\n\n /**\n * hides the person card\n *\n * @memberof MgtPerson\n */\n public hidePersonCard = () => {\n const flyout = this.flyout;\n if (flyout) {\n flyout.close();\n }\n const personCard =\n this.querySelector('.mgt-person-card') ||\n this.renderRoot.querySelector('.mgt-person-card');\n if (personCard) {\n personCard.isExpanded = false;\n personCard.clearHistory();\n }\n };\n\n private readonly loadPersonCardResources = async () => {\n // if there could be a person-card then we should load those resources using a dynamic import\n if (this.personCardInteraction !== 'none' && !this._hasLoadedPersonCard) {\n const { registerMgtPersonCardComponent } = await import('../mgt-person-card/mgt-person-card');\n\n // only register person card if it hasn't been registered yet\n if (!customElements.get(buildComponentName('person-card'))) registerMgtPersonCardComponent();\n\n this._hasLoadedPersonCard = true;\n }\n };\n\n public showPersonCard = () => {\n if (!this._personCardShouldRender) {\n this._personCardShouldRender = true;\n void this.loadPersonCardResources();\n }\n\n const flyout = this.flyout;\n if (flyout) {\n flyout.open();\n }\n };\n}\n","/**\n * -------------------------------------------------------------------------------------------\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\n * See License in the project root for license information.\n * -------------------------------------------------------------------------------------------\n */\n\n/**\n * An object containing width, height, top and left properties (aka segment's bounding rects)\n *\n * @interface IWindowSegment\n */\nexport interface IWindowSegment {\n top: number;\n left: number;\n width: number;\n height: number;\n}\n\n/**\n * An interface that defines the Window Segments Enumeration API.\n *\n * @interface SegmentAwareWindow\n */\nexport interface ISegmentAwareWindow extends Window {\n /**\n * Returns an array of screen segments.\n *\n * @returns {*}\n * @memberof SegmentAwareWindow\n */\n getWindowSegments(): IWindowSegment[];\n}\n\n/**\n * Responds whether or not the Window object supports the Window Segments Enumeration API.\n *\n * @export\n * @returns {boolean}\n */\nexport const isWindowSegmentAware = (): boolean => {\n return (window as unknown as ISegmentAwareWindow).getWindowSegments !== undefined;\n};\n\n/**\n * Returns an ISegmentAwareWindow instance of the Window object, or null if the API is not supported.\n *\n * @export\n * @returns {ISegmentAwareWindow}\n */\nexport const getSegmentAwareWindow = (): ISegmentAwareWindow => {\n return isWindowSegmentAware() ? (window as unknown as ISegmentAwareWindow) : null;\n};\n","// THIS FILE IS AUTO GENERATED\n// ANY CHANGES WILL BE LOST DURING BUILD\n// MODIFY THE .SCSS FILE INSTEAD\n\nimport { css, CSSResult } from 'lit';\n/**\n * exports lit-element css\n * @export styles\n */\nexport const styles: CSSResult[] = [\n css`\n.root .scout-top{position:fixed;top:0;left:0}.root .scout-bottom{position:fixed;bottom:0;right:0}.root .flyout{display:none;position:fixed;z-index:9999999;opacity:0;box-shadow:var(--mgt-flyout-box-shadow,var(--elevation-shadow-card-rest));border-radius:8px}.root .flyout.small{overflow:hidden auto}.root.visible .flyout{display:inline-block;animation-name:fade-in;animation-duration:.3s;animation-timing-function:cubic-bezier(0.1,0.9,0.2,1);animation-fill-mode:both;transition:top .3s ease,bottom .3s ease,left .3s ease}.root.visible .flyout.small{overflow:hidden auto}@keyframes fade-in{from{opacity:0;margin-top:-10px;margin-bottom:-10px}to{opacity:1;margin-top:0;margin-bottom:0}}\n`];","/**\n * -------------------------------------------------------------------------------------------\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\n * See License in the project root for license information.\n * -------------------------------------------------------------------------------------------\n */\n\nimport { html, PropertyValues, TemplateResult } from 'lit';\nimport { property } from 'lit/decorators.js';\nimport { classMap } from 'lit/directives/class-map.js';\nimport { getSegmentAwareWindow, isWindowSegmentAware, IWindowSegment } from '../../../utils/WindowSegmentHelpers';\nimport { styles } from './mgt-flyout-css';\nimport { MgtBaseTaskComponent, registerComponent } from '@microsoft/mgt-element';\n\nexport const registerMgtFlyoutComponent = () => registerComponent('flyout', MgtFlyout);\n\n/**\n * A component to create flyout anchored to an element\n *\n * @export\n * @class MgtFlyout\n * @extends {LitElement}\n */\nexport class MgtFlyout extends MgtBaseTaskComponent {\n /**\n * Array of styles to apply to the element. The styles should be defined\n * using the `css` tag function.\n */\n static get styles() {\n return styles;\n }\n\n /**\n * Gets or sets whether the flyout is light dismissible.\n *\n * @type {boolean}\n * @memberof MgtFlyout\n */\n @property({\n attribute: 'light-dismiss',\n type: Boolean\n })\n public isLightDismiss: boolean;\n\n /**\n * Gets or sets whether the flyout should avoid rendering the flyout\n * on top of the anchor\n *\n * @type {boolean}\n * @memberof MgtFlyout\n */\n @property({\n attribute: null,\n type: Boolean\n })\n public avoidHidingAnchor: boolean;\n\n /**\n * Gets or sets whether the flyout is visible\n *\n * @type {string}\n * @memberof MgtFlyout\n */\n @property({\n attribute: 'isOpen',\n type: Boolean\n })\n public get isOpen(): boolean {\n return this._isOpen;\n }\n public set isOpen(value: boolean) {\n const oldValue = this._isOpen;\n if (oldValue === value) {\n return;\n }\n\n this._isOpen = value;\n\n window.requestAnimationFrame(() => {\n this.setupWindowEvents(this.isOpen);\n const flyout = this._flyout;\n if (!this.isOpen && flyout) {\n // reset style for next update\n flyout.style.width = null;\n flyout.style.setProperty('--mgt-flyout-set-width', null);\n flyout.style.setProperty('--mgt-flyout-set-height', null);\n flyout.style.maxHeight = null;\n flyout.style.top = null;\n flyout.style.left = null;\n flyout.style.bottom = null;\n }\n });\n\n this.requestUpdate('isOpen', oldValue);\n this.dispatchEvent(new Event(value ? 'opened' : 'closed'));\n }\n\n // Minimum distance to render from window edge\n private get _edgePadding() {\n return 24;\n }\n\n // if the flyout is opened once, this will keep the flyout in the dom\n private _renderedOnce = false;\n\n private get _flyout(): HTMLElement {\n return this.renderRoot.querySelector('.flyout');\n }\n\n private get _anchor(): HTMLElement {\n return this.renderRoot.querySelector('.anchor');\n }\n\n private get _topScout(): HTMLElement {\n return this.renderRoot.querySelector('.scout-top');\n }\n\n private get _bottomScout(): HTMLElement {\n return this.renderRoot.querySelector('.scout-bottom');\n }\n\n private _isOpen = false;\n private _smallView = false;\n private _windowHeight: number;\n\n constructor() {\n super();\n\n this.avoidHidingAnchor = true;\n\n // handling when person-card is expanded and size changes\n this.addEventListener('expanded', () => {\n window.requestAnimationFrame(() => {\n this.updateFlyout();\n });\n });\n }\n\n /**\n * Show the flyout.\n */\n public open(): void {\n this.isOpen = true;\n }\n\n /**\n * Close the flyout.\n */\n public close(): void {\n this.isOpen = false;\n }\n\n /**\n * Invoked each time the custom element is disconnected from the document's DOM\n *\n * @memberof MgtFlyout\n */\n public disconnectedCallback() {\n this.setupWindowEvents(false);\n super.disconnectedCallback();\n }\n\n /**\n * Invoked whenever the element is updated. Implement to perform\n * post-updating tasks via DOM APIs, for example, focusing an element.\n *\n * Setting properties inside this method will trigger the element to update\n * again after this update cycle completes.\n *\n * @param changedProperties Map of changed properties with old values\n */\n protected updated(changedProps: PropertyValues) {\n super.updated(changedProps);\n\n window.requestAnimationFrame(() => {\n this.updateFlyout();\n });\n }\n\n /**\n * Invoked on each update to perform rendering tasks. This method must return\n * a lit-html TemplateResult. Setting properties inside this method will *not*\n * trigger the element to update.\n */\n protected render() {\n const flyoutClasses = {\n root: true,\n visible: this.isOpen\n };\n\n const anchorTemplate = this.renderAnchor();\n let flyoutTemplate = null;\n this._windowHeight =\n window.innerHeight && document.documentElement.clientHeight\n ? Math.min(window.innerHeight, document.documentElement.clientHeight)\n : window.innerHeight || document.documentElement.clientHeight;\n\n if (this._windowHeight < 250) {\n this._smallView = true;\n }\n\n if (this.isOpen || this._renderedOnce) {\n this._renderedOnce = true;\n const smallFlyoutClasses = classMap({\n flyout: true,\n small: this._smallView\n });\n flyoutTemplate = html`\n
\n ${this.renderFlyout()}\n
\n `;\n }\n\n return html`\n
\n
\n ${anchorTemplate}\n
\n \n \n ${flyoutTemplate}\n
\n `;\n }\n\n /**\n * Renders the anchor content.\n *\n * @protected\n * @returns\n * @memberof MgtFlyout\n */\n protected renderAnchor(): TemplateResult {\n return html`\n \n `;\n }\n\n /**\n * Renders the flyout.\n */\n protected renderFlyout(): TemplateResult {\n return html`\n \n `;\n }\n\n /**\n * Updates the position of the flyout.\n * Makes a second recursive call to ensure the flyout is positioned correctly.\n * This is needed as the width of the flyout is not settled until after the first render.\n *\n * @private\n * @param {boolean} [firstPass=true]\n * @return {*}\n * @memberof MgtFlyout\n */\n private updateFlyout(firstPass = true) {\n if (!this.isOpen) {\n return;\n }\n\n const anchor = this._anchor;\n const flyout = this._flyout;\n\n if (flyout && anchor) {\n const windowWidth =\n window.innerWidth && document.documentElement.clientWidth\n ? Math.min(window.innerWidth, document.documentElement.clientWidth)\n : window.innerWidth || document.documentElement.clientWidth;\n\n this._windowHeight =\n window.innerHeight && document.documentElement.clientHeight\n ? Math.min(window.innerHeight, document.documentElement.clientHeight)\n : window.innerHeight || document.documentElement.clientHeight;\n\n let left = 0;\n let bottom: number;\n let top = 0;\n let height: number;\n let width: number;\n\n const flyoutRect = flyout.getBoundingClientRect();\n const anchorRect = anchor.getBoundingClientRect();\n const topScoutRect = this._topScout.getBoundingClientRect();\n const bottomScoutRect = this._bottomScout.getBoundingClientRect();\n\n const windowRect: IWindowSegment = {\n height: this._windowHeight,\n left: 0,\n top: 0,\n width: windowWidth\n };\n\n if (isWindowSegmentAware()) {\n const segmentAwareWindow = getSegmentAwareWindow();\n const screenSegments = segmentAwareWindow.getWindowSegments();\n\n let anchorSegment: IWindowSegment;\n\n const anchorCenterX = anchorRect.left + anchorRect.width / 2;\n const anchorCenterY = anchorRect.top + anchorRect.height / 2;\n\n for (const segment of screenSegments) {\n if (anchorCenterX >= segment.left && anchorCenterY >= segment.top) {\n anchorSegment = segment;\n break;\n }\n }\n\n if (anchorSegment) {\n windowRect.left = anchorSegment.left;\n windowRect.top = anchorSegment.top;\n windowRect.width = anchorSegment.width;\n windowRect.height = anchorSegment.height;\n }\n }\n\n if (flyoutRect.width + 2 * this._edgePadding > windowRect.width) {\n if (flyoutRect.width > windowRect.width) {\n // flyout is wider than the window\n width = windowRect.width;\n left = 0;\n } else {\n // center in between\n left = (windowRect.width - flyoutRect.width) / 2;\n }\n } else if (anchorRect.left + flyoutRect.width + this._edgePadding > windowRect.width) {\n // it will render off screen to the right, move to the left\n left = anchorRect.left - (anchorRect.left + flyoutRect.width + this._edgePadding - windowRect.width);\n } else if (anchorRect.left < this._edgePadding) {\n // it will render off screen to the left, move to the right\n left = this._edgePadding;\n } else {\n left = anchorRect.left;\n }\n\n const anchorRectBottomToWindowBottom = windowRect.height - (anchorRect.top + anchorRect.height);\n const anchorRectTopToWindowTop = anchorRect.top;\n\n if (this.avoidHidingAnchor) {\n if (anchorRectBottomToWindowBottom <= flyoutRect.height) {\n if (anchorRectTopToWindowTop < flyoutRect.height) {\n if (anchorRectTopToWindowTop > anchorRectBottomToWindowBottom) {\n // more room top than bottom - render above\n bottom = windowRect.height - anchorRect.top;\n height = anchorRectTopToWindowTop;\n } else {\n // more room bottom than top\n top = anchorRect.bottom;\n height = anchorRectBottomToWindowBottom;\n }\n } else {\n // render above anchor\n bottom = windowRect.height - anchorRect.top;\n height = anchorRectTopToWindowTop;\n }\n } else {\n top = anchorRect.bottom;\n height = anchorRectBottomToWindowBottom;\n }\n } else {\n if (flyoutRect.height + 2 * this._edgePadding > windowRect.height) {\n // flyout wants to be higher than the window hight, and we don't need to avoid hiding the anchor\n // make the flyout height the height of the window\n if (flyoutRect.height >= windowRect.height) {\n height = windowRect.height;\n top = 0;\n } else {\n top = (windowRect.height - flyoutRect.height) / 2;\n }\n } else {\n if (anchorRect.top + anchorRect.height + flyoutRect.height + this._edgePadding > windowRect.height) {\n // it will render offscreen bellow, move it up a bit\n top = windowRect.height - flyoutRect.height - this._edgePadding;\n } else {\n top = Math.max(anchorRect.top + anchorRect.height, this._edgePadding);\n }\n }\n }\n\n // check the scout is positioned where it is supposed to be\n // if it's not, then we are no longer fixed position and should assume\n // absolute positioning\n // this is a workaround when a transform is applied to a parent\n // https://stackoverflow.com/questions/42660332/css-transform-parent-and-fixed-child\n if (topScoutRect.top !== 0 || topScoutRect.left !== 0) {\n left -= topScoutRect.left;\n\n if (typeof bottom !== 'undefined') {\n bottom += bottomScoutRect.top - this._windowHeight;\n } else {\n top -= topScoutRect.top;\n }\n }\n\n if (this.direction === 'rtl') {\n if (left > 100 && this.offsetLeft > 100) {\n // potentially anchored to right side (for non people-picker flyout)\n flyout.style.left = `${windowRect.width - left + flyoutRect.left - flyoutRect.width - 30}px`;\n }\n } else {\n flyout.style.left = `${left + windowRect.left}px`;\n }\n\n if (typeof bottom !== 'undefined') {\n flyout.style.top = 'unset';\n flyout.style.bottom = `${bottom}px`;\n } else {\n flyout.style.bottom = 'unset';\n flyout.style.top = `${top + windowRect.top}px`;\n }\n\n if (width) {\n // if we had to set the width, recalculate since the height could have changed\n flyout.style.width = `${width}px`;\n flyout.style.setProperty('--mgt-flyout-set-width', `${width}px`);\n window.requestAnimationFrame(() => this.updateFlyout());\n }\n\n // don't use the calculated height on the first pass as the contents of the flyout may not have rendered yet\n // this gives them a change to contribute height and not get forced to a smaller than intended height\n if (height && !firstPass) {\n flyout.style.maxHeight = `${height}px`;\n flyout.style.setProperty('--mgt-flyout-set-height', `${height}px`);\n } else {\n flyout.style.maxHeight = null;\n flyout.style.setProperty('--mgt-flyout-set-height', 'unset');\n }\n if (firstPass) {\n window.requestAnimationFrame(() => this.updateFlyout(false));\n }\n }\n }\n\n private setupWindowEvents(isOpen: boolean) {\n if (isOpen && this.isLightDismiss) {\n window.addEventListener('wheel', this.handleWindowEvent);\n window.addEventListener('pointerdown', this.handleWindowEvent);\n window.addEventListener('resize', this.handleResize);\n window.addEventListener('keyup', this.handleKeyUp);\n } else {\n window.removeEventListener('wheel', this.handleWindowEvent);\n window.removeEventListener('pointerdown', this.handleWindowEvent);\n window.removeEventListener('resize', this.handleResize);\n window.removeEventListener('keyup', this.handleKeyUp);\n }\n }\n\n private readonly handleWindowEvent = (e: Event) => {\n const flyout = this._flyout;\n\n if (flyout) {\n // IE\n if (!e.composedPath) {\n let currentElem = e.target as HTMLElement;\n while (currentElem) {\n currentElem = currentElem.parentElement;\n if (currentElem === flyout || (e.type === 'pointerdown' && currentElem === this)) {\n return;\n }\n }\n } else {\n const path = e.composedPath();\n if (path.includes(flyout) || (e.type === 'pointerdown' && path.includes(this))) {\n return;\n }\n }\n }\n\n this.close();\n };\n\n private readonly handleResize = () => {\n this.close();\n };\n\n private readonly handleKeyUp = (e: KeyboardEvent) => {\n if (e.key === 'Escape') {\n this.close();\n }\n };\n\n private readonly handleFlyoutWheel = (e: Event) => {\n e.preventDefault();\n };\n}\n","/**\n * -------------------------------------------------------------------------------------------\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\n * See License in the project root for license information.\n * -------------------------------------------------------------------------------------------\n */\n\n/**\n * All schemas and stores for caching component calls\n */\nexport const schemas = {\n presence: {\n name: 'presence',\n stores: {\n presence: 'presence'\n },\n version: 2\n },\n users: {\n name: 'users',\n stores: {\n users: 'users',\n usersQuery: 'usersQuery',\n userFilters: 'userFilters'\n },\n version: 3\n },\n photos: {\n name: 'photos',\n stores: {\n contacts: 'contacts',\n users: 'users',\n groups: 'groups',\n teams: 'teams'\n },\n version: 2\n },\n people: {\n name: 'people',\n stores: {\n contacts: 'contacts',\n groupPeople: 'groupPeople',\n peopleQuery: 'peopleQuery'\n },\n version: 3\n },\n groups: {\n name: 'groups',\n stores: {\n groups: 'groups',\n groupsQuery: 'groupsQuery'\n },\n version: 5\n },\n get: {\n name: 'responses',\n stores: {\n responses: 'responses'\n },\n version: 2\n },\n search: {\n name: 'search',\n stores: {\n responses: 'responses'\n },\n version: 2\n },\n files: {\n name: 'files',\n stores: {\n driveFiles: 'driveFiles',\n groupFiles: 'groupFiles',\n siteFiles: 'siteFiles',\n userFiles: 'userFiles',\n insightFiles: 'insightFiles',\n fileQueries: 'fileQueries'\n },\n version: 2\n },\n fileLists: {\n name: 'file-lists',\n stores: {\n fileLists: 'fileLists',\n insightfileLists: 'insightfileLists'\n },\n version: 2\n }\n};\n","/**\n * -------------------------------------------------------------------------------------------\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\n * See License in the project root for license information.\n * -------------------------------------------------------------------------------------------\n */\n\nimport { IDynamicPerson, IContact, IGroup, IUser } from './types';\n\nexport const isGroup = (obj: IDynamicPerson): obj is IGroup => {\n return 'groupTypes' in obj;\n};\n\nexport const isUser = (obj: IDynamicPerson): obj is IUser => {\n return 'personType' in obj || 'userType' in obj;\n};\n\nexport const isContact = (obj: IDynamicPerson): obj is IContact => {\n return 'initials' in obj;\n};\n","/**\n * -------------------------------------------------------------------------------------------\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\n * See License in the project root for license information.\n * -------------------------------------------------------------------------------------------\n */\n\nimport { IGraph, prepScopes, CacheItem, CacheService, CacheStore, CacheSchema } from '@microsoft/mgt-element';\nimport { Contact, Person, User } from '@microsoft/microsoft-graph-types';\nimport { CollectionResponse } from '@microsoft/mgt-element';\nimport { extractEmailAddress } from '../utils/Utils';\nimport { schemas } from './cacheStores';\nimport { IDynamicPerson } from './types';\n\nconst personTypes = ['any', 'person', 'group'] as const;\n/**\n * Person Type enum\n *\n * @export\n * @enum {string}\n */\nexport type PersonType = (typeof personTypes)[number];\nexport const isPersonType = (value: unknown): value is PersonType =>\n typeof value === 'string' && personTypes.includes(value as PersonType);\nexport const personTypeConverter = (value: string, defaultValue: PersonType = 'any'): PersonType =>\n isPersonType(value) ? value : defaultValue;\n\nconst userTypes = ['any', 'user', 'contact'] as const;\n/**\n * User Type enum\n *\n * @export\n * @enum {string}\n */\nexport type UserType = (typeof userTypes)[number];\n\nexport const isUserType = (value: unknown): value is UserType => {\n return typeof value === 'string' && userTypes.includes(value as UserType);\n};\n\nexport const userTypeConverter = (value: string, defaultValue: UserType = 'any'): UserType =>\n isUserType(value) ? value : defaultValue;\n\n/**\n * Object to be stored in cache representing individual people\n */\ninterface CachePerson extends CacheItem {\n /**\n * json representing a person stored as string\n */\n person?: string;\n}\n\n/**\n * Stores results of queries (multiple people returned)\n */\ninterface CachePeopleQuery extends CacheItem {\n /**\n * max number of results the query asks for\n */\n maxResults?: number;\n /**\n * list of people returned by query (might be less than max results!)\n */\n results?: string[];\n}\n\n/**\n * Defines the expiration time\n */\nconst getPeopleInvalidationTime = (): number => {\n return CacheService.config.people.invalidationPeriod || CacheService.config.defaultInvalidationPeriod;\n};\n\n/**\n * Whether the people store is enabled\n */\nconst getIsPeopleCacheEnabled = (): boolean => CacheService.config.people.isEnabled && CacheService.config.isEnabled;\n\nconst validPeopleQueryScopes = ['People.Read', 'People.Read.All'];\nconst validContactQueryScopes = ['Contacts.Read', 'Contacts.ReadWrite'];\n\n/**\n * async promise, returns all Graph people who are most relevant contacts to the signed in user.\n *\n * @param {IGraph} graph\n * @param {string} query\n * @param {number} [top=10] - number of people to return\n * @param {UserType} [personType='any'] - the type of person to search for\n * @returns {(Promise)}\n */\nexport const findPeople = async (\n graph: IGraph,\n query: string,\n top = 10,\n userType: UserType = 'any',\n filters = ''\n): Promise => {\n const cacheKey = `${query}:${top}:${userType}`;\n let cache: CacheStore;\n if (getIsPeopleCacheEnabled()) {\n const people: CacheSchema = schemas.people;\n const peopleQuery: string = schemas.people.stores.peopleQuery;\n cache = CacheService.getCache(people, peopleQuery);\n const result: CachePeopleQuery = getIsPeopleCacheEnabled() ? await cache.getValue(cacheKey) : null;\n if (result && getPeopleInvalidationTime() > Date.now() - result.timeCached) {\n return result.results.map(peopleStr => JSON.parse(peopleStr) as Person);\n }\n }\n\n let filter = \"personType/class eq 'Person'\";\n\n if (userType !== 'any') {\n if (userType === 'user') {\n filter += \"and personType/subclass eq 'OrganizationUser'\";\n } else {\n filter += \"and (personType/subclass eq 'ImplicitContact' or personType/subclass eq 'PersonalContact')\";\n }\n }\n\n if (filters !== '') {\n // Adding the default people filters to the search filters\n filter += ` and ${filters}`;\n }\n let graphResult: CollectionResponse;\n try {\n let graphRequest = graph\n .api('/me/people')\n .search('\"' + query + '\"')\n .top(top)\n .filter(filter)\n .middlewareOptions(prepScopes(validPeopleQueryScopes));\n\n if (userType !== 'contact') {\n // for any type other than Contact, user a wider search\n graphRequest = graphRequest.header('X-PeopleQuery-QuerySources', 'Mailbox,Directory');\n }\n\n graphResult = (await graphRequest.get()) as CollectionResponse;\n\n if (getIsPeopleCacheEnabled() && graphResult) {\n const item: CachePeopleQuery = { maxResults: top, results: null };\n item.results = graphResult.value.map(personStr => JSON.stringify(personStr));\n await cache.putValue(cacheKey, item);\n }\n } catch (error) {\n // intentionally empty\n }\n return graphResult?.value;\n};\n\n/**\n * async promise to the Graph for People, by default, it will request the most frequent contacts for the signed in user.\n *\n * @returns {(Promise)}\n * @memberof Graph\n */\nexport const getPeople = async (\n graph: IGraph,\n userType: UserType = 'any',\n peopleFilters = '',\n top = 10\n): Promise => {\n let cache: CacheStore;\n const cacheKey = `${peopleFilters ? peopleFilters : `*:${userType}`}:${top}`;\n\n if (getIsPeopleCacheEnabled()) {\n cache = CacheService.getCache(schemas.people, schemas.people.stores.peopleQuery);\n const cacheRes = await cache.getValue(cacheKey);\n\n if (cacheRes && getPeopleInvalidationTime() > Date.now() - cacheRes.timeCached) {\n return cacheRes.results.map(ppl => JSON.parse(ppl) as Person);\n }\n }\n\n const uri = '/me/people';\n let filter = \"personType/class eq 'Person'\";\n if (userType !== 'any') {\n if (userType === 'user') {\n filter += \"and personType/subclass eq 'OrganizationUser'\";\n } else {\n filter += \"and (personType/subclass eq 'ImplicitContact' or personType/subclass eq 'PersonalContact')\";\n }\n }\n\n if (peopleFilters) {\n filter += ` and ${peopleFilters}`;\n }\n\n let people: CollectionResponse;\n try {\n let graphRequest = graph.api(uri).middlewareOptions(prepScopes(validPeopleQueryScopes)).top(top).filter(filter);\n\n if (userType !== 'contact') {\n // for any type other than Contact, user a wider search\n graphRequest = graphRequest.header('X-PeopleQuery-QuerySources', 'Mailbox,Directory');\n }\n\n people = (await graphRequest.get()) as CollectionResponse;\n if (getIsPeopleCacheEnabled() && people) {\n await cache.putValue(cacheKey, { maxResults: 10, results: people.value.map(ppl => JSON.stringify(ppl)) });\n }\n } catch (_) {\n // no-op\n }\n return people ? people.value : null;\n};\n\n/**\n * Attempts to extract the email from the IDynamicPerson properties.\n *\n * @param {IDynamicperson} entity\n */\nexport const getEmailFromGraphEntity = (entity: IDynamicPerson): string => {\n const person = entity as Person;\n const user = entity as User;\n const contact = entity as Contact;\n\n if (user.mail) {\n return extractEmailAddress(user.mail);\n } else if (person.scoredEmailAddresses?.length) {\n return extractEmailAddress(person.scoredEmailAddresses[0].address);\n } else if (contact.emailAddresses?.length) {\n return extractEmailAddress(contact.emailAddresses[0].address);\n }\n return null;\n};\n\n/**\n * async promise, returns a Graph contact associated with the email provided\n *\n * @param {string} email\n * @returns {(Promise)}\n * @memberof Graph\n */\nexport const findContactsByEmail = async (graph: IGraph, email: string): Promise => {\n let cache: CacheStore;\n if (getIsPeopleCacheEnabled()) {\n cache = CacheService.getCache(schemas.people, schemas.people.stores.contacts);\n const contact = await cache.getValue(email);\n\n if (contact && getPeopleInvalidationTime() > Date.now() - contact.timeCached) {\n return JSON.parse(contact.person) as Contact[];\n }\n }\n\n const encodedEmail = `${email.replace(/#/g, '%2523')}`;\n\n const result = (await graph\n .api('/me/contacts')\n .filter(`emailAddresses/any(a:a/address eq '${encodedEmail}')`)\n .middlewareOptions(prepScopes(validContactQueryScopes))\n .get()) as CollectionResponse;\n\n if (getIsPeopleCacheEnabled() && result) {\n await cache.putValue(email, { person: JSON.stringify(result.value) });\n }\n\n return result ? result.value : null;\n};\n\n/**\n * async promise, returns Graph people matching the Graph query specified\n * in the resource param\n *\n * @param {IGraph} graph - the graph instance to use for making requests\n * @param {string} version - the graph version url segment to use when making requests\n * @param {string} resource - the resource segment of the graph url to be requested\n * @param {string[]} scopes - an array of scopes that are required to make the underlying graph request,\n * if any scope provided is not currently consented then the user will be prompted for consent prior to\n * making the graph request to load data.\n * @returns {(Promise)}\n * @memberof Graph\n */\nexport const getPeopleFromResource = async (\n graph: IGraph,\n version: string,\n resource: string,\n scopes: string[]\n): Promise => {\n let cache: CacheStore;\n const key = `${version}${resource}`;\n if (getIsPeopleCacheEnabled()) {\n cache = CacheService.getCache(schemas.people, schemas.people.stores.peopleQuery);\n const result: CachePeopleQuery = await cache.getValue(key);\n if (result && getPeopleInvalidationTime() > Date.now() - result.timeCached) {\n return result.results.map(peopleStr => JSON.parse(peopleStr) as Person);\n }\n }\n\n let request = graph.api(resource).version(version);\n\n if (scopes?.length) {\n request = request.middlewareOptions(prepScopes(scopes));\n }\n\n let response = (await request.get()) as CollectionResponse;\n // get more pages if there are available\n if (response && Array.isArray(response.value) && response['@odata.nextLink']) {\n let page = response;\n\n while (page?.['@odata.nextLink']) {\n const nextLink = page['@odata.nextLink'] as string;\n const nextResource = nextLink.split(version)[1];\n page = (await graph.api(nextResource).version(version).get()) as CollectionResponse;\n if (page?.value?.length) {\n page.value = response.value.concat(page.value);\n response = page;\n }\n }\n }\n\n if (getIsPeopleCacheEnabled() && response) {\n const item = { results: null };\n if (Array.isArray(response.value)) {\n item.results = response.value.map(personStr => JSON.stringify(personStr));\n } else {\n item.results = [JSON.stringify(response)];\n }\n await cache.putValue(key, item);\n }\n\n return response?.value;\n};\n","/**\n * -------------------------------------------------------------------------------------------\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\n * See License in the project root for license information.\n * -------------------------------------------------------------------------------------------\n */\n\nimport { IGraph, prepScopes, CacheItem, CacheService, CacheStore } from '@microsoft/mgt-element';\nimport { ResponseType } from '@microsoft/microsoft-graph-client';\nimport * as MicrosoftGraph from '@microsoft/microsoft-graph-types';\nimport { Person, ProfilePhoto } from '@microsoft/microsoft-graph-types';\n\nimport { blobToBase64 } from '../utils/Utils';\nimport { schemas } from './cacheStores';\nimport { findContactsByEmail, getEmailFromGraphEntity } from './graph.people';\nimport { findUsers } from './graph.user';\nimport { IDynamicPerson } from './types';\n\n/**\n * photo object stored in cache\n */\nexport interface CachePhoto extends CacheItem {\n /**\n * user tag associated with photo\n */\n eTag?: string;\n /**\n * user/contact photo\n */\n photo?: string;\n}\n\n/**\n * Defines expiration time\n */\nexport const getPhotoInvalidationTime = () =>\n CacheService.config.photos.invalidationPeriod || CacheService.config.defaultInvalidationPeriod;\n\n/**\n * Whether photo store is enabled\n */\nexport const getIsPhotosCacheEnabled = () => CacheService.config.photos.isEnabled && CacheService.config.isEnabled;\n\n/**\n * Ordered list of scopes able to load user photos for any user, least privilege comes first\n */\nexport const anyUserValidPhotoScopes = ['User.ReadBasic.All', 'User.Read.All', 'User.ReadWrite.All'];\n\n/**\n * Ordered list of scopes able to load user photo for the current user, least privilege comes first\n */\nexport const currentUserValidPhotoScopes = ['User.Read', 'User.ReadWrite', ...anyUserValidPhotoScopes];\n\n/**\n * retrieves a photo for the specified resource.\n *\n * @param {string} resource\n * @param {string[]} scopes\n * @returns {Promise}\n */\nexport const getPhotoForResource = async (graph: IGraph, resource: string, scopes: string[]): Promise => {\n try {\n const response = (await graph\n .api(`${resource}/photo/$value`)\n .responseType(ResponseType.RAW)\n .middlewareOptions(prepScopes(scopes))\n .get()) as Response;\n\n if (response.status === 404) {\n // 404 means the resource does not have a photo\n // we still want to cache that state\n // so we return an object that can be cached\n return { eTag: null, photo: null };\n } else if (!response.ok) {\n return null;\n }\n\n const eTag = response['@odata.mediaEtag'] as string;\n const blob = await blobToBase64(await response.blob());\n return { eTag, photo: blob };\n } catch (e) {\n return null;\n }\n};\n\n/**\n * async promise, returns Graph photos associated with contacts of the logged in user\n *\n * @param contactId\n * @returns {Promise}\n * @memberof Graph\n */\nexport const getContactPhoto = async (graph: IGraph, contactId: string): Promise => {\n let cache: CacheStore;\n let photoDetails: CachePhoto;\n if (getIsPhotosCacheEnabled()) {\n cache = CacheService.getCache(schemas.photos, schemas.photos.stores.contacts);\n photoDetails = await cache.getValue(contactId);\n if (photoDetails && getPhotoInvalidationTime() > Date.now() - photoDetails.timeCached) {\n return photoDetails.photo;\n }\n }\n const validContactPhotoScopes = ['Contacts.Read', 'Contacts.ReadWrite'];\n\n photoDetails = await getPhotoForResource(graph, `me/contacts/${contactId}`, validContactPhotoScopes);\n if (getIsPhotosCacheEnabled() && photoDetails) {\n await cache.putValue(contactId, photoDetails);\n }\n return photoDetails ? photoDetails.photo : null;\n};\n\n/**\n * async promise, returns Graph photo associated with provided userId\n *\n * @param userId\n * @returns {Promise}\n * @memberof Graph\n */\nexport const getUserPhoto = async (graph: IGraph, userId: string): Promise => {\n let cache: CacheStore;\n let photoDetails: CachePhoto;\n\n if (getIsPhotosCacheEnabled()) {\n cache = CacheService.getCache(schemas.photos, schemas.photos.stores.users);\n photoDetails = await cache.getValue(userId);\n if (photoDetails && getPhotoInvalidationTime() > Date.now() - photoDetails.timeCached) {\n return photoDetails.photo;\n } else if (photoDetails) {\n // there is a photo in the cache, but it's stale. implicit assumption that the app has permissions\n // necessary to fetch photo metadata otherwise there couldn't be data in the cache\n try {\n const response = (await graph.api(`users/${userId}/photo`).get()) as ProfilePhoto;\n if (\n response &&\n (response['@odata.mediaEtag'] !== photoDetails.eTag ||\n (response['@odata.mediaEtag'] === null && photoDetails.eTag === null))\n ) {\n // set photoDetails to null so that photo gets pulled from the graph later\n photoDetails = null;\n }\n } catch {\n return null;\n }\n }\n }\n // if there is a photo in the cache, we got here because it was stale\n photoDetails = photoDetails || (await getPhotoForResource(graph, `users/${userId}`, anyUserValidPhotoScopes));\n if (getIsPhotosCacheEnabled() && photoDetails) {\n await cache.putValue(userId, photoDetails);\n }\n return photoDetails ? photoDetails.photo : null;\n};\n\n/**\n * async promise, returns Graph photo associated with the logged in user\n *\n * @returns {Promise}\n * @memberof Graph\n */\nexport const myPhoto = async (graph: IGraph): Promise => {\n let cache: CacheStore;\n let photoDetails: CachePhoto;\n if (getIsPhotosCacheEnabled()) {\n cache = CacheService.getCache(schemas.photos, schemas.photos.stores.users);\n photoDetails = await cache.getValue('me');\n if (photoDetails && getPhotoInvalidationTime() > Date.now() - photoDetails.timeCached) {\n return photoDetails.photo;\n }\n }\n\n try {\n const response = (await graph.api('me/photo').get()) as ProfilePhoto;\n if (\n response &&\n (response['@odata.mediaEtag'] !== photoDetails.eTag ||\n (response['@odata.mediaEtag'] === null && photoDetails.eTag === null))\n ) {\n photoDetails = null;\n }\n } catch {\n return null;\n }\n photoDetails = photoDetails || (await getPhotoForResource(graph, 'me', currentUserValidPhotoScopes));\n if (getIsPhotosCacheEnabled()) {\n await cache.putValue('me', photoDetails || {});\n }\n\n return photoDetails ? photoDetails.photo : null;\n};\n\n/**\n * async promise, loads image of user\n *\n * @export\n */\nexport const getPersonImage = async (graph: IGraph, person: IDynamicPerson, useContactsApis = true) => {\n // handle if person but not user\n if ('personType' in person && (person as Person).personType.subclass !== 'OrganizationUser') {\n if ((person as Person).personType.subclass === 'PersonalContact' && useContactsApis) {\n // if person is a contact, look for them and their photo in contact api\n const contactMail = getEmailFromGraphEntity(person);\n const contact = await findContactsByEmail(graph, contactMail);\n if (contact?.length && contact[0].id) {\n return await getContactPhoto(graph, contact[0].id);\n }\n }\n\n return null;\n }\n\n // handle if user\n if ((person as MicrosoftGraph.Person).userPrincipalName || person.id) {\n // try to find a user by userPrincipalName\n const id = (person as MicrosoftGraph.Person).userPrincipalName || person.id;\n return await getUserPhoto(graph, id);\n }\n\n // else assume id is for user and try to get photo\n if (person.id) {\n const image = await getUserPhoto(graph, person.id);\n if (image) {\n return image;\n }\n }\n\n // let's try to find a person by the email\n const email = getEmailFromGraphEntity(person);\n\n if (email) {\n // try to find user\n const users = await findUsers(graph, email, 1);\n if (users?.length) {\n return await getUserPhoto(graph, users[0].id);\n }\n\n // if no user, try to find a contact\n if (useContactsApis) {\n const contacts = await findContactsByEmail(graph, email);\n if (contacts?.length) {\n return await getContactPhoto(graph, contacts[0].id);\n }\n }\n }\n\n return null;\n};\n\n/**\n * Load the image for a group\n *\n * @param graph\n * @param group\n * @param useContactsApis\n * @returns\n */\nexport const getGroupImage = async (graph: IGraph, group: IDynamicPerson) => {\n let photoDetails: CachePhoto;\n let cache: CacheStore;\n\n const groupId = group.id;\n\n if (getIsPhotosCacheEnabled()) {\n cache = CacheService.getCache(schemas.photos, schemas.photos.stores.groups);\n photoDetails = await cache.getValue(groupId);\n if (photoDetails && getPhotoInvalidationTime() > Date.now() - photoDetails.timeCached) {\n return photoDetails.photo;\n } else if (photoDetails) {\n // there is a photo in the cache, but it's stale\n try {\n const response = (await graph.api(`groups/${groupId}/photo`).get()) as ProfilePhoto;\n if (\n response &&\n (response['@odata.mediaEtag'] !== photoDetails.eTag ||\n (response['@odata.mediaEtag'] === null && photoDetails.eTag === null))\n ) {\n // set photoDetails to null so that photo gets pulled from the graph later\n photoDetails = null;\n }\n } catch {\n return null;\n }\n }\n }\n\n const validGroupPhotoScopes = ['Group.Read.All', 'Group.ReadWrite.All'];\n // if there is a photo in the cache, we got here because it was stale\n photoDetails = photoDetails || (await getPhotoForResource(graph, `groups/${groupId}`, validGroupPhotoScopes));\n if (getIsPhotosCacheEnabled() && photoDetails) {\n await cache.putValue(groupId, photoDetails);\n }\n return photoDetails ? photoDetails.photo : null;\n};\n\n/**\n * checks if user has a photo in the cache\n *\n * @param userId\n * @returns {CachePhoto}\n * @memberof Graph\n */\nexport const getPhotoFromCache = async (userId: string, storeName: string): Promise => {\n const cache = CacheService.getCache(schemas.photos, storeName);\n const item = await cache.getValue(userId);\n return item;\n};\n\n/**\n * checks if user has a photo in the cache\n *\n * @param userId\n * @returns {void}\n * @memberof Graph\n */\nexport const storePhotoInCache = async (userId: string, storeName: string, value: CachePhoto): Promise => {\n const cache = CacheService.getCache(schemas.photos, storeName);\n await cache.putValue(userId, value);\n};\n","/**\n * -------------------------------------------------------------------------------------------\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\n * See License in the project root for license information.\n * -------------------------------------------------------------------------------------------\n */\n\nimport { IGraph, prepScopes, CacheItem, CacheService, CacheStore, CollectionResponse } from '@microsoft/mgt-element';\nimport { Person, Presence } from '@microsoft/microsoft-graph-types';\nimport { schemas } from './cacheStores';\nimport { IDynamicPerson } from './types';\n\n/**\n * Object to be stored in cache representing individual people\n */\ninterface CachePresence extends CacheItem {\n /**\n * json representing a person stored as string\n */\n presence?: string;\n}\n\n/**\n * Defines the expiration time\n */\nconst getPresenceInvalidationTime = (): number =>\n CacheService.config.presence.invalidationPeriod || CacheService.config.defaultInvalidationPeriod;\n\n/**\n * Whether the groups store is enabled\n */\nconst getIsPresenceCacheEnabled = (): boolean =>\n CacheService.config.presence.isEnabled && CacheService.config.isEnabled;\n\n/**\n * async promise, allows developer to get user presence\n *\n * @returns {Promise}\n * @param {IGraph} graph\n * @param {string} userId - id for the user or null for current signed in user\n * @memberof BetaGraph\n */\nexport const getUserPresence = async (graph: IGraph, userId?: string): Promise => {\n let cache: CacheStore;\n\n if (getIsPresenceCacheEnabled()) {\n cache = CacheService.getCache(schemas.presence, schemas.presence.stores.presence);\n const presence = await cache.getValue(userId || 'me');\n if (presence && getPresenceInvalidationTime() > Date.now() - presence.timeCached) {\n return JSON.parse(presence.presence) as Presence;\n }\n }\n\n const validScopes = userId ? ['presence.read.all'] : ['presence.read', 'presence.read.all'];\n const resource = userId ? `/users/${userId}/presence` : '/me/presence';\n\n const result = (await graph.api(resource).middlewareOptions(prepScopes(validScopes)).get()) as Presence;\n if (getIsPresenceCacheEnabled()) {\n await cache.putValue(userId || 'me', { presence: JSON.stringify(result) });\n }\n\n return result;\n};\n\n/**\n * async promise, allows developer to get person presense by providing array of IDynamicPerson\n *\n * @returns {}\n * @memberof BetaGraph\n */\nexport const getUsersPresenceByPeople = async (graph: IGraph, people?: IDynamicPerson[]) => {\n if (!people || people.length === 0) {\n return {};\n }\n\n const peoplePresence: Record = {};\n const peoplePresenceToQuery: string[] = [];\n const validScopes = ['presence.read.all'];\n let cache: CacheStore;\n\n if (getIsPresenceCacheEnabled()) {\n cache = CacheService.getCache(schemas.presence, schemas.presence.stores.presence);\n }\n\n for (const person of people) {\n if (person?.id) {\n const id = person.id;\n peoplePresence[id] = null;\n let presence: CachePresence;\n if (getIsPresenceCacheEnabled()) {\n presence = await cache.getValue(id);\n }\n if (getIsPresenceCacheEnabled() && presence && getPresenceInvalidationTime() > Date.now() - presence.timeCached) {\n peoplePresence[id] = JSON.parse(presence.presence) as Presence;\n } else {\n peoplePresenceToQuery.push(id);\n }\n }\n }\n\n try {\n if (peoplePresenceToQuery.length > 0) {\n const presenceResult = (await graph\n .api('/communications/getPresencesByUserId')\n .middlewareOptions(prepScopes(validScopes))\n .post({\n ids: peoplePresenceToQuery\n })) as CollectionResponse;\n\n for (const r of presenceResult.value) {\n peoplePresence[r.id] = r;\n if (getIsPresenceCacheEnabled()) {\n await cache.putValue(r.id, { presence: JSON.stringify(r) });\n }\n }\n }\n\n return peoplePresence;\n } catch (_) {\n try {\n /**\n * individual calls to getUserPresence as fallback\n * must filter out the contacts, which will either 404 or have PresenceUnknown response\n * caching will be handled by getUserPresence\n */\n const response = await Promise.all(\n people\n .filter(\n person =>\n person?.id &&\n !peoplePresence[person.id] &&\n 'personType' in person &&\n (person as Person).personType.subclass === 'OrganizationUser'\n )\n .map(person => getUserPresence(graph, person.id))\n );\n\n for (const r of response) {\n peoplePresence[r.id] = r;\n }\n return peoplePresence;\n } catch (e) {\n return null;\n }\n }\n};\n","/**\n * -------------------------------------------------------------------------------------------\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\n * See License in the project root for license information.\n * -------------------------------------------------------------------------------------------\n */\n\nimport { CacheItem, CacheService, CacheStore, CollectionResponse, IGraph, prepScopes } from '@microsoft/mgt-element';\nimport { User } from '@microsoft/microsoft-graph-types';\n\nimport { GraphRequest } from '@microsoft/microsoft-graph-client';\nimport { schemas } from './cacheStores';\nimport { findPeople, PersonType } from './graph.people';\nimport { IDynamicPerson } from './types';\n\n/**\n * Object to be stored in cache\n */\nexport interface CacheUser extends CacheItem {\n /**\n * stringified json representing a user\n */\n user?: string;\n}\n\n/**\n * Object to be stored in cache\n */\nexport interface CacheUserQuery extends CacheItem {\n /**\n * max number of results the query asks for\n */\n maxResults?: number;\n /**\n * list of users returned by query\n */\n results?: string[];\n}\n\n/**\n * Defines the time it takes for objects in the cache to expire\n */\nexport const getUserInvalidationTime = (): number =>\n CacheService.config.users.invalidationPeriod || CacheService.config.defaultInvalidationPeriod;\n\n/**\n * Whether or not the cache is enabled\n */\nexport const getIsUsersCacheEnabled = (): boolean =>\n CacheService.config.users.isEnabled && CacheService.config.isEnabled;\n\nexport const getUsers = async (graph: IGraph, userFilters = '', top = 10): Promise => {\n const allValidScopes = [\n 'User.ReadBasic.All',\n 'User.Read.All',\n 'Directory.Read.All',\n 'User.ReadWrite.All',\n 'Directory.ReadWrite.All'\n ];\n const apiString = '/users';\n let cache: CacheStore;\n const cacheKey = `${userFilters === '' ? '*' : userFilters}:${top}`;\n const cacheItem = { maxResults: top, results: null };\n\n if (getIsUsersCacheEnabled()) {\n cache = CacheService.getCache(schemas.users, schemas.users.stores.userFilters);\n const cacheRes = await cache.getValue(cacheKey);\n if (cacheRes && getUserInvalidationTime() > Date.now() - cacheRes.timeCached) {\n return cacheRes.results.map(userStr => JSON.parse(userStr) as User);\n }\n }\n const graphClient: GraphRequest = graph.api(apiString).top(top);\n\n if (userFilters) {\n graphClient.filter(userFilters).header('ConsistencyLevel', 'eventual').count(true);\n }\n\n try {\n const response = (await graphClient\n .middlewareOptions(prepScopes(allValidScopes))\n .get()) as CollectionResponse;\n if (getIsUsersCacheEnabled() && response) {\n cacheItem.results = response.value.map(userStr => JSON.stringify(userStr));\n await cache.putValue(userFilters, cacheItem);\n }\n return response.value;\n // eslint-disable-next-line no-empty\n } catch (error) {}\n};\n\nconst allValidMeScopes = ['User.Read', 'User.ReadWrite'];\n/**\n * async promise, returns Graph User data relating to the user logged in\n *\n * @returns {(Promise)}\n * @memberof Graph\n */\nexport const getMe = async (graph: IGraph, requestedProps?: string[]): Promise => {\n // for the /me call we'll only use the single User.Read and User.ReadWrite permissions\n // as they are explicitly scoped to the current user\n let cache: CacheStore;\n if (getIsUsersCacheEnabled()) {\n cache = CacheService.getCache(schemas.users, schemas.users.stores.users);\n const me = await cache.getValue('me');\n\n if (me && getUserInvalidationTime() > Date.now() - me.timeCached) {\n const cachedData = JSON.parse(me.user) as User;\n const uniqueProps = requestedProps\n ? requestedProps.filter(prop => !Object.keys(cachedData).includes(prop))\n : null;\n\n // if requestedProps doesn't contain any unique props other than \"@odata.context\"\n if (!uniqueProps || uniqueProps.length <= 1) {\n return cachedData;\n }\n }\n }\n\n let apiString = 'me';\n if (requestedProps) {\n apiString = apiString + '?$select=' + requestedProps.toString();\n }\n const response = (await graph.api(apiString).middlewareOptions(prepScopes(allValidMeScopes)).get()) as User;\n if (getIsUsersCacheEnabled()) {\n await cache.putValue('me', { user: JSON.stringify(response) });\n }\n return response;\n};\n\nexport const validUserByIdScopes = [\n 'User.ReadBasic.All',\n 'User.Read.All',\n 'Directory.Read.All',\n 'User.ReadWrite.All',\n 'Directory.ReadWrite.All'\n];\n/**\n * async promise, returns all Graph users associated with the userPrincipleName provided\n *\n * @param {string} userPrincipleName\n * @returns {(Promise)}\n * @memberof Graph\n */\nexport const getUser = async (graph: IGraph, userPrincipleName: string, requestedProps?: string[]): Promise => {\n let cache: CacheStore;\n\n if (getIsUsersCacheEnabled()) {\n cache = CacheService.getCache(schemas.users, schemas.users.stores.users);\n // check cache\n const user = await cache.getValue(userPrincipleName);\n\n // is it stored and is timestamp good?\n if (user && getUserInvalidationTime() > Date.now() - user.timeCached) {\n const cachedData = user.user ? (JSON.parse(user.user) as User) : null;\n const uniqueProps =\n requestedProps && cachedData ? requestedProps.filter(prop => !Object.keys(cachedData).includes(prop)) : null;\n\n // return without any worries\n if (!uniqueProps || uniqueProps.length <= 1) {\n return cachedData;\n }\n }\n }\n\n let apiString = `/users/${userPrincipleName}`;\n if (requestedProps) {\n apiString = apiString + '?$select=' + requestedProps.toString();\n }\n\n // else we must grab it\n let response: User;\n try {\n response = (await graph.api(apiString).middlewareOptions(prepScopes(validUserByIdScopes)).get()) as User;\n // eslint-disable-next-line no-empty\n } catch (_) {}\n\n if (getIsUsersCacheEnabled()) {\n await cache.putValue(userPrincipleName, { user: JSON.stringify(response) });\n }\n return response;\n};\n\n/**\n * Returns a Promise of Graph Users array associated with the user ids array\n *\n * @export\n * @param {IGraph} graph\n * @param {string[]} userIds, an array of string ids\n * @returns {Promise}\n */\nexport const getUsersForUserIds = async (\n graph: IGraph,\n userIds: string[],\n searchInput = '',\n userFilters = '',\n fallbackDetails?: IDynamicPerson[]\n): Promise => {\n if (!userIds || userIds.length === 0) {\n return [];\n }\n const batch = graph.createBatch();\n const peopleDict: Record> = {};\n const peopleSearchMatches = {};\n const notInCache = [];\n searchInput = searchInput.toLowerCase();\n let cache: CacheStore;\n\n if (getIsUsersCacheEnabled()) {\n cache = CacheService.getCache(schemas.users, schemas.users.stores.users);\n }\n\n for (const id of userIds) {\n peopleDict[id] = null;\n let apiUrl = `/users/${id}`;\n let user: User;\n let cacheUser: CacheUser;\n if (getIsUsersCacheEnabled()) {\n cacheUser = await cache.getValue(id);\n }\n if (cacheUser?.user && getUserInvalidationTime() > Date.now() - cacheUser.timeCached) {\n user = JSON.parse(cacheUser?.user) as User;\n\n if (searchInput) {\n if (user) {\n const displayName = user.displayName;\n const searchMatches = displayName?.toLowerCase().includes(searchInput);\n if (searchMatches) {\n peopleSearchMatches[id] = user;\n }\n }\n } else {\n if (user) {\n peopleDict[id] = user;\n } else {\n batch.get(id, apiUrl, validUserByIdScopes);\n notInCache.push(id);\n }\n }\n } else if (id !== '') {\n if (id === 'me') {\n peopleDict[id] = await getMe(graph);\n } else {\n apiUrl = `/users/${id}`;\n if (userFilters) {\n apiUrl += `${apiUrl}?$filter=${userFilters}&$count=true`;\n }\n batch.get(id, apiUrl, validUserByIdScopes, userFilters ? { ConsistencyLevel: 'eventual' } : {});\n notInCache.push(id);\n }\n }\n }\n try {\n if (batch.hasRequests) {\n const responses = await batch.executeAll();\n // iterate over userIds to ensure the order of ids\n for (const id of userIds) {\n const response = responses.get(id);\n if (response?.content) {\n const user = response.content;\n if (searchInput) {\n const displayName = user?.displayName.toLowerCase() || '';\n if (displayName.includes(searchInput)) {\n peopleSearchMatches[id] = user;\n }\n } else {\n peopleDict[id] = user;\n }\n\n if (getIsUsersCacheEnabled()) {\n await cache.putValue(id, { user: JSON.stringify(user) });\n }\n } else {\n const fallback = fallbackDetails.find(detail => Object.values(detail).includes(id));\n if (fallback) {\n peopleDict[id] = fallback as User;\n }\n }\n }\n }\n if (searchInput && Object.keys(peopleSearchMatches).length) {\n return Promise.all(Object.values(peopleSearchMatches));\n }\n return Promise.all(Object.values(peopleDict));\n } catch (_) {\n // fallback to making the request one by one\n try {\n // call getUser for all the users that weren't cached\n userIds\n .filter(id => notInCache.includes(id))\n .forEach(id => {\n peopleDict[id] = getUser(graph, id);\n });\n if (getIsUsersCacheEnabled()) {\n // store all users that weren't retrieved from the cache, into the cache\n await Promise.all(\n userIds\n .filter(id => notInCache.includes(id))\n .map(async id => await cache.putValue(id, { user: JSON.stringify(await peopleDict[id]) }))\n );\n }\n return Promise.all(Object.values(peopleDict));\n } catch (e) {\n return [];\n }\n }\n};\n\n/**\n * Returns a Promise of Graph Users array associated with the people queries array\n *\n * @export\n * @param {IGraph} graph\n * @param {string[]} peopleQueries, an array of string ids\n * @returns {Promise}\n */\nexport const getUsersForPeopleQueries = async (\n graph: IGraph,\n peopleQueries: string[],\n fallbackDetails?: IDynamicPerson[]\n): Promise => {\n const allValidPeopleScopes = ['People.Read', 'People.Read.All'];\n if (!peopleQueries || peopleQueries.length === 0) {\n return [];\n }\n\n const batch = graph.createBatch>();\n const people: User[] = [];\n let cacheRes: CacheUserQuery;\n let cache: CacheStore;\n if (getIsUsersCacheEnabled()) {\n cache = CacheService.getCache(schemas.users, schemas.users.stores.usersQuery);\n }\n\n for (const personQuery of peopleQueries) {\n if (getIsUsersCacheEnabled()) {\n cacheRes = await cache.getValue(personQuery);\n }\n\n if (\n getIsUsersCacheEnabled() &&\n cacheRes?.results[0] &&\n getUserInvalidationTime() > Date.now() - cacheRes.timeCached\n ) {\n const person = JSON.parse(cacheRes.results[0]) as User;\n people.push(person);\n } else {\n batch.get(personQuery, `/me/people?$search=\"${personQuery}\"`, allValidPeopleScopes, {\n 'X-PeopleQuery-QuerySources': 'Mailbox,Directory'\n });\n }\n }\n\n if (batch.hasRequests) {\n try {\n const responses = await batch.executeAll();\n\n for (const personQuery of peopleQueries) {\n const response = responses.get(personQuery);\n if (response?.content?.value && response.content.value.length > 0) {\n people.push(response.content.value[0]);\n if (getIsUsersCacheEnabled()) {\n await cache.putValue(personQuery, { maxResults: 1, results: [JSON.stringify(response.content.value[0])] });\n }\n } else {\n const fallback = fallbackDetails.find(detail => Object.values(detail).includes(personQuery));\n if (fallback) {\n people.push(fallback as User);\n }\n }\n }\n\n return people;\n } catch (_) {\n try {\n return Promise.all(\n peopleQueries\n .filter(personQuery => personQuery && personQuery !== '')\n .map(async personQuery => {\n const personArray = await findPeople(graph, personQuery, 1);\n if (personArray?.length) {\n if (getIsUsersCacheEnabled()) {\n await cache.putValue(personQuery, { maxResults: 1, results: [JSON.stringify(personArray[0])] });\n }\n return personArray[0];\n }\n })\n );\n } catch (e) {\n return [];\n }\n }\n }\n return people;\n};\n\n/**\n * Search Microsoft Graph for Users in the organization\n *\n * @export\n * @param {IGraph} graph\n * @param {string} query - the string to search for\n * @param {number} [top=10] - maximum number of results to return\n * @returns {Promise}\n */\nexport const findUsers = async (graph: IGraph, query: string, top = 10, userFilters = ''): Promise => {\n const scopes = validUserByIdScopes;\n const item = { maxResults: top, results: null };\n const cacheKey = `${query}:${top}:${userFilters}`;\n let cache: CacheStore;\n\n if (getIsUsersCacheEnabled()) {\n cache = CacheService.getCache(schemas.users, schemas.users.stores.usersQuery);\n const result: CacheUserQuery = await cache.getValue(cacheKey);\n\n if (result && getUserInvalidationTime() > Date.now() - result.timeCached) {\n return result.results.map(userStr => JSON.parse(userStr) as User);\n }\n }\n\n const encodedQuery = `${query.replace(/#/g, '%2523')}`;\n const graphBuilder = graph\n .api('users')\n .search(`\"displayName:${encodedQuery}\" OR \"mail:${encodedQuery}\" OR \"userPrincipalName: ${encodedQuery}\"`)\n .header('ConsistencyLevel', 'eventual')\n .count(true);\n let graphResult: CollectionResponse;\n\n if (userFilters !== '') {\n graphBuilder.filter(userFilters);\n }\n try {\n graphResult = (await graphBuilder.top(top).middlewareOptions(prepScopes(scopes)).get()) as CollectionResponse;\n // eslint-disable-next-line no-empty\n } catch {}\n\n if (getIsUsersCacheEnabled() && graphResult) {\n item.results = graphResult.value.map(userStr => JSON.stringify(userStr));\n await cache.putValue(query, item);\n }\n return graphResult ? graphResult.value : null;\n};\n\n/**\n * async promise, returns all matching Graph users who are member of the specified group\n *\n * @param {string} query\n * @param {string} groupId - the group to query\n * @param {number} [top=10] - number of people to return\n * @param {PersonType} [personType='person'] - the type of person to search for\n * @param {boolean} [transitive=false] - whether the return should contain a flat list of all nested members\n * @returns {(Promise)}\n */\nexport const findGroupMembers = async (\n graph: IGraph,\n query: string,\n groupId: string,\n top = 10,\n personType: PersonType = 'person',\n transitive = false,\n userFilters = '',\n peopleFilters = ''\n): Promise => {\n const allValidScopes = [\n 'GroupMember.Read.All',\n 'Group.Read.All',\n 'Directory.Read.All',\n 'GroupMember.ReadWrite.All',\n 'Group.ReadWrite.All'\n ];\n const item = { maxResults: top, results: null };\n\n let cache: CacheStore;\n const key = `${groupId || '*'}:${query || '*'}:${top}:${personType}:${transitive}:${userFilters}`;\n\n if (getIsUsersCacheEnabled()) {\n cache = CacheService.getCache(schemas.users, schemas.users.stores.usersQuery);\n const result: CacheUserQuery = await cache.getValue(key);\n\n if (result && getUserInvalidationTime() > Date.now() - result.timeCached) {\n return result.results.map(userStr => JSON.parse(userStr) as User);\n }\n }\n\n let filter = '';\n if (query) {\n filter = `startswith(displayName,'${query}') or startswith(givenName,'${query}') or startswith(surname,'${query}') or startswith(mail,'${query}') or startswith(userPrincipalName,'${query}')`;\n }\n\n let apiUrl = `/groups/${groupId}/${transitive ? 'transitiveMembers' : 'members'}`;\n if (personType === 'person') {\n apiUrl += '/microsoft.graph.user';\n } else if (personType === 'group') {\n apiUrl += '/microsoft.graph.group';\n if (query) {\n filter = `startswith(displayName,'${query}') or startswith(mail,'${query}')`;\n }\n }\n\n if (userFilters) {\n filter += query ? ` and ${userFilters}` : userFilters;\n }\n\n if (peopleFilters) {\n filter += query ? ` and ${peopleFilters}` : peopleFilters;\n }\n\n const graphClient: GraphRequest = graph.api(apiUrl).top(top).filter(filter);\n\n if (userFilters) {\n graphClient.header('ConsistencyLevel', 'eventual').count(true);\n }\n\n const graphResult = (await graphClient\n .middlewareOptions(prepScopes(allValidScopes))\n .get()) as CollectionResponse;\n\n if (getIsUsersCacheEnabled() && graphResult) {\n item.results = graphResult.value.map(userStr => JSON.stringify(userStr));\n await cache.putValue(key, item);\n }\n\n return graphResult ? graphResult.value : null;\n};\n\nexport const findUsersFromGroupIds = async (\n graph: IGraph,\n query: string,\n groupIds: string[],\n top = 10,\n personType: PersonType = 'person',\n transitive = false,\n groupFilters = ''\n): Promise => {\n const users: User[] = [];\n for (const groupId of groupIds) {\n try {\n const groupUsers = await findGroupMembers(graph, query, groupId, top, personType, transitive, groupFilters);\n users.push(...groupUsers);\n } catch (_) {\n continue;\n }\n }\n return users;\n};\n","/**\n * -------------------------------------------------------------------------------------------\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\n * See License in the project root for license information.\n * -------------------------------------------------------------------------------------------\n */\n\nimport { GraphError } from '@microsoft/microsoft-graph-client';\n\nexport const isGraphError = (e: unknown): e is GraphError => {\n const test = e as GraphError;\n return (\n test.statusCode &&\n 'code' in test &&\n 'body' in test &&\n test.date &&\n 'message' in test &&\n 'name' in test &&\n 'requestId' in test\n );\n};\n","/**\n * -------------------------------------------------------------------------------------------\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\n * See License in the project root for license information.\n * -------------------------------------------------------------------------------------------\n */\n\nimport { CacheService, IGraph, prepScopes } from '@microsoft/mgt-element';\n\nimport {\n CachePhoto,\n anyUserValidPhotoScopes,\n currentUserValidPhotoScopes,\n getIsPhotosCacheEnabled,\n getPhotoForResource,\n getPhotoFromCache,\n getPhotoInvalidationTime,\n storePhotoInCache\n} from './graph.photos';\nimport { CacheUser, getIsUsersCacheEnabled, getUserInvalidationTime } from './graph.user';\nimport { IDynamicPerson } from './types';\nimport { schemas } from './cacheStores';\nimport { Photo } from '@microsoft/microsoft-graph-types';\nimport { isGraphError } from './isGraphError';\n\n/**\n * async promise, returns IDynamicPerson\n *\n * @param {string} userId\n * @returns {(Promise)}\n * @memberof Graph\n */\nexport const getUserWithPhoto = async (\n graph: IGraph,\n userId?: string,\n requestedProps?: string[]\n): Promise => {\n const anyUserValidScopes = [\n 'User.ReadBasic.All',\n 'User.Read.All',\n 'Directory.Read.All',\n 'User.ReadWrite.All',\n 'Directory.ReadWrite.All'\n ];\n\n const currentUserValidScopes = ['User.Read', 'User.ReadWrite', ...anyUserValidScopes];\n\n const requiredUserScopes = userId ? anyUserValidScopes : currentUserValidScopes;\n const requiredPhotoScopes = userId ? anyUserValidPhotoScopes : currentUserValidPhotoScopes;\n\n let photo: string;\n let user: IDynamicPerson = null;\n\n let cachedPhoto: CachePhoto;\n let cachedUser: CacheUser;\n\n const resource = userId ? `users/${userId}` : 'me';\n const fullResource = resource + (requestedProps ? `?$select=${requestedProps.toString()}` : '');\n\n // attempt to get user and photo from cache if enabled\n if (getIsUsersCacheEnabled()) {\n const cache = CacheService.getCache(schemas.users, schemas.users.stores.users);\n cachedUser = await cache.getValue(userId || 'me');\n if (cachedUser && getUserInvalidationTime() > Date.now() - cachedUser.timeCached) {\n user = cachedUser.user ? (JSON.parse(cachedUser.user) as IDynamicPerson) : null;\n if (user !== null && requestedProps) {\n const uniqueProps = requestedProps.filter(prop => !Object.keys(user).includes(prop));\n if (uniqueProps.length >= 1) {\n user = null;\n cachedUser = null;\n }\n }\n } else {\n cachedUser = null;\n }\n }\n if (getIsPhotosCacheEnabled()) {\n cachedPhoto = await getPhotoFromCache(userId || 'me', schemas.photos.stores.users);\n if (cachedPhoto && getPhotoInvalidationTime() > Date.now() - cachedPhoto.timeCached) {\n photo = cachedPhoto.photo;\n } else if (cachedPhoto) {\n try {\n const response: Photo = (await graph.api(`${resource}/photo`).get()) as Photo;\n if (response?.['@odata.mediaEtag'] && response['@odata.mediaEtag'] === cachedPhoto.eTag) {\n // put current image into the cache to update the timestamp since etag is the same\n await storePhotoInCache(userId || 'me', schemas.photos.stores.users, cachedPhoto);\n photo = cachedPhoto.photo;\n } else {\n cachedPhoto = null;\n }\n } catch (e: unknown) {\n if (isGraphError(e)) {\n // if 404 received (photo not found) but user already in cache, update timeCache value to prevent repeated 404 error / graph calls on each page refresh\n if (e.code === 'ErrorItemNotFound' || e.code === 'ImageNotFound') {\n await storePhotoInCache(userId || 'me', schemas.photos.stores.users, { eTag: null, photo: null });\n }\n }\n }\n }\n }\n\n // if both are not in the cache, batch get them\n if (!cachedPhoto && !cachedUser) {\n let eTag: string;\n\n // batch calls\n const batch = graph.createBatch();\n if (userId) {\n batch.get(\n 'user',\n `/users/${userId}${requestedProps ? '?$select=' + requestedProps.toString() : ''}`,\n requiredUserScopes\n );\n batch.get('photo', `users/${userId}/photo/$value`, requiredPhotoScopes);\n } else {\n batch.get('user', 'me', requiredUserScopes);\n batch.get('photo', 'me/photo/$value', requiredPhotoScopes);\n }\n const response = await batch.executeAll();\n\n const photoResponse = response.get('photo');\n if (photoResponse) {\n // eslint-disable-next-line @typescript-eslint/dot-notation\n eTag = photoResponse.headers['ETag'];\n photo = photoResponse.content as string;\n }\n\n const userResponse = response.get('user');\n if (userResponse) {\n user = userResponse.content as IDynamicPerson;\n }\n\n // store user & photo in their respective cache\n if (getIsUsersCacheEnabled()) {\n const cache = CacheService.getCache(schemas.users, schemas.users.stores.users);\n await cache.putValue(userId || 'me', { user: JSON.stringify(user) });\n }\n if (getIsPhotosCacheEnabled()) {\n await storePhotoInCache(userId || 'me', schemas.photos.stores.users, { eTag, photo });\n }\n } else if (!cachedPhoto) {\n try {\n // if only photo or user is not cached, get it individually\n const response = await getPhotoForResource(graph, resource, requiredPhotoScopes);\n if (response) {\n if (getIsPhotosCacheEnabled()) {\n await storePhotoInCache(userId || 'me', schemas.photos.stores.users, {\n eTag: response.eTag,\n photo: response.photo\n });\n }\n photo = response.photo;\n }\n } catch (_) {\n // intentionally left empty...\n }\n } else if (!cachedUser) {\n // get user from graph\n try {\n const response: IDynamicPerson = (await graph\n .api(fullResource)\n .middlewareOptions(prepScopes(requiredUserScopes))\n .get()) as IDynamicPerson;\n\n if (response) {\n if (getIsUsersCacheEnabled()) {\n const cache = CacheService.getCache(schemas.users, schemas.users.stores.users);\n await cache.putValue(userId || 'me', { user: JSON.stringify(response) });\n }\n user = response;\n }\n } catch (_) {\n // intentionally left empty...\n }\n }\n\n if (user) {\n user.personImage = photo;\n }\n return user;\n};\n","/**\n * -------------------------------------------------------------------------------------------\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\n * See License in the project root for license information.\n * -------------------------------------------------------------------------------------------\n */\n\nimport * as MicrosoftGraph from '@microsoft/microsoft-graph-types';\n\n/**\n * IDynamicPerson describes the person object we use throughout mgt-person,\n * which can be one of three similar Graph types.\n *\n * In addition, this custom type also defines the optional `personImage` property,\n * which is used to pass the image around to other components as part of the person object.\n */\nexport type IUser = MicrosoftGraph.User | MicrosoftGraph.Person;\nexport type IContact = MicrosoftGraph.Contact;\nexport type IGroup = MicrosoftGraph.Group;\n\nexport type IDynamicPerson = (IUser | IContact | IGroup) & {\n /**\n * personDetails.personImage is a toolkit injected property to pass image between components\n * an optimization to avoid fetching the image when unnecessary.\n *\n * @type {string}\n */\n personImage?: string;\n};\n\n/**\n * avatarSize describes the enum strings that can be passed in to determine\n * size of avatar.\n */\nexport type AvatarSize = 'small' | 'large' | 'auto';\n\n/**\n * Insight string types used to retrieve OneDrive files\n */\nexport type OfficeGraphInsightString = 'trending' | 'used' | 'shared';\n\nconst viewTypes = ['image', 'oneline', 'twolines', 'threelines', 'fourlines'] as const;\n/**\n * Enumeration to define what parts of the person component render\n *\n * @export\n * @enum {string}\n */\nexport type ViewType = (typeof viewTypes)[number];\n\nexport const isViewType = (value: unknown): value is ViewType => {\n return typeof value === 'string' && viewTypes.includes(value as ViewType);\n};\n\nexport const viewTypeConverter = (value: string, defaultValue: ViewType = 'twolines'): ViewType => {\n if (isViewType(value)) {\n return value;\n }\n return defaultValue;\n};\n\n/**\n * Postion describes the position of the dropdown\n */\nexport type Position = 'above' | 'below';\n","import { FASTElementDefinition } from \"@microsoft/fast-element\";\nimport { FoundationElement } from \"../foundation-element/foundation-element.js\";\nimport { DI, Registration } from \"../di/di.js\";\nimport { DesignToken } from \"../design-token/design-token.js\";\nimport { ComponentPresentation } from \"./component-presentation.js\";\n/* eslint-disable @typescript-eslint/no-non-null-assertion */\n/**\n * Indicates what to do with an ambiguous (duplicate) element.\n * @public\n */\nexport const ElementDisambiguation = Object.freeze({\n /**\n * Skip defining the element but still call the provided callback passed\n * to DesignSystemRegistrationContext.tryDefineElement\n */\n definitionCallbackOnly: null,\n /**\n * Ignore the duplicate element entirely.\n */\n ignoreDuplicate: Symbol(),\n});\nconst elementTypesByTag = new Map();\nconst elementTagsByType = new Map();\nlet rootDesignSystem = null;\nconst designSystemKey = DI.createInterface(x => x.cachedCallback(handler => {\n if (rootDesignSystem === null) {\n rootDesignSystem = new DefaultDesignSystem(null, handler);\n }\n return rootDesignSystem;\n}));\n/**\n * An API gateway to design system features.\n * @public\n */\nexport const DesignSystem = Object.freeze({\n /**\n * Returns the HTML element name that the type is defined as.\n * @param type - The type to lookup.\n * @public\n */\n tagFor(type) {\n return elementTagsByType.get(type);\n },\n /**\n * Searches the DOM hierarchy for the design system that is responsible\n * for the provided element.\n * @param element - The element to locate the design system for.\n * @returns The located design system.\n * @public\n */\n responsibleFor(element) {\n const owned = element.$$designSystem$$;\n if (owned) {\n return owned;\n }\n const container = DI.findResponsibleContainer(element);\n return container.get(designSystemKey);\n },\n /**\n * Gets the DesignSystem if one is explicitly defined on the provided element;\n * otherwise creates a design system defined directly on the element.\n * @param element - The element to get or create a design system for.\n * @returns The design system.\n * @public\n */\n getOrCreate(node) {\n if (!node) {\n if (rootDesignSystem === null) {\n rootDesignSystem = DI.getOrCreateDOMContainer().get(designSystemKey);\n }\n return rootDesignSystem;\n }\n const owned = node.$$designSystem$$;\n if (owned) {\n return owned;\n }\n const container = DI.getOrCreateDOMContainer(node);\n if (container.has(designSystemKey, false)) {\n return container.get(designSystemKey);\n }\n else {\n const system = new DefaultDesignSystem(node, container);\n container.register(Registration.instance(designSystemKey, system));\n return system;\n }\n },\n});\nfunction extractTryDefineElementParams(params, elementDefinitionType, elementDefinitionCallback) {\n if (typeof params === \"string\") {\n return {\n name: params,\n type: elementDefinitionType,\n callback: elementDefinitionCallback,\n };\n }\n else {\n return params;\n }\n}\nclass DefaultDesignSystem {\n constructor(owner, container) {\n this.owner = owner;\n this.container = container;\n this.designTokensInitialized = false;\n this.prefix = \"fast\";\n this.shadowRootMode = undefined;\n this.disambiguate = () => ElementDisambiguation.definitionCallbackOnly;\n if (owner !== null) {\n owner.$$designSystem$$ = this;\n }\n }\n withPrefix(prefix) {\n this.prefix = prefix;\n return this;\n }\n withShadowRootMode(mode) {\n this.shadowRootMode = mode;\n return this;\n }\n withElementDisambiguation(callback) {\n this.disambiguate = callback;\n return this;\n }\n withDesignTokenRoot(root) {\n this.designTokenRoot = root;\n return this;\n }\n register(...registrations) {\n const container = this.container;\n const elementDefinitionEntries = [];\n const disambiguate = this.disambiguate;\n const shadowRootMode = this.shadowRootMode;\n const context = {\n elementPrefix: this.prefix,\n tryDefineElement(params, elementDefinitionType, elementDefinitionCallback) {\n const extractedParams = extractTryDefineElementParams(params, elementDefinitionType, elementDefinitionCallback);\n const { name, callback, baseClass } = extractedParams;\n let { type } = extractedParams;\n let elementName = name;\n let typeFoundByName = elementTypesByTag.get(elementName);\n let needsDefine = true;\n while (typeFoundByName) {\n const result = disambiguate(elementName, type, typeFoundByName);\n switch (result) {\n case ElementDisambiguation.ignoreDuplicate:\n return;\n case ElementDisambiguation.definitionCallbackOnly:\n needsDefine = false;\n typeFoundByName = void 0;\n break;\n default:\n elementName = result;\n typeFoundByName = elementTypesByTag.get(elementName);\n break;\n }\n }\n if (needsDefine) {\n if (elementTagsByType.has(type) || type === FoundationElement) {\n type = class extends type {\n };\n }\n elementTypesByTag.set(elementName, type);\n elementTagsByType.set(type, elementName);\n if (baseClass) {\n elementTagsByType.set(baseClass, elementName);\n }\n }\n elementDefinitionEntries.push(new ElementDefinitionEntry(container, elementName, type, shadowRootMode, callback, needsDefine));\n },\n };\n if (!this.designTokensInitialized) {\n this.designTokensInitialized = true;\n if (this.designTokenRoot !== null) {\n DesignToken.registerRoot(this.designTokenRoot);\n }\n }\n container.registerWithContext(context, ...registrations);\n for (const entry of elementDefinitionEntries) {\n entry.callback(entry);\n if (entry.willDefine && entry.definition !== null) {\n entry.definition.define();\n }\n }\n return this;\n }\n}\nclass ElementDefinitionEntry {\n constructor(container, name, type, shadowRootMode, callback, willDefine) {\n this.container = container;\n this.name = name;\n this.type = type;\n this.shadowRootMode = shadowRootMode;\n this.callback = callback;\n this.willDefine = willDefine;\n this.definition = null;\n }\n definePresentation(presentation) {\n ComponentPresentation.define(this.name, presentation, this.container);\n }\n defineElement(definition) {\n this.definition = new FASTElementDefinition(this.type, Object.assign(Object.assign({}, definition), { name: this.name }));\n }\n tagFor(type) {\n return DesignSystem.tagFor(type);\n }\n}\n/* eslint-enable @typescript-eslint/no-non-null-assertion */\n","/**\n * -------------------------------------------------------------------------------------------\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\n * See License in the project root for license information.\n * -------------------------------------------------------------------------------------------\n */\n\nimport { provideFluentDesignSystem } from '@fluentui/web-components';\n\n/**\n * Provides a design system to the fluent components\n */\nconst designSystem = provideFluentDesignSystem();\n\n/**\n * Registers fluent components to the design system\n *\n * @param fluentComponents array of fluent components to register\n * @returns\n */\nexport const registerFluentComponents = (...fluentComponents: (() => unknown)[]) => {\n if (!fluentComponents?.length) {\n return;\n }\n\n for (const component of fluentComponents) {\n designSystem.register(component());\n }\n};\n","import { DesignSystem } from '@microsoft/fast-foundation';\n/**\n * Provides a design system for the specified element either by returning one that was\n * already created for that element or creating one.\n * @param element - The element to root the design system at. By default, this is the body.\n * @returns A Fluent Design System\n * @public\n */\nexport function provideFluentDesignSystem(element) {\n return DesignSystem.getOrCreate(element).withPrefix('fluent');\n}\n","/**\n * -------------------------------------------------------------------------------------------\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\n * See License in the project root for license information.\n * -------------------------------------------------------------------------------------------\n */\n\n/**\n * Defines icon used by svgHelper\n *\n * @export\n * @enum {number}\n */\nexport enum SvgIcon {\n /**\n * Arrow Icon pointing down\n */\n ArrowDown,\n\n /**\n * Icon separates team from channel in selection\n */\n TeamSeparator,\n\n /**\n * Search icon\n */\n Search,\n\n /**\n * Skype Arrow icon (out of office status)\n */\n SkypeArrow,\n\n /**\n * Smaller email icon used in top of person card\n */\n SmallEmail,\n\n /**\n * Smaller email, hovered version, icon used in top of person card\n */\n SmallEmailHovered,\n\n /**\n * Smaller chat icon used in top of person card\n */\n SmallChat,\n\n /**\n * Small chat icon, hover version, used in top of person card\n */\n SmallChatHovered,\n\n /**\n * Video icon used in top of person card\n */\n Video,\n\n /**\n * Videoicon, hovered version used in top of person card\n */\n VideoHovered,\n\n /**\n * Downward chevron\n */\n ExpandDown,\n\n /**\n * Overview icon\n */\n Overview,\n\n /**\n * Paper plane\n */\n Send,\n\n /**\n * Phone/Mail icon\n */\n Contact,\n\n /**\n * Copy to clipboard\n */\n Copy,\n\n /**\n * A phone handset\n */\n Phone,\n\n /**\n * A cellphone\n */\n CellPhone,\n\n /**\n * Chat message\n */\n Chat,\n\n /**\n * Call icon\n */\n Call,\n\n /**\n * Call icon, hovered version\n */\n CallHovered,\n\n /**\n * Confirmation icon\n */\n Confirmation,\n /**\n * Company department\n */\n Department,\n\n /**\n *\n * Dot Icon\n */\n Dot,\n\n /**\n * Email message\n */\n Email,\n\n /**\n * Location indicator\n */\n OfficeLocation,\n\n /**\n * A person\n */\n Person,\n\n /**\n * Messages\n */\n Messages,\n\n /**\n * Organization tree\n */\n Organization,\n\n /**\n * Right facing chevron\n */\n ExpandRight,\n\n /**\n * Person profile\n */\n Profile,\n\n /**\n * Balloon\n */\n Birthday,\n\n /**\n * File icon\n */\n File,\n\n /**\n * Files icon\n */\n Files,\n\n /**\n * Back arrow\n */\n Back,\n\n /**\n * Close icon\n */\n Close,\n\n /**\n * Upload icon\n */\n Upload,\n\n /**\n * File Cloud icon\n */\n FileCloud,\n\n /**\n * Drag File Mouse Icon\n */\n DragFile,\n\n /**\n *\n * Cancel icon\n */\n Cancel,\n\n /**\n *\n * Checkmark icon\n *\n */\n CheckMark,\n\n /**\n *\n * Radio icon\n *\n */\n Radio,\n\n /**\n *\n * Success icon\n */\n Success,\n\n /**\n *\n * Fail icon\n */\n Fail,\n\n /**\n *\n * account selection\n */\n SelectAccount,\n\n /**\n * News\n */\n News,\n\n /**\n * Bookmark\n */\n DoubleBookmark,\n\n /**\n * Left chevron\n */\n ChevronLeft,\n\n /**\n * Right chevron\n */\n ChevronRight,\n\n /**\n * Event\n */\n Event,\n\n /**\n * Q&A\n */\n BookOpen,\n\n /**\n * File outer icon\n */\n FileOuter,\n\n /**\n * Book question icon\n */\n BookQuestion,\n\n /**\n * Globe icon\n */\n Globe,\n /**\n * Delete icon\n */\n Delete,\n\n /**\n *\n * Add icon\n */\n Add,\n\n /**\n *\n * Calendar icon\n */\n Calendar,\n Planner,\n Milestone,\n PersonAdd,\n PresenceAvailable,\n PresenceOofAvailable,\n PresenceBusy,\n PresenceOofBusy,\n PresenceDnd,\n PresenceOofDnd,\n PresenceAway,\n PresenceOofAway,\n PresenceOffline,\n PresenceStatusUnknown\n}\n\nimport { html } from 'lit';\n\n/**\n * returns an svg\n *\n * @param svgIcon defined by name\n * @param color hex value\n */\nexport const getSvg = (svgIcon: SvgIcon, color?: string) => {\n switch (svgIcon) {\n case SvgIcon.ArrowDown:\n return html`\n \n `;\n\n case SvgIcon.TeamSeparator:\n return html`\n \n `;\n\n case SvgIcon.Search:\n return html`\n `;\n\n case SvgIcon.SkypeArrow:\n return html`\n \n `;\n\n case SvgIcon.SmallEmail:\n return html`\n \n `;\n\n case SvgIcon.SmallChat:\n return html`\n \n `;\n\n case SvgIcon.Video:\n return html`\n \n `;\n\n case SvgIcon.ExpandDown: {\n return html`\n \n `;\n }\n\n case SvgIcon.Overview:\n return html`\n \n `;\n\n case SvgIcon.Send:\n return html`\n \n `;\n\n case SvgIcon.Contact:\n return html`\n \n `;\n\n case SvgIcon.Call:\n return html`\n \n `;\n\n case SvgIcon.Confirmation:\n return html`\n \n `;\n\n case SvgIcon.Copy:\n return html`\n \n `;\n\n case SvgIcon.Phone:\n return html`\n \n `;\n\n case SvgIcon.CellPhone:\n return html`\n \n `;\n\n case SvgIcon.Chat:\n return html`\n \n `;\n\n case SvgIcon.Department:\n return html`\n \n `;\n\n case SvgIcon.Dot:\n return html`\n \n `;\n\n case SvgIcon.Email:\n return html`\n \n `;\n\n case SvgIcon.OfficeLocation:\n return html`\n \n `;\n\n case SvgIcon.Birthday:\n return html`\n \n `;\n\n case SvgIcon.Person:\n return html`\n \n `;\n\n case SvgIcon.Messages:\n return html`\n \n `;\n\n case SvgIcon.Organization:\n return html`\n \n `;\n\n case SvgIcon.ExpandRight:\n return html`\n \n `;\n\n case SvgIcon.Profile:\n return html`\n \n `;\n\n case SvgIcon.File:\n return html`\n \n `;\n\n case SvgIcon.Files:\n return html`\n \n `;\n\n case SvgIcon.Back:\n return html`\n \n `;\n\n case SvgIcon.Close:\n return html`\n \n `;\n case SvgIcon.Upload:\n return html`\n \n `;\n\n case SvgIcon.FileCloud:\n return html`\n \n `;\n\n case SvgIcon.DragFile:\n return html`\n \n `;\n\n case SvgIcon.Cancel:\n return html`\n \n `;\n\n case SvgIcon.Success:\n return html`\n \n `;\n\n case SvgIcon.CheckMark:\n return html`\n \n `;\n\n case SvgIcon.Radio:\n return html`\n \n `;\n\n case SvgIcon.Fail:\n return html`\n \n `;\n\n case SvgIcon.SelectAccount:\n return html`\n \n `;\n\n case SvgIcon.News:\n return html`\n \n `;\n\n case SvgIcon.DoubleBookmark:\n return html`\n \n `;\n\n case SvgIcon.ChevronLeft:\n return html`\n `;\n\n case SvgIcon.ChevronRight:\n return html`\n `;\n\n case SvgIcon.Delete:\n return html`\n \n `;\n\n case SvgIcon.Add:\n return html`\n `;\n\n case SvgIcon.Calendar:\n return html`\n \n `;\n\n case SvgIcon.Planner:\n return html`\n `;\n\n case SvgIcon.Milestone:\n return html`\n `;\n\n case SvgIcon.PersonAdd:\n return html`\n `;\n case SvgIcon.Event:\n return html`\n \n `;\n\n case SvgIcon.BookOpen:\n return html`\n \n `;\n\n case SvgIcon.FileOuter:\n return html`\n \n `;\n\n case SvgIcon.BookQuestion:\n return html`\n \n `;\n\n case SvgIcon.Globe:\n return html`\n \n `;\n\n case SvgIcon.PresenceAvailable:\n return html`\n `;\n\n case SvgIcon.PresenceOofAvailable:\n return html`\n `;\n\n case SvgIcon.PresenceBusy:\n return html`\n `;\n\n case SvgIcon.PresenceOofBusy:\n return html`\n \n `;\n\n case SvgIcon.PresenceDnd:\n return html`\n `;\n\n case SvgIcon.PresenceOofDnd:\n return html`\n `;\n\n case SvgIcon.PresenceAway:\n return html`\n `;\n\n case SvgIcon.PresenceOofAway:\n return html`\n `;\n\n case SvgIcon.PresenceOffline:\n return html`\n `;\n\n case SvgIcon.PresenceStatusUnknown:\n return html`\n `;\n }\n};\n","/**\n * -------------------------------------------------------------------------------------------\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\n * See License in the project root for license information.\n * -------------------------------------------------------------------------------------------\n */\n\nimport { CacheService } from '@microsoft/mgt-element';\n\nexport const getRelativeDisplayDate = (date: Date): string => {\n const now = new Date();\n\n // Today -> 5:23 PM\n const today = new Date(now.getFullYear(), now.getMonth(), now.getDate());\n if (date >= today) {\n return date.toLocaleString('default', {\n hour: 'numeric',\n minute: 'numeric'\n });\n }\n\n // This week -> Sun 3:04 PM\n const sunday = new Date(today);\n sunday.setDate(now.getDate() - now.getDay());\n if (date >= sunday) {\n return date.toLocaleString('default', {\n hour: 'numeric',\n minute: 'numeric',\n weekday: 'short'\n });\n }\n\n // Last two week -> Sun 8/2\n const lastTwoWeeks = new Date(sunday);\n lastTwoWeeks.setDate(sunday.getDate() - 7);\n if (date >= lastTwoWeeks) {\n return date.toLocaleString('default', {\n day: 'numeric',\n month: 'numeric',\n weekday: 'short'\n });\n }\n\n // More than two weeks ago -> 8/1/2020\n return date.toLocaleString('default', {\n day: 'numeric',\n month: 'numeric',\n year: 'numeric'\n });\n};\n\n/**\n * returns day, month and year\n *\n * @export\n * @param {Date} date\n * @returns\n */\nexport const getDateString = (date: Date) => {\n const month = date.getMonth();\n const day = date.getDate();\n const year = date.getFullYear();\n\n return `${day} / ${month} / ${year}`;\n};\n\n/**\n * returns month and day\n *\n * @export\n * @param {Date} date\n * @returns\n */\nexport const getShortDateString = (date: Date) => {\n const month = date.getMonth();\n const day = date.getDate();\n\n return `${getMonthString(month)} ${day}`;\n};\n\n/**\n * returns month string based on number\n *\n * @export\n * @param {number} month\n * @returns {string}\n */\nexport const getMonthString = (month: number): string => {\n switch (month) {\n case 0:\n return 'January';\n case 1:\n return 'February';\n case 2:\n return 'March';\n case 3:\n return 'April';\n case 4:\n return 'May';\n case 5:\n return 'June';\n case 6:\n return 'July';\n case 7:\n return 'August';\n case 8:\n return 'September';\n case 9:\n return 'October';\n case 10:\n return 'November';\n case 11:\n return 'December';\n default:\n return 'Month';\n }\n};\n\n/**\n * returns day of week string based on number\n * where 0 === Sunday\n *\n * @export\n * @param {number} day\n * @returns {string}\n */\nexport const getDayOfWeekString = (day: number): string => {\n switch (day) {\n case 0:\n return 'Sunday';\n case 1:\n return 'Monday';\n case 2:\n return 'Tuesday';\n case 3:\n return 'Wednesday';\n case 4:\n return 'Thursday';\n case 5:\n return 'Friday';\n case 6:\n return 'Saturday';\n default:\n return 'Day';\n }\n};\n\n/**\n * retrieve the days in the month provided by number\n *\n * @export\n * @param {number} monthNum\n * @returns {number}\n */\nexport const getDaysInMonth = (monthNum: number): number => {\n switch (monthNum) {\n case 1:\n return 28;\n\n case 3:\n case 5:\n case 8:\n case 10:\n default:\n return 30;\n\n case 0:\n case 2:\n case 4:\n case 6:\n case 7:\n case 9:\n case 11:\n return 31;\n }\n};\n\n/**\n * returns serialized date from month number and year number\n *\n * @export\n * @param {number} month\n * @param {number} year\n * @returns\n */\nexport const getDateFromMonthYear = (month: number, year: number) => {\n const yearStr = `${year}`;\n\n let monthStr = `${month}`;\n if (monthStr.length < 2) {\n monthStr = '0' + monthStr;\n }\n\n return new Date(`${yearStr}-${monthStr}-1T12:00:00-${new Date().getTimezoneOffset() / 60}`);\n};\n\n/**\n * ensures one call at a time\n *\n * @export\n * @param {*} func\n * @param {*} time\n * @returns\n */\n// eslint-disable-next-line @typescript-eslint/ban-types\nexport const debounce = (func: Function, time: number) => {\n let timeout: number;\n\n return function () {\n // eslint-disable-next-line @typescript-eslint/no-unsafe-return, prefer-rest-params\n const functionCall = () => func.apply(this, arguments);\n\n window.clearTimeout(timeout);\n timeout = window.setTimeout(functionCall, time);\n };\n};\n\n/**\n * converts a blob to base64 encoding\n *\n * @param {Blob} blob\n * @returns {Promise}\n */\nexport const blobToBase64 = (blob: Blob): Promise => {\n return new Promise((resolve, reject) => {\n const reader = new FileReader();\n reader.onerror = reject;\n reader.onload = () => {\n resolve(reader.result as string);\n };\n reader.readAsDataURL(blob);\n });\n};\n\n/**\n * extracts an email address from a string\n *\n * @param {string} emailString\n * @returns {string}\n */\nexport const extractEmailAddress = (emailString: string): string => {\n if (emailString.startsWith('[')) {\n return emailString.match(/([a-zA-Z0-9+._-]+@[a-zA-Z0-9._-]+\\.[a-zA-Z0-9_-]+)/gi).toString();\n } else return emailString;\n};\n\n/**\n * checks if the email string is a valid email\n *\n * @param {string} emailString\n * @returns {boolean}\n */\nexport const isValidEmail = (emailString: string): boolean => {\n const emailRx =\n /^(([^<>()[\\]\\\\.,;:\\s@\"]+(\\.[^<>()[\\]\\\\.,;:\\s@\"]+)*)|(\".+\"))@((\\[[0-9]{1,3}\\.[0-9]{1,3}\\.[0-9]{1,3}\\.[0-9]{1,3}])|(([a-zA-Z\\-0-9]+\\.)+[a-zA-Z]{2,}))$/;\n return emailRx.test(emailString);\n};\n\n/**\n * Convert bytes to human readable.\n *\n * @param bytes\n * @param decimals\n * @returns\n */\nexport const formatBytes = (bytes: number, decimals = 2) => {\n if (bytes === 0) return '0 Bytes';\n const k = 1024;\n const dm = decimals < 0 ? 0 : decimals;\n const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'];\n const i = Math.floor(Math.log(bytes) / Math.log(k));\n\n return `${parseFloat((bytes / Math.pow(k, i)).toFixed(dm))} ${sizes[i]}`;\n};\n\n/**\n * Formats the a provided summary to valid html\n *\n * @param summary\n * @returns string\n */\nexport const sanitizeSummary = (summary: string) => {\n if (summary) {\n summary = summary?.replace(//gi, '...');\n summary = summary?.replace(//gi, '');\n summary = summary?.replace(/<\\/c0>/gi, '');\n }\n\n return summary;\n};\n\n/**\n * Trims the file extension from a file name\n *\n * @param fileName\n * @returns\n */\nexport const trimFileExtension = (fileName: string) => {\n return fileName?.replace(/\\.[^/.]+$/, '');\n};\n\n/**\n * Get the name of a piece of content from the url\n *\n * @param webUrl\n * @returns\n */\nexport const getNameFromUrl = (webUrl: string) => {\n const url = new URL(webUrl);\n const name = url.pathname.split('/').pop();\n return name.replace(/-/g, ' ');\n};\n\n/**\n * Defines the expiration time\n *\n * @param currentInvalidationPeriod\n * @returns number\n */\nexport const getResponseInvalidationTime = (currentInvalidationPeriod: number) => {\n return (\n currentInvalidationPeriod ||\n CacheService.config.response.invalidationPeriod ||\n CacheService.config.defaultInvalidationPeriod\n );\n};\n\n/**\n * Whether the response store is enabled\n *\n * @returns boolean\n */\nexport const getIsResponseCacheEnabled = () => {\n return CacheService.config.response.isEnabled && CacheService.config.isEnabled;\n};\n","/**\n * -------------------------------------------------------------------------------------------\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\n * See License in the project root for license information.\n * -------------------------------------------------------------------------------------------\n */\n\nimport { Client, GraphRequest } from '@microsoft/microsoft-graph-client';\nimport { IBatch } from './IBatch';\n\n/**\n * The common functions of the Graph\n *\n * @export\n * @interface IGraph\n */\nexport interface IGraph {\n /**\n * the internal client used to make graph calls\n *\n * @type {Client}\n * @memberof IGraph\n */\n readonly client: Client;\n\n /**\n * the component name appended to Graph request headers\n *\n * @type {string}\n * @memberof IGraph\n */\n readonly componentName: string;\n\n /**\n * the version of the graph to query\n *\n * @type {string}\n * @memberof IGraph\n */\n readonly version: string;\n\n /**\n * returns a new instance of the Graph using the same\n * client within the context of the provider.\n *\n * @param {Element} component\n * @returns {IGraph}\n * @memberof IGraph\n */\n forComponent(component: Element): IGraph;\n\n /**\n * use this method to make calls directly to the Graph.\n *\n * @param {string} path\n * @returns {GraphRequest}\n * @memberof IGraph\n */\n api(path: string): GraphRequest;\n\n /**\n * creates a new batch request\n *\n * @returns {Batch}\n * @memberof IGraph\n */\n createBatch(): IBatch;\n}\n\n/**\n * GraphEndpoint is a valid URL that is used to access the Graph.\n */\nexport type GraphEndpoint =\n | 'https://graph.microsoft.com'\n | 'https://graph.microsoft.us'\n | 'https://dod-graph.microsoft.us'\n | 'https://graph.microsoft.de'\n | 'https://microsoftgraph.chinacloudapi.cn'\n | 'https://canary.graph.microsoft.com';\n\n/**\n * MICROSOFT_GRAPH_DEFAULT_ENDPOINT is the default Graph endpoint that is silently set on\n * the providers as the baseURL.\n */\nexport const MICROSOFT_GRAPH_DEFAULT_ENDPOINT: GraphEndpoint = 'https://graph.microsoft.com';\n\n/**\n * MICROSOFT_GRAPH_ENDPOINTS is a set of all the valid Graph URL endpoints.\n */\nexport const MICROSOFT_GRAPH_ENDPOINTS: Set = new Set([\n MICROSOFT_GRAPH_DEFAULT_ENDPOINT,\n 'https://graph.microsoft.us',\n 'https://dod-graph.microsoft.us',\n 'https://graph.microsoft.de',\n 'https://microsoftgraph.chinacloudapi.cn',\n 'https://canary.graph.microsoft.com'\n]);\n","/**\n * -------------------------------------------------------------------------------------------\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\n * See License in the project root for license information.\n * -------------------------------------------------------------------------------------------\n */\n\nimport { LitElement, PropertyValueMap, PropertyValues } from 'lit';\nimport { state } from 'lit/decorators.js';\nimport { ProviderState } from '../providers/IProvider';\nimport { Providers } from '../providers/Providers';\nimport { LocalizationHelper } from '../utils/LocalizationHelper';\nimport { PACKAGE_VERSION } from '../utils/version';\n\n/**\n * Defines media query based on component width\n *\n * @export\n * @enum {string}\n */\nexport enum ComponentMediaQuery {\n /**\n * devices with width < 768\n */\n mobile = '',\n\n /**\n * devices with width < 1200\n */\n tablet = 'tablet',\n\n /**\n * devices with width > 1200\n */\n desktop = 'desktop'\n}\n\n/**\n * BaseComponent extends LitElement adding mgt specific features to all components\n *\n * @export MgtBaseComponent\n * @abstract\n * @class MgtBaseComponent\n * @extends {LitElement}\n * @deprecated Use MgtBaseTaskComponent instead\n */\nexport abstract class MgtBaseComponent extends LitElement {\n @state()\n protected providerState: ProviderState = ProviderState.Loading;\n /**\n * Exposes the semver of the library the component is part of\n *\n * @readonly\n * @static\n * @memberof MgtBaseComponent\n */\n public static get packageVersion() {\n return PACKAGE_VERSION;\n }\n\n /**\n * Gets or sets the direction of the component\n *\n * @protected\n * @memberof MgtBaseComponent\n */\n @state() protected direction: 'ltr' | 'rtl' | 'auto' = 'ltr';\n\n /**\n * Gets the ComponentMediaQuery of the component\n *\n * @readonly\n * @type {MgtElement.ComponentMediaQuery}\n * @memberof MgtBaseComponent\n */\n public get mediaQuery(): ComponentMediaQuery {\n if (this.offsetWidth < 768) {\n return ComponentMediaQuery.mobile;\n } else if (this.offsetWidth < 1200) {\n return ComponentMediaQuery.tablet;\n } else {\n return ComponentMediaQuery.desktop;\n }\n }\n\n /**\n * A flag to check if the component is loading data state.\n *\n * @protected\n * @memberof MgtBaseComponent\n */\n protected get isLoadingState(): boolean {\n return this._isLoadingState;\n }\n\n /**\n * A flag to check if the component has updated once.\n *\n * @readonly\n * @protected\n * @type {boolean}\n * @memberof MgtBaseComponent\n */\n protected get isFirstUpdated(): boolean {\n return this._isFirstUpdated;\n }\n\n /**\n * returns component strings\n *\n * @readonly\n * @protected\n * @memberof MgtBaseComponent\n */\n protected get strings(): Record {\n return {};\n }\n\n /**\n * determines if login component is in loading state\n *\n * @type {boolean}\n */\n private _isLoadingState = false;\n\n private _isFirstUpdated = false;\n private _currentLoadStatePromise: Promise;\n\n constructor() {\n super();\n this.handleDirectionChanged();\n this.handleLocalizationChanged();\n }\n\n /**\n * Invoked each time the custom element is appended into a document-connected element\n *\n * @memberof MgtBaseComponent\n */\n public connectedCallback() {\n super.connectedCallback();\n LocalizationHelper.onStringsUpdated(this.handleLocalizationChanged);\n LocalizationHelper.onDirectionUpdated(this.handleDirectionChanged);\n }\n\n /**\n * Invoked each time the custom element is removed from a document-connected element\n *\n * @memberof MgtBaseComponent\n */\n public disconnectedCallback() {\n super.disconnectedCallback();\n LocalizationHelper.removeOnStringsUpdated(this.handleLocalizationChanged);\n LocalizationHelper.removeOnDirectionUpdated(this.handleDirectionChanged);\n Providers.removeProviderUpdatedListener(this.handleProviderUpdates);\n Providers.removeActiveAccountChangedListener(this.handleActiveAccountUpdates);\n }\n\n /**\n * Invoked when the element is first updated. Implement to perform one time\n * work on the element after update.\n *\n * Setting properties inside this method will trigger the element to update\n * again after this update cycle completes.\n *\n * @param _changedProperties Map of changed properties with old values\n */\n protected firstUpdated(changedProperties: PropertyValueMap | Map): void {\n super.firstUpdated(changedProperties);\n this._isFirstUpdated = true;\n Providers.onProviderUpdated(this.handleProviderUpdates);\n Providers.onActiveAccountChanged(this.handleActiveAccountUpdates);\n void this.requestStateUpdate();\n }\n\n /**\n * load state into the component.\n * Override this function to provide additional loading logic.\n */\n protected loadState(): Promise {\n return Promise.resolve();\n }\n\n /**\n * Used to clear state in inherited components\n */\n protected clearState(): void {\n // no-op\n }\n\n /**\n * helps facilitate creation of events across components\n *\n * @protected\n * @param {string} eventName\n * @param {*} [detail]\n * @param {boolean} [bubbles=false]\n * @param {boolean} [cancelable=false]\n * @param {boolean} [composed=false]\n * @return {*} {boolean}\n * @memberof MgtBaseComponent\n */\n protected fireCustomEvent(\n eventName: string,\n detail?: unknown,\n bubbles = false,\n cancelable = false,\n composed = false\n ): boolean {\n const event = new CustomEvent(eventName, {\n bubbles,\n cancelable,\n composed,\n // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n detail\n });\n return this.dispatchEvent(event);\n }\n\n /**\n * Invoked whenever the element is updated. Implement to perform\n * post-updating tasks via DOM APIs, for example, focusing an element.\n *\n * Setting properties inside this method will trigger the element to update\n * again after this update cycle completes.\n *\n * * @param changedProperties Map of changed properties with old values\n */\n protected updated(changedProperties: PropertyValues) {\n super.updated(changedProperties);\n const event = new CustomEvent('updated', {\n bubbles: true,\n cancelable: true\n });\n this.dispatchEvent(event);\n }\n\n /**\n * Request to reload the state.\n * Use reload instead of load to ensure loading events are fired.\n *\n * @protected\n * @memberof MgtBaseComponent\n */\n protected async requestStateUpdate(force = false): Promise {\n // the component is still bootstraping - wait until first updated\n if (!this._isFirstUpdated) {\n return;\n }\n\n // Wait for the current load promise to complete (unless forced).\n if (this.isLoadingState && !force) {\n await this._currentLoadStatePromise;\n }\n\n const provider = Providers.globalProvider;\n\n if (!provider) {\n return Promise.resolve();\n }\n\n if (provider.state === ProviderState.SignedOut) {\n // Signed out, clear the component state\n this.clearState();\n return;\n } else if (provider.state === ProviderState.Loading) {\n // The provider state is indeterminate. Do nothing.\n return Promise.resolve();\n } else {\n // Signed in, load the internal component state\n // eslint-disable-next-line @typescript-eslint/no-misused-promises, no-async-promise-executor\n const loadStatePromise = new Promise(async (resolve, reject) => {\n try {\n this.setLoadingState(true);\n this.fireCustomEvent('loadingInitiated');\n\n await this.loadState();\n\n this.setLoadingState(false);\n this.fireCustomEvent('loadingCompleted');\n resolve();\n } catch (e) {\n // Loading failed. Clear any partially set data.\n this.clearState();\n\n this.setLoadingState(false);\n this.fireCustomEvent('loadingFailed');\n reject(e);\n }\n\n // Return the load state promise.\n // If loading + forced, chain the promises.\n // This is to account for the lack of a cancellation token concept.\n // eslint-disable-next-line @typescript-eslint/no-unsafe-return, @typescript-eslint/no-unsafe-assignment\n return (this._currentLoadStatePromise =\n // eslint-disable-next-line @typescript-eslint/no-misused-promises\n this.isLoadingState && !!this._currentLoadStatePromise && force\n ? // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n this._currentLoadStatePromise.then(() => loadStatePromise)\n : loadStatePromise);\n });\n }\n }\n\n protected setLoadingState = (value: boolean) => {\n if (this._isLoadingState === value) {\n return;\n }\n\n this._isLoadingState = value;\n this.requestUpdate('isLoadingState');\n };\n\n private readonly handleProviderUpdates = () => {\n this.providerState = Providers.globalProvider?.state ?? ProviderState.Loading;\n void this.requestStateUpdate();\n };\n\n private readonly handleActiveAccountUpdates = () => {\n this.clearState();\n void this.requestStateUpdate();\n };\n\n private readonly handleLocalizationChanged = () => {\n LocalizationHelper.updateStringsForTag(this.tagName, this.strings);\n this.requestUpdate();\n };\n\n private readonly handleDirectionChanged = () => {\n this.direction = LocalizationHelper.getDocumentDirection();\n };\n}\n","/**\n * -------------------------------------------------------------------------------------------\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\n * See License in the project root for license information.\n * -------------------------------------------------------------------------------------------\n */\n\nimport { Task } from '@lit/task';\n\nimport { LitElement, PropertyValueMap, PropertyValues, TemplateResult, html } from 'lit';\nimport { state } from 'lit/decorators.js';\nimport { ProviderState } from '../providers/IProvider';\nimport { Providers } from '../providers/Providers';\nimport { LocalizationHelper } from '../utils/LocalizationHelper';\nimport { PACKAGE_VERSION } from '../utils/version';\nimport { ComponentMediaQuery } from './baseComponent';\n\n/**\n * BaseComponent extends LitElement adding mgt specific features to all components\n *\n * @export MgtBaseTaskComponent\n * @abstract\n * @class MgtBaseTaskComponent\n * @extends {LitElement}\n */\nexport abstract class MgtBaseTaskComponent extends LitElement {\n /**\n * Supplies the component with a reactive property based on the current provider state\n *\n * @protected\n * @memberof MgtBaseTaskComponent\n */\n @state() protected providerState: ProviderState = ProviderState.Loading;\n /**\n * Exposes the semver of the library the component is part of\n *\n * @readonly\n * @static\n * @memberof MgtBaseTaskComponent\n */\n public static get packageVersion() {\n return PACKAGE_VERSION;\n }\n\n /**\n * Gets or sets the direction of the component\n *\n * @protected\n * @memberof MgtBaseTaskComponent\n */\n @state() protected direction: 'ltr' | 'rtl' | 'auto' = 'ltr';\n\n /**\n * Gets the ComponentMediaQuery of the component\n *\n * @readonly\n * @type {MgtElement.ComponentMediaQuery}\n * @memberof MgtBaseTaskComponent\n */\n public get mediaQuery(): ComponentMediaQuery {\n if (this.offsetWidth < 768) {\n return ComponentMediaQuery.mobile;\n } else if (this.offsetWidth < 1200) {\n return ComponentMediaQuery.tablet;\n } else {\n return ComponentMediaQuery.desktop;\n }\n }\n\n /**\n * A flag to check if the component has updated once.\n *\n * @readonly\n * @protected\n * @type {boolean}\n * @memberof MgtBaseTaskComponent\n */\n protected get isFirstUpdated(): boolean {\n return this._isFirstUpdated;\n }\n\n /**\n * returns component strings\n *\n * @readonly\n * @protected\n * @memberof MgtBaseTaskComponent\n */\n protected get strings(): Record {\n return {};\n }\n\n private _isFirstUpdated = false;\n\n constructor() {\n super();\n this.handleDirectionChanged();\n this.handleLocalizationChanged();\n }\n\n /**\n * Invoked each time the custom element is appended into a document-connected element\n *\n * @memberof MgtBaseTaskComponent\n */\n public connectedCallback() {\n super.connectedCallback();\n LocalizationHelper.onStringsUpdated(this.handleLocalizationChanged);\n LocalizationHelper.onDirectionUpdated(this.handleDirectionChanged);\n }\n\n /**\n * Invoked each time the custom element is removed from a document-connected element\n *\n * @memberof MgtBaseTaskComponent\n */\n public disconnectedCallback() {\n super.disconnectedCallback();\n LocalizationHelper.removeOnStringsUpdated(this.handleLocalizationChanged);\n LocalizationHelper.removeOnDirectionUpdated(this.handleDirectionChanged);\n Providers.removeProviderUpdatedListener(this.handleProviderUpdates);\n Providers.removeActiveAccountChangedListener(this.handleActiveAccountUpdates);\n }\n\n /**\n * Invoked when the element is first updated. Implement to perform one time\n * work on the element after update.\n *\n * Setting properties inside this method will trigger the element to update\n * again after this update cycle completes.\n *\n * @param _changedProperties Map of changed properties with old values\n */\n protected firstUpdated(changedProperties: PropertyValueMap | Map): void {\n super.firstUpdated(changedProperties);\n this._isFirstUpdated = true;\n Providers.onProviderUpdated(this.handleProviderUpdates);\n Providers.onActiveAccountChanged(this.handleActiveAccountUpdates);\n }\n\n /**\n * Used to clear state in inherited components\n */\n protected clearState(): void {\n // no-op\n }\n\n /**\n * helps facilitate creation of events across components\n *\n * @protected\n * @param {string} eventName\n * @param {*} [detail]\n * @param {boolean} [bubbles=false]\n * @param {boolean} [cancelable=false]\n * @param {boolean} [composed=false]\n * @return {*} {boolean}\n * @memberof MgtBaseTaskComponent\n */\n protected fireCustomEvent(\n eventName: string,\n detail?: unknown,\n bubbles = false,\n cancelable = false,\n composed = false\n ): boolean {\n const event = new CustomEvent(eventName, {\n bubbles,\n cancelable,\n composed,\n detail\n });\n return this.dispatchEvent(event);\n }\n\n /**\n * Invoked whenever the element is updated. Implement to perform\n * post-updating tasks via DOM APIs, for example, focusing an element.\n *\n * Setting properties inside this method will trigger the element to update\n * again after this update cycle completes.\n *\n * * @param changedProperties Map of changed properties with old values\n */\n protected updated(changedProperties: PropertyValues) {\n super.updated(changedProperties);\n this.fireCustomEvent('updated', undefined, true, false);\n }\n\n /**\n * load state into the component.\n * Override this function to provide actual loading logic.\n */\n protected async loadState() {\n return Promise.resolve();\n }\n\n /**\n * Override this function to provide the actual list of properties to trigger the task to run.\n * The default implementation returns an array with the providerState.\n * @returns {unknown[]} the properties when changed which trigger the Task to run\n */\n protected args(): unknown[] {\n return [this.providerState];\n }\n\n /**\n * Task that is run whenever one of the args changes\n * By default this task will call loadState\n */\n protected _task = new Task(this, {\n task: () => this.loadState(),\n args: () => this.args()\n });\n\n /**\n * Invoked on each update to perform rendering tasks. This method must return\n * a lit-html TemplateResult. Setting properties inside this method will *not*\n * trigger the element to update.\n */\n protected render() {\n return this._task.render({\n pending: this.renderLoading,\n complete: this.renderContent,\n error: this.renderError\n });\n }\n\n /**\n * A default loading template.\n * @returns default loading template\n */\n protected renderLoading = (): TemplateResult => {\n return html`Loading...`;\n };\n\n protected renderError = (e: unknown): TemplateResult => {\n return html`
Error: ${e}
`;\n };\n\n protected renderContent = (): TemplateResult => {\n return html``;\n };\n\n private readonly handleProviderUpdates = () => {\n this.providerState = Providers.globalProvider?.state ?? ProviderState.Loading;\n };\n\n private readonly handleActiveAccountUpdates = () => {\n this.clearState();\n };\n\n private readonly handleLocalizationChanged = () => {\n LocalizationHelper.updateStringsForTag(this.tagName, this.strings);\n this.requestUpdate();\n };\n\n private readonly handleDirectionChanged = () => {\n this.direction = LocalizationHelper.getDocumentDirection();\n };\n}\n","/**\n * -------------------------------------------------------------------------------------------\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\n * See License in the project root for license information.\n * -------------------------------------------------------------------------------------------\n */\n\nclass CustomElementHelper {\n private get defaultPrefix() {\n return 'mgt';\n }\n private _disambiguation = '';\n\n /**\n * Adds a disambiguation segment to the custom elements registered with the browser\n *\n * @param {string} disambiguation the disambiguation value to be used, should be lowercase\n * @return {CustomElementHelper} the current object\n * @memberof CustomElementHelper\n */\n public withDisambiguation(disambiguation: string) {\n if (disambiguation && !this._disambiguation) {\n this._disambiguation = disambiguation.toLowerCase();\n if (disambiguation !== this._disambiguation)\n console.warn(\n `🦒: Disambiguation value, ${disambiguation}, should be lowercase. Value has been converted to lowercase, ${this._disambiguation}.`\n );\n }\n return this;\n }\n\n /**\n * Provides the prefix to be used for mgt web component tags\n *\n * @readonly\n * @type {string}\n * @memberof CustomElementHelper\n */\n public get prefix(): string {\n return this._disambiguation ? `${this.defaultPrefix}-${this._disambiguation}` : this.defaultPrefix;\n }\n\n /**\n * Returns the current value for the disambiguation\n *\n * @readonly\n * @type {string}\n * @memberof CustomElementHelper\n */\n public get disambiguation(): string {\n return this._disambiguation;\n }\n\n /**\n * Returns true if a value has been provided for the disambiguation\n *\n * @readonly\n * @type {boolean}\n * @memberof CustomElementHelper\n */\n public get isDisambiguated(): boolean {\n return Boolean(this._disambiguation);\n }\n\n /**\n * Removes disambiguation from the provided tagName.\n * Intended for use when providing tag names in analytics headers passed by the Graph client\n *\n * @param {string} tagName\n * @return {*} {string}\n * @memberof CustomElementHelper\n */\n public normalize(tagName: string): string {\n return this.isDisambiguated\n ? tagName.toUpperCase().replace(this.prefix.toUpperCase(), this.defaultPrefix.toUpperCase())\n : tagName;\n }\n}\n\n/**\n * Helper object to provide the desired prefix for mgt web component tags\n *\n * @type CustomElementHelper\n */\nconst customElementHelper = new CustomElementHelper();\nexport { customElementHelper };\n","/**\n * -------------------------------------------------------------------------------------------\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\n * See License in the project root for license information.\n * -------------------------------------------------------------------------------------------\n */\n\n/**\n * Crude implementation of equivalence between the two specified arguments.\n *\n * The primary intent of this function is for comparing data contexts, which\n * are expected to be object literals with potentially nested structures and\n * where leaf values are primitives.\n */\nexport const equals = (o1: unknown, o2: unknown) => {\n return equalsInternal(o1, o2, new Set());\n};\n\n/**\n * Not exposed as it would undesirably leak implementation detail (`refs` argument).\n *\n * The `refs` argument is used to avoid infinite recursion due to circular references.\n *\n * @see equals\n */\nconst equalsInternal = (o1: unknown, o2: unknown, refs: Set) => {\n const o1Label = Object.prototype.toString.call(o1) as string;\n const o2Label = Object.prototype.toString.call(o2) as string;\n if (\n typeof o1 === 'object' &&\n typeof o2 === 'object' &&\n o1Label === o2Label &&\n o1Label === '[object Object]' &&\n !refs.has(o1)\n ) {\n refs.add(o1);\n for (const k in o1) {\n // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access\n if (!equalsInternal(o1[k], o2[k], refs)) {\n return false;\n }\n }\n for (const k in o2) {\n if (!Object.prototype.hasOwnProperty.call(o1, k)) {\n return false;\n }\n }\n return true;\n }\n if (Array.isArray(o1) && Array.isArray(o2) && !refs.has(o1)) {\n refs.add(o1);\n if (o1.length !== o2.length) {\n return false;\n }\n for (let i = 0; i < o1.length; i++) {\n if (!equalsInternal(o1[i], o2[i], refs)) {\n return false;\n }\n }\n return true;\n }\n // Everything else requires strict equality (e.g. primitives, functions, dates)\n return o1 === o2;\n};\n\n/**\n * Compares two arrays if the elements are equals\n * Should be used for arrays of primitive types\n *\n * @export\n * @template T the type of the elements in the array (should be primitive)\n * @param {T[]} arr1\n * @param {T[]} arr2\n * @returns true if both arrays contain the same items or if both arrays are null or empty\n */\nexport const arraysAreEqual = (arr1: T[], arr2: T[]) => {\n if (arr1 === arr2) {\n return true;\n }\n\n if (!arr1 || !arr2) {\n return false;\n }\n\n if (arr1.length !== arr2.length) {\n return false;\n }\n\n if (arr1.length === 0) {\n return true;\n }\n\n const setArr1 = new Set(arr1);\n\n for (const i of arr2) {\n if (!setArr1.has(i)) {\n return false;\n }\n }\n\n return true;\n};\n","/**\n * -------------------------------------------------------------------------------------------\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\n * See License in the project root for license information.\n * -------------------------------------------------------------------------------------------\n */\n\ntype ContextualTemplateElement = HTMLTemplateElement & {\n /**\n * The data context of the parent template\n */\n $parentTemplateContext?: object;\n};\n\n/**\n * Helper class for Template Instantiation\n *\n * @export\n * @class TemplateHelper\n */\nexport class TemplateHelper {\n /**\n * Render a template into a HTMLElement with the appropriate data context\n *\n * Ex:\n * ```\n * \n *
{{myObj.someStr}}
\n *
\n *
{{key.anotherStr}}
\n *
\n * \n * ```\n *\n * @param root the root element to parent the rendered content\n * @param template the template to render\n * @param context the data context to be applied\n */\n public static renderTemplate(root: HTMLElement, template: ContextualTemplateElement, context: object) {\n // inherit context from parent template\n if (template.$parentTemplateContext) {\n context = { ...context, $parent: template.$parentTemplateContext };\n }\n\n let rendered: Node;\n\n if (template.content?.childNodes.length) {\n const templateContent = template.content.cloneNode(true);\n rendered = this.renderNode(templateContent, root, context);\n } else if (template.childNodes.length) {\n const div = document.createElement('div');\n\n for (const node of template.childNodes) {\n div.appendChild(this.simpleCloneNode(node));\n }\n rendered = this.renderNode(div, root, context);\n }\n\n if (rendered) {\n root.appendChild(rendered);\n }\n }\n\n /**\n * Set an alternative binding syntax. Default is {{ }}\n *\n * @static\n * @param {string} startStr start of binding syntax\n * @param {string} endStr end of binding syntax\n * @memberof TemplateHelper\n */\n public static setBindingSyntax(startStr: string, endStr: string) {\n this._startExpression = startStr;\n this._endExpression = endStr;\n\n const start = this.escapeRegex(this._startExpression);\n const end = this.escapeRegex(this._endExpression);\n\n this._expression = new RegExp(`${start}\\\\s*([$\\\\w\\\\.,'\"\\\\s()\\\\[\\\\]]+)\\\\s*${end}`, 'g');\n }\n\n /**\n * Global context containing data or functions available to\n * all templates for binding\n *\n * @readonly\n * @static\n * @memberof TemplateHelper\n */\n public static get globalContext() {\n return this._globalContext;\n }\n\n private static readonly _globalContext = {};\n\n private static get expression() {\n if (!this._expression) {\n this.setBindingSyntax('{{', '}}');\n }\n\n return this._expression;\n }\n\n private static _startExpression: string;\n private static _endExpression: string;\n private static _expression: RegExp;\n\n private static escapeRegex(string: string) {\n return string.replace(/[-/\\\\^$*+?.()|[\\]{}]/g, '\\\\$&');\n }\n\n // simple implementation of deep cloneNode\n // required for nested templates in polyfilled browsers\n private static simpleCloneNode(node: ChildNode) {\n if (!node) {\n return null;\n }\n\n const clone = node.cloneNode(false);\n\n for (const child of node.childNodes) {\n const childClone = this.simpleCloneNode(child);\n if (childClone) {\n clone.appendChild(childClone);\n }\n }\n\n return clone;\n }\n\n private static expandExpressionsAsString(str: string, context: object) {\n return str.replace(this.expression, (match: string, p1: string) => {\n const value = this.evalInContext(p1 || this.trimExpression(match), context);\n if (value) {\n if (typeof value === 'object') {\n return JSON.stringify(value);\n } else {\n // eslint-disable-next-line @typescript-eslint/no-base-to-string\n return value.toString();\n }\n }\n return '';\n });\n }\n\n private static renderNode(node: Node, root: HTMLElement, context: object) {\n if (node.nodeName === '#text') {\n node.textContent = this.expandExpressionsAsString(node.textContent, context);\n return node;\n } else if (node.nodeName === 'TEMPLATE') {\n (node as ContextualTemplateElement).$parentTemplateContext = context;\n return node;\n }\n\n const nodeElement = node as HTMLElement;\n\n // replace attribute values\n if (nodeElement.attributes) {\n for (const attribute of nodeElement.attributes) {\n if (attribute.name === 'data-props') {\n const propsValue = this.trimExpression(attribute.value);\n for (const prop of propsValue.split(',')) {\n const keyValue = prop.trim().split(':');\n if (keyValue.length === 2) {\n const key = keyValue[0].trim();\n const value = this.evalInContext(keyValue[1].trim(), context);\n\n if (key.startsWith('@')) {\n // event\n if (typeof value === 'function') {\n // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n nodeElement.addEventListener(key.substring(1), e => value(e, context, root));\n }\n } else {\n nodeElement[key] = value;\n }\n }\n }\n } else {\n nodeElement.setAttribute(attribute.name, this.expandExpressionsAsString(attribute.value, context));\n }\n }\n }\n\n // don't process nodes that will loop yet, but\n // keep a reference of them\n const loopChildren: HTMLElement[] = [];\n\n // list of children to remove (ex, when data-if == false)\n const removeChildren = [];\n let previousChildWasIfAndTrue = false;\n\n for (const childNode of node.childNodes) {\n const childElement = childNode as HTMLElement;\n let previousChildWasIfAndTrueSet = false;\n\n if (childElement.dataset) {\n let childWillBeRemoved = false;\n\n if (childElement.dataset.if) {\n const expression = childElement.dataset.if;\n if (!this.evalBoolInContext(this.trimExpression(expression), context)) {\n removeChildren.push(childElement);\n childWillBeRemoved = true;\n } else {\n childElement.removeAttribute('data-if');\n previousChildWasIfAndTrue = true;\n previousChildWasIfAndTrueSet = true;\n }\n } else if (typeof childElement.dataset.else !== 'undefined') {\n if (previousChildWasIfAndTrue) {\n removeChildren.push(childElement);\n childWillBeRemoved = true;\n } else {\n childElement.removeAttribute('data-else');\n }\n }\n\n if (childElement.dataset.for && !childWillBeRemoved) {\n loopChildren.push(childElement);\n } else if (!childWillBeRemoved) {\n this.renderNode(childNode, root, context);\n }\n } else {\n this.renderNode(childNode, root, context);\n }\n\n // clear the flag if the current node wasn't data-if\n // or if it was data-if but it wasn't true\n if (!previousChildWasIfAndTrueSet && childNode.nodeName !== '#text') {\n previousChildWasIfAndTrue = false;\n }\n }\n\n // now handle nodes that need to be removed\n for (const child of removeChildren) {\n nodeElement.removeChild(child);\n }\n\n // now handle nodes that should loop\n for (const childElement of loopChildren) {\n const loopExpression = childElement.dataset.for;\n const loopTokens = this.trimExpression(loopExpression).split(/\\s(in|of)\\s/i);\n\n if (loopTokens.length === 3) {\n // don't really care what's in the middle at this point\n const itemName = loopTokens[0].trim();\n const listKey = loopTokens[2].trim();\n\n const list = this.evalInContext(listKey, context);\n if (Array.isArray(list)) {\n // first remove the child\n // we will need to make copy of the child for\n // each element in the list\n childElement.removeAttribute('data-for');\n\n for (let j = 0; j < list.length; j++) {\n const newContext = {\n $index: j,\n ...context\n };\n // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n newContext[itemName] = list[j];\n\n const clone = childElement.cloneNode(true);\n this.renderNode(clone, root, newContext);\n nodeElement.insertBefore(clone, childElement);\n }\n }\n nodeElement.removeChild(childElement);\n }\n }\n\n return node;\n }\n\n private static evalBoolInContext(expression: string, context: object): boolean {\n context = { ...context, ...this.globalContext };\n // eslint-disable-next-line @typescript-eslint/no-unsafe-return, @typescript-eslint/no-implied-eval\n return new Function('with(this) { return !!(' + expression + ')}').call(context);\n }\n\n private static evalInContext(expression: string, context: object): unknown {\n context = { ...context, ...this.globalContext };\n // eslint-disable-next-line @typescript-eslint/no-implied-eval\n const func = new Function('with(this) { return ' + expression + ';}');\n let result: unknown;\n try {\n result = func.call(context);\n } catch (e) {\n /* empty */\n }\n return result;\n }\n\n private static trimExpression(expression: string) {\n expression = expression.trim();\n\n if (expression.startsWith(this._startExpression) && expression.endsWith(this._endExpression)) {\n expression = expression.substr(\n this._startExpression.length,\n expression.length - this._startExpression.length - this._endExpression.length\n );\n expression = expression.trim();\n }\n\n return expression;\n }\n}\n","/**\n * -------------------------------------------------------------------------------------------\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\n * See License in the project root for license information.\n * -------------------------------------------------------------------------------------------\n */\n\nimport { property, state } from 'lit/decorators.js';\nimport { html, PropertyValueMap, PropertyValues, TemplateResult } from 'lit';\n\nimport { equals } from '../utils/equals';\nimport { TemplateContext } from '../utils/TemplateContext';\nimport { TemplateHelper } from '../utils/TemplateHelper';\nimport { MgtBaseTaskComponent } from './baseTaskComponent';\nimport { OrderedHtmlTemplate, RenderedTemplates, TemplateRenderedData } from './templatedComponent';\n\n/**\n * An abstract class that defines a templatable web component\n *\n * @export\n * @abstract\n * @class MgtTemplatedTaskComponent\n * @extends {MgtBaseTaskComponent}\n *\n * @fires {CustomEvent} templateRendered - fires when a template is rendered\n */\nexport abstract class MgtTemplatedTaskComponent extends MgtBaseTaskComponent {\n /**\n * Additional data context to be used in template binding\n * Use this to add event listeners or value converters\n *\n * @type {MgtElement.TemplateContext}\n * @memberof MgtTemplatedTaskComponent\n */\n @property({ attribute: false }) public templateContext: TemplateContext;\n\n /**\n *\n * Gets or sets the error (if any) of the request\n *\n * @type object\n * @memberof MgtSearchResults\n */\n @state() protected error: object;\n\n /**\n * Holds all templates defined by developer\n *\n * @protected\n * @memberof MgtTemplatedTaskComponent\n */\n protected templates: Record = {};\n\n private _renderedSlots = false;\n private _renderedTemplates: RenderedTemplates = {};\n private _slotNamesAddedDuringRender = [];\n\n constructor() {\n super();\n\n this.templateContext = this.templateContext || {};\n }\n\n /**\n * Render the loading state\n *\n * @protected\n * @returns {TemplateResult}\n * @memberof MgtFile\n */\n protected renderLoading = (): TemplateResult => {\n return this.renderTemplate('loading', null) || html``;\n };\n\n /**\n * Updates the element. This method reflects property values to attributes.\n * It can be overridden to render and keep updated element DOM.\n * Setting properties inside this method will *not* trigger\n * another update.\n *\n * * @param _changedProperties Map of changed properties with old values\n */\n protected update(changedProperties: PropertyValueMap | Map) {\n this.templates = this.getTemplates();\n this._slotNamesAddedDuringRender = [];\n super.update(changedProperties);\n }\n\n /**\n * Invoked whenever the element is updated. Implement to perform\n * post-updating tasks via DOM APIs, for example, focusing an element.\n *\n * Setting properties inside this method will trigger the element to update\n * again after this update cycle completes.\n *\n * * @param changedProperties Map of changed properties with old values\n */\n protected updated(changedProperties: PropertyValues) {\n super.updated(changedProperties);\n this.removeUnusedSlottedElements();\n }\n\n /**\n * Render a by type and return content to render\n *\n * @param templateType type of template (indicated by the data-type attribute)\n * @param context the data context that should be expanded in template\n * @param slotName the slot name that will be used to host the new rendered template. set to a unique value if multiple templates of this type will be rendered. default is templateType\n */\n protected renderTemplate(templateType: string, context: object, slotName?: string): TemplateResult {\n if (!this.hasTemplate(templateType)) {\n return null;\n }\n\n slotName = slotName || templateType;\n this._slotNamesAddedDuringRender.push(slotName);\n this._renderedSlots = true;\n\n const template = html`\n \n `;\n\n const dataContext = { ...context, ...this.templateContext };\n\n if (Object.prototype.hasOwnProperty.call(this._renderedTemplates, slotName)) {\n // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n const { context: existingContext, slot } = this._renderedTemplates[slotName];\n if (equals(existingContext, dataContext)) {\n return template;\n }\n this.removeChild(slot);\n }\n\n const div = document.createElement('div');\n div.slot = slotName;\n div.dataset.generated = 'template';\n\n TemplateHelper.renderTemplate(div, this.templates[templateType], dataContext);\n\n this.appendChild(div);\n\n this._renderedTemplates[slotName] = { context: dataContext, slot: div };\n\n const templateRenderedData: TemplateRenderedData = { templateType, context: dataContext, element: div };\n this.fireCustomEvent('templateRendered', templateRenderedData);\n\n return template;\n }\n\n /**\n * Check if a specific template has been provided.\n *\n * @protected\n * @param {string} templateName\n * @returns {boolean}\n * @memberof MgtTemplatedTaskComponent\n */\n protected hasTemplate(templateName: string): boolean {\n return Boolean(this.templates?.[templateName]);\n }\n\n private getTemplates() {\n const templates: Record = {};\n\n for (let i = 0; i < this.children.length; i++) {\n const child = this.children[i];\n if (child.nodeName === 'TEMPLATE') {\n const template = child as OrderedHtmlTemplate;\n if (template.dataset.type) {\n templates[template.dataset.type] = template;\n } else {\n templates.default = template;\n }\n\n template.templateOrder = i;\n }\n }\n\n return templates;\n }\n\n /**\n * Renders an error\n *\n * @returns\n */\n protected renderError = (e: unknown): TemplateResult => {\n if (this.hasTemplate('error')) {\n return this.renderTemplate('error', e as object);\n }\n\n return html`\n
\n ${e}\n
\n `;\n };\n\n private removeUnusedSlottedElements() {\n if (this._renderedSlots) {\n for (let i = 0; i < this.children.length; i++) {\n const child = this.children[i] as HTMLElement;\n if (child.dataset?.generated && !this._slotNamesAddedDuringRender.includes(child.slot)) {\n this.removeChild(child);\n delete this._renderedTemplates[child.slot];\n i--;\n }\n }\n this._renderedSlots = false;\n }\n }\n}\n","/**\n * -------------------------------------------------------------------------------------------\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\n * See License in the project root for license information.\n * -------------------------------------------------------------------------------------------\n */\n\nimport { AuthenticationProvider, AuthenticationProviderOptions } from '@microsoft/microsoft-graph-client';\nimport { validateBaseURL } from '../utils/validateBaseURL';\nimport { GraphEndpoint, IGraph, MICROSOFT_GRAPH_DEFAULT_ENDPOINT } from '../IGraph';\nimport { EventDispatcher, EventHandler } from '../utils/EventDispatcher';\n\n/**\n * Provider Type to be extended for implementing new providers\n *\n * @export\n * @abstract\n * @class IProvider\n * @implements {AuthenticationProvider}\n */\nexport abstract class IProvider implements AuthenticationProvider {\n /**\n * The Graph object that contains the Graph client sdk\n *\n * @type {Graph}\n * @memberof IProvider\n */\n public graph: IGraph;\n\n /**\n * Specifies if the provider has enabled support for multiple accounts\n *\n * @protected\n * @type {boolean}\n * @memberof IProvider\n */\n protected isMultipleAccountDisabled = true;\n\n /**\n * Specifies if Multi account functionality is supported by the provider and enabled.\n *\n * @readonly\n * @type {boolean}\n * @memberof IProvider\n */\n public get isMultiAccountSupportedAndEnabled(): boolean {\n return false;\n }\n\n private _state: ProviderState;\n private readonly _loginChangedDispatcher = new EventDispatcher();\n private readonly _activeAccountChangedDispatcher = new EventDispatcher();\n private _baseURL: GraphEndpoint = MICROSOFT_GRAPH_DEFAULT_ENDPOINT;\n\n private _approvedScopes: string[] = [];\n public get approvedScopes(): string[] {\n return this._approvedScopes;\n }\n\n public set approvedScopes(value: string[]) {\n this._approvedScopes = value.map(v => v.toLowerCase());\n }\n\n public hasAtLeastOneApprovedScope(requiredScopeSet: string[]): boolean {\n return requiredScopeSet.some(s => this.approvedScopes.includes(s.toLowerCase().trim()));\n }\n\n public hasAllOneApprovedScope(requiredScopeSet: string[]): boolean {\n return requiredScopeSet.some(s => !this.approvedScopes.includes(s.toLowerCase().trim()));\n }\n\n /**\n * Examines the currently consented scopes for any match in the requiredScopeSet to determine what, if any, scopes need to be consented to\n *\n * @param {string[]} requiredScopeSet an array of scopes to be checked\n * @returns {string[]} if any matches in requiredScopeSet exist then an empty array is returns, otherwise an array containing the first element in the requiredScopeSet is returned\n */\n public needsAdditionalScopes(requiredScopeSet: string[]): string[] {\n const reqScopes: string[] = [];\n if (requiredScopeSet.length && !this.hasAtLeastOneApprovedScope(requiredScopeSet)) {\n reqScopes.push(requiredScopeSet[0].trim());\n }\n return reqScopes;\n }\n\n /**\n * The base URL to be used in the graph client config.\n */\n public set baseURL(url: GraphEndpoint) {\n if (validateBaseURL(url)) {\n this._baseURL = url;\n return;\n } else {\n throw new Error(`${url} is not a valid Graph URL endpoint.`);\n }\n }\n\n public get baseURL(): GraphEndpoint {\n return this._baseURL;\n }\n\n private _customHosts?: string[] = undefined;\n\n /**\n * Custom Hostnames to allow graph client to utilize\n */\n public set customHosts(hosts: string[] | undefined) {\n this._customHosts = hosts;\n }\n\n public get customHosts(): string[] | undefined {\n return this._customHosts;\n }\n\n /**\n * Enable/Disable incremental consent\n *\n * @protected\n * @type {boolean}\n * @memberof IProvider\n */\n private _isIncrementalConsentDisabled = false;\n\n /**\n * Backing field for isMultiAccountSupported\n *\n * @protected\n * @memberof IProvider\n */\n protected isMultipleAccountSupported = false;\n\n /**\n * Does the provider support multiple accounts?\n *\n * @readonly\n * @type {boolean}\n * @memberof IProvider\n */\n public get isMultiAccountSupported(): boolean {\n return this.isMultipleAccountSupported;\n }\n /**\n * returns state of Provider\n *\n * @readonly\n * @type {ProviderState}\n * @memberof IProvider\n */\n public get state(): ProviderState {\n return this._state;\n }\n\n /**\n * Incremental consent setting\n *\n * @readonly\n * @memberof IProvider\n */\n public get isIncrementalConsentDisabled(): boolean {\n return this._isIncrementalConsentDisabled;\n }\n\n /**\n * Enable/Disable incremental consent\n *\n * @readonly\n * @memberof IProvider\n */\n public set isIncrementalConsentDisabled(disabled: boolean) {\n this._isIncrementalConsentDisabled = disabled;\n }\n\n /**\n * Name used for analytics\n *\n * @readonly\n * @memberof IProvider\n */\n public get name() {\n return 'MgtIProvider';\n }\n\n constructor() {\n this._state = ProviderState.Loading;\n }\n\n /**\n * sets state of Provider and fires loginchangedDispatcher\n *\n * @param {ProviderState} state\n * @memberof IProvider\n */\n public setState(state: ProviderState) {\n if (state !== this._state) {\n this._state = state;\n this._loginChangedDispatcher.fire({});\n }\n }\n\n /**\n * event handler when login changes\n *\n * @param {EventHandler} eventHandler\n * @memberof IProvider\n */\n public onStateChanged(eventHandler: EventHandler) {\n this._loginChangedDispatcher.add(eventHandler);\n }\n /**\n * removes event handler for when login changes\n *\n * @param {EventHandler} eventHandler\n * @memberof IProvider\n */\n public removeStateChangedHandler(eventHandler: EventHandler) {\n this._loginChangedDispatcher.remove(eventHandler);\n }\n\n /**\n * option implementation that can be called to sign in user (required for mgt-login to work)\n *\n * @returns {Promise}\n * @memberof IProvider\n */\n public login?(): Promise;\n\n /**\n * optional implementation that can be called to sign out user (required for mgt-login to work)\n *\n * @returns {Promise}\n * @memberof IProvider\n */\n public logout?(): Promise;\n\n /**\n * Returns all signed in accounts.\n *\n * @return {*} {any[]}\n * @memberof IProvider\n */\n public getAllAccounts?(): IProviderAccount[];\n\n /**\n * Returns active account in case of multi-account sign in\n *\n * @return {*} {any[]}\n * @memberof IProvider\n */\n public getActiveAccount?(): IProviderAccount;\n\n /**\n * Switch between two signed in accounts\n *\n * @param {*} user\n * @memberof IProvider\n */\n // eslint-disable-next-line @typescript-eslint/no-unused-vars\n public setActiveAccount?(user: IProviderAccount) {\n this.fireActiveAccountChanged();\n }\n\n /**\n * Event handler when Active account changes\n *\n * @param {EventHandler} eventHandler\n * @memberof IProvider\n */\n public onActiveAccountChanged(eventHandler: EventHandler) {\n this._activeAccountChangedDispatcher.add(eventHandler);\n }\n\n /**\n * Removes event handler for when Active account changes\n *\n * @param {EventHandler} eventHandler\n * @memberof IProvider\n */\n public removeActiveAccountChangedHandler(eventHandler: EventHandler) {\n this._activeAccountChangedDispatcher.remove(eventHandler);\n }\n\n /**\n * Fires event when active account changes\n *\n * @memberof IProvider\n */\n private fireActiveAccountChanged() {\n this._activeAccountChangedDispatcher.fire({});\n }\n\n /**\n * uses scopes to recieve access token\n *\n * @param {...string[]} scopes\n * @returns {Promise}\n * @memberof IProvider\n */\n public getAccessTokenForScopes(...scopes: string[]): Promise {\n return this.getAccessToken({ scopes });\n }\n\n /**\n * Promise to receive access token using Provider options\n *\n * @abstract\n * @param {AuthenticationProviderOptions} [options]\n * @returns {Promise}\n * @memberof IProvider\n */\n public abstract getAccessToken(options?: AuthenticationProviderOptions): Promise;\n}\n\n/**\n * ActiveAccountChanged Event\n *\n * @export\n * @interface ActiveAccountChanged\n */\n// eslint-disable-next-line @typescript-eslint/no-empty-interface\nexport interface ActiveAccountChanged {}\n/**\n * loginChangedEvent\n *\n * @export\n * @interface LoginChangedEvent\n */\n// eslint-disable-next-line @typescript-eslint/no-empty-interface\nexport interface LoginChangedEvent {}\n\n/**\n * LoginType\n *\n * @export\n * @enum {number}\n */\nexport enum LoginType {\n /**\n * Popup = 0\n */\n Popup,\n /**\n * Redirect = 1\n */\n Redirect\n}\n\n/**\n * ProviderState\n *\n * @export\n * @enum {number}\n */\nexport enum ProviderState {\n /**\n * Loading = 0\n */\n Loading,\n /**\n * SignedOut = 1\n */\n SignedOut,\n /**\n * SignedIn = 2\n */\n SignedIn\n}\n\n/**\n * Account details\n *\n * @export\n */\nexport interface IProviderAccount {\n id: string;\n mail?: string;\n name?: string;\n tenantId?: string;\n}\n","/**\n * -------------------------------------------------------------------------------------------\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\n * See License in the project root for license information.\n * -------------------------------------------------------------------------------------------\n */\n\nimport { Client } from '@microsoft/microsoft-graph-client';\nimport { User } from '@microsoft/microsoft-graph-types';\n\nimport { EventDispatcher, EventHandler } from '../utils/EventDispatcher';\nimport { IProvider, ProviderState } from './IProvider';\n\n/**\n * Provides implementation for acquiring the necessary access token for calling the Microsoft Graph APIs.\n *\n * @export\n * @class Providers\n */\nexport class Providers {\n /**\n * returns the value of provider used globally. All components use this property to get a reference to the provider.\n *\n * @static\n * @type {IProvider}\n * @memberof Providers\n */\n public static get globalProvider(): IProvider {\n return this._globalProvider;\n }\n\n public static set globalProvider(provider: IProvider) {\n if (provider !== this._globalProvider) {\n if (this._globalProvider) {\n this._globalProvider.removeStateChangedHandler(this.handleProviderStateChanged);\n if (this._globalProvider.isMultiAccountSupportedAndEnabled) {\n this._globalProvider.removeActiveAccountChangedHandler(this.handleActiveAccountChanged);\n }\n }\n\n if (provider) {\n provider.onStateChanged(this.handleProviderStateChanged);\n if (provider.isMultiAccountSupportedAndEnabled) {\n provider.onActiveAccountChanged(this.handleActiveAccountChanged);\n }\n }\n\n this._globalProvider = provider;\n this._eventDispatcher.fire(ProvidersChangedState.ProviderChanged);\n }\n }\n\n /**\n * Fires event when Provider changes state\n *\n * @static\n * @param {EventHandler} event\n * @memberof Providers\n */\n public static onProviderUpdated(event: EventHandler) {\n this._eventDispatcher.add(event);\n }\n\n /**\n * Remove event handler\n *\n * @static\n * @param {EventHandler} event\n * @memberof Providers\n */\n public static removeProviderUpdatedListener(event: EventHandler) {\n this._eventDispatcher.remove(event);\n }\n\n /**\n * Fires event when Provider changes state\n *\n * @static\n * @param {EventHandler} event\n * @memberof Providers\n */\n public static onActiveAccountChanged(event: EventHandler) {\n this._activeAccountChangedDispatcher.add(event);\n }\n\n /**\n * Remove event handler\n *\n * @static\n * @param {EventHandler} event\n * @memberof Providers\n */\n public static removeActiveAccountChangedListener(event: EventHandler) {\n this._activeAccountChangedDispatcher.remove(event);\n }\n\n /**\n * Gets the current signed in user\n *\n * @static\n * @memberof Providers\n */\n public static me(): Promise {\n if (!this.client) {\n this._mePromise = null;\n return null;\n }\n\n // eslint-disable-next-line @typescript-eslint/no-misused-promises\n if (!this._mePromise) {\n this._mePromise = this.getMe();\n }\n\n return this._mePromise;\n }\n\n /**\n * Get current signed in user details\n *\n * @private\n * @static\n * @return {*} {Promise}\n * @memberof Providers\n */\n private static async getMe(): Promise {\n try {\n const response: User = (await this.client.api('me').get()) as User;\n if (response?.id) {\n return response;\n }\n } catch {\n // no-op\n }\n\n return null;\n }\n\n /**\n * Gets the cache ID, creates one if it does not exist\n *\n * @static\n * @memberof Providers\n */\n public static async getCacheId() {\n if (this._cacheId) {\n return this._cacheId;\n }\n if (Providers.globalProvider?.state === ProviderState.SignedIn) {\n if (!this._cacheId) {\n const client = this.client;\n if (client) {\n try {\n this._cacheId = await this.createCacheId();\n } catch {\n // no-op\n }\n }\n }\n }\n return this._cacheId;\n }\n\n /**\n * Unset the cache ID\n *\n * @static\n * @memberof Providers\n */\n private static unsetCacheId() {\n this._cacheId = null;\n this._mePromise = null;\n }\n\n /**\n * Create cache ID\n *\n * @private\n * @static\n * @return {*} {Promise}\n * @memberof Providers\n */\n private static async createCacheId(): Promise {\n if (Providers.globalProvider.isMultiAccountSupportedAndEnabled) {\n const cacheId = this.createCacheIdWithAccountDetails();\n if (cacheId) {\n return cacheId;\n }\n }\n return await this.createCacheIdWithUserDetails();\n }\n\n /**\n * Create a cache ID with user userID and principal name\n *\n * @static\n * @param {User} response\n * @return {*}\n * @memberof Providers\n */\n private static async createCacheIdWithUserDetails(): Promise {\n const response: User = await this.me();\n if (response?.id) {\n return response.id + '-' + response.userPrincipalName;\n } else return null;\n }\n\n /**\n * Create cache ID with tenant ID and user ID\n *\n * @private\n * @static\n * @return {*} {string}\n * @memberof Providers\n */\n private static createCacheIdWithAccountDetails(): string {\n const user = Providers.globalProvider.getActiveAccount();\n if (user.tenantId && user.id) {\n return user.tenantId + user.id;\n } else return null;\n }\n\n /**\n * Gets the current graph client\n *\n * @readonly\n * @static\n * @type {Client}\n * @memberof Providers\n */\n public static get client(): Client {\n if (Providers.globalProvider && Providers.globalProvider.state === ProviderState.SignedIn) {\n return Providers.globalProvider.graph.client;\n }\n return null;\n }\n\n private static readonly _eventDispatcher = new EventDispatcher();\n\n private static readonly _activeAccountChangedDispatcher = new EventDispatcher();\n\n private static _globalProvider: IProvider;\n private static _cacheId: string;\n private static _mePromise: Promise;\n\n private static readonly handleProviderStateChanged = () => {\n if (!Providers.globalProvider || Providers.globalProvider.state !== ProviderState.SignedIn) {\n // clear current signed in user info\n Providers._mePromise = null;\n }\n\n Providers._eventDispatcher.fire(ProvidersChangedState.ProviderStateChanged);\n };\n\n private static readonly handleActiveAccountChanged = () => {\n Providers.unsetCacheId();\n Providers._activeAccountChangedDispatcher.fire(null);\n };\n}\n\n/**\n * on Provider Change State\n *\n * @export\n * @enum {number}\n */\nexport enum ProvidersChangedState {\n /**\n * ProviderChanged = 0\n */\n ProviderChanged,\n /**\n * ProviderStateChanged = 1\n */\n ProviderStateChanged\n}\n","export default function _OverloadYield(value, kind) {\n this.v = value, this.k = kind;\n}","import OverloadYield from \"./OverloadYield.js\";\nexport default function _awaitAsyncGenerator(value) {\n return new OverloadYield(value, 0);\n}","import OverloadYield from \"./OverloadYield.js\";\nexport default function AsyncGenerator(gen) {\n var front, back;\n function resume(key, arg) {\n try {\n var result = gen[key](arg),\n value = result.value,\n overloaded = value instanceof OverloadYield;\n Promise.resolve(overloaded ? value.v : value).then(function (arg) {\n if (overloaded) {\n var nextKey = \"return\" === key ? \"return\" : \"next\";\n if (!value.k || arg.done) return resume(nextKey, arg);\n arg = gen[nextKey](arg).value;\n }\n settle(result.done ? \"return\" : \"normal\", arg);\n }, function (err) {\n resume(\"throw\", err);\n });\n } catch (err) {\n settle(\"throw\", err);\n }\n }\n function settle(type, value) {\n switch (type) {\n case \"return\":\n front.resolve({\n value: value,\n done: !0\n });\n break;\n case \"throw\":\n front.reject(value);\n break;\n default:\n front.resolve({\n value: value,\n done: !1\n });\n }\n (front = front.next) ? resume(front.key, front.arg) : back = null;\n }\n this._invoke = function (key, arg) {\n return new Promise(function (resolve, reject) {\n var request = {\n key: key,\n arg: arg,\n resolve: resolve,\n reject: reject,\n next: null\n };\n back ? back = back.next = request : (front = back = request, resume(key, arg));\n });\n }, \"function\" != typeof gen[\"return\"] && (this[\"return\"] = void 0);\n}\nAsyncGenerator.prototype[\"function\" == typeof Symbol && Symbol.asyncIterator || \"@@asyncIterator\"] = function () {\n return this;\n}, AsyncGenerator.prototype.next = function (arg) {\n return this._invoke(\"next\", arg);\n}, AsyncGenerator.prototype[\"throw\"] = function (arg) {\n return this._invoke(\"throw\", arg);\n}, AsyncGenerator.prototype[\"return\"] = function (arg) {\n return this._invoke(\"return\", arg);\n};","import AsyncGenerator from \"./AsyncGenerator.js\";\nexport default function _wrapAsyncGenerator(fn) {\n return function () {\n return new AsyncGenerator(fn.apply(this, arguments));\n };\n}","const instanceOfAny = (object, constructors) => constructors.some((c) => object instanceof c);\n\nlet idbProxyableTypes;\nlet cursorAdvanceMethods;\n// This is a function to prevent it throwing up in node environments.\nfunction getIdbProxyableTypes() {\n return (idbProxyableTypes ||\n (idbProxyableTypes = [\n IDBDatabase,\n IDBObjectStore,\n IDBIndex,\n IDBCursor,\n IDBTransaction,\n ]));\n}\n// This is a function to prevent it throwing up in node environments.\nfunction getCursorAdvanceMethods() {\n return (cursorAdvanceMethods ||\n (cursorAdvanceMethods = [\n IDBCursor.prototype.advance,\n IDBCursor.prototype.continue,\n IDBCursor.prototype.continuePrimaryKey,\n ]));\n}\nconst transactionDoneMap = new WeakMap();\nconst transformCache = new WeakMap();\nconst reverseTransformCache = new WeakMap();\nfunction promisifyRequest(request) {\n const promise = new Promise((resolve, reject) => {\n const unlisten = () => {\n request.removeEventListener('success', success);\n request.removeEventListener('error', error);\n };\n const success = () => {\n resolve(wrap(request.result));\n unlisten();\n };\n const error = () => {\n reject(request.error);\n unlisten();\n };\n request.addEventListener('success', success);\n request.addEventListener('error', error);\n });\n // This mapping exists in reverseTransformCache but doesn't doesn't exist in transformCache. This\n // is because we create many promises from a single IDBRequest.\n reverseTransformCache.set(promise, request);\n return promise;\n}\nfunction cacheDonePromiseForTransaction(tx) {\n // Early bail if we've already created a done promise for this transaction.\n if (transactionDoneMap.has(tx))\n return;\n const done = new Promise((resolve, reject) => {\n const unlisten = () => {\n tx.removeEventListener('complete', complete);\n tx.removeEventListener('error', error);\n tx.removeEventListener('abort', error);\n };\n const complete = () => {\n resolve();\n unlisten();\n };\n const error = () => {\n reject(tx.error || new DOMException('AbortError', 'AbortError'));\n unlisten();\n };\n tx.addEventListener('complete', complete);\n tx.addEventListener('error', error);\n tx.addEventListener('abort', error);\n });\n // Cache it for later retrieval.\n transactionDoneMap.set(tx, done);\n}\nlet idbProxyTraps = {\n get(target, prop, receiver) {\n if (target instanceof IDBTransaction) {\n // Special handling for transaction.done.\n if (prop === 'done')\n return transactionDoneMap.get(target);\n // Make tx.store return the only store in the transaction, or undefined if there are many.\n if (prop === 'store') {\n return receiver.objectStoreNames[1]\n ? undefined\n : receiver.objectStore(receiver.objectStoreNames[0]);\n }\n }\n // Else transform whatever we get back.\n return wrap(target[prop]);\n },\n set(target, prop, value) {\n target[prop] = value;\n return true;\n },\n has(target, prop) {\n if (target instanceof IDBTransaction &&\n (prop === 'done' || prop === 'store')) {\n return true;\n }\n return prop in target;\n },\n};\nfunction replaceTraps(callback) {\n idbProxyTraps = callback(idbProxyTraps);\n}\nfunction wrapFunction(func) {\n // Due to expected object equality (which is enforced by the caching in `wrap`), we\n // only create one new func per func.\n // Cursor methods are special, as the behaviour is a little more different to standard IDB. In\n // IDB, you advance the cursor and wait for a new 'success' on the IDBRequest that gave you the\n // cursor. It's kinda like a promise that can resolve with many values. That doesn't make sense\n // with real promises, so each advance methods returns a new promise for the cursor object, or\n // undefined if the end of the cursor has been reached.\n if (getCursorAdvanceMethods().includes(func)) {\n return function (...args) {\n // Calling the original function with the proxy as 'this' causes ILLEGAL INVOCATION, so we use\n // the original object.\n func.apply(unwrap(this), args);\n return wrap(this.request);\n };\n }\n return function (...args) {\n // Calling the original function with the proxy as 'this' causes ILLEGAL INVOCATION, so we use\n // the original object.\n return wrap(func.apply(unwrap(this), args));\n };\n}\nfunction transformCachableValue(value) {\n if (typeof value === 'function')\n return wrapFunction(value);\n // This doesn't return, it just creates a 'done' promise for the transaction,\n // which is later returned for transaction.done (see idbObjectHandler).\n if (value instanceof IDBTransaction)\n cacheDonePromiseForTransaction(value);\n if (instanceOfAny(value, getIdbProxyableTypes()))\n return new Proxy(value, idbProxyTraps);\n // Return the same value back if we're not going to transform it.\n return value;\n}\nfunction wrap(value) {\n // We sometimes generate multiple promises from a single IDBRequest (eg when cursoring), because\n // IDB is weird and a single IDBRequest can yield many responses, so these can't be cached.\n if (value instanceof IDBRequest)\n return promisifyRequest(value);\n // If we've already transformed this value before, reuse the transformed value.\n // This is faster, but it also provides object equality.\n if (transformCache.has(value))\n return transformCache.get(value);\n const newValue = transformCachableValue(value);\n // Not all types are transformed.\n // These may be primitive types, so they can't be WeakMap keys.\n if (newValue !== value) {\n transformCache.set(value, newValue);\n reverseTransformCache.set(newValue, value);\n }\n return newValue;\n}\nconst unwrap = (value) => reverseTransformCache.get(value);\n\n/**\n * Open a database.\n *\n * @param name Name of the database.\n * @param version Schema version.\n * @param callbacks Additional callbacks.\n */\nfunction openDB(name, version, { blocked, upgrade, blocking, terminated } = {}) {\n const request = indexedDB.open(name, version);\n const openPromise = wrap(request);\n if (upgrade) {\n request.addEventListener('upgradeneeded', (event) => {\n upgrade(wrap(request.result), event.oldVersion, event.newVersion, wrap(request.transaction), event);\n });\n }\n if (blocked) {\n request.addEventListener('blocked', (event) => blocked(\n // Casting due to https://github.com/microsoft/TypeScript-DOM-lib-generator/pull/1405\n event.oldVersion, event.newVersion, event));\n }\n openPromise\n .then((db) => {\n if (terminated)\n db.addEventListener('close', () => terminated());\n if (blocking) {\n db.addEventListener('versionchange', (event) => blocking(event.oldVersion, event.newVersion, event));\n }\n })\n .catch(() => { });\n return openPromise;\n}\n/**\n * Delete a database.\n *\n * @param name Name of the database.\n */\nfunction deleteDB(name, { blocked } = {}) {\n const request = indexedDB.deleteDatabase(name);\n if (blocked) {\n request.addEventListener('blocked', (event) => blocked(\n // Casting due to https://github.com/microsoft/TypeScript-DOM-lib-generator/pull/1405\n event.oldVersion, event));\n }\n return wrap(request).then(() => undefined);\n}\n\nconst readMethods = ['get', 'getKey', 'getAll', 'getAllKeys', 'count'];\nconst writeMethods = ['put', 'add', 'delete', 'clear'];\nconst cachedMethods = new Map();\nfunction getMethod(target, prop) {\n if (!(target instanceof IDBDatabase &&\n !(prop in target) &&\n typeof prop === 'string')) {\n return;\n }\n if (cachedMethods.get(prop))\n return cachedMethods.get(prop);\n const targetFuncName = prop.replace(/FromIndex$/, '');\n const useIndex = prop !== targetFuncName;\n const isWrite = writeMethods.includes(targetFuncName);\n if (\n // Bail if the target doesn't exist on the target. Eg, getAll isn't in Edge.\n !(targetFuncName in (useIndex ? IDBIndex : IDBObjectStore).prototype) ||\n !(isWrite || readMethods.includes(targetFuncName))) {\n return;\n }\n const method = async function (storeName, ...args) {\n // isWrite ? 'readwrite' : undefined gzipps better, but fails in Edge :(\n const tx = this.transaction(storeName, isWrite ? 'readwrite' : 'readonly');\n let target = tx.store;\n if (useIndex)\n target = target.index(args.shift());\n // Must reject if op rejects.\n // If it's a write operation, must reject if tx.done rejects.\n // Must reject with op rejection first.\n // Must resolve with op value.\n // Must handle both promises (no unhandled rejections)\n return (await Promise.all([\n target[targetFuncName](...args),\n isWrite && tx.done,\n ]))[0];\n };\n cachedMethods.set(prop, method);\n return method;\n}\nreplaceTraps((oldTraps) => ({\n ...oldTraps,\n get: (target, prop, receiver) => getMethod(target, prop) || oldTraps.get(target, prop, receiver),\n has: (target, prop) => !!getMethod(target, prop) || oldTraps.has(target, prop),\n}));\n\nconst advanceMethodProps = ['continue', 'continuePrimaryKey', 'advance'];\nconst methodMap = {};\nconst advanceResults = new WeakMap();\nconst ittrProxiedCursorToOriginalProxy = new WeakMap();\nconst cursorIteratorTraps = {\n get(target, prop) {\n if (!advanceMethodProps.includes(prop))\n return target[prop];\n let cachedFunc = methodMap[prop];\n if (!cachedFunc) {\n cachedFunc = methodMap[prop] = function (...args) {\n advanceResults.set(this, ittrProxiedCursorToOriginalProxy.get(this)[prop](...args));\n };\n }\n return cachedFunc;\n },\n};\nasync function* iterate(...args) {\n // tslint:disable-next-line:no-this-assignment\n let cursor = this;\n if (!(cursor instanceof IDBCursor)) {\n cursor = await cursor.openCursor(...args);\n }\n if (!cursor)\n return;\n cursor = cursor;\n const proxiedCursor = new Proxy(cursor, cursorIteratorTraps);\n ittrProxiedCursorToOriginalProxy.set(proxiedCursor, cursor);\n // Map this double-proxy back to the original, so other cursor methods work.\n reverseTransformCache.set(proxiedCursor, unwrap(cursor));\n while (cursor) {\n yield proxiedCursor;\n // If one of the advancing methods was not called, call continue().\n cursor = await (advanceResults.get(proxiedCursor) || cursor.continue());\n advanceResults.delete(proxiedCursor);\n }\n}\nfunction isIteratorProp(target, prop) {\n return ((prop === Symbol.asyncIterator &&\n instanceOfAny(target, [IDBIndex, IDBObjectStore, IDBCursor])) ||\n (prop === 'iterate' && instanceOfAny(target, [IDBIndex, IDBObjectStore])));\n}\nreplaceTraps((oldTraps) => ({\n ...oldTraps,\n get(target, prop, receiver) {\n if (isIteratorProp(target, prop))\n return iterate;\n return oldTraps.get(target, prop, receiver);\n },\n has(target, prop) {\n return isIteratorProp(target, prop) || oldTraps.has(target, prop);\n },\n}));\n\nexport { deleteDB, openDB, unwrap, wrap };\n","/**\n * -------------------------------------------------------------------------------------------\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\n * See License in the project root for license information.\n * -------------------------------------------------------------------------------------------\n */\n\n/**\n * Localstorage key for storing names of cache databases\n *\n * @type {string}\n *\n */\n\nexport const dbListKey = 'mgt-db-list';\n","/**\n * -------------------------------------------------------------------------------------------\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\n * See License in the project root for license information.\n * -------------------------------------------------------------------------------------------\n */\n\nimport { openDB } from 'idb';\nimport { Providers } from '../providers/Providers';\nimport { dbListKey } from './dbListKey';\nimport { CacheItem } from './CacheItem';\nimport { CacheSchema } from './CacheSchema';\n\n/**\n * Represents a store in the cache\n *\n * @class CacheStore\n * @template T\n */\n\nexport class CacheStore {\n private readonly schema: CacheSchema;\n private readonly store: string;\n\n public constructor(schema: CacheSchema, store: string) {\n if (!(store in schema.stores)) {\n throw Error('\"store\" must be defined in the \"schema\"');\n }\n\n this.schema = schema;\n this.store = store;\n }\n\n /**\n * gets value from cache for the given key\n *\n * @param {string} key\n * @returns {Promise}\n * @memberof Cache\n */\n public async getValue(key: string): Promise {\n if (!window.indexedDB) {\n return null;\n }\n try {\n const db = await this.getDb();\n return db.get(this.store, key) as unknown as T;\n } catch (e) {\n return null;\n }\n }\n\n /**\n * inserts value into cache for the given key\n *\n * @param {string} key\n * @param {T} item\n * @returns\n * @memberof Cache\n */\n public async putValue(key: string, item: T) {\n if (!window.indexedDB) {\n return;\n }\n try {\n await (await this.getDb()).put(this.store, { ...item, timeCached: Date.now() }, key);\n } catch (e) {\n return;\n }\n }\n\n /**\n * Clears the store of all stored values\n *\n * @returns\n * @memberof Cache\n */\n public async clearStore() {\n if (!window.indexedDB) {\n return;\n }\n try {\n await (await this.getDb()).clear(this.store);\n } catch (e) {\n return;\n }\n }\n\n /**\n * Returns the name of the parent DB that the cache store belongs to\n */\n public async getDBName() {\n const id = await Providers.getCacheId();\n if (id) {\n return `mgt-${this.schema.name}` + `-${id}`;\n }\n }\n\n private async getDb() {\n const dbName = await this.getDBName();\n if (dbName) {\n return openDB(dbName, this.schema.version, {\n // eslint-disable-next-line @typescript-eslint/no-unused-vars\n upgrade: (db, _oldVersion, _newVersion, _transaction) => {\n const dbArray: string[] = (JSON.parse(localStorage.getItem(dbListKey)) as string[]) || [];\n if (!dbArray.includes(dbName)) {\n dbArray.push(dbName);\n }\n localStorage.setItem(dbListKey, JSON.stringify(dbArray));\n for (const storeName in this.schema.stores) {\n if (\n Object.prototype.hasOwnProperty.call(this.schema.stores, storeName) &&\n !db.objectStoreNames.contains(storeName)\n ) {\n db.createObjectStore(storeName);\n }\n }\n }\n });\n }\n }\n}\n","/**\n * -------------------------------------------------------------------------------------------\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\n * See License in the project root for license information.\n * -------------------------------------------------------------------------------------------\n */\n\nimport { Providers } from '../providers/Providers';\nimport { ProviderState } from '../providers/IProvider';\nimport { CacheStore } from './CacheStore';\nimport { CacheSchema } from './CacheSchema';\nimport { CacheItem } from './CacheItem';\nimport { dbListKey } from './dbListKey';\n\n/**\n * Holds the cache options for cache store\n *\n * @export\n * @interface CacheConfig\n */\nexport interface CacheConfig {\n /**\n * Default global invalidation period\n *\n * @type {number}\n * @memberof CacheConfig\n */\n defaultInvalidationPeriod: number;\n /**\n * Controls whether the cache is enabled globally\n *\n * @type {boolean}\n * @memberof CacheConfig\n */\n isEnabled: boolean;\n /**\n * Cache options for groups store\n *\n * @type {CacheOptions}\n * @memberof CacheConfig\n */\n groups: CacheOptions;\n /**\n * Cache options for people store\n *\n * @type {CacheOptions}\n * @memberof CacheConfig\n */\n people: CacheOptions;\n /**\n * Cache options for photos store\n *\n * @type {CacheOptions}\n * @memberof CacheConfig\n */\n photos: CacheOptions;\n /**\n * Cache options for presence store\n *\n * @type {CacheOptions}\n * @memberof CacheConfig\n */\n\n presence: CacheOptions;\n /**\n * Cache options for users store\n *\n * @type {CacheOptions}\n * @memberof CacheConfig\n */\n users: CacheOptions;\n\n /**\n * Cache options for a generic response store\n *\n * @type {CacheOptions}\n * @memberof CacheConfig\n */\n response: CacheOptions;\n\n /**\n * Cache options for files store\n *\n * @type {CacheOptions}\n * @memberof CacheConfig\n */\n files: CacheOptions;\n /**\n * Cache options for fileLists store\n *\n * @type {CacheOptions}\n * @memberof CacheConfig\n */\n fileLists: CacheOptions;\n}\n\n/**\n * Options for each store\n *\n * @export\n * @interface CacheOptions\n */\nexport interface CacheOptions {\n /**\n * Defines the time (in ms) for objects in the store to expire\n *\n * @type {number}\n * @memberof CacheOptions\n */\n invalidationPeriod: number;\n /**\n * Whether the store is enabled or not\n *\n * @type {boolean}\n * @memberof CacheOptions\n */\n isEnabled: boolean;\n}\n\n/**\n * class in charge of managing all the caches and their stores\n *\n * @export\n * @class CacheService\n */\nexport class CacheService {\n /**\n * Looks for existing cache, otherwise creates a new one\n *\n * @static\n * @template T\n * @param {CacheSchema} schema\n * @param {string} storeName\n * @returns {CacheStore}\n * @memberof CacheService\n */\n public static getCache(schema: CacheSchema, storeName: string): CacheStore {\n const key = `${schema.name}/${storeName}`;\n\n if (!this.isInitialized) {\n this.init();\n }\n\n if (!this.cacheStore.has(storeName)) {\n this.cacheStore.set(key, new CacheStore(schema, storeName));\n }\n return this.cacheStore.get(key) as CacheStore;\n }\n\n /**\n * Clears cache for a single user when ID is passed\n *\n * @static\n * @param {string} id\n * @memberof CacheService\n */\n public static clearCacheById(id: string): Promise {\n const work: Promise[] = [];\n const oldDbArray: string[] = JSON.parse(localStorage.getItem(dbListKey)) as string[];\n if (oldDbArray) {\n const newDbArray: string[] = [];\n oldDbArray.forEach(x => {\n if (x.includes(id)) {\n work.push(\n new Promise((resolve, reject) => {\n const delReq = indexedDB.deleteDatabase(x);\n delReq.onsuccess = () => resolve();\n delReq.onerror = () => {\n console.error(`🦒: ${delReq.error.name} occurred deleting cache: ${x}`, delReq.error.message);\n reject();\n };\n })\n );\n } else {\n newDbArray.push(x);\n }\n });\n if (newDbArray.length > 0) {\n localStorage.setItem(dbListKey, JSON.stringify(newDbArray));\n } else {\n localStorage.removeItem(dbListKey);\n }\n }\n return Promise.all(work);\n }\n\n private static readonly cacheStore = new Map>();\n private static isInitialized = false;\n\n private static readonly cacheConfig: CacheConfig = {\n defaultInvalidationPeriod: 3600000,\n groups: {\n invalidationPeriod: null,\n isEnabled: true\n },\n isEnabled: true,\n people: {\n invalidationPeriod: null,\n isEnabled: true\n },\n photos: {\n invalidationPeriod: null,\n isEnabled: true\n },\n presence: {\n invalidationPeriod: 300000,\n isEnabled: true\n },\n users: {\n invalidationPeriod: null,\n isEnabled: true\n },\n response: {\n invalidationPeriod: null,\n isEnabled: true\n },\n files: {\n invalidationPeriod: null,\n isEnabled: true\n },\n fileLists: {\n invalidationPeriod: null,\n isEnabled: true\n }\n };\n\n /**\n * returns the cacheconfig object\n *\n * @readonly\n * @static\n * @type {CacheConfig}\n * @memberof CacheService\n */\n public static get config(): CacheConfig {\n return this.cacheConfig;\n }\n\n /**\n * Checks for current sign in state and see if it has changed from signed-in to signed out\n *\n *\n * @private\n * @static\n * @memberof CacheService\n */\n private static init() {\n let previousState: ProviderState;\n if (Providers.globalProvider) {\n previousState = Providers.globalProvider.state;\n }\n\n // eslint-disable-next-line @typescript-eslint/no-misused-promises\n Providers.onProviderUpdated(async () => {\n if (previousState === ProviderState.SignedIn && Providers.globalProvider.state === ProviderState.SignedOut) {\n const id = await Providers.getCacheId();\n if (id !== null) {\n await this.clearCacheById(id);\n }\n }\n previousState = Providers.globalProvider.state;\n });\n this.isInitialized = true;\n }\n}\n","/**\n * -------------------------------------------------------------------------------------------\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\n * See License in the project root for license information.\n * -------------------------------------------------------------------------------------------\n */\n\n/**\n * An EventHandler for custom events\n */\nexport type EventHandler = (event: E) => void;\n\n/**\n * Provider EventDispatcher\n *\n * @export\n * @class EventDispatcher\n * @template E\n */\nexport class EventDispatcher {\n private readonly eventHandlers: EventHandler[] = [];\n /**\n * fires event handler\n *\n * @param {E} event\n * @memberof EventDispatcher\n */\n\n public fire(event: E) {\n for (const handler of this.eventHandlers) {\n handler(event);\n }\n }\n\n /**\n * adds eventHandler\n *\n * @param {EventHandler} eventHandler\n * @memberof EventDispatcher\n */\n public add(eventHandler: EventHandler) {\n this.eventHandlers.push(eventHandler);\n }\n\n /**\n * removes eventHandler\n *\n * @param {EventHandler} eventHandler\n * @memberof EventDispatcher\n */\n public remove(eventHandler: EventHandler) {\n for (let i = 0; i < this.eventHandlers.length; i++) {\n if (this.eventHandlers[i] === eventHandler) {\n this.eventHandlers.splice(i, 1);\n i--;\n }\n }\n }\n}\n","/**\n * -------------------------------------------------------------------------------------------\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\n * See License in the project root for license information.\n * -------------------------------------------------------------------------------------------\n */\n\nimport { EventDispatcher, EventHandler } from './EventDispatcher';\n\ntype ComponentLocalizationRecord = Record;\ntype LocalizationRecord = Record;\n\ntype LocalizationStorage = {\n _components: LocalizationRecord;\n} & Record;\n\n/**\n * Helper class for Localization\n *\n *\n * @export\n * @class LocalizationHelper\n */\nexport class LocalizationHelper {\n static _strings: LocalizationStorage;\n\n static _stringsEventDispatcher = new EventDispatcher();\n\n static _directionEventDispatcher = new EventDispatcher();\n\n private static mutationObserver: MutationObserver;\n\n public static get strings() {\n return this._strings;\n }\n\n /**\n * Set strings to be localized\n *\n * @static\n * @memberof LocalizationHelper\n */\n public static set strings(value: LocalizationStorage) {\n this._strings = value;\n this._stringsEventDispatcher.fire(null);\n }\n\n /**\n * returns body dir attribute to determine rtl or ltr\n *\n * @static\n * @returns {string} dir\n * @memberof LocalizationHelper\n */\n public static getDocumentDirection(): 'rtl' | 'ltr' | 'auto' {\n // Re-set the dir to ltr if the dir attribute is already loaded and the first two options\n // are returning null values.\n const parsed = document.body?.getAttribute('dir') || document.documentElement?.getAttribute('dir');\n switch (parsed) {\n case 'rtl':\n return 'rtl';\n case 'auto':\n return 'auto';\n case 'ltr':\n default:\n return 'ltr';\n }\n }\n\n /**\n * Fires event when LocalizationHelper changes state\n *\n * @static\n * @param {EventHandler} event\n * @memberof LocalizationHelper\n */\n public static onStringsUpdated(event: EventHandler) {\n this._stringsEventDispatcher.add(event);\n }\n\n public static removeOnStringsUpdated(event: EventHandler) {\n this._stringsEventDispatcher.remove(event);\n }\n\n public static onDirectionUpdated(event: EventHandler) {\n this._directionEventDispatcher.add(event);\n this.initDirection();\n }\n\n public static removeOnDirectionUpdated(event: EventHandler) {\n this._directionEventDispatcher.remove(event);\n }\n\n private static _isDirectionInit = false;\n\n /**\n * Checks for direction setup and adds mutationObserver\n *\n * @private\n * @static\n * @returns\n * @memberof LocalizationHelper\n */\n private static initDirection() {\n if (this._isDirectionInit) {\n return;\n }\n this._isDirectionInit = true;\n this.mutationObserver = new MutationObserver(mutations => {\n mutations.forEach(mutation => {\n if (mutation.attributeName === 'dir') {\n this._directionEventDispatcher.fire(null);\n }\n });\n });\n const options = { attributes: true, attributeFilter: ['dir'] };\n this.mutationObserver.observe(document.body, options);\n this.mutationObserver.observe(document.documentElement, options);\n }\n\n /**\n * Provided helper method to determine localized or defaultString for specific string is returned\n *\n * @static updateStringsForTag\n * @param {string} tagName\n * @param stringsObj\n * @returns\n * @memberof LocalizationHelper\n */\n public static updateStringsForTag(tagName: string, stringObj: Record) {\n tagName = tagName.toLowerCase();\n\n if (tagName.startsWith('mgt-')) {\n tagName = tagName.substring(4);\n }\n\n if (this._strings && stringObj) {\n // check for top level strings, applied per component, overridden by specific component def\n for (const prop of Object.entries(stringObj)) {\n const overrideValue = this._strings[prop[0]];\n if (typeof overrideValue === 'string') {\n stringObj[prop[0]] = overrideValue;\n }\n }\n\n // strings defined component specific\n if (this._strings._components?.[tagName]) {\n const strings = this._strings._components[tagName];\n for (const key of Object.keys(strings)) {\n if (stringObj[key]) {\n stringObj[key] = strings[key];\n }\n }\n }\n }\n\n return stringObj;\n }\n}\n","/**\n * -------------------------------------------------------------------------------------------\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\n * See License in the project root for license information.\n * -------------------------------------------------------------------------------------------\n */\n\nimport { HTMLTemplateResult, html } from 'lit';\nimport { customElementHelper } from '../components/customElementHelper';\n\n/**\n * stringsCache ensures that the same TemplateStringsArray object is returned on subsequent calls\n * This is needed as lit-html internally uses the TemplateStringsArray object as a cache key.\n *\n * @type {WeakMap}\n */\nconst stringsCache = new WeakMap();\n\n/**\n * Rewrites strings in an array using the supplied matcher RegExp\n * Assumes that the RegExp returns a group on matches\n *\n * @param strings The array of strings to be re-written\n * @param matcher A RegExp to be used for matching strings for replacement\n */\nconst rewriteStrings = (strings: readonly string[], matcher: RegExp, replacement: string): readonly string[] => {\n const temp: string[] = [];\n for (const s of strings) {\n temp.push(s.replace(matcher, replacement));\n }\n return temp;\n};\n\n/**\n * Generates a template literal tag function that returns an HTMLTemplateResult.\n */\nconst tag = (strings: TemplateStringsArray, ...values: unknown[]): HTMLTemplateResult => {\n // re-write mgtHtml`${title}`;\n * ```\n *\n * The `mgtHtml` tag is a wrapper for the `html` tag from `lit` which provides for dynamic tag re-writing\n */\nexport const mgtHtml = tag;\n","/**\n * -------------------------------------------------------------------------------------------\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\n * See License in the project root for license information.\n * -------------------------------------------------------------------------------------------\n */\n\nimport { AuthenticationHandlerOptions } from '@microsoft/microsoft-graph-client';\nimport { Providers } from '../providers/Providers';\n\n/**\n * creates an AuthenticationHandlerOptions from scopes array that\n * can be used in the Graph sdk middleware chain\n *\n * @export\n * @param {...string[]} scopes\n * @returns\n */\n\nexport const prepScopes = (scopes: string[], provider = Providers.globalProvider) => {\n const additionalScopes = provider.needsAdditionalScopes(scopes);\n const authProviderOptions = {\n scopes: additionalScopes\n };\n\n if (!provider.isIncrementalConsentDisabled) {\n return [new AuthenticationHandlerOptions(undefined, authProviderOptions)];\n } else {\n return [];\n }\n};\n","/**\n * -------------------------------------------------------------------------------------------\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\n * See License in the project root for license information.\n * -------------------------------------------------------------------------------------------\n */\n\nimport { customElementHelper } from '../components/customElementHelper';\n\nexport const buildComponentName = (tagBase: string) => `${customElementHelper.prefix}-${tagBase}`;\n\nexport const registerComponent = (\n tagBase: string,\n constructor: CustomElementConstructor,\n options?: ElementDefinitionOptions\n) => {\n const tagName = buildComponentName(tagBase);\n if (!customElements.get(tagName)) customElements.define(tagName, constructor, options);\n};\n","/**\n * -------------------------------------------------------------------------------------------\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\n * See License in the project root for license information.\n * -------------------------------------------------------------------------------------------\n */\n\nimport { GraphEndpoint, MICROSOFT_GRAPH_ENDPOINTS } from '../IGraph';\n\n/**\n * Helper method to validate a base URL string\n *\n * @param url a URL string\n * @returns GraphEndpoint\n */\n\nexport const validateBaseURL = (url: string): GraphEndpoint => {\n try {\n const urlObj = new URL(url);\n const originAsEndpoint = urlObj.origin as GraphEndpoint;\n if (MICROSOFT_GRAPH_ENDPOINTS.has(originAsEndpoint)) {\n return originAsEndpoint;\n }\n } catch (error) {\n return;\n }\n};\n","/**\n * -------------------------------------------------------------------------------------------\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\n * See License in the project root for license information.\n * -------------------------------------------------------------------------------------------\n */\n\n// THIS FILE IS AUTO GENERATED\n// ANY CHANGES WILL BE LOST DURING BUILD\n\nexport const PACKAGE_VERSION = '4.2.3';\n","/**\r\n * -------------------------------------------------------------------------------------------\r\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\r\n * See License in the project root for license information.\r\n * -------------------------------------------------------------------------------------------\r\n */\r\n\r\n/**\r\n * @enum\r\n * Enum for RequestMethods\r\n * @property {string} GET - The get request type\r\n * @property {string} PATCH - The patch request type\r\n * @property {string} POST - The post request type\r\n * @property {string} PUT - The put request type\r\n * @property {string} DELETE - The delete request type\r\n */\r\nexport enum RequestMethod {\r\n\tGET = \"GET\",\r\n\tPATCH = \"PATCH\",\r\n\tPOST = \"POST\",\r\n\tPUT = \"PUT\",\r\n\tDELETE = \"DELETE\",\r\n}\r\n","/**\r\n * -------------------------------------------------------------------------------------------\r\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\r\n * See License in the project root for license information.\r\n * -------------------------------------------------------------------------------------------\r\n */\r\n\r\n/**\r\n * @module BatchRequestContent\r\n */\r\nimport { RequestMethod } from \"../RequestMethod\";\r\n\r\n/**\r\n * @interface\r\n * Signature to represent the buffer request body parsing method\r\n * @property {Function} buffer - Returns a promise that resolves to a buffer of the request body\r\n */\r\ninterface NodeBody {\r\n\tbuffer(): Promise;\r\n}\r\n\r\n/**\r\n * @interface\r\n * Signature to represent the Request for both Node and browser environments\r\n * @extends Request\r\n * @extends NodeBody\r\n */\r\ninterface IsomorphicRequest extends Request, NodeBody {}\r\n\r\n/**\r\n * @interface\r\n * Signature representing BatchRequestStep data\r\n * @property {string} id - Unique identity for the request, Should not be an empty string\r\n * @property {string[]} [dependsOn] - Array of dependencies\r\n * @property {Request} request - The Request object\r\n */\r\nexport interface BatchRequestStep {\r\n\tid: string;\r\n\tdependsOn?: string[];\r\n\trequest: Request;\r\n}\r\n\r\n/**\r\n * @interface\r\n * Signature representing single request in a Batching\r\n * @extends RequestInit\r\n * @see {@link https://github.com/Microsoft/TypeScript/blob/master/lib/lib.dom.d.ts#L1337} and {@link https://fetch.spec.whatwg.org/#requestinit}\r\n *\r\n * @property {string} url - The url value of the request\r\n */\r\n\r\nexport interface RequestData extends RequestInit {\r\n\turl: string;\r\n}\r\n\r\n/**\r\n * @interface\r\n * Signature representing batch request data\r\n * @property {string} id - Unique identity for the request, Should not be an empty string\r\n * @property {string[]} [dependsOn] - Array of dependencies\r\n */\r\nexport interface BatchRequestData extends RequestData {\r\n\tid: string;\r\n\tdependsOn?: string[];\r\n}\r\n\r\n/**\r\n * @interface\r\n * Signature representing batch request body\r\n * @property {BatchRequestData[]} requests - Array of request data, a json representation of requests for batch\r\n */\r\n\r\nexport interface BatchRequestBody {\r\n\trequests: BatchRequestData[];\r\n}\r\n\r\n/**\r\n * @class\r\n * Class for handling BatchRequestContent\r\n */\r\nexport class BatchRequestContent {\r\n\t/**\r\n\t * @private\r\n\t * @static\r\n\t * Limit for number of requests {@link - https://developer.microsoft.com/en-us/graph/docs/concepts/known_issues#json-batching}\r\n\t */\r\n\tprivate static requestLimit = 20;\r\n\r\n\t/**\r\n\t * @public\r\n\t * To keep track of requests, key will be id of the request and value will be the request json\r\n\t */\r\n\tpublic requests: Map;\r\n\r\n\t/**\r\n\t * @private\r\n\t * @static\r\n\t * Validates the dependency chain of the requests\r\n\t *\r\n\t * Note:\r\n\t * Individual requests can depend on other individual requests. Currently, requests can only depend on a single other request, and must follow one of these three patterns:\r\n\t * 1. Parallel - no individual request states a dependency in the dependsOn property.\r\n\t * 2. Serial - all individual requests depend on the previous individual request.\r\n\t * 3. Same - all individual requests that state a dependency in the dependsOn property, state the same dependency.\r\n\t * As JSON batching matures, these limitations will be removed.\r\n\t * @see {@link https://developer.microsoft.com/en-us/graph/docs/concepts/known_issues#json-batching}\r\n\t *\r\n\t * @param {Map} requests - The map of requests.\r\n\t * @returns The boolean indicating the validation status\r\n\t */\r\n\r\n\tprivate static validateDependencies(requests: Map): boolean {\r\n\t\tconst isParallel = (reqs: Map): boolean => {\r\n\t\t\tconst iterator = reqs.entries();\r\n\t\t\tlet cur = iterator.next();\r\n\t\t\twhile (!cur.done) {\r\n\t\t\t\tconst curReq = cur.value[1];\r\n\t\t\t\tif (curReq.dependsOn !== undefined && curReq.dependsOn.length > 0) {\r\n\t\t\t\t\treturn false;\r\n\t\t\t\t}\r\n\t\t\t\tcur = iterator.next();\r\n\t\t\t}\r\n\t\t\treturn true;\r\n\t\t};\r\n\t\tconst isSerial = (reqs: Map): boolean => {\r\n\t\t\tconst iterator = reqs.entries();\r\n\t\t\tlet cur = iterator.next();\r\n\t\t\tconst firstRequest: BatchRequestStep = cur.value[1];\r\n\t\t\tif (firstRequest.dependsOn !== undefined && firstRequest.dependsOn.length > 0) {\r\n\t\t\t\treturn false;\r\n\t\t\t}\r\n\t\t\tlet prev = cur;\r\n\t\t\tcur = iterator.next();\r\n\t\t\twhile (!cur.done) {\r\n\t\t\t\tconst curReq: BatchRequestStep = cur.value[1];\r\n\t\t\t\tif (curReq.dependsOn === undefined || curReq.dependsOn.length !== 1 || curReq.dependsOn[0] !== prev.value[1].id) {\r\n\t\t\t\t\treturn false;\r\n\t\t\t\t}\r\n\t\t\t\tprev = cur;\r\n\t\t\t\tcur = iterator.next();\r\n\t\t\t}\r\n\t\t\treturn true;\r\n\t\t};\r\n\t\tconst isSame = (reqs: Map): boolean => {\r\n\t\t\tconst iterator = reqs.entries();\r\n\t\t\tlet cur = iterator.next();\r\n\t\t\tconst firstRequest: BatchRequestStep = cur.value[1];\r\n\t\t\tlet dependencyId: string;\r\n\t\t\tif (firstRequest.dependsOn === undefined || firstRequest.dependsOn.length === 0) {\r\n\t\t\t\tdependencyId = firstRequest.id;\r\n\t\t\t} else {\r\n\t\t\t\tif (firstRequest.dependsOn.length === 1) {\r\n\t\t\t\t\tconst fDependencyId = firstRequest.dependsOn[0];\r\n\t\t\t\t\tif (fDependencyId !== firstRequest.id && reqs.has(fDependencyId)) {\r\n\t\t\t\t\t\tdependencyId = fDependencyId;\r\n\t\t\t\t\t} else {\r\n\t\t\t\t\t\treturn false;\r\n\t\t\t\t\t}\r\n\t\t\t\t} else {\r\n\t\t\t\t\treturn false;\r\n\t\t\t\t}\r\n\t\t\t}\r\n\t\t\tcur = iterator.next();\r\n\t\t\twhile (!cur.done) {\r\n\t\t\t\tconst curReq = cur.value[1];\r\n\t\t\t\tif ((curReq.dependsOn === undefined || curReq.dependsOn.length === 0) && dependencyId !== curReq.id) {\r\n\t\t\t\t\treturn false;\r\n\t\t\t\t}\r\n\t\t\t\tif (curReq.dependsOn !== undefined && curReq.dependsOn.length !== 0) {\r\n\t\t\t\t\tif (curReq.dependsOn.length === 1 && (curReq.id === dependencyId || curReq.dependsOn[0] !== dependencyId)) {\r\n\t\t\t\t\t\treturn false;\r\n\t\t\t\t\t}\r\n\t\t\t\t\tif (curReq.dependsOn.length > 1) {\r\n\t\t\t\t\t\treturn false;\r\n\t\t\t\t\t}\r\n\t\t\t\t}\r\n\t\t\t\tcur = iterator.next();\r\n\t\t\t}\r\n\t\t\treturn true;\r\n\t\t};\r\n\t\tif (requests.size === 0) {\r\n\t\t\tconst error = new Error(\"Empty requests map, Please provide at least one request.\");\r\n\t\t\terror.name = \"Empty Requests Error\";\r\n\t\t\tthrow error;\r\n\t\t}\r\n\t\treturn isParallel(requests) || isSerial(requests) || isSame(requests);\r\n\t}\r\n\r\n\t/**\r\n\t * @private\r\n\t * @static\r\n\t * @async\r\n\t * Converts Request Object instance to a JSON\r\n\t * @param {IsomorphicRequest} request - The IsomorphicRequest Object instance\r\n\t * @returns A promise that resolves to JSON representation of a request\r\n\t */\r\n\tprivate static async getRequestData(request: IsomorphicRequest): Promise {\r\n\t\tconst requestData: RequestData = {\r\n\t\t\turl: \"\",\r\n\t\t};\r\n\t\tconst hasHttpRegex = new RegExp(\"^https?://\");\r\n\t\t// Stripping off hostname, port and url scheme\r\n\t\trequestData.url = hasHttpRegex.test(request.url) ? \"/\" + request.url.split(/.*?\\/\\/.*?\\//)[1] : request.url;\r\n\t\trequestData.method = request.method;\r\n\t\tconst headers = {};\r\n\t\trequest.headers.forEach((value, key) => {\r\n\t\t\theaders[key] = value;\r\n\t\t});\r\n\t\tif (Object.keys(headers).length) {\r\n\t\t\trequestData.headers = headers;\r\n\t\t}\r\n\t\tif (request.method === RequestMethod.PATCH || request.method === RequestMethod.POST || request.method === RequestMethod.PUT) {\r\n\t\t\trequestData.body = await BatchRequestContent.getRequestBody(request);\r\n\t\t}\r\n\t\t/**\r\n\t\t * TODO: Check any other property needs to be used from the Request object and add them\r\n\t\t */\r\n\t\treturn requestData;\r\n\t}\r\n\r\n\t/**\r\n\t * @private\r\n\t * @static\r\n\t * @async\r\n\t * Gets the body of a Request object instance\r\n\t * @param {IsomorphicRequest} request - The IsomorphicRequest object instance\r\n\t * @returns The Promise that resolves to a body value of a Request\r\n\t */\r\n\tprivate static async getRequestBody(request: IsomorphicRequest): Promise {\r\n\t\tlet bodyParsed = false;\r\n\t\tlet body;\r\n\t\ttry {\r\n\t\t\tconst cloneReq = request.clone();\r\n\t\t\tbody = await cloneReq.json();\r\n\t\t\tbodyParsed = true;\r\n\t\t} catch (e) {\r\n\t\t\t//TODO- Handle empty catches\r\n\t\t}\r\n\t\tif (!bodyParsed) {\r\n\t\t\ttry {\r\n\t\t\t\tif (typeof Blob !== \"undefined\") {\r\n\t\t\t\t\tconst blob = await request.blob();\r\n\t\t\t\t\tconst reader = new FileReader();\r\n\t\t\t\t\tbody = await new Promise((resolve) => {\r\n\t\t\t\t\t\treader.addEventListener(\r\n\t\t\t\t\t\t\t\"load\",\r\n\t\t\t\t\t\t\t() => {\r\n\t\t\t\t\t\t\t\tconst dataURL = reader.result as string;\r\n\t\t\t\t\t\t\t\t/**\r\n\t\t\t\t\t\t\t\t * Some valid dataURL schemes:\r\n\t\t\t\t\t\t\t\t * 1. data:text/vnd-example+xyz;foo=bar;base64,R0lGODdh\r\n\t\t\t\t\t\t\t\t * 2. data:text/plain;charset=UTF-8;page=21,the%20data:1234,5678\r\n\t\t\t\t\t\t\t\t * 3. data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==\r\n\t\t\t\t\t\t\t\t * 4. data:image/png,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==\r\n\t\t\t\t\t\t\t\t * 5. data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==\r\n\t\t\t\t\t\t\t\t * @see Syntax {@link https://en.wikipedia.org/wiki/Data_URI_scheme} for more\r\n\t\t\t\t\t\t\t\t */\r\n\t\t\t\t\t\t\t\tconst regex = new RegExp(\"^s*data:(.+?/.+?(;.+?=.+?)*)?(;base64)?,(.*)s*$\");\r\n\t\t\t\t\t\t\t\tconst segments = regex.exec(dataURL);\r\n\t\t\t\t\t\t\t\tresolve(segments[4]);\r\n\t\t\t\t\t\t\t},\r\n\t\t\t\t\t\t\tfalse,\r\n\t\t\t\t\t\t);\r\n\t\t\t\t\t\treader.readAsDataURL(blob);\r\n\t\t\t\t\t});\r\n\t\t\t\t} else if (typeof Buffer !== \"undefined\") {\r\n\t\t\t\t\tconst buffer = await request.buffer();\r\n\t\t\t\t\tbody = buffer.toString(\"base64\");\r\n\t\t\t\t}\r\n\t\t\t\tbodyParsed = true;\r\n\t\t\t} catch (e) {\r\n\t\t\t\t// TODO-Handle empty catches\r\n\t\t\t}\r\n\t\t}\r\n\t\treturn body;\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * @constructor\r\n\t * Constructs a BatchRequestContent instance\r\n\t * @param {BatchRequestStep[]} [requests] - Array of requests value\r\n\t * @returns An instance of a BatchRequestContent\r\n\t */\r\n\tpublic constructor(requests?: BatchRequestStep[]) {\r\n\t\tthis.requests = new Map();\r\n\t\tif (typeof requests !== \"undefined\") {\r\n\t\t\tconst limit = BatchRequestContent.requestLimit;\r\n\t\t\tif (requests.length > limit) {\r\n\t\t\t\tconst error = new Error(`Maximum requests limit exceeded, Max allowed number of requests are ${limit}`);\r\n\t\t\t\terror.name = \"Limit Exceeded Error\";\r\n\t\t\t\tthrow error;\r\n\t\t\t}\r\n\t\t\tfor (const req of requests) {\r\n\t\t\t\tthis.addRequest(req);\r\n\t\t\t}\r\n\t\t}\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * Adds a request to the batch request content\r\n\t * @param {BatchRequestStep} request - The request value\r\n\t * @returns The id of the added request\r\n\t */\r\n\tpublic addRequest(request: BatchRequestStep): string {\r\n\t\tconst limit = BatchRequestContent.requestLimit;\r\n\t\tif (request.id === \"\") {\r\n\t\t\tconst error = new Error(`Id for a request is empty, Please provide an unique id`);\r\n\t\t\terror.name = \"Empty Id For Request\";\r\n\t\t\tthrow error;\r\n\t\t}\r\n\t\tif (this.requests.size === limit) {\r\n\t\t\tconst error = new Error(`Maximum requests limit exceeded, Max allowed number of requests are ${limit}`);\r\n\t\t\terror.name = \"Limit Exceeded Error\";\r\n\t\t\tthrow error;\r\n\t\t}\r\n\t\tif (this.requests.has(request.id)) {\r\n\t\t\tconst error = new Error(`Adding request with duplicate id ${request.id}, Make the id of the requests unique`);\r\n\t\t\terror.name = \"Duplicate RequestId Error\";\r\n\t\t\tthrow error;\r\n\t\t}\r\n\t\tthis.requests.set(request.id, request);\r\n\t\treturn request.id;\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * Removes request from the batch payload and its dependencies from all dependents\r\n\t * @param {string} requestId - The id of a request that needs to be removed\r\n\t * @returns The boolean indicating removed status\r\n\t */\r\n\tpublic removeRequest(requestId: string): boolean {\r\n\t\tconst deleteStatus = this.requests.delete(requestId);\r\n\t\tconst iterator = this.requests.entries();\r\n\t\tlet cur = iterator.next();\r\n\t\t/**\r\n\t\t * Removing dependencies where this request is present as a dependency\r\n\t\t */\r\n\t\twhile (!cur.done) {\r\n\t\t\tconst dependencies = cur.value[1].dependsOn;\r\n\t\t\tif (typeof dependencies !== \"undefined\") {\r\n\t\t\t\tconst index = dependencies.indexOf(requestId);\r\n\t\t\t\tif (index !== -1) {\r\n\t\t\t\t\tdependencies.splice(index, 1);\r\n\t\t\t\t}\r\n\t\t\t\tif (dependencies.length === 0) {\r\n\t\t\t\t\tdelete cur.value[1].dependsOn;\r\n\t\t\t\t}\r\n\t\t\t}\r\n\t\t\tcur = iterator.next();\r\n\t\t}\r\n\t\treturn deleteStatus;\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * @async\r\n\t * Serialize content from BatchRequestContent instance\r\n\t * @returns The body content to make batch request\r\n\t */\r\n\tpublic async getContent(): Promise {\r\n\t\tconst requests: BatchRequestData[] = [];\r\n\t\tconst requestBody: BatchRequestBody = {\r\n\t\t\trequests,\r\n\t\t};\r\n\t\tconst iterator = this.requests.entries();\r\n\t\tlet cur = iterator.next();\r\n\t\tif (cur.done) {\r\n\t\t\tconst error = new Error(\"No requests added yet, Please add at least one request.\");\r\n\t\t\terror.name = \"Empty Payload\";\r\n\t\t\tthrow error;\r\n\t\t}\r\n\t\tif (!BatchRequestContent.validateDependencies(this.requests)) {\r\n\t\t\tconst error = new Error(`Invalid dependency found, Dependency should be:\r\n1. Parallel - no individual request states a dependency in the dependsOn property.\r\n2. Serial - all individual requests depend on the previous individual request.\r\n3. Same - all individual requests that state a dependency in the dependsOn property, state the same dependency.`);\r\n\t\t\terror.name = \"Invalid Dependency\";\r\n\t\t\tthrow error;\r\n\t\t}\r\n\t\twhile (!cur.done) {\r\n\t\t\tconst requestStep: BatchRequestStep = cur.value[1];\r\n\t\t\tconst batchRequestData: BatchRequestData = (await BatchRequestContent.getRequestData(requestStep.request as IsomorphicRequest)) as BatchRequestData;\r\n\t\t\t/**\r\n\t\t\t * @see{@https://tools.ietf.org/html/rfc7578#section-4.4}\r\n\t\t\t * TODO- Setting/Defaulting of content-type header to the correct value\r\n\t\t\t * @see {@link https://developer.microsoft.com/en-us/graph/docs/concepts/json_batching#request-format}\r\n\t\t\t */\r\n\t\t\tif (batchRequestData.body !== undefined && (batchRequestData.headers === undefined || batchRequestData.headers[\"content-type\"] === undefined)) {\r\n\t\t\t\tconst error = new Error(`Content-type header is not mentioned for request #${requestStep.id}, For request having body, Content-type header should be mentioned`);\r\n\t\t\t\terror.name = \"Invalid Content-type header\";\r\n\t\t\t\tthrow error;\r\n\t\t\t}\r\n\t\t\tbatchRequestData.id = requestStep.id;\r\n\t\t\tif (requestStep.dependsOn !== undefined && requestStep.dependsOn.length > 0) {\r\n\t\t\t\tbatchRequestData.dependsOn = requestStep.dependsOn;\r\n\t\t\t}\r\n\t\t\trequests.push(batchRequestData);\r\n\t\t\tcur = iterator.next();\r\n\t\t}\r\n\t\trequestBody.requests = requests;\r\n\t\treturn requestBody;\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * Adds a dependency for a given dependent request\r\n\t * @param {string} dependentId - The id of the dependent request\r\n\t * @param {string} [dependencyId] - The id of the dependency request, if not specified the preceding request will be considered as a dependency\r\n\t * @returns Nothing\r\n\t */\r\n\tpublic addDependency(dependentId: string, dependencyId?: string): void {\r\n\t\tif (!this.requests.has(dependentId)) {\r\n\t\t\tconst error = new Error(`Dependent ${dependentId} does not exists, Please check the id`);\r\n\t\t\terror.name = \"Invalid Dependent\";\r\n\t\t\tthrow error;\r\n\t\t}\r\n\t\tif (typeof dependencyId !== \"undefined\" && !this.requests.has(dependencyId)) {\r\n\t\t\tconst error = new Error(`Dependency ${dependencyId} does not exists, Please check the id`);\r\n\t\t\terror.name = \"Invalid Dependency\";\r\n\t\t\tthrow error;\r\n\t\t}\r\n\t\tif (typeof dependencyId !== \"undefined\") {\r\n\t\t\tconst dependent = this.requests.get(dependentId);\r\n\t\t\tif (dependent.dependsOn === undefined) {\r\n\t\t\t\tdependent.dependsOn = [];\r\n\t\t\t}\r\n\t\t\tif (dependent.dependsOn.indexOf(dependencyId) !== -1) {\r\n\t\t\t\tconst error = new Error(`Dependency ${dependencyId} is already added for the request ${dependentId}`);\r\n\t\t\t\terror.name = \"Duplicate Dependency\";\r\n\t\t\t\tthrow error;\r\n\t\t\t}\r\n\t\t\tdependent.dependsOn.push(dependencyId);\r\n\t\t} else {\r\n\t\t\tconst iterator = this.requests.entries();\r\n\t\t\tlet prev;\r\n\t\t\tlet cur = iterator.next();\r\n\t\t\twhile (!cur.done && cur.value[1].id !== dependentId) {\r\n\t\t\t\tprev = cur;\r\n\t\t\t\tcur = iterator.next();\r\n\t\t\t}\r\n\t\t\tif (typeof prev !== \"undefined\") {\r\n\t\t\t\tconst dId = prev.value[0];\r\n\t\t\t\tif (cur.value[1].dependsOn === undefined) {\r\n\t\t\t\t\tcur.value[1].dependsOn = [];\r\n\t\t\t\t}\r\n\t\t\t\tif (cur.value[1].dependsOn.indexOf(dId) !== -1) {\r\n\t\t\t\t\tconst error = new Error(`Dependency ${dId} is already added for the request ${dependentId}`);\r\n\t\t\t\t\terror.name = \"Duplicate Dependency\";\r\n\t\t\t\t\tthrow error;\r\n\t\t\t\t}\r\n\t\t\t\tcur.value[1].dependsOn.push(dId);\r\n\t\t\t} else {\r\n\t\t\t\tconst error = new Error(`Can't add dependency ${dependencyId}, There is only a dependent request in the batch`);\r\n\t\t\t\terror.name = \"Invalid Dependency Addition\";\r\n\t\t\t\tthrow error;\r\n\t\t\t}\r\n\t\t}\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * Removes a dependency for a given dependent request id\r\n\t * @param {string} dependentId - The id of the dependent request\r\n\t * @param {string} [dependencyId] - The id of the dependency request, if not specified will remove all the dependencies of that request\r\n\t * @returns The boolean indicating removed status\r\n\t */\r\n\tpublic removeDependency(dependentId: string, dependencyId?: string): boolean {\r\n\t\tconst request = this.requests.get(dependentId);\r\n\t\tif (typeof request === \"undefined\" || request.dependsOn === undefined || request.dependsOn.length === 0) {\r\n\t\t\treturn false;\r\n\t\t}\r\n\t\tif (typeof dependencyId !== \"undefined\") {\r\n\t\t\tconst index = request.dependsOn.indexOf(dependencyId);\r\n\t\t\tif (index === -1) {\r\n\t\t\t\treturn false;\r\n\t\t\t}\r\n\t\t\trequest.dependsOn.splice(index, 1);\r\n\t\t\treturn true;\r\n\t\t} else {\r\n\t\t\tdelete request.dependsOn;\r\n\t\t\treturn true;\r\n\t\t}\r\n\t}\r\n}\r\n","/**\r\n * -------------------------------------------------------------------------------------------\r\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\r\n * See License in the project root for license information.\r\n * -------------------------------------------------------------------------------------------\r\n */\r\n\r\n/**\r\n * @module Constants\r\n */\r\n\r\n/**\r\n * @constant\r\n * A Default API endpoint version for a request\r\n */\r\nexport const GRAPH_API_VERSION = \"v1.0\";\r\n\r\n/**\r\n * @constant\r\n * A Default base url for a request\r\n */\r\nexport const GRAPH_BASE_URL = \"https://graph.microsoft.com/\";\r\n\r\n/**\r\n * To hold list of the service root endpoints for Microsoft Graph and Graph Explorer for each national cloud.\r\n * Set(iterable:Object) is not supported in Internet Explorer. The consumer is recommended to use a suitable polyfill.\r\n */\r\nexport const GRAPH_URLS = new Set([\"graph.microsoft.com\", \"graph.microsoft.us\", \"dod-graph.microsoft.us\", \"graph.microsoft.de\", \"microsoftgraph.chinacloudapi.cn\", \"canary.graph.microsoft.com\"]);\r\n","/**\r\n * -------------------------------------------------------------------------------------------\r\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\r\n * See License in the project root for license information.\r\n * -------------------------------------------------------------------------------------------\r\n */\r\n\r\n/**\r\n * @module TelemetryHandlerOptions\r\n */\r\n\r\nimport { Context } from \"../../IContext\";\r\nimport { MiddlewareControl } from \"../MiddlewareControl\";\r\nimport { MiddlewareOptions } from \"./IMiddlewareOptions\";\r\n\r\n/**\r\n * @enum\r\n * @property {number} NONE - The hexadecimal flag value for nothing enabled\r\n * @property {number} REDIRECT_HANDLER_ENABLED - The hexadecimal flag value for redirect handler enabled\r\n * @property {number} RETRY_HANDLER_ENABLED - The hexadecimal flag value for retry handler enabled\r\n * @property {number} AUTHENTICATION_HANDLER_ENABLED - The hexadecimal flag value for the authentication handler enabled\r\n */\r\n\r\nexport enum FeatureUsageFlag {\r\n\t/* eslint-disable @typescript-eslint/naming-convention */\r\n\tNONE = 0x0,\r\n\tREDIRECT_HANDLER_ENABLED = 0x1,\r\n\tRETRY_HANDLER_ENABLED = 0x2,\r\n\tAUTHENTICATION_HANDLER_ENABLED = 0x4,\r\n\t/* eslint-enable @typescript-eslint/naming-convention */\r\n}\r\n\r\n/**\r\n * @class\r\n * @implements MiddlewareOptions\r\n * Class for TelemetryHandlerOptions\r\n */\r\n\r\nexport class TelemetryHandlerOptions implements MiddlewareOptions {\r\n\t/**\r\n\t * @private\r\n\t * A member to hold the OR of feature usage flags\r\n\t */\r\n\tprivate featureUsage: FeatureUsageFlag = FeatureUsageFlag.NONE;\r\n\r\n\t/**\r\n\t * @public\r\n\t * @static\r\n\t * To update the feature usage in the context object\r\n\t * @param {Context} context - The request context object containing middleware options\r\n\t * @param {FeatureUsageFlag} flag - The flag value\r\n\t * @returns nothing\r\n\t */\r\n\tpublic static updateFeatureUsageFlag(context: Context, flag: FeatureUsageFlag): void {\r\n\t\tlet options: TelemetryHandlerOptions;\r\n\t\tif (context.middlewareControl instanceof MiddlewareControl) {\r\n\t\t\toptions = context.middlewareControl.getMiddlewareOptions(TelemetryHandlerOptions) as TelemetryHandlerOptions;\r\n\t\t} else {\r\n\t\t\tcontext.middlewareControl = new MiddlewareControl();\r\n\t\t}\r\n\t\tif (typeof options === \"undefined\") {\r\n\t\t\toptions = new TelemetryHandlerOptions();\r\n\t\t\tcontext.middlewareControl.setMiddlewareOptions(TelemetryHandlerOptions, options);\r\n\t\t}\r\n\t\toptions.setFeatureUsage(flag);\r\n\t}\r\n\r\n\t/**\r\n\t * @private\r\n\t * To set the feature usage flag\r\n\t * @param {FeatureUsageFlag} flag - The flag value\r\n\t * @returns nothing\r\n\t */\r\n\tprivate setFeatureUsage(flag: FeatureUsageFlag): void {\r\n\t\tthis.featureUsage = this.featureUsage | flag;\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * To get the feature usage\r\n\t * @returns A feature usage flag as hexadecimal string\r\n\t */\r\n\tpublic getFeatureUsage(): string {\r\n\t\treturn this.featureUsage.toString(16);\r\n\t}\r\n}\r\n","/**\r\n * -------------------------------------------------------------------------------------------\r\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\r\n * See License in the project root for license information.\r\n * -------------------------------------------------------------------------------------------\r\n */\r\n\r\n/**\r\n * @module GraphClientError\r\n */\r\n\r\n/**\r\n * @class\r\n * Create GraphClientError object to handle client-side errors\r\n * encountered within the JavaScript Client SDK.\r\n * Whereas GraphError Class should be used to handle errors in the response from the Graph API.\r\n */\r\n\r\nexport class GraphClientError extends Error {\r\n\t/**\r\n\t * @public\r\n\t * A custom error. This property should set be when the error is not of instanceOf Error/GraphClientError.\r\n\t * Example =\r\n\t * const client = MicrosoftGraph.Client.init({\r\n\t * \t\tdefaultVersion: \"v1.0\",\r\n\t * \tauthProvider: (done) => { done({TokenError:\"AccessToken cannot be null\"}, \"\");\r\n\t * });\r\n\t */\r\n\tpublic customError?: any;\r\n\r\n\t/**\r\n\t * @public\r\n\t * @static\r\n\t * @async\r\n\t * To set the GraphClientError object\r\n\t * @param {any} error - The error returned encountered by the Graph JavaScript Client SDK while processing request\r\n\t * @returns GraphClientError object set to the error passed\r\n\t */\r\n\tpublic static setGraphClientError(error: any): GraphClientError {\r\n\t\tlet graphClientError: GraphClientError;\r\n\t\tif (error instanceof Error) {\r\n\t\t\tgraphClientError = error;\r\n\t\t} else {\r\n\t\t\tgraphClientError = new GraphClientError();\r\n\t\t\tgraphClientError.customError = error;\r\n\t\t}\r\n\t\treturn graphClientError;\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * @constructor\r\n\t * Creates an instance of GraphClientError\r\n\t * @param {string} message? - Error message\r\n\t * @returns An instance of GraphClientError\r\n\t */\r\n\tpublic constructor(message?: string) {\r\n\t\tsuper(message);\r\n\t\tObject.setPrototypeOf(this, GraphClientError.prototype);\r\n\t}\r\n}\r\n","/**\r\n * -------------------------------------------------------------------------------------------\r\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\r\n * See License in the project root for license information.\r\n * -------------------------------------------------------------------------------------------\r\n */\r\n\r\n/**\r\n * @module GraphRequestUtil\r\n */\r\nimport { GRAPH_URLS } from \"./Constants\";\r\nimport { GraphClientError } from \"./GraphClientError\";\r\n/**\r\n * To hold list of OData query params\r\n */\r\nexport const oDataQueryNames = [\"$select\", \"$expand\", \"$orderby\", \"$filter\", \"$top\", \"$skip\", \"$skipToken\", \"$count\"];\r\n\r\n/**\r\n * To construct the URL by appending the segments with \"/\"\r\n * @param {string[]} urlSegments - The array of strings\r\n * @returns The constructed URL string\r\n */\r\nexport const urlJoin = (urlSegments: string[]): string => {\r\n\tconst removePostSlash = (s) => s.replace(/\\/+$/, \"\");\r\n\tconst removePreSlash = (s) => s.replace(/^\\/+/, \"\");\r\n\tconst joiner = (pre, cur) => [removePostSlash(pre), removePreSlash(cur)].join(\"/\");\r\n\tconst parts = Array.prototype.slice.call(urlSegments);\r\n\treturn parts.reduce(joiner);\r\n};\r\n\r\n/**\r\n * Serializes the content\r\n * @param {any} content - The content value that needs to be serialized\r\n * @returns The serialized content\r\n *\r\n * Note:\r\n * This conversion is required due to the following reasons:\r\n * Body parameter of Request method of isomorphic-fetch only accepts Blob, ArrayBuffer, FormData, TypedArrays string.\r\n * Node.js platform does not support Blob, FormData. Javascript File object inherits from Blob so it is also not supported in node. Therefore content of type Blob, File, FormData will only come from browsers.\r\n * Parallel to ArrayBuffer in javascript, node provides Buffer interface. Node's Buffer is able to send the arbitrary binary data to the server successfully for both Browser and Node platform. Whereas sending binary data via ArrayBuffer or TypedArrays was only possible using Browser. To support both Node and Browser, `serializeContent` converts TypedArrays or ArrayBuffer to `Node Buffer`.\r\n * If the data received is in JSON format, `serializeContent` converts the JSON to string.\r\n */\r\n\r\nexport const serializeContent = (content: any): any => {\r\n\tconst className: string = content && content.constructor && content.constructor.name;\r\n\tif (className === \"Buffer\" || className === \"Blob\" || className === \"File\" || className === \"FormData\" || typeof content === \"string\") {\r\n\t\treturn content;\r\n\t}\r\n\tif (className === \"ArrayBuffer\") {\r\n\t\tcontent = Buffer.from(content);\r\n\t} else if (className === \"Int8Array\" || className === \"Int16Array\" || className === \"Int32Array\" || className === \"Uint8Array\" || className === \"Uint16Array\" || className === \"Uint32Array\" || className === \"Uint8ClampedArray\" || className === \"Float32Array\" || className === \"Float64Array\" || className === \"DataView\") {\r\n\t\tcontent = Buffer.from(content.buffer);\r\n\t} else {\r\n\t\ttry {\r\n\t\t\tcontent = JSON.stringify(content);\r\n\t\t} catch (error) {\r\n\t\t\tthrow new Error(\"Unable to stringify the content\");\r\n\t\t}\r\n\t}\r\n\treturn content;\r\n};\r\n\r\n/**\r\n * Checks if the url is one of the service root endpoints for Microsoft Graph and Graph Explorer.\r\n * @param {string} url - The url to be verified\r\n * @returns {boolean} - Returns true if the url is a Graph URL\r\n */\r\nexport const isGraphURL = (url: string): boolean => {\r\n\treturn isValidEndpoint(url);\r\n};\r\n\r\n/**\r\n * Checks if the url is for one of the custom hosts provided during client initialization\r\n * @param {string} url - The url to be verified\r\n * @param {Set} customHosts - The url to be verified\r\n * @returns {boolean} - Returns true if the url is a for a custom host\r\n */\r\nexport const isCustomHost = (url: string, customHosts: Set): boolean => {\r\n\tcustomHosts.forEach((host) => isCustomHostValid(host));\r\n\treturn isValidEndpoint(url, customHosts);\r\n};\r\n\r\n/**\r\n * Checks if the url is for one of the provided hosts.\r\n * @param {string} url - The url to be verified\r\n * @param {Set} allowedHosts - A set of hosts.\r\n * @returns {boolean} - Returns true is for one of the provided endpoints.\r\n */\r\nconst isValidEndpoint = (url: string, allowedHosts: Set = GRAPH_URLS): boolean => {\r\n\t// Valid Graph URL pattern - https://graph.microsoft.com/{version}/{resource}?{query-parameters}\r\n\t// Valid Graph URL example - https://graph.microsoft.com/v1.0/\r\n\turl = url.toLowerCase();\r\n\r\n\tif (url.indexOf(\"https://\") !== -1) {\r\n\t\turl = url.replace(\"https://\", \"\");\r\n\r\n\t\t// Find where the host ends\r\n\t\tconst startofPortNoPos = url.indexOf(\":\");\r\n\t\tconst endOfHostStrPos = url.indexOf(\"/\");\r\n\t\tlet hostName = \"\";\r\n\t\tif (endOfHostStrPos !== -1) {\r\n\t\t\tif (startofPortNoPos !== -1 && startofPortNoPos < endOfHostStrPos) {\r\n\t\t\t\thostName = url.substring(0, startofPortNoPos);\r\n\t\t\t\treturn allowedHosts.has(hostName);\r\n\t\t\t}\r\n\t\t\t// Parse out the host\r\n\t\t\thostName = url.substring(0, endOfHostStrPos);\r\n\t\t\treturn allowedHosts.has(hostName);\r\n\t\t}\r\n\t}\r\n\r\n\treturn false;\r\n};\r\n\r\n/**\r\n * Throws error if the string is not a valid host/hostname and contains other url parts.\r\n * @param {string} host - The host to be verified\r\n */\r\nconst isCustomHostValid = (host: string) => {\r\n\tif (host.indexOf(\"/\") !== -1) {\r\n\t\tthrow new GraphClientError(\"Please add only hosts or hostnames to the CustomHosts config. If the url is `http://example.com:3000/`, host is `example:3000`\");\r\n\t}\r\n};\r\n","/**\r\n * -------------------------------------------------------------------------------------------\r\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\r\n * See License in the project root for license information.\r\n * -------------------------------------------------------------------------------------------\r\n */\r\n\r\n/**\r\n * @module MiddlewareControl\r\n */\r\n\r\nimport { MiddlewareOptions } from \"./options/IMiddlewareOptions\";\r\n\r\n/**\r\n * @class\r\n * Class representing MiddlewareControl\r\n */\r\nexport class MiddlewareControl {\r\n\t/**\r\n\t * @private\r\n\t * A member holding map of MiddlewareOptions\r\n\t */\r\n\tprivate middlewareOptions: Map;\r\n\r\n\t/**\r\n\t * @public\r\n\t * @constructor\r\n\t * Creates an instance of MiddlewareControl\r\n\t * @param {MiddlewareOptions[]} [middlewareOptions = []] - The array of middlewareOptions\r\n\t * @returns The instance of MiddlewareControl\r\n\t */\r\n\tpublic constructor(middlewareOptions: MiddlewareOptions[] = []) {\r\n\t\tthis.middlewareOptions = new Map();\r\n\t\tfor (const option of middlewareOptions) {\r\n\t\t\tconst fn = option.constructor;\r\n\t\t\tthis.middlewareOptions.set(fn, option);\r\n\t\t}\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * To get the middleware option using the class of the option\r\n\t * @param {Function} fn - The class of the strongly typed option class\r\n\t * @returns The middleware option\r\n\t * @example\r\n\t * // if you wanted to return the middleware option associated with this class (MiddlewareControl)\r\n\t * // call this function like this:\r\n\t * getMiddlewareOptions(MiddlewareControl)\r\n\t */\r\n\tpublic getMiddlewareOptions(fn: Function): MiddlewareOptions {\r\n\t\treturn this.middlewareOptions.get(fn);\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * To set the middleware options using the class of the option\r\n\t * @param {Function} fn - The class of the strongly typed option class\r\n\t * @param {MiddlewareOptions} option - The strongly typed middleware option\r\n\t * @returns nothing\r\n\t */\r\n\tpublic setMiddlewareOptions(fn: Function, option: MiddlewareOptions): void {\r\n\t\tthis.middlewareOptions.set(fn, option);\r\n\t}\r\n}\r\n","/**\r\n * -------------------------------------------------------------------------------------------\r\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\r\n * See License in the project root for license information.\r\n * -------------------------------------------------------------------------------------------\r\n */\r\n\r\n/**\r\n * @module AuthenticationHandlerOptions\r\n */\r\n\r\nimport { AuthenticationProvider } from \"../../IAuthenticationProvider\";\r\nimport { AuthenticationProviderOptions } from \"../../IAuthenticationProviderOptions\";\r\nimport { MiddlewareOptions } from \"./IMiddlewareOptions\";\r\n\r\n/**\r\n * @class\r\n * @implements MiddlewareOptions\r\n * Class representing AuthenticationHandlerOptions\r\n */\r\nexport class AuthenticationHandlerOptions implements MiddlewareOptions {\r\n\t/**\r\n\t * @public\r\n\t * A member holding an instance of an authentication provider\r\n\t */\r\n\tpublic authenticationProvider: AuthenticationProvider;\r\n\r\n\t/**\r\n\t * @public\r\n\t * A member holding an instance of authentication provider options\r\n\t */\r\n\tpublic authenticationProviderOptions: AuthenticationProviderOptions;\r\n\r\n\t/**\r\n\t * @public\r\n\t * @constructor\r\n\t * To create an instance of AuthenticationHandlerOptions\r\n\t * @param {AuthenticationProvider} [authenticationProvider] - The authentication provider instance\r\n\t * @param {AuthenticationProviderOptions} [authenticationProviderOptions] - The authentication provider options instance\r\n\t * @returns An instance of AuthenticationHandlerOptions\r\n\t */\r\n\tpublic constructor(authenticationProvider?: AuthenticationProvider, authenticationProviderOptions?: AuthenticationProviderOptions) {\r\n\t\tthis.authenticationProvider = authenticationProvider;\r\n\t\tthis.authenticationProviderOptions = authenticationProviderOptions;\r\n\t}\r\n}\r\n","/**\r\n * -------------------------------------------------------------------------------------------\r\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\r\n * See License in the project root for license information.\r\n * -------------------------------------------------------------------------------------------\r\n */\r\n\r\n/**\r\n * @module AuthenticationHandler\r\n */\r\n\r\nimport { isCustomHost, isGraphURL } from \"../GraphRequestUtil\";\r\nimport { AuthenticationProvider } from \"../IAuthenticationProvider\";\r\nimport { AuthenticationProviderOptions } from \"../IAuthenticationProviderOptions\";\r\nimport { Context } from \"../IContext\";\r\nimport { Middleware } from \"./IMiddleware\";\r\nimport { MiddlewareControl } from \"./MiddlewareControl\";\r\nimport { appendRequestHeader } from \"./MiddlewareUtil\";\r\nimport { AuthenticationHandlerOptions } from \"./options/AuthenticationHandlerOptions\";\r\nimport { FeatureUsageFlag, TelemetryHandlerOptions } from \"./options/TelemetryHandlerOptions\";\r\n\r\n/**\r\n * @class\r\n * @implements Middleware\r\n * Class representing AuthenticationHandler\r\n */\r\nexport class AuthenticationHandler implements Middleware {\r\n\t/**\r\n\t * @private\r\n\t * A member representing the authorization header name\r\n\t */\r\n\tprivate static AUTHORIZATION_HEADER = \"Authorization\";\r\n\r\n\t/**\r\n\t * @private\r\n\t * A member to hold an AuthenticationProvider instance\r\n\t */\r\n\tprivate authenticationProvider: AuthenticationProvider;\r\n\r\n\t/**\r\n\t * @private\r\n\t * A member to hold next middleware in the middleware chain\r\n\t */\r\n\tprivate nextMiddleware: Middleware;\r\n\r\n\t/**\r\n\t * @public\r\n\t * @constructor\r\n\t * Creates an instance of AuthenticationHandler\r\n\t * @param {AuthenticationProvider} authenticationProvider - The authentication provider for the authentication handler\r\n\t */\r\n\tpublic constructor(authenticationProvider: AuthenticationProvider) {\r\n\t\tthis.authenticationProvider = authenticationProvider;\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * @async\r\n\t * To execute the current middleware\r\n\t * @param {Context} context - The context object of the request\r\n\t * @returns A Promise that resolves to nothing\r\n\t */\r\n\tpublic async execute(context: Context): Promise {\r\n\t\tconst url = typeof context.request === \"string\" ? context.request : context.request.url;\r\n\t\tif (isGraphURL(url) || (context.customHosts && isCustomHost(url, context.customHosts))) {\r\n\t\t\tlet options: AuthenticationHandlerOptions;\r\n\t\t\tif (context.middlewareControl instanceof MiddlewareControl) {\r\n\t\t\t\toptions = context.middlewareControl.getMiddlewareOptions(AuthenticationHandlerOptions) as AuthenticationHandlerOptions;\r\n\t\t\t}\r\n\t\t\tlet authenticationProvider: AuthenticationProvider;\r\n\t\t\tlet authenticationProviderOptions: AuthenticationProviderOptions;\r\n\t\t\tif (options) {\r\n\t\t\t\tauthenticationProvider = options.authenticationProvider;\r\n\t\t\t\tauthenticationProviderOptions = options.authenticationProviderOptions;\r\n\t\t\t}\r\n\t\t\tif (!authenticationProvider) {\r\n\t\t\t\tauthenticationProvider = this.authenticationProvider;\r\n\t\t\t}\r\n\t\t\tconst token: string = await authenticationProvider.getAccessToken(authenticationProviderOptions);\r\n\t\t\tconst bearerKey = `Bearer ${token}`;\r\n\t\t\tappendRequestHeader(context.request, context.options, AuthenticationHandler.AUTHORIZATION_HEADER, bearerKey);\r\n\t\t\tTelemetryHandlerOptions.updateFeatureUsageFlag(context, FeatureUsageFlag.AUTHENTICATION_HANDLER_ENABLED);\r\n\t\t} else {\r\n\t\t\tif (context.options.headers) {\r\n\t\t\t\tdelete context.options.headers[AuthenticationHandler.AUTHORIZATION_HEADER];\r\n\t\t\t}\r\n\t\t}\r\n\t\treturn await this.nextMiddleware.execute(context);\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * To set the next middleware in the chain\r\n\t * @param {Middleware} next - The middleware instance\r\n\t * @returns Nothing\r\n\t */\r\n\tpublic setNext(next: Middleware): void {\r\n\t\tthis.nextMiddleware = next;\r\n\t}\r\n}\r\n","/**\r\n * -------------------------------------------------------------------------------------------\r\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\r\n * See License in the project root for license information.\r\n * -------------------------------------------------------------------------------------------\r\n */\r\n\r\n/**\r\n * @module HTTPMessageHandler\r\n */\r\n\r\nimport { Context } from \"../IContext\";\r\nimport { Middleware } from \"./IMiddleware\";\r\n\r\n/**\r\n * @class\r\n * @implements Middleware\r\n * Class for HTTPMessageHandler\r\n */\r\nexport class HTTPMessageHandler implements Middleware {\r\n\t/**\r\n\t * @public\r\n\t * @async\r\n\t * To execute the current middleware\r\n\t * @param {Context} context - The request context object\r\n\t * @returns A promise that resolves to nothing\r\n\t */\r\n\tpublic async execute(context: Context): Promise {\r\n\t\tcontext.response = await fetch(context.request, context.options);\r\n\t}\r\n}\r\n","/**\r\n * -------------------------------------------------------------------------------------------\r\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\r\n * See License in the project root for license information.\r\n * -------------------------------------------------------------------------------------------\r\n */\r\n\r\n/**\r\n * @module RetryHandlerOptions\r\n */\r\n\r\nimport { FetchOptions } from \"../../IFetchOptions\";\r\nimport { MiddlewareOptions } from \"./IMiddlewareOptions\";\r\n\r\n/**\r\n * @type\r\n * A type declaration for shouldRetry callback\r\n */\r\nexport type ShouldRetry = (delay: number, attempt: number, request: RequestInfo, options: FetchOptions | undefined, response: Response) => boolean;\r\n\r\n/**\r\n * @class\r\n * @implements MiddlewareOptions\r\n * Class for RetryHandlerOptions\r\n */\r\n\r\nexport class RetryHandlerOptions implements MiddlewareOptions {\r\n\t/**\r\n\t * @private\r\n\t * @static\r\n\t * A member holding default delay value in seconds\r\n\t */\r\n\tprivate static DEFAULT_DELAY = 3;\r\n\r\n\t/**\r\n\t * @private\r\n\t * @static\r\n\t * A member holding default maxRetries value\r\n\t */\r\n\tprivate static DEFAULT_MAX_RETRIES = 3;\r\n\r\n\t/**\r\n\t * @private\r\n\t * @static\r\n\t * A member holding maximum delay value in seconds\r\n\t */\r\n\tprivate static MAX_DELAY = 180;\r\n\r\n\t/**\r\n\t * @private\r\n\t * @static\r\n\t * A member holding maximum maxRetries value\r\n\t */\r\n\tprivate static MAX_MAX_RETRIES = 10;\r\n\r\n\t/**\r\n\t * @public\r\n\t * A member holding delay value in seconds\r\n\t */\r\n\tpublic delay: number;\r\n\r\n\t/**\r\n\t * @public\r\n\t * A member holding maxRetries value\r\n\t */\r\n\tpublic maxRetries: number;\r\n\r\n\t/**\r\n\t * @public\r\n\t * A member holding shouldRetry callback\r\n\t */\r\n\tpublic shouldRetry: ShouldRetry;\r\n\r\n\t/**\r\n\t * @private\r\n\t * A member holding default shouldRetry callback\r\n\t */\r\n\tprivate static defaultShouldRetry: ShouldRetry = () => true;\r\n\r\n\t/**\r\n\t * @public\r\n\t * @constructor\r\n\t * To create an instance of RetryHandlerOptions\r\n\t * @param {number} [delay = RetryHandlerOptions.DEFAULT_DELAY] - The delay value in seconds\r\n\t * @param {number} [maxRetries = RetryHandlerOptions.DEFAULT_MAX_RETRIES] - The maxRetries value\r\n\t * @param {ShouldRetry} [shouldRetry = RetryHandlerOptions.DEFAULT_SHOULD_RETRY] - The shouldRetry callback function\r\n\t * @returns An instance of RetryHandlerOptions\r\n\t */\r\n\tpublic constructor(delay: number = RetryHandlerOptions.DEFAULT_DELAY, maxRetries: number = RetryHandlerOptions.DEFAULT_MAX_RETRIES, shouldRetry: ShouldRetry = RetryHandlerOptions.defaultShouldRetry) {\r\n\t\tif (delay > RetryHandlerOptions.MAX_DELAY && maxRetries > RetryHandlerOptions.MAX_MAX_RETRIES) {\r\n\t\t\tconst error = new Error(`Delay and MaxRetries should not be more than ${RetryHandlerOptions.MAX_DELAY} and ${RetryHandlerOptions.MAX_MAX_RETRIES}`);\r\n\t\t\terror.name = \"MaxLimitExceeded\";\r\n\t\t\tthrow error;\r\n\t\t} else if (delay > RetryHandlerOptions.MAX_DELAY) {\r\n\t\t\tconst error = new Error(`Delay should not be more than ${RetryHandlerOptions.MAX_DELAY}`);\r\n\t\t\terror.name = \"MaxLimitExceeded\";\r\n\t\t\tthrow error;\r\n\t\t} else if (maxRetries > RetryHandlerOptions.MAX_MAX_RETRIES) {\r\n\t\t\tconst error = new Error(`MaxRetries should not be more than ${RetryHandlerOptions.MAX_MAX_RETRIES}`);\r\n\t\t\terror.name = \"MaxLimitExceeded\";\r\n\t\t\tthrow error;\r\n\t\t} else if (delay < 0 && maxRetries < 0) {\r\n\t\t\tconst error = new Error(`Delay and MaxRetries should not be negative`);\r\n\t\t\terror.name = \"MinExpectationNotMet\";\r\n\t\t\tthrow error;\r\n\t\t} else if (delay < 0) {\r\n\t\t\tconst error = new Error(`Delay should not be negative`);\r\n\t\t\terror.name = \"MinExpectationNotMet\";\r\n\t\t\tthrow error;\r\n\t\t} else if (maxRetries < 0) {\r\n\t\t\tconst error = new Error(`MaxRetries should not be negative`);\r\n\t\t\terror.name = \"MinExpectationNotMet\";\r\n\t\t\tthrow error;\r\n\t\t}\r\n\t\tthis.delay = Math.min(delay, RetryHandlerOptions.MAX_DELAY);\r\n\t\tthis.maxRetries = Math.min(maxRetries, RetryHandlerOptions.MAX_MAX_RETRIES);\r\n\t\tthis.shouldRetry = shouldRetry;\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * To get the maximum delay\r\n\t * @returns A maximum delay\r\n\t */\r\n\tpublic getMaxDelay(): number {\r\n\t\treturn RetryHandlerOptions.MAX_DELAY;\r\n\t}\r\n}\r\n","/**\r\n * -------------------------------------------------------------------------------------------\r\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\r\n * See License in the project root for license information.\r\n * -------------------------------------------------------------------------------------------\r\n */\r\n\r\n/**\r\n * @module RetryHandler\r\n */\r\n\r\nimport { Context } from \"../IContext\";\r\nimport { FetchOptions } from \"../IFetchOptions\";\r\nimport { RequestMethod } from \"../RequestMethod\";\r\nimport { Middleware } from \"./IMiddleware\";\r\nimport { MiddlewareControl } from \"./MiddlewareControl\";\r\nimport { getRequestHeader, setRequestHeader } from \"./MiddlewareUtil\";\r\nimport { RetryHandlerOptions } from \"./options/RetryHandlerOptions\";\r\nimport { FeatureUsageFlag, TelemetryHandlerOptions } from \"./options/TelemetryHandlerOptions\";\r\n\r\n/**\r\n * @class\r\n * @implements Middleware\r\n * Class for RetryHandler\r\n */\r\nexport class RetryHandler implements Middleware {\r\n\t/**\r\n\t * @private\r\n\t * @static\r\n\t * A list of status codes that needs to be retried\r\n\t */\r\n\tprivate static RETRY_STATUS_CODES: number[] = [\r\n\t\t429, // Too many requests\r\n\t\t503, // Service unavailable\r\n\t\t504, // Gateway timeout\r\n\t];\r\n\r\n\t/**\r\n\t * @private\r\n\t * @static\r\n\t * A member holding the name of retry attempt header\r\n\t */\r\n\tprivate static RETRY_ATTEMPT_HEADER = \"Retry-Attempt\";\r\n\r\n\t/**\r\n\t * @private\r\n\t * @static\r\n\t * A member holding the name of retry after header\r\n\t */\r\n\tprivate static RETRY_AFTER_HEADER = \"Retry-After\";\r\n\r\n\t/**\r\n\t * @private\r\n\t * A member to hold next middleware in the middleware chain\r\n\t */\r\n\tprivate nextMiddleware: Middleware;\r\n\r\n\t/**\r\n\t * @private\r\n\t * A member holding the retry handler options\r\n\t */\r\n\tprivate options: RetryHandlerOptions;\r\n\r\n\t/**\r\n\t * @public\r\n\t * @constructor\r\n\t * To create an instance of RetryHandler\r\n\t * @param {RetryHandlerOptions} [options = new RetryHandlerOptions()] - The retry handler options value\r\n\t * @returns An instance of RetryHandler\r\n\t */\r\n\tpublic constructor(options: RetryHandlerOptions = new RetryHandlerOptions()) {\r\n\t\tthis.options = options;\r\n\t}\r\n\r\n\t/**\r\n\t *\r\n\t * @private\r\n\t * To check whether the response has the retry status code\r\n\t * @param {Response} response - The response object\r\n\t * @returns Whether the response has retry status code or not\r\n\t */\r\n\tprivate isRetry(response: Response): boolean {\r\n\t\treturn RetryHandler.RETRY_STATUS_CODES.indexOf(response.status) !== -1;\r\n\t}\r\n\r\n\t/**\r\n\t * @private\r\n\t * To check whether the payload is buffered or not\r\n\t * @param {RequestInfo} request - The url string or the request object value\r\n\t * @param {FetchOptions} options - The options of a request\r\n\t * @returns Whether the payload is buffered or not\r\n\t */\r\n\tprivate isBuffered(request: RequestInfo, options: FetchOptions | undefined): boolean {\r\n\t\tconst method = typeof request === \"string\" ? options.method : (request as Request).method;\r\n\t\tconst isPutPatchOrPost: boolean = method === RequestMethod.PUT || method === RequestMethod.PATCH || method === RequestMethod.POST;\r\n\t\tif (isPutPatchOrPost) {\r\n\t\t\tconst isStream = getRequestHeader(request, options, \"Content-Type\") === \"application/octet-stream\";\r\n\t\t\tif (isStream) {\r\n\t\t\t\treturn false;\r\n\t\t\t}\r\n\t\t}\r\n\t\treturn true;\r\n\t}\r\n\r\n\t/**\r\n\t * @private\r\n\t * To get the delay for a retry\r\n\t * @param {Response} response - The response object\r\n\t * @param {number} retryAttempts - The current attempt count\r\n\t * @param {number} delay - The delay value in seconds\r\n\t * @returns A delay for a retry\r\n\t */\r\n\tprivate getDelay(response: Response, retryAttempts: number, delay: number): number {\r\n\t\tconst getRandomness = () => Number(Math.random().toFixed(3));\r\n\t\tconst retryAfter = response.headers !== undefined ? response.headers.get(RetryHandler.RETRY_AFTER_HEADER) : null;\r\n\t\tlet newDelay: number;\r\n\t\tif (retryAfter !== null) {\r\n\t\t\tif (Number.isNaN(Number(retryAfter))) {\r\n\t\t\t\tnewDelay = Math.round((new Date(retryAfter).getTime() - Date.now()) / 1000);\r\n\t\t\t} else {\r\n\t\t\t\tnewDelay = Number(retryAfter);\r\n\t\t\t}\r\n\t\t} else {\r\n\t\t\t// Adding randomness to avoid retrying at a same\r\n\t\t\tnewDelay = retryAttempts >= 2 ? this.getExponentialBackOffTime(retryAttempts) + delay + getRandomness() : delay + getRandomness();\r\n\t\t}\r\n\t\treturn Math.min(newDelay, this.options.getMaxDelay() + getRandomness());\r\n\t}\r\n\r\n\t/**\r\n\t * @private\r\n\t * To get an exponential back off value\r\n\t * @param {number} attempts - The current attempt count\r\n\t * @returns An exponential back off value\r\n\t */\r\n\tprivate getExponentialBackOffTime(attempts: number): number {\r\n\t\treturn Math.round((1 / 2) * (2 ** attempts - 1));\r\n\t}\r\n\r\n\t/**\r\n\t * @private\r\n\t * @async\r\n\t * To add delay for the execution\r\n\t * @param {number} delaySeconds - The delay value in seconds\r\n\t * @returns Nothing\r\n\t */\r\n\tprivate async sleep(delaySeconds: number): Promise {\r\n\t\tconst delayMilliseconds = delaySeconds * 1000;\r\n\t\treturn new Promise((resolve) => setTimeout(resolve, delayMilliseconds));\r\n\t}\r\n\r\n\tprivate getOptions(context: Context): RetryHandlerOptions {\r\n\t\tlet options: RetryHandlerOptions;\r\n\t\tif (context.middlewareControl instanceof MiddlewareControl) {\r\n\t\t\toptions = context.middlewareControl.getMiddlewareOptions(this.options.constructor) as RetryHandlerOptions;\r\n\t\t}\r\n\t\tif (typeof options === \"undefined\") {\r\n\t\t\toptions = Object.assign(new RetryHandlerOptions(), this.options);\r\n\t\t}\r\n\t\treturn options;\r\n\t}\r\n\r\n\t/**\r\n\t * @private\r\n\t * @async\r\n\t * To execute the middleware with retries\r\n\t * @param {Context} context - The context object\r\n\t * @param {number} retryAttempts - The current attempt count\r\n\t * @param {RetryHandlerOptions} options - The retry middleware options instance\r\n\t * @returns A Promise that resolves to nothing\r\n\t */\r\n\tprivate async executeWithRetry(context: Context, retryAttempts: number, options: RetryHandlerOptions): Promise {\r\n\t\tawait this.nextMiddleware.execute(context);\r\n\t\tif (retryAttempts < options.maxRetries && this.isRetry(context.response) && this.isBuffered(context.request, context.options) && options.shouldRetry(options.delay, retryAttempts, context.request, context.options, context.response)) {\r\n\t\t\t++retryAttempts;\r\n\t\t\tsetRequestHeader(context.request, context.options, RetryHandler.RETRY_ATTEMPT_HEADER, retryAttempts.toString());\r\n\t\t\tconst delay = this.getDelay(context.response, retryAttempts, options.delay);\r\n\t\t\tawait this.sleep(delay);\r\n\t\t\treturn await this.executeWithRetry(context, retryAttempts, options);\r\n\t\t} else {\r\n\t\t\treturn;\r\n\t\t}\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * @async\r\n\t * To execute the current middleware\r\n\t * @param {Context} context - The context object of the request\r\n\t * @returns A Promise that resolves to nothing\r\n\t */\r\n\tpublic async execute(context: Context): Promise {\r\n\t\tconst retryAttempts = 0;\r\n\t\tconst options: RetryHandlerOptions = this.getOptions(context);\r\n\t\tTelemetryHandlerOptions.updateFeatureUsageFlag(context, FeatureUsageFlag.RETRY_HANDLER_ENABLED);\r\n\t\treturn await this.executeWithRetry(context, retryAttempts, options);\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * To set the next middleware in the chain\r\n\t * @param {Middleware} next - The middleware instance\r\n\t * @returns Nothing\r\n\t */\r\n\tpublic setNext(next: Middleware): void {\r\n\t\tthis.nextMiddleware = next;\r\n\t}\r\n}\r\n","/**\r\n * -------------------------------------------------------------------------------------------\r\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\r\n * See License in the project root for license information.\r\n * -------------------------------------------------------------------------------------------\r\n */\r\n\r\n/**\r\n * @module RedirectHandlerOptions\r\n */\r\n\r\nimport { MiddlewareOptions } from \"./IMiddlewareOptions\";\r\n\r\n/**\r\n * @type\r\n * A type declaration for shouldRetry callback\r\n */\r\nexport type ShouldRedirect = (response: Response) => boolean;\r\n\r\n/**\r\n * @class\r\n * @implements MiddlewareOptions\r\n * A class representing RedirectHandlerOptions\r\n */\r\nexport class RedirectHandlerOptions implements MiddlewareOptions {\r\n\t/**\r\n\t * @private\r\n\t * @static\r\n\t * A member holding default max redirects value\r\n\t */\r\n\tprivate static DEFAULT_MAX_REDIRECTS = 5;\r\n\r\n\t/**\r\n\t * @private\r\n\t * @static\r\n\t * A member holding maximum max redirects value\r\n\t */\r\n\tprivate static MAX_MAX_REDIRECTS = 20;\r\n\r\n\t/**\r\n\t * @public\r\n\t * A member holding max redirects value\r\n\t */\r\n\tpublic maxRedirects: number;\r\n\r\n\t/**\r\n\t * @public\r\n\t * A member holding shouldRedirect callback\r\n\t */\r\n\tpublic shouldRedirect: ShouldRedirect;\r\n\r\n\t/**\r\n\t * @private\r\n\t * A member holding default shouldRedirect callback\r\n\t */\r\n\tprivate static defaultShouldRedirect: ShouldRedirect = () => true;\r\n\r\n\t/**\r\n\t * @public\r\n\t * @constructor\r\n\t * To create an instance of RedirectHandlerOptions\r\n\t * @param {number} [maxRedirects = RedirectHandlerOptions.DEFAULT_MAX_REDIRECTS] - The max redirects value\r\n\t * @param {ShouldRedirect} [shouldRedirect = RedirectHandlerOptions.DEFAULT_SHOULD_RETRY] - The should redirect callback\r\n\t * @returns An instance of RedirectHandlerOptions\r\n\t */\r\n\tpublic constructor(maxRedirects: number = RedirectHandlerOptions.DEFAULT_MAX_REDIRECTS, shouldRedirect: ShouldRedirect = RedirectHandlerOptions.defaultShouldRedirect) {\r\n\t\tif (maxRedirects > RedirectHandlerOptions.MAX_MAX_REDIRECTS) {\r\n\t\t\tconst error = new Error(`MaxRedirects should not be more than ${RedirectHandlerOptions.MAX_MAX_REDIRECTS}`);\r\n\t\t\terror.name = \"MaxLimitExceeded\";\r\n\t\t\tthrow error;\r\n\t\t}\r\n\t\tif (maxRedirects < 0) {\r\n\t\t\tconst error = new Error(`MaxRedirects should not be negative`);\r\n\t\t\terror.name = \"MinExpectationNotMet\";\r\n\t\t\tthrow error;\r\n\t\t}\r\n\t\tthis.maxRedirects = maxRedirects;\r\n\t\tthis.shouldRedirect = shouldRedirect;\r\n\t}\r\n}\r\n","/**\r\n * -------------------------------------------------------------------------------------------\r\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\r\n * See License in the project root for license information.\r\n * -------------------------------------------------------------------------------------------\r\n */\r\n\r\n/**\r\n * @module RedirectHandler\r\n */\r\n\r\nimport { Context } from \"../IContext\";\r\nimport { RequestMethod } from \"../RequestMethod\";\r\nimport { Middleware } from \"./IMiddleware\";\r\nimport { MiddlewareControl } from \"./MiddlewareControl\";\r\nimport { cloneRequestWithNewUrl } from \"./MiddlewareUtil\";\r\nimport { RedirectHandlerOptions } from \"./options/RedirectHandlerOptions\";\r\nimport { FeatureUsageFlag, TelemetryHandlerOptions } from \"./options/TelemetryHandlerOptions\";\r\n\r\n/**\r\n * @class\r\n * Class\r\n * @implements Middleware\r\n * Class representing RedirectHandler\r\n */\r\nexport class RedirectHandler implements Middleware {\r\n\t/**\r\n\t * @private\r\n\t * @static\r\n\t * A member holding the array of redirect status codes\r\n\t */\r\n\tprivate static REDIRECT_STATUS_CODES: number[] = [\r\n\t\t301, // Moved Permanently\r\n\t\t302, // Found\r\n\t\t303, // See Other\r\n\t\t307, // Temporary Permanently\r\n\t\t308, // Moved Permanently\r\n\t];\r\n\r\n\t/**\r\n\t * @private\r\n\t * @static\r\n\t * A member holding SeeOther status code\r\n\t */\r\n\tprivate static STATUS_CODE_SEE_OTHER = 303;\r\n\r\n\t/**\r\n\t * @private\r\n\t * @static\r\n\t * A member holding the name of the location header\r\n\t */\r\n\tprivate static LOCATION_HEADER = \"Location\";\r\n\r\n\t/**\r\n\t * @private\r\n\t * @static\r\n\t * A member representing the authorization header name\r\n\t */\r\n\tprivate static AUTHORIZATION_HEADER = \"Authorization\";\r\n\r\n\t/**\r\n\t * @private\r\n\t * @static\r\n\t * A member holding the manual redirect value\r\n\t */\r\n\tprivate static MANUAL_REDIRECT: RequestRedirect = \"manual\";\r\n\r\n\t/**\r\n\t * @private\r\n\t * A member holding options to customize the handler behavior\r\n\t */\r\n\tprivate options: RedirectHandlerOptions;\r\n\r\n\t/**\r\n\t * @private\r\n\t * A member to hold next middleware in the middleware chain\r\n\t */\r\n\tprivate nextMiddleware: Middleware;\r\n\r\n\t/**\r\n\t * @public\r\n\t * @constructor\r\n\t * To create an instance of RedirectHandler\r\n\t * @param {RedirectHandlerOptions} [options = new RedirectHandlerOptions()] - The redirect handler options instance\r\n\t * @returns An instance of RedirectHandler\r\n\t */\r\n\r\n\tpublic constructor(options: RedirectHandlerOptions = new RedirectHandlerOptions()) {\r\n\t\tthis.options = options;\r\n\t}\r\n\r\n\t/**\r\n\t * @private\r\n\t * To check whether the response has the redirect status code or not\r\n\t * @param {Response} response - The response object\r\n\t * @returns A boolean representing whether the response contains the redirect status code or not\r\n\t */\r\n\tprivate isRedirect(response: Response): boolean {\r\n\t\treturn RedirectHandler.REDIRECT_STATUS_CODES.indexOf(response.status) !== -1;\r\n\t}\r\n\r\n\t/**\r\n\t * @private\r\n\t * To check whether the response has location header or not\r\n\t * @param {Response} response - The response object\r\n\t * @returns A boolean representing the whether the response has location header or not\r\n\t */\r\n\tprivate hasLocationHeader(response: Response): boolean {\r\n\t\treturn response.headers.has(RedirectHandler.LOCATION_HEADER);\r\n\t}\r\n\r\n\t/**\r\n\t * @private\r\n\t * To get the redirect url from location header in response object\r\n\t * @param {Response} response - The response object\r\n\t * @returns A redirect url from location header\r\n\t */\r\n\tprivate getLocationHeader(response: Response): string {\r\n\t\treturn response.headers.get(RedirectHandler.LOCATION_HEADER);\r\n\t}\r\n\r\n\t/**\r\n\t * @private\r\n\t * To check whether the given url is a relative url or not\r\n\t * @param {string} url - The url string value\r\n\t * @returns A boolean representing whether the given url is a relative url or not\r\n\t */\r\n\tprivate isRelativeURL(url: string): boolean {\r\n\t\treturn url.indexOf(\"://\") === -1;\r\n\t}\r\n\r\n\t/**\r\n\t * @private\r\n\t * To check whether the authorization header in the request should be dropped for consequent redirected requests\r\n\t * @param {string} requestUrl - The request url value\r\n\t * @param {string} redirectUrl - The redirect url value\r\n\t * @returns A boolean representing whether the authorization header in the request should be dropped for consequent redirected requests\r\n\t */\r\n\tprivate shouldDropAuthorizationHeader(requestUrl: string, redirectUrl: string): boolean {\r\n\t\tconst schemeHostRegex = /^[A-Za-z].+?:\\/\\/.+?(?=\\/|$)/;\r\n\t\tconst requestMatches: string[] = schemeHostRegex.exec(requestUrl);\r\n\t\tlet requestAuthority: string;\r\n\t\tlet redirectAuthority: string;\r\n\t\tif (requestMatches !== null) {\r\n\t\t\trequestAuthority = requestMatches[0];\r\n\t\t}\r\n\t\tconst redirectMatches: string[] = schemeHostRegex.exec(redirectUrl);\r\n\t\tif (redirectMatches !== null) {\r\n\t\t\tredirectAuthority = redirectMatches[0];\r\n\t\t}\r\n\t\treturn typeof requestAuthority !== \"undefined\" && typeof redirectAuthority !== \"undefined\" && requestAuthority !== redirectAuthority;\r\n\t}\r\n\r\n\t/**\r\n\t * @private\r\n\t * @async\r\n\t * To update a request url with the redirect url\r\n\t * @param {string} redirectUrl - The redirect url value\r\n\t * @param {Context} context - The context object value\r\n\t * @returns Nothing\r\n\t */\r\n\tprivate async updateRequestUrl(redirectUrl: string, context: Context): Promise {\r\n\t\tcontext.request = typeof context.request === \"string\" ? redirectUrl : await cloneRequestWithNewUrl(redirectUrl, context.request as Request);\r\n\t}\r\n\r\n\t/**\r\n\t * @private\r\n\t * To get the options for execution of the middleware\r\n\t * @param {Context} context - The context object\r\n\t * @returns A options for middleware execution\r\n\t */\r\n\tprivate getOptions(context: Context): RedirectHandlerOptions {\r\n\t\tlet options: RedirectHandlerOptions;\r\n\t\tif (context.middlewareControl instanceof MiddlewareControl) {\r\n\t\t\toptions = context.middlewareControl.getMiddlewareOptions(RedirectHandlerOptions) as RedirectHandlerOptions;\r\n\t\t}\r\n\t\tif (typeof options === \"undefined\") {\r\n\t\t\toptions = Object.assign(new RedirectHandlerOptions(), this.options);\r\n\t\t}\r\n\t\treturn options;\r\n\t}\r\n\r\n\t/**\r\n\t * @private\r\n\t * @async\r\n\t * To execute the next middleware and to handle in case of redirect response returned by the server\r\n\t * @param {Context} context - The context object\r\n\t * @param {number} redirectCount - The redirect count value\r\n\t * @param {RedirectHandlerOptions} options - The redirect handler options instance\r\n\t * @returns A promise that resolves to nothing\r\n\t */\r\n\tprivate async executeWithRedirect(context: Context, redirectCount: number, options: RedirectHandlerOptions): Promise {\r\n\t\tawait this.nextMiddleware.execute(context);\r\n\t\tconst response = context.response;\r\n\t\tif (redirectCount < options.maxRedirects && this.isRedirect(response) && this.hasLocationHeader(response) && options.shouldRedirect(response)) {\r\n\t\t\t++redirectCount;\r\n\t\t\tif (response.status === RedirectHandler.STATUS_CODE_SEE_OTHER) {\r\n\t\t\t\tcontext.options.method = RequestMethod.GET;\r\n\t\t\t\tdelete context.options.body;\r\n\t\t\t} else {\r\n\t\t\t\tconst redirectUrl: string = this.getLocationHeader(response);\r\n\t\t\t\tif (!this.isRelativeURL(redirectUrl) && this.shouldDropAuthorizationHeader(response.url, redirectUrl)) {\r\n\t\t\t\t\tdelete context.options.headers[RedirectHandler.AUTHORIZATION_HEADER];\r\n\t\t\t\t}\r\n\t\t\t\tawait this.updateRequestUrl(redirectUrl, context);\r\n\t\t\t}\r\n\t\t\tawait this.executeWithRedirect(context, redirectCount, options);\r\n\t\t} else {\r\n\t\t\treturn;\r\n\t\t}\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * @async\r\n\t * To execute the current middleware\r\n\t * @param {Context} context - The context object of the request\r\n\t * @returns A Promise that resolves to nothing\r\n\t */\r\n\tpublic async execute(context: Context): Promise {\r\n\t\tconst redirectCount = 0;\r\n\t\tconst options = this.getOptions(context);\r\n\t\tcontext.options.redirect = RedirectHandler.MANUAL_REDIRECT;\r\n\t\tTelemetryHandlerOptions.updateFeatureUsageFlag(context, FeatureUsageFlag.REDIRECT_HANDLER_ENABLED);\r\n\t\treturn await this.executeWithRedirect(context, redirectCount, options);\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * To set the next middleware in the chain\r\n\t * @param {Middleware} next - The middleware instance\r\n\t * @returns Nothing\r\n\t */\r\n\tpublic setNext(next: Middleware): void {\r\n\t\tthis.nextMiddleware = next;\r\n\t}\r\n}\r\n","/**\n * -------------------------------------------------------------------------------------------\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\n * See License in the project root for license information.\n * -------------------------------------------------------------------------------------------\n */\n\n// THIS FILE IS AUTO GENERATED\n// ANY CHANGES WILL BE LOST DURING BUILD\n\n/**\n * @module Version\n */\n\nexport const PACKAGE_VERSION = \"3.0.2\";\n","/**\r\n * -------------------------------------------------------------------------------------------\r\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\r\n * See License in the project root for license information.\r\n * -------------------------------------------------------------------------------------------\r\n */\r\n\r\n/**\r\n * @module TelemetryHandler\r\n */\r\nimport { isCustomHost, isGraphURL } from \"../GraphRequestUtil\";\r\nimport { Context } from \"../IContext\";\r\nimport { PACKAGE_VERSION } from \"../Version\";\r\nimport { Middleware } from \"./IMiddleware\";\r\nimport { MiddlewareControl } from \"./MiddlewareControl\";\r\nimport { appendRequestHeader, generateUUID, getRequestHeader, setRequestHeader } from \"./MiddlewareUtil\";\r\nimport { TelemetryHandlerOptions } from \"./options/TelemetryHandlerOptions\";\r\n\r\n/**\r\n * @class\r\n * @implements Middleware\r\n * Class for TelemetryHandler\r\n */\r\nexport class TelemetryHandler implements Middleware {\r\n\t/**\r\n\t * @private\r\n\t * @static\r\n\t * A member holding the name of the client request id header\r\n\t */\r\n\tprivate static CLIENT_REQUEST_ID_HEADER = \"client-request-id\";\r\n\r\n\t/**\r\n\t * @private\r\n\t * @static\r\n\t * A member holding the name of the sdk version header\r\n\t */\r\n\tprivate static SDK_VERSION_HEADER = \"SdkVersion\";\r\n\r\n\t/**\r\n\t * @private\r\n\t * @static\r\n\t * A member holding the language prefix for the sdk version header value\r\n\t */\r\n\tprivate static PRODUCT_NAME = \"graph-js\";\r\n\r\n\t/**\r\n\t * @private\r\n\t * @static\r\n\t * A member holding the key for the feature usage metrics\r\n\t */\r\n\tprivate static FEATURE_USAGE_STRING = \"featureUsage\";\r\n\r\n\t/**\r\n\t * @private\r\n\t * A member to hold next middleware in the middleware chain\r\n\t */\r\n\tprivate nextMiddleware: Middleware;\r\n\r\n\t/**\r\n\t * @public\r\n\t * @async\r\n\t * To execute the current middleware\r\n\t * @param {Context} context - The context object of the request\r\n\t * @returns A Promise that resolves to nothing\r\n\t */\r\n\tpublic async execute(context: Context): Promise {\r\n\t\tconst url = typeof context.request === \"string\" ? context.request : context.request.url;\r\n\t\tif (isGraphURL(url) || (context.customHosts && isCustomHost(url, context.customHosts))) {\r\n\t\t\t// Add telemetry only if the request url is a Graph URL.\r\n\t\t\t// Errors are reported as in issue #265 if headers are present when redirecting to a non Graph URL\r\n\t\t\tlet clientRequestId: string = getRequestHeader(context.request, context.options, TelemetryHandler.CLIENT_REQUEST_ID_HEADER);\r\n\t\t\tif (!clientRequestId) {\r\n\t\t\t\tclientRequestId = generateUUID();\r\n\t\t\t\tsetRequestHeader(context.request, context.options, TelemetryHandler.CLIENT_REQUEST_ID_HEADER, clientRequestId);\r\n\t\t\t}\r\n\t\t\tlet sdkVersionValue = `${TelemetryHandler.PRODUCT_NAME}/${PACKAGE_VERSION}`;\r\n\t\t\tlet options: TelemetryHandlerOptions;\r\n\t\t\tif (context.middlewareControl instanceof MiddlewareControl) {\r\n\t\t\t\toptions = context.middlewareControl.getMiddlewareOptions(TelemetryHandlerOptions) as TelemetryHandlerOptions;\r\n\t\t\t}\r\n\t\t\tif (options) {\r\n\t\t\t\tconst featureUsage: string = options.getFeatureUsage();\r\n\t\t\t\tsdkVersionValue += ` (${TelemetryHandler.FEATURE_USAGE_STRING}=${featureUsage})`;\r\n\t\t\t}\r\n\t\t\tappendRequestHeader(context.request, context.options, TelemetryHandler.SDK_VERSION_HEADER, sdkVersionValue);\r\n\t\t} else {\r\n\t\t\t// Remove telemetry headers if present during redirection.\r\n\t\t\tdelete context.options.headers[TelemetryHandler.CLIENT_REQUEST_ID_HEADER];\r\n\t\t\tdelete context.options.headers[TelemetryHandler.SDK_VERSION_HEADER];\r\n\t\t}\r\n\t\treturn await this.nextMiddleware.execute(context);\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * To set the next middleware in the chain\r\n\t * @param {Middleware} next - The middleware instance\r\n\t * @returns Nothing\r\n\t */\r\n\tpublic setNext(next: Middleware): void {\r\n\t\tthis.nextMiddleware = next;\r\n\t}\r\n}\r\n","/**\r\n * -------------------------------------------------------------------------------------------\r\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\r\n * See License in the project root for license information.\r\n * -------------------------------------------------------------------------------------------\r\n */\r\n\r\n/**\r\n * @module MiddlewareFactory\r\n */\r\n\r\nimport { AuthenticationProvider } from \"../IAuthenticationProvider\";\r\nimport { AuthenticationHandler } from \"./AuthenticationHandler\";\r\nimport { HTTPMessageHandler } from \"./HTTPMessageHandler\";\r\nimport { Middleware } from \"./IMiddleware\";\r\nimport { RedirectHandlerOptions } from \"./options/RedirectHandlerOptions\";\r\nimport { RetryHandlerOptions } from \"./options/RetryHandlerOptions\";\r\nimport { RedirectHandler } from \"./RedirectHandler\";\r\nimport { RetryHandler } from \"./RetryHandler\";\r\nimport { TelemetryHandler } from \"./TelemetryHandler\";\r\n\r\n/**\r\n * @private\r\n * To check whether the environment is node or not\r\n * @returns A boolean representing the environment is node or not\r\n */\r\nconst isNodeEnvironment = (): boolean => {\r\n\treturn typeof process === \"object\" && typeof require === \"function\";\r\n};\r\n\r\n/**\r\n * @class\r\n * Class containing function(s) related to the middleware pipelines.\r\n */\r\nexport class MiddlewareFactory {\r\n\t/**\r\n\t * @public\r\n\t * @static\r\n\t * Returns the default middleware chain an array with the middleware handlers\r\n\t * @param {AuthenticationProvider} authProvider - The authentication provider instance\r\n\t * @returns an array of the middleware handlers of the default middleware chain\r\n\t */\r\n\tpublic static getDefaultMiddlewareChain(authProvider: AuthenticationProvider): Middleware[] {\r\n\t\tconst middleware: Middleware[] = [];\r\n\t\tconst authenticationHandler = new AuthenticationHandler(authProvider);\r\n\t\tconst retryHandler = new RetryHandler(new RetryHandlerOptions());\r\n\t\tconst telemetryHandler = new TelemetryHandler();\r\n\t\tconst httpMessageHandler = new HTTPMessageHandler();\r\n\r\n\t\tmiddleware.push(authenticationHandler);\r\n\t\tmiddleware.push(retryHandler);\r\n\t\tif (isNodeEnvironment()) {\r\n\t\t\tconst redirectHandler = new RedirectHandler(new RedirectHandlerOptions());\r\n\t\t\tmiddleware.push(redirectHandler);\r\n\t\t}\r\n\t\tmiddleware.push(telemetryHandler);\r\n\t\tmiddleware.push(httpMessageHandler);\r\n\r\n\t\treturn middleware;\r\n\t}\r\n}\r\n","/**\r\n * -------------------------------------------------------------------------------------------\r\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\r\n * See License in the project root for license information.\r\n * -------------------------------------------------------------------------------------------\r\n */\r\n\r\n/**\r\n * @module ChaosStrategy\r\n */\r\n\r\n/**\r\n * Strategy used for Testing Handler\r\n * @enum\r\n */\r\nexport enum ChaosStrategy {\r\n\tMANUAL,\r\n\tRANDOM,\r\n}\r\n","/**\r\n * -------------------------------------------------------------------------------------------\r\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\r\n * See License in the project root for license information.\r\n * -------------------------------------------------------------------------------------------\r\n */\r\n\r\n/**\r\n * @module ChaosHandlerOptions\r\n */\r\n\r\nimport { ChaosStrategy } from \"./ChaosStrategy\";\r\nimport { MiddlewareOptions } from \"./IMiddlewareOptions\";\r\n\r\n/**\r\n * Class representing ChaosHandlerOptions\r\n * @class\r\n * Class\r\n * @implements MiddlewareOptions\r\n */\r\nexport class ChaosHandlerOptions implements MiddlewareOptions {\r\n\t/**\r\n\t * Specifies the startegy used for the Testing Handler -> RANDOM/MANUAL\r\n\t *\r\n\t * @public\r\n\t */\r\n\tpublic chaosStrategy: ChaosStrategy;\r\n\r\n\t/**\r\n\t * Status code to be returned in the response\r\n\t *\r\n\t * @public\r\n\t */\r\n\tpublic statusCode: number;\r\n\r\n\t/**\r\n\t * The Message to be returned in the response\r\n\t *\r\n\t * @public\r\n\t */\r\n\tpublic statusMessage: string;\r\n\r\n\t/**\r\n\t * The percentage of randomness/chaos in the handler\r\n\t *\r\n\t * Setting the default value as 10%\r\n\t * @public\r\n\t */\r\n\tpublic chaosPercentage: number;\r\n\r\n\t/**\r\n\t * The response body to be returned in the response\r\n\t *\r\n\t * @public\r\n\t */\r\n\tpublic responseBody: any;\r\n\r\n\t/**\r\n\t * The response headers to be returned in the response\r\n\t *\r\n\t * @public\r\n\t */\r\n\tpublic headers: Headers;\r\n\r\n\t/**\r\n\t * @public\r\n\t * @constructor\r\n\t * To create an instance of Testing Handler Options\r\n\t * @param {ChaosStrategy} chaosStrategy - Specifies the startegy used for the Testing Handler -> RAMDOM/MANUAL\r\n\t * @param {string} statusMessage - The Message to be returned in the response\r\n\t * @param {number?} statusCode - The statusCode to be returned in the response\r\n\t * @param {number?} chaosPercentage - The percentage of randomness/chaos in the handler\r\n\t * @param {any?} responseBody - The response body to be returned in the response\r\n\t * @returns An instance of ChaosHandlerOptions\r\n\t */\r\n\tpublic constructor(chaosStrategy: ChaosStrategy = ChaosStrategy.RANDOM, statusMessage = \"Some error Happened\", statusCode?: number, chaosPercentage?: number, responseBody?: any, headers?: Headers) {\r\n\t\tthis.chaosStrategy = chaosStrategy;\r\n\t\tthis.statusCode = statusCode;\r\n\t\tthis.statusMessage = statusMessage;\r\n\t\tthis.chaosPercentage = chaosPercentage !== undefined ? chaosPercentage : 10;\r\n\t\tthis.responseBody = responseBody;\r\n\t\tthis.headers = headers;\r\n\t\tif (this.chaosPercentage > 100) {\r\n\t\t\tthrow new Error(\"Error Pecentage can not be more than 100\");\r\n\t\t}\r\n\t}\r\n}\r\n","/**\r\n * -------------------------------------------------------------------------------------------\r\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\r\n * See License in the project root for license information.\r\n * -------------------------------------------------------------------------------------------\r\n */\r\n\r\n/**\r\n * @enum\r\n * Enum for ResponseType values\r\n * @property {string} ARRAYBUFFER - To download response content as an [ArrayBuffer]{@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer}\r\n * @property {string} BLOB - To download content as a [binary/blob] {@link https://developer.mozilla.org/en-US/docs/Web/API/Blob}\r\n * @property {string} DOCUMENT - This downloads content as a document or stream\r\n * @property {string} JSON - To download response content as a json\r\n * @property {string} STREAM - To download response as a [stream]{@link https://nodejs.org/api/stream.html}\r\n * @property {string} TEXT - For downloading response as a text\r\n */\r\n\r\nexport enum ResponseType {\r\n\tARRAYBUFFER = \"arraybuffer\",\r\n\tBLOB = \"blob\",\r\n\tDOCUMENT = \"document\",\r\n\tJSON = \"json\",\r\n\tRAW = \"raw\",\r\n\tSTREAM = \"stream\",\r\n\tTEXT = \"text\",\r\n}\r\n","/**\r\n * -------------------------------------------------------------------------------------------\r\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\r\n * See License in the project root for license information.\r\n * -------------------------------------------------------------------------------------------\r\n */\r\n\r\n/**\r\n * @module GraphResponseHandler\r\n * References - https://fetch.spec.whatwg.org/#responses\r\n */\r\n\r\nimport { GraphRequestCallback } from \"./IGraphRequestCallback\";\r\nimport { ResponseType } from \"./ResponseType\";\r\n\r\n/**\r\n * @enum\r\n * Enum for document types\r\n * @property {string} TEXT_HTML - The text/html content type\r\n * @property {string} TEXT_XML - The text/xml content type\r\n * @property {string} APPLICATION_XML - The application/xml content type\r\n * @property {string} APPLICATION_XHTML - The application/xhml+xml content type\r\n */\r\nexport enum DocumentType {\r\n\tTEXT_HTML = \"text/html\",\r\n\tTEXT_XML = \"text/xml\",\r\n\tAPPLICATION_XML = \"application/xml\",\r\n\tAPPLICATION_XHTML = \"application/xhtml+xml\",\r\n}\r\n\r\n/**\r\n * @enum\r\n * Enum for Content types\r\n * @property {string} TEXT_PLAIN - The text/plain content type\r\n * @property {string} APPLICATION_JSON - The application/json content type\r\n */\r\n\r\nenum ContentType {\r\n\tTEXT_PLAIN = \"text/plain\",\r\n\tAPPLICATION_JSON = \"application/json\",\r\n}\r\n\r\n/**\r\n * @enum\r\n * Enum for Content type regex\r\n * @property {string} DOCUMENT - The regex to match document content types\r\n * @property {string} IMAGE - The regex to match image content types\r\n */\r\nenum ContentTypeRegexStr {\r\n\tDOCUMENT = \"^(text\\\\/(html|xml))|(application\\\\/(xml|xhtml\\\\+xml))$\",\r\n\tIMAGE = \"^image\\\\/.+\",\r\n}\r\n\r\n/**\r\n * @class\r\n * Class for GraphResponseHandler\r\n */\r\n\r\nexport class GraphResponseHandler {\r\n\t/**\r\n\t * @private\r\n\t * @static\r\n\t * To parse Document response\r\n\t * @param {Response} rawResponse - The response object\r\n\t * @param {DocumentType} type - The type to which the document needs to be parsed\r\n\t * @returns A promise that resolves to a document content\r\n\t */\r\n\tprivate static parseDocumentResponse(rawResponse: Response, type: DocumentType): Promise {\r\n\t\tif (typeof DOMParser !== \"undefined\") {\r\n\t\t\treturn new Promise((resolve, reject) => {\r\n\t\t\t\trawResponse.text().then((xmlString) => {\r\n\t\t\t\t\ttry {\r\n\t\t\t\t\t\tconst parser = new DOMParser();\r\n\t\t\t\t\t\tconst xmlDoc = parser.parseFromString(xmlString, type);\r\n\t\t\t\t\t\tresolve(xmlDoc);\r\n\t\t\t\t\t} catch (error) {\r\n\t\t\t\t\t\treject(error);\r\n\t\t\t\t\t}\r\n\t\t\t\t});\r\n\t\t\t});\r\n\t\t} else {\r\n\t\t\treturn Promise.resolve(rawResponse.body);\r\n\t\t}\r\n\t}\r\n\r\n\t/**\r\n\t * @private\r\n\t * @static\r\n\t * @async\r\n\t * To convert the native Response to response content\r\n\t * @param {Response} rawResponse - The response object\r\n\t * @param {ResponseType} [responseType] - The response type value\r\n\t * @returns A promise that resolves to the converted response content\r\n\t */\r\n\tprivate static async convertResponse(rawResponse: Response, responseType?: ResponseType): Promise {\r\n\t\tif (rawResponse.status === 204) {\r\n\t\t\t// NO CONTENT\r\n\t\t\treturn Promise.resolve();\r\n\t\t}\r\n\t\tlet responseValue: any;\r\n\t\tconst contentType = rawResponse.headers.get(\"Content-type\");\r\n\t\tswitch (responseType) {\r\n\t\t\tcase ResponseType.ARRAYBUFFER:\r\n\t\t\t\tresponseValue = await rawResponse.arrayBuffer();\r\n\t\t\t\tbreak;\r\n\t\t\tcase ResponseType.BLOB:\r\n\t\t\t\tresponseValue = await rawResponse.blob();\r\n\t\t\t\tbreak;\r\n\t\t\tcase ResponseType.DOCUMENT:\r\n\t\t\t\tresponseValue = await GraphResponseHandler.parseDocumentResponse(rawResponse, DocumentType.TEXT_XML);\r\n\t\t\t\tbreak;\r\n\t\t\tcase ResponseType.JSON:\r\n\t\t\t\tresponseValue = await rawResponse.json();\r\n\t\t\t\tbreak;\r\n\t\t\tcase ResponseType.STREAM:\r\n\t\t\t\tresponseValue = await Promise.resolve(rawResponse.body);\r\n\t\t\t\tbreak;\r\n\t\t\tcase ResponseType.TEXT:\r\n\t\t\t\tresponseValue = await rawResponse.text();\r\n\t\t\t\tbreak;\r\n\t\t\tdefault:\r\n\t\t\t\tif (contentType !== null) {\r\n\t\t\t\t\tconst mimeType = contentType.split(\";\")[0];\r\n\t\t\t\t\tif (new RegExp(ContentTypeRegexStr.DOCUMENT).test(mimeType)) {\r\n\t\t\t\t\t\tresponseValue = await GraphResponseHandler.parseDocumentResponse(rawResponse, mimeType as DocumentType);\r\n\t\t\t\t\t} else if (new RegExp(ContentTypeRegexStr.IMAGE).test(mimeType)) {\r\n\t\t\t\t\t\tresponseValue = rawResponse.blob();\r\n\t\t\t\t\t} else if (mimeType === ContentType.TEXT_PLAIN) {\r\n\t\t\t\t\t\tresponseValue = await rawResponse.text();\r\n\t\t\t\t\t} else if (mimeType === ContentType.APPLICATION_JSON) {\r\n\t\t\t\t\t\tresponseValue = await rawResponse.json();\r\n\t\t\t\t\t} else {\r\n\t\t\t\t\t\tresponseValue = Promise.resolve(rawResponse.body);\r\n\t\t\t\t\t}\r\n\t\t\t\t} else {\r\n\t\t\t\t\t/**\r\n\t\t\t\t\t * RFC specification {@link https://tools.ietf.org/html/rfc7231#section-3.1.1.5} says:\r\n\t\t\t\t\t * A sender that generates a message containing a payload body SHOULD\r\n\t\t\t\t\t * generate a Content-Type header field in that message unless the\r\n\t\t\t\t\t * intended media type of the enclosed representation is unknown to the\r\n\t\t\t\t\t * sender. If a Content-Type header field is not present, the recipient\r\n\t\t\t\t\t * MAY either assume a media type of \"application/octet-stream\"\r\n\t\t\t\t\t * ([RFC2046], Section 4.5.1) or examine the data to determine its type.\r\n\t\t\t\t\t *\r\n\t\t\t\t\t * So assuming it as a stream type so returning the body.\r\n\t\t\t\t\t */\r\n\t\t\t\t\tresponseValue = Promise.resolve(rawResponse.body);\r\n\t\t\t\t}\r\n\t\t\t\tbreak;\r\n\t\t}\r\n\t\treturn responseValue;\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * @static\r\n\t * @async\r\n\t * To get the parsed response\r\n\t * @param {Response} rawResponse - The response object\r\n\t * @param {ResponseType} [responseType] - The response type value\r\n\t * @param {GraphRequestCallback} [callback] - The graph request callback function\r\n\t * @returns The parsed response\r\n\t */\r\n\tpublic static async getResponse(rawResponse: Response, responseType?: ResponseType, callback?: GraphRequestCallback): Promise {\r\n\t\tif (responseType === ResponseType.RAW) {\r\n\t\t\treturn Promise.resolve(rawResponse);\r\n\t\t} else {\r\n\t\t\tconst response = await GraphResponseHandler.convertResponse(rawResponse, responseType);\r\n\t\t\tif (rawResponse.ok) {\r\n\t\t\t\t// Status Code 2XX\r\n\t\t\t\tif (typeof callback === \"function\") {\r\n\t\t\t\t\tcallback(null, response);\r\n\t\t\t\t} else {\r\n\t\t\t\t\treturn response;\r\n\t\t\t\t}\r\n\t\t\t} else {\r\n\t\t\t\t// NOT OK Response\r\n\t\t\t\tthrow response;\r\n\t\t\t}\r\n\t\t}\r\n\t}\r\n}\r\n","/**\r\n * -------------------------------------------------------------------------------------------\r\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\r\n * See License in the project root for license information.\r\n * -------------------------------------------------------------------------------------------\r\n */\r\n\r\n/**\r\n * @module Range\r\n */\r\n\r\n/**\r\n * @class\r\n * Class representing Range\r\n */\r\nexport class Range {\r\n\t/**\r\n\t * @public\r\n\t * The minimum value of the range\r\n\t */\r\n\tpublic minValue: number;\r\n\r\n\t/**\r\n\t * @public\r\n\t * The maximum value of the range\r\n\t */\r\n\tpublic maxValue: number;\r\n\r\n\t/**\r\n\t * @public\r\n\t * @constructor\r\n\t * Creates a range for given min and max values\r\n\t * @param {number} [minVal = -1] - The minimum value.\r\n\t * @param {number} [maxVal = -1] - The maximum value.\r\n\t * @returns An instance of a Range\r\n\t */\r\n\tpublic constructor(minVal = -1, maxVal = -1) {\r\n\t\tthis.minValue = minVal;\r\n\t\tthis.maxValue = maxVal;\r\n\t}\r\n}\r\n","/**\r\n * -------------------------------------------------------------------------------------------\r\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\r\n * See License in the project root for license information.\r\n * -------------------------------------------------------------------------------------------\r\n */\r\n\r\n/**\r\n * Class representing a successful file upload result\r\n */\r\nexport class UploadResult {\r\n\t/**\r\n\t * @private\r\n\t * Location value looked up in the response header\r\n\t */\r\n\tprivate _location: string;\r\n\r\n\t/**\r\n\t * @private\r\n\t * Response body of the final raw response\r\n\t */\r\n\tprivate _responseBody: unknown;\r\n\r\n\t/**\r\n\t * @public\r\n\t * Get of the location value.\r\n\t * Location value is looked up in the response header\r\n\t */\r\n\tpublic get location(): string {\r\n\t\treturn this._location;\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * Set the location value\r\n\t * Location value is looked up in the response header\r\n\t */\r\n\tpublic set location(location: string) {\r\n\t\tthis._location = location;\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * Get The response body from the completed upload response\r\n\t */\r\n\tpublic get responseBody() {\r\n\t\treturn this._responseBody;\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * Set the response body from the completed upload response\r\n\t */\r\n\tpublic set responseBody(responseBody: unknown) {\r\n\t\tthis._responseBody = responseBody;\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * @param {responseBody} responsebody - The response body from the completed upload response\r\n\t * @param {location} location - The location value from the headers from the completed upload response\r\n\t */\r\n\tpublic constructor(responseBody: unknown, location: string) {\r\n\t\t// Response body or the location parameter can be undefined.\r\n\t\tthis._location = location;\r\n\t\tthis._responseBody = responseBody;\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * @param {responseBody} responseBody - The response body from the completed upload response\r\n\t * @param {responseHeaders} responseHeaders - The headers from the completed upload response\r\n\t */\r\n\tpublic static CreateUploadResult(responseBody?: unknown, responseHeaders?: Headers) {\r\n\t\treturn new UploadResult(responseBody, responseHeaders.get(\"location\"));\r\n\t}\r\n}\r\n","/**\r\n * -------------------------------------------------------------------------------------------\r\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\r\n * See License in the project root for license information.\r\n * -------------------------------------------------------------------------------------------\r\n */\r\n\r\n/**\r\n * @module LargeFileUploadTask\r\n */\r\n\r\nimport { GraphClientError } from \"../GraphClientError\";\r\nimport { GraphResponseHandler } from \"../GraphResponseHandler\";\r\nimport { Client } from \"../index\";\r\nimport { ResponseType } from \"../ResponseType\";\r\nimport { UploadEventHandlers } from \"./FileUploadTask/Interfaces/IUploadEventHandlers\";\r\nimport { Range } from \"./FileUploadTask/Range\";\r\nimport { UploadResult } from \"./FileUploadTask/UploadResult\";\r\n\r\n/**\r\n * @interface\r\n * Signature to representing key value pairs\r\n * @property {[key: string] : string | number} - The Key value pair\r\n */\r\ninterface KeyValuePairObjectStringNumber {\r\n\t[key: string]: string | number;\r\n}\r\n\r\n/**\r\n * @interface\r\n * Signature to represent the resulting response in the status enquiry request\r\n * @property {string} expirationDateTime - The expiration time of the upload session\r\n * @property {string[]} nextExpectedRanges - The ranges expected in next consecutive request in the upload\r\n */\r\ninterface UploadStatusResponse {\r\n\texpirationDateTime: string;\r\n\tnextExpectedRanges: string[];\r\n}\r\n\r\n/**\r\n * @interface\r\n * Signature to define options for upload task\r\n * @property {number} [rangeSize = LargeFileUploadTask.DEFAULT_FILE_SIZE] - Specifies the range chunk size\r\n * @property {UploadEventHandlers} uploadEventHandlers - UploadEventHandlers attached to an upload task\r\n */\r\nexport interface LargeFileUploadTaskOptions {\r\n\trangeSize?: number;\r\n\tuploadEventHandlers?: UploadEventHandlers;\r\n}\r\n\r\n/**\r\n * @interface\r\n * Signature to represent upload session resulting from the session creation in the server\r\n * @property {string} url - The URL to which the file upload is made\r\n * @property {Date} expiry - The expiration of the time of the upload session\r\n */\r\nexport interface LargeFileUploadSession {\r\n\turl: string;\r\n\texpiry: Date;\r\n\tisCancelled?: boolean;\r\n}\r\n\r\n/**\r\n * @type\r\n * Representing the return type of the sliceFile function that is type of the slice of a given range.\r\n */\r\nexport type SliceType = ArrayBuffer | Blob | Uint8Array;\r\n\r\n/**\r\n * @interface\r\n * Signature to define the properties and content of the file in upload task\r\n * @property {ArrayBuffer | File} content - The actual file content\r\n * @property {string} name - Specifies the file name with extension\r\n * @property {number} size - Specifies size of the file\r\n */\r\nexport interface FileObject {\r\n\tcontent: T;\r\n\tname: string;\r\n\tsize: number;\r\n\tsliceFile(range: Range): SliceType | Promise;\r\n}\r\n\r\n/**\r\n * @class\r\n * Class representing LargeFileUploadTask\r\n */\r\nexport class LargeFileUploadTask {\r\n\t/**\r\n\t * @private\r\n\t * Default value for the rangeSize\r\n\t */\r\n\tprivate DEFAULT_FILE_SIZE: number = 5 * 1024 * 1024;\r\n\r\n\t/**\r\n\t * @protected\r\n\t * The GraphClient instance\r\n\t */\r\n\tprotected client: Client;\r\n\r\n\t/**\r\n\t * @protected\r\n\t * The object holding file details\r\n\t */\r\n\tprotected file: FileObject;\r\n\r\n\t/**\r\n\t * @protected\r\n\t * The object holding options for the task\r\n\t */\r\n\tprotected options: LargeFileUploadTaskOptions;\r\n\r\n\t/**\r\n\t * @protected\r\n\t * The object for upload session\r\n\t */\r\n\tprotected uploadSession: LargeFileUploadSession;\r\n\r\n\t/**\r\n\t * @protected\r\n\t * The next range needs to be uploaded\r\n\t */\r\n\tprotected nextRange: Range;\r\n\r\n\t/**\r\n\t * @public\r\n\t * @static\r\n\t * @async\r\n\t * Makes request to the server to create an upload session\r\n\t * @param {Client} client - The GraphClient instance\r\n\t * @param {string} requestUrl - The URL to create the upload session\r\n\t * @param {any} payload - The payload that needs to be sent\r\n\t * @param {KeyValuePairObjectStringNumber} headers - The headers that needs to be sent\r\n\t * @returns The promise that resolves to LargeFileUploadSession\r\n\t */\r\n\tpublic static async createUploadSession(client: Client, requestUrl: string, payload: any, headers: KeyValuePairObjectStringNumber = {}): Promise {\r\n\t\tconst session = await client\r\n\t\t\t.api(requestUrl)\r\n\t\t\t.headers(headers)\r\n\t\t\t.post(payload);\r\n\t\tconst largeFileUploadSession: LargeFileUploadSession = {\r\n\t\t\turl: session.uploadUrl,\r\n\t\t\texpiry: new Date(session.expirationDateTime),\r\n\t\t\tisCancelled: false,\r\n\t\t};\r\n\t\treturn largeFileUploadSession;\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * @constructor\r\n\t * Constructs a LargeFileUploadTask\r\n\t * @param {Client} client - The GraphClient instance\r\n\t * @param {FileObject} file - The FileObject holding details of a file that needs to be uploaded\r\n\t * @param {LargeFileUploadSession} uploadSession - The upload session to which the upload has to be done\r\n\t * @param {LargeFileUploadTaskOptions} options - The upload task options\r\n\t * @returns An instance of LargeFileUploadTask\r\n\t */\r\n\tpublic constructor(client: Client, file: FileObject, uploadSession: LargeFileUploadSession, options: LargeFileUploadTaskOptions = {}) {\r\n\t\tthis.client = client;\r\n\r\n\t\tif (!file.sliceFile) {\r\n\t\t\tthrow new GraphClientError(\"Please pass the FileUpload object, StreamUpload object or any custom implementation of the FileObject interface\");\r\n\t\t} else {\r\n\t\t\tthis.file = file;\r\n\t\t}\r\n\t\tthis.file = file;\r\n\t\tif (!options.rangeSize) {\r\n\t\t\toptions.rangeSize = this.DEFAULT_FILE_SIZE;\r\n\t\t}\r\n\r\n\t\tthis.options = options;\r\n\t\tthis.uploadSession = uploadSession;\r\n\t\tthis.nextRange = new Range(0, this.options.rangeSize - 1);\r\n\t}\r\n\r\n\t/**\r\n\t * @private\r\n\t * Parses given range string to the Range instance\r\n\t * @param {string[]} ranges - The ranges value\r\n\t * @returns The range instance\r\n\t */\r\n\tprivate parseRange(ranges: string[]): Range {\r\n\t\tconst rangeStr = ranges[0];\r\n\t\tif (typeof rangeStr === \"undefined\" || rangeStr === \"\") {\r\n\t\t\treturn new Range();\r\n\t\t}\r\n\t\tconst firstRange = rangeStr.split(\"-\");\r\n\t\tconst minVal = parseInt(firstRange[0], 10);\r\n\t\tlet maxVal = parseInt(firstRange[1], 10);\r\n\t\tif (Number.isNaN(maxVal)) {\r\n\t\t\tmaxVal = this.file.size - 1;\r\n\t\t}\r\n\t\treturn new Range(minVal, maxVal);\r\n\t}\r\n\r\n\t/**\r\n\t * @private\r\n\t * Updates the expiration date and the next range\r\n\t * @param {UploadStatusResponse} response - The response of the upload status\r\n\t * @returns Nothing\r\n\t */\r\n\tprivate updateTaskStatus(response: UploadStatusResponse): void {\r\n\t\tthis.uploadSession.expiry = new Date(response.expirationDateTime);\r\n\t\tthis.nextRange = this.parseRange(response.nextExpectedRanges);\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * Gets next range that needs to be uploaded\r\n\t * @returns The range instance\r\n\t */\r\n\tpublic getNextRange(): Range {\r\n\t\tif (this.nextRange.minValue === -1) {\r\n\t\t\treturn this.nextRange;\r\n\t\t}\r\n\t\tconst minVal = this.nextRange.minValue;\r\n\t\tlet maxValue = minVal + this.options.rangeSize - 1;\r\n\t\tif (maxValue >= this.file.size) {\r\n\t\t\tmaxValue = this.file.size - 1;\r\n\t\t}\r\n\t\treturn new Range(minVal, maxValue);\r\n\t}\r\n\r\n\t/**\r\n\t * @deprecated This function has been moved into FileObject interface.\r\n\t * @public\r\n\t * Slices the file content to the given range\r\n\t * @param {Range} range - The range value\r\n\t * @returns The sliced ArrayBuffer or Blob\r\n\t */\r\n\tpublic sliceFile(range: Range): ArrayBuffer | Blob {\r\n\t\tconsole.warn(\"The LargeFileUploadTask.sliceFile() function has been deprecated and moved into the FileObject interface.\");\r\n\t\tif (this.file.content instanceof ArrayBuffer || this.file.content instanceof Blob || this.file.content instanceof Uint8Array) {\r\n\t\t\treturn this.file.content.slice(range.minValue, range.maxValue + 1);\r\n\t\t}\r\n\t\tthrow new GraphClientError(\"The LargeFileUploadTask.sliceFile() function expects only Blob, ArrayBuffer or Uint8Array file content. Please note that the sliceFile() function is deprecated.\");\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * @async\r\n\t * Uploads file to the server in a sequential order by slicing the file\r\n\t * @returns The promise resolves to uploaded response\r\n\t */\r\n\tpublic async upload(): Promise {\r\n\t\tconst uploadEventHandlers = this.options && this.options.uploadEventHandlers;\r\n\t\twhile (!this.uploadSession.isCancelled) {\r\n\t\t\tconst nextRange = this.getNextRange();\r\n\t\t\tif (nextRange.maxValue === -1) {\r\n\t\t\t\tconst err = new Error(\"Task with which you are trying to upload is already completed, Please check for your uploaded file\");\r\n\t\t\t\terr.name = \"Invalid Session\";\r\n\t\t\t\tthrow err;\r\n\t\t\t}\r\n\t\t\tconst fileSlice = await this.file.sliceFile(nextRange);\r\n\t\t\tconst rawResponse = await this.uploadSliceGetRawResponse(fileSlice, nextRange, this.file.size);\r\n\t\t\tif (!rawResponse) {\r\n\t\t\t\tthrow new GraphClientError(\"Something went wrong! Large file upload slice response is null.\");\r\n\t\t\t}\r\n\r\n\t\t\tconst responseBody = await GraphResponseHandler.getResponse(rawResponse);\r\n\t\t\t/**\r\n\t\t\t * (rawResponse.status === 201) -> This condition is applicable for OneDrive, PrintDocument and Outlook APIs.\r\n\t\t\t * (rawResponse.status === 200 && responseBody.id) -> This additional condition is applicable only for OneDrive API.\r\n\t\t\t */\r\n\t\t\tif (rawResponse.status === 201 || (rawResponse.status === 200 && responseBody.id)) {\r\n\t\t\t\tconst uploadResult = UploadResult.CreateUploadResult(responseBody, rawResponse.headers);\r\n\t\t\t\treturn uploadResult;\r\n\t\t\t}\r\n\r\n\t\t\t/* Handling the API issue where the case of Outlook upload response property -'nextExpectedRanges' is not uniform.\r\n\t\t\t * https://github.com/microsoftgraph/msgraph-sdk-serviceissues/issues/39\r\n\t\t\t */\r\n\t\t\tconst res: UploadStatusResponse = {\r\n\t\t\t\texpirationDateTime: responseBody.expirationDateTime || responseBody.ExpirationDateTime,\r\n\t\t\t\tnextExpectedRanges: responseBody.NextExpectedRanges || responseBody.nextExpectedRanges,\r\n\t\t\t};\r\n\t\t\tthis.updateTaskStatus(res);\r\n\t\t\tif (uploadEventHandlers && uploadEventHandlers.progress) {\r\n\t\t\t\tuploadEventHandlers.progress(nextRange, uploadEventHandlers.extraCallbackParam);\r\n\t\t\t}\r\n\t\t}\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * @async\r\n\t * Uploads given slice to the server\r\n\t * @param {ArrayBuffer | Blob | File} fileSlice - The file slice\r\n\t * @param {Range} range - The range value\r\n\t * @param {number} totalSize - The total size of a complete file\r\n\t * @returns The response body of the upload slice result\r\n\t */\r\n\tpublic async uploadSlice(fileSlice: ArrayBuffer | Blob | File, range: Range, totalSize: number): Promise {\r\n\t\treturn await this.client\r\n\t\t\t.api(this.uploadSession.url)\r\n\t\t\t.headers({\r\n\t\t\t\t\"Content-Length\": `${range.maxValue - range.minValue + 1}`,\r\n\t\t\t\t\"Content-Range\": `bytes ${range.minValue}-${range.maxValue}/${totalSize}`,\r\n\t\t\t\t\"Content-Type\": \"application/octet-stream\",\r\n\t\t\t})\r\n\t\t\t.put(fileSlice);\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * @async\r\n\t * Uploads given slice to the server\r\n\t * @param {unknown} fileSlice - The file slice\r\n\t * @param {Range} range - The range value\r\n\t * @param {number} totalSize - The total size of a complete file\r\n\t * @returns The raw response of the upload slice result\r\n\t */\r\n\tpublic async uploadSliceGetRawResponse(fileSlice: unknown, range: Range, totalSize: number): Promise {\r\n\t\treturn await this.client\r\n\t\t\t.api(this.uploadSession.url)\r\n\t\t\t.headers({\r\n\t\t\t\t\"Content-Length\": `${range.maxValue - range.minValue + 1}`,\r\n\t\t\t\t\"Content-Range\": `bytes ${range.minValue}-${range.maxValue}/${totalSize}`,\r\n\t\t\t\t\"Content-Type\": \"application/octet-stream\",\r\n\t\t\t})\r\n\t\t\t.responseType(ResponseType.RAW)\r\n\t\t\t.put(fileSlice);\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * @async\r\n\t * Deletes upload session in the server\r\n\t * @returns The promise resolves to cancelled response\r\n\t */\r\n\tpublic async cancel(): Promise {\r\n\t\tconst cancelResponse = await this.client\r\n\t\t\t.api(this.uploadSession.url)\r\n\t\t\t.responseType(ResponseType.RAW)\r\n\t\t\t.delete();\r\n\t\tif (cancelResponse.status === 204) {\r\n\t\t\tthis.uploadSession.isCancelled = true;\r\n\t\t}\r\n\t\treturn cancelResponse;\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * @async\r\n\t * Gets status for the upload session\r\n\t * @returns The promise resolves to the status enquiry response\r\n\t */\r\n\tpublic async getStatus(): Promise {\r\n\t\tconst response = await this.client.api(this.uploadSession.url).get();\r\n\t\tthis.updateTaskStatus(response);\r\n\t\treturn response;\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * @async\r\n\t * Resumes upload session and continue uploading the file from the last sent range\r\n\t * @returns The promise resolves to the uploaded response\r\n\t */\r\n\tpublic async resume(): Promise {\r\n\t\tawait this.getStatus();\r\n\t\treturn await this.upload();\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * @async\r\n\t * Get the upload session information\r\n\t * @returns The large file upload session\r\n\t */\r\n\tpublic getUploadSession(): LargeFileUploadSession {\r\n\t\treturn this.uploadSession;\r\n\t}\r\n}\r\n","/**\r\n * -------------------------------------------------------------------------------------------\r\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\r\n * See License in the project root for license information.\r\n * -------------------------------------------------------------------------------------------\r\n */\r\n\r\nimport { GraphClientError } from \"../../../GraphClientError\";\r\nimport { FileObject, SliceType } from \"../../LargeFileUploadTask\";\r\nimport { Range } from \"../Range\";\r\n\r\n/**\r\n * @class\r\n * Class used for creating LargeFileUploadTask fileobject.\r\n * This class accepts files of type ArrayBuffer, Blob, Uint8Array.\r\n */\r\nexport class FileUpload implements FileObject {\r\n\t/**\r\n\t * @public\r\n\t * @constructor\r\n\t * @param {ArrayBuffer | Blob | Uint8Array} content - The file to be uploaded\r\n\t * @param {string} name - The name of the file to be uploaded\r\n\t * @param {number} size - The total size of the file to be uploaded\r\n\t * @returns An instance of the FileUpload class\r\n\t */\r\n\tpublic constructor(public content: ArrayBuffer | Blob | Uint8Array, public name: string, public size: number) {\r\n\t\tif (!content || !name || !size) {\r\n\t\t\tthrow new GraphClientError(\"Please provide the upload content, name of the file and size of the file\");\r\n\t\t}\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * Slices the file content to the given range\r\n\t * @param {Range} range - The range value\r\n\t * @returns The sliced file part\r\n\t */\r\n\tpublic sliceFile(range: Range): ArrayBuffer | Blob | Uint8Array {\r\n\t\treturn this.content.slice(range.minValue, range.maxValue + 1);\r\n\t}\r\n}\r\n","/**\r\n * -------------------------------------------------------------------------------------------\r\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\r\n * See License in the project root for license information.\r\n * -------------------------------------------------------------------------------------------\r\n */\r\n\r\n/**\r\n * @module OneDriveLargeFileUploadTaskUtil\r\n */\r\n\r\n/**\r\n * @constant\r\n * Default value for the rangeSize\r\n * Recommended size is between 5 - 10 MB {@link https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/api/driveitem_createuploadsession#best-practices}\r\n */\r\nconst DEFAULT_FILE_SIZE: number = 5 * 1024 * 1024;\r\n\r\n/**\r\n * @constant\r\n * Rounds off the given value to a multiple of 320 KB\r\n * @param {number} value - The value\r\n * @returns The rounded off value\r\n */\r\nconst roundTo320KB = (value: number): number => {\r\n\tif (value > 320 * 1024) {\r\n\t\tvalue = Math.floor(value / (320 * 1024)) * 320 * 1024;\r\n\t}\r\n\treturn value;\r\n};\r\n\r\n/**\r\n * @constant\r\n * Get the valid rangeSize for a file slicing (validity is based on the constrains mentioned in here\r\n * {@link https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/api/driveitem_createuploadsession#upload-bytes-to-the-upload-session})\r\n *\r\n * @param {number} [rangeSize = DEFAULT_FILE_SIZE] - The rangeSize value.\r\n * @returns The valid rangeSize\r\n */\r\nexport const getValidRangeSize = (rangeSize: number = DEFAULT_FILE_SIZE): number => {\r\n\tconst sixtyMB = 60 * 1024 * 1024;\r\n\tif (rangeSize > sixtyMB) {\r\n\t\trangeSize = sixtyMB;\r\n\t}\r\n\treturn roundTo320KB(rangeSize);\r\n};\r\n","/**\r\n * -------------------------------------------------------------------------------------------\r\n * Copyright (c) Microsoft Corporation. All Rights Reserved. Licensed under the MIT License.\r\n * See License in the project root for license information.\r\n * -------------------------------------------------------------------------------------------\r\n */\r\n\r\n/**\r\n * @module OneDriveLargeFileUploadTask\r\n */\r\n\r\nimport { GraphClientError } from \"../GraphClientError\";\r\nimport { Client } from \"../index\";\r\nimport { FileUpload } from \"./FileUploadTask/FileObjectClasses/FileUpload\";\r\nimport { UploadEventHandlers } from \"./FileUploadTask/Interfaces/IUploadEventHandlers\";\r\nimport { FileObject, LargeFileUploadSession, LargeFileUploadTask, LargeFileUploadTaskOptions } from \"./LargeFileUploadTask\";\r\nimport { getValidRangeSize } from \"./OneDriveLargeFileUploadTaskUtil\";\r\n\r\n/**\r\n * @interface\r\n * Signature to define options when creating an upload task\r\n * @property {string} fileName - Specifies the name of a file to be uploaded (with extension)\r\n * @property {string} [fileDescription] - Specifies the description of the file to be uploaded\r\n * @property {string} [path] - The path to which the file needs to be uploaded\r\n * @property {number} [rangeSize] - Specifies the range chunk size\r\n * @property {string} [conflictBehavior] - Conflict behaviour option\r\n * @property {UploadEventHandlers} [uploadEventHandlers] - UploadEventHandlers attached to an upload task\r\n */\r\nexport interface OneDriveLargeFileUploadOptions {\r\n\tfileName: string;\r\n\tfileDescription?: string;\r\n\tpath?: string;\r\n\trangeSize?: number;\r\n\tconflictBehavior?: string;\r\n\tuploadEventHandlers?: UploadEventHandlers;\r\n}\r\n\r\n/**\r\n * @interface\r\n * Signature to define options when creating an upload task\r\n * @property {string} fileName - Specifies the name of a file to be uploaded (with extension)\r\n * @property {string} [fileDescription] - Specifies the description of the file to be uploaded\r\n * @property {string} [conflictBehavior] - Conflict behaviour option\r\n */\r\ninterface OneDriveFileUploadSessionPayLoad {\r\n\tfileName: string;\r\n\tfileDescription?: string;\r\n\tconflictBehavior?: string;\r\n}\r\n\r\n/**\r\n * @interface\r\n * Signature to define the file information when processing an upload task\r\n * @property {File | Uint8Array} content - The file content\r\n * @property {number} size - The size of file\r\n */\r\ninterface FileInfo {\r\n\tcontent: File | Uint8Array;\r\n\tsize: number;\r\n}\r\n\r\n/**\r\n * @class\r\n * Class representing OneDriveLargeFileUploadTask\r\n */\r\nexport class OneDriveLargeFileUploadTask extends LargeFileUploadTask {\r\n\t/**\r\n\t * @private\r\n\t * @static\r\n\t * Default path for the file being uploaded\r\n\t */\r\n\tprivate static DEFAULT_UPLOAD_PATH = \"/\";\r\n\r\n\t/**\r\n\t * @private\r\n\t * @static\r\n\t * Constructs the create session url for Onedrive\r\n\t * @param {string} fileName - The name of the file\r\n\t * @param {path} [path = OneDriveLargeFileUploadTask.DEFAULT_UPLOAD_PATH] - The path for the upload\r\n\t * @returns The constructed create session url\r\n\t */\r\n\tprivate static constructCreateSessionUrl(fileName: string, path: string = OneDriveLargeFileUploadTask.DEFAULT_UPLOAD_PATH): string {\r\n\t\tfileName = fileName.trim();\r\n\t\tpath = path.trim();\r\n\t\tif (path === \"\") {\r\n\t\t\tpath = \"/\";\r\n\t\t}\r\n\t\tif (path[0] !== \"/\") {\r\n\t\t\tpath = `/${path}`;\r\n\t\t}\r\n\t\tif (path[path.length - 1] !== \"/\") {\r\n\t\t\tpath = `${path}/`;\r\n\t\t}\r\n\t\t// we choose to encode each component of the file path separately because when encoding full URI\r\n\t\t// with encodeURI, special characters like # or % in the file name doesn't get encoded as desired\r\n\t\treturn `/me/drive/root:${path\r\n\t\t\t.split(\"/\")\r\n\t\t\t.map((p) => encodeURIComponent(p))\r\n\t\t\t.join(\"/\")}${encodeURIComponent(fileName)}:/createUploadSession`;\r\n\t}\r\n\r\n\t/**\r\n\t * @private\r\n\t * @static\r\n\t * Get file information\r\n\t * @param {Blob | Uint8Array | File} file - The file entity\r\n\t * @param {string} fileName - The file name\r\n\t * @returns {FileInfo} The file information\r\n\t */\r\n\tprivate static getFileInfo(file: Blob | Uint8Array | File, fileName: string): FileInfo {\r\n\t\tlet content;\r\n\t\tlet size;\r\n\t\tif (typeof Blob !== \"undefined\" && file instanceof Blob) {\r\n\t\t\tcontent = new File([file as Blob], fileName);\r\n\t\t\tsize = content.size;\r\n\t\t} else if (typeof File !== \"undefined\" && file instanceof File) {\r\n\t\t\tcontent = file as File;\r\n\t\t\tsize = content.size;\r\n\t\t} else if (typeof Uint8Array !== \"undefined\" && file instanceof Uint8Array) {\r\n\t\t\tconst b = file as Uint8Array;\r\n\t\t\tsize = b.byteLength;\r\n\t\t\tcontent = b.buffer.slice(b.byteOffset, b.byteOffset + b.byteLength);\r\n\t\t}\r\n\t\treturn {\r\n\t\t\tcontent,\r\n\t\t\tsize,\r\n\t\t};\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * @static\r\n\t * @async\r\n\t * Creates a OneDriveLargeFileUploadTask\r\n\t * @param {Client} client - The GraphClient instance\r\n\t * @param {Blob | Uint8Array | File} file - File represented as Blob, Uint8Array or File\r\n\t * @param {OneDriveLargeFileUploadOptions} options - The options for upload task\r\n\t * @returns The promise that will be resolves to OneDriveLargeFileUploadTask instance\r\n\t */\r\n\tpublic static async create(client: Client, file: Blob | Uint8Array | File, options: OneDriveLargeFileUploadOptions): Promise> {\r\n\t\tif (!client || !file || !options) {\r\n\t\t\tthrow new GraphClientError(\"Please provide the Graph client instance, file object and OneDriveLargeFileUploadOptions value\");\r\n\t\t}\r\n\t\tconst fileName = options.fileName;\r\n\t\tconst fileInfo = OneDriveLargeFileUploadTask.getFileInfo(file, fileName);\r\n\t\tconst fileObj = new FileUpload(fileInfo.content, fileName, fileInfo.size);\r\n\t\treturn this.createTaskWithFileObject(client, fileObj, options);\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * @static\r\n\t * @async\r\n\t * Creates a OneDriveLargeFileUploadTask\r\n\t * @param {Client} client - The GraphClient instance\r\n\t * @param {FileObject} fileObject - FileObject instance\r\n\t * @param {OneDriveLargeFileUploadOptions} options - The options for upload task\r\n\t * @returns The promise that will be resolves to OneDriveLargeFileUploadTask instance\r\n\t */\r\n\tpublic static async createTaskWithFileObject(client: Client, fileObject: FileObject, options: OneDriveLargeFileUploadOptions): Promise> {\r\n\t\tif (!client || !fileObject || !options) {\r\n\t\t\tthrow new GraphClientError(\"Please provide the Graph client instance, FileObject interface implementation and OneDriveLargeFileUploadOptions value\");\r\n\t\t}\r\n\t\tconst requestUrl = OneDriveLargeFileUploadTask.constructCreateSessionUrl(options.fileName, options.path);\r\n\t\tconst uploadSessionPayload: OneDriveFileUploadSessionPayLoad = {\r\n\t\t\tfileName: options.fileName,\r\n\t\t\tfileDescription: options.fileDescription,\r\n\t\t\tconflictBehavior: options.conflictBehavior,\r\n\t\t};\r\n\t\tconst session = await OneDriveLargeFileUploadTask.createUploadSession(client, requestUrl, uploadSessionPayload);\r\n\t\tconst rangeSize = getValidRangeSize(options.rangeSize);\r\n\t\treturn new OneDriveLargeFileUploadTask(client, fileObject, session, {\r\n\t\t\trangeSize,\r\n\t\t\tuploadEventHandlers: options.uploadEventHandlers,\r\n\t\t});\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * @static\r\n\t * @async\r\n\t * Makes request to the server to create an upload session\r\n\t * @param {Client} client - The GraphClient instance\r\n\t * @param {string} requestUrl - The URL to create the upload session\r\n\t * @param {string} payloadOptions - The payload option. Default conflictBehavior is 'rename'\r\n\t * @returns The promise that resolves to LargeFileUploadSession\r\n\t */\r\n\tpublic static async createUploadSession(client: Client, requestUrl: string, payloadOptions: OneDriveFileUploadSessionPayLoad): Promise {\r\n\t\tconst payload = {\r\n\t\t\titem: {\r\n\t\t\t\t\"@microsoft.graph.conflictBehavior\": payloadOptions?.conflictBehavior || \"rename\",\r\n\t\t\t\tname: payloadOptions?.fileName,\r\n\t\t\t\tdescription: payloadOptions?.fileDescription,\r\n\t\t\t},\r\n\t\t};\r\n\t\treturn super.createUploadSession(client, requestUrl, payload);\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * @constructor\r\n\t * Constructs a OneDriveLargeFileUploadTask\r\n\t * @param {Client} client - The GraphClient instance\r\n\t * @param {FileObject} file - The FileObject holding details of a file that needs to be uploaded\r\n\t * @param {LargeFileUploadSession} uploadSession - The upload session to which the upload has to be done\r\n\t * @param {LargeFileUploadTaskOptions} options - The upload task options\r\n\t * @returns An instance of OneDriveLargeFileUploadTask\r\n\t */\r\n\tpublic constructor(client: Client, file: FileObject, uploadSession: LargeFileUploadSession, options: LargeFileUploadTaskOptions) {\r\n\t\tsuper(client, file, uploadSession, options);\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * Commits upload session to end uploading\r\n\t * @param {string} requestUrl - The URL to commit the upload session\r\n\t * @param {string} conflictBehavior - Conflict behaviour option. Default is 'rename'\r\n\t * @returns The promise resolves to committed response\r\n\t */\r\n\tpublic async commit(requestUrl: string, conflictBehavior = \"rename\"): Promise {\r\n\t\tconst payload = {\r\n\t\t\tname: this.file.name,\r\n\t\t\t\"@microsoft.graph.conflictBehavior\": conflictBehavior,\r\n\t\t\t\"@microsoft.graph.sourceUrl\": this.uploadSession.url,\r\n\t\t};\r\n\t\treturn await this.client.api(requestUrl).put(payload);\r\n\t}\r\n}\r\n","import { GraphClientError } from \"../../../GraphClientError\";\r\nimport { FileObject, SliceType } from \"../../LargeFileUploadTask\";\r\nimport { Range } from \"../Range\";\r\n\r\n/**\r\n * @interface\r\n * Interface to store slice of a stream and range of the slice.\r\n * @property {Buffer} fileSlice - The slice of the stream\r\n * @property {Range} range - The range of the slice\r\n */\r\ninterface SliceRecord {\r\n\tfileSlice: Buffer;\r\n\trange: Range;\r\n}\r\n\r\n/**\r\n * @class\r\n * FileObject class for Readable Stream upload\r\n */\r\nexport class StreamUpload implements FileObject {\r\n\t/**\r\n\t * @private\r\n\t * Represents a cache of the last attempted upload slice.\r\n\t * This can be used when resuming a previously failed slice upload.\r\n\t */\r\n\tprivate previousSlice: SliceRecord;\r\n\r\n\tpublic constructor(public content: NodeStream, public name: string, public size: number) {\r\n\t\tif (!content || !name || !size) {\r\n\t\t\tthrow new GraphClientError(\"Please provide the Readable Stream content, name of the file and size of the file\");\r\n\t\t}\r\n\t}\r\n\r\n\t/**\r\n\t * @public\r\n\t * Slices the file content to the given range\r\n\t * @param {Range} range - The range value\r\n\t * @returns The sliced file part\r\n\t */\r\n\tpublic async sliceFile(range: Range): Promise