@indos/bibliotheque 1.12.0 → 1.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -15,7 +15,7 @@ export { desepingler, epingler, lireLAnnuaire, useEpingle, type AnnuaireDeLEcran
15
15
  export { useAnnoncer } from './ouvrir.ts';
16
16
  export { useAnnoncerLeDroitQuiBaisse, useMontrerLaChoseIntrouvable } from './direct.ts';
17
17
  export { rechargerLaPage } from './navigation.ts';
18
- export { chercherParLOutil, cleDesChoses, motsDeLaPublication, rechercheDeLaListe, useRelireLesChoses, vuesDuPartage, type AncetreDUneChose, type ChoseTrouvee, type ChosesTrouvees, type CiblesDuPartage, type ColonneDUneChose, type CritereDeRecherche, type DeclarationDesChoses, type DroitSurUneChose, type FenetreDuMenu, type FormulaireDUneFicheDeclare, type GesteDuMenu, type MotsDeLaPublication, type MotsDUnGeste, type OuvertureDUneChose, type RechercheDeLaListe, type VueDeLaListe, } from './choses.ts';
18
+ export { chercherParLOutil, cleDesChoses, cleDUneChose, motsDeLaPublication, rechercheDeLaListe, useRelireLesChoses, vuesDuPartage, type AncetreDUneChose, type ChoseTrouvee, type ChosesTrouvees, type CiblesDuPartage, type ColonneDUneChose, type CritereDeRecherche, type DeclarationDesChoses, type DroitSurUneChose, type FenetreDuMenu, type FormulaireDUneFicheDeclare, type GesteDuMenu, type MotsDeLaPublication, type MotsDUnGeste, type OuvertureDUneChose, type RechercheDeLaListe, type VueDeLaListe, } from './choses.ts';
19
19
  export { ListeDesChoses } from './liste-des-choses.tsx';
20
20
  export { DansLEtatDuDirect, EcranDUneChose } from './ecran-d-une-chose.tsx';
21
21
  export { texteDUneChoseAbsente } from '../ui/etats.tsx';
@@ -17,7 +17,7 @@ export { desepingler, epingler, lireLAnnuaire, useEpingle } from './barre.js';
17
17
  export { useAnnoncer } from './ouvrir.js';
18
18
  export { useAnnoncerLeDroitQuiBaisse, useMontrerLaChoseIntrouvable } from './direct.js';
19
19
  export { rechargerLaPage } from './navigation.js';
20
- export { chercherParLOutil, cleDesChoses, motsDeLaPublication, rechercheDeLaListe, useRelireLesChoses, vuesDuPartage, } from './choses.js';
20
+ export { chercherParLOutil, cleDesChoses, cleDUneChose, motsDeLaPublication, rechercheDeLaListe, useRelireLesChoses, vuesDuPartage, } from './choses.js';
21
21
  export { ListeDesChoses } from './liste-des-choses.js';
22
22
  export { DansLEtatDuDirect, EcranDUneChose } from './ecran-d-une-chose.js';
23
23
  export { texteDUneChoseAbsente } from '../ui/etats.js';
@@ -6,7 +6,7 @@ import { Confirmation } from '../ui/confirmation.js';
6
6
  import { Fenetre } from '../ui/fenetre.js';
7
7
  import { MenuDUneLigne } from '../ui/menu-d-une-ligne.js';
8
8
  import { lireLAnnuaire, useEpingle } from './barre.js';
9
- import { cleDesChoses, estRangee, motsDe } from './choses.js';
9
+ import { cleDesChoses, cleDUneChose, estRangee, motsDe } from './choses.js';
10
10
  import { depuisLaListe, useAnnoncer, useOuvrir } from './ouvrir.js';
11
11
  import { PanneauDuPartage } from './panneau-du-partage.js';
12
12
  import { useSession } from './session.js';
@@ -32,7 +32,7 @@ export function MenuDUneChose({ choses, chose, surLEcran = false, surSupprimee }
32
32
  mutationFn: () => choses.supprimer(chose),
33
33
  onSuccess: () => {
34
34
  annoncer(motsDeLaSuppression.fait ?? `${LaChose} « ${chose.nom} » est supprimé${mots.e}.`);
35
- client.removeQueries({ queryKey: cleDesChoses(choses.app, 'chose', chose.id) });
35
+ client.removeQueries({ queryKey: cleDUneChose(choses, 'chose', chose.id) });
36
36
  surSupprimee?.();
37
37
  void relire();
38
38
  },
@@ -103,7 +103,7 @@ function FenetreDuDon({ choses, chose, ouverte, onOuverteChange, retour, surFerm
103
103
  annoncer(`« ${chose.nom} » est à ${options.find((option) => option.valeur === a)?.libelle ?? a}.`);
104
104
  const encore = await choses.lire(chose.id).catch(() => undefined);
105
105
  if (!encore) {
106
- client.removeQueries({ queryKey: cleDesChoses(choses.app, 'chose', chose.id) });
106
+ client.removeQueries({ queryKey: cleDUneChose(choses, 'chose', chose.id) });
107
107
  surFermee?.();
108
108
  }
109
109
  await client.invalidateQueries({ queryKey: cleDesChoses(choses.app) });
@@ -7,7 +7,7 @@ import { Choix } from '../ui/choix.js';
7
7
  import { cn } from '../ui/classes.js';
8
8
  import { Panneau } from '../ui/panneau.js';
9
9
  import { lireLAnnuaire } from './barre.js';
10
- import { cleDesChoses, estRangee, motsDe, motsDeLaPublication, texteDuNoeud } from './choses.js';
10
+ import { cleDesChoses, cleDUneChose, estRangee, motsDe, motsDeLaPublication, texteDuNoeud } from './choses.js';
11
11
  import { demandeLAccord } from './confirmation-d-un-geste.js';
12
12
  import { useAnnoncer } from './ouvrir.js';
13
13
  import { useSession } from './session.js';
@@ -59,7 +59,7 @@ function ContenuDuPartage({ choses, chose, mots }) {
59
59
  // La liste des ouvertures, où va le focus quand « Retirer » fait partir sa ligne.
60
60
  const ouverturesDeLaChose = useRef(null);
61
61
  const partage = useQuery({
62
- queryKey: cleDesChoses(choses.app, 'partage', chose.id),
62
+ queryKey: cleDUneChose(choses, 'partage', chose.id),
63
63
  queryFn: () => choses.lirePartage(chose),
64
64
  staleTime: dureeDuPartageLu,
65
65
  });
@@ -182,7 +182,7 @@ export function accesDe(choses, chose, ouvertures) {
182
182
  export function PastilleDeLAcces({ choses, chose }) {
183
183
  const client = useQueryClient();
184
184
  const [ouvert, setOuvert] = useState(false);
185
- const cle = cleDesChoses(choses.app, 'partage', chose.id);
185
+ const cle = cleDUneChose(choses, 'partage', chose.id);
186
186
  const partage = useQuery({ queryKey: cle, queryFn: () => choses.lirePartage(chose), enabled: Boolean(choses.lirePartage), staleTime: dureeDuPartageLu });
187
187
  const acces = accesDe(choses, chose, partage.data);
188
188
  const proprietaire = (chose.droit ?? 'proprietaire') === 'proprietaire';
@@ -1,5 +1,8 @@
1
1
  import { type KeyObject } from 'node:crypto';
2
+ import { type IncomingMessage, type Server } from 'node:http';
2
3
  import type { TestContext } from 'node:test';
4
+ import { Client } from '@modelcontextprotocol/client';
5
+ import { type TraitementDeLApp } from './app.ts';
3
6
  import type { AppDeLaConsole, EntreeDeLaBarre } from './ecran.ts';
4
7
  import type { Personne } from './jeton.ts';
5
8
  import type { Annuaire } from './partage.ts';
@@ -29,3 +32,23 @@ export declare function lancerLeFauxCore(t: TestContext, sessions?: Record<strin
29
32
  logo?: string;
30
33
  nom?: string;
31
34
  }, apps?: AppDeclaree[], annuaire?: Annuaire): Promise<string>;
35
+ export declare function servirLApp(t: TestContext, nom: string, options?: {
36
+ chemin?: (requete: IncomingMessage) => boolean;
37
+ hotePublic?: boolean;
38
+ }): Promise<{
39
+ serveur: Server<typeof IncomingMessage, typeof import("http").ServerResponse>;
40
+ port: number;
41
+ origine: string;
42
+ adresse: string;
43
+ adressePublique: string | undefined;
44
+ brancher(traiter: TraitementDeLApp): void;
45
+ }>;
46
+ export type ClientDEssai = Client;
47
+ export declare function connecter(t: TestContext, adresse: string, personne: Personne | string, app?: string): Promise<ClientDEssai>;
48
+ export type ResultatLu = {
49
+ erreur: boolean;
50
+ refus: boolean;
51
+ texte: string;
52
+ json: any;
53
+ };
54
+ export declare function appeler(client: ClientDEssai, outil: string, arguments_?: Record<string, unknown>, options?: Parameters<Client['callTool']>[1]): Promise<ResultatLu>;
package/src/faux-core.js CHANGED
@@ -1,6 +1,9 @@
1
1
  import { generateKeyPairSync, sign } from 'node:crypto';
2
2
  import { once } from 'node:events';
3
3
  import { createServer } from 'node:http';
4
+ import { Client, StreamableHTTPClientTransport } from '@modelcontextprotocol/client';
5
+ import { creerLeServeur } from './app.js';
6
+ import { sansLeChemin } from './sans-le-chemin.js';
4
7
  // Un faux core pour les tests des apps : il sert sa clé publique et signe des jetons, fabriqués
5
8
  // ici à la main, sans le code du core.
6
9
  export const { privateKey: cleDuFauxCore, publicKey: clePubliqueDuFauxCore } = generateKeyPairSync('ed25519');
@@ -112,3 +115,81 @@ export async function lancerLeFauxCore(t, sessions = {}, theme = {}, apps = [],
112
115
  await once(serveur, 'listening');
113
116
  return `http://127.0.0.1:${serveur.address().port}`;
114
117
  }
118
+ // Une app à l'essai, servie comme `demarrerLApp` la sert derrière le proxy : sur un port libre de
119
+ // 127.0.0.1, son chemin (`/<nom>`) retiré de chaque requête qui le porte, sauf là où `chemin` le
120
+ // garde, comme l'option du même nom de `demarrerLApp`. Avec `hotePublic`, elle écoute sur toutes les
121
+ // interfaces et se joint aussi par `localhost`, son hôte public (`adressePublique`), où elle garde son
122
+ // chemin, sauf si `chemin` en dit autrement. L'erreur d'un traitement coupe la connexion. Elle rend son
123
+ // `adresse`, avec son chemin, son `origine`, son `port`, son `serveur` (pour un WebSocket), et
124
+ // `brancher(traitement)`, qui lui donne son traitement une fois créé : jusque-là, elle répond vide.
125
+ // Elle s'arrête à la fin du test.
126
+ export async function servirLApp(t, nom, options = {}) {
127
+ let traitement;
128
+ let hotePublic;
129
+ const retirer = options.chemin ?? ((requete) => requete.headers.host !== hotePublic);
130
+ const serveur = creerLeServeur((requete, reponse) => {
131
+ if (retirer(requete)) {
132
+ requete.url = sansLeChemin(requete.url ?? '/', `/${nom}`);
133
+ }
134
+ if (!traitement) {
135
+ reponse.end();
136
+ return;
137
+ }
138
+ try {
139
+ Promise.resolve(traitement(requete, reponse)).catch((erreur) => reponse.destroy(erreur));
140
+ }
141
+ catch (erreur) {
142
+ reponse.destroy(erreur);
143
+ }
144
+ });
145
+ serveur.listen(0, options.hotePublic ? undefined : '127.0.0.1');
146
+ await once(serveur, 'listening');
147
+ t.after(() => {
148
+ serveur.closeAllConnections();
149
+ serveur.close();
150
+ });
151
+ const port = serveur.address().port;
152
+ const origine = `http://127.0.0.1:${port}`;
153
+ const adressePublique = options.hotePublic ? `http://localhost:${port}` : undefined;
154
+ hotePublic = adressePublique && new URL(adressePublique).host;
155
+ return {
156
+ serveur,
157
+ port,
158
+ origine,
159
+ adresse: `${origine}/${nom}`,
160
+ adressePublique,
161
+ brancher(traiter) {
162
+ traitement = traiter;
163
+ },
164
+ };
165
+ }
166
+ // Un client MCP pour la personne, comme le core qui relaie Claude, sur `<adresse>/mcp` : il présente
167
+ // le jeton du faux core pour l'app, `app`, par défaut le dernier segment du chemin d'`adresse`, comme
168
+ // le nom d'une app dans son `ADRESSE`. Une chaîne à la place de la personne est un jeton présenté tel
169
+ // quel. Le client se ferme à la fin du test.
170
+ export async function connecter(t, adresse, personne, app) {
171
+ let jeton = personne;
172
+ if (typeof jeton !== 'string') {
173
+ const nom = app ?? new URL(adresse).pathname.split('/').filter(Boolean).at(-1);
174
+ if (!nom) {
175
+ throw new Error(`L'adresse ${adresse} n'a pas de chemin : donnez le nom de l'app à connecter.`);
176
+ }
177
+ jeton = fabriquerUnJeton(jeton, nom);
178
+ }
179
+ const client = new Client({ name: 'essai', version: '1.0.0' });
180
+ await client.connect(new StreamableHTTPClientTransport(new URL(`${adresse}/mcp`), { requestInit: { headers: { authorization: `Bearer ${jeton}` } } }));
181
+ t.after(() => client.close());
182
+ return client;
183
+ }
184
+ // Appelle l'outil par le client de `connecter`, et rend son résultat lu. `options` sont celles du
185
+ // client MCP pour cet appel, comme un `timeout` plus long que la minute par défaut.
186
+ export async function appeler(client, outil, arguments_ = {}, options) {
187
+ const resultat = await client.callTool({ name: outil, arguments: arguments_ }, options);
188
+ const texte = resultat.content.find((partie) => partie.type === 'text')?.text ?? '';
189
+ return {
190
+ erreur: resultat.isError === true,
191
+ refus: resultat._meta?.['indos/refus'] === true,
192
+ texte,
193
+ json: /^[[{]/.test(texte) ? JSON.parse(texte) : undefined,
194
+ };
195
+ }
@@ -0,0 +1,37 @@
1
+ import type pg from 'pg';
2
+ export type FichierDUneChose = {
3
+ chemin: string;
4
+ type: string;
5
+ taille: number;
6
+ };
7
+ export type FichierLu = FichierDUneChose & {
8
+ contenu: Buffer;
9
+ };
10
+ export type TexteLu = FichierDUneChose & {
11
+ texte: string;
12
+ };
13
+ export declare const deuxMo: number;
14
+ export declare function estUnChemin(chemin: string): boolean;
15
+ export declare function estUnDossier(chemin: string): boolean;
16
+ export declare const formeDUnChemin = "Un chemin de fichier : des segments de lettres, chiffres, `.`, `_` et `-`, s\u00E9par\u00E9s par `/`, dont aucun ne commence par un point ou un tiret, 300 caract\u00E8res au plus ; un dossier finit par `/`.";
17
+ export declare function typeDuChemin(chemin: string): string | undefined;
18
+ export declare function typeSain(type: string): string | undefined;
19
+ export declare function estUnTexte(type: string): boolean;
20
+ export declare function texteDe(octets: Buffer): string | undefined;
21
+ export type OptionsDesFichiers = {
22
+ chose: string;
23
+ laChose: string;
24
+ };
25
+ export declare function creerLesFichiersDUneChose({ chose: nomDeLaChose, laChose }: OptionsDesFichiers): {
26
+ lesFichiers(base: pg.Pool | pg.PoolClient, id: string): Promise<FichierDUneChose[]>;
27
+ lireLesFichiers: (base: pg.Pool | pg.PoolClient, id: string, chemins: string[]) => Promise<Map<string, FichierLu>>;
28
+ lireUnTexte(base: pg.Pool | pg.PoolClient, id: string, chemin: string): Promise<TexteLu>;
29
+ lireDesTextes(base: pg.Pool | pg.PoolClient, id: string, chemins: string[]): Promise<(TexteLu | {
30
+ chemin: string;
31
+ erreur: string;
32
+ })[]>;
33
+ poser(client: pg.PoolClient, id: string, chemin: string, type: string, contenu: Buffer): Promise<FichierDUneChose>;
34
+ copier(client: pg.PoolClient, source: string, depuis: string, cible: string, vers: string): Promise<FichierDUneChose[]>;
35
+ retirer(client: pg.PoolClient, id: string, chemin: string): Promise<string[]>;
36
+ };
37
+ export type FichiersDUneChose = ReturnType<typeof creerLesFichiersDUneChose>;
@@ -0,0 +1,136 @@
1
+ export const deuxMo = 2 * 1024 * 1024;
2
+ // Un chemin : des segments de lettres, chiffres, `.`, `_` et `-`, séparés par `/`, dont aucun ne
3
+ // commence par un point ou un tiret ; un dossier : un chemin suivi de `/`.
4
+ const segments = '[A-Za-z0-9_][A-Za-z0-9._-]*(/[A-Za-z0-9_][A-Za-z0-9._-]*)*';
5
+ const unChemin = new RegExp(`^${segments}$`);
6
+ const unDossier = new RegExp(`^${segments}/$`);
7
+ export function estUnChemin(chemin) {
8
+ return chemin.length <= 300 && unChemin.test(chemin);
9
+ }
10
+ export function estUnDossier(chemin) {
11
+ return chemin.length <= 300 && unDossier.test(chemin);
12
+ }
13
+ export const formeDUnChemin = 'Un chemin de fichier : des segments de lettres, chiffres, `.`, `_` et `-`, séparés par `/`, dont aucun ne commence par un point ou un tiret, 300 caractères au plus ; un dossier finit par `/`.';
14
+ // Le type d'un fichier d'après l'extension de son chemin : celui que le navigateur attend.
15
+ const types = {
16
+ html: 'text/html', css: 'text/css', js: 'text/javascript', mjs: 'text/javascript', json: 'application/json',
17
+ md: 'text/markdown', txt: 'text/plain', csv: 'text/csv', xml: 'application/xml', svg: 'image/svg+xml',
18
+ png: 'image/png', jpg: 'image/jpeg', jpeg: 'image/jpeg', gif: 'image/gif', webp: 'image/webp', avif: 'image/avif', ico: 'image/x-icon',
19
+ woff: 'font/woff', woff2: 'font/woff2', ttf: 'font/ttf', otf: 'font/otf',
20
+ pdf: 'application/pdf', mp3: 'audio/mpeg', mp4: 'video/mp4', webm: 'video/webm', wasm: 'application/wasm',
21
+ };
22
+ export function typeDuChemin(chemin) {
23
+ const point = chemin.lastIndexOf('.');
24
+ return point > chemin.lastIndexOf('/') ? types[chemin.slice(point + 1).toLowerCase()] : undefined;
25
+ }
26
+ // Un type MIME tel que la base l'accepte : en minuscules, sans paramètre.
27
+ const unType = /^[a-z]+\/[a-z0-9.+-]+$/;
28
+ export function typeSain(type) {
29
+ const nu = type.split(';')[0]?.trim().toLowerCase() ?? '';
30
+ return unType.test(nu) ? nu : undefined;
31
+ }
32
+ // Un fichier se lit en texte quand son type le dit et que ses octets sont de l'UTF-8.
33
+ export function estUnTexte(type) {
34
+ return /^text\/|^application\/(json|javascript|xml)$|\+(json|xml)$/.test(type);
35
+ }
36
+ export function texteDe(octets) {
37
+ try {
38
+ return new TextDecoder('utf-8', { fatal: true }).decode(octets);
39
+ }
40
+ catch {
41
+ return undefined;
42
+ }
43
+ }
44
+ // Les gestes sur les fichiers des choses de l'app. Une lecture prend la base ou la connexion d'une
45
+ // transaction ; une écriture, la connexion de la transaction de la chose (`enTransaction`), qui
46
+ // tient son verrou et sa date de modification.
47
+ export function creerLesFichiersDUneChose({ chose: nomDeLaChose, laChose }) {
48
+ if (!/^[a-z_][a-z0-9_]*$/.test(nomDeLaChose)) {
49
+ throw new Error(`« ${nomDeLaChose} » n'est pas un nom de colonne.`);
50
+ }
51
+ const chose = nomDeLaChose;
52
+ const LaChose = `${laChose.charAt(0).toUpperCase()}${laChose.slice(1)}`;
53
+ // Le texte d'un fichier lu, ou une erreur qui dit pourquoi il ne se lit pas.
54
+ function texteDuFichier(chemin, fichier) {
55
+ if (!fichier) {
56
+ throw new Error(`${LaChose} n'a pas de fichier « ${chemin} » : \`lire\` sans \`chemins\` donne ses fichiers.`);
57
+ }
58
+ if (!estUnTexte(fichier.type)) {
59
+ throw new Error(`« ${chemin} » n'est pas un fichier texte (${fichier.type}).`);
60
+ }
61
+ const texte = texteDe(fichier.contenu);
62
+ if (texte === undefined) {
63
+ throw new Error(`« ${chemin} » (${fichier.type}) n'est pas écrit en UTF-8 : il ne se lit pas en texte.`);
64
+ }
65
+ return { chemin, type: fichier.type, taille: fichier.taille, texte };
66
+ }
67
+ // Les fichiers de ces chemins, avec leurs octets.
68
+ async function lireLesFichiers(base, id, chemins) {
69
+ if (chemins.length === 0) {
70
+ return new Map();
71
+ }
72
+ const { rows } = await base.query(`select chemin, type, taille, contenu from fichier where ${chose} = $1 and chemin = any($2)`, [id, chemins]);
73
+ return new Map(rows.map((fichier) => [fichier.chemin, fichier]));
74
+ }
75
+ return {
76
+ // Les fichiers d'une chose, sans leur contenu, du premier au dernier chemin.
77
+ async lesFichiers(base, id) {
78
+ const { rows } = await base.query(`select chemin, type, taille from fichier where ${chose} = $1 order by chemin`, [id]);
79
+ return rows;
80
+ },
81
+ lireLesFichiers,
82
+ // Le fichier texte de ce chemin, avec son texte, ou une erreur qui dit pourquoi il ne se lit pas.
83
+ async lireUnTexte(base, id, chemin) {
84
+ return texteDuFichier(chemin, (await lireLesFichiers(base, id, [chemin])).get(chemin));
85
+ },
86
+ // Les fichiers texte de ces chemins, dans l'ordre demandé : chacun avec son texte, ou ce qui
87
+ // l'empêche de se lire.
88
+ async lireDesTextes(base, id, chemins) {
89
+ const uniques = [...new Set(chemins)];
90
+ const lus = await lireLesFichiers(base, id, uniques);
91
+ return uniques.map((chemin) => {
92
+ try {
93
+ return texteDuFichier(chemin, lus.get(chemin));
94
+ }
95
+ catch (erreur) {
96
+ return { chemin, erreur: erreur.message };
97
+ }
98
+ });
99
+ },
100
+ // Pose un fichier sous son chemin : le crée, ou remplace celui du même chemin.
101
+ async poser(client, id, chemin, type, contenu) {
102
+ if (contenu.length > deuxMo) {
103
+ throw new Error(`« ${chemin} » fait ${contenu.length} octets : un fichier en fait 2 Mo au plus.`);
104
+ }
105
+ const { rows } = await client.query(`insert into fichier (${chose}, chemin, type, contenu) values ($1, $2, $3, $4)
106
+ on conflict (${chose}, chemin) do update set type = excluded.type, contenu = excluded.contenu, modifie_le = now()
107
+ returning chemin, type, taille`, [id, chemin, type, contenu]);
108
+ return rows[0];
109
+ },
110
+ // Copie, en une requête, le fichier `depuis` de la chose source sous `vers` dans la chose cible,
111
+ // ou, quand les deux finissent par `/`, tous ses fichiers sous ce dossier dans le dossier cible.
112
+ // Un fichier du même chemin dans la cible est remplacé ; chaque fichier garde son type.
113
+ async copier(client, source, depuis, cible, vers) {
114
+ const dossier = depuis.endsWith('/');
115
+ const { rows } = await client.query(`insert into fichier (${chose}, chemin, type, contenu)
116
+ select $3, case when $5 then $4 || substr(chemin, length($2) + 1) else $4 end, type, contenu
117
+ from fichier
118
+ where ${chose} = $1 and case when $5 then starts_with(chemin, $2) else chemin = $2 end
119
+ order by chemin
120
+ on conflict (${chose}, chemin) do update set type = excluded.type, contenu = excluded.contenu, modifie_le = now()
121
+ returning chemin, type, taille`, [source, depuis, cible, vers, dossier]);
122
+ if (rows.length === 0) {
123
+ throw new Error(`${LaChose} source n'a aucun fichier « ${depuis} ».`);
124
+ }
125
+ return rows;
126
+ },
127
+ // Retire le fichier de ce chemin, ou tous ceux d'un dossier, et rend les chemins retirés.
128
+ async retirer(client, id, chemin) {
129
+ const { rows } = await client.query(`delete from fichier where ${chose} = $1 and case when $3 then starts_with(chemin, $2) else chemin = $2 end returning chemin`, [id, chemin, chemin.endsWith('/')]);
130
+ if (rows.length === 0) {
131
+ throw new Error(`${LaChose} n'a aucun fichier « ${chemin} ».`);
132
+ }
133
+ return rows.map((ligne) => ligne.chemin).sort();
134
+ },
135
+ };
136
+ }
@@ -0,0 +1,28 @@
1
+ import { type PersonnePresente } from './presence.ts';
2
+ export declare const cheminDuDirect = "direct";
3
+ export declare const raisons: {
4
+ readonly introuvable: 'introuvable';
5
+ readonly plusOuvert: 'plus ouvert par ce lien';
6
+ readonly connexion: 'connexion requise';
7
+ readonly reessayez: 'réessayez';
8
+ readonly origine: 'origine refusée';
9
+ };
10
+ export declare const codes: {
11
+ readonly droitChange: 4205;
12
+ readonly plusDeDroit: 4403;
13
+ readonly redemarrage: 1012;
14
+ };
15
+ export declare function estUneChoseAbsente(raison: string): boolean;
16
+ export type Invite = {
17
+ id: string;
18
+ prenom: string;
19
+ };
20
+ export declare function personneDeLInvite(donne: unknown, tirer: () => string): PersonnePresente;
21
+ export type OngletPresent = {
22
+ client: number;
23
+ personne: PersonnePresente;
24
+ etat: Record<string, unknown>;
25
+ };
26
+ export declare function personneDeLEtat(etat: unknown): PersonnePresente | undefined;
27
+ export declare function ongletsDesAutres(etats: Map<number, unknown>, client: number): OngletPresent[];
28
+ export declare function personnesDesAutres(etats: Map<number, unknown>, client: number): PersonnePresente[];
@@ -0,0 +1,70 @@
1
+ import { longueurDUnNom } from './presence.js';
2
+ // La forme commune du direct Yjs, la même au serveur (`@indos/bibliotheque/direct`) et à la page
3
+ // (`@indos/bibliotheque/direct/page`), sans rien de Node ni du navigateur (bibliotheque/CLAUDE.md,
4
+ // « Le direct Yjs ») : son chemin, les raisons de ses refus, ses codes de fermeture et la présence
5
+ // que le serveur écrit.
6
+ // Le chemin du direct d'une chose, sous l'app : `direct/<id>`.
7
+ export const cheminDuDirect = 'direct';
8
+ // Pourquoi le serveur refuse une connexion : la page reçoit la raison à l'ouverture
9
+ // (`onAuthenticationFailed`), ou avec la fermeture 4403. « réessayez » (le core ou la base ne
10
+ // répondent pas) se réessaie seul ; les autres ferment le direct.
11
+ export const raisons = {
12
+ introuvable: 'introuvable',
13
+ plusOuvert: 'plus ouvert par ce lien',
14
+ connexion: 'connexion requise',
15
+ reessayez: 'réessayez',
16
+ origine: 'origine refusée',
17
+ };
18
+ // Les codes de fermeture du serveur : le droit a changé, la page se rouvre au nouveau ; plus de
19
+ // droit, la page ferme le direct, avec la raison ; l'app redémarre, la page se rouvre.
20
+ export const codes = { droitChange: 4205, plusDeDroit: 4403, redemarrage: 1012 };
21
+ // La raison d'un refus qui dit une chose absente, ou qui n'est plus ouverte à la personne : l'écran
22
+ // commun d'une chose introuvable la remplace.
23
+ export function estUneChoseAbsente(raison) {
24
+ return raison === raisons.introuvable || raison === raisons.plusOuvert;
25
+ }
26
+ const formeDUnUuid = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
27
+ // La présence d'un invité, tirée de ce que sa page envoie : son identifiant, un UUID, sinon un
28
+ // identifiant tiré par le serveur ; son prénom, sans les espaces autour, borné à 24 caractères,
29
+ // « Invité » quand il est vide.
30
+ export function personneDeLInvite(donne, tirer) {
31
+ const invite = donne && typeof donne === 'object' ? donne : {};
32
+ const id = typeof invite.id === 'string' && formeDUnUuid.test(invite.id) ? invite.id.toLowerCase() : tirer();
33
+ const prenom = typeof invite.prenom === 'string' ? Array.from(invite.prenom.trim()).slice(0, longueurDUnNom).join('').trim() : '';
34
+ return { id, nom: prenom || 'Invité', invite: true };
35
+ }
36
+ // La personne qu'un état de présence porte, écrite par le serveur, ou rien.
37
+ export function personneDeLEtat(etat) {
38
+ const personne = etat && typeof etat === 'object' ? etat.personne : undefined;
39
+ if (!personne || typeof personne !== 'object') {
40
+ return undefined;
41
+ }
42
+ const { id, nom, invite } = personne;
43
+ if (typeof id !== 'string' || typeof nom !== 'string') {
44
+ return undefined;
45
+ }
46
+ return { id, nom, ...(invite === true ? { invite: true } : {}) };
47
+ }
48
+ // Les onglets des autres, d'après les états de présence (`awareness.getStates()`), sans celui de la
49
+ // page (`client`, son `clientID`) : ceux qui portent une personne, dans l'ordre des états.
50
+ export function ongletsDesAutres(etats, client) {
51
+ const onglets = [];
52
+ for (const [autre, etat] of etats) {
53
+ const personne = autre === client ? undefined : personneDeLEtat(etat);
54
+ if (personne) {
55
+ onglets.push({ client: autre, personne, etat: etat });
56
+ }
57
+ }
58
+ return onglets;
59
+ }
60
+ // Les autres personnes présentes, une fois chacune quel que soit le nombre de ses onglets : les
61
+ // `autres` d'`EtatEtPresences`.
62
+ export function personnesDesAutres(etats, client) {
63
+ const personnes = new Map();
64
+ for (const { personne } of ongletsDesAutres(etats, client)) {
65
+ if (!personnes.has(personne.id)) {
66
+ personnes.set(personne.id, personne);
67
+ }
68
+ }
69
+ return [...personnes.values()];
70
+ }
package/src/presence.d.ts CHANGED
@@ -1,2 +1,8 @@
1
+ export type PersonnePresente = {
2
+ id: string;
3
+ nom: string;
4
+ invite?: boolean;
5
+ };
6
+ export declare const longueurDUnNom = 24;
1
7
  export declare const couleursDesPersonnes: readonly ['#2b6dc9', '#c6327c', '#1f7d4e', '#996216', '#9a49c2', '#177a83', '#4a7a29', '#6262cb'];
2
8
  export declare function couleurDe(id: string): string;
package/src/presence.js CHANGED
@@ -1,6 +1,9 @@
1
- // @indos/bibliotheque/presence : la couleur d'une personne dans le direct, sans rien de Node ni du
2
- // navigateur (bibliotheque/CLAUDE.md, « Le direct à l'écran »). La page et le serveur la calculent
3
- // de la même façon : une personne a la même couleur dans toutes les apps, sur chaque appareil.
1
+ // @indos/bibliotheque/presence : une personne présente dans le direct et sa couleur, sans rien de
2
+ // Node ni du navigateur (bibliotheque/CLAUDE.md, « Le direct à l'écran »). La page et le serveur la
3
+ // calculent de la même façon : une personne a la même couleur dans toutes les apps, sur chaque
4
+ // appareil.
5
+ // La longueur d'un nom dans le direct : le nom d'une session, ou le prénom d'un invité, borné.
6
+ export const longueurDUnNom = 24;
4
7
  // Huit couleurs à la même luminance, ni rouge ni orange, pour ne se confondre ni avec l'accent ni
5
8
  // avec l'erreur. Chacune se lit sur le papier clair (#faf8f3) et sur la surface du charbon (#1e1e1e)
6
9
  // à 3:1 au moins, et porte un texte blanc à 4,5:1 au moins (tests/presence.test.ts). Elles sont les
@@ -0,0 +1,26 @@
1
+ export type Remplacement = {
2
+ avant: string;
3
+ apres: string;
4
+ };
5
+ export declare const schemaDesRemplacements: {
6
+ type: string;
7
+ minItems: number;
8
+ maxItems: number;
9
+ description: string;
10
+ items: {
11
+ type: string;
12
+ properties: {
13
+ avant: {
14
+ type: string;
15
+ minLength: number;
16
+ };
17
+ apres: {
18
+ type: string;
19
+ };
20
+ };
21
+ required: string[];
22
+ additionalProperties: boolean;
23
+ };
24
+ };
25
+ export declare function appliquerLesRemplacements(contenu: string, remplacements: Remplacement[]): string;
26
+ export declare function extraitLePlusProche(contenu: string, avant: string): string | undefined;
@@ -0,0 +1,41 @@
1
+ export const schemaDesRemplacements = {
2
+ type: 'array',
3
+ minItems: 1,
4
+ maxItems: 100,
5
+ description: 'Les remplacements, appliqués dans l\'ordre : `avant`, un passage du contenu assez long pour y être unique ; `apres`, ce qui le remplace.',
6
+ items: {
7
+ type: 'object',
8
+ properties: { avant: { type: 'string', minLength: 1 }, apres: { type: 'string' } },
9
+ required: ['avant', 'apres'],
10
+ additionalProperties: false,
11
+ },
12
+ };
13
+ export function appliquerLesRemplacements(contenu, remplacements) {
14
+ for (const [rang, { avant, apres }] of remplacements.entries()) {
15
+ const position = contenu.indexOf(avant);
16
+ if (position < 0) {
17
+ const extrait = extraitLePlusProche(contenu, avant);
18
+ throw new Error(`Le remplacement ${rang + 1} : son « avant » ne se trouve pas dans le contenu ; rien n'est écrit.${extrait ? ` Le passage le plus proche : ${extrait}` : ''}`);
19
+ }
20
+ if (contenu.indexOf(avant, position + 1) >= 0) {
21
+ throw new Error(`Le remplacement ${rang + 1} : son « avant » se trouve plusieurs fois dans le contenu ; rien n'est écrit. L'allonger pour qu'il soit unique.`);
22
+ }
23
+ contenu = contenu.slice(0, position) + apres + contenu.slice(position + avant.length);
24
+ }
25
+ return contenu;
26
+ }
27
+ // Le passage du contenu le plus proche d'un « avant » introuvable : le plus long début, ou la plus
28
+ // longue fin, de l'« avant » qui s'y trouve, avec ce qui l'entoure.
29
+ const autour = 120;
30
+ export function extraitLePlusProche(contenu, avant) {
31
+ for (let longueur = avant.length - 1; longueur >= Math.min(8, avant.length); longueur--) {
32
+ for (const position of [contenu.indexOf(avant.slice(0, longueur)), contenu.indexOf(avant.slice(avant.length - longueur))]) {
33
+ if (position >= 0) {
34
+ const debut = Math.max(0, position - autour);
35
+ const fin = Math.min(contenu.length, position + longueur + autour);
36
+ return `${debut > 0 ? '…' : ''}${contenu.slice(debut, fin)}${fin < contenu.length ? '…' : ''}`;
37
+ }
38
+ }
39
+ }
40
+ return undefined;
41
+ }
@@ -0,0 +1 @@
1
+ export declare function sansLeChemin(url: string, prefixe: string): string;
@@ -0,0 +1,9 @@
1
+ // L'adresse d'une requête sans le chemin de l'app (`/<nom>`), sa recherche gardée ; telle quelle
2
+ // sans lui. `demarrerLApp` la donne au traitement de l'app, et l'app à l'essai du faux core de même.
3
+ export function sansLeChemin(url, prefixe) {
4
+ const { pathname, search } = new URL(url, 'http://app');
5
+ if (pathname !== prefixe && !pathname.startsWith(`${prefixe}/`)) {
6
+ return url;
7
+ }
8
+ return `${pathname.slice(prefixe.length) || '/'}${search}`;
9
+ }
@@ -0,0 +1,5 @@
1
+ export type Signaux<Quoi extends string> = {
2
+ signaler(id: string, quoi: Quoi): void;
3
+ ecouter(id: string, rappel: (quoi: Quoi) => void): () => void;
4
+ };
5
+ export declare function creerLesSignaux<Quoi extends string>(): Signaux<Quoi>;
package/src/signaux.js ADDED
@@ -0,0 +1,20 @@
1
+ export function creerLesSignaux() {
2
+ const ecouteurs = new Map();
3
+ return {
4
+ signaler(id, quoi) {
5
+ for (const rappel of ecouteurs.get(id) ?? []) {
6
+ rappel(quoi);
7
+ }
8
+ },
9
+ ecouter(id, rappel) {
10
+ const deLaChose = ecouteurs.get(id) ?? new Set();
11
+ ecouteurs.set(id, deLaChose.add(rappel));
12
+ return () => {
13
+ deLaChose.delete(rappel);
14
+ if (deLaChose.size === 0) {
15
+ ecouteurs.delete(id);
16
+ }
17
+ };
18
+ },
19
+ };
20
+ }
@@ -1,10 +1,7 @@
1
1
  import type { HTMLAttributes } from 'react';
2
+ import { type PersonnePresente } from '../presence.ts';
2
3
  export type EtatDeLaConnexion = 'connexion' | 'en-direct' | 'reconnexion';
3
- export type PersonnePresente = {
4
- id: string;
5
- nom: string;
6
- invite?: boolean;
7
- };
4
+ export type { PersonnePresente };
8
5
  export type ProprietesDeLEtatEtDesPresences = {
9
6
  etat: EtatDeLaConnexion;
10
7
  lectureSeule?: boolean;
@@ -24,3 +21,5 @@ export type ProprietesDeLEtiquetteDuNom = {
24
21
  export declare function EtiquetteDuNom({ id, nom, className, style, ...reste }: ProprietesDeLEtiquetteDuNom): import("react").JSX.Element;
25
22
  export declare function elementDeLEtiquetteDuNom(id: string, nom: string): HTMLSpanElement;
26
23
  export declare function texteDuDroitQuiBaisse(une: string, feminin?: boolean): string;
24
+ export declare function texteDeCeQuiNEstPasEnregistre(une: string, feminin?: boolean): string;
25
+ export declare function texteDUnRefusDuDirect(raison: string, une: string, feminin?: boolean): string;