@indos/bibliotheque 4.4.0 → 4.5.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.
- package/CLAUDE.md +3 -3
- package/manifeste.json +1 -1
- package/package.json +1 -1
- package/src/appeler.js +2 -2
- package/src/faux-core.d.ts +1 -0
- package/src/faux-core.js +36 -6
- package/src/notifier.js +1 -1
- package/src/partage.d.ts +1 -1
- package/src/partage.js +7 -6
package/CLAUDE.md
CHANGED
|
@@ -26,7 +26,7 @@ Le dossier de l'app porte :
|
|
|
26
26
|
- `DOCUMENTATION.md`, facultatif : pour la personne, rendu à `/documentation/<nom>` en Markdown restreint (`##`, `###`, paragraphes, listes, étapes, gras, code, liens).
|
|
27
27
|
- `logo.svg`, facultatif : 24×24, l'objet en graphite `currentColor`, en formes simples, le geste de l'agent tracé à la main au jaune `#F0B429` (entouré, coche, gribouillis, souligné, flèche), le même geste pour une même fonction. Sans logo, la carte porte l'initiale du titre.
|
|
28
28
|
|
|
29
|
-
Une app écoute sur `PORT`, répond 200 sur `GET /sante`, s'arrête en huit secondes au plus sur `docker stop`, et garde tout dans sa base ou au bucket de l'OS, sans volume. Elle reçoit `DATABASE_URL`, `CLE` (32 octets en base64), `ADRESSE` (`https://<domaine>/<nom>`), `CORE_ADRESSE` et `CLE_D_APPEL
|
|
29
|
+
Une app écoute sur `PORT`, répond 200 sur `GET /sante`, s'arrête en huit secondes au plus sur `docker stop`, et garde tout dans sa base ou au bucket de l'OS, sans volume. Elle reçoit `DATABASE_URL`, `CLE` (32 octets en base64), `ADRESSE` (`https://<domaine>/<nom>`), `CORE_ADRESSE` et `CLE_D_APPEL`, sa clé d'appel, que la bibliothèque transmet telle quelle au core (`Bearer <CLE_D_APPEL>`) pour appeler, notifier et lire l'annuaire.
|
|
30
30
|
|
|
31
31
|
Ce que le kit lit d'une app du client, au commit publié et poussé, jamais depuis les fichiers du poste : son `manifeste.json`, son `logo.svg`, sa `DOCUMENTATION.md`, et l'image que la CI de son dépôt a poussée pour ce commit. Il refuse un manifeste dont le `nom` n'est pas celui de l'app ou qui déclare `sousDomaine`, et une image sans `HEALTHCHECK` ou qui n'expose pas un seul port.
|
|
32
32
|
|
|
@@ -160,7 +160,7 @@ Une chose est toujours à une personne et s'ouvre à des personnes, à des group
|
|
|
160
160
|
- `chercher` donne le cœur de l'outil `chercher` : vues `toutes`, `a_moi`, `partagees`, et `publiees` avec `publication` (`schemaDeChercher`). `pourLaPersonne` sert une requête que l'app écrit elle-même.
|
|
161
161
|
- `ouvrirALaCreation(client, id)` s'appelle à chaque création, juste après l'`insert`, dans la transaction.
|
|
162
162
|
- `partager`, `ne_plus_partager` et `donner` sont au propriétaire de la chose seul, même face à qui a la modification ou possède l'OS. Un partage qui s'élargit (une cible nouvelle, la lecture qui passe en modification) et un don demandent `confirmer: true`. Sans cible, ils refusent.
|
|
163
|
-
- Les cibles se cherchent dans l'annuaire du core, gardé cinq secondes : une personne ou un groupe inconnu, une personne désactivée ou soi-même sont refusés. Aucun droit ne se décide sur l'annuaire gardé : le don des choses d'une personne désactivée et le droit d'un lien signé le relisent sans cache.
|
|
163
|
+
- Les cibles se cherchent dans l'annuaire du core, lu avec la clé d'appel de l'app quand elle l'a et gardé cinq secondes : une personne ou un groupe inconnu, une personne désactivée ou soi-même sont refusés. Aucun droit ne se décide sur l'annuaire gardé : le don des choses d'une personne désactivée et le droit d'un lien signé le relisent sans cache.
|
|
164
164
|
- Une chose rangée dans une autre (`racine`) n'a pas de propriétaire à elle : son droit se lit sur sa racine, et elle ne se donne pas.
|
|
165
165
|
- `donner_les_choses`, au propriétaire de l'OS seul, est `outilDeDonnerLesChoses(partage, { apresUnDon })`, le même dans chaque app : toutes les choses d'une personne désactivée passent à une personne active, racines seules.
|
|
166
166
|
- Après un partage, un don ou une publication, l'outil relit ce qui en dépend (le droit des connexions en direct).
|
|
@@ -356,7 +356,7 @@ Chaque écran prend de la bibliothèque ce qui se dessine pareil partout. Quatre
|
|
|
356
356
|
Les tests de chaque app reposent sur ces aides ; ce qui reste dans ses tests lui est propre.
|
|
357
357
|
|
|
358
358
|
- Node :
|
|
359
|
-
- `lancerLeFauxCore` : sessions, annuaire, apps déclarées, notifications, `fabriquerUnJeton`. Une app qu'il ne déclare pas est fermée à tous, comme au core : le test d'une app qui reconnaît la personne à sa session (une page, un geste d'écran, `POST /outils`) la déclare.
|
|
359
|
+
- `lancerLeFauxCore` : sessions, annuaire, apps déclarées, notifications, `fabriquerUnJeton`. Il reconnaît la clé d'une app, `fabriquerUneCleDAppel(app)`, sous laquelle l'app notifie sous son seul nom, et la clé commune, `cleDAppelDuFauxCore` ; il sert l'annuaire sans clé ou sous l'une d'elles. Une app qu'il ne déclare pas est fermée à tous, comme au core : le test d'une app qui reconnaît la personne à sa session (une page, un geste d'écran, `POST /outils`) la déclare.
|
|
360
360
|
- `ouvrirLaBaseDUnTest(t, migrations)` : la base d'un test, PGlite jointe par un pool d'une connexion, ses migrations appliquées, fermée à la fin du test. `ouvrirUneBaseDEssai` rend la base seule, à un test qui ouvre ses connexions lui-même (`ouvrirLaBase(adresse, 1)`).
|
|
361
361
|
- `servirLApp`, `connecter` (un client MCP, comme le core qui relaie Claude), `appeler` (rend `{ erreur, refus, texte, json }`).
|
|
362
362
|
- Page, dans jsdom (Vitest) : `sessionDEssai`, `appDEssai`, `servir(routes)` à la place de `fetch`, `ouvrirLaPage`, `testerLEcranDesComptes`. Un test choisit dans un `Choix` par un clic sur le `combobox`, puis sur l'`option`.
|
package/manifeste.json
CHANGED
package/package.json
CHANGED
package/src/appeler.js
CHANGED
|
@@ -5,8 +5,8 @@ export function estUnRefus(resultat) {
|
|
|
5
5
|
return resultat.isError === true && resultat._meta?.['indos/refus'] === true;
|
|
6
6
|
}
|
|
7
7
|
// L'appel d'une app à l'outil d'une autre, pour une personne, par le core (bibliotheque/CLAUDE.md,
|
|
8
|
-
// « Les entrées de la bibliothèque »). `par` est le nom de l'app qui appelle ; le kit passe
|
|
9
|
-
// CLE_D_APPEL à toute app dont le compose la cite. Le résultat est celui de l'outil, refus compris ; une erreur ne vient que
|
|
8
|
+
// « Les entrées de la bibliothèque »). `par` est le nom de l'app qui appelle ; le kit passe sa clé d'appel dans
|
|
9
|
+
// CLE_D_APPEL à toute app dont le compose la cite, transmise telle quelle au core. Le résultat est celui de l'outil, refus compris ; une erreur ne vient que
|
|
10
10
|
// d'un appel que le core refuse (clé, personne ou app inconnue) ou qui n'aboutit pas.
|
|
11
11
|
export function creerLAppel(par, adresseDuCore = process.env.CORE_ADRESSE, cle = process.env.CLE_D_APPEL) {
|
|
12
12
|
return async function appeler(app, outil, arguments_, personne) {
|
package/src/faux-core.d.ts
CHANGED
|
@@ -10,6 +10,7 @@ export declare const cleDuFauxCore: KeyObject, clePubliqueDuFauxCore: KeyObject;
|
|
|
10
10
|
export declare function fabriquerUnJeton(personne: Personne, app: string, cle?: KeyObject): string;
|
|
11
11
|
export declare const logoDEssai = "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 10 10\"><rect width=\"10\" height=\"10\"/></svg>";
|
|
12
12
|
export declare const cleDAppelDuFauxCore = "cle-d-appel-du-faux-core";
|
|
13
|
+
export declare function fabriquerUneCleDAppel(app: string): string;
|
|
13
14
|
export type NotificationRecue = {
|
|
14
15
|
par: string;
|
|
15
16
|
pour: string;
|
package/src/faux-core.js
CHANGED
|
@@ -3,6 +3,7 @@ import { once } from 'node:events';
|
|
|
3
3
|
import { createServer } from 'node:http';
|
|
4
4
|
import { Client, StreamableHTTPClientTransport } from '@modelcontextprotocol/client';
|
|
5
5
|
import { creerLeServeur } from './app.js';
|
|
6
|
+
import { deriver } from './deriver.js';
|
|
6
7
|
import { sansLeChemin } from './sans-le-chemin.js';
|
|
7
8
|
// Un faux core pour les tests des apps : il sert sa clé publique et signe des jetons, fabriqués
|
|
8
9
|
// ici à la main, sans le code du core.
|
|
@@ -19,9 +20,27 @@ export function fabriquerUnJeton(personne, app, cle = cleDuFauxCore) {
|
|
|
19
20
|
}
|
|
20
21
|
// Un logo d'essai, à donner au faux core.
|
|
21
22
|
export const logoDEssai = '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 10 10"><rect width="10" height="10"/></svg>';
|
|
22
|
-
// La clé commune des apps que le faux core
|
|
23
|
-
// (`creerLeNotificateur(par, adresse, cleDAppelDuFauxCore)`, ou `CLE_D_APPEL`)
|
|
23
|
+
// La clé commune des apps que le faux core reconnaît à `/notifier` et à `/annuaire`, que le test
|
|
24
|
+
// donne à l'app (`creerLeNotificateur(par, adresse, cleDAppelDuFauxCore)`, ou `CLE_D_APPEL`) : l'app
|
|
25
|
+
// y notifie sous le nom qu'elle se donne.
|
|
24
26
|
export const cleDAppelDuFauxCore = 'cle-d-appel-du-faux-core';
|
|
27
|
+
// La clé maître du faux core, dont dérive la clé d'appel de chaque app.
|
|
28
|
+
const cleMaitreDuFauxCore = Buffer.alloc(32, 9);
|
|
29
|
+
// La clé d'appel d'une app, dans la forme que le kit écrit dans `CLE_D_APPEL` : `<app>.<clé>`, la
|
|
30
|
+
// clé `deriver(clé du core, "appel/<app>")` en base64, ici celle du faux core. Avec elle, l'app
|
|
31
|
+
// notifie sous son seul nom.
|
|
32
|
+
export function fabriquerUneCleDAppel(app) {
|
|
33
|
+
return `${app}.${deriver(cleMaitreDuFauxCore, `appel/${app}`).toString('base64')}`;
|
|
34
|
+
}
|
|
35
|
+
// Qui appelle le faux core, d'après l'en-tête `Authorization`, comme au core : l'app que nomme sa
|
|
36
|
+
// clé, la clé commune, ou rien.
|
|
37
|
+
function quiAppelle(entete) {
|
|
38
|
+
if (entete === `Bearer ${cleDAppelDuFauxCore}`) {
|
|
39
|
+
return { commune: true };
|
|
40
|
+
}
|
|
41
|
+
const app = /^Bearer ([a-z0-9]+(?:-[a-z0-9]+)*)\./.exec(entete ?? '')?.[1];
|
|
42
|
+
return app && entete === `Bearer ${fabriquerUneCleDAppel(app)}` ? { app } : undefined;
|
|
43
|
+
}
|
|
25
44
|
const notificationsRecues = new Map();
|
|
26
45
|
// Les notifications qu'a reçues le faux core d'`adresse` (celle que rend `lancerLeFauxCore`), dans
|
|
27
46
|
// l'ordre d'arrivée, une par personne, de `pour` seulement quand il est donné.
|
|
@@ -80,13 +99,14 @@ export function sessionDuCore(apps, proprietaire, nomDeLOS, groupes = []) {
|
|
|
80
99
|
// déclare pas est fermée à tous, comme au core : le test d'une app qui reconnaît la personne à sa
|
|
81
100
|
// session (une page, un geste d'écran, `POST /outils`) la déclare.
|
|
82
101
|
// Il sert l'annuaire (`GET /annuaire`) : `annuaire`, ou, sans lui, les personnes des sessions,
|
|
83
|
-
// actives, sans groupe
|
|
102
|
+
// actives, sans groupe ; sans en-tête `Authorization`, ou avec la clé d'une app
|
|
103
|
+
// (`fabriquerUneCleDAppel`) ou la clé commune (`cleDAppelDuFauxCore`), 401 avec une autre. L'annuaire est tenu par référence et relu à chaque requête : un test qui
|
|
84
104
|
// retire un membre d'un groupe ou désactive une personne en cours de route, sur l'objet qu'il a
|
|
85
105
|
// passé, le voit à l'appel suivant.
|
|
86
106
|
// Il sert `theme.logo` sur `/theme/logo.svg`, lu à chaque requête (un test le change en cours de
|
|
87
107
|
// route), ou 404 sans logo.
|
|
88
|
-
// Il reçoit les notifications des apps à `POST /notifier`, comme le core : la clé
|
|
89
|
-
// (
|
|
108
|
+
// Il reçoit les notifications des apps à `POST /notifier`, comme le core : la clé d'une app, `par`
|
|
109
|
+
// étant son nom (401 sinon), ou la clé commune ; `{ par, pour, auteur?, sorte, phrase, chemin }`, un chemin sous l'app ;
|
|
90
110
|
// il les garde, à lire par `notificationsDuFauxCore`, et répond `{ notifiees }`. Avec
|
|
91
111
|
// `notifications: true`, la session porte le nombre de notifications reçues par la personne, comme
|
|
92
112
|
// celle du core.
|
|
@@ -133,6 +153,11 @@ export async function lancerLeFauxCore(t, sessions = {}, theme = {}, apps = [],
|
|
|
133
153
|
return;
|
|
134
154
|
}
|
|
135
155
|
if (requete.url === '/annuaire') {
|
|
156
|
+
if (requete.headers.authorization !== undefined && !quiAppelle(requete.headers.authorization)) {
|
|
157
|
+
reponse.writeHead(401, { 'content-type': 'application/json' });
|
|
158
|
+
reponse.end(JSON.stringify({ erreur: 'La clé d\'appel ne convient pas.' }));
|
|
159
|
+
return;
|
|
160
|
+
}
|
|
136
161
|
reponse.writeHead(200, { 'content-type': 'application/json' });
|
|
137
162
|
reponse.end(JSON.stringify(servi));
|
|
138
163
|
return;
|
|
@@ -155,7 +180,8 @@ async function recevoirUneNotification(requete, reponse, adresse) {
|
|
|
155
180
|
reponse.writeHead(statut, { 'content-type': 'application/json' });
|
|
156
181
|
reponse.end(JSON.stringify(corps));
|
|
157
182
|
};
|
|
158
|
-
|
|
183
|
+
const appelant = quiAppelle(requete.headers.authorization);
|
|
184
|
+
if (!appelant) {
|
|
159
185
|
repondre(401, { erreur: 'La clé d\'appel est refusée.' });
|
|
160
186
|
return;
|
|
161
187
|
}
|
|
@@ -178,6 +204,10 @@ async function recevoirUneNotification(requete, reponse, adresse) {
|
|
|
178
204
|
repondre(400, { erreur: 'Il faut {"par", "pour", "auteur"?, "sorte", "phrase", "chemin"}.' });
|
|
179
205
|
return;
|
|
180
206
|
}
|
|
207
|
+
if ('app' in appelant && par !== appelant.app) {
|
|
208
|
+
repondre(401, { erreur: `La clé d'appel est celle de l'app ${appelant.app} : \`par\` doit être ${appelant.app}.` });
|
|
209
|
+
return;
|
|
210
|
+
}
|
|
181
211
|
if (chemin !== `/${par}` && !chemin.startsWith(`/${par}/`)) {
|
|
182
212
|
repondre(400, { erreur: `Le chemin d'une notification est sous /${par}.` });
|
|
183
213
|
return;
|
package/src/notifier.js
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
// montre dans l'écran « Notifications » et par la cloche de la barre.
|
|
4
4
|
// Le délai laissé au core pour répondre, en millisecondes.
|
|
5
5
|
export const delaiDUneNotification = 3_000;
|
|
6
|
-
// La notification d'une app, vers le core (`CORE_ADRESSE/notifier`), avec
|
|
6
|
+
// La notification d'une app, vers le core (`CORE_ADRESSE/notifier`), avec sa clé d'appel
|
|
7
7
|
// (`CLE_D_APPEL`, que le kit passe à toute app dont le compose la cite). `par` est le nom de l'app.
|
|
8
8
|
//
|
|
9
9
|
// `notifier` part après l'écriture validée, jamais dans une transaction, une seule fois, sans nouvel
|
package/src/partage.d.ts
CHANGED
|
@@ -30,7 +30,7 @@ type SchemaDUnArgument = NonNullable<Outil['schema']['properties']>[string];
|
|
|
30
30
|
export declare const dureeDeLAnnuaire = 5000;
|
|
31
31
|
export declare function suffit(droit: DroitSurLaChose | undefined, attendu: DroitSurLaChose): boolean;
|
|
32
32
|
export declare function ouverturesDe(personne: Personne): string[];
|
|
33
|
-
export declare function creerLAnnuaire(adresseDuCore?: string | undefined, horloge?: () => number): ({ sansCache }?: {
|
|
33
|
+
export declare function creerLAnnuaire(adresseDuCore?: string | undefined, horloge?: () => number, cle?: string | undefined): ({ sansCache }?: {
|
|
34
34
|
sansCache?: boolean;
|
|
35
35
|
}) => Promise<Annuaire>;
|
|
36
36
|
export declare function nomDe(annuaire: Annuaire, id: string): string;
|
package/src/partage.js
CHANGED
|
@@ -19,16 +19,17 @@ export function ouverturesDe(personne) {
|
|
|
19
19
|
// Lit l'annuaire du core (`CORE_ADRESSE/annuaire`), gardé `dureeDeLAnnuaire`. Un core qui ne le
|
|
20
20
|
// donne pas, ou qui ne répond pas, lève une erreur, qui n'est pas gardée. `{ sansCache: true }` le
|
|
21
21
|
// relit au core, pour un geste qui décide sur ce qu'il dit, comme le don des choses d'une personne
|
|
22
|
-
// désactivée ; la lecture remplace celle gardée.
|
|
22
|
+
// désactivée ; la lecture remplace celle gardée. `cle`, la clé d'appel de l'app (`CLE_D_APPEL` par
|
|
23
|
+
// défaut), part en `Authorization: Bearer <cle>` ; sans elle, l'annuaire se demande sans en-tête.
|
|
23
24
|
// `horloge` ne sert qu'aux tests.
|
|
24
|
-
export function creerLAnnuaire(adresseDuCore = process.env.CORE_ADRESSE, horloge = Date.now) {
|
|
25
|
+
export function creerLAnnuaire(adresseDuCore = process.env.CORE_ADRESSE, horloge = Date.now, cle = process.env.CLE_D_APPEL) {
|
|
25
26
|
let garde;
|
|
26
27
|
return function lireLAnnuaire({ sansCache = false } = {}) {
|
|
27
28
|
if (!adresseDuCore) {
|
|
28
29
|
return Promise.reject(new Error('La variable CORE_ADRESSE manque : l\'adresse interne du core vient du kit.'));
|
|
29
30
|
}
|
|
30
31
|
if (sansCache || !garde || horloge() - garde.lu >= dureeDeLAnnuaire) {
|
|
31
|
-
const lecture = { lu: horloge(), annuaire: demanderLAnnuaire(new URL('/annuaire', adresseDuCore)) };
|
|
32
|
+
const lecture = { lu: horloge(), annuaire: demanderLAnnuaire(new URL('/annuaire', adresseDuCore), cle) };
|
|
32
33
|
lecture.annuaire.catch(() => {
|
|
33
34
|
if (garde === lecture) {
|
|
34
35
|
garde = undefined;
|
|
@@ -39,8 +40,8 @@ export function creerLAnnuaire(adresseDuCore = process.env.CORE_ADRESSE, horloge
|
|
|
39
40
|
return garde.annuaire;
|
|
40
41
|
};
|
|
41
42
|
}
|
|
42
|
-
async function demanderLAnnuaire(adresse) {
|
|
43
|
-
const reponse = await fetch(adresse, { signal: AbortSignal.timeout(5000) });
|
|
43
|
+
async function demanderLAnnuaire(adresse, cle) {
|
|
44
|
+
const reponse = await fetch(adresse, { headers: cle ? { authorization: `Bearer ${cle}` } : {}, signal: AbortSignal.timeout(5000) });
|
|
44
45
|
if (!reponse.ok) {
|
|
45
46
|
throw new Error(`Le core ne donne pas l'annuaire : ${reponse.status}.`);
|
|
46
47
|
}
|
|
@@ -165,7 +166,7 @@ export function creerLePartage(options) {
|
|
|
165
166
|
// lit le droit : la racine, ou la chose elle-même.
|
|
166
167
|
const depuis = racine ? `${table} join ${table} as racine on racine.id = ${table}.${racine}` : table;
|
|
167
168
|
const aliasDuDroit = racine ? 'racine' : table;
|
|
168
|
-
const lireLAnnuaire = creerLAnnuaire(options.adresseDuCore ?? process.env.CORE_ADRESSE);
|
|
169
|
+
const lireLAnnuaire = creerLAnnuaire(options.adresseDuCore ?? process.env.CORE_ADRESSE, Date.now, options.cleDAppel);
|
|
169
170
|
const { chemin } = options;
|
|
170
171
|
const nomAffiche = (lu) => (lu?.trim() ? lu : options.sansNom ?? 'Sans titre');
|
|
171
172
|
// La notification d'une chose : `notifier` ne lève jamais, et part après l'écriture, hors de toute
|