@nauth-toolkit/client 0.1.95 → 0.1.98

package/dist/index.cjs

@@ -1619,6 +1619,18 @@ var NAuthClient = class {
   }
   /**
    * Refresh tokens manually.
+   *
+   * @throws {NAuthClientError} When refresh fails (e.g., session expired)
+   *
+   * @example
+   * ```typescript
+   * try {
+   *   await client.refreshTokens();
+   * } catch (error) {
+   *   // Session expired - user is already logged out automatically
+   *   router.navigate(['/login']);
+   * }
+   * ```
    */
   async refreshTokens() {
     const tokenDelivery = this.getTokenDeliveryMode();
@@ -1629,10 +1641,19 @@ var NAuthClient = class {
     const refreshFn = async () => {
       return this.post(this.config.endpoints.refresh, body, false);
     };
-    const tokens = await this.tokenManager.refreshOnce(refreshFn, { persist: tokenDelivery === "json" });
-    this.config.onTokenRefresh?.();
-    this.eventEmitter.emit({ type: "auth:refresh", data: { success: true }, timestamp: Date.now() });
-    return tokens;
+    try {
+      const tokens = await this.tokenManager.refreshOnce(refreshFn, { persist: tokenDelivery === "json" });
+      this.config.onTokenRefresh?.();
+      this.eventEmitter.emit({ type: "auth:refresh", data: { success: true }, timestamp: Date.now() });
+      return tokens;
+    } catch (error) {
+      if (error instanceof NAuthClientError && error.statusCode === 401) {
+        await this.clearLocalAuthState();
+        this.config.onSessionExpired?.();
+        this.eventEmitter.emit({ type: "auth:session_expired", data: {}, timestamp: Date.now() });
+      }
+      throw error;
+    }
   }
   // ============================================================================
   // Local state management (no network)