Files
parenthese/backend/src/lib/tree-purge.ts
T
IliesAllaliandClaude Opus 5 0c4cc20c97 Suppression des données par les utilisateurs, CI et auto-hébergement vérifié
Utilisateurs
- Suppression de compte depuis l'écran « Votre compte », confirmée par mot de passe :
  arbres possédés et médias effacés, email retiré des contributions, sessions fermées partout.
- Suppression d'arbre définitive, en base et sur le disque.
- Ajout d'un frère ou d'une sœur relié aux parents existants ; relations parent et enfant
  corrigées en mode démo.
- Liste d'attente retirée (route, envoi d'emails, dépendance Resend).

Projet ouvert
- CI : front, landing, backend avec vérification des migrations, test Docker de bout en bout.
- Déploiement lancé seulement après une CI réussie sur main.
- Image API : CLI Prisma installée à part pour que les migrations tournent au démarrage.
- SECURITY.md, CONTRIBUTING.md, modèles d'issue et de pull request.
- Migration renommée avec un nom descriptif, contenu identique.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-14 16:22:26 +02:00

100 lines
2.8 KiB
TypeScript

import { rm } from 'node:fs/promises'
import path from 'node:path'
import type { Prisma, PrismaClient } from '@prisma/client'
import { env } from '../config/env.js'
export type PurgeLogger = {
warn: (details: Record<string, unknown>, message: string) => void
error: (details: Record<string, unknown>, message: string) => void
}
export function getMediaStorageRoot(): string {
return path.resolve(env.MEDIA_STORAGE_PATH)
}
/**
* Dossier des médias d'un arbre : `<racine>/<treeId>`.
* Renvoie null si l'identifiant désigne autre chose qu'un dossier situé directement sous la racine.
*/
export function resolveTreeMediaDirectory(treeId: string, storageRoot = getMediaStorageRoot()): string | null {
if (!treeId || treeId.includes('/') || treeId.includes('\\')) {
return null
}
const root = path.resolve(storageRoot)
const directory = path.resolve(root, treeId)
if (directory === root || path.dirname(directory) !== root) {
return null
}
return directory
}
/**
* Supprime définitivement des arbres, dans la transaction fournie.
* Personnes, liens, médias, annotations, contributions et journal d'audit partent en cascade.
*/
export async function deleteTreeRecords(tx: Prisma.TransactionClient, treeIds: string[]): Promise<number> {
if (treeIds.length === 0) {
return 0
}
await tx.user.updateMany({
where: {
lastOpenedTreeId: { in: treeIds },
},
data: {
lastOpenedTreeId: null,
lastOpenedAccessMode: null,
lastOpenedRole: null,
lastOpenedAt: null,
},
})
const deleted = await tx.tree.deleteMany({
where: {
id: { in: treeIds },
},
})
return deleted.count
}
/**
* Supprime les dossiers médias des arbres. À appeler une fois la transaction validée :
* un échec est journalisé sans être propagé, la base restant la source de vérité.
*/
export async function removeTreeMediaDirectories(
treeIds: string[],
logger: PurgeLogger,
storageRoot = getMediaStorageRoot(),
): Promise<void> {
for (const treeId of treeIds) {
const directory = resolveTreeMediaDirectory(treeId, storageRoot)
if (!directory) {
logger.warn({ treeId }, 'Refused media directory path for tree purge')
continue
}
try {
await rm(directory, { recursive: true, force: true })
} catch (error) {
logger.error({ err: error, treeId }, 'Failed to remove tree media directory')
}
}
}
/** Suppression définitive d'arbres : base dans une transaction, puis fichiers. */
export async function purgeTrees(prisma: PrismaClient, treeIds: string[], logger: PurgeLogger): Promise<number> {
const uniqueIds = [...new Set(treeIds)]
if (uniqueIds.length === 0) {
return 0
}
const count = await prisma.$transaction((tx) => deleteTreeRecords(tx, uniqueIds))
await removeTreeMediaDirectories(uniqueIds, logger)
return count
}