@goralys/core 1.4.3 → 1.5.0

package/dist/index.d.ts

@@ -45,11 +45,26 @@ type CheckAuthImpl = () => boolean;
 declare function configureCheckAuth(impl: CheckAuthImpl): void;
 declare function isAuthenticated(): boolean;
 
+type Toast = {
+    type: "error" | "warning" | "info" | "success";
+    title: string;
+    message: string;
+    expires?: number;
+};
+type ToastFn = (toast: Toast, duration?: number) => void;
+
+interface ToastConfig {
+    getShowToast: () => ToastFn;
+}
+declare function configureToast(cfg: ToastConfig): void;
+declare function getToastConfig(): ToastConfig;
+
 interface GoralysCoreConfig {
     client: GoralysClientConfig;
     storage: StorageAdapter;
     cookies: CookiesAdapter;
     auth: CheckAuthImpl;
+    toast: ToastConfig;
 }
 declare function configGoralysCore(cfg: GoralysCoreConfig): void;
 
@@ -76,14 +91,19 @@ type ConfirmOptions = {
     title: string;
     message: string;
 };
+type AuthTokenContext = "admin-panel" | "profile";
+type AuthToken = {
+    username: string;
+    name: string;
+    expires: Date;
+    created: Date;
+};
 
-type Toast = {
-    type: "error" | "warning" | "info" | "success";
-    title: string;
-    message: string;
-    expires?: number;
+declare function useAuthTokens(context: AuthTokenContext, target?: string | null): {
+    tokens: AuthToken[] | null;
+    refetch: () => Promise<undefined | void>;
+    syncKey: string;
 };
-type ToastFn = (toast: Toast, duration?: number) => void;
 
 type SubjectStatus = "not_submitted" | "submitted" | "rejected" | "approved";
 declare const SubjectStatusConfig: Record<SubjectStatus, {
@@ -121,7 +141,7 @@ type DraftModalResult = {
 declare const getStatusLabel: (status: SubjectStatus) => string;
 declare const getStatusHelper: (status: SubjectStatus, role: UserRole["role"]) => string;
 
-declare function useSubjects(role: UserRole["role"], showToast: ToastFn): {
+declare function useSubjects(role: UserRole["role"]): {
     subjects: Subject[] | null;
     refetch: () => Promise<undefined | void>;
     syncKey: string;
@@ -151,21 +171,40 @@ type SupportTicket = {
     createdAt: PHPDateTime;
 };
 
-declare function useSupportTickets(showToast: ToastFn): {
+declare function useSupportTickets(): {
     supportTickets: SupportTicket[] | null;
     refetch: () => Promise<undefined | void>;
     syncKey: string;
 };
 
+interface UseSyncedResourceOptions<T> {
+    name: string;
+    cacheKey: string;
+    syncKey: string;
+    fetcher: () => Promise<Response | null | undefined>;
+    parse: (data: unknown) => T | null;
+    requireAuth?: boolean;
+    guard?: () => string | null | undefined;
+}
+/**
+ * Shared implementation behind useSubjects / useAuthTokens: cookies sync, localStorage cache, single-flight de-duplication, and a cross-tab
+ * `cookiesOnChange` listener that re-fetches once another tab invalidates the sync flag.
+ */
+declare function useSyncedResource<T>({ name, cacheKey, syncKey, fetcher, parse, requireAuth, guard }: UseSyncedResourceOptions<T>): {
+    data: T | null;
+    refetch: () => Promise<undefined | void>;
+    syncKey: string;
+};
+
 interface UserFetchResult {
     users: User[] | null;
     refetch: () => Promise<void | undefined>;
     syncKey: string;
 }
-declare function useUsers(showToast: ToastFn): UserFetchResult;
-declare function useVirtualUsers(showToast: ToastFn): UserFetchResult;
-declare function useAdmins(showToast: ToastFn): UserFetchResult;
-declare function useVirtualAdmins(showToast: ToastFn): UserFetchResult;
+declare function useUsers(): UserFetchResult;
+declare function useVirtualUsers(): UserFetchResult;
+declare function useAdmins(): UserFetchResult;
+declare function useVirtualAdmins(): UserFetchResult;
 
 declare const LOGO_PATH: {
     main: string;
@@ -183,6 +222,8 @@ declare const EMAIL_KEY = "email";
 declare const PUB_ID_KEY = "public-id";
 declare const SUBJECT_SYNC_RADIX = "subjects-synced-";
 declare const SUBJECT_CACHE_RADIX = "subjects-cache-";
+declare const AUTH_TOKEN_SYNC_RADIX = "auth-tokens-sync-";
+declare const AUTH_TOKEN_CACHE_RADIX = "auth-tokens-cache-";
 declare const USER_CACHE_RADIX = "users-cache-";
 declare const USER_SYNC_RADIX = "users-synced-";
 declare const ADMIN_CACHE_RADIX = "admins-cache-";
@@ -191,6 +232,8 @@ declare const SUPPORT_TICKET_CACHE = "support-tickets-cache";
 declare const SUPPORT_TICKET_SYNC = "support-tickets-synced";
 declare const SUBJECT_SYNCS: Record<UserRole["role"], string>;
 declare const SUBJECT_CACHES: Record<UserRole["role"], string>;
+declare const AUTH_TOKEN_SYNCS: Record<AuthTokenContext, string>;
+declare const AUTH_TOKEN_CACHES: Record<AuthTokenContext, string>;
 type UserType = {
     type: "users-virtual" | "users-real" | "admins-virtual" | "admins-real";
 };
@@ -221,11 +264,16 @@ declare const helpContent: Section[];
 declare function isFoolsDay(): boolean;
 
 declare function buildArray<T>(...items: (T | false | null | undefined)[]): T[];
+declare const fromPhpDate: (phpDate: PHPDateTime) => Date;
 declare const parsePhpDateTime: (phpDate: PHPDateTime) => string;
 
 declare function emitAuthEvent(event: AuthEvent): void;
 declare function onAuthEvent(callback: (event: AuthEvent) => void): () => void;
 
+declare function fetchTokensProfile(): Promise<Response | null>;
+declare function fetchTokensAdminPanel(target: string): Promise<Response | null>;
+declare function fetchAuthTokensForContext(ctx: AuthTokenContext, target?: string | null): Promise<Response | null>;
+
 declare function emitUserEvent(event: UserEvent): void;
 declare function onUserEvent(callback: (event: UserEvent) => void): () => void;
 
@@ -245,7 +293,7 @@ declare function isHTTPMethod(maybeMethod: string): maybeMethod is HttpMethod;
 declare function goralysFetchClient(method: HttpMethod, input: string | URL | Request, payload?: Record<string, string | number | boolean | null> | FormData, requestOptions?: RequestInit): Promise<Response>;
 declare function fetchCsrfClient(formId: string): Promise<string | null>;
 declare function buildApiUrl(endpoint: string, params: Record<string, string | null>, domain?: boolean): string;
-declare function handleToastRequest(r: Response, showToast: (payload: Toast, duration?: number) => void, redirect?: boolean, duration?: number): Promise<boolean>;
+declare function handleToastRequest(r: Response, showToast: ToastFn, redirect?: boolean, duration?: number): Promise<boolean>;
 
 declare class GoralysActionHandler {
     handle: (r: Response) => Promise<void>;
@@ -291,4 +339,4 @@ declare function fetchVirtualUsersClient(): Promise<Response>;
 declare function fetchAdminsClient(): Promise<Response>;
 declare function fetchVirtualAdminsClient(): Promise<Response>;
 
-export { ADMIN_CACHE_RADIX, ADMIN_SYNC_RADIX, type AuthEvent, COOKIES_DISMISSED_KEY, type CheckAuthImpl, type ConfirmOptions, type CookieValue, type CookiesAdapter, type DraftModalResult, EMAIL_KEY, FLASH_TOAST_KEY, FULL_NAME_KEY, GoralysActionHandler, type GoralysClientConfig, HTTP_METHODS, type HttpMethod, LOGO_PATH, PERSISTANT_COOKIES, PERSISTANT_LOCALS, type PHPDateTime, PUB_ID_KEY, ROLE_KEY, SUBJECT_CACHES, SUBJECT_CACHE_RADIX, SUBJECT_SYNCS, SUBJECT_SYNC_RADIX, SUPPORT_TICKET_CACHE, SUPPORT_TICKET_SYNC, type StorageAdapter, type Subject, type SubjectStatus, SubjectStatusConfig, type SubjectsSearchField, type SupportReasons, type SupportTicket, type Toast, type ToastFn, USERNAME_KEY, USER_CACHES, USER_CACHE_RADIX, USER_ROLES, USER_SYNCS, USER_SYNC_RADIX, type User, type UserData, type UserEvent, type UserRole, type UserType, buildApiUrl, buildArray, cacheUserDataClient, configGoralysCore, configureCheckAuth, configureCookies, configureGoralysClient, configureStorage, cookiesGet, cookiesGetAll, cookiesOnChange, cookiesRemove, cookiesSet, emitAuthEvent, emitNavigationEvent, emitUserEvent, emptyUserCacheClient, fetchAdminsClient, fetchCsrfClient, fetchSubjectsForRoleClient, fetchUsersClient, fetchVirtualAdminsClient, fetchVirtualUsersClient, getGoralysClientConfig, getLongFromShort, getShortFromLong, getStatusHelper, getStatusLabel, goralysFetchClient, handleToastRequest, helpContent, isAuthenticated, isFoolsDay, isHTTPMethod, onAuthEvent, onNavigationEvent, onUserEvent, parsePhpDateTime, reasonsConfig, searchFields, storageGet, storageKeyAt, storageRemove, storageSet, storageSize, useAdmins, useSubjects, useSupportTickets, useUsers, useVirtualAdmins, useVirtualUsers };
+export { ADMIN_CACHE_RADIX, ADMIN_SYNC_RADIX, AUTH_TOKEN_CACHES, AUTH_TOKEN_CACHE_RADIX, AUTH_TOKEN_SYNCS, AUTH_TOKEN_SYNC_RADIX, type AuthEvent, type AuthToken, type AuthTokenContext, COOKIES_DISMISSED_KEY, type CheckAuthImpl, type ConfirmOptions, type CookieValue, type CookiesAdapter, type DraftModalResult, EMAIL_KEY, FLASH_TOAST_KEY, FULL_NAME_KEY, GoralysActionHandler, type GoralysClientConfig, HTTP_METHODS, type HttpMethod, LOGO_PATH, PERSISTANT_COOKIES, PERSISTANT_LOCALS, type PHPDateTime, PUB_ID_KEY, ROLE_KEY, SUBJECT_CACHES, SUBJECT_CACHE_RADIX, SUBJECT_SYNCS, SUBJECT_SYNC_RADIX, SUPPORT_TICKET_CACHE, SUPPORT_TICKET_SYNC, type StorageAdapter, type Subject, type SubjectStatus, SubjectStatusConfig, type SubjectsSearchField, type SupportReasons, type SupportTicket, type Toast, type ToastConfig, type ToastFn, USERNAME_KEY, USER_CACHES, USER_CACHE_RADIX, USER_ROLES, USER_SYNCS, USER_SYNC_RADIX, type UseSyncedResourceOptions, type User, type UserData, type UserEvent, type UserRole, type UserType, buildApiUrl, buildArray, cacheUserDataClient, configGoralysCore, configureCheckAuth, configureCookies, configureGoralysClient, configureStorage, configureToast, cookiesGet, cookiesGetAll, cookiesOnChange, cookiesRemove, cookiesSet, emitAuthEvent, emitNavigationEvent, emitUserEvent, emptyUserCacheClient, fetchAdminsClient, fetchAuthTokensForContext, fetchCsrfClient, fetchSubjectsForRoleClient, fetchTokensAdminPanel, fetchTokensProfile, fetchUsersClient, fetchVirtualAdminsClient, fetchVirtualUsersClient, fromPhpDate, getGoralysClientConfig, getLongFromShort, getShortFromLong, getStatusHelper, getStatusLabel, getToastConfig, goralysFetchClient, handleToastRequest, helpContent, isAuthenticated, isFoolsDay, isHTTPMethod, onAuthEvent, onNavigationEvent, onUserEvent, parsePhpDateTime, reasonsConfig, searchFields, storageGet, storageKeyAt, storageRemove, storageSet, storageSize, useAdmins, useAuthTokens, useSubjects, useSupportTickets, useSyncedResource, useUsers, useVirtualAdmins, useVirtualUsers };

package/dist/index.js

@@ -4,9 +4,8 @@ function configureGoralysClient(cfg) {
   config = cfg;
 }
 function getGoralysClientConfig() {
-  if (!config) {
+  if (!config)
     throw new Error("Goralys client not configured. Call configureGoralysClient() first.");
-  }
   return config;
 }
 
@@ -56,38 +55,28 @@ function isAuthenticated() {
   return checkAuthImpl();
 }
 
+// src/lib/toast/config.ts
+var config2 = null;
+function configureToast(cfg) {
+  config2 = cfg;
+}
+function getToastConfig() {
+  if (!config2)
+    throw new Error("Toasts have not been configured yet. Call configureToast() first.");
+  return config2;
+}
+
 // src/config.ts
 function configGoralysCore(cfg) {
   configureGoralysClient(cfg.client);
   configureCookies(cfg.cookies);
   configureStorage(cfg.storage);
   configureCheckAuth(cfg.auth);
+  configureToast(cfg.toast);
 }
 
-// src/hooks/useSubjects.ts
-import { useCallback, useEffect, useMemo, useRef, useState } from "react";
-
-// src/lib/auth/auth-event.ts
-var listeners = /* @__PURE__ */ new Set();
-function emitAuthEvent(event) {
-  listeners.forEach((l) => l(event));
-}
-function onAuthEvent(callback) {
-  listeners.add(callback);
-  return () => {
-    listeners.delete(callback);
-  };
-}
-
-// src/lib/fetch/navigation-event.ts
-var listeners2 = /* @__PURE__ */ new Set();
-function emitNavigationEvent(event) {
-  listeners2.forEach((l) => l(event));
-}
-function onNavigationEvent(listener) {
-  listeners2.add(listener);
-  return () => listeners2.delete(listener);
-}
+// src/hooks/use-auth-tokens.ts
+import { useCallback as useCallback2 } from "react";
 
 // src/lib/config.ts
 var COOKIES_DISMISSED_KEY = "cookie-banner-dismissed";
@@ -101,6 +90,8 @@ var EMAIL_KEY = "email";
 var PUB_ID_KEY = "public-id";
 var SUBJECT_SYNC_RADIX = "subjects-synced-";
 var SUBJECT_CACHE_RADIX = "subjects-cache-";
+var AUTH_TOKEN_SYNC_RADIX = "auth-tokens-sync-";
+var AUTH_TOKEN_CACHE_RADIX = "auth-tokens-cache-";
 var USER_CACHE_RADIX = "users-cache-";
 var USER_SYNC_RADIX = "users-synced-";
 var ADMIN_CACHE_RADIX = "admins-cache-";
@@ -119,6 +110,14 @@ var SUBJECT_CACHES = {
   admin: SUBJECT_CACHE_RADIX + "admin",
   none: SUBJECT_CACHE_RADIX + "unknown"
 };
+var AUTH_TOKEN_SYNCS = {
+  "admin-panel": AUTH_TOKEN_SYNC_RADIX + "admin-panel",
+  profile: AUTH_TOKEN_SYNC_RADIX + "profile"
+};
+var AUTH_TOKEN_CACHES = {
+  "admin-panel": AUTH_TOKEN_CACHE_RADIX + "admin-panel",
+  profile: AUTH_TOKEN_CACHE_RADIX + "profile"
+};
 var USER_SYNCS = {
   "users-real": USER_SYNC_RADIX + "users",
   "users-virtual": USER_SYNC_RADIX + "users-virtual",
@@ -332,6 +331,28 @@ Attention : les administrateurs ont acc\xE8s \xE0 toutes les fonctionnalit\xE9s
   }
 ];
 
+// src/lib/auth/auth-event.ts
+var listeners = /* @__PURE__ */ new Set();
+function emitAuthEvent(event) {
+  listeners.forEach((l) => l(event));
+}
+function onAuthEvent(callback) {
+  listeners.add(callback);
+  return () => {
+    listeners.delete(callback);
+  };
+}
+
+// src/lib/fetch/navigation-event.ts
+var listeners2 = /* @__PURE__ */ new Set();
+function emitNavigationEvent(event) {
+  listeners2.forEach((l) => l(event));
+}
+function onNavigationEvent(listener) {
+  listeners2.add(listener);
+  return () => listeners2.delete(listener);
+}
+
 // src/lib/user/user.client.ts
 async function cacheUserDataClient() {
   const res = await goralysFetchClient("GET", "user/profile");
@@ -414,17 +435,21 @@ var GoralysActionHandler = class {
 // src/lib/fetch/fetch.client.ts
 var actionHandler = new GoralysActionHandler();
 async function goralysFetchClient(method, input, payload, requestOptions) {
+  if (requestOptions?.body)
+    console.error("[Fetch] Found body inside request options. This is not allowed, consider using the payload parameter instead");
   const { apiDomain, getSchoolToken, isNative } = getGoralysClientConfig();
+  const { headers: extraHeaders, ...restOptions } = requestOptions ?? {};
   const res = await fetch(`${apiDomain}/${input}`, {
     credentials: "include",
     method: method === "BREW" ? "POST" : method,
     headers: {
       ...method === "BREW" ? { "X-HTTP-Method-Override": method } : {},
       "X-High-School-Token": getSchoolToken(),
-      "X-Goralys-Client": isNative ? "mobile" : "desktop"
+      "X-Goralys-Client": isNative ? "mobile" : "desktop",
+      ...extraHeaders
     },
     body: payload ? payload instanceof FormData ? payload : JSON.stringify(payload) : void 0,
-    ...requestOptions
+    ...restOptions
   });
   const clone = res.clone();
   const contentType = clone.headers.get("Content-Type");
@@ -491,56 +516,52 @@ async function handleToastRequest(r, showToast, redirect = true, duration) {
   return false;
 }
 
-// src/lib/subjects/subjects.client.ts
-async function fetchStudentSubjectsClient() {
-  const csrfToken = await fetchCsrfClient("get-student-subjects");
-  if (!csrfToken)
-    return null;
-  return await goralysFetchClient("GET", buildApiUrl("subjects/student", { "csrf-token": csrfToken }));
-}
-async function fetchTeacherSubjectsClient() {
-  const csrfToken = await fetchCsrfClient("get-teacher-subjects");
-  if (!csrfToken)
+// src/lib/auth/fetch-auth-tokens.ts
+async function fetchTokensProfile() {
+  const username = cookiesGet(USERNAME_KEY);
+  if (!username) {
+    console.error("[fetchTokensProfile] No username cookies, aborting");
     return null;
-  return await goralysFetchClient("GET", buildApiUrl("subjects/teacher", { "csrf-token": csrfToken }));
+  }
+  return await goralysFetchClient("GET", "user/tokens");
 }
-async function fetchAdminSubjectsClient() {
-  const csrfToken = await fetchCsrfClient("get-admin-subjects");
-  if (!csrfToken)
+async function fetchTokensAdminPanel(target) {
+  const username = cookiesGet(USERNAME_KEY);
+  if (!username) {
+    console.error("[fetchTokensProfile] No username cookies, aborting");
     return null;
-  return await goralysFetchClient("GET", buildApiUrl("subjects/admin", { "csrf-token": csrfToken }));
-}
-async function fetchSubjectsForRoleClient(role) {
-  switch (role.role) {
-    case "student":
-      return await fetchStudentSubjectsClient();
-    case "teacher":
-      return await fetchTeacherSubjectsClient();
-    case "admin":
-      return await fetchAdminSubjectsClient();
-    default:
-      return null;
+  }
+  return await goralysFetchClient("GET", "user/tokens/any", { username: target });
+}
+async function fetchAuthTokensForContext(ctx, target = null) {
+  switch (ctx) {
+    case "profile":
+      return await fetchTokensProfile();
+    case "admin-panel":
+      return await fetchTokensAdminPanel(target);
   }
 }
 
-// src/hooks/useSubjects.ts
-function useSubjects(role, showToast) {
-  const [subjects, setSubjects] = useState(null);
+// src/hooks/use-synced-ressource.ts
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+function useSyncedResource({ name, cacheKey, syncKey, fetcher, parse, requireAuth = true, guard }) {
+  const [data, setData] = useState(null);
+  const showToast = getToastConfig().getShowToast();
   const showToastRef = useRef(showToast);
   useEffect(() => {
     showToastRef.current = showToast;
   }, [showToast]);
   const inFlightRef = useRef(null);
-  const fetchSubjects = useCallback(async () => {
-    const cacheKey = SUBJECT_CACHES[role];
-    const syncKey = SUBJECT_SYNCS[role];
-    console.log("[useSubjects] fetchSubjects called", { role });
-    if (!isAuthenticated()) {
-      console.log("[useSubjects] not authenticated, aborting");
+  const fetchResource = useCallback(async () => {
+    const abortReason = guard?.();
+    if (abortReason) {
+      console.error(`[${name}] ${abortReason}`);
+      return;
+    }
+    if (requireAuth && !isAuthenticated()) {
       return;
     }
     if (inFlightRef.current) {
-      console.log("[useSubjects] in-flight, waiting");
       return inFlightRef.current;
     }
     let resolve;
@@ -550,223 +571,152 @@ function useSubjects(role, showToast) {
     try {
       const syncValue = cookiesGet(syncKey);
       if (syncValue == "1") {
-        const raw = storageGet(cacheKey);
-        if (raw === null || raw === void 0) {
+        const raw2 = storageGet(cacheKey);
+        if (raw2 === null || raw2 === void 0) {
           cookiesSet(syncKey, "0");
           storageRemove(cacheKey);
-          await fetchSubjects();
+          inFlightRef.current = null;
+          resolve();
+          await fetchResource();
           return;
         }
-        const cached = JSON.parse(raw ?? "null");
-        setSubjects((prev) => {
-          if (JSON.stringify(prev) === JSON.stringify(cached))
-            return prev;
-          return cached;
-        });
+        const cached = JSON.parse(raw2 ?? "null");
+        setData((prev) => JSON.stringify(prev) === JSON.stringify(cached) ? prev : cached);
         return;
       }
-      const res = await fetchSubjectsForRoleClient({ role });
+      const res = await fetcher();
       if (res)
         await handleToastRequest(res, showToastRef.current, false);
-      const data = await res?.json();
+      const raw = await res?.json();
       cookiesSet(syncKey, "1");
-      storageSet(cacheKey, JSON.stringify(data));
-      console.log("[useSubjects] set syncKey and cached to localStorage");
-      const result = Array.isArray(data) ? data : null;
-      setSubjects((prev) => {
-        if (JSON.stringify(prev) === JSON.stringify(result))
-          return prev;
-        return result;
-      });
+      storageSet(cacheKey, JSON.stringify(raw));
+      const result = parse(raw);
+      setData((prev) => JSON.stringify(prev) === JSON.stringify(result) ? prev : result);
     } finally {
       inFlightRef.current = null;
       resolve();
     }
-  }, [role, showToastRef]);
+  }, [cacheKey, syncKey, fetcher, parse, requireAuth, guard, name]);
   useEffect(() => {
     const onChange = () => {
       if (inFlightRef.current)
         return;
-      if (cookiesGet(SUBJECT_SYNCS[role]) != "1") {
-        void fetchSubjects();
+      if (cookiesGet(syncKey) != "1") {
+        void fetchResource();
       }
     };
     return cookiesOnChange(onChange);
-  }, [fetchSubjects, role]);
+  }, [fetchResource, syncKey]);
   useEffect(() => {
-    void fetchSubjects();
-  }, [fetchSubjects]);
-  return useMemo(() => ({
-    subjects,
-    refetch: fetchSubjects,
-    syncKey: SUBJECT_SYNCS[role]
-  }), [subjects, fetchSubjects, role]);
+    void fetchResource();
+  }, [fetchResource]);
+  return useMemo(() => ({ data, refetch: fetchResource, syncKey }), [data, fetchResource, syncKey]);
 }
 
-// src/hooks/useSupportTickets.ts
-import { useCallback as useCallback2, useEffect as useEffect2, useMemo as useMemo2, useRef as useRef2, useState as useState2 } from "react";
-function useSupportTickets(showToast) {
-  const [supportTickets, setSupportTickets] = useState2(null);
-  const showToastRef = useRef2(showToast);
-  useEffect2(() => {
-    showToastRef.current = showToast;
-  }, [showToast]);
-  const inFlightRef = useRef2(null);
-  const fetchSupportTickets = useCallback2(async () => {
-    const syncKey = SUPPORT_TICKET_SYNC;
-    const cacheKey = SUPPORT_TICKET_CACHE;
-    if (!isAuthenticated()) {
-      console.log("[useSupportTickets] not authenticated, aborting");
-      return;
-    }
-    if (inFlightRef.current) {
-      console.log("[useSupportTickets] in-flight, waiting");
-      return inFlightRef.current;
-    }
-    let resolve;
-    inFlightRef.current = new Promise((r) => {
-      resolve = r;
-    });
-    try {
-      const syncValue = cookiesGet(syncKey);
-      if (syncValue == "1") {
-        const raw = storageGet(cacheKey);
-        if (raw === null || raw === void 0) {
-          cookiesSet(syncKey, "0");
-          storageRemove(cacheKey);
-          await fetchSupportTickets();
-          return;
-        }
-        const cached = JSON.parse(raw ?? "null");
-        setSupportTickets((prev) => {
-          if (JSON.stringify(prev) === JSON.stringify(cached))
-            return prev;
-          return cached;
-        });
-        return;
-      }
-      const res = await goralysFetchClient("GET", buildApiUrl("support/tickets", { "csrf-token": await fetchCsrfClient("get-tickets") }));
-      if (res)
-        await handleToastRequest(res, showToastRef.current, false);
-      const data = await res?.json();
-      cookiesSet(syncKey, "1");
-      storageSet(cacheKey, JSON.stringify(data));
-      const result = Array.isArray(data) ? data : null;
-      setSupportTickets((prev) => {
-        if (JSON.stringify(prev) === JSON.stringify(result))
-          return prev;
-        return result;
-      });
-    } finally {
-      inFlightRef.current = null;
-      resolve();
-    }
-  }, [showToastRef]);
-  useEffect2(() => {
-    const onChange = () => {
-      if (inFlightRef.current)
-        return;
-      if (cookiesGet(SUPPORT_TICKET_SYNC) != "1") {
-        void fetchSupportTickets();
-      }
-    };
-    return cookiesOnChange(onChange);
-  }, [fetchSupportTickets]);
-  useEffect2(() => {
-    void fetchSupportTickets();
-  }, [fetchSupportTickets]);
-  return useMemo2(() => ({
-    supportTickets,
-    refetch: fetchSupportTickets,
-    syncKey: SUPPORT_TICKET_SYNC
-  }), [supportTickets, fetchSupportTickets]);
+// src/hooks/use-auth-tokens.ts
+function useAuthTokens(context, target = null) {
+  const guard = useCallback2(() => context === "admin-panel" && !target ? "Cannot use admin panel context without target" : null, [context, target]);
+  const fetcher = useCallback2(async () => context === "admin-panel" ? await fetchTokensAdminPanel(target) : await fetchTokensProfile(), [context, target]);
+  const parse = useCallback2((data) => Array.isArray(data) ? data : null, []);
+  const { data: tokens, refetch, syncKey } = useSyncedResource({
+    name: "useAuthTokens",
+    cacheKey: AUTH_TOKEN_CACHES[context],
+    syncKey: AUTH_TOKEN_SYNCS[context],
+    fetcher,
+    parse,
+    guard
+  });
+  return { tokens, refetch, syncKey };
 }
 
-// src/hooks/useUsers.ts
-import { useCallback as useCallback3, useEffect as useEffect3, useMemo as useMemo3, useRef as useRef3, useState as useState3 } from "react";
-function useUserCollection(fetchFn, type, showToast) {
-  const syncKey = USER_SYNCS[type];
-  const cacheKey = USER_CACHES[type];
-  const [users, setUsers] = useState3(null);
-  const showToastRef = useRef3(showToast);
-  useEffect3(() => {
-    showToastRef.current = showToast;
-  }, [showToast]);
-  const inFlightRef = useRef3(null);
-  const fetchUsers = useCallback3(async () => {
-    if (!isAuthenticated()) {
-      console.log("[useUsers] not authenticated, aborting");
-      return;
-    }
-    if (inFlightRef.current)
-      return inFlightRef.current;
-    let resolve;
-    inFlightRef.current = new Promise((r) => {
-      resolve = r;
-    });
-    try {
-      const syncValue = cookiesGet(syncKey);
-      if (syncValue == "1") {
-        const raw = storageGet(cacheKey);
-        if (raw === null || raw === void 0) {
-          cookiesSet(syncKey, "0");
-          storageRemove(cacheKey);
-          await fetchUsers();
-          return;
-        }
-        const cached = JSON.parse(raw ?? "null");
-        setUsers((prev) => {
-          if (JSON.stringify(prev) === JSON.stringify(cached))
-            return prev;
-          return cached;
-        });
-        return;
-      }
-      const res = await fetchFn();
-      if (res)
-        await handleToastRequest(res, showToastRef.current, false);
-      const data = await res?.json();
-      if (res?.ok) {
-        cookiesSet(syncKey, "1");
-        storageSet(cacheKey, JSON.stringify(data));
-      }
-      const result = Array.isArray(data) ? data : null;
-      setUsers((prev) => {
-        if (JSON.stringify(prev) === JSON.stringify(result))
-          return prev;
-        return result;
-      });
-    } finally {
-      inFlightRef.current = null;
-      resolve();
-    }
-  }, [fetchFn, cacheKey, syncKey]);
-  useEffect3(() => {
-    const onChange = () => {
-      if (inFlightRef.current)
-        return;
-      if (cookiesGet(syncKey) != "1") {
-        void fetchUsers();
-      }
-    };
-    return cookiesOnChange(onChange);
-  }, [fetchUsers, syncKey]);
-  useEffect3(() => {
-    void fetchUsers();
-  }, [fetchUsers]);
-  return useMemo3(() => ({ users, refetch: fetchUsers, syncKey }), [users, fetchUsers, syncKey]);
+// src/hooks/use-subjects.ts
+import { useCallback as useCallback3 } from "react";
+
+// src/lib/subjects/subjects.client.ts
+async function fetchStudentSubjectsClient() {
+  const csrfToken = await fetchCsrfClient("get-student-subjects");
+  if (!csrfToken)
+    return null;
+  return await goralysFetchClient("GET", buildApiUrl("subjects/student", { "csrf-token": csrfToken }));
+}
+async function fetchTeacherSubjectsClient() {
+  const csrfToken = await fetchCsrfClient("get-teacher-subjects");
+  if (!csrfToken)
+    return null;
+  return await goralysFetchClient("GET", buildApiUrl("subjects/teacher", { "csrf-token": csrfToken }));
+}
+async function fetchAdminSubjectsClient() {
+  const csrfToken = await fetchCsrfClient("get-admin-subjects");
+  if (!csrfToken)
+    return null;
+  return await goralysFetchClient("GET", buildApiUrl("subjects/admin", { "csrf-token": csrfToken }));
+}
+async function fetchSubjectsForRoleClient(role) {
+  switch (role.role) {
+    case "student":
+      return await fetchStudentSubjectsClient();
+    case "teacher":
+      return await fetchTeacherSubjectsClient();
+    case "admin":
+      return await fetchAdminSubjectsClient();
+    default:
+      return null;
+  }
+}
+
+// src/hooks/use-subjects.ts
+function useSubjects(role) {
+  const fetcher = useCallback3(async () => fetchSubjectsForRoleClient({ role }), [role]);
+  const parse = useCallback3((data) => Array.isArray(data) ? data : null, []);
+  const { data: subjects, refetch, syncKey } = useSyncedResource({
+    name: "useSubjects",
+    cacheKey: SUBJECT_CACHES[role],
+    syncKey: SUBJECT_SYNCS[role],
+    fetcher,
+    parse
+  });
+  return { subjects, refetch, syncKey };
+}
+
+// src/hooks/use-support-tickets.ts
+import { useCallback as useCallback4 } from "react";
+function useSupportTickets() {
+  const fetcher = useCallback4(async () => await goralysFetchClient("GET", buildApiUrl("support/tickets", { "csrf-token": await fetchCsrfClient("get-tickets") })), []);
+  const parse = useCallback4((data) => Array.isArray(data) ? data : null, []);
+  const { data: supportTickets, refetch, syncKey } = useSyncedResource({
+    name: "useSupportTickets",
+    cacheKey: SUPPORT_TICKET_CACHE,
+    syncKey: SUPPORT_TICKET_SYNC,
+    fetcher,
+    parse
+  });
+  return { supportTickets, refetch, syncKey };
+}
+
+// src/hooks/use-users-collection.ts
+import { useCallback as useCallback5 } from "react";
+function useUsersCollection(fetcher, type) {
+  const parse = useCallback5((data) => Array.isArray(data) ? data : null, []);
+  const { data: users, refetch, syncKey } = useSyncedResource({
+    name: "useUsersCollection",
+    cacheKey: USER_CACHES[type],
+    syncKey: USER_SYNCS[type],
+    fetcher,
+    parse
+  });
+  return { users, refetch, syncKey };
 }
-function useUsers(showToast) {
-  return useUserCollection(fetchUsersClient, "users-real", showToast);
+function useUsers() {
+  return useUsersCollection(fetchUsersClient, "users-real");
 }
-function useVirtualUsers(showToast) {
-  return useUserCollection(fetchVirtualUsersClient, "users-virtual", showToast);
+function useVirtualUsers() {
+  return useUsersCollection(fetchVirtualUsersClient, "users-virtual");
 }
-function useAdmins(showToast) {
-  return useUserCollection(fetchAdminsClient, "admins-real", showToast);
+function useAdmins() {
+  return useUsersCollection(fetchAdminsClient, "admins-real");
 }
-function useVirtualAdmins(showToast) {
-  return useUserCollection(fetchVirtualAdminsClient, "admins-virtual", showToast);
+function useVirtualAdmins() {
+  return useUsersCollection(fetchVirtualAdminsClient, "admins-virtual");
 }
 
 // src/lib/asset.ts
@@ -789,8 +739,9 @@ function isFoolsDay() {
 function buildArray(...items) {
   return items.filter((item) => Boolean(item));
 }
+var fromPhpDate = (phpDate) => new Date(phpDate.date);
 var parsePhpDateTime = (phpDate) => {
-  return new Date(phpDate.date).toLocaleString("fr-FR", {
+  return fromPhpDate(phpDate).toLocaleString("fr-FR", {
     year: "numeric",
     month: "2-digit",
     day: "2-digit",
@@ -953,6 +904,10 @@ var USER_ROLES = ["admin", "teacher", "student", "none"];
 export {
   ADMIN_CACHE_RADIX,
   ADMIN_SYNC_RADIX,
+  AUTH_TOKEN_CACHES,
+  AUTH_TOKEN_CACHE_RADIX,
+  AUTH_TOKEN_SYNCS,
+  AUTH_TOKEN_SYNC_RADIX,
   COOKIES_DISMISSED_KEY,
   EMAIL_KEY,
   FLASH_TOAST_KEY,
@@ -984,6 +939,7 @@ export {
   configureCookies,
   configureGoralysClient,
   configureStorage,
+  configureToast,
   cookiesGet,
   cookiesGetAll,
   cookiesOnChange,
@@ -994,16 +950,21 @@ export {
   emitUserEvent,
   emptyUserCacheClient,
   fetchAdminsClient,
+  fetchAuthTokensForContext,
   fetchCsrfClient,
   fetchSubjectsForRoleClient,
+  fetchTokensAdminPanel,
+  fetchTokensProfile,
   fetchUsersClient,
   fetchVirtualAdminsClient,
   fetchVirtualUsersClient,
+  fromPhpDate,
   getGoralysClientConfig,
   getLongFromShort,
   getShortFromLong,
   getStatusHelper,
   getStatusLabel,
+  getToastConfig,
   goralysFetchClient,
   handleToastRequest,
   helpContent,
@@ -1021,8 +982,10 @@ export {
   storageSet,
   storageSize,
   useAdmins,
+  useAuthTokens,
   useSubjects,
   useSupportTickets,
+  useSyncedResource,
   useUsers,
   useVirtualAdmins,
   useVirtualUsers

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@goralys/core",
-    "version": "1.4.3",
+    "version": "1.5.0",
     "license": "LGPL-2.1-or-later",
     "description": "Shared business logic for the Goralys web application",
     "repository": {
@@ -27,9 +27,11 @@
         "access": "public"
     },
     "scripts": {
+        "prebuild": "pnpm barrel",
         "build": "tsup",
         "typeCheck": "tsgo --noEmit",
-        "dev": "tsup --watch"
+        "dev": "tsup --watch",
+        "barrel": "rm ./src/index.ts && barrelsby -d ./src -l top"
     },
     "peerDependencies": {
         "react": ">=18"