@usehercules/auth 1.0.45 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.mts","names":[],"sources":["../../src/convex-react/ConvexProviderWithHercules.tsx"],"sourcesContent":[],"mappings":";;;;;iBA6IgB,8BAAA;;;AAAhB;YAIY;UACF;AALV,CAAA,CAAA,EAMC,kBAAA,CAAA,GAAA,CAAA,OAN6C"}
1
+ {"version":3,"file":"index.d.mts","names":[],"sources":["../../src/convex-react/ConvexProviderWithHercules.tsx"],"sourcesContent":[],"mappings":";;;;;iBA2FgB,8BAAA;;;AAAhB;YAIY;UACF;AALV,CAAA,CAAA,EAMC,kBAAA,CAAA,GAAA,CAAA,OAN6C"}
@@ -1,3 +1,4 @@
1
+ import { t as withRefreshLock } from "../refresh-lock-DYW9ITwj.mjs";
1
2
  import { useCallback, useMemo, useRef } from "react";
2
3
  import { useAuth } from "react-oidc-context";
3
4
  import { jsx } from "react/jsx-runtime";
@@ -6,7 +7,6 @@ import { jwtDecode } from "jwt-decode";
6
7
 
7
8
  //#region src/convex-react/ConvexProviderWithHercules.tsx
8
9
  const REFRESH_THRESHOLD_MS = 3600 * 1e3;
9
- const LOCK_KEY = "__herculesAuthRefresh";
10
10
  function tokenExpiresWithin(token, ms) {
11
11
  try {
12
12
  return jwtDecode(token).exp * 1e3 - Date.now() < ms;
@@ -14,31 +14,6 @@ function tokenExpiresWithin(token, ms) {
14
14
  return true;
15
15
  }
16
16
  }
17
- async function withLock(key, callback) {
18
- if (typeof navigator !== "undefined" && navigator.locks) return navigator.locks.request(key, callback);
19
- return manualMutex(key, callback);
20
- }
21
- const mutexes = /* @__PURE__ */ new Map();
22
- async function manualMutex(key, callback) {
23
- return new Promise((resolve, reject) => {
24
- const wrapped = () => callback().then(resolve).catch(reject).finally(() => {
25
- const mutex$1 = mutexes.get(key);
26
- const next = mutex$1.waiting.shift();
27
- if (next) mutex$1.running = next();
28
- else mutex$1.running = null;
29
- });
30
- let mutex = mutexes.get(key);
31
- if (!mutex) {
32
- mutex = {
33
- running: null,
34
- waiting: []
35
- };
36
- mutexes.set(key, mutex);
37
- }
38
- if (mutex.running === null) mutex.running = wrapped();
39
- else mutex.waiting.push(wrapped);
40
- });
41
- }
42
17
  function useUseAuthFromHercules() {
43
18
  const { isAuthenticated, user, isLoading, signinSilent } = useAuth();
44
19
  const idToken = user?.id_token;
@@ -54,7 +29,7 @@ function useUseAuthFromHercules() {
54
29
  if (!forceRefreshToken) return currentToken ?? null;
55
30
  if (currentToken != null && !tokenExpiresWithin(currentToken, REFRESH_THRESHOLD_MS)) return currentToken;
56
31
  if (inFlightRefresh.current) return inFlightRefresh.current;
57
- const refresh = withLock(LOCK_KEY, async () => {
32
+ const refresh = withRefreshLock(async () => {
58
33
  const tokenAfterLock = idTokenRef.current;
59
34
  if (tokenAfterLock != null && !tokenExpiresWithin(tokenAfterLock, REFRESH_THRESHOLD_MS)) return tokenAfterLock;
60
35
  try {
@@ -1 +1 @@
1
- {"version":3,"file":"index.mjs","names":["mutex"],"sources":["../../src/convex-react/ConvexProviderWithHercules.tsx"],"sourcesContent":["\"use client\";\n\nimport type { ReactNode } from \"react\";\nimport { ConvexProviderWithAuth, type ConvexReactClient } from \"convex/react\";\nimport { jwtDecode } from \"jwt-decode\";\nimport { useCallback, useMemo, useRef } from \"react\";\nimport { useAuth } from \"react-oidc-context\";\nimport type { HerculesAuthProvider } from \"../react/HerculesAuthProvider\";\n\nconst REFRESH_THRESHOLD_MS = 60 * 60 * 1000; // 1 hour\nconst LOCK_KEY = \"__herculesAuthRefresh\";\n\nfunction tokenExpiresWithin(token: string, ms: number): boolean {\n try {\n const payload = jwtDecode(token);\n return payload.exp! * 1000 - Date.now() < ms;\n } catch {\n return true;\n }\n}\n\n// Cross-tab mutex: uses Web Locks API when available, falls back to a\n// simple in-memory queue for environments that don't support it.\nasync function withLock<T>(\n key: string,\n callback: () => Promise<T>,\n): Promise<T> {\n if (typeof navigator !== \"undefined\" && navigator.locks) {\n return navigator.locks.request(key, callback);\n }\n return manualMutex(key, callback);\n}\n\nconst mutexes = new Map<\n string,\n { running: Promise<void> | null; waiting: Array<() => Promise<void>> }\n>();\n\nasync function manualMutex<T>(\n key: string,\n callback: () => Promise<T>,\n): Promise<T> {\n return new Promise<T>((resolve, reject) => {\n const wrapped = () =>\n callback()\n .then(resolve)\n .catch(reject)\n .finally(() => {\n const mutex = mutexes.get(key)!;\n const next = mutex.waiting.shift();\n if (next) {\n mutex.running = next();\n } else {\n mutex.running = null;\n }\n });\n\n let mutex = mutexes.get(key);\n if (!mutex) {\n mutex = { running: null, waiting: [] };\n mutexes.set(key, mutex);\n }\n\n if (mutex.running === null) {\n mutex.running = wrapped();\n } else {\n mutex.waiting.push(wrapped);\n }\n });\n}\n\nfunction useUseAuthFromHercules() {\n const { isAuthenticated, user, isLoading, signinSilent } = useAuth();\n const idToken = user?.id_token;\n const issuer = user?.profile?.iss;\n const subject = user?.profile?.sub;\n\n const idTokenRef = useRef(idToken);\n idTokenRef.current = idToken;\n\n const signinSilentRef = useRef(signinSilent);\n signinSilentRef.current = signinSilent;\n\n const inFlightRefresh = useRef<Promise<string | null> | null>(null);\n\n const fetchAccessToken = useCallback(\n async ({ forceRefreshToken }: { forceRefreshToken: boolean }) => {\n const currentToken = idTokenRef.current;\n if (!forceRefreshToken) {\n return currentToken ?? null;\n }\n if (\n currentToken != null &&\n !tokenExpiresWithin(currentToken, REFRESH_THRESHOLD_MS)\n ) {\n return currentToken;\n }\n if (inFlightRefresh.current) {\n return inFlightRefresh.current;\n }\n const refresh = withLock(LOCK_KEY, async () => {\n const tokenAfterLock = idTokenRef.current;\n if (\n tokenAfterLock != null &&\n !tokenExpiresWithin(tokenAfterLock, REFRESH_THRESHOLD_MS)\n ) {\n return tokenAfterLock;\n }\n try {\n const refreshed = await signinSilentRef.current();\n return refreshed?.id_token ?? null;\n } catch {\n return null;\n }\n }).finally(() => {\n inFlightRefresh.current = null;\n });\n inFlightRefresh.current = refresh;\n return refresh;\n },\n [issuer, subject],\n );\n\n return useMemo(\n () => ({\n isLoading: isAuthenticated ? false : isLoading,\n isAuthenticated,\n fetchAccessToken,\n }),\n [isLoading, isAuthenticated, fetchAccessToken],\n );\n}\n\n/**\n * A wrapper React component which provides a {@link ConvexReactClient}\n * authenticated with Hercules Auth.\n *\n * It must be wrapped by a configured `{@link HerculesAuthProvider}`.\n *\n * @public\n */\nexport function ConvexProviderWithHerculesAuth({\n children,\n client,\n}: {\n children: ReactNode;\n client: ConvexReactClient;\n}) {\n return (\n <ConvexProviderWithAuth client={client} useAuth={useUseAuthFromHercules}>\n {children}\n </ConvexProviderWithAuth>\n );\n}\n"],"mappings":";;;;;;;AASA,MAAM,uBAAuB,OAAU;AACvC,MAAM,WAAW;AAEjB,SAAS,mBAAmB,OAAe,IAAqB;AAC9D,KAAI;AAEF,SADgB,UAAU,MAAM,CACjB,MAAO,MAAO,KAAK,KAAK,GAAG;SACpC;AACN,SAAO;;;AAMX,eAAe,SACb,KACA,UACY;AACZ,KAAI,OAAO,cAAc,eAAe,UAAU,MAChD,QAAO,UAAU,MAAM,QAAQ,KAAK,SAAS;AAE/C,QAAO,YAAY,KAAK,SAAS;;AAGnC,MAAM,0BAAU,IAAI,KAGjB;AAEH,eAAe,YACb,KACA,UACY;AACZ,QAAO,IAAI,SAAY,SAAS,WAAW;EACzC,MAAM,gBACJ,UAAU,CACP,KAAK,QAAQ,CACb,MAAM,OAAO,CACb,cAAc;GACb,MAAMA,UAAQ,QAAQ,IAAI,IAAI;GAC9B,MAAM,OAAOA,QAAM,QAAQ,OAAO;AAClC,OAAI,KACF,SAAM,UAAU,MAAM;OAEtB,SAAM,UAAU;IAElB;EAEN,IAAI,QAAQ,QAAQ,IAAI,IAAI;AAC5B,MAAI,CAAC,OAAO;AACV,WAAQ;IAAE,SAAS;IAAM,SAAS,EAAE;IAAE;AACtC,WAAQ,IAAI,KAAK,MAAM;;AAGzB,MAAI,MAAM,YAAY,KACpB,OAAM,UAAU,SAAS;MAEzB,OAAM,QAAQ,KAAK,QAAQ;GAE7B;;AAGJ,SAAS,yBAAyB;CAChC,MAAM,EAAE,iBAAiB,MAAM,WAAW,iBAAiB,SAAS;CACpE,MAAM,UAAU,MAAM;CACtB,MAAM,SAAS,MAAM,SAAS;CAC9B,MAAM,UAAU,MAAM,SAAS;CAE/B,MAAM,aAAa,OAAO,QAAQ;AAClC,YAAW,UAAU;CAErB,MAAM,kBAAkB,OAAO,aAAa;AAC5C,iBAAgB,UAAU;CAE1B,MAAM,kBAAkB,OAAsC,KAAK;CAEnE,MAAM,mBAAmB,YACvB,OAAO,EAAE,wBAAwD;EAC/D,MAAM,eAAe,WAAW;AAChC,MAAI,CAAC,kBACH,QAAO,gBAAgB;AAEzB,MACE,gBAAgB,QAChB,CAAC,mBAAmB,cAAc,qBAAqB,CAEvD,QAAO;AAET,MAAI,gBAAgB,QAClB,QAAO,gBAAgB;EAEzB,MAAM,UAAU,SAAS,UAAU,YAAY;GAC7C,MAAM,iBAAiB,WAAW;AAClC,OACE,kBAAkB,QAClB,CAAC,mBAAmB,gBAAgB,qBAAqB,CAEzD,QAAO;AAET,OAAI;AAEF,YADkB,MAAM,gBAAgB,SAAS,GAC/B,YAAY;WACxB;AACN,WAAO;;IAET,CAAC,cAAc;AACf,mBAAgB,UAAU;IAC1B;AACF,kBAAgB,UAAU;AAC1B,SAAO;IAET,CAAC,QAAQ,QAAQ,CAClB;AAED,QAAO,eACE;EACL,WAAW,kBAAkB,QAAQ;EACrC;EACA;EACD,GACD;EAAC;EAAW;EAAiB;EAAiB,CAC/C;;;;;;;;;;AAWH,SAAgB,+BAA+B,EAC7C,UACA,UAIC;AACD,QACE,oBAAC;EAA+B;EAAQ,SAAS;EAC9C;GACsB"}
1
+ {"version":3,"file":"index.mjs","names":[],"sources":["../../src/convex-react/ConvexProviderWithHercules.tsx"],"sourcesContent":["\"use client\";\n\nimport type { ReactNode } from \"react\";\nimport { ConvexProviderWithAuth, type ConvexReactClient } from \"convex/react\";\nimport { jwtDecode } from \"jwt-decode\";\nimport { useCallback, useMemo, useRef } from \"react\";\nimport { useAuth } from \"react-oidc-context\";\nimport { withRefreshLock } from \"../internal/refresh-lock\";\nimport type { HerculesAuthProvider } from \"../react/HerculesAuthProvider\";\n\nconst REFRESH_THRESHOLD_MS = 60 * 60 * 1000; // 1 hour\n\nfunction tokenExpiresWithin(token: string, ms: number): boolean {\n try {\n const payload = jwtDecode(token);\n return payload.exp! * 1000 - Date.now() < ms;\n } catch {\n return true;\n }\n}\n\nfunction useUseAuthFromHercules() {\n const { isAuthenticated, user, isLoading, signinSilent } = useAuth();\n const idToken = user?.id_token;\n const issuer = user?.profile?.iss;\n const subject = user?.profile?.sub;\n\n const idTokenRef = useRef(idToken);\n idTokenRef.current = idToken;\n\n const signinSilentRef = useRef(signinSilent);\n signinSilentRef.current = signinSilent;\n\n const inFlightRefresh = useRef<Promise<string | null> | null>(null);\n\n const fetchAccessToken = useCallback(\n async ({ forceRefreshToken }: { forceRefreshToken: boolean }) => {\n const currentToken = idTokenRef.current;\n if (!forceRefreshToken) {\n return currentToken ?? null;\n }\n if (\n currentToken != null &&\n !tokenExpiresWithin(currentToken, REFRESH_THRESHOLD_MS)\n ) {\n return currentToken;\n }\n if (inFlightRefresh.current) {\n return inFlightRefresh.current;\n }\n const refresh = withRefreshLock(async () => {\n const tokenAfterLock = idTokenRef.current;\n if (\n tokenAfterLock != null &&\n !tokenExpiresWithin(tokenAfterLock, REFRESH_THRESHOLD_MS)\n ) {\n return tokenAfterLock;\n }\n try {\n const refreshed = await signinSilentRef.current();\n return refreshed?.id_token ?? null;\n } catch {\n return null;\n }\n }).finally(() => {\n inFlightRefresh.current = null;\n });\n inFlightRefresh.current = refresh;\n return refresh;\n },\n [issuer, subject],\n );\n\n return useMemo(\n () => ({\n isLoading: isAuthenticated ? false : isLoading,\n isAuthenticated,\n fetchAccessToken,\n }),\n [isLoading, isAuthenticated, fetchAccessToken],\n );\n}\n\n/**\n * A wrapper React component which provides a {@link ConvexReactClient}\n * authenticated with Hercules Auth.\n *\n * It must be wrapped by a configured `{@link HerculesAuthProvider}`.\n *\n * @public\n */\nexport function ConvexProviderWithHerculesAuth({\n children,\n client,\n}: {\n children: ReactNode;\n client: ConvexReactClient;\n}) {\n return (\n <ConvexProviderWithAuth client={client} useAuth={useUseAuthFromHercules}>\n {children}\n </ConvexProviderWithAuth>\n );\n}\n"],"mappings":";;;;;;;;AAUA,MAAM,uBAAuB,OAAU;AAEvC,SAAS,mBAAmB,OAAe,IAAqB;AAC9D,KAAI;AAEF,SADgB,UAAU,MAAM,CACjB,MAAO,MAAO,KAAK,KAAK,GAAG;SACpC;AACN,SAAO;;;AAIX,SAAS,yBAAyB;CAChC,MAAM,EAAE,iBAAiB,MAAM,WAAW,iBAAiB,SAAS;CACpE,MAAM,UAAU,MAAM;CACtB,MAAM,SAAS,MAAM,SAAS;CAC9B,MAAM,UAAU,MAAM,SAAS;CAE/B,MAAM,aAAa,OAAO,QAAQ;AAClC,YAAW,UAAU;CAErB,MAAM,kBAAkB,OAAO,aAAa;AAC5C,iBAAgB,UAAU;CAE1B,MAAM,kBAAkB,OAAsC,KAAK;CAEnE,MAAM,mBAAmB,YACvB,OAAO,EAAE,wBAAwD;EAC/D,MAAM,eAAe,WAAW;AAChC,MAAI,CAAC,kBACH,QAAO,gBAAgB;AAEzB,MACE,gBAAgB,QAChB,CAAC,mBAAmB,cAAc,qBAAqB,CAEvD,QAAO;AAET,MAAI,gBAAgB,QAClB,QAAO,gBAAgB;EAEzB,MAAM,UAAU,gBAAgB,YAAY;GAC1C,MAAM,iBAAiB,WAAW;AAClC,OACE,kBAAkB,QAClB,CAAC,mBAAmB,gBAAgB,qBAAqB,CAEzD,QAAO;AAET,OAAI;AAEF,YADkB,MAAM,gBAAgB,SAAS,GAC/B,YAAY;WACxB;AACN,WAAO;;IAET,CAAC,cAAc;AACf,mBAAgB,UAAU;IAC1B;AACF,kBAAgB,UAAU;AAC1B,SAAO;IAET,CAAC,QAAQ,QAAQ,CAClB;AAED,QAAO,eACE;EACL,WAAW,kBAAkB,QAAQ;EACrC;EACA;EACD,GACD;EAAC;EAAW;EAAiB;EAAiB,CAC/C;;;;;;;;;;AAWH,SAAgB,+BAA+B,EAC7C,UACA,UAIC;AACD,QACE,oBAAC;EAA+B;EAAQ,SAAS;EAC9C;GACsB"}
@@ -1,4 +1,5 @@
1
1
  import * as react0 from "react";
2
+ import { ReactNode } from "react";
2
3
  import * as react_oidc_context0 from "react-oidc-context";
3
4
  import { AuthContextProps as AuthContextProps$1, AuthProviderUserManagerProps, hasAuthParams } from "react-oidc-context";
4
5
  import * as oidc_client_ts0 from "oidc-client-ts";
@@ -29,9 +30,11 @@ type HerculesAuthProviderProps = Omit<AuthProviderUserManagerProps, "userManager
29
30
  userManagerSettings?: Partial<UserManagerSettings>;
30
31
  authority: string;
31
32
  client_id: string;
33
+ loadingFallback?: ReactNode;
32
34
  };
33
35
  interface HerculesAuthProviderContext {
34
36
  userManager: UserManager;
37
+ impersonationStorageKey: string;
35
38
  }
36
39
  declare const HerculesAuthProviderContext: react0.Context<HerculesAuthProviderContext | null>;
37
40
  declare function useHerculesAuthProvider(): HerculesAuthProviderContext;
@@ -40,9 +43,25 @@ declare function HerculesAuthProvider({
40
43
  userManagerSettings,
41
44
  authority,
42
45
  client_id,
46
+ loadingFallback,
43
47
  ...props
44
48
  }: HerculesAuthProviderProps): react_jsx_runtime0.JSX.Element;
45
49
  //#endregion
50
+ //#region src/react/impersonation-core.d.ts
51
+ declare const HERCULES_IMPERSONATION_SESSION_ID_PARAM = "hercules_impersonation_session_id";
52
+ declare const HERCULES_IMPERSONATION_TOKEN_PARAM = "hercules_impersonation_token";
53
+ declare function getHerculesImpersonationStorageKey(authority: string, clientId: string): string;
54
+ declare function rememberHerculesImpersonationSession(storageKey: string, sessionId: string): void;
55
+ //#endregion
56
+ //#region src/react/impersonation.d.ts
57
+ type HerculesImpersonationState = {
58
+ isImpersonating: boolean;
59
+ sessionId: string | null;
60
+ actorSub: string | null;
61
+ stopImpersonating: () => Promise<void>;
62
+ };
63
+ declare function useHerculesImpersonation(): HerculesImpersonationState;
64
+ //#endregion
46
65
  //#region src/react/use-user.d.ts
47
66
  declare function useUser(): {
48
67
  id: string | undefined;
@@ -71,5 +90,5 @@ interface AuthContextProps extends AuthContextProps$1 {
71
90
  }
72
91
  declare function useAuth(): AuthContextProps;
73
92
  //#endregion
74
- export { AuthCallbackStatus, AuthContextProps, HerculesAuthProvider, HerculesAuthProviderProps, UseAuthCallbackOptions, UseAuthCallbackResult, hasAuthParams, useAuth, useAuthCallback, useHerculesAuthProvider, useUser };
93
+ export { AuthCallbackStatus, AuthContextProps, HERCULES_IMPERSONATION_SESSION_ID_PARAM, HERCULES_IMPERSONATION_TOKEN_PARAM, HerculesAuthProvider, HerculesAuthProviderProps, HerculesImpersonationState, UseAuthCallbackOptions, UseAuthCallbackResult, getHerculesImpersonationStorageKey, hasAuthParams, rememberHerculesImpersonationSession, useAuth, useAuthCallback, useHerculesAuthProvider, useHerculesImpersonation, useUser };
75
94
  //# sourceMappingURL=index.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.mts","names":[],"sources":["../../src/react/auth-callback-hook.tsx","../../src/react/HerculesAuthProvider.tsx","../../src/react/use-user.ts","../../src/react/use-auth.ts"],"sourcesContent":[],"mappings":";;;;;;;;KAiBY,kBAAA;UAWK,sBAAA;;;iBAkBA;;;;AA7BL,UAiDK,qBAAA,CAjDa;EAWb,MAAA,EAwCP,kBAxC6B;EAsCtB,KAAA,EAAA,MAAA,GAAA,IAAA;EAqDD,SAAA,EAAA,OAAe;;;eApChB;ACrEf;AACE,iBDwGc,eAAA,CCxGd,OAAA,CAAA,EDyGS,sBCzGT,CAAA,ED0GC,qBC1GD;;;KADU,yBAAA,GAA4B,KACtC;wBAGsB,QAAQ;;;;UAkBtB,2BAAA;EDnBE,WAAA,ECoBG,WDpBe;AAW9B;AAsCA,cC1BM,2BD4BI,EC5BuB,MAAA,CAAA,OD2ClB,CC3CkB,2BD2CX,GAAA,IAAA,CAAA;AAoCN,iBC5EA,uBAAA,CAAA,CD6EL,EC7E4B,2BD8EpC;iBChEa,oBAAA;;;;;;GAMb,4BAAyB,kBAAA,CAAA,GAAA,CAAA;;;iBCrDZ,OAAA,CAAA;;;;;;;SAAO,mBAAA,CAAA,YAAA;EFOX,QAAA,CAAA,EAAA,MAAA;EAWK,aAAA,CAAA,EAAA,MAAA,GAAsB,IAAA,GAAA,SAkBtB;EAoBA,YAAA,CAAA,EAAA,MAAA,GAAqB,SAAA;EAqDtB,aAAA,CAAA,EAAA,MAAe;;;YE7GR,eAAA,CAAA,aAAA;EDIX,UAAA,CAAA,EAAA,MAAA;EACV,KAAA,CAAA,EAAA,OAAA;EADsC,SAAA,CAAA,EAAA,MAAA;CAIR;;;UEXf,gBAAA,SAAyB;iBACzB;gBACD;;iBAGA,OAAA,CAAA,GAAW"}
1
+ {"version":3,"file":"index.d.mts","names":[],"sources":["../../src/react/auth-callback-hook.tsx","../../src/react/HerculesAuthProvider.tsx","../../src/react/impersonation-core.ts","../../src/react/impersonation.ts","../../src/react/use-user.ts","../../src/react/use-auth.ts"],"sourcesContent":[],"mappings":";;;;;;;;;KAiBY,kBAAA;UAWK,sBAAA;;;iBAkBA;;;;UAoBA,qBAAA;EAjDL,MAAA,EAmDF,kBAnDoB;EAWb,KAAA,EAAA,MAAA,GAAA,IAAA;EAsCA,SAAA,EAAA,OAAA;EAqDD,SAAA,EAAA,OAAe;;eApChB;;ACnDH,iBDuFI,eAAA,CCvFqB,OAAA,CAAA,EDwF1B,sBCxF0B,CAAA,EDyFlC,qBCzFkC;;;KAAzB,yBAAA,GAA4B,KACtC;wBAGsB,QAAQ;;;oBAGZ;;ADtBpB,UCsCU,2BAAA,CDtCoB;EAWb,WAAA,EC4BF,WD5BE;EAsCA,uBAAA,EAAqB,MAAA;AAqDtC;cC3DM,6BAA2B,MAAA,CAAA,QAAA;iBAGjB,uBAAA,CAAA,GAAuB;iBA0EvB,oBAAA;;;;;;;GAOb,4BAAyB,kBAAA,CAAA,GAAA,CAAA;;;cC9If,uCAAA;cAEA,kCAAA;iBAQG,kCAAA;iBAOA,oCAAA;;;KCHJ,0BAAA;;;;2BAIe;;iBAGX,wBAAA,CAAA,GAA4B;;;iBCb5B,OAAA,CAAA;;;;;;;SAAO,mBAAA,CAAA,YAAA;;EJOX,aAAA,CAAA,EAAA,MAAkB,GAAA,IAAA,GAAA,SAAA;EAWb,YAAA,CAAA,EAAA,MAAA,GAAA,SAAsB;EAsCtB,aAAA,CAAA,EAAA,MAAA;EAqDD,UAAA,CAAA,EAAA,MAAe,GAAA,SACpB;;YI9GY,eAAA,CAAA,aAAA;;EHsBX,KAAA,CAAA,EAAA,OAAA;EACV,SAAA,CAAA,EAAA,MAAA;CADsC;;;UIzBvB,gBAAA,SAAyB;iBACzB;gBACD;;iBAGA,OAAA,CAAA,GAAW"}
@@ -1,9 +1,10 @@
1
+ import { t as withRefreshLock } from "../refresh-lock-DYW9ITwj.mjs";
1
2
  import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState } from "react";
2
3
  import { AuthProvider, hasAuthParams, hasAuthParams as hasAuthParams$1, useAuth as useAuth$1 } from "react-oidc-context";
3
4
  import { ConvexError } from "convex/values";
4
5
  import * as z from "zod";
5
6
  import { UserManager, WebStorageStateStore } from "oidc-client-ts";
6
- import { jsx } from "react/jsx-runtime";
7
+ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
7
8
 
8
9
  //#region src/react/auth-callback-hook.tsx
9
10
  const DEFAULT_TIMEOUT_MS = 2e4;
@@ -149,8 +150,30 @@ function useAuthCallback(options = {}) {
149
150
  };
150
151
  }
151
152
 
153
+ //#endregion
154
+ //#region src/react/impersonation-core.ts
155
+ const HERCULES_IMPERSONATION_SESSION_ID_PARAM = "hercules_impersonation_session_id";
156
+ const HERCULES_IMPERSONATION_TOKEN_PARAM = "hercules_impersonation_token";
157
+ function getHerculesImpersonationStorageKey(authority, clientId) {
158
+ return `hercules.impersonation.${authority}.${clientId}`;
159
+ }
160
+ function rememberHerculesImpersonationSession(storageKey, sessionId) {
161
+ if (typeof window === "undefined") return;
162
+ window.localStorage.setItem(storageKey, JSON.stringify({
163
+ sessionId,
164
+ startedAt: (/* @__PURE__ */ new Date()).toISOString()
165
+ }));
166
+ }
167
+ function clearHerculesImpersonationParamsFromUrl(url) {
168
+ url.searchParams.delete(HERCULES_IMPERSONATION_SESSION_ID_PARAM);
169
+ url.searchParams.delete(HERCULES_IMPERSONATION_TOKEN_PARAM);
170
+ return url;
171
+ }
172
+
152
173
  //#endregion
153
174
  //#region src/react/HerculesAuthProvider.tsx
175
+ const RECOVERY_TIMEOUT_MS = 1e4;
176
+ const LOCK_GRACE_MS = 5e3;
154
177
  function onSigninCallback() {
155
178
  window.history.replaceState({}, document.title, window.location.pathname);
156
179
  }
@@ -167,34 +190,221 @@ function useHerculesAuthProvider() {
167
190
  if (!context) throw new Error("HerculesAuthProviderContext not found");
168
191
  return context;
169
192
  }
193
+ function AuthRecoveryGate({ children, loadingFallback, skipRecovery }) {
194
+ const { user, isLoading, signinSilent } = useAuth$1();
195
+ const userExpired = user?.expired === true;
196
+ const hasAttempted = useRef(false);
197
+ const signinSilentRef = useRef(signinSilent);
198
+ signinSilentRef.current = signinSilent;
199
+ const [recoveryDone, setRecoveryDone] = useState(false);
200
+ const [recovering, setRecovering] = useState(false);
201
+ useEffect(() => {
202
+ if (skipRecovery) {
203
+ hasAttempted.current = true;
204
+ setRecoveryDone(true);
205
+ return;
206
+ }
207
+ if (isLoading) return;
208
+ if (hasAttempted.current) return;
209
+ hasAttempted.current = true;
210
+ if (!user || !userExpired) {
211
+ setRecoveryDone(true);
212
+ return;
213
+ }
214
+ setRecovering(true);
215
+ const finish = () => {
216
+ setRecovering(false);
217
+ setRecoveryDone(true);
218
+ };
219
+ setTimeout(finish, RECOVERY_TIMEOUT_MS);
220
+ withRefreshLock(async () => {
221
+ await Promise.race([signinSilentRef.current().catch(() => void 0), new Promise((resolve) => setTimeout(resolve, RECOVERY_TIMEOUT_MS + LOCK_GRACE_MS))]);
222
+ }).finally(finish);
223
+ }, [
224
+ isLoading,
225
+ skipRecovery,
226
+ userExpired
227
+ ]);
228
+ if (!skipRecovery && (recovering || !recoveryDone && !isLoading && userExpired)) return /* @__PURE__ */ jsx(Fragment, { children: loadingFallback });
229
+ return /* @__PURE__ */ jsx(Fragment, { children });
230
+ }
170
231
  /**
171
232
  * A wrapper React component which provides a {@link ReactAuthProvider}
172
233
  * configured with Hercules Auth.
173
234
  *
174
235
  * @public
175
236
  */
176
- function HerculesAuthProvider({ children, userManagerSettings, authority, client_id, ...props }) {
177
- const [userManager] = useState(() => new UserManager({
178
- ...userManagerSettings,
179
- authority: userManagerSettings?.authority ?? authority,
180
- client_id: userManagerSettings?.client_id ?? client_id,
181
- prompt: userManagerSettings?.prompt ?? "select_account",
182
- response_type: userManagerSettings?.response_type ?? "code",
183
- scope: userManagerSettings?.scope ?? "openid profile email offline_access",
184
- redirect_uri: userManagerSettings?.redirect_uri ?? `${window.location.origin}/auth/callback`,
185
- post_logout_redirect_uri: userManagerSettings?.post_logout_redirect_uri ?? window.location.origin,
186
- userStore: userManagerSettings?.userStore ?? new WebStorageStateStore({ store: window.localStorage })
187
- }));
237
+ function HerculesAuthProvider({ children, userManagerSettings, authority, client_id, loadingFallback = null, ...props }) {
238
+ const automaticSilentRenewExplicit = userManagerSettings?.automaticSilentRenew === true;
239
+ const [{ userManager, impersonationStorageKey }] = useState(() => {
240
+ const effectiveAuthority = userManagerSettings?.authority ?? authority;
241
+ const effectiveClientId = userManagerSettings?.client_id ?? client_id;
242
+ return {
243
+ userManager: new UserManager({
244
+ ...userManagerSettings,
245
+ authority: effectiveAuthority,
246
+ client_id: effectiveClientId,
247
+ prompt: userManagerSettings?.prompt ?? "select_account",
248
+ response_type: userManagerSettings?.response_type ?? "code",
249
+ scope: userManagerSettings?.scope ?? "openid profile email offline_access",
250
+ redirect_uri: userManagerSettings?.redirect_uri ?? `${window.location.origin}/auth/callback`,
251
+ post_logout_redirect_uri: userManagerSettings?.post_logout_redirect_uri ?? window.location.origin,
252
+ userStore: userManagerSettings?.userStore ?? new WebStorageStateStore({ store: window.localStorage }),
253
+ automaticSilentRenew: userManagerSettings?.automaticSilentRenew ?? false,
254
+ silentRequestTimeoutInSeconds: userManagerSettings?.silentRequestTimeoutInSeconds ?? RECOVERY_TIMEOUT_MS / 1e3
255
+ }),
256
+ impersonationStorageKey: getHerculesImpersonationStorageKey(effectiveAuthority, effectiveClientId)
257
+ };
258
+ });
259
+ useEffect(() => {
260
+ if (automaticSilentRenewExplicit) return;
261
+ let retryTimerId = null;
262
+ let timeoutRetryCount = 0;
263
+ let stopped = false;
264
+ const events = userManager.events;
265
+ const tryRenew = () => {
266
+ if (stopped) return;
267
+ withRefreshLock(async () => {
268
+ if (stopped) return;
269
+ try {
270
+ await userManager.signinSilent();
271
+ timeoutRetryCount = 0;
272
+ } catch (err) {
273
+ if (stopped) return;
274
+ if (err instanceof Error && err.name === "ErrorTimeout") {
275
+ timeoutRetryCount++;
276
+ const maxRetries = userManager.settings.maxSilentRenewTimeoutRetries;
277
+ if (maxRetries !== void 0 && timeoutRetryCount > maxRetries) {
278
+ timeoutRetryCount = 0;
279
+ events._raiseSilentRenewError?.(err);
280
+ return;
281
+ }
282
+ retryTimerId = setTimeout(() => {
283
+ retryTimerId = null;
284
+ tryRenew();
285
+ }, 5e3);
286
+ } else {
287
+ timeoutRetryCount = 0;
288
+ events._raiseSilentRenewError?.(err);
289
+ }
290
+ }
291
+ });
292
+ };
293
+ const onExpiring = () => tryRenew();
294
+ userManager.events.addAccessTokenExpiring(onExpiring);
295
+ return () => {
296
+ stopped = true;
297
+ userManager.events.removeAccessTokenExpiring(onExpiring);
298
+ if (retryTimerId !== null) clearTimeout(retryTimerId);
299
+ };
300
+ }, [userManager, automaticSilentRenewExplicit]);
188
301
  return /* @__PURE__ */ jsx(HerculesAuthProviderContext.Provider, {
189
- value: { userManager },
190
- children: /* @__PURE__ */ jsx(AuthProvider, {
302
+ value: {
303
+ userManager,
304
+ impersonationStorageKey
305
+ },
306
+ children: /* @__PURE__ */ jsxs(AuthProvider, {
191
307
  userManager,
192
308
  ...DEFAULT_AUTH_CONFIG,
193
309
  ...props,
194
- children
310
+ children: [/* @__PURE__ */ jsx(HerculesImpersonationHandoff, { storageKey: impersonationStorageKey }), /* @__PURE__ */ jsx(AuthRecoveryGate, {
311
+ loadingFallback,
312
+ skipRecovery: hasCompleteImpersonationHandoff(),
313
+ children
314
+ })]
195
315
  })
196
316
  });
197
317
  }
318
+ function HerculesImpersonationHandoff({ storageKey }) {
319
+ const auth = useAuth$1();
320
+ const hasStartedRef = useRef(false);
321
+ useEffect(() => {
322
+ if (hasStartedRef.current || typeof window === "undefined") return;
323
+ const url = new URL(window.location.href);
324
+ const impersonationSessionId = url.searchParams.get(HERCULES_IMPERSONATION_SESSION_ID_PARAM);
325
+ const impersonationToken = url.searchParams.get(HERCULES_IMPERSONATION_TOKEN_PARAM);
326
+ if (!impersonationSessionId && !impersonationToken) return;
327
+ if (!impersonationSessionId || !impersonationToken) {
328
+ window.history.replaceState({}, document.title, clearHerculesImpersonationParamsFromUrl(url).toString());
329
+ return;
330
+ }
331
+ if (auth.isLoading) return;
332
+ hasStartedRef.current = true;
333
+ rememberHerculesImpersonationSession(storageKey, impersonationSessionId);
334
+ window.history.replaceState({}, document.title, clearHerculesImpersonationParamsFromUrl(url).toString());
335
+ (async () => {
336
+ if (auth.isAuthenticated) await auth.removeUser();
337
+ await auth.signinRedirect({ extraQueryParams: {
338
+ [HERCULES_IMPERSONATION_SESSION_ID_PARAM]: impersonationSessionId,
339
+ [HERCULES_IMPERSONATION_TOKEN_PARAM]: impersonationToken
340
+ } });
341
+ })();
342
+ }, [auth, storageKey]);
343
+ return null;
344
+ }
345
+ function hasCompleteImpersonationHandoff() {
346
+ if (typeof window === "undefined") return false;
347
+ const params = new URL(window.location.href).searchParams;
348
+ return params.has(HERCULES_IMPERSONATION_SESSION_ID_PARAM) && params.has(HERCULES_IMPERSONATION_TOKEN_PARAM);
349
+ }
350
+
351
+ //#endregion
352
+ //#region src/react/impersonation.ts
353
+ function useHerculesImpersonation() {
354
+ const { userManager, impersonationStorageKey } = useHerculesAuthProvider();
355
+ const auth = useAuth$1();
356
+ const [storedSessionId, setStoredSessionId] = useState(() => readStoredImpersonationSessionId(impersonationStorageKey));
357
+ const profile = auth.user?.profile ?? {};
358
+ const profileSessionId = typeof profile.hercules_impersonation_session_id === "string" ? profile.hercules_impersonation_session_id : null;
359
+ const actorSub = typeof profile.hercules_actor_sub === "string" ? profile.hercules_actor_sub : null;
360
+ const sessionId = auth.isAuthenticated ? profileSessionId : storedSessionId;
361
+ useEffect(() => {
362
+ if (!auth.isAuthenticated) return;
363
+ if (profileSessionId) {
364
+ rememberHerculesImpersonationSession(impersonationStorageKey, profileSessionId);
365
+ setStoredSessionId(profileSessionId);
366
+ return;
367
+ }
368
+ if (typeof window !== "undefined") window.localStorage.removeItem(impersonationStorageKey);
369
+ setStoredSessionId(null);
370
+ }, [
371
+ auth.isAuthenticated,
372
+ impersonationStorageKey,
373
+ profileSessionId
374
+ ]);
375
+ const stopImpersonating = useCallback(async () => {
376
+ if (typeof window !== "undefined") window.localStorage.removeItem(impersonationStorageKey);
377
+ setStoredSessionId(null);
378
+ if (await userManager.metadataService.getEndSessionEndpoint() != null) await auth.signoutRedirect();
379
+ else await auth.removeUser();
380
+ }, [
381
+ auth,
382
+ impersonationStorageKey,
383
+ userManager
384
+ ]);
385
+ return useMemo(() => ({
386
+ isImpersonating: auth.isAuthenticated && sessionId != null,
387
+ sessionId,
388
+ actorSub,
389
+ stopImpersonating
390
+ }), [
391
+ actorSub,
392
+ auth.isAuthenticated,
393
+ sessionId,
394
+ stopImpersonating
395
+ ]);
396
+ }
397
+ function readStoredImpersonationSessionId(storageKey) {
398
+ if (typeof window === "undefined") return null;
399
+ try {
400
+ const stored = window.localStorage.getItem(storageKey);
401
+ if (!stored) return null;
402
+ const parsed = JSON.parse(stored);
403
+ return typeof parsed.sessionId === "string" ? parsed.sessionId : null;
404
+ } catch {
405
+ return null;
406
+ }
407
+ }
198
408
 
199
409
  //#endregion
200
410
  //#region src/react/use-user.ts
@@ -259,5 +469,5 @@ function useAuth() {
259
469
  }
260
470
 
261
471
  //#endregion
262
- export { HerculesAuthProvider, hasAuthParams, useAuth, useAuthCallback, useHerculesAuthProvider, useUser };
472
+ export { HERCULES_IMPERSONATION_SESSION_ID_PARAM, HERCULES_IMPERSONATION_TOKEN_PARAM, HerculesAuthProvider, getHerculesImpersonationStorageKey, hasAuthParams, rememberHerculesImpersonationSession, useAuth, useAuthCallback, useHerculesAuthProvider, useHerculesImpersonation, useUser };
263
473
  //# sourceMappingURL=index.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.mjs","names":["useAuth","hasAuthParams","DEFAULT_AUTH_CONFIG: Partial<HerculesAuthProviderProps>","ReactAuthProvider","useAuth","useOidcAuth"],"sources":["../../src/react/auth-callback-hook.tsx","../../src/react/HerculesAuthProvider.tsx","../../src/react/use-user.ts","../../src/react/use-auth.ts"],"sourcesContent":["\"use client\";\n\nimport { useEffect, useState, useRef, useCallback } from \"react\";\nimport { useAuth, hasAuthParams } from \"react-oidc-context\";\nimport { ConvexError } from \"convex/values\";\nimport * as z from \"zod\";\n\nconst DEFAULT_TIMEOUT_MS = 20000; // 20 second timeout\n\nconst convexErrorSchema = z.object({\n message: z.string(),\n});\n\n/**\n * Authentication callback status states\n * @public\n */\nexport type AuthCallbackStatus =\n | \"processing-oauth\" // OIDC is processing the callback\n | \"waiting-backend\" // OIDC authenticated, waiting for backend\n | \"syncing\" // Syncing user with backend (e.g., creating user record)\n | \"success\" // All done\n | \"error\"; // Something went wrong\n\n/**\n * Options for the useAuthCallback hook\n * @public\n */\nexport interface UseAuthCallbackOptions {\n /**\n * Timeout in milliseconds before the callback is considered failed.\n * @default 20000\n */\n timeoutMs?: number;\n\n /**\n * Whether the backend (e.g., Convex) is authenticated.\n * The hook will wait for this to be true before calling onSync.\n */\n isBackendAuthenticated?: boolean;\n\n /**\n * Called when the backend is authenticated and ready to sync.\n * Use this to create/update the user in your backend.\n * Return a promise that resolves when sync is complete.\n */\n onSync?: () => Promise<void>;\n\n /**\n * Called when authentication is successful and sync is complete.\n * Use this to redirect the user.\n */\n onSuccess?: () => void;\n\n /**\n * Called when OIDC is not authenticated and there are no auth params.\n * This typically means the user navigated directly to the callback page.\n * Use this to redirect them away.\n */\n onNoAuthParams?: () => void;\n}\n\n/**\n * Return type for the useAuthCallback hook\n * @public\n */\nexport interface UseAuthCallbackResult {\n /** Current status of the auth callback flow */\n status: AuthCallbackStatus;\n\n /** Error message if status is \"error\" */\n error: string | null;\n\n /** Whether the auth callback is still in progress */\n isLoading: boolean;\n\n /** Whether the auth callback completed successfully */\n isSuccess: boolean;\n\n /** Whether there was an error */\n isError: boolean;\n\n /** Retry the authentication flow by redirecting to the auth provider */\n retry: () => Promise<void>;\n}\n\n/**\n * A hook for handling OAuth/OIDC callback flows.\n *\n * This hook manages the complete authentication callback lifecycle:\n * 1. Processing the OAuth callback from the identity provider\n * 2. Waiting for backend authentication (e.g., Convex)\n * 3. Syncing user data with your backend\n * 4. Handling success and error states\n *\n * @example\n * ```tsx\n * function AuthCallback() {\n * const navigate = useNavigate();\n * const { isAuthenticated } = useConvexAuth();\n * const updateUser = useMutation(api.users.updateCurrentUser);\n *\n * const { status, error, retry } = useAuthCallback({\n * isBackendAuthenticated: isAuthenticated,\n * onSync: () => updateUser(),\n * onSuccess: () => navigate(\"/\", { replace: true }),\n * onNoAuthParams: () => navigate(\"/\", { replace: true }),\n * });\n *\n * if (status === \"error\") {\n * return <ErrorState message={error} onRetry={retry} />;\n * }\n *\n * return <LoadingSpinner />;\n * }\n * ```\n *\n * @public\n */\nexport function useAuthCallback(\n options: UseAuthCallbackOptions = {},\n): UseAuthCallbackResult {\n const {\n timeoutMs = DEFAULT_TIMEOUT_MS,\n isBackendAuthenticated = true,\n onSync,\n onSuccess,\n onNoAuthParams,\n } = options;\n\n const {\n isLoading: isAuthLoading,\n isAuthenticated: isOidcAuthenticated,\n error: oidcError,\n signinRedirect,\n } = useAuth();\n\n const [status, setStatus] = useState<AuthCallbackStatus>(\"processing-oauth\");\n const [error, setError] = useState<string | null>(null);\n\n // Track mount state to prevent state updates after unmount\n const mountedRef = useRef(true);\n // Track if we had auth params on mount (won't change during lifecycle)\n const hadAuthParams = useRef(hasAuthParams());\n // Track if we've already started sync to prevent double execution\n const syncStarted = useRef(false);\n\n // Reset on mount, cleanup on unmount\n useEffect(() => {\n mountedRef.current = true;\n syncStarted.current = false;\n return () => {\n mountedRef.current = false;\n };\n }, []);\n\n // Timeout protection with state awareness\n useEffect(() => {\n if (status === \"success\" || status === \"error\") return;\n\n const timeout = setTimeout(() => {\n if (mountedRef.current) {\n setStatus(\"error\");\n setError(\"Authentication timed out. Please try again.\");\n }\n }, timeoutMs);\n\n return () => clearTimeout(timeout);\n }, [status, timeoutMs]);\n\n // Track OIDC authentication progression\n useEffect(() => {\n // Don't update if we're already past processing or in an error state\n if (status !== \"processing-oauth\" && status !== \"waiting-backend\") return;\n\n // Handle OIDC errors\n if (oidcError) {\n setStatus(\"error\");\n setError(oidcError.message || \"Authentication failed\");\n return;\n }\n\n // No auth params and not authenticated - navigated here directly\n if (!hadAuthParams.current && !isAuthLoading && !isOidcAuthenticated) {\n onNoAuthParams?.();\n return;\n }\n\n // OIDC is done loading and authenticated - move to waiting for backend\n if (\n !isAuthLoading &&\n isOidcAuthenticated &&\n status === \"processing-oauth\"\n ) {\n setStatus(\"waiting-backend\");\n return;\n }\n\n // OIDC finished but not authenticated (and we had auth params)\n // Wait a bit before declaring failure to avoid race conditions\n if (\n hadAuthParams.current &&\n !isAuthLoading &&\n !isOidcAuthenticated &&\n !oidcError &&\n status === \"processing-oauth\"\n ) {\n // Use a small delay to avoid race condition during OIDC state transitions\n const failureTimeout = setTimeout(() => {\n if (mountedRef.current && !isOidcAuthenticated) {\n setStatus(\"error\");\n setError(\"Authentication was cancelled or failed. Please try again.\");\n }\n }, 500);\n\n return () => clearTimeout(failureTimeout);\n }\n\n return;\n }, [isAuthLoading, isOidcAuthenticated, oidcError, status, onNoAuthParams]);\n\n // Sync with backend once backend is authenticated\n useEffect(() => {\n if (status !== \"waiting-backend\" || !isBackendAuthenticated) return;\n if (syncStarted.current) return;\n\n syncStarted.current = true;\n\n async function performSync() {\n if (!mountedRef.current) return;\n\n setStatus(\"syncing\");\n\n try {\n if (onSync) {\n await onSync();\n }\n\n if (mountedRef.current) {\n setStatus(\"success\");\n }\n } catch (err) {\n console.error(\"Auth callback sync failed:\", err);\n\n if (!mountedRef.current) return;\n\n if (err instanceof ConvexError) {\n // try to extract the error message from the convex error\n const parseResult = convexErrorSchema.safeParse(err.data);\n if (parseResult.success) {\n setStatus(\"error\");\n setError(parseResult.data.message);\n return;\n }\n }\n\n // Check if it's an authentication error\n const errorMessage =\n err instanceof Error\n ? err.message\n : \"Failed to complete authentication. Please try again.\";\n\n setStatus(\"error\");\n setError(errorMessage);\n }\n }\n\n performSync();\n }, [status, isBackendAuthenticated, onSync]);\n\n // Handle successful completion\n useEffect(() => {\n if (status === \"success\") {\n onSuccess?.();\n }\n }, [status, onSuccess]);\n\n // Retry handler\n const retry = useCallback(async () => {\n try {\n await signinRedirect();\n } catch (err) {\n console.error(\"Failed to restart auth:\", err);\n }\n }, [signinRedirect]);\n\n return {\n status,\n error,\n isLoading: status !== \"success\" && status !== \"error\",\n isSuccess: status === \"success\",\n isError: status === \"error\",\n retry,\n };\n}\n","\"use client\";\n\nimport { useState } from \"react\";\nimport {\n AuthProvider as ReactAuthProvider,\n type AuthProviderUserManagerProps,\n} from \"react-oidc-context\";\nimport {\n UserManager,\n WebStorageStateStore,\n type UserManagerSettings,\n} from \"oidc-client-ts\";\nimport { createContext, useContext } from \"react\";\n\nexport type HerculesAuthProviderProps = Omit<\n AuthProviderUserManagerProps,\n \"userManager\"\n> & {\n userManagerSettings?: Partial<UserManagerSettings>;\n authority: string;\n client_id: string;\n};\n\nfunction onSigninCallback() {\n window.history.replaceState({}, document.title, window.location.pathname);\n}\n\nfunction onSignoutCallback() {\n window.location.pathname = \"\";\n}\n\nconst DEFAULT_AUTH_CONFIG: Partial<HerculesAuthProviderProps> = {\n onSignoutCallback,\n onSigninCallback,\n};\n\ninterface HerculesAuthProviderContext {\n userManager: UserManager;\n}\n\nconst HerculesAuthProviderContext =\n createContext<HerculesAuthProviderContext | null>(null);\n\nexport function useHerculesAuthProvider() {\n const context = useContext(HerculesAuthProviderContext);\n if (!context) {\n throw new Error(\"HerculesAuthProviderContext not found\");\n }\n return context;\n}\n\n/**\n * A wrapper React component which provides a {@link ReactAuthProvider}\n * configured with Hercules Auth.\n *\n * @public\n */\nexport function HerculesAuthProvider({\n children,\n userManagerSettings,\n authority,\n client_id,\n ...props\n}: HerculesAuthProviderProps) {\n const [userManager] = useState(\n () =>\n new UserManager({\n ...userManagerSettings,\n authority: userManagerSettings?.authority ?? authority,\n client_id: userManagerSettings?.client_id ?? client_id,\n prompt: userManagerSettings?.prompt ?? \"select_account\",\n response_type: userManagerSettings?.response_type ?? \"code\",\n scope:\n userManagerSettings?.scope ?? \"openid profile email offline_access\",\n redirect_uri:\n userManagerSettings?.redirect_uri ??\n `${window.location.origin}/auth/callback`,\n post_logout_redirect_uri:\n userManagerSettings?.post_logout_redirect_uri ??\n window.location.origin,\n userStore:\n userManagerSettings?.userStore ??\n new WebStorageStateStore({ store: window.localStorage }),\n }),\n );\n\n return (\n <HerculesAuthProviderContext.Provider value={{ userManager }}>\n <ReactAuthProvider\n userManager={userManager}\n {...DEFAULT_AUTH_CONFIG}\n {...props}\n >\n {children}\n </ReactAuthProvider>\n </HerculesAuthProviderContext.Provider>\n );\n}\n","\"use client\";\n\nimport { useMemo } from \"react\";\nimport { useAuth } from \"react-oidc-context\";\n\n/**\n * A hook that returns the current user if authenticated\n *\n * @public\n */\nexport function useUser() {\n const { user, isLoading, error, isAuthenticated } = useAuth();\n\n return useMemo(() => {\n const id = user?.profile.sub;\n const name = user?.profile.name;\n const email = user?.profile.email;\n const avatar = user?.profile.picture;\n return {\n ...(user ?? {}),\n id,\n name,\n email,\n avatar,\n isAuthenticated,\n isLoading,\n error,\n };\n }, [user, isAuthenticated, isLoading, error]);\n}\n","import {\n useAuth as useOidcAuth,\n type AuthContextProps as OidcAuthContextProps,\n} from \"react-oidc-context\";\nimport { useHerculesAuthProvider } from \"./HerculesAuthProvider\";\nimport { useCallback, useMemo } from \"react\";\n\nexport interface AuthContextProps extends OidcAuthContextProps {\n signout: () => Promise<void>;\n signin: () => Promise<void>;\n}\n\nexport function useAuth(): AuthContextProps {\n const { userManager } = useHerculesAuthProvider();\n const auth = useOidcAuth();\n\n const { signoutRedirect, removeUser, signinRedirect } = auth;\n const signout = useCallback(async () => {\n const endpoint = await userManager.metadataService.getEndSessionEndpoint();\n if (endpoint != null) {\n await signoutRedirect();\n } else {\n await removeUser();\n }\n }, [userManager, signoutRedirect, removeUser]);\n\n const signin = useCallback(async () => {\n await signinRedirect();\n }, [signinRedirect]);\n\n return useMemo(() => {\n return {\n ...auth,\n signout,\n signin,\n } satisfies AuthContextProps;\n }, [auth, signout, signin]);\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.mjs","names":["useAuth","hasAuthParams","DEFAULT_AUTH_CONFIG: Partial<HerculesAuthProviderProps>","useAuth","retryTimerId: ReturnType<typeof setTimeout> | null","ReactAuthProvider","useOidcAuth","useAuth","useOidcAuth"],"sources":["../../src/react/auth-callback-hook.tsx","../../src/react/impersonation-core.ts","../../src/react/HerculesAuthProvider.tsx","../../src/react/impersonation.ts","../../src/react/use-user.ts","../../src/react/use-auth.ts"],"sourcesContent":["\"use client\";\n\nimport { useEffect, useState, useRef, useCallback } from \"react\";\nimport { useAuth, hasAuthParams } from \"react-oidc-context\";\nimport { ConvexError } from \"convex/values\";\nimport * as z from \"zod\";\n\nconst DEFAULT_TIMEOUT_MS = 20000; // 20 second timeout\n\nconst convexErrorSchema = z.object({\n message: z.string(),\n});\n\n/**\n * Authentication callback status states\n * @public\n */\nexport type AuthCallbackStatus =\n | \"processing-oauth\" // OIDC is processing the callback\n | \"waiting-backend\" // OIDC authenticated, waiting for backend\n | \"syncing\" // Syncing user with backend (e.g., creating user record)\n | \"success\" // All done\n | \"error\"; // Something went wrong\n\n/**\n * Options for the useAuthCallback hook\n * @public\n */\nexport interface UseAuthCallbackOptions {\n /**\n * Timeout in milliseconds before the callback is considered failed.\n * @default 20000\n */\n timeoutMs?: number;\n\n /**\n * Whether the backend (e.g., Convex) is authenticated.\n * The hook will wait for this to be true before calling onSync.\n */\n isBackendAuthenticated?: boolean;\n\n /**\n * Called when the backend is authenticated and ready to sync.\n * Use this to create/update the user in your backend.\n * Return a promise that resolves when sync is complete.\n */\n onSync?: () => Promise<void>;\n\n /**\n * Called when authentication is successful and sync is complete.\n * Use this to redirect the user.\n */\n onSuccess?: () => void;\n\n /**\n * Called when OIDC is not authenticated and there are no auth params.\n * This typically means the user navigated directly to the callback page.\n * Use this to redirect them away.\n */\n onNoAuthParams?: () => void;\n}\n\n/**\n * Return type for the useAuthCallback hook\n * @public\n */\nexport interface UseAuthCallbackResult {\n /** Current status of the auth callback flow */\n status: AuthCallbackStatus;\n\n /** Error message if status is \"error\" */\n error: string | null;\n\n /** Whether the auth callback is still in progress */\n isLoading: boolean;\n\n /** Whether the auth callback completed successfully */\n isSuccess: boolean;\n\n /** Whether there was an error */\n isError: boolean;\n\n /** Retry the authentication flow by redirecting to the auth provider */\n retry: () => Promise<void>;\n}\n\n/**\n * A hook for handling OAuth/OIDC callback flows.\n *\n * This hook manages the complete authentication callback lifecycle:\n * 1. Processing the OAuth callback from the identity provider\n * 2. Waiting for backend authentication (e.g., Convex)\n * 3. Syncing user data with your backend\n * 4. Handling success and error states\n *\n * @example\n * ```tsx\n * function AuthCallback() {\n * const navigate = useNavigate();\n * const { isAuthenticated } = useConvexAuth();\n * const updateUser = useMutation(api.users.updateCurrentUser);\n *\n * const { status, error, retry } = useAuthCallback({\n * isBackendAuthenticated: isAuthenticated,\n * onSync: () => updateUser(),\n * onSuccess: () => navigate(\"/\", { replace: true }),\n * onNoAuthParams: () => navigate(\"/\", { replace: true }),\n * });\n *\n * if (status === \"error\") {\n * return <ErrorState message={error} onRetry={retry} />;\n * }\n *\n * return <LoadingSpinner />;\n * }\n * ```\n *\n * @public\n */\nexport function useAuthCallback(\n options: UseAuthCallbackOptions = {},\n): UseAuthCallbackResult {\n const {\n timeoutMs = DEFAULT_TIMEOUT_MS,\n isBackendAuthenticated = true,\n onSync,\n onSuccess,\n onNoAuthParams,\n } = options;\n\n const {\n isLoading: isAuthLoading,\n isAuthenticated: isOidcAuthenticated,\n error: oidcError,\n signinRedirect,\n } = useAuth();\n\n const [status, setStatus] = useState<AuthCallbackStatus>(\"processing-oauth\");\n const [error, setError] = useState<string | null>(null);\n\n // Track mount state to prevent state updates after unmount\n const mountedRef = useRef(true);\n // Track if we had auth params on mount (won't change during lifecycle)\n const hadAuthParams = useRef(hasAuthParams());\n // Track if we've already started sync to prevent double execution\n const syncStarted = useRef(false);\n\n // Reset on mount, cleanup on unmount\n useEffect(() => {\n mountedRef.current = true;\n syncStarted.current = false;\n return () => {\n mountedRef.current = false;\n };\n }, []);\n\n // Timeout protection with state awareness\n useEffect(() => {\n if (status === \"success\" || status === \"error\") return;\n\n const timeout = setTimeout(() => {\n if (mountedRef.current) {\n setStatus(\"error\");\n setError(\"Authentication timed out. Please try again.\");\n }\n }, timeoutMs);\n\n return () => clearTimeout(timeout);\n }, [status, timeoutMs]);\n\n // Track OIDC authentication progression\n useEffect(() => {\n // Don't update if we're already past processing or in an error state\n if (status !== \"processing-oauth\" && status !== \"waiting-backend\") return;\n\n // Handle OIDC errors\n if (oidcError) {\n setStatus(\"error\");\n setError(oidcError.message || \"Authentication failed\");\n return;\n }\n\n // No auth params and not authenticated - navigated here directly\n if (!hadAuthParams.current && !isAuthLoading && !isOidcAuthenticated) {\n onNoAuthParams?.();\n return;\n }\n\n // OIDC is done loading and authenticated - move to waiting for backend\n if (\n !isAuthLoading &&\n isOidcAuthenticated &&\n status === \"processing-oauth\"\n ) {\n setStatus(\"waiting-backend\");\n return;\n }\n\n // OIDC finished but not authenticated (and we had auth params)\n // Wait a bit before declaring failure to avoid race conditions\n if (\n hadAuthParams.current &&\n !isAuthLoading &&\n !isOidcAuthenticated &&\n !oidcError &&\n status === \"processing-oauth\"\n ) {\n // Use a small delay to avoid race condition during OIDC state transitions\n const failureTimeout = setTimeout(() => {\n if (mountedRef.current && !isOidcAuthenticated) {\n setStatus(\"error\");\n setError(\"Authentication was cancelled or failed. Please try again.\");\n }\n }, 500);\n\n return () => clearTimeout(failureTimeout);\n }\n\n return;\n }, [isAuthLoading, isOidcAuthenticated, oidcError, status, onNoAuthParams]);\n\n // Sync with backend once backend is authenticated\n useEffect(() => {\n if (status !== \"waiting-backend\" || !isBackendAuthenticated) return;\n if (syncStarted.current) return;\n\n syncStarted.current = true;\n\n async function performSync() {\n if (!mountedRef.current) return;\n\n setStatus(\"syncing\");\n\n try {\n if (onSync) {\n await onSync();\n }\n\n if (mountedRef.current) {\n setStatus(\"success\");\n }\n } catch (err) {\n console.error(\"Auth callback sync failed:\", err);\n\n if (!mountedRef.current) return;\n\n if (err instanceof ConvexError) {\n // try to extract the error message from the convex error\n const parseResult = convexErrorSchema.safeParse(err.data);\n if (parseResult.success) {\n setStatus(\"error\");\n setError(parseResult.data.message);\n return;\n }\n }\n\n // Check if it's an authentication error\n const errorMessage =\n err instanceof Error\n ? err.message\n : \"Failed to complete authentication. Please try again.\";\n\n setStatus(\"error\");\n setError(errorMessage);\n }\n }\n\n performSync();\n }, [status, isBackendAuthenticated, onSync]);\n\n // Handle successful completion\n useEffect(() => {\n if (status === \"success\") {\n onSuccess?.();\n }\n }, [status, onSuccess]);\n\n // Retry handler\n const retry = useCallback(async () => {\n try {\n await signinRedirect();\n } catch (err) {\n console.error(\"Failed to restart auth:\", err);\n }\n }, [signinRedirect]);\n\n return {\n status,\n error,\n isLoading: status !== \"success\" && status !== \"error\",\n isSuccess: status === \"success\",\n isError: status === \"error\",\n retry,\n };\n}\n","\"use client\";\n\nexport const HERCULES_IMPERSONATION_SESSION_ID_PARAM =\n \"hercules_impersonation_session_id\";\nexport const HERCULES_IMPERSONATION_TOKEN_PARAM =\n \"hercules_impersonation_token\";\n\nexport type StoredHerculesImpersonation = {\n sessionId: string;\n startedAt: string;\n};\n\nexport function getHerculesImpersonationStorageKey(\n authority: string,\n clientId: string,\n) {\n return `hercules.impersonation.${authority}.${clientId}`;\n}\n\nexport function rememberHerculesImpersonationSession(\n storageKey: string,\n sessionId: string,\n) {\n if (typeof window === \"undefined\") return;\n window.localStorage.setItem(\n storageKey,\n JSON.stringify({ sessionId, startedAt: new Date().toISOString() }),\n );\n}\n\nexport function clearHerculesImpersonationParamsFromUrl(url: URL) {\n url.searchParams.delete(HERCULES_IMPERSONATION_SESSION_ID_PARAM);\n url.searchParams.delete(HERCULES_IMPERSONATION_TOKEN_PARAM);\n return url;\n}\n","\"use client\";\n\nimport {\n createContext,\n useContext,\n useEffect,\n useRef,\n useState,\n type ReactNode,\n} from \"react\";\nimport {\n AuthProvider as ReactAuthProvider,\n type AuthProviderUserManagerProps,\n useAuth,\n} from \"react-oidc-context\";\nimport {\n UserManager,\n WebStorageStateStore,\n type UserManagerSettings,\n} from \"oidc-client-ts\";\nimport { withRefreshLock } from \"../internal/refresh-lock\";\nimport {\n clearHerculesImpersonationParamsFromUrl,\n getHerculesImpersonationStorageKey,\n HERCULES_IMPERSONATION_SESSION_ID_PARAM,\n HERCULES_IMPERSONATION_TOKEN_PARAM,\n rememberHerculesImpersonationSession,\n} from \"./impersonation-core\";\n\nconst RECOVERY_TIMEOUT_MS = 10_000;\nconst LOCK_GRACE_MS = 5_000;\n\nexport type HerculesAuthProviderProps = Omit<\n AuthProviderUserManagerProps,\n \"userManager\"\n> & {\n userManagerSettings?: Partial<UserManagerSettings>;\n authority: string;\n client_id: string;\n loadingFallback?: ReactNode;\n};\n\nfunction onSigninCallback() {\n window.history.replaceState({}, document.title, window.location.pathname);\n}\n\nfunction onSignoutCallback() {\n window.location.pathname = \"\";\n}\n\nconst DEFAULT_AUTH_CONFIG: Partial<HerculesAuthProviderProps> = {\n onSignoutCallback,\n onSigninCallback,\n};\n\ninterface HerculesAuthProviderContext {\n userManager: UserManager;\n impersonationStorageKey: string;\n}\n\nconst HerculesAuthProviderContext =\n createContext<HerculesAuthProviderContext | null>(null);\n\nexport function useHerculesAuthProvider() {\n const context = useContext(HerculesAuthProviderContext);\n if (!context) {\n throw new Error(\"HerculesAuthProviderContext not found\");\n }\n return context;\n}\n\nfunction AuthRecoveryGate({\n children,\n loadingFallback,\n skipRecovery,\n}: {\n children: ReactNode;\n loadingFallback: ReactNode;\n skipRecovery: boolean;\n}) {\n const { user, isLoading, signinSilent } = useAuth();\n const userExpired = user?.expired === true;\n const hasAttempted = useRef(false);\n const signinSilentRef = useRef(signinSilent);\n signinSilentRef.current = signinSilent;\n const [recoveryDone, setRecoveryDone] = useState(false);\n const [recovering, setRecovering] = useState(false);\n\n useEffect(() => {\n if (skipRecovery) {\n hasAttempted.current = true;\n setRecoveryDone(true);\n return;\n }\n if (isLoading) return;\n if (hasAttempted.current) return;\n hasAttempted.current = true;\n\n if (!user || !userExpired) {\n setRecoveryDone(true);\n return;\n }\n\n setRecovering(true);\n const finish = () => {\n setRecovering(false);\n setRecoveryDone(true);\n };\n setTimeout(finish, RECOVERY_TIMEOUT_MS);\n\n void withRefreshLock(async () => {\n await Promise.race([\n signinSilentRef.current().catch(() => undefined),\n new Promise<void>((resolve) =>\n setTimeout(resolve, RECOVERY_TIMEOUT_MS + LOCK_GRACE_MS),\n ),\n ]);\n }).finally(finish);\n }, [isLoading, skipRecovery, userExpired]);\n\n const shouldBlock =\n !skipRecovery &&\n (recovering || (!recoveryDone && !isLoading && userExpired));\n\n if (shouldBlock) {\n return <>{loadingFallback}</>;\n }\n\n return <>{children}</>;\n}\n\n/**\n * A wrapper React component which provides a {@link ReactAuthProvider}\n * configured with Hercules Auth.\n *\n * @public\n */\nexport function HerculesAuthProvider({\n children,\n userManagerSettings,\n authority,\n client_id,\n loadingFallback = null,\n ...props\n}: HerculesAuthProviderProps) {\n const automaticSilentRenewExplicit =\n userManagerSettings?.automaticSilentRenew === true;\n const [{ userManager, impersonationStorageKey }] = useState(() => {\n const effectiveAuthority = userManagerSettings?.authority ?? authority;\n const effectiveClientId = userManagerSettings?.client_id ?? client_id;\n\n return {\n userManager: new UserManager({\n ...userManagerSettings,\n authority: effectiveAuthority,\n client_id: effectiveClientId,\n prompt: userManagerSettings?.prompt ?? \"select_account\",\n response_type: userManagerSettings?.response_type ?? \"code\",\n scope:\n userManagerSettings?.scope ?? \"openid profile email offline_access\",\n redirect_uri:\n userManagerSettings?.redirect_uri ??\n `${window.location.origin}/auth/callback`,\n post_logout_redirect_uri:\n userManagerSettings?.post_logout_redirect_uri ??\n window.location.origin,\n userStore:\n userManagerSettings?.userStore ??\n new WebStorageStateStore({ store: window.localStorage }),\n automaticSilentRenew:\n userManagerSettings?.automaticSilentRenew ?? false,\n silentRequestTimeoutInSeconds:\n userManagerSettings?.silentRequestTimeoutInSeconds ??\n RECOVERY_TIMEOUT_MS / 1000,\n }),\n impersonationStorageKey: getHerculesImpersonationStorageKey(\n effectiveAuthority,\n effectiveClientId,\n ),\n };\n });\n\n useEffect(() => {\n if (automaticSilentRenewExplicit) return;\n let retryTimerId: ReturnType<typeof setTimeout> | null = null;\n let timeoutRetryCount = 0;\n let stopped = false;\n const events = userManager.events as unknown as {\n _raiseSilentRenewError?: (e: Error) => void;\n };\n const tryRenew = () => {\n if (stopped) return;\n void withRefreshLock(async () => {\n if (stopped) return;\n try {\n await userManager.signinSilent();\n timeoutRetryCount = 0;\n } catch (err) {\n if (stopped) return;\n const isTimeout = err instanceof Error && err.name === \"ErrorTimeout\";\n if (isTimeout) {\n timeoutRetryCount++;\n const maxRetries = (\n userManager.settings as {\n maxSilentRenewTimeoutRetries?: number;\n }\n ).maxSilentRenewTimeoutRetries;\n if (maxRetries !== undefined && timeoutRetryCount > maxRetries) {\n timeoutRetryCount = 0;\n events._raiseSilentRenewError?.(err as Error);\n return;\n }\n retryTimerId = setTimeout(() => {\n retryTimerId = null;\n tryRenew();\n }, 5000);\n } else {\n timeoutRetryCount = 0;\n events._raiseSilentRenewError?.(err as Error);\n }\n }\n });\n };\n const onExpiring = () => tryRenew();\n userManager.events.addAccessTokenExpiring(onExpiring);\n return () => {\n stopped = true;\n userManager.events.removeAccessTokenExpiring(onExpiring);\n if (retryTimerId !== null) clearTimeout(retryTimerId);\n };\n }, [userManager, automaticSilentRenewExplicit]);\n\n return (\n <HerculesAuthProviderContext.Provider\n value={{ userManager, impersonationStorageKey }}\n >\n <ReactAuthProvider\n userManager={userManager}\n {...DEFAULT_AUTH_CONFIG}\n {...props}\n >\n <HerculesImpersonationHandoff storageKey={impersonationStorageKey} />\n <AuthRecoveryGate\n loadingFallback={loadingFallback}\n skipRecovery={hasCompleteImpersonationHandoff()}\n >\n {children}\n </AuthRecoveryGate>\n </ReactAuthProvider>\n </HerculesAuthProviderContext.Provider>\n );\n}\n\nfunction HerculesImpersonationHandoff({ storageKey }: { storageKey: string }) {\n const auth = useAuth();\n const hasStartedRef = useRef(false);\n\n useEffect(() => {\n if (hasStartedRef.current || typeof window === \"undefined\") return;\n\n const url = new URL(window.location.href);\n const impersonationSessionId = url.searchParams.get(\n HERCULES_IMPERSONATION_SESSION_ID_PARAM,\n );\n const impersonationToken = url.searchParams.get(\n HERCULES_IMPERSONATION_TOKEN_PARAM,\n );\n if (!impersonationSessionId && !impersonationToken) return;\n if (!impersonationSessionId || !impersonationToken) {\n window.history.replaceState(\n {},\n document.title,\n clearHerculesImpersonationParamsFromUrl(url).toString(),\n );\n return;\n }\n if (auth.isLoading) return;\n\n hasStartedRef.current = true;\n rememberHerculesImpersonationSession(storageKey, impersonationSessionId);\n window.history.replaceState(\n {},\n document.title,\n clearHerculesImpersonationParamsFromUrl(url).toString(),\n );\n\n void (async () => {\n if (auth.isAuthenticated) {\n await auth.removeUser();\n }\n\n await auth.signinRedirect({\n extraQueryParams: {\n [HERCULES_IMPERSONATION_SESSION_ID_PARAM]: impersonationSessionId,\n [HERCULES_IMPERSONATION_TOKEN_PARAM]: impersonationToken,\n },\n });\n })();\n }, [auth, storageKey]);\n\n return null;\n}\n\nfunction hasCompleteImpersonationHandoff(): boolean {\n if (typeof window === \"undefined\") return false;\n\n const params = new URL(window.location.href).searchParams;\n return (\n params.has(HERCULES_IMPERSONATION_SESSION_ID_PARAM) &&\n params.has(HERCULES_IMPERSONATION_TOKEN_PARAM)\n );\n}\n","\"use client\";\n\nimport { useCallback, useEffect, useMemo, useState } from \"react\";\nimport { useAuth as useOidcAuth } from \"react-oidc-context\";\nimport { useHerculesAuthProvider } from \"./HerculesAuthProvider\";\nimport {\n rememberHerculesImpersonationSession,\n type StoredHerculesImpersonation,\n} from \"./impersonation-core\";\nexport {\n getHerculesImpersonationStorageKey,\n HERCULES_IMPERSONATION_SESSION_ID_PARAM,\n HERCULES_IMPERSONATION_TOKEN_PARAM,\n rememberHerculesImpersonationSession,\n} from \"./impersonation-core\";\n\nexport type HerculesImpersonationState = {\n isImpersonating: boolean;\n sessionId: string | null;\n actorSub: string | null;\n stopImpersonating: () => Promise<void>;\n};\n\nexport function useHerculesImpersonation(): HerculesImpersonationState {\n const { userManager, impersonationStorageKey } = useHerculesAuthProvider();\n const auth = useOidcAuth();\n const [storedSessionId, setStoredSessionId] = useState<string | null>(() =>\n readStoredImpersonationSessionId(impersonationStorageKey),\n );\n\n const profile = (auth.user?.profile ?? {}) as Record<string, unknown>;\n const profileSessionId =\n typeof profile.hercules_impersonation_session_id === \"string\"\n ? profile.hercules_impersonation_session_id\n : null;\n const actorSub =\n typeof profile.hercules_actor_sub === \"string\"\n ? profile.hercules_actor_sub\n : null;\n const sessionId = auth.isAuthenticated ? profileSessionId : storedSessionId;\n\n useEffect(() => {\n if (!auth.isAuthenticated) return;\n\n if (profileSessionId) {\n rememberHerculesImpersonationSession(\n impersonationStorageKey,\n profileSessionId,\n );\n setStoredSessionId(profileSessionId);\n return;\n }\n\n if (typeof window !== \"undefined\") {\n window.localStorage.removeItem(impersonationStorageKey);\n }\n setStoredSessionId(null);\n }, [auth.isAuthenticated, impersonationStorageKey, profileSessionId]);\n\n const stopImpersonating = useCallback(async () => {\n if (typeof window !== \"undefined\") {\n window.localStorage.removeItem(impersonationStorageKey);\n }\n setStoredSessionId(null);\n\n const endpoint = await userManager.metadataService.getEndSessionEndpoint();\n if (endpoint != null) {\n await auth.signoutRedirect();\n } else {\n await auth.removeUser();\n }\n }, [auth, impersonationStorageKey, userManager]);\n\n return useMemo(\n () => ({\n isImpersonating: auth.isAuthenticated && sessionId != null,\n sessionId,\n actorSub,\n stopImpersonating,\n }),\n [actorSub, auth.isAuthenticated, sessionId, stopImpersonating],\n );\n}\n\nfunction readStoredImpersonationSessionId(storageKey: string) {\n if (typeof window === \"undefined\") return null;\n\n try {\n const stored = window.localStorage.getItem(storageKey);\n if (!stored) return null;\n const parsed = JSON.parse(stored) as Partial<StoredHerculesImpersonation>;\n return typeof parsed.sessionId === \"string\" ? parsed.sessionId : null;\n } catch {\n return null;\n }\n}\n","\"use client\";\n\nimport { useMemo } from \"react\";\nimport { useAuth } from \"react-oidc-context\";\n\n/**\n * A hook that returns the current user if authenticated\n *\n * @public\n */\nexport function useUser() {\n const { user, isLoading, error, isAuthenticated } = useAuth();\n\n return useMemo(() => {\n const id = user?.profile.sub;\n const name = user?.profile.name;\n const email = user?.profile.email;\n const avatar = user?.profile.picture;\n return {\n ...(user ?? {}),\n id,\n name,\n email,\n avatar,\n isAuthenticated,\n isLoading,\n error,\n };\n }, [user, isAuthenticated, isLoading, error]);\n}\n","import {\n useAuth as useOidcAuth,\n type AuthContextProps as OidcAuthContextProps,\n} from \"react-oidc-context\";\nimport { useHerculesAuthProvider } from \"./HerculesAuthProvider\";\nimport { useCallback, useMemo } from \"react\";\n\nexport interface AuthContextProps extends OidcAuthContextProps {\n signout: () => Promise<void>;\n signin: () => Promise<void>;\n}\n\nexport function useAuth(): AuthContextProps {\n const { userManager } = useHerculesAuthProvider();\n const auth = useOidcAuth();\n\n const { signoutRedirect, removeUser, signinRedirect } = auth;\n const signout = useCallback(async () => {\n const endpoint = await userManager.metadataService.getEndSessionEndpoint();\n if (endpoint != null) {\n await signoutRedirect();\n } else {\n await removeUser();\n }\n }, [userManager, signoutRedirect, removeUser]);\n\n const signin = useCallback(async () => {\n await signinRedirect();\n }, [signinRedirect]);\n\n return useMemo(() => {\n return {\n ...auth,\n signout,\n signin,\n } satisfies AuthContextProps;\n }, [auth, signout, signin]);\n}\n"],"mappings":"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"}
@@ -0,0 +1,31 @@
1
+ //#region src/internal/refresh-lock.ts
2
+ const REFRESH_LOCK_KEY = "__herculesAuthRefresh";
3
+ const mutexes = /* @__PURE__ */ new Map();
4
+ async function manualMutex(key, callback) {
5
+ return new Promise((resolve, reject) => {
6
+ const wrapped = () => callback().then(resolve).catch(reject).finally(() => {
7
+ const mutex$1 = mutexes.get(key);
8
+ const next = mutex$1.waiting.shift();
9
+ if (next) mutex$1.running = next();
10
+ else mutex$1.running = null;
11
+ });
12
+ let mutex = mutexes.get(key);
13
+ if (!mutex) {
14
+ mutex = {
15
+ running: null,
16
+ waiting: []
17
+ };
18
+ mutexes.set(key, mutex);
19
+ }
20
+ if (mutex.running === null) mutex.running = wrapped();
21
+ else mutex.waiting.push(wrapped);
22
+ });
23
+ }
24
+ async function withRefreshLock(callback) {
25
+ if (typeof navigator !== "undefined" && navigator.locks) return navigator.locks.request(REFRESH_LOCK_KEY, callback);
26
+ return manualMutex(REFRESH_LOCK_KEY, callback);
27
+ }
28
+
29
+ //#endregion
30
+ export { withRefreshLock as t };
31
+ //# sourceMappingURL=refresh-lock-DYW9ITwj.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"refresh-lock-DYW9ITwj.mjs","names":["mutex"],"sources":["../src/internal/refresh-lock.ts"],"sourcesContent":["export const REFRESH_LOCK_KEY = \"__herculesAuthRefresh\";\n\ntype Queue = {\n running: Promise<void> | null;\n waiting: Array<() => Promise<void>>;\n};\n\nconst mutexes = new Map<string, Queue>();\n\nasync function manualMutex<T>(\n key: string,\n callback: () => Promise<T>,\n): Promise<T> {\n return new Promise<T>((resolve, reject) => {\n const wrapped = () =>\n callback()\n .then(resolve)\n .catch(reject)\n .finally(() => {\n const mutex = mutexes.get(key)!;\n const next = mutex.waiting.shift();\n if (next) {\n mutex.running = next();\n } else {\n mutex.running = null;\n }\n });\n\n let mutex = mutexes.get(key);\n if (!mutex) {\n mutex = { running: null, waiting: [] };\n mutexes.set(key, mutex);\n }\n\n if (mutex.running === null) {\n mutex.running = wrapped();\n } else {\n mutex.waiting.push(wrapped);\n }\n });\n}\n\nexport async function withRefreshLock<T>(\n callback: () => Promise<T>,\n): Promise<T> {\n if (typeof navigator !== \"undefined\" && navigator.locks) {\n return navigator.locks.request(REFRESH_LOCK_KEY, callback);\n }\n return manualMutex(REFRESH_LOCK_KEY, callback);\n}\n"],"mappings":";AAAA,MAAa,mBAAmB;AAOhC,MAAM,0BAAU,IAAI,KAAoB;AAExC,eAAe,YACb,KACA,UACY;AACZ,QAAO,IAAI,SAAY,SAAS,WAAW;EACzC,MAAM,gBACJ,UAAU,CACP,KAAK,QAAQ,CACb,MAAM,OAAO,CACb,cAAc;GACb,MAAMA,UAAQ,QAAQ,IAAI,IAAI;GAC9B,MAAM,OAAOA,QAAM,QAAQ,OAAO;AAClC,OAAI,KACF,SAAM,UAAU,MAAM;OAEtB,SAAM,UAAU;IAElB;EAEN,IAAI,QAAQ,QAAQ,IAAI,IAAI;AAC5B,MAAI,CAAC,OAAO;AACV,WAAQ;IAAE,SAAS;IAAM,SAAS,EAAE;IAAE;AACtC,WAAQ,IAAI,KAAK,MAAM;;AAGzB,MAAI,MAAM,YAAY,KACpB,OAAM,UAAU,SAAS;MAEzB,OAAM,QAAQ,KAAK,QAAQ;GAE7B;;AAGJ,eAAsB,gBACpB,UACY;AACZ,KAAI,OAAO,cAAc,eAAe,UAAU,MAChD,QAAO,UAAU,MAAM,QAAQ,kBAAkB,SAAS;AAE5D,QAAO,YAAY,kBAAkB,SAAS"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@usehercules/auth",
3
- "version": "1.0.45",
3
+ "version": "1.1.0",
4
4
  "description": "Authentication utilities for Hercules applications using OIDC",
5
5
  "type": "module",
6
6
  "sideEffects": false,
@@ -40,13 +40,13 @@
40
40
  "@testing-library/react": "^16.3.2",
41
41
  "@types/react": "^19.2.14",
42
42
  "@types/react-dom": "^19.2.3",
43
- "convex": "^1.32.0",
43
+ "convex": "^1.38.0",
44
44
  "jsdom": "^28.1.0",
45
45
  "react": "^19.2.4",
46
46
  "react-dom": "^19.2.4",
47
47
  "tsdown": "^0.18.4",
48
48
  "typescript": "^5.9.3",
49
- "vitest": "^4.0.18"
49
+ "vitest": "^4.1.0"
50
50
  },
51
51
  "scripts": {
52
52
  "build": "tsdown",
@@ -43,9 +43,9 @@ vi.mock("convex/react", () => ({
43
43
  },
44
44
  }));
45
45
 
46
- // Token expiring in 30 minutes (within the 1hr refresh threshold)
46
+ // Token expiring in 30 minutes (within the one-hour refresh threshold).
47
47
  const EXPIRING_TOKEN = makeJwt(Math.floor(Date.now() / 1000) + 30 * 60);
48
- // Token expiring in 2 hours (outside the 1hr refresh threshold)
48
+ // Token expiring in two hours (outside the one-hour refresh threshold).
49
49
  const LONG_LIVED_TOKEN = makeJwt(Math.floor(Date.now() / 1000) + 2 * 60 * 60);
50
50
 
51
51
  function setAuthState(overrides: Record<string, unknown>) {
@@ -111,7 +111,7 @@ describe("ConvexProviderWithHerculesAuth fetchAccessToken", () => {
111
111
  expect(mockSigninSilent).not.toHaveBeenCalled();
112
112
  });
113
113
 
114
- it("skips refresh when token expires more than 1 hour from now", async () => {
114
+ it("skips refresh when token expires more than one hour from now", async () => {
115
115
  setAuthState({ user: { id_token: LONG_LIVED_TOKEN } });
116
116
 
117
117
  const { result } = renderUseAuth();