chore: remove agent-oriented comments from the codebase (#25)
CD — Deployment / deploy (push) Successful in 23s

PR automatique de chore/code-cleanup vers main.

---------

Co-authored-by: xEsiah <[email protected]>
Reviewed-on: #25
Reviewed-by: Esiah <[email protected]>
Co-authored-by: Gitea Actions <-[email protected]>
This commit was merged in pull request #25.
This commit is contained in:
Gitea Actions
2026-11-04 15:04:00 +00:00
committed by Esiah
co-authored by Esiah
parent fb7d0bab16
commit d837817bcb
52 changed files with 70 additions and 841 deletions
-34
View File
@@ -45,7 +45,6 @@ export interface UploadedFile {
updated_at: string;
}
/** Etat d'une session d'envoi resumable, cote serveur. */
export interface UploadSession {
uploadId: string;
name: string;
@@ -56,7 +55,6 @@ export interface UploadSession {
expiresAt: string;
}
/** Au-dela de ce seuil, l'envoi passe par des morceaux de 50 MiB. */
export const LARGE_UPLOAD_THRESHOLD = 90 * 1024 * 1024;
export interface FavoriteFile extends UploadedFile {
@@ -216,11 +214,6 @@ const BASE = "/api/cloud";
const messageOf = (body: unknown, fallback: string): string =>
(body as { error?: { message?: string } } | null)?.error?.message ?? fallback;
/**
* Un seul point d'entree HTTP. Le cookie de session est envoye
* automatiquement (same-origin), et toute erreur non-2xx devient une
* ApiError portant le message serveur, jamais un corps brut.
*/
const request = async <T>(path: string, init?: RequestInit): Promise<T> => {
let response: Response;
try {
@@ -267,7 +260,6 @@ const query = (params: Record<string, string | number | null | undefined>): stri
return suffix ? `?${suffix}` : "";
};
/** Envoi d'un corps brut (fichier, image), hors JSON. */
const putBinary = async <T>(path: string, body: BodyInit, type: string): Promise<T> => {
let response: Response;
try {
@@ -285,12 +277,6 @@ const putBinary = async <T>(path: string, body: BodyInit, type: string): Promise
return parsed as T;
};
/**
* Identifiant de reprise, stocke localement : si l'onglet est ferme pendant un
* gros envoi, le meme fichier reprend a l'octet pres au lieu de repartir de
* zero. La cle inclut la date de modification pour ne pas confondre deux
* fichiers homonymes.
*/
const resumeKey = (file: File, folderId: string | null): string =>
`cohaise.upload:${folderId ?? "root"}:${file.name}:${file.size}:${file.lastModified}`;
@@ -306,7 +292,6 @@ const writeResume = (key: string, uploadId: string): void => {
try {
window.localStorage.setItem(key, uploadId);
} catch {
/* navigation privee : la reprise inter-onglets est simplement indisponible */
}
};
@@ -314,11 +299,9 @@ const clearResume = (key: string): void => {
try {
window.localStorage.removeItem(key);
} catch {
/* voir writeResume */
}
};
/** Envoi d'un morceau en XHR : `fetch` n'expose pas la progression montante. */
const sendChunk = (
uploadId: string,
blob: Blob,
@@ -341,7 +324,6 @@ const sendChunk = (
try {
parsed = JSON.parse(xhr.responseText);
} catch {
/* reponse non JSON : message generique */
}
reject(new ApiError(xhr.status, messageOf(parsed, "L'envoi du morceau a echoue.")));
};
@@ -352,11 +334,6 @@ const sendChunk = (
const sessionPath = (uploadId: string): string => `/uploads/${encodeURIComponent(uploadId)}`;
/**
* Envoi resumable en morceaux de 50 MiB. Chaque morceau reste sous la limite
* de corps de requete de Cloudflare ; le serveur ne publie le fichier qu'une
* fois tous les morceaux recus et le nom verifie.
*/
const uploadFileResumable = async (
file: File,
folderId: string | null,
@@ -412,8 +389,6 @@ const uploadFileResumable = async (
attempts += 1;
if (!transient || attempts > 4) throw error;
// Laisse au serveur le temps de terminer (ou d'annuler) le morceau
// avant de lui demander ou en est reellement le curseur.
await new Promise((resolve) => setTimeout(resolve, 400 * attempts));
const status = await request<{ upload: UploadSession }>(sessionPath(uploadId));
if (status.upload.name !== file.name || status.upload.size !== file.size) {
@@ -430,7 +405,6 @@ const uploadFileResumable = async (
};
export const api = {
// --- Session -----------------------------------------------------------
me: () => request<{ user: User }>("/auth/me"),
login: (email: string, password: string) =>
post<{ user: User }>("/auth/login", { email, password }),
@@ -445,7 +419,6 @@ export const api = {
confirmEmailChange: (token: string) =>
post<{ ok: boolean; email: string }>("/account/email-change/confirm", { token }),
// --- Compte ------------------------------------------------------------
updateProfile: (first_name: string, last_name: string) =>
patch<{ ok: boolean }>("/account/profile", { first_name, last_name }),
preferences: () => request<{ theme: Theme; language: Language }>("/account/preferences"),
@@ -459,7 +432,6 @@ export const api = {
deleteAvatar: () => del<{ ok: boolean }>("/account/avatar"),
directory: () => request<{ users: DirectoryUser[] }>("/directory"),
// --- Dossiers ----------------------------------------------------------
folders: (parentId?: string | null) =>
request<{ parentId: string | null; folders: Folder[] }>(
`/folders${query({ parentId })}`,
@@ -486,7 +458,6 @@ export const api = {
`/folders/${encodeURIComponent(id)}/permissions/${encodeURIComponent(userId)}`,
),
// --- Fichiers ----------------------------------------------------------
files: (folderId?: string | null) =>
request<{ folderId: string | null; files: UploadedFile[] }>(`/files${query({ folderId })}`),
uploadFile: (
@@ -521,7 +492,6 @@ export const api = {
thumbnailUrl: (id: string) => `${BASE}/files/${encodeURIComponent(id)}/thumbnail`,
previewUrl: (id: string) => `${BASE}/files/${encodeURIComponent(id)}/preview`,
// --- Corbeille, recherche, galerie ------------------------------------
trash: () =>
request<{ retentionDays: number; folders: TrashFolder[]; files: TrashFile[] }>("/trash"),
restoreFolder: (id: string) =>
@@ -539,7 +509,6 @@ export const api = {
`/media${query({ kind, limit, offset })}`,
),
// --- Chat d'un dossier ------------------------------------------------
chatMembers: (folderId: string) =>
request<{ members: ChatMember[] }>(`/folders/${encodeURIComponent(folderId)}/chat/members`),
chatMessages: (folderId: string, after = 0, limit = 50, editedAfter?: string | null) =>
@@ -562,7 +531,6 @@ export const api = {
del<{ ok: boolean }>(`/folders/${encodeURIComponent(folderId)}/chat/messages/${id}`),
chatUnread: () => request<{ unread: Record<string, number> }>("/chat/unread"),
// --- Administration ----------------------------------------------------
adminStats: () => request<AdminStats>("/admin/stats"),
adminUsers: (q?: string) =>
request<{ users: AdminUser[] }>(`/admin/users${query({ q })}`),
@@ -608,7 +576,6 @@ export const api = {
),
};
/** Octets en lecture humaine, sans precision inutile. */
export const formatBytes = (bytes: number): string => {
const english = getLanguage() === "en";
if (bytes < 1024) return `${bytes} ${english ? "B" : "o"}`;
@@ -625,7 +592,6 @@ export const formatBytes = (bytes: number): string => {
export const formatDate = (value: string | null): string =>
value ? new Date(value).toLocaleString(getLocale(), { dateStyle: "medium", timeStyle: "short" }) : "—";
/** Date et heure completes, avec les secondes : utilise au survol d'un mention. */
export const formatDateTimeSeconds = (value: string | null): string =>
value
? new Date(value).toLocaleString(getLocale(), {
-28
View File
@@ -8,13 +8,7 @@ import {
import type { Language } from "./api.js";
import { setLanguage } from "./locale.js";
/**
* Traduction par clef de source : la chaine francaise sert de clef, le
* dictionnaire anglais fournit la variante. Une clef absente retombe sur le
* francais, donc un oubli ne casse jamais l'interface.
*/
const en: Record<string, string> = {
// --- Commun ------------------------------------------------------------
"Annuler": "Cancel",
"Enregistrer": "Save",
"Créer": "Create",
@@ -50,7 +44,6 @@ const en: Record<string, string> = {
"Chargement des dossiers…": "Loading folders…",
"Chargement des partages impossible.": "Unable to load shares.",
// --- Navigation / coque ------------------------------------------------
"Fichiers": "Files",
"Favoris": "Favorites",
"Recherche": "Search",
@@ -65,7 +58,6 @@ const en: Record<string, string> = {
"Fermer le menu": "Close menu",
"Ouvrir le menu": "Open menu",
// --- Connexion ---------------------------------------------------------
"Connectez-vous pour accéder à vos fichiers.": "Sign in to access your files.",
"Connexion": "Sign in",
"Votre session reste ouverte 14 jours.": "Your session stays open for 14 days.",
@@ -74,7 +66,6 @@ const en: Record<string, string> = {
"Se connecter": "Sign in",
"Mot de passe oublié ?": "Forgot your password?",
// --- Mot de passe oublié ----------------------------------------------
"Mot de passe oublié": "Forgot password",
"Réinitialisation": "Reset",
"Nous vous enverrons un lien valable une heure.": "We will email you a link valid for one hour.",
@@ -83,7 +74,6 @@ const en: Record<string, string> = {
"Retour à la connexion": "Back to sign in",
"Envoyer le lien": "Send link",
// --- Réinitialisation --------------------------------------------------
"Nouveau mot de passe": "New password",
"Choisissez un mot de passe robuste.": "Choose a strong password.",
"Ce lien est incomplet ou invalide.": "This link is incomplete or invalid.",
@@ -95,12 +85,10 @@ const en: Record<string, string> = {
"Réinitialiser": "Reset",
"Les deux mots de passe ne correspondent pas.": "The two passwords do not match.",
// --- Changement d'adresse ---------------------------------------------
"Changement d'adresse": "Email change",
"Votre adresse e-mail a été mise à jour.": "Your email address has been updated.",
"Accéder à mes fichiers": "Go to my files",
// --- Changement de mot de passe ---------------------------------------
"Bienvenue {name}. Ce mot de passe a été défini par un administrateur : choisissez le vôtre.":
"Welcome {name}. This password was set by an administrator: choose your own.",
"Changement requis": "Change required",
@@ -109,7 +97,6 @@ const en: Record<string, string> = {
"Mot de passe actuel": "Current password",
"Se déconnecter": "Sign out",
// --- Explorateur -------------------------------------------------------
"Racine": "Root",
"Vos dossiers et fichiers. Envoyez un fichier ou créez un dossier.":
"Your folders and files. Upload a file or create a folder.",
@@ -138,7 +125,6 @@ const en: Record<string, string> = {
"ce fichier": "this file",
"Placer {name} ({kind}) dans la corbeille ?": "Move {name} ({kind}) to the trash?",
// --- Boites de dialogue ------------------------------------------------
"Lecture": "Read",
"Écriture": "Write",
"Nom": "Name",
@@ -162,7 +148,6 @@ const en: Record<string, string> = {
"Épinglage impossible.": "Unable to pin.",
"Envoi du message impossible.": "Unable to send the message.",
// --- Discussion de dossier --------------------------------------------
"Compte supprimé": "Deleted account",
"Supprimer le message": "Delete message",
"Ce message sera retiré du salon pour tout le monde.":
@@ -189,7 +174,6 @@ const en: Record<string, string> = {
"Désépingler le message": "Unpin message",
"Messages épinglés": "Pinned messages",
// --- Explorateur / drag & drop -----------------------------------------
"Déposez vos fichiers ici": "Drop your files here",
"{count} fichier(s) déposé(s) dans {name}.": "{count} file(s) uploaded to {name}.",
"{count} fichier(s) déposé(s) dans ce dossier.": "{count} file(s) uploaded to this folder.",
@@ -197,7 +181,6 @@ const en: Record<string, string> = {
"Envoi {current}/{total}…": "Uploading {current}/{total}…",
"{current}/{total}": "{current}/{total}",
// --- Sélection multiple -----------------------------------------------
"Sélectionner {name}": "Select {name}",
"{count} élément(s) sélectionné(s).": "{count} item(s) selected.",
"Annuler la sélection": "Clear selection",
@@ -208,7 +191,6 @@ const en: Record<string, string> = {
"Seuls les fichiers peuvent être téléchargés.": "Only files can be downloaded.",
"Les dossiers n'ont pas été téléchargés.": "Folders were not downloaded.",
// --- Visionneuse -------------------------------------------------------
"Lecture impossible.": "Unable to read.",
"Ouvrir": "Open",
"Le PDF s'ouvre dans un nouvel onglet.": "The PDF opens in a new tab.",
@@ -216,14 +198,12 @@ const en: Record<string, string> = {
"Fichier précédent": "Previous file",
"Fichier suivant": "Next file",
// --- Favoris -----------------------------------------------------------
"Les fichiers que vous avez étoilés, tous dossiers confondus.":
"The files you starred, across all folders.",
"Aucun favori": "No favorites",
"Étoilez un fichier dans l'explorateur pour le retrouver ici.":
"Star a file in the browser to find it here.",
// --- Recherche ---------------------------------------------------------
"Saisissez au moins deux caractères.": "Enter at least two characters.",
"Recherchez par nom dans les dossiers et fichiers auxquels vous avez accès.":
"Search by name in the folders and files you can access.",
@@ -234,7 +214,6 @@ const en: Record<string, string> = {
"Aucun résultat": "No results",
"Rien ne correspond à « {q} ».": "Nothing matches “{q}”.",
// --- Galerie -----------------------------------------------------------
"Tout": "All",
"Images": "Images",
"Vidéos": "Videos",
@@ -247,7 +226,6 @@ const en: Record<string, string> = {
"Aucun média": "No media",
"Rien à afficher pour ce filtre.": "Nothing to show for this filter.",
// --- Corbeille ---------------------------------------------------------
"Vider la corbeille": "Empty trash",
"Tous les éléments seront définitivement supprimés. Cette action est irréversible.":
"All items will be permanently deleted. This action cannot be undone.",
@@ -266,7 +244,6 @@ const en: Record<string, string> = {
"Restaurer {name}": "Restore {name}",
"Supprimer définitivement {name}": "Permanently delete {name}",
// --- Compte ------------------------------------------------------------
"Profil, photo, adresse e-mail et sessions ouvertes.":
"Profile, photo, email address and open sessions.",
"Identité": "Identity",
@@ -298,7 +275,6 @@ const en: Record<string, string> = {
"Fermer la session en cours vous déconnectera immédiatement.":
"Closing the current session will sign you out immediately.",
// --- Préférences -------------------------------------------------------
"Préférences": "Preferences",
"Apparence et langue de l'interface.": "Interface appearance and language.",
"Thème": "Theme",
@@ -308,7 +284,6 @@ const en: Record<string, string> = {
"Langue": "Language",
"Préférences enregistrées.": "Preferences saved.",
// --- Administration ----------------------------------------------------
"Créer des membres, ajustez leurs quotas et gérez les accès.":
"Create members, adjust their quotas and manage access.",
"Nouveau membre": "New member",
@@ -382,9 +357,6 @@ export const I18nProvider = ({
language: Language;
children: ReactNode;
}) => {
// La langue est poussee dans le module des que le provider rend : les
// formatages (`formatBytes`, `formatDate`) lisent cette valeur partagee, en
// dehors de React. L'appel est idempotent.
setLanguage(language);
const t = useCallback<Translate>(
-5
View File
@@ -1,10 +1,5 @@
import type { Language } from "./api";
/**
* Langue d'affichage courante, partagee par tout le module (hors composants
* React) : formatage des tailles et des dates. Le provider i18n la met a jour
* des qu'un utilisateur change de langue dans son compte.
*/
let language: Language = "fr";
export const getLanguage = (): Language => language;
-1
View File
@@ -1,6 +1,5 @@
export type MediaKind = "image" | "video" | "audio" | "document" | "archive" | "other";
/** Miroir de `classify()` cote backend, pour choisir la vignette d'un fichier. */
export const mediaKind = (mime: string | null): MediaKind => {
const value = (mime ?? "").toLowerCase();
if (value.startsWith("image/")) return "image";
-6
View File
@@ -10,11 +10,6 @@ const prefersDark = (): boolean =>
const isDark = (theme: Theme): boolean =>
theme === "dark" || (theme === "system" && prefersDark());
/**
* Applique le theme choisi dans le compte sur la racine du document. Le meme
* choix est recopie dans `localStorage` pour que `public/theme.js` reproduise
* le rendu des le premier pixel, avant que React ne demarre.
*/
export const ThemeProvider = ({ theme, children }: { theme: Theme; children: ReactNode }) => {
useEffect(() => {
const apply = () => {
@@ -24,7 +19,6 @@ export const ThemeProvider = ({ theme, children }: { theme: Theme; children: Rea
try {
localStorage.setItem(STORAGE_KEY, theme);
} catch {
/* stockage indisponible : le rendu reste correct */
}
if (theme !== "system") return undefined;