chore: remove agent-oriented comments from the codebase
PR — Ouverture automatique / create-pr (push) Successful in 3s

This commit is contained in:
2026-11-04 15:50:36 +01:00
parent 60d6fcaf94
commit e9851c482d
51 changed files with 0 additions and 821 deletions
-68
View File
@@ -11,15 +11,6 @@ import {
} from "../lib/index.js";
import { audit, canManageFolder, canRead, READ_SQL } from "../access.js";
/**
* Chat attache a un dossier. Le salon ne se lit et ne s'ecrit qu'avec l'acces
* au dossier : le role global ne suffit jamais, `admin` compris.
*
* Les membres du salon sont exactement les comptes qui ont acces au dossier
* (proprietaire, permissions nominatives, dossier public). Un administrateur
* n'est donc membre que des salons des dossiers partages avec lui.
*/
const uuid = z
.string()
.regex(
@@ -31,12 +22,10 @@ const sendInput = z.object({
body: z.string().trim().min(1, "Message vide.").max(2000, "Message trop long."),
});
/** Meme borne que l'envoi : un message edite ne peut pas devenir plus long. */
const editInput = z.object({
body: z.string().trim().min(1, "Message vide.").max(2000, "Message trop long."),
});
/** Horodatage renvoye tel quel par le serveur : `AAAA-MM-JJTHH:MM:SS.ffffff`. */
const DATETIME_CURSOR = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,6})?$/;
interface MessageRow {
@@ -51,7 +40,6 @@ interface MessageRow {
avatar_updated_at: Date | null;
}
/** Auteur joint a la ligne : meme jointure que la lecture, pour la reponse du POST. */
const SELECT_MESSAGE = `
SELECT m.id, m.user_id, m.body, m.created_at, m.edited_at, m.is_pinned,
u.first_name, u.last_name, ua.updated_at AS avatar_updated_at
@@ -73,14 +61,8 @@ const publicMessage = (row: MessageRow) => ({
});
export const registerChatRoutes = (app: App, db: Db, config: Config): void => {
// Ecriture bornee par compte : le salon reste utilisable meme si un client
// s'emballe. La lecture (interrogation periodique) n'est pas limitee ici.
const limiter = createRateLimiter(20, 10_000);
/**
* Le dossier doit exister et etre accessible : `canRead` rejette une session
* sans acces comme un dossier inexistant (404, pour ne rien confirmer).
*/
const assertFolder = async (
folderId: string,
): Promise<{ id: string; owner_id: string | null; access_type: string }> => {
@@ -93,7 +75,6 @@ export const registerChatRoutes = (app: App, db: Db, config: Config): void => {
return folder;
};
/** Reprise du curseur de lecture du salon pour la session courante. */
const markRead = async (folderId: string, userId: string, messageId: number): Promise<void> => {
if (messageId <= 0) return;
await db
@@ -108,11 +89,6 @@ export const registerChatRoutes = (app: App, db: Db, config: Config): void => {
.catch(() => undefined);
};
/**
* Pastilles de messages non lus : tous les salons accessibles a la session
* qui contiennent au moins un message qu'elle n'a pas encore lu. Les
* messages de la session ignores : il n'a rien de neuf a lire.
*/
app.get("/api/cloud/chat/unread", requireAuth, async (context) => {
const user = currentUser(context);
const rows = await db.query<{ folder_id: string; unread: number }>(
@@ -144,9 +120,6 @@ export const registerChatRoutes = (app: App, db: Db, config: Config): void => {
const folder = await assertFolder(folderId);
if (!(await canRead(db, user, folderId))) throw AppError.notFound("Dossier introuvable.");
// Les membres sont ceux qui ont acces au dossier : proprietaire,
// permission nominative non expiree, et tous les comptes actifs si le
// dossier est public. Le role global ne compte pas.
const rows = await db.query<{
id: string;
first_name: string;
@@ -194,20 +167,6 @@ export const registerChatRoutes = (app: App, db: Db, config: Config): void => {
const limit = Math.min(200, Math.max(1, Number(context.req.query("limit")) || 50));
const after = Math.max(0, Number(context.req.query("after")) || 0);
/**
* Curseur d'edition. Le curseur `after` ne voit que les messages plus
* recents : une reecriture d'un ancien message y resterait invisible.
*
* Le curseur est un horodatage de la base, dans le meme cadran que la
* colonne `edited_at` : le client le renvoie tel quel, sans conversion.
* Comparer une chaine ISO (UTC) a un DATETIME stocke en heure locale
* decalerait la fenetre de la difference de fuseau.
*
* Il est calcule AVANT la requete : une edition survenue entre les deux
* porte un horodatage posterieur au curseur, elle sera donc vue au tour
* suivant plutot que perdue.
*/
// `cursor` est un mot reserve en MariaDB : l'alias est renomme.
const cursorRow = await db.one<{ chat_cursor: string }>(
"SELECT DATE_FORMAT(CURRENT_TIMESTAMP(3), '%Y-%m-%dT%H:%i:%s.%f') AS chat_cursor",
);
@@ -218,9 +177,6 @@ export const registerChatRoutes = (app: App, db: Db, config: Config): void => {
? editedAfterRaw
: serverCursor;
// `after` sert a la synchronisation incrementale (polling) : on ne remonte
// que les messages posterieurs au dernier connu, dans l'ordre du temps.
// Sans `after` : les `limit` derniers, remis dans l'ordre croissant.
const rows =
after > 0
? await db.query<MessageRow>(
@@ -252,8 +208,6 @@ export const registerChatRoutes = (app: App, db: Db, config: Config): void => {
const user = currentUser(context);
const folderId = context.req.param("folderId") ?? "";
await assertFolder(folderId);
// Etre membre du salon suffit a ecrire : un acces `read` participe a la
// discussion, exactement comme le proprietaire.
if (!(await canRead(db, user, folderId))) throw AppError.notFound("Dossier introuvable.");
if (!limiter.allow(user.id)) {
@@ -272,12 +226,6 @@ export const registerChatRoutes = (app: App, db: Db, config: Config): void => {
return context.json({ message: publicMessage(row) }, 201);
});
/**
* Edition d'un message. Seul l'auteur peut modifier ce qu'il a ecrit : le
* filtre `user_id = ?` est porte par la requete SQL, donc un message d'autrui
* est indistinguishable d'un message inexistant. Le gestionnaire du dossier
* peut supprimer un message, mais pas le reecrire a la place de son auteur.
*/
app.patch(
"/api/cloud/folders/:folderId/chat/messages/:id",
requireAuth,
@@ -321,11 +269,6 @@ export const registerChatRoutes = (app: App, db: Db, config: Config): void => {
},
);
/**
* Epinglage d'un message. Bascule atomique en base : le salon compte
* plusieurs participants, deux clics croises ne doivent pas laisser le
* message dans un etat incoherent. Tout membre du salon peut epingler.
*/
app.put(
"/api/cloud/folders/:folderId/chat/messages/:id/pin",
requireAuth,
@@ -366,12 +309,6 @@ export const registerChatRoutes = (app: App, db: Db, config: Config): void => {
},
);
/**
* Messages epingles du salon. Relu a chaque tour de synchronisation : le
* curseur `after` ne remonte que les messages plus recents, donc un
* epinglage pose sur un ancien message resterait invisible sans cette lecture
* dediee.
*/
app.get("/api/cloud/folders/:folderId/chat/pins", requireAuth, async (context) => {
const user = currentUser(context);
const folderId = context.req.param("folderId") ?? "";
@@ -403,15 +340,10 @@ export const registerChatRoutes = (app: App, db: Db, config: Config): void => {
"SELECT user_id FROM chat_messages WHERE id = ? AND folder_id = ? AND deleted_at IS NULL",
[id, folderId],
);
// Auteur ou gestionnaire du dossier (proprietaire) : meme reponse qu'un
// message inexistant pour ne rien laisser deviner.
if (!row || (row.user_id !== user.id && !(await canManageFolder(db, user, folderId)))) {
throw AppError.notFound("Message introuvable.");
}
// Un message retire quitte aussi les epingles : le laisser marque ferait
// apparaitre un epingle fantome dans le bandeau. `deleted_at` suit la
// meme horloge que `created_at`.
await db.exec(
"UPDATE chat_messages SET deleted_at = CURRENT_TIMESTAMP(3), is_pinned = 0 WHERE id = ?",
[id],