@passflow/react 0.16.0 → 0.17.0

package/dist/src/components/provider/passflow-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"passflow-provider.d.ts","sourceRoot":"","sources":["../../../../src/components/provider/passflow-provider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiC,KAAK,cAAc,EAA2B,MAAM,gBAAgB,CAAC;AAC7G,OAAO,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,KAAK,SAAS,EAAiE,MAAM,OAAO,CAAC;AACtH,OAAO,EAAmB,KAAK,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAEpG,OAAO,EAIL,KAAK,gBAAgB,EAIrB,KAAK,UAAU,EAEhB,MAAM,WAAW,CAAC;AAEnB,OAAO,oBAAoB,CAAC;AAE5B;;;;;;;GAOG;AACH,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,oBAAoB,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC,CAAC;AAEpG,KAAK,qBAAqB,GAAG,cAAc,GAAG;IAC5C,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC5B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,sBAAsB,CAAC;IAC3C;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,qBAAqB,QACkE,CAAC;AAErG;;;;;;;;;;GAUG;AACH,eAAO,MAAM,4BAA4B,QAAO,MAAM,GAAG,SAQxD,CAAC;AAiCF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,uBAAuB,QAAO,OAA+B,CAAC;AAqK3E;;;GAGG;AACH,KAAK,mBAAmB,GAAG;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IAKvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH;;;;;;GAMG;AACH,KAAK,aAAa,GAAG,MAAM,GAAG,YAAY,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;AAmLtF;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,aAAa,EAAE,aAAa,CAAC;CAC9B,CAAC;AAwCF,eAAO,MAAM,mBAAmB,yCAE9B,CAAC;AAEH,eAAO,MAAM,gBAAgB,EAAE,EAAE,CAAC,qBAAqB,CAyJtD,CAAC"}
+{"version":3,"file":"passflow-provider.d.ts","sourceRoot":"","sources":["../../../../src/components/provider/passflow-provider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiC,KAAK,cAAc,EAA2B,MAAM,gBAAgB,CAAC;AAC7G,OAAO,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,KAAK,SAAS,EAAiE,MAAM,OAAO,CAAC;AACtH,OAAO,EAAmB,KAAK,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAGpG,OAAO,EAIL,KAAK,gBAAgB,EAIrB,KAAK,UAAU,EAEhB,MAAM,WAAW,CAAC;AAEnB,OAAO,oBAAoB,CAAC;AAE5B;;;;;;;GAOG;AACH,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,oBAAoB,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC,CAAC;AAEpG,KAAK,qBAAqB,GAAG,cAAc,GAAG;IAC5C,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC5B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,sBAAsB,CAAC;IAC3C;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,qBAAqB,QACkE,CAAC;AAErG;;;;;;;;;;GAUG;AACH,eAAO,MAAM,4BAA4B,QAAO,MAAM,GAAG,SAQxD,CAAC;AAiCF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,uBAAuB,QAAO,OAA+B,CAAC;AAqK3E;;;GAGG;AACH,KAAK,mBAAmB,GAAG;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IAKvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH;;;;;;GAMG;AACH,KAAK,aAAa,GAAG,MAAM,GAAG,YAAY,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;AAmLtF;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,aAAa,EAAE,aAAa,CAAC;CAC9B,CAAC;AAwCF,eAAO,MAAM,mBAAmB,yCAE9B,CAAC;AAEH,eAAO,MAAM,gBAAgB,EAAE,EAAE,CAAC,qBAAqB,CA0JtD,CAAC"}

package/dist/src/components/provider/use-dispose-on-replace.d.cts

@@ -0,0 +1,17 @@
+import type { Passflow } from '@passflow/core';
+type Disposable = Pick<Passflow, 'dispose'>;
+/**
+ * Disposes a Passflow instance once it is replaced (a new `useMemo` value) or the
+ * provider unmounts. Each instance owns refresh timers, a BroadcastChannel and Web
+ * Locks; one left undisposed keeps acting as an extra tab.
+ *
+ * Why the dispose is deferred: React StrictMode runs effect cleanup and setup again
+ * for the same instance in one commit, while `useMemo` keeps that instance live. An
+ * immediate dispose in cleanup would kill the instance the app keeps using, and core
+ * forbids using an instance after `dispose()`. So cleanup only schedules the dispose
+ * (`setTimeout(0)`); a setup that sees the same instance cancels it. A different
+ * instance or a real unmount leaves the timer to fire.
+ */
+export declare function useDisposeOnReplace(instance: Disposable): void;
+export {};
+//# sourceMappingURL=use-dispose-on-replace.d.ts.map

package/dist/src/components/provider/use-dispose-on-replace.d.ts

@@ -0,0 +1,17 @@
+import type { Passflow } from '@passflow/core';
+type Disposable = Pick<Passflow, 'dispose'>;
+/**
+ * Disposes a Passflow instance once it is replaced (a new `useMemo` value) or the
+ * provider unmounts. Each instance owns refresh timers, a BroadcastChannel and Web
+ * Locks; one left undisposed keeps acting as an extra tab.
+ *
+ * Why the dispose is deferred: React StrictMode runs effect cleanup and setup again
+ * for the same instance in one commit, while `useMemo` keeps that instance live. An
+ * immediate dispose in cleanup would kill the instance the app keeps using, and core
+ * forbids using an instance after `dispose()`. So cleanup only schedules the dispose
+ * (`setTimeout(0)`); a setup that sees the same instance cancels it. A different
+ * instance or a real unmount leaves the timer to fire.
+ */
+export declare function useDisposeOnReplace(instance: Disposable): void;
+export {};
+//# sourceMappingURL=use-dispose-on-replace.d.ts.map

package/dist/src/components/provider/use-dispose-on-replace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-dispose-on-replace.d.ts","sourceRoot":"","sources":["../../../../src/components/provider/use-dispose-on-replace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,KAAK,UAAU,GAAG,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AAO5C;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI,CAe9D"}

package/dist/src/context/auth-context.d.cts

@@ -1,6 +1,6 @@
-import { type ParsedTokens, type Tokens } from '@passflow/core';
+import { type ParsedTokens, type SessionExpiredReason, type Tokens } from '@passflow/core';
 import { type FC, type PropsWithChildren } from 'react';
-export type SessionExpiredHandler = (reason: 'refresh_failed' | 'token_invalid' | 'logged_out') => void;
+export type SessionExpiredHandler = (reason: SessionExpiredReason) => void;
 export type AuthContextValue = {
     isAuthenticated: () => boolean;
     logout: () => void;
@@ -14,8 +14,9 @@ export type AuthContextValue = {
 export declare const AuthContext: import("react").Context<AuthContextValue | undefined>;
 export type AuthProviderProps = PropsWithChildren<{
     /**
-     * Called when the session expires (token refresh failed).
-     * Use this to redirect to your login page.
+     * Called when the session has really ended: last auth strike, no successor token pair
+     * in time, or another user's tokens in storage. A transient refresh failure keeps the
+     * session and does not call this. Use this to redirect to your login page.
      */
     onSessionExpired?: SessionExpiredHandler;
 }>;

package/dist/src/context/auth-context.d.ts

@@ -1,6 +1,6 @@
-import { type ParsedTokens, type Tokens } from '@passflow/core';
+import { type ParsedTokens, type SessionExpiredReason, type Tokens } from '@passflow/core';
 import { type FC, type PropsWithChildren } from 'react';
-export type SessionExpiredHandler = (reason: 'refresh_failed' | 'token_invalid' | 'logged_out') => void;
+export type SessionExpiredHandler = (reason: SessionExpiredReason) => void;
 export type AuthContextValue = {
     isAuthenticated: () => boolean;
     logout: () => void;
@@ -14,8 +14,9 @@ export type AuthContextValue = {
 export declare const AuthContext: import("react").Context<AuthContextValue | undefined>;
 export type AuthProviderProps = PropsWithChildren<{
     /**
-     * Called when the session expires (token refresh failed).
-     * Use this to redirect to your login page.
+     * Called when the session has really ended: last auth strike, no successor token pair
+     * in time, or another user's tokens in storage. A transient refresh failure keeps the
+     * session and does not call this. Use this to redirect to your login page.
      */
     onSessionExpired?: SessionExpiredHandler;
 }>;

package/dist/src/context/auth-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth-context.d.ts","sourceRoot":"","sources":["../../../src/context/auth-context.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAA0C,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxG,OAAO,EAAiB,KAAK,EAAE,EAAE,KAAK,iBAAiB,EAAoC,MAAM,OAAO,CAAC;AAGzG,MAAM,MAAM,qBAAqB,GAAG,CAAC,MAAM,EAAE,gBAAgB,GAAG,eAAe,GAAG,YAAY,KAAK,IAAI,CAAC;AAExG,MAAM,MAAM,gBAAgB,GAAG;IAC7B,eAAe,EAAE,MAAM,OAAO,CAAC;IAC/B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,SAAS,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,YAAY,EAAE,YAAY,GAAG,SAAS,CAAA;KAAE,CAAC,CAAC;CACpH,CAAC;AAEF,eAAO,MAAM,WAAW,uDAAyD,CAAC;AAElF,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;IAChD;;;OAGG;IACH,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;CAC1C,CAAC,CAAC;AAEH,eAAO,MAAM,YAAY,EAAE,EAAE,CAAC,iBAAiB,CAmE9C,CAAC"}
+{"version":3,"file":"auth-context.d.ts","sourceRoot":"","sources":["../../../src/context/auth-context.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,YAAY,EAGjB,KAAK,oBAAoB,EACzB,KAAK,MAAM,EACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAiB,KAAK,EAAE,EAAE,KAAK,iBAAiB,EAAoC,MAAM,OAAO,CAAC;AAGzG,MAAM,MAAM,qBAAqB,GAAG,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,CAAC;AAE3E,MAAM,MAAM,gBAAgB,GAAG;IAC7B,eAAe,EAAE,MAAM,OAAO,CAAC;IAC/B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,SAAS,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,YAAY,EAAE,YAAY,GAAG,SAAS,CAAA;KAAE,CAAC,CAAC;CACpH,CAAC;AAEF,eAAO,MAAM,WAAW,uDAAyD,CAAC;AAElF,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;IAChD;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;CAC1C,CAAC,CAAC;AAEH,eAAO,MAAM,YAAY,EAAE,EAAE,CAAC,iBAAiB,CAkE9C,CAAC"}

package/dist/src/hooks/index.d.cts

@@ -11,8 +11,9 @@ export { useOutsideClick } from './use-outsideclick.cjs';
 export { usePassflow } from './use-passflow.cjs';
 export { type UsePasswordlessCompleteProps, usePasswordlessComplete } from './use-passwordless-complete.cjs';
 export { type UseProviderProps, useProvider } from './use-provider.cjs';
+export { type UseRefreshStatusResult, useRefreshStatus } from './use-refresh-status.cjs';
 export { type UseResetPasswordProps, useResetPassword } from './use-reset-password.cjs';
-export { type SessionExpiredReason, type UseSessionExpiredOptions, type UseSessionExpiredResult, useSessionExpired, } from './use-session-expired.cjs';
+export { type UseSessionExpiredOptions, type UseSessionExpiredResult, useSessionExpired, } from './use-session-expired.cjs';
 export { type UseSignInProps, useSignIn } from './use-signin.cjs';
 export { type UseSignUpProps, useSignUp } from './use-signup.cjs';
 export { type UseTrustedDevicesProps, useTrustedDevices } from './use-trusted-devices.cjs';

package/dist/src/hooks/index.d.ts

@@ -11,8 +11,9 @@ export { useOutsideClick } from './use-outsideclick.js';
 export { usePassflow } from './use-passflow.js';
 export { type UsePasswordlessCompleteProps, usePasswordlessComplete } from './use-passwordless-complete.js';
 export { type UseProviderProps, useProvider } from './use-provider.js';
+export { type UseRefreshStatusResult, useRefreshStatus } from './use-refresh-status.js';
 export { type UseResetPasswordProps, useResetPassword } from './use-reset-password.js';
-export { type SessionExpiredReason, type UseSessionExpiredOptions, type UseSessionExpiredResult, useSessionExpired, } from './use-session-expired.js';
+export { type UseSessionExpiredOptions, type UseSessionExpiredResult, useSessionExpired, } from './use-session-expired.js';
 export { type UseSignInProps, useSignIn } from './use-signin.js';
 export { type UseSignUpProps, useSignUp } from './use-signup.js';
 export { type UseTrustedDevicesProps, useTrustedDevices } from './use-trusted-devices.js';

package/dist/src/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,mBAAmB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,UAAU,GACX,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,KAAK,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,KAAK,cAAc,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,KAAK,4BAA4B,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACzG,OAAO,EAAE,KAAK,gBAAgB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,KAAK,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAEpF,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,KAAK,cAAc,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,KAAK,cAAc,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,KAAK,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AACvF,OAAO,EAAE,KAAK,2BAA2B,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACrG,OAAO,EAAE,KAAK,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC3F,OAAO,EAAE,KAAK,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/F,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACjH,OAAO,EAAE,KAAK,gCAAgC,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAEtH,OAAO,EAAE,KAAK,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC3F,OAAO,EAAE,KAAK,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE3F,OAAO,EAAE,KAAK,gBAAgB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,KAAK,oBAAoB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,mBAAmB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,UAAU,GACX,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,KAAK,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,KAAK,cAAc,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,KAAK,4BAA4B,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACzG,OAAO,EAAE,KAAK,gBAAgB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,KAAK,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACrF,OAAO,EAAE,KAAK,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGpF,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,KAAK,cAAc,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,KAAK,cAAc,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,KAAK,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AACvF,OAAO,EAAE,KAAK,2BAA2B,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACrG,OAAO,EAAE,KAAK,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC3F,OAAO,EAAE,KAAK,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/F,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACjH,OAAO,EAAE,KAAK,gCAAgC,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAEtH,OAAO,EAAE,KAAK,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC3F,OAAO,EAAE,KAAK,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE3F,OAAO,EAAE,KAAK,gBAAgB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,KAAK,oBAAoB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/src/hooks/use-refresh-status.d.cts

@@ -0,0 +1,36 @@
+export interface UseRefreshStatusResult {
+    /**
+     * True inside a transient-failure episode: a token refresh failed for a reason that
+     * does not end the session (network, 5xx) and core is retrying. The session is kept.
+     */
+    isFailing: boolean;
+    /**
+     * Epoch ms of the episode's first transient failure (`RefreshFailing.since`).
+     */
+    since: number | null;
+    /**
+     * Epoch ms of the pending retry, when core knows it (`RefreshFailing.nextRetryAt`).
+     */
+    nextRetryAt: number | null;
+}
+/**
+ * Hook to show a "connection trouble" notice while token refresh is failing transiently.
+ *
+ * Set by `RefreshFailing`; cleared by `RefreshRecovered`, and by `SessionExpired`,
+ * `SignOut`, `SignIn` and `Register`, which end or replace the session the episode
+ * belonged to. A real end of the session is reported by `useSessionExpired`, not here.
+ *
+ * Core reports the episode only as events (there is no getter to read on mount), so a
+ * component that mounts after `RefreshFailing` starts idle. Call the hook in a component
+ * that lives for the whole app, near `PassflowProvider`.
+ *
+ * @example
+ * ```tsx
+ * function ConnectionNotice() {
+ *   const { isFailing } = useRefreshStatus();
+ *   return isFailing ? <Banner>Reconnecting...</Banner> : null;
+ * }
+ * ```
+ */
+export declare function useRefreshStatus(): UseRefreshStatusResult;
+//# sourceMappingURL=use-refresh-status.d.ts.map

package/dist/src/hooks/use-refresh-status.d.ts

@@ -0,0 +1,36 @@
+export interface UseRefreshStatusResult {
+    /**
+     * True inside a transient-failure episode: a token refresh failed for a reason that
+     * does not end the session (network, 5xx) and core is retrying. The session is kept.
+     */
+    isFailing: boolean;
+    /**
+     * Epoch ms of the episode's first transient failure (`RefreshFailing.since`).
+     */
+    since: number | null;
+    /**
+     * Epoch ms of the pending retry, when core knows it (`RefreshFailing.nextRetryAt`).
+     */
+    nextRetryAt: number | null;
+}
+/**
+ * Hook to show a "connection trouble" notice while token refresh is failing transiently.
+ *
+ * Set by `RefreshFailing`; cleared by `RefreshRecovered`, and by `SessionExpired`,
+ * `SignOut`, `SignIn` and `Register`, which end or replace the session the episode
+ * belonged to. A real end of the session is reported by `useSessionExpired`, not here.
+ *
+ * Core reports the episode only as events (there is no getter to read on mount), so a
+ * component that mounts after `RefreshFailing` starts idle. Call the hook in a component
+ * that lives for the whole app, near `PassflowProvider`.
+ *
+ * @example
+ * ```tsx
+ * function ConnectionNotice() {
+ *   const { isFailing } = useRefreshStatus();
+ *   return isFailing ? <Banner>Reconnecting...</Banner> : null;
+ * }
+ * ```
+ */
+export declare function useRefreshStatus(): UseRefreshStatusResult;
+//# sourceMappingURL=use-refresh-status.d.ts.map

package/dist/src/hooks/use-refresh-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-refresh-status.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-refresh-status.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;;OAEG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAaD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,IAAI,sBAAsB,CA4BzD"}

package/dist/src/hooks/use-session-expired.d.cts

@@ -1,4 +1,4 @@
-export type SessionExpiredReason = 'refresh_failed' | 'token_invalid' | 'logged_out';
+import { type SessionExpiredReason } from '@passflow/core';
 export interface UseSessionExpiredOptions {
     /**
      * Called when the session expires.
@@ -23,9 +23,13 @@ export interface UseSessionExpiredResult {
 /**
  * Hook to handle session expiration events.
  *
- * When the SDK detects that the session is invalid (e.g., refresh token expired),
- * it emits a SessionExpired event. This hook allows you to react to that event
- * and redirect users to your login page.
+ * Core emits SessionExpired only when the session has really ended: the last
+ * auth strike (`'refresh_failed'`), no successor token pair in time
+ * (`'successor_timeout'`), or another user's tokens in storage
+ * (`'identity_changed'`). A transient refresh failure (network, 5xx) keeps the
+ * session and is reported as RefreshFailing / RefreshRecovered instead; see
+ * `useRefreshStatus`. This hook lets you react to the real end and redirect
+ * users to your login page.
  *
  * @example
  * ```tsx

package/dist/src/hooks/use-session-expired.d.ts

@@ -1,4 +1,4 @@
-export type SessionExpiredReason = 'refresh_failed' | 'token_invalid' | 'logged_out';
+import { type SessionExpiredReason } from '@passflow/core';
 export interface UseSessionExpiredOptions {
     /**
      * Called when the session expires.
@@ -23,9 +23,13 @@ export interface UseSessionExpiredResult {
 /**
  * Hook to handle session expiration events.
  *
- * When the SDK detects that the session is invalid (e.g., refresh token expired),
- * it emits a SessionExpired event. This hook allows you to react to that event
- * and redirect users to your login page.
+ * Core emits SessionExpired only when the session has really ended: the last
+ * auth strike (`'refresh_failed'`), no successor token pair in time
+ * (`'successor_timeout'`), or another user's tokens in storage
+ * (`'identity_changed'`). A transient refresh failure (network, 5xx) keeps the
+ * session and is reported as RefreshFailing / RefreshRecovered instead; see
+ * `useRefreshStatus`. This hook lets you react to the real end and redirect
+ * users to your login page.
  *
  * @example
  * ```tsx

package/dist/src/hooks/use-session-expired.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-session-expired.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-session-expired.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG,eAAe,GAAG,YAAY,CAAC;AAErF,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,CAAC;CAC3D;AAED,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,gBAAgB,EAAE,OAAO,CAAC;IAC1B;;OAEG;IACH,aAAa,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC3C;;OAEG;IACH,mBAAmB,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,uBAAuB,CAsC7F"}
+{"version":3,"file":"use-session-expired.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-session-expired.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0C,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAInG,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,CAAC;CAC3D;AAED,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,gBAAgB,EAAE,OAAO,CAAC;IAC1B;;OAEG;IACH,aAAa,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC3C;;OAEG;IACH,mBAAmB,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,uBAAuB,CAsC7F"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@passflow/react",
   "description": "Passflow React UI Kit",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "type": "module",
   "files": [
     "dist",
@@ -49,7 +49,7 @@
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "dependencies": {
-    "@passflow/core": "^0.20.1",
+    "@passflow/core": "^0.21.0",
     "@radix-ui/react-dialog": "^1.3.1",
     "@radix-ui/react-popover": "^1.3.1",
     "@simplewebauthn/browser": "^14.0.0",