chore: remove agent-oriented comments from the codebase
PR — Ouverture automatique / create-pr (push) Successful in 3s
PR — Ouverture automatique / create-pr (push) Successful in 3s
This commit is contained in:
@@ -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],
|
||||
|
||||
Reference in New Issue
Block a user