@shane_donnelly/dsi-internal-react-utils 0.1.0 → 0.1.1

package/README.md

@@ -10,8 +10,6 @@ npm install @shane_donnelly/dsi-internal-react-utils keycloak-js
 
 ### Prérequis
 
-- React >= 19
-- keycloak-js >= 25
 - Un serveur Keycloak configuré avec un realm, un client, et au moins un Identity Provider
 
 > **Recommandé** : utiliser [react-router](https://reactrouter.com/) pour éviter de perdre l'état de la page lors des redirections d'authentification.
@@ -159,3 +157,47 @@ function AdvancedComponent() {
   console.log(keycloak?.tokenParsed);
 }
 ```
+
+### Fonctions utilitaires standalone
+
+Deux fonctions sont disponibles pour manipuler l'instance Keycloak en dehors de React (intercepteurs HTTP, services, etc.) :
+
+```tsx
+import { useAuth, logoutKeycloak, refreshTokenKeycloak } from '@shane_donnelly/dsi-internal-react-utils';
+
+// Récupérer l'instance keycloak via useAuth()
+const { keycloak } = useAuth();
+
+// Rafraîchir le token (minValidity en secondes, défaut: 30)
+const refreshed = await refreshTokenKeycloak(keycloak!, 60);
+const freshToken = keycloak!.token;
+
+// Déconnecter l'utilisateur (redirectUri optionnel, défaut: window.location.origin)
+await logoutKeycloak(keycloak!);
+```
+
+Exemple dans un intercepteur Axios :
+
+```ts
+import axios from 'axios';
+import { logoutKeycloak, refreshTokenKeycloak } from '@shane_donnelly/dsi-internal-react-utils';
+import type Keycloak from 'keycloak-js';
+
+function setupInterceptors(keycloak: Keycloak) {
+  axios.interceptors.request.use(async (config) => {
+    await refreshTokenKeycloak(keycloak, 60);
+    config.headers.Authorization = `Bearer ${keycloak.token}`;
+    return config;
+  });
+
+  axios.interceptors.response.use(
+    (response) => response,
+    async (error) => {
+      if (error.response?.status === 401) {
+        await logoutKeycloak(keycloak);
+      }
+      return Promise.reject(error);
+    },
+  );
+}
+```

package/dist/keycloak/core/client.d.ts

@@ -20,3 +20,41 @@ export declare function initKeycloak(keycloak: Keycloak): Promise<boolean>;
  * @returns Informations utilisateur ou `null`
  */
 export declare function parseUser(keycloak: Keycloak): AuthUser | null;
+/**
+ * Déconnecte l'utilisateur via l'instance Keycloak.
+ *
+ * Utilisable en dehors de React (ex: intercepteur HTTP, service, guard).
+ *
+ * @param keycloak - Instance Keycloak (récupérable via `useAuth().keycloak`)
+ * @param redirectUri - URL de redirection après déconnexion (défaut: `window.location.origin`)
+ *
+ * @example
+ * ```ts
+ * import { logoutKeycloak } from '@shane_donnelly/dsi-internal-react-utils';
+ *
+ * // dans un intercepteur axios
+ * if (response.status === 401) {
+ *   await logoutKeycloak(keycloakInstance);
+ * }
+ * ```
+ */
+export declare function logoutKeycloak(keycloak: Keycloak, redirectUri?: string): Promise<void>;
+/**
+ * Rafraîchit le token d'accès via l'instance Keycloak.
+ *
+ * Utilisable en dehors de React (ex: intercepteur HTTP, service).
+ *
+ * @param keycloak - Instance Keycloak (récupérable via `useAuth().keycloak`)
+ * @param minValidity - Durée minimale de validité restante en secondes (défaut: 30)
+ * @returns `true` si le token a été rafraîchi, `false` sinon
+ *
+ * @example
+ * ```ts
+ * import { refreshTokenKeycloak } from '@shane_donnelly/dsi-internal-react-utils';
+ *
+ * // avant un appel API
+ * await refreshTokenKeycloak(keycloakInstance, 60);
+ * const token = keycloakInstance.token;
+ * ```
+ */
+export declare function refreshTokenKeycloak(keycloak: Keycloak, minValidity?: number): Promise<boolean>;

package/dist/keycloak/core/client.js

@@ -21,5 +21,15 @@ async function n(e) {
 function r(e) {
 	return e.tokenParsed ? e.tokenParsed : null;
 }
+async function i(e, t) {
+	await e.logout({ redirectUri: t ?? window.location.origin });
+}
+async function a(e, t = 30) {
+	try {
+		return await e.updateToken(t);
+	} catch (e) {
+		return console.warn("[dsi-keycloak] Token refresh failed:", e), !1;
+	}
+}
 //#endregion
-export { t as createKeycloakInstance, n as initKeycloak, r as parseUser };
+export { t as createKeycloakInstance, n as initKeycloak, i as logoutKeycloak, r as parseUser, a as refreshTokenKeycloak };

package/dist/keycloak/index.d.ts

@@ -3,4 +3,5 @@ export type { KeycloakProviderProps } from './react/KeycloakProvider';
 export { ProtectedRoute } from './react/ProtectedRoute';
 export type { ProtectedRouteProps } from './react/ProtectedRoute';
 export { useAuth } from './react/hooks/useAuth';
+export { logoutKeycloak, refreshTokenKeycloak } from './core/client';
 export type { KeycloakConfig, KeycloakAuthOptions, AuthStatus, AuthUser, AuthContextValue, } from './core/types';

package/dist/keycloak/index.js

@@ -1,4 +1,5 @@
-import { KeycloakProvider as e } from "./react/KeycloakProvider/index.js";
-import { useAuth as t } from "./react/hooks/useAuth.js";
-import { t as n } from "../ProtectedRoute-Bl0cCdQ2.js";
-export { e as KeycloakProvider, n as ProtectedRoute, t as useAuth };
+import { logoutKeycloak as e, refreshTokenKeycloak as t } from "./core/client.js";
+import { KeycloakProvider as n } from "./react/KeycloakProvider/index.js";
+import { useAuth as r } from "./react/hooks/useAuth.js";
+import { t as i } from "../ProtectedRoute-Bl0cCdQ2.js";
+export { n as KeycloakProvider, i as ProtectedRoute, e as logoutKeycloak, t as refreshTokenKeycloak, r as useAuth };

package/dist/main.d.ts

@@ -1,2 +1,2 @@
-export { KeycloakProvider, ProtectedRoute, useAuth, } from './keycloak';
+export { KeycloakProvider, ProtectedRoute, useAuth, logoutKeycloak, refreshTokenKeycloak, } from './keycloak';
 export type { KeycloakProviderProps, ProtectedRouteProps, KeycloakConfig, KeycloakAuthOptions, AuthStatus, AuthUser, AuthContextValue, } from './keycloak';

package/dist/main.js

@@ -1,5 +1,6 @@
-import { KeycloakProvider as e } from "./keycloak/react/KeycloakProvider/index.js";
-import { useAuth as t } from "./keycloak/react/hooks/useAuth.js";
-import { t as n } from "./ProtectedRoute-Bl0cCdQ2.js";
+import { logoutKeycloak as e, refreshTokenKeycloak as t } from "./keycloak/core/client.js";
+import { KeycloakProvider as n } from "./keycloak/react/KeycloakProvider/index.js";
+import { useAuth as r } from "./keycloak/react/hooks/useAuth.js";
+import { t as i } from "./ProtectedRoute-Bl0cCdQ2.js";
 import "./keycloak/index.js";
-export { e as KeycloakProvider, n as ProtectedRoute, t as useAuth };
+export { n as KeycloakProvider, i as ProtectedRoute, e as logoutKeycloak, t as refreshTokenKeycloak, r as useAuth };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@shane_donnelly/dsi-internal-react-utils",
   "private": false,
-  "version": "0.1.0",
+  "version": "0.1.1",
   "type": "module",
   "scripts": {
     "dev": "vite",