@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.
- package/dist/convex-react/index.d.mts.map +1 -1
- package/dist/convex-react/index.mjs +2 -27
- package/dist/convex-react/index.mjs.map +1 -1
- package/dist/react/index.d.mts +20 -1
- package/dist/react/index.d.mts.map +1 -1
- package/dist/react/index.mjs +227 -17
- package/dist/react/index.mjs.map +1 -1
- package/dist/refresh-lock-DYW9ITwj.mjs +31 -0
- package/dist/refresh-lock-DYW9ITwj.mjs.map +1 -0
- package/package.json +3 -3
- package/src/convex-react/ConvexProviderWithHercules.test.tsx +3 -3
- package/src/convex-react/ConvexProviderWithHercules.tsx +2 -52
- package/src/internal/refresh-lock.ts +50 -0
- package/src/react/HerculesAuthProvider.test.tsx +372 -0
- package/src/react/HerculesAuthProvider.tsx +224 -10
- package/src/react/impersonation-core.ts +35 -0
- package/src/react/impersonation.test.tsx +121 -0
- package/src/react/impersonation.ts +96 -0
- package/src/react/index.ts +1 -0
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/convex-react/ConvexProviderWithHercules.tsx"],"sourcesContent":[],"mappings":";;;;;
|
|
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 =
|
|
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":[
|
|
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"}
|
package/dist/react/index.d.mts
CHANGED
|
@@ -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":"
|
|
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"}
|
package/dist/react/index.mjs
CHANGED
|
@@ -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
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
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: {
|
|
190
|
-
|
|
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
|
package/dist/react/index.mjs.map
CHANGED
|
@@ -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":";;;;;;;;;AAOA,MAAM,qBAAqB;AAE3B,MAAM,oBAAoB,EAAE,OAAO,EACjC,SAAS,EAAE,QAAQ,EACpB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4GF,SAAgB,gBACd,UAAkC,EAAE,EACb;CACvB,MAAM,EACJ,YAAY,oBACZ,yBAAyB,MACzB,QACA,WACA,mBACE;CAEJ,MAAM,EACJ,WAAW,eACX,iBAAiB,qBACjB,OAAO,WACP,mBACEA,WAAS;CAEb,MAAM,CAAC,QAAQ,aAAa,SAA6B,mBAAmB;CAC5E,MAAM,CAAC,OAAO,YAAY,SAAwB,KAAK;CAGvD,MAAM,aAAa,OAAO,KAAK;CAE/B,MAAM,gBAAgB,OAAOC,iBAAe,CAAC;CAE7C,MAAM,cAAc,OAAO,MAAM;AAGjC,iBAAgB;AACd,aAAW,UAAU;AACrB,cAAY,UAAU;AACtB,eAAa;AACX,cAAW,UAAU;;IAEtB,EAAE,CAAC;AAGN,iBAAgB;AACd,MAAI,WAAW,aAAa,WAAW,QAAS;EAEhD,MAAM,UAAU,iBAAiB;AAC/B,OAAI,WAAW,SAAS;AACtB,cAAU,QAAQ;AAClB,aAAS,8CAA8C;;KAExD,UAAU;AAEb,eAAa,aAAa,QAAQ;IACjC,CAAC,QAAQ,UAAU,CAAC;AAGvB,iBAAgB;AAEd,MAAI,WAAW,sBAAsB,WAAW,kBAAmB;AAGnE,MAAI,WAAW;AACb,aAAU,QAAQ;AAClB,YAAS,UAAU,WAAW,wBAAwB;AACtD;;AAIF,MAAI,CAAC,cAAc,WAAW,CAAC,iBAAiB,CAAC,qBAAqB;AACpE,qBAAkB;AAClB;;AAIF,MACE,CAAC,iBACD,uBACA,WAAW,oBACX;AACA,aAAU,kBAAkB;AAC5B;;AAKF,MACE,cAAc,WACd,CAAC,iBACD,CAAC,uBACD,CAAC,aACD,WAAW,oBACX;GAEA,MAAM,iBAAiB,iBAAiB;AACtC,QAAI,WAAW,WAAW,CAAC,qBAAqB;AAC9C,eAAU,QAAQ;AAClB,cAAS,4DAA4D;;MAEtE,IAAI;AAEP,gBAAa,aAAa,eAAe;;IAI1C;EAAC;EAAe;EAAqB;EAAW;EAAQ;EAAe,CAAC;AAG3E,iBAAgB;AACd,MAAI,WAAW,qBAAqB,CAAC,uBAAwB;AAC7D,MAAI,YAAY,QAAS;AAEzB,cAAY,UAAU;EAEtB,eAAe,cAAc;AAC3B,OAAI,CAAC,WAAW,QAAS;AAEzB,aAAU,UAAU;AAEpB,OAAI;AACF,QAAI,OACF,OAAM,QAAQ;AAGhB,QAAI,WAAW,QACb,WAAU,UAAU;YAEf,KAAK;AACZ,YAAQ,MAAM,8BAA8B,IAAI;AAEhD,QAAI,CAAC,WAAW,QAAS;AAEzB,QAAI,eAAe,aAAa;KAE9B,MAAM,cAAc,kBAAkB,UAAU,IAAI,KAAK;AACzD,SAAI,YAAY,SAAS;AACvB,gBAAU,QAAQ;AAClB,eAAS,YAAY,KAAK,QAAQ;AAClC;;;IAKJ,MAAM,eACJ,eAAe,QACX,IAAI,UACJ;AAEN,cAAU,QAAQ;AAClB,aAAS,aAAa;;;AAI1B,eAAa;IACZ;EAAC;EAAQ;EAAwB;EAAO,CAAC;AAG5C,iBAAgB;AACd,MAAI,WAAW,UACb,cAAa;IAEd,CAAC,QAAQ,UAAU,CAAC;CAGvB,MAAM,QAAQ,YAAY,YAAY;AACpC,MAAI;AACF,SAAM,gBAAgB;WACf,KAAK;AACZ,WAAQ,MAAM,2BAA2B,IAAI;;IAE9C,CAAC,eAAe,CAAC;AAEpB,QAAO;EACL;EACA;EACA,WAAW,WAAW,aAAa,WAAW;EAC9C,WAAW,WAAW;EACtB,SAAS,WAAW;EACpB;EACD;;;;;ACnSH,MAAa,0CACX;AACF,MAAa,qCACX;AAOF,SAAgB,mCACd,WACA,UACA;AACA,QAAO,0BAA0B,UAAU,GAAG;;AAGhD,SAAgB,qCACd,YACA,WACA;AACA,KAAI,OAAO,WAAW,YAAa;AACnC,QAAO,aAAa,QAClB,YACA,KAAK,UAAU;EAAE;EAAW,4BAAW,IAAI,MAAM,EAAC,aAAa;EAAE,CAAC,CACnE;;AAGH,SAAgB,wCAAwC,KAAU;AAChE,KAAI,aAAa,OAAO,wCAAwC;AAChE,KAAI,aAAa,OAAO,mCAAmC;AAC3D,QAAO;;;;;ACJT,MAAM,sBAAsB;AAC5B,MAAM,gBAAgB;AAYtB,SAAS,mBAAmB;AAC1B,QAAO,QAAQ,aAAa,EAAE,EAAE,SAAS,OAAO,OAAO,SAAS,SAAS;;AAG3E,SAAS,oBAAoB;AAC3B,QAAO,SAAS,WAAW;;AAG7B,MAAMC,sBAA0D;CAC9D;CACA;CACD;AAOD,MAAM,8BACJ,cAAkD,KAAK;AAEzD,SAAgB,0BAA0B;CACxC,MAAM,UAAU,WAAW,4BAA4B;AACvD,KAAI,CAAC,QACH,OAAM,IAAI,MAAM,wCAAwC;AAE1D,QAAO;;AAGT,SAAS,iBAAiB,EACxB,UACA,iBACA,gBAKC;CACD,MAAM,EAAE,MAAM,WAAW,iBAAiBC,WAAS;CACnD,MAAM,cAAc,MAAM,YAAY;CACtC,MAAM,eAAe,OAAO,MAAM;CAClC,MAAM,kBAAkB,OAAO,aAAa;AAC5C,iBAAgB,UAAU;CAC1B,MAAM,CAAC,cAAc,mBAAmB,SAAS,MAAM;CACvD,MAAM,CAAC,YAAY,iBAAiB,SAAS,MAAM;AAEnD,iBAAgB;AACd,MAAI,cAAc;AAChB,gBAAa,UAAU;AACvB,mBAAgB,KAAK;AACrB;;AAEF,MAAI,UAAW;AACf,MAAI,aAAa,QAAS;AAC1B,eAAa,UAAU;AAEvB,MAAI,CAAC,QAAQ,CAAC,aAAa;AACzB,mBAAgB,KAAK;AACrB;;AAGF,gBAAc,KAAK;EACnB,MAAM,eAAe;AACnB,iBAAc,MAAM;AACpB,mBAAgB,KAAK;;AAEvB,aAAW,QAAQ,oBAAoB;AAEvC,EAAK,gBAAgB,YAAY;AAC/B,SAAM,QAAQ,KAAK,CACjB,gBAAgB,SAAS,CAAC,YAAY,OAAU,EAChD,IAAI,SAAe,YACjB,WAAW,SAAS,sBAAsB,cAAc,CACzD,CACF,CAAC;IACF,CAAC,QAAQ,OAAO;IACjB;EAAC;EAAW;EAAc;EAAY,CAAC;AAM1C,KAHE,CAAC,iBACA,cAAe,CAAC,gBAAgB,CAAC,aAAa,aAG/C,QAAO,0CAAG,kBAAmB;AAG/B,QAAO,gCAAG,WAAY;;;;;;;;AASxB,SAAgB,qBAAqB,EACnC,UACA,qBACA,WACA,WACA,kBAAkB,MAClB,GAAG,SACyB;CAC5B,MAAM,+BACJ,qBAAqB,yBAAyB;CAChD,MAAM,CAAC,EAAE,aAAa,6BAA6B,eAAe;EAChE,MAAM,qBAAqB,qBAAqB,aAAa;EAC7D,MAAM,oBAAoB,qBAAqB,aAAa;AAE5D,SAAO;GACL,aAAa,IAAI,YAAY;IAC3B,GAAG;IACH,WAAW;IACX,WAAW;IACX,QAAQ,qBAAqB,UAAU;IACvC,eAAe,qBAAqB,iBAAiB;IACrD,OACE,qBAAqB,SAAS;IAChC,cACE,qBAAqB,gBACrB,GAAG,OAAO,SAAS,OAAO;IAC5B,0BACE,qBAAqB,4BACrB,OAAO,SAAS;IAClB,WACE,qBAAqB,aACrB,IAAI,qBAAqB,EAAE,OAAO,OAAO,cAAc,CAAC;IAC1D,sBACE,qBAAqB,wBAAwB;IAC/C,+BACE,qBAAqB,iCACrB,sBAAsB;IACzB,CAAC;GACF,yBAAyB,mCACvB,oBACA,kBACD;GACF;GACD;AAEF,iBAAgB;AACd,MAAI,6BAA8B;EAClC,IAAIC,eAAqD;EACzD,IAAI,oBAAoB;EACxB,IAAI,UAAU;EACd,MAAM,SAAS,YAAY;EAG3B,MAAM,iBAAiB;AACrB,OAAI,QAAS;AACb,GAAK,gBAAgB,YAAY;AAC/B,QAAI,QAAS;AACb,QAAI;AACF,WAAM,YAAY,cAAc;AAChC,yBAAoB;aACb,KAAK;AACZ,SAAI,QAAS;AAEb,SADkB,eAAe,SAAS,IAAI,SAAS,gBACxC;AACb;MACA,MAAM,aACJ,YAAY,SAGZ;AACF,UAAI,eAAe,UAAa,oBAAoB,YAAY;AAC9D,2BAAoB;AACpB,cAAO,yBAAyB,IAAa;AAC7C;;AAEF,qBAAe,iBAAiB;AAC9B,sBAAe;AACf,iBAAU;SACT,IAAK;YACH;AACL,0BAAoB;AACpB,aAAO,yBAAyB,IAAa;;;KAGjD;;EAEJ,MAAM,mBAAmB,UAAU;AACnC,cAAY,OAAO,uBAAuB,WAAW;AACrD,eAAa;AACX,aAAU;AACV,eAAY,OAAO,0BAA0B,WAAW;AACxD,OAAI,iBAAiB,KAAM,cAAa,aAAa;;IAEtD,CAAC,aAAa,6BAA6B,CAAC;AAE/C,QACE,oBAAC,4BAA4B;EAC3B,OAAO;GAAE;GAAa;GAAyB;YAE/C,qBAACC;GACc;GACb,GAAI;GACJ,GAAI;cAEJ,oBAAC,gCAA6B,YAAY,0BAA2B,EACrE,oBAAC;IACkB;IACjB,cAAc,iCAAiC;IAE9C;KACgB;IACD;GACiB;;AAI3C,SAAS,6BAA6B,EAAE,cAAsC;CAC5E,MAAM,OAAOF,WAAS;CACtB,MAAM,gBAAgB,OAAO,MAAM;AAEnC,iBAAgB;AACd,MAAI,cAAc,WAAW,OAAO,WAAW,YAAa;EAE5D,MAAM,MAAM,IAAI,IAAI,OAAO,SAAS,KAAK;EACzC,MAAM,yBAAyB,IAAI,aAAa,IAC9C,wCACD;EACD,MAAM,qBAAqB,IAAI,aAAa,IAC1C,mCACD;AACD,MAAI,CAAC,0BAA0B,CAAC,mBAAoB;AACpD,MAAI,CAAC,0BAA0B,CAAC,oBAAoB;AAClD,UAAO,QAAQ,aACb,EAAE,EACF,SAAS,OACT,wCAAwC,IAAI,CAAC,UAAU,CACxD;AACD;;AAEF,MAAI,KAAK,UAAW;AAEpB,gBAAc,UAAU;AACxB,uCAAqC,YAAY,uBAAuB;AACxE,SAAO,QAAQ,aACb,EAAE,EACF,SAAS,OACT,wCAAwC,IAAI,CAAC,UAAU,CACxD;AAED,GAAM,YAAY;AAChB,OAAI,KAAK,gBACP,OAAM,KAAK,YAAY;AAGzB,SAAM,KAAK,eAAe,EACxB,kBAAkB;KACf,0CAA0C;KAC1C,qCAAqC;IACvC,EACF,CAAC;MACA;IACH,CAAC,MAAM,WAAW,CAAC;AAEtB,QAAO;;AAGT,SAAS,kCAA2C;AAClD,KAAI,OAAO,WAAW,YAAa,QAAO;CAE1C,MAAM,SAAS,IAAI,IAAI,OAAO,SAAS,KAAK,CAAC;AAC7C,QACE,OAAO,IAAI,wCAAwC,IACnD,OAAO,IAAI,mCAAmC;;;;;AC9RlD,SAAgB,2BAAuD;CACrE,MAAM,EAAE,aAAa,4BAA4B,yBAAyB;CAC1E,MAAM,OAAOG,WAAa;CAC1B,MAAM,CAAC,iBAAiB,sBAAsB,eAC5C,iCAAiC,wBAAwB,CAC1D;CAED,MAAM,UAAW,KAAK,MAAM,WAAW,EAAE;CACzC,MAAM,mBACJ,OAAO,QAAQ,sCAAsC,WACjD,QAAQ,oCACR;CACN,MAAM,WACJ,OAAO,QAAQ,uBAAuB,WAClC,QAAQ,qBACR;CACN,MAAM,YAAY,KAAK,kBAAkB,mBAAmB;AAE5D,iBAAgB;AACd,MAAI,CAAC,KAAK,gBAAiB;AAE3B,MAAI,kBAAkB;AACpB,wCACE,yBACA,iBACD;AACD,sBAAmB,iBAAiB;AACpC;;AAGF,MAAI,OAAO,WAAW,YACpB,QAAO,aAAa,WAAW,wBAAwB;AAEzD,qBAAmB,KAAK;IACvB;EAAC,KAAK;EAAiB;EAAyB;EAAiB,CAAC;CAErE,MAAM,oBAAoB,YAAY,YAAY;AAChD,MAAI,OAAO,WAAW,YACpB,QAAO,aAAa,WAAW,wBAAwB;AAEzD,qBAAmB,KAAK;AAGxB,MADiB,MAAM,YAAY,gBAAgB,uBAAuB,IAC1D,KACd,OAAM,KAAK,iBAAiB;MAE5B,OAAM,KAAK,YAAY;IAExB;EAAC;EAAM;EAAyB;EAAY,CAAC;AAEhD,QAAO,eACE;EACL,iBAAiB,KAAK,mBAAmB,aAAa;EACtD;EACA;EACA;EACD,GACD;EAAC;EAAU,KAAK;EAAiB;EAAW;EAAkB,CAC/D;;AAGH,SAAS,iCAAiC,YAAoB;AAC5D,KAAI,OAAO,WAAW,YAAa,QAAO;AAE1C,KAAI;EACF,MAAM,SAAS,OAAO,aAAa,QAAQ,WAAW;AACtD,MAAI,CAAC,OAAQ,QAAO;EACpB,MAAM,SAAS,KAAK,MAAM,OAAO;AACjC,SAAO,OAAO,OAAO,cAAc,WAAW,OAAO,YAAY;SAC3D;AACN,SAAO;;;;;;;;;;;ACnFX,SAAgB,UAAU;CACxB,MAAM,EAAE,MAAM,WAAW,OAAO,oBAAoBC,WAAS;AAE7D,QAAO,cAAc;EACnB,MAAM,KAAK,MAAM,QAAQ;EACzB,MAAM,OAAO,MAAM,QAAQ;EAC3B,MAAM,QAAQ,MAAM,QAAQ;EAC5B,MAAM,SAAS,MAAM,QAAQ;AAC7B,SAAO;GACL,GAAI,QAAQ,EAAE;GACd;GACA;GACA;GACA;GACA;GACA;GACA;GACD;IACA;EAAC;EAAM;EAAiB;EAAW;EAAM,CAAC;;;;;AChB/C,SAAgB,UAA4B;CAC1C,MAAM,EAAE,gBAAgB,yBAAyB;CACjD,MAAM,OAAOC,WAAa;CAE1B,MAAM,EAAE,iBAAiB,YAAY,mBAAmB;CACxD,MAAM,UAAU,YAAY,YAAY;AAEtC,MADiB,MAAM,YAAY,gBAAgB,uBAAuB,IAC1D,KACd,OAAM,iBAAiB;MAEvB,OAAM,YAAY;IAEnB;EAAC;EAAa;EAAiB;EAAW,CAAC;CAE9C,MAAM,SAAS,YAAY,YAAY;AACrC,QAAM,gBAAgB;IACrB,CAAC,eAAe,CAAC;AAEpB,QAAO,cAAc;AACnB,SAAO;GACL,GAAG;GACH;GACA;GACD;IACA;EAAC;EAAM;EAAS;EAAO,CAAC"}
|
|
@@ -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
|
|
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.
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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();
|