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

package/README.md

@@ -8,10 +8,16 @@ Librairie de composants et utilitaires React pour les projets front-end de la DS
 npm install @shane_donnelly/dsi-internal-react-utils keycloak-js
 ```
 
+### Styles
+
+L'import du CSS est obligatoire pour charger les styles des composants :
+
+```ts
+import '@shane_donnelly/dsi-internal-react-utils/style.css'
+```
+
 ### 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 +165,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/{ProtectedRoute-Bl0cCdQ2.js → ProtectedRoute-_48urWWd.js}

@@ -2,7 +2,7 @@ import { KeycloakProvider as e } from "./keycloak/react/KeycloakProvider/index.j
 import { useAuth as t } from "./keycloak/react/hooks/useAuth.js";
 import { useEffect as n, useRef as r } from "react";
 import { Fragment as i, jsx as a, jsxs as o } from "react/jsx-runtime";
-import './assets/ProtectedRoute.css';var s = {
+var s = {
 	loadingContainer: "_loadingContainer_1th3z_1",
 	spinner: "_spinner_1th3z_11",
 	spin: "_spin_1th3z_11",

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-_48urWWd.js";
+export { n as KeycloakProvider, i as ProtectedRoute, e as logoutKeycloak, t as refreshTokenKeycloak, r as useAuth };

package/dist/keycloak/react/ProtectedRoute/index.js

@@ -1,2 +1,2 @@
-import { t as e } from "../../../ProtectedRoute-Bl0cCdQ2.js";
+import { t as e } from "../../../ProtectedRoute-_48urWWd.js";
 export { e as ProtectedRoute };

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-_48urWWd.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/dist/{assets/ProtectedRoute.css → style.css}

@@ -1 +1,2 @@
 ._loadingContainer_1th3z_1{flex-direction:column;justify-content:center;align-items:center;gap:1rem;min-height:100vh;font-family:system-ui,-apple-system,sans-serif;display:flex}._spinner_1th3z_11{border:3px solid #e5e7eb;border-top-color:#3b82f6;border-radius:50%;width:40px;height:40px;animation:1s linear infinite _spin_1th3z_11}@keyframes _spin_1th3z_11{to{transform:rotate(360deg)}}._errorContainer_1th3z_26{flex-direction:column;justify-content:center;align-items:center;gap:1rem;min-height:100vh;font-family:system-ui,-apple-system,sans-serif;display:flex}._errorMessage_1th3z_36{color:#dc2626;text-align:center;background:#fef2f2;border-radius:12px;max-width:400px;padding:1.5rem}
+/*$vite$:1*/

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@shane_donnelly/dsi-internal-react-utils",
   "private": false,
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
   "scripts": {
     "dev": "vite",
@@ -33,12 +33,16 @@
   },
   "main": "dist/main.js",
   "types": "dist/main.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/main.js",
+      "types": "./dist/main.d.ts"
+    },
+    "./style.css": "./dist/style.css"
+  },
   "files": [
     "dist"
   ],
-  "sideEffects": [
-    "**/*.css"
-  ],
   "peerDependencies": {
     "react": "^19.2.4",
     "react-dom": "^19.2.4",