@devsym/graph-toolkit-react 0.1.0-next.2 → 1.0.0-next.6

package/AGENTS.md

@@ -0,0 +1,167 @@
+# AGENTS.md — Graph Toolkit React
+
+This file is for coding agents that consume `@devsym/graph-toolkit-react`.
+Use this as the primary quick reference for implementation choices.
+
+## Package
+
+- Package name: `@devsym/graph-toolkit-react`
+- Peer deps: `react`, `react-dom`, `@fluentui/react-components`
+- Optional peer dep: `@azure/msal-browser` (required only for `MsalBrowserProvider`)
+
+Install:
+
+```bash
+npm install @devsym/graph-toolkit-react react react-dom @fluentui/react-components
+```
+
+If using browser MSAL auth:
+
+```bash
+npm install @azure/msal-browser
+```
+
+## Scenario Decision Matrix
+
+Choose one provider and wire it into `GraphProvider`.
+
+| Scenario | Use | Why |
+| --- | --- | --- |
+| Local development / UI prototyping | `MockProvider` | No auth setup; deterministic mock data |
+| Browser-hosted app (SPA) with Entra/MSA sign-in | `MsalBrowserProvider` | Native browser MSAL flow |
+| Microsoft Teams-hosted app with consumer-managed Teams auth | `TeamsHostedProvider` | Reuses existing Teams token acquisition + backend exchange |
+| Existing custom auth stack | Custom `IProvider` implementation | Full control over token source and lifecycle |
+
+## Minimal Patterns
+
+### 1) MockProvider (fastest start)
+
+```tsx
+import { FluentProvider, webLightTheme } from '@fluentui/react-components';
+import { GraphProvider, MockProvider, Person } from '@devsym/graph-toolkit-react';
+
+const provider = new MockProvider();
+
+export function App() {
+  return (
+    <FluentProvider theme={webLightTheme}>
+      <GraphProvider provider={provider}>
+        <Person userId="AdeleV@contoso.com" view="twolines" showPresence />
+      </GraphProvider>
+    </FluentProvider>
+  );
+}
+```
+
+### 2) Browser SPA with MSAL (`MsalBrowserProvider`)
+
+```tsx
+import { PublicClientApplication } from '@azure/msal-browser';
+import { GraphProvider, MsalBrowserProvider, Person } from '@devsym/graph-toolkit-react';
+
+const msal = new PublicClientApplication({
+  auth: {
+    clientId: 'YOUR_CLIENT_ID',
+    authority: 'https://login.microsoftonline.com/common',
+    redirectUri: window.location.origin,
+  },
+});
+
+const provider = new MsalBrowserProvider(msal, ['User.Read']);
+await provider.initialize();
+
+export function App() {
+  return (
+    <GraphProvider provider={provider}>
+      <Person userId="me" view="threelines" />
+    </GraphProvider>
+  );
+}
+```
+
+### 3) Teams-hosted app (`TeamsHostedProvider`)
+
+```tsx
+import {
+  createBackendTokenExchange,
+  GraphProvider,
+  Person,
+  TeamsHostedProvider,
+} from '@devsym/graph-toolkit-react';
+import { authentication } from '@microsoft/teams-js';
+
+const exchangeForGraphToken = createBackendTokenExchange({
+  endpoint: '/api/token/exchange',
+});
+
+const provider = new TeamsHostedProvider({
+  defaultScopes: ['User.Read'],
+  getTeamsSsoToken: async scopes => authentication.getAuthToken({ resources: scopes }),
+  exchangeForGraphToken,
+});
+
+await provider.login();
+
+export function App() {
+  return (
+    <GraphProvider provider={provider}>
+      <Person userId="me" view="threelines" />
+    </GraphProvider>
+  );
+}
+```
+
+### 4) Custom auth (`IProvider`)
+
+```tsx
+import { IProvider, ProviderState } from '@devsym/graph-toolkit-react';
+
+export class MyProvider implements IProvider {
+  state: ProviderState = 'SignedOut';
+
+  async login(): Promise<void> {
+    this.state = 'SignedIn';
+  }
+
+  async logout(): Promise<void> {
+    this.state = 'SignedOut';
+  }
+
+  async getAccessToken(): Promise<string> {
+    return 'ACCESS_TOKEN';
+  }
+}
+```
+
+## Scopes by Feature
+
+| Feature | Minimum delegated scope | Notes |
+| --- | --- | --- |
+| Current user profile (`userId="me"`) | `User.Read` | Required for basic profile fields |
+| Other user profile (`userId="{id/upn}"`) | `User.ReadBasic.All` | May require admin consent |
+| Presence (`showPresence`) | `Presence.Read` | UI still renders without presence |
+| Profile photo (`fetchImage`) | `User.Read` | Falls back to initials if unavailable |
+
+## Common Failures and Fixes
+
+| Symptom | Likely Cause | Action |
+| --- | --- | --- |
+| Redirect URI mismatch / `AADSTS50011` | App registration redirect URI does not match dev URL | Add exact SPA redirect URI used by local dev server |
+| Person stays loading | Provider not initialized / login not completed | Ensure `await provider.initialize()` (MSAL) or `await provider.login()` (Teams/custom) before rendering |
+| Presence missing | `Presence.Read` not granted | Add and consent to `Presence.Read`; keep graceful fallback |
+| `Cannot find module '@azure/msal-browser'` | Using `MsalBrowserProvider` without optional peer dependency installed | Install `@azure/msal-browser` |
+
+## Agent Rules
+
+- Choose the simplest provider that fits the host environment.
+- Keep scopes minimal and feature-driven.
+- Prefer `userId="me"` for first implementation; expand to other users only when needed.
+- Wrap components with `GraphProvider`; avoid direct token handling in UI components.
+- If uncertain, default to `MockProvider` for local iteration, then switch to real auth provider.
+
+## Source of Truth
+
+- Primary docs: `README.md`
+- Migration guide: `docs/MGT_MIGRATION.md`
+- MSAL sample: `samples/react-msal-sample/README.md`
+- API exports and types: package root `dist/index.d.ts` in published artifact

package/dist/components/Person/Person.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Person.d.ts","sourceRoot":"","sources":["../../../src/components/Person/Person.tsx"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AA2C7C,eAAO,MAAM,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,CAuFxC,CAAC"}
+{"version":3,"file":"Person.d.ts","sourceRoot":"","sources":["../../../src/components/Person/Person.tsx"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAwB7C,eAAO,MAAM,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,CAkFxC,CAAC"}

package/dist/components/Person/Person.types.d.ts

@@ -1,12 +1,8 @@
 /**
  * Person component types
  */
-import type { CSSProperties } from 'react';
-import { User } from '@microsoft/microsoft-graph-types';
-export type PersonView = 'avatar' | 'oneline' | 'twolines' | 'threelines';
-export type PersonSize = 'small' | 'medium' | 'large' | 'extra-large';
-export type PersonTextAlignment = 'start' | 'center';
-export type PersonTextPosition = 'before' | 'after' | 'below';
+import type { PersonaProps } from '@fluentui/react-components';
+export type PersonView = 'avatar' | 'oneline' | 'twolines' | 'threelines' | 'fourlines';
 export interface PersonDetails {
     displayName?: string;
     mail?: string;
@@ -16,20 +12,13 @@ export interface PersonDetails {
     id?: string;
     userPrincipalName?: string;
 }
-export interface PersonProps {
+export interface PersonProps extends PersonaProps {
     userId?: string;
     userPrincipalName?: string;
     email?: string;
     personDetails?: PersonDetails;
     view?: PersonView;
     showPresence?: boolean;
-    avatarSize?: PersonSize;
-    textAlignment?: PersonTextAlignment;
-    textPosition?: PersonTextPosition;
-    numericSize?: number;
     fetchImage?: boolean;
-    onClick?: (person: User) => void;
-    className?: string;
-    style?: CSSProperties;
 }
 //# sourceMappingURL=Person.types.d.ts.map

package/dist/components/Person/Person.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Person.types.d.ts","sourceRoot":"","sources":["../../../src/components/Person/Person.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,kCAAkC,CAAC;AAExD,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,CAAC;AAC1E,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,aAAa,CAAC;AACtE,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,QAAQ,CAAC;AACrD,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;AAE9D,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAE1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,aAAa,CAAC,EAAE,aAAa,CAAC;IAG9B,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,UAAU,CAAC;IAGxB,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,UAAU,CAAC,EAAE,OAAO,CAAC;IAGrB,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,KAAK,IAAI,CAAC;IAGjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB"}
+{"version":3,"file":"Person.types.d.ts","sourceRoot":"","sources":["../../../src/components/Person/Person.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,WAAW,CAAC;AAExF,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,WAAY,SAAQ,YAAY;IAE/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,aAAa,CAAC,EAAE,aAAa,CAAC;IAG9B,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IAGvB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB"}

package/dist/hooks/usePersonData.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usePersonData.d.ts","sourceRoot":"","sources":["../../src/hooks/usePersonData.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAKlE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,SAAS,oBAAoB,KAAG,UAgK7D,CAAC"}
+{"version":3,"file":"usePersonData.d.ts","sourceRoot":"","sources":["../../src/hooks/usePersonData.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAYlE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AA8BD;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,SAAS,oBAAoB,KAAG,UA2O7D,CAAC"}

package/dist/index.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const w=require("react/jsx-runtime"),O=require("@fluentui/react-components"),d=require("react"),q=require("@microsoft/microsoft-graph-client");var o=(t=>(t.Loading="Loading",t.SignedOut="SignedOut",t.SignedIn="SignedIn",t))(o||{});const P=d.createContext({provider:null,state:o.Loading}),G=({provider:t,children:e})=>{const s=d.useCallback(()=>t?.getState?.()??o.Loading,[t]),r=d.useCallback(i=>(t.onStateChanged?.(i),()=>{const c=t;typeof c.removeStateChangedHandler=="function"&&c.removeStateChangedHandler(i)}),[t]),n=d.useSyncExternalStore(r,s,s),a=d.useMemo(()=>({provider:t,state:n}),[t,n]);return w.jsx(P.Provider,{value:a,children:e})},I=()=>{const{provider:t}=d.useContext(P);return t},b=()=>{const{state:t}=d.useContext(P);return t},L=t=>q.Client.init({authProvider:async e=>{try{const s=await t.getAccessToken();e(null,s)}catch(s){e(s,null)}}}),z=t=>{const e=t.trim().split(" ");return e.length===1?e[0].substring(0,2).toUpperCase():(e[0][0]+e[e.length-1][0]).toUpperCase()},U=()=>{const t=I(),e=b();return d.useMemo(()=>!t||e!=="SignedIn"?null:L(t),[t,e])};class C{state=o.SignedOut;listeners=[];constructor(e){e?.autoSignIn&&(this.state=o.SignedIn)}getAccessToken(){return this.state!==o.SignedIn?Promise.reject(new Error("Not signed in")):Promise.resolve("mock-token")}async login(){this.state=o.SignedIn,this.emit()}async logout(){this.state=o.SignedOut,this.emit()}getState(){return this.state}onStateChanged(e){this.listeners.push(e)}removeStateChangedHandler(e){this.listeners=this.listeners.filter(s=>s!==e)}emit(){for(const e of this.listeners)try{e()}catch{}}}const B=()=>new C({autoSignIn:!0}),j=t=>{const e=U(),s=I(),r=b(),{userId:n,userPrincipalName:a,fetchPresence:i=!1,fetchPhoto:c=!0}=t,[f,p]=d.useState({user:null,presence:null,photoUrl:null,loading:!0,error:null});return d.useEffect(()=>{let h=!1;return(async()=>{if(s instanceof C){const l={id:"00000000-0000-0000-0000-000000000000",displayName:"Adele Vance",userPrincipalName:"adelev@contoso.com",jobTitle:"Product Manager",department:"Marketing",officeLocation:"19/3106",mail:"adelev@contoso.com"},u={availability:"Available",activity:"Available",id:l.id,odataType:"#microsoft.graph.presence"};h||p({user:l,presence:i?u:null,photoUrl:c?"https://ui-avatars.com/api/?name=Adele+Vance&background=0D8ABC&color=ffffff":null,loading:!1,error:null});return}if(r!=="SignedIn"){h||p({user:null,presence:null,photoUrl:null,loading:!1,error:r==="SignedOut"?null:new Error("Provider not signed in")});return}if(!e){h||p(l=>({...l,loading:!0}));return}const m=n||a;if(!m){h||p({user:null,presence:null,photoUrl:null,loading:!1,error:null});return}try{p(g=>({...g,loading:!0,error:null}));const l=m.toLowerCase()==="me",u=await e.api(l?"/me":`/users/${m}`).select("id,displayName,jobTitle,mail,department,officeLocation,userPrincipalName").get();if(h)return;let S=null,k=null;if(i&&u.id)try{S=await e.api(l?"/me/presence":`/users/${u.id}/presence`).get()}catch(g){console.warn("Failed to fetch presence:",g)}if(c&&u.id)try{const g=await e.api(l?"/me/photo/$value":`/users/${u.id}/photo/$value`).get();k=URL.createObjectURL(g)}catch(g){console.warn("Failed to fetch photo:",g)}h||p({user:u,presence:S,photoUrl:k,loading:!1,error:null})}catch(l){h||p({user:null,presence:null,photoUrl:null,loading:!1,error:l})}})(),()=>{h=!0}},[e,s,r,n,a,i,c]),f},N=t=>{switch(t){case"small":return"small";case"large":return"large";case"extra-large":return"extra-large";default:return"medium"}},$=t=>{switch(t?.toLowerCase()){case"available":case"availableidle":return"available";case"away":case"berightback":return"away";case"busy":case"busyidle":case"donotdisturb":return"busy";default:return"offline"}},D=({userId:t,userPrincipalName:e,email:s,personDetails:r,view:n="oneline",showPresence:a=!1,avatarSize:i="medium",textAlignment:c,textPosition:f,numericSize:p,fetchImage:h=!0,onClick:y,className:m,style:l})=>{const{user:u,presence:S,photoUrl:k,loading:g}=j({userId:r?void 0:t||e||s,fetchPresence:a,fetchPhoto:h}),T=r||u,E=p??N(i);if(g)return w.jsx(O.Persona,{size:E,name:"Loading...",textAlignment:c,textPosition:f,className:m,style:l});if(!T)return null;const M=T.displayName||"Unknown User",F=z(M),v={size:E,name:M,textAlignment:c,textPosition:f,avatar:{image:k?{src:k}:void 0,initials:k?void 0:F},className:m,style:l};return a&&S&&(v.presence={status:$(S.availability)}),n!=="avatar"&&((n==="twolines"||n==="threelines")&&(v.secondaryText=T.jobTitle??void 0),n==="threelines"&&(v.tertiaryText=T.department??void 0)),y&&(v.onClick=()=>{u&&y(u)}),w.jsx(O.Persona,{...v})};function H(t){return`See https://aka.ms/msal.js.errors#${t} for details`}class x extends Error{constructor(e,s,r){const n=s||(e?H(e):""),a=n?`${e}: ${n}`:e;super(a),Object.setPrototypeOf(this,x.prototype),this.errorCode=e||"",this.errorMessage=n||"",this.subError=r||"",this.name="AuthError"}setCorrelationId(e){this.correlationId=e}}class A extends x{constructor(e,s,r,n,a,i,c,f){super(e,s,r),Object.setPrototypeOf(this,A.prototype),this.timestamp=n||"",this.traceId=a||"",this.correlationId=i||"",this.claims=c||"",this.name="InteractionRequiredAuthError",this.errorNo=f}}class R{msalInstance;defaultScopes;account=null;state=o.Loading;listeners=[];constructor(e,s){this.msalInstance=e,this.defaultScopes=s}async initialize(){await this.msalInstance.initialize(),await this.msalInstance.handleRedirectPromise();const e=this.msalInstance.getActiveAccount(),s=this.msalInstance.getAllAccounts();this.account=e??s[0]??null,this.account?(this.msalInstance.setActiveAccount(this.account),this.setState(o.SignedIn)):this.setState(o.SignedOut)}async login(){const e={scopes:this.defaultScopes},s=await this.msalInstance.loginPopup(e);this.account=s.account,this.account&&this.msalInstance.setActiveAccount(this.account),this.setState(o.SignedIn)}async logout(){const e=this.msalInstance.getActiveAccount()??this.account??void 0;await this.msalInstance.logoutPopup({account:e}),this.account=null,this.setState(o.SignedOut)}async getAccessToken(e){const s=e&&e.length>0?e:this.defaultScopes,r=this.msalInstance.getActiveAccount()??this.account;if(!r)throw new Error("No active account. User must sign in first.");const n={scopes:s,account:r};try{return(await this.msalInstance.acquireTokenSilent(n)).accessToken}catch(a){if(a instanceof A){const i={scopes:s,account:r};return(await this.msalInstance.acquireTokenPopup(i)).accessToken}throw a}}getState(){return this.state}onStateChanged(e){this.listeners.push(e)}removeStateChangedHandler(e){this.listeners=this.listeners.filter(s=>s!==e)}setState(e){this.state=e,this.emit()}emit(){for(const e of this.listeners)try{e()}catch{}}}const K=6e4;function V(t){const e=t.fetchFn??fetch;return async({ssoToken:s,scopes:r})=>{const n=await e(t.endpoint,{method:"POST",headers:{Authorization:`Bearer ${s}`,"Content-Type":"application/json"},body:JSON.stringify({scopes:r})}),a=await n.json().catch(()=>({error:n.statusText||"Token exchange failed"}));if(!n.ok){const i=a?.error||a?.message||n.statusText;throw new Error(`Backend token exchange failed: ${i}`)}if(!a?.accessToken)throw new Error("Backend token exchange response did not include accessToken.");return{accessToken:a.accessToken,expiresAt:a.expiresAt}}}class J{defaultScopes;getTeamsSsoTokenFn;exchangeForGraphTokenFn;refreshSkewMs;state=o.SignedOut;listeners=[];tokenCache=new Map;constructor(e){if(!e.defaultScopes||e.defaultScopes.length===0)throw new Error("TeamsHostedProvider requires at least one default scope.");this.defaultScopes=[...new Set(e.defaultScopes)],this.getTeamsSsoTokenFn=e.getTeamsSsoToken,this.exchangeForGraphTokenFn=e.exchangeForGraphToken,this.refreshSkewMs=e.refreshSkewMs??K}async login(){try{await this.getAccessToken(),this.setState(o.SignedIn)}catch(e){throw this.clearCache(),this.setState(o.SignedOut),e}}async logout(){this.clearCache(),this.setState(o.SignedOut)}async getAccessToken(e){const s=this.normalizeScopes(e),r=this.buildScopeKey(s),n=this.tokenCache.get(r);if(n&&this.isTokenValid(n))return n.accessToken;const a=await this.getTeamsSsoTokenFn(s);if(!a)throw new Error("Teams SSO token acquisition returned empty token.");const i=await this.exchangeForGraphTokenFn({ssoToken:a,scopes:s}),c=this.normalizeExchangedToken(i);return this.tokenCache.set(r,c),this.setState(o.SignedIn),c.accessToken}getState(){return this.state}onStateChanged(e){this.listeners.push(e)}removeStateChangedHandler(e){this.listeners=this.listeners.filter(s=>s!==e)}normalizeScopes(e){const s=e&&e.length>0?e:this.defaultScopes,r=[...new Set(s.filter(Boolean))];if(r.length===0)throw new Error("At least one scope is required to request a Graph token.");return r}buildScopeKey(e){return[...e].sort().join(" ")}isTokenValid(e){return e.expiresAtMs?Date.now()+this.refreshSkewMs<e.expiresAtMs:!0}normalizeExchangedToken(e){if(typeof e=="string"){if(!e)throw new Error("Graph token exchange returned empty access token.");return{accessToken:e}}if(!e.accessToken)throw new Error("Graph token exchange returned empty access token.");return{accessToken:e.accessToken,expiresAtMs:this.toEpochMs(e.expiresAt)}}toEpochMs(e){if(e)return e instanceof Date?e.getTime():e}clearCache(){this.tokenCache.clear()}setState(e){this.state!==e&&(this.state=e,this.emit())}emit(){for(const e of this.listeners)try{e()}catch{}}}exports.GraphProvider=G;exports.MockProvider=C;exports.MsalBrowserProvider=R;exports.Person=D;exports.ProviderState=o;exports.TeamsHostedProvider=J;exports.createBackendTokenExchange=V;exports.createMockSignedInProvider=B;exports.useGraphClient=U;exports.usePersonData=j;exports.useProvider=I;exports.useProviderState=b;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const F=require("react/jsx-runtime"),L=require("@fluentui/react-components"),d=require("react"),V=require("@microsoft/microsoft-graph-client"),Q="graph-toolkit-person-cache",P="personData",J=1,W=3600*1e3,X=3600*1e3,Y=300*1e3,q={enabled:!0,userTtlMs:W,photoTtlMs:X,presenceTtlMs:Y},D=()=>typeof window<"u"&&typeof window.indexedDB<"u",G=t=>new Promise((e,n)=>{t.onsuccess=()=>e(t.result),t.onerror=()=>n(t.error)}),R=()=>new Promise((t,e)=>{if(!D()){e(new Error("IndexedDB unavailable"));return}const n=window.indexedDB.open(Q,J);n.onupgradeneeded=()=>{const r=n.result;r.objectStoreNames.contains(P)||r.createObjectStore(P)},n.onsuccess=()=>t(n.result),n.onerror=()=>e(n.error)}),Z=t=>`person:${t.trim().toLowerCase()}`,U=(t,e)=>t?Date.now()-t<e:!1,ee=async t=>{if(!D())return null;let e=null;try{e=await R();const r=e.transaction(P,"readonly").objectStore(P);return await G(r.get(t))??null}catch{return null}finally{e?.close()}},te=async(t,e)=>{if(!D())return;let n=null;try{n=await R();const s=n.transaction(P,"readwrite").objectStore(P);await G(s.put(e,t))}catch{return}finally{n?.close()}},O=d.createContext({provider:null,state:"Loading",personCacheOptions:q}),ne=({provider:t,children:e,personCacheOptions:n})=>{const r=d.useCallback(()=>t?.getState?.()??"Loading",[t]),s=d.useCallback(l=>(t.onStateChanged?.(l),()=>{const m=t;typeof m.removeStateChangedHandler=="function"&&m.removeStateChangedHandler(l)}),[t]),o=d.useSyncExternalStore(s,r,r),i=d.useMemo(()=>({...q,...n??{}}),[n]),a=d.useMemo(()=>({provider:t,state:o,personCacheOptions:i}),[t,o,i]);return F.jsx(O.Provider,{value:a,children:e})},N=()=>{const{provider:t}=d.useContext(O);return t},_=()=>{const{state:t}=d.useContext(O);return t},$=()=>{const{personCacheOptions:t}=d.useContext(O);return t},se=t=>V.Client.init({authProvider:async e=>{try{const n=await t.getAccessToken();e(null,n)}catch(n){e(n,null)}}}),re=t=>{const e=t.trim().split(" ");return e.length===1?e[0].substring(0,2).toUpperCase():(e[0][0]+e[e.length-1][0]).toUpperCase()},z=()=>{const t=N(),e=_();return d.useMemo(()=>!t||e!=="SignedIn"?null:se(t),[t,e])};class B{state="SignedOut";listeners=[];constructor(e){e?.autoSignIn&&(this.state="SignedIn")}getAccessToken(){return this.state!=="SignedIn"?Promise.reject(new Error("Not signed in")):Promise.resolve("mock-token")}async login(){this.state="SignedIn",this.emit()}async logout(){this.state="SignedOut",this.emit()}getState(){return this.state}onStateChanged(e){this.listeners.push(e)}removeStateChangedHandler(e){this.listeners=this.listeners.filter(n=>n!==e)}emit(){for(const e of this.listeners)try{e()}catch{}}}const oe=()=>new B({autoSignIn:!0}),ae=async t=>{if(!t)return null;if(typeof t=="string")return t;const e=t instanceof Blob?t:t instanceof ArrayBuffer?new Blob([t]):null;return e?new Promise((n,r)=>{const s=new FileReader;s.onloadend=()=>n(typeof s.result=="string"?s.result:null),s.onerror=()=>r(s.error),s.readAsDataURL(e)}):null},K=t=>{const e=z(),n=N(),r=_(),s=$(),{userId:o,userPrincipalName:i,fetchPresence:a=!1,fetchPhoto:l=!0}=t,[m,u]=d.useState({user:null,presence:null,photoUrl:null,loading:!0,error:null});return d.useEffect(()=>{let f=!1;return(async()=>{if(n instanceof B){const h={id:"00000000-0000-0000-0000-000000000000",displayName:"Adele Vance",userPrincipalName:"adelev@contoso.com",jobTitle:"Product Manager",department:"Marketing",officeLocation:"19/3106",mail:"adelev@contoso.com"},y={availability:"Available",activity:"Available",id:h.id,odataType:"#microsoft.graph.presence"};f||u({user:h,presence:a?y:null,photoUrl:l?"https://ui-avatars.com/api/?name=Adele+Vance&background=0D8ABC&color=ffffff":null,loading:!1,error:null});return}if(r!=="SignedIn"){f||u({user:null,presence:null,photoUrl:null,loading:!1,error:r==="SignedOut"?null:new Error("Provider not signed in")});return}if(!e){f||u(h=>({...h,loading:!0}));return}const T=o||i;if(!T){f||u({user:null,presence:null,photoUrl:null,loading:!1,error:null});return}const E=Z(T),c=s.enabled?await ee(E):null,x=!!(c?.user&&U(c.userCachedAt,s.userTtlMs)),A=!!(c?.presenceCachedAt&&U(c.presenceCachedAt,s.presenceTtlMs)),b=!!(c?.photoCachedAt&&U(c.photoCachedAt,s.photoTtlMs));if(x&&(!a||A)&&(!l||b)){f||u({user:c?.user??null,presence:a?c?.presence??null:null,photoUrl:l?c?.photoUrl??null:null,loading:!1,error:null});return}try{u(v=>({...v,loading:!0,error:null}));const h=T.toLowerCase()==="me",y=Date.now();let k=!1,w=!1,C=!1,p=x?c?.user??null:null;if(p||(p=await e.api(h?"/me":`/users/${T}`).select("id,displayName,jobTitle,mail,department,officeLocation,userPrincipalName").get(),k=!0),f)return;let I=null,M=null;if(a){if(A)I=c?.presence??null;else if(p?.id){try{I=await e.api(h?"/me/presence":`/users/${p.id}/presence`).get()}catch(v){console.warn("Failed to fetch presence:",v)}w=!0}}if(l){if(b)M=c?.photoUrl??null;else if(p?.id){try{const v=await e.api(h?"/me/photo/$value":`/users/${p.id}/photo/$value`).get();M=await ae(v)}catch(v){console.warn("Failed to fetch photo:",v)}C=!0}}const g={...c??{}};k&&p&&(g.user=p,g.userCachedAt=y),a&&(w||A)&&(g.presence=w?I:c?.presence,g.presenceCachedAt=w?y:c?.presenceCachedAt),l&&(C||b)&&(g.photoUrl=C?M:c?.photoUrl,g.photoCachedAt=C?y:c?.photoCachedAt),s.enabled&&(k||w||C)&&g.user&&await te(E,g),f||u({user:p,presence:I,photoUrl:M,loading:!1,error:null})}catch(h){f||u({user:null,presence:null,photoUrl:null,loading:!1,error:h})}})(),()=>{f=!0}},[e,n,r,o,i,a,l,s]),m},ce=t=>{switch(t?.toLowerCase()){case"available":case"availableidle":return"available";case"away":case"berightback":return"away";case"busy":case"busyidle":case"donotdisturb":return"busy";default:return"offline"}},ie=({userId:t,userPrincipalName:e,email:n,personDetails:r,view:s="oneline",showPresence:o=!1,fetchImage:i=!0,...a})=>{const{user:l,presence:m,photoUrl:u,loading:f}=K({userId:r?void 0:t||e||n,fetchPresence:o,fetchPhoto:i}),S=r||l;if(f)return F.jsx(L.Persona,{...a,name:a.name??"Loading..."});if(!S)return null;const T=S.displayName||"Unknown User",E=re(T),c=s!=="avatar"&&(s==="twolines"||s==="threelines"||s==="fourlines")?S.jobTitle??void 0:void 0,x=s!=="avatar"&&(s==="threelines"||s==="fourlines")?S.department??void 0:void 0,A=s!=="avatar"&&s==="fourlines"?S.officeLocation??S.mail??void 0:void 0,b=o&&m?{status:ce(m.availability)}:void 0,h=a.presence??b,y=a.avatar??{image:u?{src:u}:void 0,initials:u?void 0:E},k=a.name??T,w=a.secondaryText??c,C=a.tertiaryText??x,p=a.quaternaryText??A;return F.jsx(L.Persona,{...a,name:k,avatar:y,presence:h,secondaryText:w,tertiaryText:C,quaternaryText:p})};function le(t){return`See https://aka.ms/msal.js.errors#${t} for details`}class j extends Error{constructor(e,n,r){const s=n||(e?le(e):""),o=s?`${e}: ${s}`:e;super(o),Object.setPrototypeOf(this,j.prototype),this.errorCode=e||"",this.errorMessage=s||"",this.subError=r||"",this.name="AuthError"}setCorrelationId(e){this.correlationId=e}}class H extends j{constructor(e,n,r,s,o,i,a,l){super(e,n,r),Object.setPrototypeOf(this,H.prototype),this.timestamp=s||"",this.traceId=o||"",this.correlationId=i||"",this.claims=a||"",this.name="InteractionRequiredAuthError",this.errorNo=l}}class ue{msalInstance;defaultScopes;account=null;state="Loading";listeners=[];constructor(e,n){this.msalInstance=e,this.defaultScopes=n}async initialize(){await this.msalInstance.initialize(),await this.msalInstance.handleRedirectPromise();const e=this.msalInstance.getActiveAccount(),n=this.msalInstance.getAllAccounts();this.account=e??n[0]??null,this.account?(this.msalInstance.setActiveAccount(this.account),this.setState("SignedIn")):this.setState("SignedOut")}async login(){const e={scopes:this.defaultScopes},n=await this.msalInstance.loginPopup(e);this.account=n.account,this.account&&this.msalInstance.setActiveAccount(this.account),this.setState("SignedIn")}async logout(){const e=this.msalInstance.getActiveAccount()??this.account??void 0;await this.msalInstance.logoutPopup({account:e}),this.account=null,this.setState("SignedOut")}async getAccessToken(e){const n=e&&e.length>0?e:this.defaultScopes,r=this.msalInstance.getActiveAccount()??this.account;if(!r)throw new Error("No active account. User must sign in first.");const s={scopes:n,account:r};try{return(await this.msalInstance.acquireTokenSilent(s)).accessToken}catch(o){if(o instanceof H){const i={scopes:n,account:r};return(await this.msalInstance.acquireTokenPopup(i)).accessToken}throw o}}getState(){return this.state}onStateChanged(e){this.listeners.push(e)}removeStateChangedHandler(e){this.listeners=this.listeners.filter(n=>n!==e)}setState(e){this.state=e,this.emit()}emit(){for(const e of this.listeners)try{e()}catch{}}}const he=6e4;function de(t){const e=t.fetchFn??fetch;return async({ssoToken:n,scopes:r})=>{const s=await e(t.endpoint,{method:"POST",headers:{Authorization:`Bearer ${n}`,"Content-Type":"application/json"},body:JSON.stringify({scopes:r})}),o=await s.json().catch(()=>({error:s.statusText||"Token exchange failed"}));if(!s.ok){const i=o?.error||o?.message||s.statusText;throw new Error(`Backend token exchange failed: ${i}`)}if(!o?.accessToken)throw new Error("Backend token exchange response did not include accessToken.");return{accessToken:o.accessToken,expiresAt:o.expiresAt}}}class fe{defaultScopes;getTeamsSsoTokenFn;exchangeForGraphTokenFn;refreshSkewMs;state="SignedOut";listeners=[];tokenCache=new Map;constructor(e){if(!e.defaultScopes||e.defaultScopes.length===0)throw new Error("TeamsHostedProvider requires at least one default scope.");this.defaultScopes=[...new Set(e.defaultScopes)],this.getTeamsSsoTokenFn=e.getTeamsSsoToken,this.exchangeForGraphTokenFn=e.exchangeForGraphToken,this.refreshSkewMs=e.refreshSkewMs??he}async login(){try{await this.getAccessToken(),this.setState("SignedIn")}catch(e){throw this.clearCache(),this.setState("SignedOut"),e}}async logout(){this.clearCache(),this.setState("SignedOut")}async getAccessToken(e){const n=this.normalizeScopes(e),r=this.buildScopeKey(n),s=this.tokenCache.get(r);if(s&&this.isTokenValid(s))return s.accessToken;const o=await this.getTeamsSsoTokenFn(n);if(!o)throw new Error("Teams SSO token acquisition returned empty token.");const i=await this.exchangeForGraphTokenFn({ssoToken:o,scopes:n}),a=this.normalizeExchangedToken(i);return this.tokenCache.set(r,a),this.setState("SignedIn"),a.accessToken}getState(){return this.state}onStateChanged(e){this.listeners.push(e)}removeStateChangedHandler(e){this.listeners=this.listeners.filter(n=>n!==e)}normalizeScopes(e){const n=e&&e.length>0?e:this.defaultScopes,r=[...new Set(n.filter(Boolean))];if(r.length===0)throw new Error("At least one scope is required to request a Graph token.");return r}buildScopeKey(e){return[...e].sort().join(" ")}isTokenValid(e){return e.expiresAtMs?Date.now()+this.refreshSkewMs<e.expiresAtMs:!0}normalizeExchangedToken(e){if(typeof e=="string"){if(!e)throw new Error("Graph token exchange returned empty access token.");return{accessToken:e}}if(!e.accessToken)throw new Error("Graph token exchange returned empty access token.");return{accessToken:e.accessToken,expiresAtMs:this.toEpochMs(e.expiresAt)}}toEpochMs(e){if(e)return e instanceof Date?e.getTime():e}clearCache(){this.tokenCache.clear()}setState(e){this.state!==e&&(this.state=e,this.emit())}emit(){for(const e of this.listeners)try{e()}catch{}}}exports.GraphProvider=ne;exports.MockProvider=B;exports.MsalBrowserProvider=ue;exports.Person=ie;exports.TeamsHostedProvider=fe;exports.createBackendTokenExchange=de;exports.createMockSignedInProvider=oe;exports.useGraphClient=z;exports.usePersonCacheOptions=$;exports.usePersonData=K;exports.useProvider=N;exports.useProviderState=_;

package/dist/index.mjs

@@ -1,59 +1,122 @@
-import { jsx as w } from "react/jsx-runtime";
-import { Persona as C } from "@fluentui/react-components";
-import { createContext as j, useCallback as x, useSyncExternalStore as G, useMemo as E, useContext as M, useState as q, useEffect as z } from "react";
-import { Client as N } from "@microsoft/microsoft-graph-client";
-var o = /* @__PURE__ */ ((t) => (t.Loading = "Loading", t.SignedOut = "SignedOut", t.SignedIn = "SignedIn", t))(o || {});
-const v = j({
+import { jsx as U } from "react/jsx-runtime";
+import { Persona as H } from "@fluentui/react-components";
+import { createContext as K, useCallback as L, useSyncExternalStore as V, useMemo as F, useContext as N, useState as Q, useEffect as J } from "react";
+import { Client as W } from "@microsoft/microsoft-graph-client";
+const X = "graph-toolkit-person-cache", v = "personData", Y = 1, Z = 3600 * 1e3, ee = 3600 * 1e3, te = 300 * 1e3, j = {
+  enabled: !0,
+  userTtlMs: Z,
+  photoTtlMs: ee,
+  presenceTtlMs: te
+}, _ = () => typeof window < "u" && typeof window.indexedDB < "u", R = (t) => new Promise((e, n) => {
+  t.onsuccess = () => e(t.result), t.onerror = () => n(t.error);
+}), q = () => new Promise((t, e) => {
+  if (!_()) {
+    e(new Error("IndexedDB unavailable"));
+    return;
+  }
+  const n = window.indexedDB.open(X, Y);
+  n.onupgradeneeded = () => {
+    const r = n.result;
+    r.objectStoreNames.contains(v) || r.createObjectStore(v);
+  }, n.onsuccess = () => t(n.result), n.onerror = () => e(n.error);
+}), ne = (t) => `person:${t.trim().toLowerCase()}`, M = (t, e) => t ? Date.now() - t < e : !1, se = async (t) => {
+  if (!_())
+    return null;
+  let e = null;
+  try {
+    e = await q();
+    const r = e.transaction(v, "readonly").objectStore(v);
+    return await R(r.get(t)) ?? null;
+  } catch {
+    return null;
+  } finally {
+    e?.close();
+  }
+}, re = async (t, e) => {
+  if (!_())
+    return;
+  let n = null;
+  try {
+    n = await q();
+    const s = n.transaction(v, "readwrite").objectStore(v);
+    await R(s.put(e, t));
+  } catch {
+    return;
+  } finally {
+    n?.close();
+  }
+}, O = K({
   provider: null,
-  state: o.Loading
-}), Y = ({ provider: t, children: e }) => {
-  const s = x(
-    () => t?.getState?.() ?? o.Loading,
+  state: "Loading",
+  personCacheOptions: j
+}), Te = ({
+  provider: t,
+  children: e,
+  personCacheOptions: n
+}) => {
+  const r = L(
+    () => t?.getState?.() ?? "Loading",
     [t]
-  ), r = x(
-    (i) => (t.onStateChanged?.(i), () => {
-      const c = t;
-      typeof c.removeStateChangedHandler == "function" && c.removeStateChangedHandler(i);
+  ), s = L(
+    (l) => (t.onStateChanged?.(l), () => {
+      const g = t;
+      typeof g.removeStateChangedHandler == "function" && g.removeStateChangedHandler(l);
     }),
     [t]
-  ), n = G(r, s, s), a = E(() => ({ provider: t, state: n }), [t, n]);
-  return /* @__PURE__ */ w(v.Provider, { value: a, children: e });
-}, U = () => {
-  const { provider: t } = M(v);
+  ), o = V(s, r, r), i = F(
+    () => ({
+      ...j,
+      ...n ?? {}
+    }),
+    [n]
+  ), a = F(
+    () => ({
+      provider: t,
+      state: o,
+      personCacheOptions: i
+    }),
+    [t, o, i]
+  );
+  return /* @__PURE__ */ U(O.Provider, { value: a, children: e });
+}, G = () => {
+  const { provider: t } = N(O);
+  return t;
+}, $ = () => {
+  const { state: t } = N(O);
   return t;
-}, O = () => {
-  const { state: t } = M(v);
+}, oe = () => {
+  const { personCacheOptions: t } = N(O);
   return t;
-}, $ = (t) => N.init({
+}, ae = (t) => W.init({
   authProvider: async (e) => {
     try {
-      const s = await t.getAccessToken();
-      e(null, s);
-    } catch (s) {
-      e(s, null);
+      const n = await t.getAccessToken();
+      e(null, n);
+    } catch (n) {
+      e(n, null);
     }
   }
-}), B = (t) => {
+}), ce = (t) => {
   const e = t.trim().split(" ");
   return e.length === 1 ? e[0].substring(0, 2).toUpperCase() : (e[0][0] + e[e.length - 1][0]).toUpperCase();
-}, D = () => {
-  const t = U(), e = O();
-  return E(() => !t || e !== "SignedIn" ? null : $(t), [t, e]);
+}, ie = () => {
+  const t = G(), e = $();
+  return F(() => !t || e !== "SignedIn" ? null : ae(t), [t, e]);
 };
-class F {
-  state = o.SignedOut;
+class z {
+  state = "SignedOut";
   listeners = [];
   constructor(e) {
-    e?.autoSignIn && (this.state = o.SignedIn);
+    e?.autoSignIn && (this.state = "SignedIn");
   }
   getAccessToken() {
-    return this.state !== o.SignedIn ? Promise.reject(new Error("Not signed in")) : Promise.resolve("mock-token");
+    return this.state !== "SignedIn" ? Promise.reject(new Error("Not signed in")) : Promise.resolve("mock-token");
   }
   async login() {
-    this.state = o.SignedIn, this.emit();
+    this.state = "SignedIn", this.emit();
   }
   async logout() {
-    this.state = o.SignedOut, this.emit();
+    this.state = "SignedOut", this.emit();
   }
   getState() {
     return this.state;
@@ -62,7 +125,7 @@ class F {
     this.listeners.push(e);
   }
   removeStateChangedHandler(e) {
-    this.listeners = this.listeners.filter((s) => s !== e);
+    this.listeners = this.listeners.filter((n) => n !== e);
   }
   emit() {
     for (const e of this.listeners)
@@ -72,19 +135,29 @@ class F {
       }
   }
 }
-const Z = () => new F({ autoSignIn: !0 }), H = (t) => {
-  const e = D(), s = U(), r = O(), { userId: n, userPrincipalName: a, fetchPresence: i = !1, fetchPhoto: c = !0 } = t, [p, d] = q({
+const ye = () => new z({ autoSignIn: !0 }), le = async (t) => {
+  if (!t)
+    return null;
+  if (typeof t == "string")
+    return t;
+  const e = t instanceof Blob ? t : t instanceof ArrayBuffer ? new Blob([t]) : null;
+  return e ? new Promise((n, r) => {
+    const s = new FileReader();
+    s.onloadend = () => n(typeof s.result == "string" ? s.result : null), s.onerror = () => r(s.error), s.readAsDataURL(e);
+  }) : null;
+}, ue = (t) => {
+  const e = ie(), n = G(), r = $(), s = oe(), { userId: o, userPrincipalName: i, fetchPresence: a = !1, fetchPhoto: l = !0 } = t, [g, u] = Q({
     user: null,
     presence: null,
     photoUrl: null,
     loading: !0,
     error: null
   });
-  return z(() => {
-    let h = !1;
+  return J(() => {
+    let d = !1;
     return (async () => {
-      if (s instanceof F) {
-        const l = {
+      if (n instanceof z) {
+        const h = {
           id: "00000000-0000-0000-0000-000000000000",
           displayName: "Adele Vance",
           userPrincipalName: "adelev@contoso.com",
@@ -92,23 +165,23 @@ const Z = () => new F({ autoSignIn: !0 }), H = (t) => {
           department: "Marketing",
           officeLocation: "19/3106",
           mail: "adelev@contoso.com"
-        }, u = {
+        }, T = {
           availability: "Available",
           activity: "Available",
-          id: l.id,
+          id: h.id,
           odataType: "#microsoft.graph.presence"
         };
-        h || d({
-          user: l,
-          presence: i ? u : null,
-          photoUrl: c ? "https://ui-avatars.com/api/?name=Adele+Vance&background=0D8ABC&color=ffffff" : null,
+        d || u({
+          user: h,
+          presence: a ? T : null,
+          photoUrl: l ? "https://ui-avatars.com/api/?name=Adele+Vance&background=0D8ABC&color=ffffff" : null,
           loading: !1,
           error: null
         });
         return;
       }
       if (r !== "SignedIn") {
-        h || d({
+        d || u({
           user: null,
           presence: null,
           photoUrl: null,
@@ -118,12 +191,12 @@ const Z = () => new F({ autoSignIn: !0 }), H = (t) => {
         return;
       }
       if (!e) {
-        h || d((l) => ({ ...l, loading: !0 }));
+        d || u((h) => ({ ...h, loading: !0 }));
         return;
       }
-      const g = n || a;
-      if (!g) {
-        h || d({
+      const S = o || i;
+      if (!S) {
+        d || u({
           user: null,
           presence: null,
           photoUrl: null,
@@ -132,64 +205,81 @@ const Z = () => new F({ autoSignIn: !0 }), H = (t) => {
         });
         return;
       }
+      const E = ne(S), c = s.enabled ? await se(E) : null, b = !!(c?.user && M(c.userCachedAt, s.userTtlMs)), A = !!(c?.presenceCachedAt && M(c.presenceCachedAt, s.presenceTtlMs)), P = !!(c?.photoCachedAt && M(c.photoCachedAt, s.photoTtlMs));
+      if (b && (!a || A) && (!l || P)) {
+        d || u({
+          user: c?.user ?? null,
+          presence: a ? c?.presence ?? null : null,
+          photoUrl: l ? c?.photoUrl ?? null : null,
+          loading: !1,
+          error: null
+        });
+        return;
+      }
       try {
-        d((f) => ({ ...f, loading: !0, error: null }));
-        const l = g.toLowerCase() === "me", u = await e.api(l ? "/me" : `/users/${g}`).select("id,displayName,jobTitle,mail,department,officeLocation,userPrincipalName").get();
-        if (h) return;
-        let m = null, S = null;
-        if (i && u.id)
-          try {
-            m = await e.api(l ? "/me/presence" : `/users/${u.id}/presence`).get();
-          } catch (f) {
-            console.warn("Failed to fetch presence:", f);
+        u((k) => ({ ...k, loading: !0, error: null }));
+        const h = S.toLowerCase() === "me", T = Date.now();
+        let C = !1, y = !1, w = !1, f = b ? c?.user ?? null : null;
+        if (f || (f = await e.api(h ? "/me" : `/users/${S}`).select("id,displayName,jobTitle,mail,department,officeLocation,userPrincipalName").get(), C = !0), d) return;
+        let x = null, I = null;
+        if (a) {
+          if (A)
+            x = c?.presence ?? null;
+          else if (f?.id) {
+            try {
+              x = await e.api(h ? "/me/presence" : `/users/${f.id}/presence`).get();
+            } catch (k) {
+              console.warn("Failed to fetch presence:", k);
+            }
+            y = !0;
           }
-        if (c && u.id)
-          try {
-            const f = await e.api(l ? "/me/photo/$value" : `/users/${u.id}/photo/$value`).get();
-            S = URL.createObjectURL(f);
-          } catch (f) {
-            console.warn("Failed to fetch photo:", f);
+        }
+        if (l) {
+          if (P)
+            I = c?.photoUrl ?? null;
+          else if (f?.id) {
+            try {
+              const k = await e.api(h ? "/me/photo/$value" : `/users/${f.id}/photo/$value`).get();
+              I = await le(k);
+            } catch (k) {
+              console.warn("Failed to fetch photo:", k);
+            }
+            w = !0;
           }
-        h || d({
-          user: u,
-          presence: m,
-          photoUrl: S,
+        }
+        const p = {
+          ...c ?? {}
+        };
+        C && f && (p.user = f, p.userCachedAt = T), a && (y || A) && (p.presence = y ? x : c?.presence, p.presenceCachedAt = y ? T : c?.presenceCachedAt), l && (w || P) && (p.photoUrl = w ? I : c?.photoUrl, p.photoCachedAt = w ? T : c?.photoCachedAt), s.enabled && (C || y || w) && p.user && await re(E, p), d || u({
+          user: f,
+          presence: x,
+          photoUrl: I,
           loading: !1,
           error: null
         });
-      } catch (l) {
-        h || d({
+      } catch (h) {
+        d || u({
           user: null,
           presence: null,
           photoUrl: null,
           loading: !1,
-          error: l
+          error: h
         });
       }
     })(), () => {
-      h = !0;
+      d = !0;
     };
   }, [
     e,
-    s,
-    r,
     n,
-    a,
+    r,
+    o,
     i,
-    c
-  ]), p;
-}, R = (t) => {
-  switch (t) {
-    case "small":
-      return "small";
-    case "large":
-      return "large";
-    case "extra-large":
-      return "extra-large";
-    default:
-      return "medium";
-  }
-}, K = (t) => {
+    a,
+    l,
+    s
+  ]), g;
+}, he = (t) => {
   switch (t?.toLowerCase()) {
     case "available":
     case "availableidle":
@@ -204,117 +294,108 @@ const Z = () => new F({ autoSignIn: !0 }), H = (t) => {
     default:
       return "offline";
   }
-}, ee = ({
+}, we = ({
   userId: t,
   userPrincipalName: e,
-  email: s,
+  email: n,
   personDetails: r,
-  view: n = "oneline",
-  showPresence: a = !1,
-  avatarSize: i = "medium",
-  textAlignment: c,
-  textPosition: p,
-  numericSize: d,
-  fetchImage: h = !0,
-  onClick: T,
-  className: g,
-  style: l
+  view: s = "oneline",
+  showPresence: o = !1,
+  fetchImage: i = !0,
+  ...a
 }) => {
-  const { user: u, presence: m, photoUrl: S, loading: f } = H({
-    userId: r ? void 0 : t || e || s,
-    fetchPresence: a,
-    fetchPhoto: h
-  }), y = r || u, A = d ?? R(i);
-  if (f)
-    return /* @__PURE__ */ w(
-      C,
+  const { user: l, presence: g, photoUrl: u, loading: d } = ue({
+    userId: r ? void 0 : t || e || n,
+    fetchPresence: o,
+    fetchPhoto: i
+  }), m = r || l;
+  if (d)
+    return /* @__PURE__ */ U(
+      H,
       {
-        size: A,
-        name: "Loading...",
-        textAlignment: c,
-        textPosition: p,
-        className: g,
-        style: l
+        ...a,
+        name: a.name ?? "Loading..."
       }
     );
-  if (!y)
+  if (!m)
     return null;
-  const b = y.displayName || "Unknown User", L = B(b), k = {
-    size: A,
-    name: b,
-    textAlignment: c,
-    textPosition: p,
-    avatar: {
-      image: S ? { src: S } : void 0,
-      initials: S ? void 0 : L
-    },
-    className: g,
-    style: l
-  };
-  return a && m && (k.presence = {
-    status: K(m.availability)
-  }), n !== "avatar" && ((n === "twolines" || n === "threelines") && (k.secondaryText = y.jobTitle ?? void 0), n === "threelines" && (k.tertiaryText = y.department ?? void 0)), T && (k.onClick = () => {
-    u && T(u);
-  }), /* @__PURE__ */ w(C, { ...k });
+  const S = m.displayName || "Unknown User", E = ce(S), c = s !== "avatar" && (s === "twolines" || s === "threelines" || s === "fourlines") ? m.jobTitle ?? void 0 : void 0, b = s !== "avatar" && (s === "threelines" || s === "fourlines") ? m.department ?? void 0 : void 0, A = s !== "avatar" && s === "fourlines" ? m.officeLocation ?? m.mail ?? void 0 : void 0, P = o && g ? {
+    status: he(g.availability)
+  } : void 0, h = a.presence ?? P, T = a.avatar ?? {
+    image: u ? { src: u } : void 0,
+    initials: u ? void 0 : E
+  }, C = a.name ?? S, y = a.secondaryText ?? c, w = a.tertiaryText ?? b, f = a.quaternaryText ?? A;
+  return /* @__PURE__ */ U(
+    H,
+    {
+      ...a,
+      name: C,
+      avatar: T,
+      presence: h,
+      secondaryText: y,
+      tertiaryText: w,
+      quaternaryText: f
+    }
+  );
 };
-function V(t) {
+function de(t) {
   return `See https://aka.ms/msal.js.errors#${t} for details`;
 }
-class I extends Error {
-  constructor(e, s, r) {
-    const n = s || (e ? V(e) : ""), a = n ? `${e}: ${n}` : e;
-    super(a), Object.setPrototypeOf(this, I.prototype), this.errorCode = e || "", this.errorMessage = n || "", this.subError = r || "", this.name = "AuthError";
+class D extends Error {
+  constructor(e, n, r) {
+    const s = n || (e ? de(e) : ""), o = s ? `${e}: ${s}` : e;
+    super(o), Object.setPrototypeOf(this, D.prototype), this.errorCode = e || "", this.errorMessage = s || "", this.subError = r || "", this.name = "AuthError";
   }
   setCorrelationId(e) {
     this.correlationId = e;
   }
 }
-class P extends I {
-  constructor(e, s, r, n, a, i, c, p) {
-    super(e, s, r), Object.setPrototypeOf(this, P.prototype), this.timestamp = n || "", this.traceId = a || "", this.correlationId = i || "", this.claims = c || "", this.name = "InteractionRequiredAuthError", this.errorNo = p;
+class B extends D {
+  constructor(e, n, r, s, o, i, a, l) {
+    super(e, n, r), Object.setPrototypeOf(this, B.prototype), this.timestamp = s || "", this.traceId = o || "", this.correlationId = i || "", this.claims = a || "", this.name = "InteractionRequiredAuthError", this.errorNo = l;
   }
 }
-class te {
+class ke {
   msalInstance;
   defaultScopes;
   account = null;
-  state = o.Loading;
+  state = "Loading";
   listeners = [];
-  constructor(e, s) {
-    this.msalInstance = e, this.defaultScopes = s;
+  constructor(e, n) {
+    this.msalInstance = e, this.defaultScopes = n;
   }
   async initialize() {
     await this.msalInstance.initialize(), await this.msalInstance.handleRedirectPromise();
-    const e = this.msalInstance.getActiveAccount(), s = this.msalInstance.getAllAccounts();
-    this.account = e ?? s[0] ?? null, this.account ? (this.msalInstance.setActiveAccount(this.account), this.setState(o.SignedIn)) : this.setState(o.SignedOut);
+    const e = this.msalInstance.getActiveAccount(), n = this.msalInstance.getAllAccounts();
+    this.account = e ?? n[0] ?? null, this.account ? (this.msalInstance.setActiveAccount(this.account), this.setState("SignedIn")) : this.setState("SignedOut");
   }
   async login() {
-    const e = { scopes: this.defaultScopes }, s = await this.msalInstance.loginPopup(e);
-    this.account = s.account, this.account && this.msalInstance.setActiveAccount(this.account), this.setState(o.SignedIn);
+    const e = { scopes: this.defaultScopes }, n = await this.msalInstance.loginPopup(e);
+    this.account = n.account, this.account && this.msalInstance.setActiveAccount(this.account), this.setState("SignedIn");
   }
   async logout() {
     const e = this.msalInstance.getActiveAccount() ?? this.account ?? void 0;
-    await this.msalInstance.logoutPopup({ account: e }), this.account = null, this.setState(o.SignedOut);
+    await this.msalInstance.logoutPopup({ account: e }), this.account = null, this.setState("SignedOut");
   }
   async getAccessToken(e) {
-    const s = e && e.length > 0 ? e : this.defaultScopes, r = this.msalInstance.getActiveAccount() ?? this.account;
+    const n = e && e.length > 0 ? e : this.defaultScopes, r = this.msalInstance.getActiveAccount() ?? this.account;
     if (!r)
       throw new Error("No active account. User must sign in first.");
-    const n = {
-      scopes: s,
+    const s = {
+      scopes: n,
       account: r
     };
     try {
-      return (await this.msalInstance.acquireTokenSilent(n)).accessToken;
-    } catch (a) {
-      if (a instanceof P) {
+      return (await this.msalInstance.acquireTokenSilent(s)).accessToken;
+    } catch (o) {
+      if (o instanceof B) {
         const i = {
-          scopes: s,
+          scopes: n,
           account: r
         };
         return (await this.msalInstance.acquireTokenPopup(i)).accessToken;
       }
-      throw a;
+      throw o;
     }
   }
   getState() {
@@ -324,7 +405,7 @@ class te {
     this.listeners.push(e);
   }
   removeStateChangedHandler(e) {
-    this.listeners = this.listeners.filter((s) => s !== e);
+    this.listeners = this.listeners.filter((n) => n !== e);
   }
   setState(e) {
     this.state = e, this.emit();
@@ -337,65 +418,68 @@ class te {
       }
   }
 }
-const J = 6e4;
-function se(t) {
+const fe = 6e4;
+function Ce(t) {
   const e = t.fetchFn ?? fetch;
-  return async ({ ssoToken: s, scopes: r }) => {
-    const n = await e(t.endpoint, {
+  return async ({
+    ssoToken: n,
+    scopes: r
+  }) => {
+    const s = await e(t.endpoint, {
       method: "POST",
       headers: {
-        Authorization: `Bearer ${s}`,
+        Authorization: `Bearer ${n}`,
         "Content-Type": "application/json"
       },
       body: JSON.stringify({ scopes: r })
-    }), a = await n.json().catch(() => ({ error: n.statusText || "Token exchange failed" }));
-    if (!n.ok) {
-      const i = a?.error || a?.message || n.statusText;
+    }), o = await s.json().catch(() => ({ error: s.statusText || "Token exchange failed" }));
+    if (!s.ok) {
+      const i = o?.error || o?.message || s.statusText;
       throw new Error(`Backend token exchange failed: ${i}`);
     }
-    if (!a?.accessToken)
+    if (!o?.accessToken)
       throw new Error("Backend token exchange response did not include accessToken.");
     return {
-      accessToken: a.accessToken,
-      expiresAt: a.expiresAt
+      accessToken: o.accessToken,
+      expiresAt: o.expiresAt
     };
   };
 }
-class ne {
+class ve {
   defaultScopes;
   getTeamsSsoTokenFn;
   exchangeForGraphTokenFn;
   refreshSkewMs;
-  state = o.SignedOut;
+  state = "SignedOut";
   listeners = [];
   tokenCache = /* @__PURE__ */ new Map();
   constructor(e) {
     if (!e.defaultScopes || e.defaultScopes.length === 0)
       throw new Error("TeamsHostedProvider requires at least one default scope.");
-    this.defaultScopes = [...new Set(e.defaultScopes)], this.getTeamsSsoTokenFn = e.getTeamsSsoToken, this.exchangeForGraphTokenFn = e.exchangeForGraphToken, this.refreshSkewMs = e.refreshSkewMs ?? J;
+    this.defaultScopes = [...new Set(e.defaultScopes)], this.getTeamsSsoTokenFn = e.getTeamsSsoToken, this.exchangeForGraphTokenFn = e.exchangeForGraphToken, this.refreshSkewMs = e.refreshSkewMs ?? fe;
   }
   async login() {
     try {
-      await this.getAccessToken(), this.setState(o.SignedIn);
+      await this.getAccessToken(), this.setState("SignedIn");
     } catch (e) {
-      throw this.clearCache(), this.setState(o.SignedOut), e;
+      throw this.clearCache(), this.setState("SignedOut"), e;
     }
   }
   async logout() {
-    this.clearCache(), this.setState(o.SignedOut);
+    this.clearCache(), this.setState("SignedOut");
   }
   async getAccessToken(e) {
-    const s = this.normalizeScopes(e), r = this.buildScopeKey(s), n = this.tokenCache.get(r);
-    if (n && this.isTokenValid(n))
-      return n.accessToken;
-    const a = await this.getTeamsSsoTokenFn(s);
-    if (!a)
+    const n = this.normalizeScopes(e), r = this.buildScopeKey(n), s = this.tokenCache.get(r);
+    if (s && this.isTokenValid(s))
+      return s.accessToken;
+    const o = await this.getTeamsSsoTokenFn(n);
+    if (!o)
       throw new Error("Teams SSO token acquisition returned empty token.");
     const i = await this.exchangeForGraphTokenFn({
-      ssoToken: a,
-      scopes: s
-    }), c = this.normalizeExchangedToken(i);
-    return this.tokenCache.set(r, c), this.setState(o.SignedIn), c.accessToken;
+      ssoToken: o,
+      scopes: n
+    }), a = this.normalizeExchangedToken(i);
+    return this.tokenCache.set(r, a), this.setState("SignedIn"), a.accessToken;
   }
   getState() {
     return this.state;
@@ -404,10 +488,10 @@ class ne {
     this.listeners.push(e);
   }
   removeStateChangedHandler(e) {
-    this.listeners = this.listeners.filter((s) => s !== e);
+    this.listeners = this.listeners.filter((n) => n !== e);
   }
   normalizeScopes(e) {
-    const s = e && e.length > 0 ? e : this.defaultScopes, r = [...new Set(s.filter(Boolean))];
+    const n = e && e.length > 0 ? e : this.defaultScopes, r = [...new Set(n.filter(Boolean))];
     if (r.length === 0)
       throw new Error("At least one scope is required to request a Graph token.");
     return r;
@@ -450,16 +534,16 @@ class ne {
   }
 }
 export {
-  Y as GraphProvider,
-  F as MockProvider,
-  te as MsalBrowserProvider,
-  ee as Person,
-  o as ProviderState,
-  ne as TeamsHostedProvider,
-  se as createBackendTokenExchange,
-  Z as createMockSignedInProvider,
-  D as useGraphClient,
-  H as usePersonData,
-  U as useProvider,
-  O as useProviderState
+  Te as GraphProvider,
+  z as MockProvider,
+  ke as MsalBrowserProvider,
+  we as Person,
+  ve as TeamsHostedProvider,
+  Ce as createBackendTokenExchange,
+  ye as createMockSignedInProvider,
+  ie as useGraphClient,
+  oe as usePersonCacheOptions,
+  ue as usePersonData,
+  G as useProvider,
+  $ as useProviderState
 };

package/dist/providers/IProvider.d.ts

@@ -1,11 +1,7 @@
 /**
  * Provider interface for Microsoft Graph authentication
  */
-export declare enum ProviderState {
-    Loading = "Loading",
-    SignedOut = "SignedOut",
-    SignedIn = "SignedIn"
-}
+export type ProviderState = 'Loading' | 'SignedOut' | 'SignedIn';
 export interface IProvider {
     /**
      * Get an access token for the specified scopes

package/dist/providers/IProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IProvider.d.ts","sourceRoot":"","sources":["../../src/providers/IProvider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oBAAY,aAAa;IACvB,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,QAAQ,aAAa;CACtB;AAED,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnD;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;OAEG;IACH,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAExB;;OAEG;IACH,QAAQ,IAAI,aAAa,CAAC;IAE1B;;OAEG;IACH,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;CAChD"}
+{"version":3,"file":"IProvider.d.ts","sourceRoot":"","sources":["../../src/providers/IProvider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC;AAEjE,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnD;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;OAEG;IACH,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAExB;;OAEG;IACH,QAAQ,IAAI,aAAa,CAAC;IAE1B;;OAEG;IACH,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;CAChD"}

package/dist/providers/MockProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MockProvider.d.ts","sourceRoot":"","sources":["../../src/providers/MockProvider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIvD,qBAAa,YAAa,YAAW,SAAS;IAC5C,OAAO,CAAC,KAAK,CAA0C;IACvD,OAAO,CAAC,SAAS,CAAuB;gBAC5B,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAMnE,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAQ3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAK7B,QAAQ,IAAI,aAAa;IAIzB,cAAc,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAIzC,yBAAyB,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAIpD,OAAO,CAAC,IAAI;CASb;AAED,eAAO,MAAM,0BAA0B,oBAA+C,CAAC"}
+{"version":3,"file":"MockProvider.d.ts","sourceRoot":"","sources":["../../src/providers/MockProvider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIvD,qBAAa,YAAa,YAAW,SAAS;IAC5C,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,SAAS,CAAuB;gBAC5B,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAMnE,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAQ3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAK7B,QAAQ,IAAI,aAAa;IAIzB,cAAc,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAIzC,yBAAyB,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAIpD,OAAO,CAAC,IAAI;CASb;AAED,eAAO,MAAM,0BAA0B,oBAA+C,CAAC"}

package/dist/providers/MsalBrowserProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MsalBrowserProvider.d.ts","sourceRoot":"","sources":["../../src/providers/MsalBrowserProvider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAIH,uBAAuB,EAE1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEvD,qBAAa,mBAAoB,YAAW,SAAS;IACjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA0B;IACvD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAW;IACzC,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,KAAK,CAAwC;IACrD,OAAO,CAAC,SAAS,CAAyB;gBAE9B,YAAY,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,EAAE;IAKpE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAYtB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAOvB,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IA8BxD,QAAQ,IAAI,aAAa;IAIzB,cAAc,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAIzC,yBAAyB,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAIpD,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,IAAI;CASf"}
+{"version":3,"file":"MsalBrowserProvider.d.ts","sourceRoot":"","sources":["../../src/providers/MsalBrowserProvider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAIL,uBAAuB,EAExB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEvD,qBAAa,mBAAoB,YAAW,SAAS;IACnD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA0B;IACvD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAW;IACzC,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,SAAS,CAAyB;gBAE9B,YAAY,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,EAAE;IAKpE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAYtB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAOvB,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IA8BxD,QAAQ,IAAI,aAAa;IAIzB,cAAc,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAIzC,yBAAyB,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAIpD,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,IAAI;CASb"}

package/dist/providers/ProviderContext.d.ts

@@ -3,9 +3,11 @@
  */
 import React, { ReactNode } from 'react';
 import { IProvider, ProviderState } from './IProvider';
+import { PersonCacheOptions } from '../utils/personCache';
 export interface GraphProviderProps {
     provider: IProvider;
     children: ReactNode;
+    personCacheOptions?: Partial<PersonCacheOptions>;
 }
 export declare const GraphProvider: React.FC<GraphProviderProps>;
 /**
@@ -16,4 +18,8 @@ export declare const useProvider: () => IProvider | null;
  * Hook to access the current provider state
  */
 export declare const useProviderState: () => ProviderState;
+/**
+ * Hook to access configured person cache options
+ */
+export declare const usePersonCacheOptions: () => PersonCacheOptions;
 //# sourceMappingURL=ProviderContext.d.ts.map

package/dist/providers/ProviderContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProviderContext.d.ts","sourceRoot":"","sources":["../../src/providers/ProviderContext.tsx"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,EAIZ,SAAS,EAGV,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAYvD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CA2BtD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,QAAO,SAAS,GAAG,IAG1C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,QAAO,aAGnC,CAAC"}
+{"version":3,"file":"ProviderContext.d.ts","sourceRoot":"","sources":["../../src/providers/ProviderContext.tsx"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,EAIZ,SAAS,EAGV,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAgC,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAcxF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,EAAE,SAAS,CAAC;IACpB,kBAAkB,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAClD;AAED,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CA8CtD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,QAAO,SAAS,GAAG,IAG1C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,QAAO,aAGnC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,QAAO,kBAGxC,CAAC"}

package/dist/providers/TeamsHostedProvider.d.ts

@@ -24,7 +24,7 @@ export interface CreateBackendTokenExchangeOptions {
  * Creates a typed callback for exchanging a Teams SSO token with a backend
  * endpoint that performs OBO and returns a Graph token.
  */
-export declare function createBackendTokenExchange(options: CreateBackendTokenExchangeOptions): ({ ssoToken, scopes }: ExchangeForGraphTokenParams) => Promise<BackendTokenExchangeResponse>;
+export declare function createBackendTokenExchange(options: CreateBackendTokenExchangeOptions): ({ ssoToken, scopes, }: ExchangeForGraphTokenParams) => Promise<BackendTokenExchangeResponse>;
 /**
  * Teams-hosted auth provider for Graph Toolkit React.
  *

package/dist/providers/TeamsHostedProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TeamsHostedProvider.d.ts","sourceRoot":"","sources":["../../src/providers/TeamsHostedProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIvD,MAAM,WAAW,2BAA2B;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,0BAA0B;IACvC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACxD,qBAAqB,EAAE,CACnB,MAAM,EAAE,2BAA2B,KAClC,OAAO,CAAC,MAAM,GAAG,mBAAmB,CAAC,CAAC;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,4BAA6B,SAAQ,mBAAmB;IACrE,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iCAAiC;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AASD;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,iCAAiC,IAGnE,sBAAsB,2BAA2B,KAAG,OAAO,CAAC,4BAA4B,CAAC,CA4B1G;AAED;;;;;;GAMG;AACH,qBAAa,mBAAoB,YAAW,SAAS;IACjD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAW;IACzC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAwC;IAC3E,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAEG;IAC3C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,KAAK,CAA0C;IACvD,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkC;gBAEjD,OAAO,EAAE,0BAA0B;IAWzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAWtB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAKvB,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IA0BxD,QAAQ,IAAI,aAAa;IAIzB,cAAc,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAIzC,yBAAyB,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAIpD,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,uBAAuB;IAmB/B,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,IAAI;CASf"}
+{"version":3,"file":"TeamsHostedProvider.d.ts","sourceRoot":"","sources":["../../src/providers/TeamsHostedProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIvD,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,0BAA0B;IACzC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACxD,qBAAqB,EAAE,CACrB,MAAM,EAAE,2BAA2B,KAChC,OAAO,CAAC,MAAM,GAAG,mBAAmB,CAAC,CAAC;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,4BAA6B,SAAQ,mBAAmB;IACvE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iCAAiC;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CACxB;AASD;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,iCAAiC,IAGrE,uBAGX,2BAA2B,KAAG,OAAO,CAAC,4BAA4B,CAAC,CA4BvE;AAED;;;;;;GAMG;AACH,qBAAa,mBAAoB,YAAW,SAAS;IACnD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAW;IACzC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAwC;IAC3E,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAEG;IAC3C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkC;gBAEjD,OAAO,EAAE,0BAA0B;IAWzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAWtB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAKvB,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IA0BxD,QAAQ,IAAI,aAAa;IAIzB,cAAc,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAIzC,yBAAyB,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAIpD,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,uBAAuB;IAmB/B,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,IAAI;CASb"}

package/dist/utils/personCache.d.ts

@@ -0,0 +1,24 @@
+import { Presence, User } from '@microsoft/microsoft-graph-types';
+export declare const USER_CACHE_TTL_MS: number;
+export declare const PHOTO_CACHE_TTL_MS: number;
+export declare const PRESENCE_CACHE_TTL_MS: number;
+export interface PersonCacheOptions {
+    enabled: boolean;
+    userTtlMs: number;
+    photoTtlMs: number;
+    presenceTtlMs: number;
+}
+export declare const DEFAULT_PERSON_CACHE_OPTIONS: PersonCacheOptions;
+export interface PersonCacheEntry {
+    user?: User | null;
+    userCachedAt?: number;
+    presence?: Presence | null;
+    presenceCachedAt?: number;
+    photoUrl?: string | null;
+    photoCachedAt?: number;
+}
+export declare const getPersonCacheKey: (identifier: string) => string;
+export declare const isTimestampFresh: (timestamp: number | undefined, ttlMs: number) => boolean;
+export declare const readPersonCache: (key: string) => Promise<PersonCacheEntry | null>;
+export declare const writePersonCache: (key: string, value: PersonCacheEntry) => Promise<void>;
+//# sourceMappingURL=personCache.d.ts.map

package/dist/utils/personCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"personCache.d.ts","sourceRoot":"","sources":["../../src/utils/personCache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kCAAkC,CAAC;AAMlE,eAAO,MAAM,iBAAiB,QAAiB,CAAC;AAChD,eAAO,MAAM,kBAAkB,QAAiB,CAAC;AACjD,eAAO,MAAM,qBAAqB,QAAgB,CAAC;AAEnD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,4BAA4B,EAAE,kBAK1C,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAkCD,eAAO,MAAM,iBAAiB,GAAI,YAAY,MAAM,KAAG,MAEtD,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,WAAW,MAAM,GAAG,SAAS,EAAE,OAAO,MAAM,KAAG,OAK/E,CAAC;AAEF,eAAO,MAAM,eAAe,GAAU,KAAK,MAAM,KAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAkBlF,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAU,KAAK,MAAM,EAAE,OAAO,gBAAgB,KAAG,OAAO,CAAC,IAAI,CAiBzF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devsym/graph-toolkit-react",
-  "version": "0.1.0-next.2",
+  "version": "1.0.0-next.6",
   "description": "React components for Microsoft Graph powered by Fluent UI",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -15,6 +15,8 @@
   "files": [
     "dist",
     "README.md",
+    "AGENTS.md",
+    "MGT_MIGRATION.md",
     "LICENSE"
   ],
   "scripts": {
@@ -22,7 +24,7 @@
     "dev": "vite build --watch",
     "changeset": "changeset",
     "version-packages": "changeset version",
-    "publish-packages": "changeset publish",
+    "publish-packages": "changeset publish --provenance",
     "type-check": "tsc --noEmit",
     "lint": "eslint src --ext .ts,.tsx",
     "lint:fix": "eslint src --ext .ts,.tsx --fix",
@@ -43,8 +45,13 @@
   ],
   "author": "",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ThomasPe/graph-toolkit-react"
+  },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "tag": "next"
   },
   "peerDependencies": {
     "@azure/msal-browser": "^4.0.0 || ^5.0.0",
@@ -91,4 +98,4 @@
     "vite-plugin-dts": "^4.5.4",
     "vitest": "^4.0.18"
   }
-}
+}

package/readme.md

@@ -13,6 +13,8 @@
 
 <h3 align="center">
   <a href="#getting-started">Get Started</a> • 
+  <a href="#migration-from-mgt">Migration</a> • 
+  <a href="#agent-quick-reference">Agent Quick Reference</a> • 
   <a href="#storybook">Storybook</a> • 
   <a href="#contribute">Contribute</a>
 </h3>
@@ -50,6 +52,32 @@ npm install @devsym/graph-toolkit-react
 | ------- | ------- | ----------- |
 | `@devsym/graph-toolkit-react` | `0.1.0-alpha.1` | React components for Microsoft Graph powered by Fluent UI |
 
+<a id="migration-from-mgt"></a>
+## 🔄 Migration from MGT
+
+For migration from Microsoft Graph Toolkit (including Teams-hosted scenarios), use [`docs/MGT_MIGRATION.md`](./docs/MGT_MIGRATION.md).
+
+The guide includes:
+
+- Concept mapping (MGT patterns to this package)
+- Step-by-step migration checklist
+- Teams-specific migration section (`TeamsHostedProvider` + backend token exchange)
+- Common migration pitfalls and validation checklist
+
+<a id="agent-quick-reference"></a>
+## 🤖 Agent Quick Reference
+
+If you are using a coding agent (Copilot/Codex/Claude/etc.), use the scenario-first reference in [`AGENTS.md`](./AGENTS.md).
+
+It includes:
+
+- Provider decision matrix by hosting scenario
+- Minimal copy-ready snippets for `MockProvider`, `MsalBrowserProvider`, `TeamsHostedProvider`, and custom `IProvider`
+- Scopes-by-feature mapping
+- Common failures and exact remediation steps
+
+For end-to-end browser-hosted setup with MSAL, also see [`samples/react-msal-sample/README.md`](./samples/react-msal-sample/README.md).
+
 ## 🎨 Components
 
 Currently available in alpha:
@@ -62,13 +90,17 @@ import { Person } from '@devsym/graph-toolkit-react';
 
 <Person 
   userId="user@contoso.com"
-  view="twoLines"
+  view="twolines"
   showPresence
+  presenceOnly={false}
+  size="large"
   textAlignment="center"
-  onClick={() => console.log('Clicked!')}
+  onClick={() => console.log('Persona clicked!')}
 />
 ```
 
+`Person` supports Fluent UI Persona props directly.
+
 
 <a id="getting-started"></a>
 ## 🚀 Getting Started
@@ -115,7 +147,7 @@ function App() {
   return (
     <FluentProvider theme={webLightTheme}>
       <GraphProvider provider={provider}>
-        <Person userId="AdeleV@contoso.com" view="twoLines" showPresence />
+        <Person userId="AdeleV@contoso.com" view="twolines" showPresence />
       </GraphProvider>
     </FluentProvider>
   );
@@ -218,7 +250,7 @@ Use explicit mode selection in your app:
 import { IProvider, ProviderState } from '@devsym/graph-toolkit-react';
 
 class MyAuthProvider implements IProvider {
-  state = ProviderState.SignedOut;
+  state: ProviderState = 'SignedOut';
   
   async login(): Promise<void> { /* ... */ }
   async logout(): Promise<void> { /* ... */ }