consolidation V1 : docs resync, PDF streaming multi-pages, recherche sans accents, parser https

This commit is contained in:
venture
2026-09-25 18:13:30 +02:00
parent c642763035
commit a50eb830f4
13 changed files with 215 additions and 114 deletions
@@ -1,5 +1,8 @@
package com.kazier.mobile.data.local
import java.text.Normalizer
import java.util.Locale
/**
* Échappe les jokers `LIKE` (`%`, `_`) et l'échappement lui-même (`\`) dans
* un fragment destiné à une requête `... LIKE ... ESCAPE '\'` (m5, m7).
@@ -8,3 +11,17 @@ package com.kazier.mobile.data.local
*/
internal fun String.escapeLike(): String =
replace("\\", "\\\\").replace("%", "\\%").replace("_", "\\_")
/**
* Normalise une saisie de recherche pour le matching insensible aux accents
* (suivi m7) : minuscules (ROOT, pas de surprise turque), décomposition NFD,
* suppression des diacritiques, ligatures `œ`/`æ` explicites (non décomposées
* par NFD). À appliquer AVANT [escapeLike] ; le SQL compare contre
* `name` normalisé de la même façon (chaîne de `REPLACE`, voir `FileDao`).
*/
internal fun String.normalizeSearch(): String =
lowercase(Locale.ROOT)
.let { Normalizer.normalize(it, Normalizer.Form.NFD) }
.replace(Regex("\\p{Mn}+"), "")
.replace("œ", "oe")
.replace("æ", "ae")
@@ -46,20 +46,28 @@ interface FileDao {
suspend fun getByUri(uri: String): FileEntity?
/**
* Recherche par nom (m7) : `:query` arrive déjà échappé (`escapeLike`,
* `%`/`_` littéraux, pas des jokers) avec `ESCAPE '\'`. `COLLATE NOCASE`
* sur l'opérande gauche pour une casse ASCII insensible explicite
* (le repli Unicode « ete » → « ÉTÉ » demanderait une colonne normalisée,
* hors scope — voir FEEDBACK).
* Recherche par nom (m7 + suivi accents) : `:query` arrive déjà échappé
* (`escapeLike`, `%`/`_` littéraux, pas des jokers) avec `ESCAPE '\'`.
* `COLLATE NOCASE` couvre la casse ASCII ; la deuxième branche compare
* `lower(name)` débarrassé de ses accents (chaîne de `REPLACE` FR — pas de
* colonne normalisée ni de migration) contre `:normQuery` (saisie passée
* par `normalizeSearch` + `escapeLike`). « ete » trouve « ÉTÉ ».
*/
@Query("""
SELECT * FROM files
WHERE "exists" = 1
AND (:query IS NULL OR name COLLATE NOCASE LIKE '%' || :query || '%' ESCAPE '\')
AND (:query IS NULL OR name COLLATE NOCASE LIKE '%' || :query || '%' ESCAPE '\'
OR REPLACE(REPLACE(REPLACE(REPLACE(REPLACE(REPLACE(REPLACE(REPLACE(REPLACE(REPLACE(
REPLACE(REPLACE(REPLACE(REPLACE(REPLACE(REPLACE(REPLACE(REPLACE(
lower(name),
'œ','oe'),'æ','ae'),'ç','c'),'à','a'),'â','a'),'ä','a'),
'é','e'),'è','e'),'ê','e'),'ë','e'),'î','i'),'ï','i'),
'ô','o'),'ö','o'),'ù','u'),'û','u'),'ü','u'),'ÿ','y')
LIKE '%' || :normQuery || '%' ESCAPE '\')
AND (:category IS NULL OR category = :category)
ORDER BY name ASC
""")
fun searchWithFilters(query: String?, category: String?): Flow<List<FileEntity>>
fun searchWithFilters(query: String?, normQuery: String?, category: String?): Flow<List<FileEntity>>
@Query("""
SELECT * FROM files
@@ -3,6 +3,7 @@ package com.kazier.mobile.data.repository
import androidx.room.withTransaction
import com.kazier.mobile.data.local.AppDatabase
import com.kazier.mobile.data.local.escapeLike
import com.kazier.mobile.data.local.normalizeSearch
import com.kazier.mobile.data.local.dao.FileDao
import com.kazier.mobile.data.local.dao.FolderDao
import com.kazier.mobile.data.local.entity.FileEntity
@@ -49,13 +50,18 @@ class FileRepository @Inject constructor(
/**
* Recherche/filtrage par nom et catégorie (utilisé par SearchViewModel).
* m7 : la saisie est échappée (`%`/`_` littéraux, pas des jokers).
* m7 : la saisie est échappée (`%`/`_` littéraux, pas des jokers) ;
* suivi accents : la saisie normalisée (`normalizeSearch`) matche
* « ÉTÉ » depuis « ete » (branche SQL dédiée, sans migration).
*/
fun searchFiles(query: String?, category: String?): Flow<List<FileEntity>> =
fileDao.searchWithFilters(
query = query?.trim()?.takeIf { it.isNotEmpty() }?.escapeLike(),
fun searchFiles(query: String?, category: String?): Flow<List<FileEntity>> {
val trimmed = query?.trim()?.takeIf { it.isNotEmpty() }
return fileDao.searchWithFilters(
query = trimmed?.escapeLike(),
normQuery = trimmed?.normalizeSearch()?.escapeLike(),
category = category,
)
}
/** Les `limit` fichiers les plus récents (date de référence), filtrés par catégorie. */
fun recentFiles(category: String?, limit: Int = RECENT_LIMIT): Flow<List<FileEntity>> =
@@ -367,6 +367,9 @@ fun DocumentViewerScreen(
* - IMAGE → document plein écran sur fond noir
* - TEXT → lecture immersive (fond sombre, texte clair, sélectionnable)
*
* Fichier cloud-only (`uri == null`) : le viewer streaming plein écran
* (même contenu que la page, en plus grand) — jamais persisté.
*
* Le retour (tap ou bouton système) est géré par le cadre commun [FocusScaffold].
*/
@Composable
@@ -376,6 +379,20 @@ private fun FocusDocumentReader(
onExitFullscreen: () -> Unit,
modifier: Modifier = Modifier,
) {
if (file.uri == null) {
FocusScaffold(
file = file,
onExitFullscreen = onExitFullscreen,
modifier = modifier,
) {
DocumentContentViewer(
file = file,
onOpenExternalFailed = onOpenExternalFailed,
modifier = Modifier.fillMaxSize(),
)
}
return
}
when (file.categoryValue()) {
FileCategory.PDF -> PdfFullscreenReader(
file = file,
@@ -942,9 +959,9 @@ internal fun resolveViewerPage(currentPage: Int, restoredPage: Int, itemCount: I
internal fun shouldExitViewer(jumpPending: Boolean, hadDocuments: Boolean, isEmpty: Boolean): Boolean =
!jumpPending && hadDocuments && isEmpty
/** Vrai si le fichier est local et appartient à une catégorie consultable en mode focus. */
/** Vrai si le fichier appartient à une catégorie consultable en mode focus. */
private fun FileEntity.canFocus(): Boolean =
uri != null && categoryValue() in FOCUS_CATEGORIES
categoryValue() in FOCUS_CATEGORIES
/**
* Vrai si le fichier est prêt pour l'OCR serveur : copie physique locale ET
@@ -55,6 +55,10 @@ import kotlinx.coroutines.withContext
* largeur cible borne les bitmaps et un cache LRU limite la mémoire. Le
* `PdfRenderer` n'est pas thread-safe : toutes les lectures passent par un
* `Mutex` et un dispatcher IO.
*
* `openFd` (optionnel) remplace la lecture SAF : streaming distant (lot 1) —
* les octets sont écrits dans un fichier temporaire du `cacheDir` par
* l'appelant ([RemoteDocumentViewer]), supprimé à la sortie.
*/
@Composable
fun PdfPageViewer(
@@ -62,16 +66,17 @@ fun PdfPageViewer(
contentResolver: ContentResolver,
onOpenExternalFailed: () -> Unit,
modifier: Modifier = Modifier,
openFd: (() -> ParcelFileDescriptor?)? = null,
) {
val uri = file.uri
if (uri == null) {
if (uri == null && openFd == null) {
CloudOnlyPlaceholder(file, modifier)
return
}
val document = remember(uri) { PdfDocumentState(contentResolver, uri) }
var pageCount by remember(uri) { mutableIntStateOf(0) }
var loadFailed by remember(uri) { mutableStateOf(false) }
val document = remember(file.resourceId, uri) { PdfDocumentState(contentResolver, uri, openFd) }
var pageCount by remember(file.resourceId) { mutableIntStateOf(0) }
var loadFailed by remember(file.resourceId) { mutableStateOf(false) }
// Le state vit en mémoire (cache + dossier ouvert) tant que ce lecteur est
// affiché ; il est fermé à la sortie ou au changement de document.
@@ -79,7 +84,7 @@ fun PdfPageViewer(
onDispose { document.close() }
}
LaunchedEffect(uri) {
LaunchedEffect(document) {
pageCount = 0
loadFailed = false
if (document.load()) {
@@ -136,22 +141,23 @@ fun PdfFocusViewer(
modifier: Modifier = Modifier,
onPageCountChanged: ((Int) -> Unit)? = null,
renderScale: Float = 1f,
openFd: (() -> ParcelFileDescriptor?)? = null,
) {
val uri = file.uri
if (uri == null) {
if (uri == null && openFd == null) {
CloudOnlyPlaceholder(file, modifier)
return
}
val document = remember(uri) { PdfDocumentState(contentResolver, uri) }
var pageCount by remember(uri) { mutableIntStateOf(0) }
var loadFailed by remember(uri) { mutableStateOf(false) }
val document = remember(file.resourceId, uri) { PdfDocumentState(contentResolver, uri, openFd) }
var pageCount by remember(file.resourceId) { mutableIntStateOf(0) }
var loadFailed by remember(file.resourceId) { mutableStateOf(false) }
DisposableEffect(document) {
onDispose { document.close() }
}
LaunchedEffect(uri) {
LaunchedEffect(document) {
pageCount = 0
loadFailed = false
if (document.load()) {
@@ -303,10 +309,15 @@ private fun PdfPageItem(
/**
* État d'un document PDF : ouvre le `PdfRenderer` à la demande, rend chaque
* page via le cache LRU et verrouille l'accès au renderer (non thread-safe).
*
* Source des octets : SAF (`contentResolver` + `uri`) par défaut, ou
* `openFd` (streaming distant — l'appelant écrit les octets dans un fichier
* temporaire et fournit un descripteur frais à chaque appel).
*/
private class PdfDocumentState(
private val contentResolver: ContentResolver,
private val uri: String,
private val uri: String?,
private val openFd: (() -> ParcelFileDescriptor?)? = null,
) {
@Volatile
private var renderer: PdfRenderer? = null
@@ -329,7 +340,8 @@ private class PdfDocumentState(
if (closed) return@withLock false
if (renderer != null) return@withLock true
val opened = runCatching {
val pfd: ParcelFileDescriptor? = DocumentContent.openFileDescriptor(contentResolver, uri)
val pfd: ParcelFileDescriptor? = openFd?.invoke()
?: uri?.let { DocumentContent.openFileDescriptor(contentResolver, it) }
if (pfd != null) PdfRenderer(pfd) else null
}.getOrNull()
if (opened != null) renderer = opened
@@ -1,7 +1,6 @@
package com.kazier.mobile.ui.document.content
import android.graphics.BitmapFactory
import android.graphics.pdf.PdfRenderer
import android.os.ParcelFileDescriptor
import androidx.compose.foundation.Image
import androidx.compose.foundation.layout.Arrangement
@@ -197,7 +196,12 @@ private fun RemoteContentBody(
when (file.categoryValue()) {
FileCategory.IMAGE -> RemoteImageViewer(bytes = bytes, description = file.name, modifier = modifier)
FileCategory.TEXT -> RemoteTextViewer(bytes = bytes, modifier = modifier)
FileCategory.PDF -> RemotePdfViewer(file = file, bytes = bytes, modifier = modifier)
FileCategory.PDF -> RemotePdfViewer(
file = file,
bytes = bytes,
onOpenExternalFailed = onOpenExternalFailed,
modifier = modifier,
)
else -> Column(
modifier = modifier.padding(24.dp),
horizontalAlignment = Alignment.CenterHorizontally,
@@ -266,19 +270,25 @@ private fun RemoteTextViewer(bytes: ByteArray, modifier: Modifier = Modifier) {
}
/**
* PDF distant : le `PdfRenderer` système exige un descripteur de fichier —
* les octets sont écrits dans un fichier temporaire du `cacheDir`
* (`stream-<resourceId>.pdf`), supprimé à la sortie. Première page affichée
* (aperçu streaming, pas de navigation complète).
* PDF distant : les octets sont écrits dans un fichier temporaire du
* `cacheDir` (`stream-<resourceId>.pdf`), lu via le pager multi-pages
* partagé ([PdfPageViewer]), puis supprimé à la sortie. La fermeture du
* renderer (enfant) précède la suppression du fichier (parent).
*/
@Composable
private fun RemotePdfViewer(file: FileEntity, bytes: ByteArray, modifier: Modifier = Modifier) {
private fun RemotePdfViewer(
file: FileEntity,
bytes: ByteArray,
onOpenExternalFailed: () -> Unit,
modifier: Modifier = Modifier,
) {
val context = LocalContext.current
val contentResolver = context.contentResolver
var tmpFile by remember(file.resourceId) { mutableStateOf<File?>(null) }
var loadFailed by remember(file.resourceId) { mutableStateOf(false) }
var writeFailed by remember(file.resourceId) { mutableStateOf(false) }
LaunchedEffect(file.resourceId, bytes) {
loadFailed = false
writeFailed = false
tmpFile = withContext(Dispatchers.IO) {
runCatching {
val tmp = File(context.cacheDir, "stream-${file.resourceId}.pdf")
@@ -286,7 +296,7 @@ private fun RemotePdfViewer(file: FileEntity, bytes: ByteArray, modifier: Modifi
tmp
}.getOrNull()
}
if (tmpFile == null) loadFailed = true
if (tmpFile == null) writeFailed = true
}
DisposableEffect(file.resourceId) {
onDispose {
@@ -302,7 +312,7 @@ private fun RemotePdfViewer(file: FileEntity, bytes: ByteArray, modifier: Modifi
val tmp = tmpFile
when {
loadFailed || (tmp != null && !tmp.exists()) -> Text(
writeFailed -> Text(
text = stringResource(R.string.document_cannot_read),
style = MaterialTheme.typography.bodyMedium,
modifier = modifier,
@@ -310,56 +320,17 @@ private fun RemotePdfViewer(file: FileEntity, bytes: ByteArray, modifier: Modifi
tmp == null -> Box(modifier.fillMaxSize(), contentAlignment = Alignment.Center) {
CircularProgressIndicator()
}
else -> RemotePdfFirstPage(tmp = tmp, modifier = modifier)
}
}
@Composable
private fun RemotePdfFirstPage(tmp: File, modifier: Modifier = Modifier) {
var bitmap by remember(tmp.absolutePath) { mutableStateOf<android.graphics.Bitmap?>(null) }
var failed by remember(tmp.absolutePath) { mutableStateOf(false) }
LaunchedEffect(tmp.absolutePath) {
failed = false
bitmap = withContext(Dispatchers.IO) {
runCatching {
val pfd = ParcelFileDescriptor.open(tmp, ParcelFileDescriptor.MODE_READ_ONLY)
val renderer = PdfRenderer(pfd)
try {
if (renderer.pageCount <= 0) return@runCatching null
val page = renderer.openPage(0)
try {
val width = (page.width * 2f).toInt().coerceIn(1, 4096)
val height = (page.height * 2f).toInt().coerceIn(1, 4096)
val bmp = android.graphics.Bitmap.createBitmap(
width, height, android.graphics.Bitmap.Config.ARGB_8888,
)
page.render(bmp, null, null, PdfRenderer.Page.RENDER_MODE_FOR_DISPLAY)
bmp
} finally {
page.close()
}
} finally {
renderer.close()
pfd.close()
}
}.getOrNull()
}
if (bitmap == null) failed = true
}
Box(modifier.fillMaxSize(), contentAlignment = Alignment.Center) {
when {
bitmap != null -> Image(
bitmap = bitmap!!.asImageBitmap(),
contentDescription = null,
modifier = Modifier.fillMaxSize(),
contentScale = ContentScale.Fit,
)
failed -> Text(
text = stringResource(R.string.document_cannot_read),
style = MaterialTheme.typography.bodyMedium,
)
else -> CircularProgressIndicator()
}
else -> PdfPageViewer(
file = file,
contentResolver = contentResolver,
onOpenExternalFailed = onOpenExternalFailed,
modifier = modifier,
openFd = {
runCatching {
ParcelFileDescriptor.open(tmp, ParcelFileDescriptor.MODE_READ_ONLY)
}.getOrNull()
},
)
}
}
@@ -3,14 +3,19 @@ package com.kazier.mobile.ui.share
/**
* Extraction d'un token de lien de partage depuis une saisie utilisateur.
*
* Formats acceptés : 32-hex brut, URL deep-link `kazier://share/<token>`,
* ou URL API `…/shares/links/<token>`. Retourne le token normalisé
* (lowercase) ou null si rien d'exploitable.
* Formats acceptés : 32-hex brut, deep-link `kazier://share/<token>`,
* URL API `…/shares/links/<token>`, ou page courte `…/s/<token>`.
* Retourne le token normalisé (lowercase) ou null si rien d'exploitable.
*
* Le format partagé est TOUJOURS le deep-link `kazier://share/<token>`
* (voir [shareUrl]) : indépendant du domaine du serveur, donc compatible
* self-hosting (pas d'App Links https vérifiés, qui exigeraient un domaine
* unique). Les formes https ne servent qu'à tolérer un lien collé.
*/
object ShareLinkParser {
private val HEX32 = Regex("^[0-9a-f]{32}$")
private val HEX32_LOOSE = Regex("^[0-9a-fA-F]{32}$")
private val IN_URL = Regex("(?:shares/links|/share)[:/]([0-9a-fA-F]{32})(?![0-9a-fA-F])")
private val IN_URL = Regex("(?:shares/links|/share|/s)[:/]([0-9a-fA-F]{32})(?![0-9a-fA-F])")
fun extractToken(input: String): String? {
val trimmed = input.trim()
@@ -18,7 +18,9 @@ import org.robolectric.annotation.Config
/**
* m7 : la recherche `LIKE` échappe `%`/`_` (littéraux, pas des jokers) —
* « 100% » ne matchait pas tout avant le fix. La casse ASCII reste
* insensible (`COLLATE NOCASE`).
* insensible (`COLLATE NOCASE`), et le suivi accents rend la recherche
* insensible aux diacritiques (« ete » → « ÉTÉ », branche SQL `REPLACE`,
* sans migration).
*/
@RunWith(RobolectricTestRunner::class)
@Config(sdk = [34])
@@ -50,7 +52,7 @@ class SearchEscapeTest {
// Le repository échappe avant d'appeler le DAO — on rejoue ici le
// contrat (`escapeLike`) pour verrouiller le comportement SQL.
val escaped = "100%".escapeLikeForTest()
val rows = fileDao.searchWithFilters(escaped, null).first()
val rows = fileDao.searchWithFilters(escaped, escaped.normalizeForTest(), null).first()
assertEquals(listOf("100%.txt"), rows.map { it.name })
}
@@ -61,7 +63,7 @@ class SearchEscapeTest {
fileDao.upsert(file("b".repeat(32), "a_b.txt"))
fileDao.upsert(file("c".repeat(32), "axb.txt"))
val rows = fileDao.searchWithFilters("a\\_b", null).first()
val rows = fileDao.searchWithFilters("a\\_b", "a\\_b", null).first()
assertEquals(listOf("a_b.txt"), rows.map { it.name })
}
@@ -70,11 +72,53 @@ class SearchEscapeTest {
fun recherche_insensible_a_la_casse_ascii() = runTest {
fileDao.upsert(file("a".repeat(32), "Rapport.TXT"))
val rows = fileDao.searchWithFilters("rapport", null).first()
val rows = fileDao.searchWithFilters("rapport", "rapport", null).first()
assertEquals(listOf("Rapport.TXT"), rows.map { it.name })
}
@Test
fun recherche_insensible_aux_accents() = runTest {
fileDao.upsert(file("a".repeat(32), "Été à la plage.txt"))
fileDao.upsert(file("b".repeat(32), "ÉCOLE.pdf"))
fileDao.upsert(file("c".repeat(32), "chœur final.mp3"))
fileDao.upsert(file("d".repeat(32), "façade naïve.doc"))
fileDao.upsert(file("e".repeat(32), "rien à voir.txt"))
assertEquals(
listOf("Été à la plage.txt"),
fileDao.searchWithFilters("ete", "ete", null).first().map { it.name },
)
assertEquals(
listOf("ÉCOLE.pdf"),
fileDao.searchWithFilters("ecole", "ecole", null).first().map { it.name },
)
assertEquals(
listOf("chœur final.mp3"),
fileDao.searchWithFilters("choeur", "choeur", null).first().map { it.name },
)
assertEquals(
listOf("façade naïve.doc"),
fileDao.searchWithFilters("facade naive", "facade naive", null).first().map { it.name },
)
// La saisie accentuée trouve aussi (normalisée des deux côtés).
assertEquals(
listOf("Été à la plage.txt"),
fileDao.searchWithFilters("été", "ete", null).first().map { it.name },
)
}
@Test
fun normalize_miroir_kotlin() {
// Miroir de `normalizeSearch` (interne au main) — verrouille le
// contrat repository → DAO.
assertEquals("ete", "Été".normalizeForTest())
assertEquals("choeur", "chœur".normalizeForTest())
assertEquals("facade", "façade".normalizeForTest())
assertEquals("aether", "Æther".normalizeForTest())
assertEquals("noel", "Noël".normalizeForTest())
}
private fun file(resourceId: String, name: String) = FileEntity(
resourceId = resourceId,
name = name,
@@ -89,6 +133,14 @@ class SearchEscapeTest {
private fun String.escapeLikeForTest(): String =
replace("\\", "\\\\").replace("%", "\\%").replace("_", "\\_")
/** Miroir de `normalizeSearch` (interne au main) : minuscules + sans accents. */
private fun String.normalizeForTest(): String =
lowercase(java.util.Locale.ROOT)
.let { java.text.Normalizer.normalize(it, java.text.Normalizer.Form.NFD) }
.replace(Regex("\\p{Mn}+"), "")
.replace("œ", "oe")
.replace("æ", "ae")
private companion object {
const val NOW = 1_700_000_000_000L
}
@@ -36,6 +36,14 @@ class ShareLinkParserTest {
)
}
@Test
fun `extractToken_extrait_de_la_page_courte`() {
assertEquals(
token,
ShareLinkParser.extractToken("https://mon-serveur.fr/s/$token"),
)
}
@Test
fun `extractToken_rejette_l_illisible`() {
assertNull(ShareLinkParser.extractToken(""))