@indos/bibliotheque 2.3.0 → 3.0.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.
Files changed (121) hide show
  1. package/CLAUDE.md +361 -0
  2. package/LICENSE +4 -18
  3. package/README.md +6 -11
  4. package/bin/page-de-l-espace.js +12 -6
  5. package/package.json +16 -13
  6. package/src/app.js +2 -2
  7. package/src/appeler.js +4 -5
  8. package/src/compte.d.ts +222 -8
  9. package/src/compte.js +250 -22
  10. package/src/description-des-comptes.d.ts +16 -0
  11. package/src/direct/page.js +1 -1
  12. package/src/direct.js +1 -1
  13. package/src/ecran.js +2 -2
  14. package/src/espace/apercu.js +10 -23
  15. package/src/espace/barre.d.ts +1 -0
  16. package/src/espace/barre.js +8 -2
  17. package/src/espace/cadre.d.ts +4 -5
  18. package/src/espace/cadre.js +31 -29
  19. package/src/espace/chose-seule.d.ts +1 -4
  20. package/src/espace/chose-seule.js +7 -16
  21. package/src/espace/choses.d.ts +9 -5
  22. package/src/espace/choses.js +9 -4
  23. package/src/espace/comptes.js +146 -103
  24. package/src/espace/coquille.d.ts +6 -6
  25. package/src/espace/coquille.js +157 -68
  26. package/src/espace/doubles-de-jsdom.js +11 -4
  27. package/src/espace/ecran-d-une-chose.js +10 -9
  28. package/src/espace/ecran.js +1 -2
  29. package/src/espace/edition-de-la-barre.d.ts +31 -0
  30. package/src/espace/edition-de-la-barre.js +450 -0
  31. package/src/espace/essai.js +4 -4
  32. package/src/espace/fenetre-du-don.d.ts +11 -0
  33. package/src/espace/fenetre-du-don.js +41 -0
  34. package/src/espace/index.d.ts +3 -3
  35. package/src/espace/index.js +3 -3
  36. package/src/espace/liste-des-choses.js +28 -24
  37. package/src/espace/menu-d-une-chose.js +15 -51
  38. package/src/espace/ouvrir.d.ts +3 -3
  39. package/src/espace/ouvrir.js +15 -14
  40. package/src/espace/page.js +1 -1
  41. package/src/espace/panneau-du-partage.d.ts +8 -3
  42. package/src/espace/panneau-du-partage.js +36 -14
  43. package/src/espace/routes-des-choses.js +6 -5
  44. package/src/espace/session.d.ts +14 -0
  45. package/src/faux-core.d.ts +29 -3
  46. package/src/faux-core.js +90 -12
  47. package/src/fichiers.d.ts +2 -0
  48. package/src/fichiers.js +6 -4
  49. package/src/flux.js +1 -1
  50. package/src/format.d.ts +3 -0
  51. package/src/format.js +20 -1
  52. package/src/forme-du-direct.js +1 -1
  53. package/src/jeton.js +2 -2
  54. package/src/liens.js +1 -1
  55. package/src/mcp.js +3 -3
  56. package/src/notifier.d.ts +10 -0
  57. package/src/notifier.js +47 -0
  58. package/src/page.d.ts +17 -0
  59. package/src/page.js +139 -14
  60. package/src/partage.d.ts +5 -1
  61. package/src/partage.js +61 -16
  62. package/src/presence.js +1 -1
  63. package/src/sans-accents.js +1 -1
  64. package/src/session.js +4 -4
  65. package/src/theme.js +1 -1
  66. package/src/ui/blocs.d.ts +5 -2
  67. package/src/ui/blocs.js +11 -6
  68. package/src/ui/choix.d.ts +2 -1
  69. package/src/ui/choix.js +3 -2
  70. package/src/ui/direct.d.ts +6 -0
  71. package/src/ui/direct.js +9 -5
  72. package/src/ui/fenetre.d.ts +8 -3
  73. package/src/ui/fenetre.js +34 -9
  74. package/src/ui/focus.d.ts +2 -0
  75. package/src/ui/focus.js +5 -0
  76. package/src/ui/gestes-du-contenu.d.ts +21 -0
  77. package/src/ui/gestes-du-contenu.js +24 -0
  78. package/src/ui/icones.d.ts +7 -0
  79. package/src/ui/icones.js +12 -1
  80. package/src/ui/index.d.ts +6 -5
  81. package/src/ui/index.js +5 -4
  82. package/src/ui/lien.d.ts +1 -0
  83. package/src/ui/lien.js +2 -2
  84. package/src/ui/menu-d-une-ligne.d.ts +2 -0
  85. package/src/ui/panneau.d.ts +1 -2
  86. package/src/ui/panneau.js +8 -4
  87. package/src/ui/reglages.d.ts +47 -0
  88. package/src/ui/reglages.js +101 -0
  89. package/src/ui/tableau.d.ts +1 -2
  90. package/src/ui/tableau.js +8 -12
  91. package/src/ui/vues.js +1 -1
  92. package/src/vite.d.ts +3 -0
  93. package/src/vite.js +50 -18
  94. package/CHANGELOG.md +0 -276
  95. package/bin/bibliotheque.d.ts +0 -1
  96. package/bin/bibliotheque.js +0 -62
  97. package/modeles/app-du-client/.dockerignore +0 -3
  98. package/modeles/app-du-client/DOCUMENTATION.md +0 -27
  99. package/modeles/app-du-client/Dockerfile +0 -36
  100. package/modeles/app-du-client/README.md +0 -53
  101. package/modeles/app-du-client/USAGE.md +0 -3
  102. package/modeles/app-du-client/espace/ecrans/entrees.tsx +0 -57
  103. package/modeles/app-du-client/espace/index.html +0 -9
  104. package/modeles/app-du-client/espace/page.tsx +0 -6
  105. package/modeles/app-du-client/espace/requetes/entrees.ts +0 -16
  106. package/modeles/app-du-client/espace/routes.ts +0 -12
  107. package/modeles/app-du-client/espace/tsconfig.json +0 -7
  108. package/modeles/app-du-client/gitignore +0 -2
  109. package/modeles/app-du-client/logo.svg +0 -1
  110. package/modeles/app-du-client/migrations/0001-creer-les-entrees.sql +0 -10
  111. package/modeles/app-du-client/module.json +0 -12
  112. package/modeles/app-du-client/package.json +0 -17
  113. package/modeles/app-du-client/src/demarrer.ts +0 -17
  114. package/modeles/app-du-client/src/outils.ts +0 -48
  115. package/modeles/app-du-client/src/serveur.ts +0 -46
  116. package/modeles/app-du-client/tests/espace/entrees.test.tsx +0 -57
  117. package/modeles/app-du-client/tests/serveur.test.ts +0 -119
  118. package/modeles/app-du-client/tests/sources-de-la-page.test.ts +0 -23
  119. package/modeles/app-du-client/tsconfig.json +0 -22
  120. package/src/ui/repli.d.ts +0 -12
  121. package/src/ui/repli.js +0 -6
package/src/faux-core.js CHANGED
@@ -20,6 +20,15 @@ export function fabriquerUnJeton(personne, app, cle = cleDuFauxCore) {
20
20
  }
21
21
  // Un logo d'essai, à donner au faux core.
22
22
  export const logoDEssai = '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 10 10"><rect width="10" height="10"/></svg>';
23
+ // La clé commune des apps que le faux core attend à `/notifier`, que le test donne à l'app
24
+ // (`creerLeNotificateur(par, adresse, cleDAppelDuFauxCore)`, ou `CLE_D_APPEL`).
25
+ export const cleDAppelDuFauxCore = 'cle-d-appel-du-faux-core';
26
+ const notificationsRecues = new Map();
27
+ // Les notifications qu'a reçues le faux core d'`adresse` (celle que rend `lancerLeFauxCore`), dans
28
+ // l'ordre d'arrivée, une par personne, de `pour` seulement quand il est donné.
29
+ export function notificationsDuFauxCore(adresse, pour) {
30
+ return (notificationsRecues.get(adresse) ?? []).filter((notification) => pour === undefined || notification.pour === pour);
31
+ }
23
32
  // Une app est ouverte à la personne quand ses accès l'ouvrent à l'équipe ou à l'un de ses groupes ;
24
33
  // le propriétaire ouvre toute app.
25
34
  function estOuverte(app, proprietaire, groupes) {
@@ -27,11 +36,13 @@ function estOuverte(app, proprietaire, groupes) {
27
36
  return proprietaire || acces.some((avec) => avec === 'equipe' || groupes.includes(avec));
28
37
  }
29
38
  // Ce que le core rend à `/session` des apps déclarées, pour une personne, dans sa forme
30
- // (core/CLAUDE.md, « La personne connectée ») : les apps qui lui sont ouvertes, d'après
39
+ // (indos/bibliotheque/CLAUDE.md, « Les pièces ») : les apps qui lui sont ouvertes, d'après
31
40
  // ses groupes, dans l'ordre de leur titre, chacune avec ses réglages quand la personne a le droit de
32
41
  // les voir, les écrans qu'elle a le droit de voir, avec leur chemin, et son lien (son premier écran
33
- // visible, sinon ses réglages, sinon son lien déclaré) ; puis la barre de départ : « Bienvenue », le
34
- // premier écran de chaque app qui en a un, au titre de l'app, puis le journal, au nom de l'OS.
42
+ // visible, sinon ses réglages, sinon son lien déclaré) ; puis la barre de départ : le premier écran
43
+ // de chaque app qui en a un, au titre de l'app, puis le journal, au nom de l'OS, à plat (`barre`),
44
+ // rangée (`rangement`), et « Bienvenue » pour accueil (`accueil`) ; et ses éléments, tels que les
45
+ // rend `/espace/barre` (`elements`).
35
46
  export function sessionDuCore(apps, proprietaire, nomDeLOS, groupes = []) {
36
47
  const resolues = apps
37
48
  .filter((app) => estOuverte(app, proprietaire, groupes))
@@ -52,31 +63,46 @@ export function sessionDuCore(apps, proprietaire, nomDeLOS, groupes = []) {
52
63
  };
53
64
  });
54
65
  const barre = [
55
- { titre: 'Bienvenue', chemin: '/bienvenue', app: nomDeLOS },
56
66
  ...resolues.flatMap((app) => (app.ecrans[0] ? [{ titre: app.titre, chemin: app.ecrans[0].chemin, app: app.titre }] : [])),
57
67
  { titre: 'Journal', chemin: '/journal', app: nomDeLOS },
58
68
  ];
59
- return { apps: resolues, barre };
69
+ const rangement = barre.map((entree) => ({ sorte: 'epingle', ...entree }));
70
+ const elements = [{ accueil: '/bienvenue' }, ...barre.map((entree) => ({ chemin: entree.chemin, nom: entree.titre, visible: true }))];
71
+ return { apps: resolues, barre, rangement, accueil: '/bienvenue', elements };
60
72
  }
61
73
  // Lance le faux core et rend son adresse. Il sert sa clé publique, et dit qui est connecté à une
62
74
  // page d'une app (`GET /session`) et à la page de l'espace (`GET /espace/session`, le même corps),
63
75
  // dans la forme du core : `sessions` associe le cookie que
64
76
  // présente l'app à la personne, rendue avec ses groupes (`personne.groupes`, nommés par
65
77
  // l'annuaire, dans l'ordre de leur nom), les apps qui lui sont ouvertes, la barre (`sessionDuCore`,
66
- // d'après `apps`, déclarées comme par le kit) et le thème (`theme.nom`, « Indos » par défaut, et
67
- // la présence de son logo) ; tout autre cookie reçoit 401. Sans app déclarée, la session ne rend
68
- // pas d'`apps`, comme un core d'avant 1.6 : aucune app n'y est fermée. Il sert l'annuaire
78
+ // d'après `apps`, déclarées comme par le kit, à plat et rangée, et son accueil) et le thème
79
+ // (`theme.nom`, « Indos » par défaut, et la présence de son logo) ; tout autre cookie reçoit 401.
80
+ // Il sert les éléments de cette barre à `/espace/barre`, comme le geste du core. Sans app déclarée,
81
+ // la session ne rend pas d'`apps`, comme un core d'avant 1.6 : aucune app n'y est fermée. Il sert l'annuaire
69
82
  // (`GET /annuaire`) : `annuaire`, ou, sans lui, les personnes des sessions, actives, sans groupe.
83
+ // L'annuaire est tenu par référence et relu à chaque requête : un test qui retire un membre d'un
84
+ // groupe ou désactive une personne en cours de route, sur l'objet qu'il a passé, le voit à l'appel
85
+ // suivant.
70
86
  // Il sert `theme.logo` sur `/theme/logo.svg`, lu à chaque requête (un test le change en cours de
71
87
  // route), ou 404 sans logo.
72
- export async function lancerLeFauxCore(t, sessions = {}, theme = {}, apps = [], annuaire) {
88
+ // Il reçoit les notifications des apps à `POST /notifier`, comme le core : la clé commune
89
+ // (`cleDAppelDuFauxCore`), `{ par, pour, auteur?, sorte, phrase, chemin }`, un chemin sous l'app ;
90
+ // il les garde, à lire par `notificationsDuFauxCore`, et répond `{ notifiees }`. Avec
91
+ // `notifications: true`, la session porte le nombre de notifications reçues par la personne, comme
92
+ // celle du core.
93
+ export async function lancerLeFauxCore(t, sessions = {}, theme = {}, apps = [], annuaire, { notifications = false } = {}) {
73
94
  const jwk = JSON.stringify(clePubliqueDuFauxCore.export({ format: 'jwk' }));
74
95
  const servi = annuaire ?? {
75
96
  personnes: [...new Map(Object.values(sessions).map(({ id, nom, email }) => [id, { id, nom, email, active: true }])).values()],
76
97
  groupes: [],
77
98
  };
99
+ let adresse = '';
78
100
  const serveur = createServer((requete, reponse) => {
79
- if (requete.url === '/session' || requete.url === '/espace/session') {
101
+ if (requete.url === '/notifier' && requete.method === 'POST') {
102
+ void recevoirUneNotification(requete, reponse, adresse);
103
+ return;
104
+ }
105
+ if (requete.url === '/session' || requete.url === '/espace/session' || requete.url === '/espace/barre') {
80
106
  const personne = sessions[requete.headers.cookie ?? ''];
81
107
  const nom = theme.nom ?? 'Indos';
82
108
  reponse.writeHead(personne ? 200 : 401, { 'content-type': 'application/json' });
@@ -89,13 +115,20 @@ export async function lancerLeFauxCore(t, sessions = {}, theme = {}, apps = [],
89
115
  .filter((groupe) => ids.includes(groupe.id))
90
116
  .map(({ id, nom: nomDuGroupe }) => ({ id, nom: nomDuGroupe }))
91
117
  .sort((un, autre) => un.nom.localeCompare(autre.nom, 'fr'));
92
- const { apps: ouvertes, barre } = sessionDuCore(apps, personne.proprietaire, nom, ids);
118
+ const { apps: ouvertes, barre, rangement, accueil, elements } = sessionDuCore(apps, personne.proprietaire, nom, ids);
119
+ if (requete.url === '/espace/barre') {
120
+ reponse.end(JSON.stringify({ epingles: elements }));
121
+ return;
122
+ }
93
123
  reponse.end(JSON.stringify({
94
124
  ...personne,
95
125
  groupes,
96
126
  ...(apps.length ? { apps: ouvertes } : {}),
97
127
  barre,
128
+ rangement,
129
+ accueil,
98
130
  theme: { nom, logo: Boolean(theme.logo) },
131
+ ...(notifications ? { notifications: notificationsDuFauxCore(adresse, personne.id).length } : {}),
99
132
  }));
100
133
  return;
101
134
  }
@@ -113,7 +146,52 @@ export async function lancerLeFauxCore(t, sessions = {}, theme = {}, apps = [],
113
146
  }).listen(0, '127.0.0.1');
114
147
  t.after(() => serveur.close());
115
148
  await once(serveur, 'listening');
116
- return `http://127.0.0.1:${serveur.address().port}`;
149
+ adresse = `http://127.0.0.1:${serveur.address().port}`;
150
+ return adresse;
151
+ }
152
+ // La route `/notifier` du faux core.
153
+ async function recevoirUneNotification(requete, reponse, adresse) {
154
+ const repondre = (statut, corps) => {
155
+ reponse.writeHead(statut, { 'content-type': 'application/json' });
156
+ reponse.end(JSON.stringify(corps));
157
+ };
158
+ if (requete.headers.authorization !== `Bearer ${cleDAppelDuFauxCore}`) {
159
+ repondre(401, { erreur: 'La clé d\'appel est refusée.' });
160
+ return;
161
+ }
162
+ const morceaux = [];
163
+ for await (const morceau of requete) {
164
+ morceaux.push(morceau);
165
+ }
166
+ const corps = (() => {
167
+ try {
168
+ return JSON.parse(Buffer.concat(morceaux).toString('utf8'));
169
+ }
170
+ catch {
171
+ return {};
172
+ }
173
+ })();
174
+ const { par, pour, auteur, sorte, phrase, chemin } = corps;
175
+ if (typeof par !== 'string' || !par || !Array.isArray(pour) || !pour.length || !pour.every((id) => typeof id === 'string' && id) ||
176
+ (auteur !== undefined && typeof auteur !== 'string') || typeof sorte !== 'string' || !/^[a-z0-9_-]{1,40}$/.test(sorte) ||
177
+ typeof phrase !== 'string' || !phrase.trim() || typeof chemin !== 'string') {
178
+ repondre(400, { erreur: 'Il faut {"par", "pour", "auteur"?, "sorte", "phrase", "chemin"}.' });
179
+ return;
180
+ }
181
+ if (chemin !== `/${par}` && !chemin.startsWith(`/${par}/`)) {
182
+ repondre(400, { erreur: `Le chemin d'une notification est sous /${par}.` });
183
+ return;
184
+ }
185
+ const gardees = notificationsRecues.get(adresse) ?? [];
186
+ notificationsRecues.set(adresse, gardees);
187
+ let notifiees = 0;
188
+ for (const id of new Set(pour)) {
189
+ if (id !== auteur) {
190
+ gardees.push({ par, pour: id, ...(auteur ? { auteur } : {}), sorte, phrase: phrase.replace(/\s+/g, ' ').trim(), chemin });
191
+ notifiees += 1;
192
+ }
193
+ }
194
+ repondre(200, { notifiees });
117
195
  }
118
196
  // Une app à l'essai, servie comme `demarrerLApp` la sert derrière le proxy : sur un port libre de
119
197
  // 127.0.0.1, son chemin (`/<nom>`) retiré de chaque requête qui le porte, sauf là où `chemin` le
package/src/fichiers.d.ts CHANGED
@@ -37,6 +37,8 @@ export declare function telechargerUnFichier(fiche: Pick<Fiche, 'nom' | 'taille'
37
37
  export declare function prendreUnFichier(appeler: Appeler | undefined, personne: Personne, id: string, options: {
38
38
  plafond: number;
39
39
  app: string;
40
+ rien: string;
41
+ conseil?: string;
40
42
  }): Promise<{
41
43
  fiche: Fiche;
42
44
  octets: Buffer;
package/src/fichiers.js CHANGED
@@ -65,19 +65,21 @@ export async function telechargerUnFichier(fiche, lien) {
65
65
  // comptent à mesure qu'ils arrivent et la lecture se coupe au plafond, quoi que dise la fiche. Un
66
66
  // fichier plus gros que `plafond`, en octets, est un refus, qui dit la limite, levé tel quel ; un
67
67
  // refus de fichiers, ou un fichiers qui ne répond pas, un échec, qui dit que le reste de l'app marche
68
- // (`app`, ses choses au pluriel : « Le reste des documents marche. »).
68
+ // (`app`, ce qui suit « Le reste » : « Le reste des documents marche. », « du drive », « de Dropbox »).
69
+ // `rien` dit ce que le refus n'a pas fait (« Rien n'est posé », « déposé dans le drive »). `conseil`,
70
+ // facultatif, remplace la fin de la phrase du refus (« Le réduire, ou en choisir un plus léger. »).
69
71
  export async function prendreUnFichier(appeler, personne, id, options) {
70
- const echec = (erreur) => new Error(`Le fichier n'a pas pu être lu dans les fichiers : ${erreur.message.replace(/\.$/, '')}. Le reste des ${options.app} marche.`);
72
+ const echec = (erreur) => new Error(`Le fichier n'a pas pu être lu dans les fichiers : ${erreur.message.replace(/\.$/, '')}. Le reste ${options.app} marche.`);
71
73
  let demande;
72
74
  try {
73
75
  demande = await demanderUnFichier(appeler, personne, id);
74
76
  }
75
77
  catch (erreur) {
76
78
  // Un fichier que la personne ne voit pas est un refus de fichiers : un échec du geste.
77
- throw erreur instanceof RefusDeFichiers ? new Error(`Rien n'est posé : ${erreur.message}`) : echec(erreur);
79
+ throw erreur instanceof RefusDeFichiers ? new Error(`Rien n'est ${options.rien} : ${erreur.message}`) : echec(erreur);
78
80
  }
79
81
  const { fiche, lien } = demande;
80
- const trop = () => new Refus(`Rien n'est posé : « ${fiche.nom} » dépasse ${tailleLisible(options.plafond)}, la limite d'un fichier pris dans les fichiers. Le réduire, ou en choisir un plus léger.`);
82
+ const trop = () => new Refus(`Rien n'est ${options.rien} : « ${fiche.nom} » dépasse ${tailleLisible(options.plafond)}, la limite d'un fichier pris dans les fichiers. ${options.conseil ?? 'Le réduire, ou en choisir un plus léger.'}`);
81
83
  if (fiche.taille > options.plafond) {
82
84
  throw trop();
83
85
  }
package/src/flux.js CHANGED
@@ -1,5 +1,5 @@
1
1
  // Un flux d'événements envoyés par le serveur (`text/event-stream`), le même dans chaque app
2
- // (bibliotheque/CLAUDE.md, « Un flux d'événements ») : un commentaire et `retry` à l'ouverture, un
2
+ // (indos/bibliotheque/CLAUDE.md, « Un flux d'événements ») : un commentaire et `retry` à l'ouverture, un
3
3
  // battement qui garde la connexion ouverte au proxy, et la fermeture au bout de sa durée, d'un
4
4
  // lecteur trop lent et à l'arrêt de l'app. La page se reconnecte seule, `retry` après.
5
5
  // Un commentaire toutes les 25 secondes : le proxy de Coolify coupe une connexion muette à 90.
package/src/format.d.ts CHANGED
@@ -3,4 +3,7 @@ export declare function jour(quand: Quand | null | undefined): string;
3
3
  export declare function jourEtHeure(quand: Quand | null | undefined): string;
4
4
  export declare function tempsEcoule(quand: Quand, maintenant?: Date): string;
5
5
  export declare function nombre(valeur: number | string | null | undefined, decimales?: number): string;
6
+ export declare function masquerLesMontants(oui: boolean): void;
7
+ export declare function montantRond(valeur: number | string | null | undefined): string;
8
+ export declare function montantEnClair(valeur: number | string | null | undefined, devise?: string): string;
6
9
  export declare function montant(valeur: number | string | null | undefined, devise?: string): string;
package/src/format.js CHANGED
@@ -85,8 +85,27 @@ export function nombre(valeur, decimales = 0) {
85
85
  const signe = lu < 0 && Number(`${entiers}.${fraction ?? 0}`) !== 0 ? '-' : '';
86
86
  return `${signe}${milliers(entiers)}${fraction ? `.${fraction}` : ''}`;
87
87
  }
88
+ // Les montants masqués à l'écran, pour une démonstration : `montant` écrit « **** ». Seule la coquille
89
+ // de la page le pose (« Masquer les montants » du menu de la personne), jamais un serveur : un PDF, un
90
+ // refus d'un outil écrivent toujours le montant, et un geste le sien (`montantEnClair`). Un masque
91
+ // d'écran, pas une protection : les données arrivent entières dans la page.
92
+ let montantsMasques = false;
93
+ export function masquerLesMontants(oui) {
94
+ montantsMasques = oui;
95
+ }
96
+ // Un montant arrondi au franc, pour l'axe ou l'étiquette d'un graphique : « 12'400 », ou « **** »
97
+ // quand les montants sont masqués.
98
+ export function montantRond(valeur) {
99
+ return montantsMasques ? '****' : nombre(valeur);
100
+ }
101
+ // Un montant toujours en clair, masque ou non : celui d'un formulaire ou de la question d'un geste,
102
+ // que la personne relit avant d'agir.
103
+ export function montantEnClair(valeur, devise) {
104
+ const ecrit = nombre(valeur, 2);
105
+ return devise ? `${devise} ${ecrit}` : ecrit;
106
+ }
88
107
  // Un montant, à deux décimales : « 12'400.00 » ; avec sa devise devant : « CHF 12'400.00 ».
89
108
  export function montant(valeur, devise) {
90
- const ecrit = nombre(valeur, 2);
109
+ const ecrit = montantsMasques ? '****' : nombre(valeur, 2);
91
110
  return devise ? `${devise} ${ecrit}` : ecrit;
92
111
  }
@@ -1,6 +1,6 @@
1
1
  import { longueurDUnNom } from './presence.js';
2
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,
3
+ // (`@indos/bibliotheque/direct/page`), sans rien de Node ni du navigateur (indos/bibliotheque/CLAUDE.md,
4
4
  // « Le direct Yjs ») : son chemin, les raisons de ses refus, ses codes de fermeture et la présence
5
5
  // que le serveur écrit.
6
6
  // Le chemin du direct d'une chose, sous l'app : `direct/<id>`.
package/src/jeton.js CHANGED
@@ -1,8 +1,8 @@
1
1
  import { createPublicKey, verify } from 'node:crypto';
2
2
  export class JetonRefuse extends Error {
3
3
  }
4
- // Vérifie le jeton court que le core joint à chaque appel d'une app (docs/architecture.md, « Le
5
- // contrat entre le MCP et une app ») : un JWT signé en Ed25519, valable une minute, pour cette app.
4
+ // Vérifie le jeton court que le core joint à chaque appel d'une app (indos/bibliotheque/CLAUDE.md, « Le
5
+ // MCP d'une app ») : un JWT signé en Ed25519, valable une minute, pour cette app.
6
6
  // La clé publique vient du core, à CORE_ADRESSE ; elle reste en mémoire, et se relit quand une
7
7
  // signature échoue (le core a changé de clé), une fois par minute au plus.
8
8
  // `horloge` ne sert qu'aux tests.
package/src/liens.js CHANGED
@@ -1,6 +1,6 @@
1
1
  import { createHmac, timingSafeEqual } from 'node:crypto';
2
2
  import { deriver } from './deriver.js';
3
- // Les liens signés d'une app (bibliotheque/CLAUDE.md, « Les pièces ») : dix minutes, une charge
3
+ // Les liens signés d'une app (indos/bibliotheque/CLAUDE.md, « Les pièces ») : dix minutes, une charge
4
4
  // signée, une clé propre à chaque sorte, tirée de la clé de l'app ; rien n'est gardé en base.
5
5
  export const dureeDUnLien = 600;
6
6
  function cleDeLaSorte(cle, sorte) {
package/src/mcp.js CHANGED
@@ -4,7 +4,7 @@ import { AjvJsonSchemaValidator } from '@modelcontextprotocol/server/validators/
4
4
  import { creerLeVerificateur, JetonRefuse } from './jeton.js';
5
5
  import { repondreEnJson, traiterUnAppelDEcran } from './appel-d-ecran.js';
6
6
  import { creerLaSession } from './session.js';
7
- // Le refus d'un outil (docs/architecture.md, « Les règles communes ») : l'outil ne fait pas ce
7
+ // Le refus d'un outil (indos/bibliotheque/CLAUDE.md, « Un refus ») : l'outil ne fait pas ce
8
8
  // qu'on lui demande, parce que l'accord de la personne manque (`confirmer`), qu'elle n'y a pas
9
9
  // droit, ou que la donnée est refusée. Levé dans `executer`, il rend une erreur d'outil marquée
10
10
  // `_meta['indos/refus']`, avec son texte tel quel : le core l'écrit refusée au journal.
@@ -12,7 +12,7 @@ export class Refus extends Error {
12
12
  }
13
13
  // Le MCP d'une app, sur /mcp : Streamable HTTP sans état, MCP standard, par le SDK officiel.
14
14
  // Chaque requête porte le jeton court du core ; l'app ne montre et n'exécute que les outils
15
- // auxquels la personne a droit (docs/architecture.md, « Le contrat entre le MCP et une app »).
15
+ // auxquels la personne a droit (indos/bibliotheque/CLAUDE.md, « Le MCP d'une app »).
16
16
  // Les instructions sont le texte d'usage de l'app. Le même traitement sert les outils aux écrans
17
17
  // de l'app, dans le navigateur, avec la session de la personne : `POST /outils/<nom>`. `adresse`
18
18
  // est l'adresse publique de l'app (ADRESSE), dont l'origine est la seule que l'appel admet.
@@ -58,7 +58,7 @@ export function creerLeMcp(options) {
58
58
  return serveur;
59
59
  }));
60
60
  // `POST /outils/<nom>` : l'appel d'un outil par un écran de l'app, pour la personne connectée au
61
- // core (docs/architecture.md, « L'espace et les réglages »), par les règles d'un geste d'écran
61
+ // core (indos/bibliotheque/CLAUDE.md, « Un écran appelle ses outils »), par les règles d'un geste d'écran
62
62
  // (`traiterUnAppelDEcran`) : la méthode (405), l'origine de l'app, avant tout appel au core (403),
63
63
  // la session (401), l'app ouverte à la personne, parmi les apps de sa session (403), un corps en
64
64
  // JSON (415), de 4 Mio au plus (413), un objet (400) ; puis l'outil, avec ses droits et ses refus,
@@ -0,0 +1,10 @@
1
+ export type Notification = {
2
+ pour: string[];
3
+ auteur?: string;
4
+ sorte: string;
5
+ phrase: string;
6
+ chemin: string;
7
+ };
8
+ export type Notifier = ReturnType<typeof creerLeNotificateur>;
9
+ export declare const delaiDUneNotification = 3000;
10
+ export declare function creerLeNotificateur(par: string, adresseDuCore?: string | undefined, cle?: string | undefined): ({ pour, auteur, sorte, phrase, chemin }: Notification) => Promise<number>;
@@ -0,0 +1,47 @@
1
+ // Une app notifie des personnes de ce qu'un autre a fait et qui les concerne
2
+ // (indos/bibliotheque/CLAUDE.md, « Les notifications »). La notification part au core, qui l'écrit et la
3
+ // montre dans l'écran « Notifications » et par la cloche de la barre.
4
+ // Le délai laissé au core pour répondre, en millisecondes.
5
+ export const delaiDUneNotification = 3_000;
6
+ // La notification d'une app, vers le core (`CORE_ADRESSE/notifier`), avec la clé commune des apps
7
+ // (`CLE_D_APPEL`, que le kit passe à toute app dont le compose la cite). `par` est le nom de l'app.
8
+ //
9
+ // `notifier` part après l'écriture validée, jamais dans une transaction, une seule fois, sans nouvel
10
+ // essai, et ne lève jamais : un core sans la route, en erreur ou muet au-delà du délai, et une app
11
+ // sans la clé donnent le même résultat, rien, écrit au journal de l'app (l'app, la sorte et
12
+ // l'identifiant des personnes, jamais leur adresse ni la phrase). Elle rend le nombre de personnes
13
+ // notifiées, 0 sans notification.
14
+ export function creerLeNotificateur(par, adresseDuCore = process.env.CORE_ADRESSE, cle = process.env.CLE_D_APPEL) {
15
+ return async function notifier({ pour, auteur, sorte, phrase, chemin }) {
16
+ const destinataires = [...new Set(pour)].filter((id) => id !== auteur);
17
+ if (!destinataires.length) {
18
+ return 0;
19
+ }
20
+ const echec = (raison) => {
21
+ console.error(`La notification n'est pas partie : app ${par}, sorte ${sorte}, personnes ${destinataires.join(', ')} : ${raison}.`);
22
+ return 0;
23
+ };
24
+ if (!adresseDuCore) {
25
+ return echec('CORE_ADRESSE manque');
26
+ }
27
+ if (!cle) {
28
+ return echec('CLE_D_APPEL manque, le compose de l\'app doit la citer');
29
+ }
30
+ try {
31
+ const reponse = await fetch(new URL('/notifier', adresseDuCore), {
32
+ method: 'POST',
33
+ headers: { authorization: `Bearer ${cle}`, 'content-type': 'application/json' },
34
+ body: JSON.stringify({ par, pour: destinataires, ...(auteur ? { auteur } : {}), sorte, phrase, chemin }),
35
+ signal: AbortSignal.timeout(delaiDUneNotification),
36
+ });
37
+ if (!reponse.ok) {
38
+ return echec(`le core répond ${reponse.status}`);
39
+ }
40
+ const { notifiees } = (await reponse.json().catch(() => ({})));
41
+ return typeof notifiees === 'number' ? notifiees : 0;
42
+ }
43
+ catch (erreur) {
44
+ return echec(erreur.name === 'TimeoutError' ? 'le core ne répond pas à temps' : 'le core est injoignable');
45
+ }
46
+ };
47
+ }
package/src/page.d.ts CHANGED
@@ -15,6 +15,23 @@ export declare function servirLaPage(options: {
15
15
  cadre?: string;
16
16
  entetes?: Record<string, string>;
17
17
  }): (requete: IncomingMessage, reponse: ServerResponse, chemin: string) => Promise<void>;
18
+ export type SourcesDeLaPagePublique = Partial<Record<'script-src' | 'font-src' | 'img-src' | 'connect-src', string[]>>;
19
+ export declare function entetesDeLaPagePublique(adresseDuCore: string, sources?: SourcesDeLaPagePublique): Record<string, string>;
20
+ export declare function servirLHotePublic(options: {
21
+ dist: string | URL;
22
+ adresse: string;
23
+ balise: string;
24
+ publiee: (id: string) => Promise<object | undefined>;
25
+ introuvable: {
26
+ titre: string;
27
+ texte: string;
28
+ };
29
+ sources?: SourcesDeLaPagePublique;
30
+ lectures?: (requete: IncomingMessage, reponse: ServerResponse, chemin: string) => Promise<boolean>;
31
+ }): {
32
+ traiter: (requete: IncomingMessage, reponse: ServerResponse) => Promise<void>;
33
+ introuvable: (requete: IncomingMessage, reponse: ServerResponse) => void;
34
+ };
18
35
  export declare function traiterUnGesteDEcran<P>(requete: IncomingMessage, reponse: ServerResponse, options: {
19
36
  origine: string;
20
37
  personneDe: (requete: IncomingMessage) => Promise<P | 'fermee' | undefined>;
package/src/page.js CHANGED
@@ -2,12 +2,12 @@ import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
2
2
  import { extname, join } from 'node:path';
3
3
  import { fileURLToPath } from 'node:url';
4
4
  import { traiterUnAppelDEcran } from './appel-d-ecran.js';
5
- import { echapper, entetesDeLEspace, envoyerLaPage, pageSimple } from './ecran.js';
5
+ import { echapper, entetesDeLEspace, envoyerLaPage, pageDAuth, pageSimple } from './ecran.js';
6
6
  import { identifiant } from './identifiant.js';
7
7
  import { Refus } from './mcp.js';
8
8
  import { creerLaSession } from './session.js';
9
- // La page de l'espace d'une pièce, le core ou une app (docs/architecture.md, « L'espace et les
10
- // réglages ») : une page en React, construite par Vite dans son dossier `dist/`, que sert la pièce
9
+ // La page de l'espace d'une pièce, le core ou une app (indos/bibliotheque/CLAUDE.md, « La page
10
+ // de l'espace ») : une page en React, construite par Vite dans son dossier `dist/`, que sert la pièce
11
11
  // elle-même. `dist/index.html` est la page ; ses fichiers, nommés par leur empreinte, sont sous
12
12
  // `dist/espace/`, et la page les cite sous `<base>espace/…`.
13
13
  // Le nombre de lignes d'une page d'une liste : un geste ou un outil paginé reçoit `page`, un entier
@@ -77,18 +77,9 @@ export function servirLaPage(options) {
77
77
  const lecture = requete.method === 'GET';
78
78
  const demande = chemin.split('?')[0];
79
79
  if (demande === '/espace' || demande.startsWith('/espace/')) {
80
- const fichier = fichiers.get(demande.slice('/espace/'.length));
81
- if (!fichier) {
80
+ if (!envoyerUnFichier(fichiers, demande.slice('/espace/'.length), requete, reponse)) {
82
81
  envoyerLaPage(reponse, 404, pageSimple('Introuvable', 'Cette page n\'existe pas.'));
83
- return;
84
82
  }
85
- reponse.writeHead(200, {
86
- 'content-type': fichier.type,
87
- 'content-length': String(fichier.octets.length),
88
- 'cache-control': 'public, max-age=31536000, immutable',
89
- 'x-content-type-options': 'nosniff',
90
- });
91
- reponse.end(lecture ? fichier.octets : undefined);
92
83
  return;
93
84
  }
94
85
  const ecrite = 'sessionDe' in session;
@@ -102,6 +93,140 @@ export function servirLaPage(options) {
102
93
  reponse.end(lecture ? octets : undefined);
103
94
  };
104
95
  }
96
+ // Un fichier construit, gardé un an par le navigateur : son nom change avec son contenu. Faux pour
97
+ // un fichier absent, que l'appelant répond.
98
+ function envoyerUnFichier(fichiers, nom, requete, reponse) {
99
+ const fichier = fichiers.get(nom);
100
+ if (!fichier) {
101
+ return false;
102
+ }
103
+ reponse.writeHead(200, {
104
+ 'content-type': fichier.type,
105
+ 'content-length': String(fichier.octets.length),
106
+ 'cache-control': 'public, max-age=31536000, immutable',
107
+ 'x-content-type-options': 'nosniff',
108
+ });
109
+ reponse.end(requete.method === 'HEAD' ? undefined : fichier.octets);
110
+ return true;
111
+ }
112
+ // Les en-têtes de la page publique d'une app (« L'hôte public d'une app ») : ses scripts, ses
113
+ // fichiers et ce qu'elle lit sont ceux de l'hôte public (`'self'`), le direct compris ; le thème et
114
+ // ses polices, ceux du core, sous `/theme/` de son adresse publique, `adresseDuCore`. Aucun cadre,
115
+ // aucun formulaire ; la page ne s'ouvre dans le cadre d'aucun site, une fenêtre qu'elle ouvre ne la
116
+ // pilote pas, un lien qu'on suit depuis elle ne dit pas d'où il vient, et rien ne se garde en cache.
117
+ // Une source qui porterait une espace, une virgule ou un point-virgule lève une erreur.
118
+ export function entetesDeLaPagePublique(adresseDuCore, sources = {}) {
119
+ for (const source of Object.values(sources).flat()) {
120
+ if (!/^[^\s;,]+$/.test(source)) {
121
+ throw new Error(`Une source de la politique est une seule source, sans espace, virgule ni point-virgule : ${JSON.stringify(source)}.`);
122
+ }
123
+ }
124
+ const theme = `${adresseDuCore}/theme/`;
125
+ const politique = [
126
+ ['default-src', '\'none\''],
127
+ ['script-src', '\'self\'', ...(sources['script-src'] ?? [])],
128
+ ['style-src', '\'self\'', '\'unsafe-inline\'', theme],
129
+ ['font-src', '\'self\'', ...(sources['font-src'] ?? []), theme],
130
+ ['img-src', '\'self\'', 'data:', ...(sources['img-src'] ?? []), theme],
131
+ ['connect-src', '\'self\'', ...(sources['connect-src'] ?? [])],
132
+ ['form-action', '\'none\''],
133
+ ['base-uri', '\'none\''],
134
+ ['frame-ancestors', '\'none\''],
135
+ ].map((directive) => directive.join(' ')).join('; ');
136
+ return {
137
+ 'content-type': 'text/html; charset=utf-8',
138
+ 'content-security-policy': politique,
139
+ 'cross-origin-opener-policy': 'same-origin',
140
+ 'referrer-policy': 'no-referrer',
141
+ 'x-content-type-options': 'nosniff',
142
+ 'cache-control': 'no-store',
143
+ };
144
+ }
145
+ // L'hôte public d'une app (indos/bibliotheque/CLAUDE.md, « L'hôte public d'une app ») : ce qu'un visiteur
146
+ // sans compte lit d'une chose publiée, sur l'hôte que la session du core n'atteint pas et où le
147
+ // chemin de l'app ne se retire pas. Il rend `traiter(requete, reponse)`, à qui l'app confie chaque
148
+ // requête de cet hôte, et `introuvable(requete, reponse)`, sa réponse à tout ce qui n'y est pas.
149
+ // Seuls `GET` et `HEAD` y sont servis :
150
+ // - `/<id>`, l'identifiant un UUID : la page de l'espace construite, sans session, avec ce que rend
151
+ // `publiee(id)` dans une balise de sa tête (`<meta name="<balise>">`, son JSON échappé), en 200 ;
152
+ // rien, pour une chose absente ou qui n'est pas publiée, et la page introuvable ;
153
+ // - ce que `lectures(requete, reponse, chemin)` sert, s'il rend vrai : les autres lectures de l'app,
154
+ // comme les images d'une chose publiée ;
155
+ // - `<chemin de l'app>/espace/<fichier>` : un fichier de la page construite, d'où elle les cite ;
156
+ // - `/theme/variables.css` : le thème du core, clair et sombre, importé de son adresse publique ;
157
+ // le reste de `/theme/` (la feuille de la page introuvable, les polices, le logo), un renvoi vers
158
+ // le core ;
159
+ // - tout le reste, une autre méthode comprise : la page introuvable, en 404, la même pour une chose
160
+ // absente, fermée ou une adresse inconnue : une page sans script, à la forme de la page simple,
161
+ // sans le retour à un accueil que le visiteur n'a pas.
162
+ // L'adresse publique du core est l'origine d'`adresse` (ADRESSE). Sans `dist/index.html`, l'app ne
163
+ // démarre pas.
164
+ export function servirLHotePublic(options) {
165
+ if (!/^[a-z][a-z0-9-]*$/.test(options.balise)) {
166
+ throw new Error(`Le nom de la balise s'écrit en minuscules, chiffres et tirets : ${JSON.stringify(options.balise)}.`);
167
+ }
168
+ const dossier = typeof options.dist === 'string' ? options.dist : fileURLToPath(options.dist);
169
+ const index = join(dossier, 'index.html');
170
+ if (!existsSync(index)) {
171
+ throw new Error(`La page n'est pas construite : ${index} manque (npm run build).`);
172
+ }
173
+ const page = readFileSync(index, 'utf8');
174
+ const fin = page.search(/<\/head>/i);
175
+ if (fin === -1) {
176
+ throw new Error(`La page n'a pas de tête : ${index}.`);
177
+ }
178
+ const [debut, suite] = [page.slice(0, fin), page.slice(fin)];
179
+ const fichiers = lireLesFichiers(join(dossier, 'espace'));
180
+ const { origin: adresseDuCore, pathname } = new URL(options.adresse);
181
+ const espace = `${pathname.replace(/\/$/, '')}/espace/`;
182
+ const entetes = entetesDeLaPagePublique(adresseDuCore, options.sources);
183
+ const absente = Buffer.from(pageDAuth({ titre: options.introuvable.titre, sousTitre: options.introuvable.texte, corps: '' }));
184
+ function envoyer(requete, reponse, statut, octets) {
185
+ reponse.writeHead(statut, { ...entetes, 'content-length': String(octets.length) });
186
+ reponse.end(requete.method === 'HEAD' ? undefined : octets);
187
+ }
188
+ function introuvable(requete, reponse) {
189
+ envoyer(requete, reponse, 404, absente);
190
+ }
191
+ async function traiter(requete, reponse) {
192
+ const adresse = new URL(requete.url ?? '/', 'http://hote-public');
193
+ const chemin = adresse.pathname;
194
+ const [, segment] = /^\/([^/]+)$/.exec(chemin) ?? [];
195
+ const id = identifiant(segment);
196
+ if (requete.method !== 'GET' && requete.method !== 'HEAD') {
197
+ introuvable(requete, reponse);
198
+ }
199
+ else if (id) {
200
+ const publie = await options.publiee(id);
201
+ if (publie) {
202
+ envoyer(requete, reponse, 200, Buffer.from(`${debut}<meta name="${options.balise}" content="${echapper(JSON.stringify(publie))}">${suite}`));
203
+ }
204
+ else {
205
+ introuvable(requete, reponse);
206
+ }
207
+ }
208
+ else if (options.lectures && await options.lectures(requete, reponse, chemin)) {
209
+ // Une lecture de l'app.
210
+ }
211
+ else if (chemin.startsWith(espace)) {
212
+ if (!envoyerUnFichier(fichiers, chemin.slice(espace.length), requete, reponse)) {
213
+ introuvable(requete, reponse);
214
+ }
215
+ }
216
+ else if (chemin === '/theme/variables.css') {
217
+ reponse.writeHead(200, { 'content-type': 'text/css; charset=utf-8', 'cache-control': 'max-age=60', 'x-content-type-options': 'nosniff' });
218
+ reponse.end(requete.method === 'HEAD' ? undefined : `@import url("${adresseDuCore}/theme/variables.css");\n`);
219
+ }
220
+ else if (chemin.startsWith('/theme/')) {
221
+ reponse.writeHead(302, { location: `${adresseDuCore}${chemin}${adresse.search}`, 'cache-control': 'max-age=60' });
222
+ reponse.end();
223
+ }
224
+ else {
225
+ introuvable(requete, reponse);
226
+ }
227
+ }
228
+ return { traiter, introuvable };
229
+ }
105
230
  // Les fichiers construits sous `dist/espace/`, par leur chemin sous ce dossier.
106
231
  function lireLesFichiers(dossier) {
107
232
  const fichiers = new Map();
@@ -117,7 +242,7 @@ function lireLesFichiers(dossier) {
117
242
  return fichiers;
118
243
  }
119
244
  // Un geste d'écran : un appel de la page de l'espace à sa pièce, en JSON, pour un geste que Claude
120
- // ne doit pas voir (docs/architecture.md, « Les règles communes »). Les règles d'un appel d'écran
245
+ // ne doit pas voir (indos/bibliotheque/CLAUDE.md, « Les gestes d'écran »). Les règles d'un appel d'écran
121
246
  // (`traiterUnAppelDEcran`) : `POST` (405), l'origine de la page, `origine` (403), la personne que
122
247
  // rend `personneDe` (401, 403 pour une app fermée, 503 si le core ne répond pas), un objet JSON de
123
248
  // 4 Mio au plus (415, 413, 400). Puis `executer` : sa valeur en 200 (`{}` pour rien) ; un `Refus`
package/src/partage.d.ts CHANGED
@@ -73,8 +73,12 @@ export type OptionsDuPartage = {
73
73
  avec: 'equipe';
74
74
  droit: Droit;
75
75
  };
76
- auProprietaireDuServeur?: Droit;
76
+ auProprietaireDeLOS?: Droit;
77
77
  publication?: string;
78
+ auDepart?: string;
79
+ chemin?: (id: string) => string;
80
+ cleDAppel?: string;
81
+ sansNom?: string;
78
82
  };
79
83
  export declare function creerLePartage(options: OptionsDuPartage): {
80
84
  pourLaPersonne: (personne: Personne, { alias, depuis }?: {