@indos/bibliotheque 4.2.0 → 4.4.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 +154 -153
- package/README.md +2 -2
- package/bin/bibliotheque.d.ts +1 -0
- package/bin/bibliotheque.js +63 -0
- package/bin/page-de-l-espace.js +2 -2
- package/manifeste.json +5 -0
- package/modeles/app-du-client/.github/workflows/publier-l-image.yml +31 -0
- package/modeles/app-du-client/DOCUMENTATION.md +27 -0
- package/modeles/app-du-client/Dockerfile +34 -0
- package/modeles/app-du-client/Dockerfile.dockerignore +3 -0
- package/modeles/app-du-client/GUIDE.md +3 -0
- package/modeles/app-du-client/README.md +47 -0
- package/modeles/app-du-client/espace/ecrans/entrees.tsx +57 -0
- package/modeles/app-du-client/espace/index.html +9 -0
- package/modeles/app-du-client/espace/page.tsx +6 -0
- package/modeles/app-du-client/espace/requetes/entrees.ts +16 -0
- package/modeles/app-du-client/espace/routes.ts +12 -0
- package/modeles/app-du-client/espace/tsconfig.json +7 -0
- package/modeles/app-du-client/essai/poser.sql +6 -0
- package/modeles/app-du-client/logo.svg +1 -0
- package/modeles/app-du-client/manifeste.json +12 -0
- package/modeles/app-du-client/migrations/0001-creer-les-entrees.sql +10 -0
- package/modeles/app-du-client/package.json +20 -0
- package/modeles/app-du-client/src/demarrer.ts +17 -0
- package/modeles/app-du-client/src/outils.ts +52 -0
- package/modeles/app-du-client/src/serveur.ts +46 -0
- package/modeles/app-du-client/tests/espace/entrees.test.tsx +58 -0
- package/modeles/app-du-client/tests/serveur.test.ts +112 -0
- package/modeles/app-du-client/tsconfig.json +22 -0
- package/package.json +3 -2
- package/src/app.js +4 -4
- package/src/appeler.js +1 -1
- package/src/base-d-essai.d.ts +3 -0
- package/src/base-d-essai.js +17 -1
- package/src/faux-core.js +10 -10
- package/src/flux.js +1 -1
- package/src/liens.js +1 -1
- package/src/mcp.d.ts +3 -0
- package/src/mcp.js +20 -2
- package/src/partage.js +6 -7
- package/src/session.js +3 -4
- package/src/theme.js +1 -1
- package/src/vite.js +33 -22
|
@@ -0,0 +1,112 @@
|
|
|
1
|
+
import assert from 'node:assert/strict';
|
|
2
|
+
import { readFileSync } from 'node:fs';
|
|
3
|
+
import { test, type TestContext } from 'node:test';
|
|
4
|
+
import { ouvrirLaBaseDUnTest } from '@indos/bibliotheque/base-d-essai';
|
|
5
|
+
import { appeler, connecter, lancerLeFauxCore, servirLApp, type ClientDEssai } from '@indos/bibliotheque/faux-core';
|
|
6
|
+
import { creerLeTraitement } from '../src/serveur.ts';
|
|
7
|
+
|
|
8
|
+
// Le manifeste et le texte d'usage, que `demarrerLApp` relit au démarrage.
|
|
9
|
+
const manifeste = JSON.parse(readFileSync(new URL('../manifeste.json', import.meta.url), 'utf8'));
|
|
10
|
+
const instructions = readFileSync(new URL('../GUIDE.md', import.meta.url), 'utf8').trim();
|
|
11
|
+
const { nom, titre } = manifeste;
|
|
12
|
+
// La page construite par `npm run build`, que l'app sert.
|
|
13
|
+
const page = readFileSync(new URL('../dist/index.html', import.meta.url), 'utf8');
|
|
14
|
+
const ada = { id: 'p1', email: 'ada@exemple.ch', nom: 'Ada', proprietaire: true };
|
|
15
|
+
const eve = { id: 'p2', email: 'eve@exemple.ch', nom: 'Eve', proprietaire: false };
|
|
16
|
+
|
|
17
|
+
// L'app telle que le kit la déclare au core, avec son écran.
|
|
18
|
+
const apps = [{ nom, titre, lien: `https://exemple.ch/${nom}`, ecrans: [{ nom: 'entrees', titre: 'Entrées' }] }];
|
|
19
|
+
|
|
20
|
+
// Démarre l'app sur une base d'essai migrée et un port libre, servie sous /<nom> comme derrière le
|
|
21
|
+
// proxy, qui retire son chemin comme `demarrerLApp`, et branchée au core donné ; rend son adresse,
|
|
22
|
+
// avec son chemin.
|
|
23
|
+
async function demarrer(t: TestContext, adresseDuCore?: string): Promise<string> {
|
|
24
|
+
const base = await ouvrirLaBaseDUnTest(t, new URL('../migrations/', import.meta.url));
|
|
25
|
+
const servie = await servirLApp(t, nom);
|
|
26
|
+
servie.brancher(creerLeTraitement({ base, adresse: servie.adresse, adresseDuCore, manifeste, instructions }));
|
|
27
|
+
return servie.adresse;
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
// Le JSON que rend un outil, qui doit aboutir.
|
|
31
|
+
async function lire(client: ClientDEssai, outil: string, arguments_: Record<string, unknown> = {}) {
|
|
32
|
+
const resultat = await appeler(client, outil, arguments_);
|
|
33
|
+
assert.equal(resultat.erreur, false, resultat.texte);
|
|
34
|
+
return resultat.json;
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
test('la racine renvoie vers l\'écran ; /sante répond ok ; une autre page est introuvable', async (t) => {
|
|
38
|
+
const adresse = await demarrer(t, await lancerLeFauxCore(t, { 'session=ada': ada }, { nom: 'Essai' }, apps));
|
|
39
|
+
const origine = new URL(adresse).origin;
|
|
40
|
+
for (const racine of [`${adresse}/`, `${origine}/`]) {
|
|
41
|
+
const reponse = await fetch(racine, { redirect: 'manual' });
|
|
42
|
+
assert.equal(reponse.status, 303);
|
|
43
|
+
assert.equal(reponse.headers.get('location'), `${adresse}/entrees`);
|
|
44
|
+
}
|
|
45
|
+
assert.equal(await (await fetch(`${origine}/sante`)).text(), 'ok');
|
|
46
|
+
assert.equal((await fetch(`${adresse}/ailleurs`, { headers: { cookie: 'session=ada' } })).status, 404);
|
|
47
|
+
});
|
|
48
|
+
|
|
49
|
+
test('l\'écran sert la page construite à une personne connectée, avec ou sans le chemin de l\'app', async (t) => {
|
|
50
|
+
const adresse = await demarrer(t, await lancerLeFauxCore(t, { 'session=eve': eve }, { nom: 'Essai' }, apps));
|
|
51
|
+
const origine = new URL(adresse).origin;
|
|
52
|
+
for (const ecran of [`${adresse}/entrees`, `${origine}/entrees`]) {
|
|
53
|
+
const reponse = await fetch(ecran, { headers: { cookie: 'session=eve' } });
|
|
54
|
+
assert.equal(reponse.status, 200);
|
|
55
|
+
// La page construite, avec la session de la personne dans sa tête.
|
|
56
|
+
const servie = await reponse.text();
|
|
57
|
+
assert.match(servie, /<meta name="indos-session" content="[^"]+"><\/head>/);
|
|
58
|
+
assert.equal(servie.replace(/<meta name="indos-session" content="[^"]+">/, ''), page);
|
|
59
|
+
}
|
|
60
|
+
const sansSession = await fetch(`${adresse}/entrees`, { redirect: 'manual' });
|
|
61
|
+
assert.equal(sansSession.status, 303);
|
|
62
|
+
assert.match(sansSession.headers.get('location') ?? '', /\/connexion\?retour=/);
|
|
63
|
+
});
|
|
64
|
+
|
|
65
|
+
test('chacun ajoute et lit ses entrées, les plus récentes d\'abord, 25 par page', async (t) => {
|
|
66
|
+
const adresse = await demarrer(t, await lancerLeFauxCore(t));
|
|
67
|
+
const deAda = await connecter(t, adresse, ada);
|
|
68
|
+
const deEve = await connecter(t, adresse, eve);
|
|
69
|
+
for (let rang = 1; rang <= 26; rang += 1) {
|
|
70
|
+
await lire(deAda, 'ajouter', { texte: `Entrée ${rang}` });
|
|
71
|
+
}
|
|
72
|
+
const ajoutee = await lire(deEve, 'ajouter', { texte: ' La seule d\'Eve ' });
|
|
73
|
+
assert.equal(ajoutee.texte, 'La seule d\'Eve');
|
|
74
|
+
|
|
75
|
+
const premiere = await lire(deAda, 'lister', {});
|
|
76
|
+
assert.equal(premiere.total, 26);
|
|
77
|
+
assert.equal(premiere.lignes.length, 25);
|
|
78
|
+
assert.equal(premiere.lignes[0].texte, 'Entrée 26');
|
|
79
|
+
const seconde = await lire(deAda, 'lister', { page: 2 });
|
|
80
|
+
assert.deepEqual(seconde.lignes.map((entree: { texte: string }) => entree.texte), ['Entrée 1']);
|
|
81
|
+
assert.deepEqual(await lire(deEve, 'lister', {}), { lignes: [ajoutee], total: 1 });
|
|
82
|
+
|
|
83
|
+
const vide = await appeler(deEve, 'ajouter', { texte: '' });
|
|
84
|
+
assert.equal(vide.erreur, true);
|
|
85
|
+
});
|
|
86
|
+
|
|
87
|
+
test('l\'écran appelle les outils avec la session de la personne, de l\'origine de l\'app seulement', async (t) => {
|
|
88
|
+
const adresse = await demarrer(t, await lancerLeFauxCore(t, { 'session=eve': eve }, { nom: 'Essai' }, apps));
|
|
89
|
+
const origine = new URL(adresse).origin;
|
|
90
|
+
function appelerDepuisLEcran(outil: string, corps: Record<string, unknown>, entetes: Record<string, string>) {
|
|
91
|
+
return fetch(`${adresse}/outils/${outil}`, {
|
|
92
|
+
method: 'POST',
|
|
93
|
+
headers: { origin: origine, 'content-type': 'application/json', ...entetes },
|
|
94
|
+
body: JSON.stringify(corps),
|
|
95
|
+
});
|
|
96
|
+
}
|
|
97
|
+
assert.equal((await appelerDepuisLEcran('ajouter', { texte: 'Depuis l\'écran' }, { cookie: 'session=eve' })).status, 200);
|
|
98
|
+
const liste = await appelerDepuisLEcran('lister', {}, { cookie: 'session=eve' });
|
|
99
|
+
assert.equal(liste.status, 200);
|
|
100
|
+
const { content } = await liste.json() as { content: { text: string }[] };
|
|
101
|
+
assert.equal(JSON.parse(content[0].text).lignes[0].texte, 'Depuis l\'écran');
|
|
102
|
+
assert.equal((await appelerDepuisLEcran('lister', {}, {})).status, 401);
|
|
103
|
+
assert.equal((await appelerDepuisLEcran('lister', {}, { cookie: 'session=eve', origin: 'https://ailleurs.exemple' })).status, 403);
|
|
104
|
+
});
|
|
105
|
+
|
|
106
|
+
test('sans jeton du core, le MCP répond 401 ; sans CORE_ADRESSE, 503', async (t) => {
|
|
107
|
+
const avecCore = await demarrer(t, await lancerLeFauxCore(t));
|
|
108
|
+
const corps = { method: 'POST', headers: { 'content-type': 'application/json' }, body: '{}' };
|
|
109
|
+
assert.equal((await fetch(`${avecCore}/mcp`, corps)).status, 401);
|
|
110
|
+
const sansCore = await demarrer(t);
|
|
111
|
+
assert.equal((await fetch(`${sansCore}/mcp`, corps)).status, 503);
|
|
112
|
+
});
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
{
|
|
2
|
+
"compilerOptions": {
|
|
3
|
+
"target": "esnext",
|
|
4
|
+
"module": "nodenext",
|
|
5
|
+
"strict": true,
|
|
6
|
+
"noEmit": true,
|
|
7
|
+
"allowImportingTsExtensions": true,
|
|
8
|
+
"erasableSyntaxOnly": true,
|
|
9
|
+
"verbatimModuleSyntax": true,
|
|
10
|
+
"types": [
|
|
11
|
+
"node"
|
|
12
|
+
],
|
|
13
|
+
"skipLibCheck": true
|
|
14
|
+
},
|
|
15
|
+
"include": [
|
|
16
|
+
"src",
|
|
17
|
+
"tests"
|
|
18
|
+
],
|
|
19
|
+
"exclude": [
|
|
20
|
+
"tests/espace"
|
|
21
|
+
]
|
|
22
|
+
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@indos/bibliotheque",
|
|
3
|
-
"version": "4.
|
|
3
|
+
"version": "4.4.0",
|
|
4
4
|
"description": "La bibliothèque des apps d'Indos : le serveur, le MCP, la base et la page de l'espace d'une app.",
|
|
5
5
|
"license": "SEE LICENSE IN LICENSE",
|
|
6
6
|
"type": "module",
|
|
@@ -135,7 +135,8 @@
|
|
|
135
135
|
"./ui/theme.css": "./src/ui/theme.css"
|
|
136
136
|
},
|
|
137
137
|
"bin": {
|
|
138
|
-
"page-de-l-espace": "./bin/page-de-l-espace.js"
|
|
138
|
+
"page-de-l-espace": "./bin/page-de-l-espace.js",
|
|
139
|
+
"bibliotheque": "./bin/bibliotheque.js"
|
|
139
140
|
},
|
|
140
141
|
"dependencies": {
|
|
141
142
|
"@hocuspocus/common": "4.7.1",
|
package/src/app.js
CHANGED
|
@@ -6,8 +6,8 @@ import { appliquerLesMigrations, ouvrirLaBase } from './base.js';
|
|
|
6
6
|
import { envoyerLaPage, pageSimple } from './ecran.js';
|
|
7
7
|
import { fermerLesFlux } from './flux.js';
|
|
8
8
|
import { sansLeChemin } from './sans-le-chemin.js';
|
|
9
|
-
// Le serveur HTTP d'une app : GET /sante (et HEAD) répond « ok » pour la sonde de
|
|
10
|
-
// et
|
|
9
|
+
// Le serveur HTTP d'une app : GET /sante (et HEAD) répond « ok » pour la sonde de l'image, le kit
|
|
10
|
+
// et la surveillance ; tout le reste va à l'app.
|
|
11
11
|
export function creerLeServeur(traiter) {
|
|
12
12
|
const serveur = createServer((requete, reponse) => {
|
|
13
13
|
const chemin = requete.url?.split('?')[0];
|
|
@@ -18,8 +18,8 @@ export function creerLeServeur(traiter) {
|
|
|
18
18
|
}
|
|
19
19
|
traiter(requete, reponse);
|
|
20
20
|
});
|
|
21
|
-
// Le proxy
|
|
22
|
-
//
|
|
21
|
+
// Le proxy garde une connexion inactive vers l'app et peut y envoyer la requête suivante :
|
|
22
|
+
// l'app la garde 95 s.
|
|
23
23
|
serveur.keepAliveTimeout = 95_000;
|
|
24
24
|
serveur.headersTimeout = 96_000;
|
|
25
25
|
return serveur;
|
package/src/appeler.js
CHANGED
|
@@ -5,7 +5,7 @@ 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
|
|
8
|
+
// « Les entrées de la bibliothèque »). `par` est le nom de l'app qui appelle ; le kit passe la clé commune des apps dans
|
|
9
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
|
|
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) {
|
package/src/base-d-essai.d.ts
CHANGED
|
@@ -1,4 +1,7 @@
|
|
|
1
|
+
import type { TestContext } from 'node:test';
|
|
2
|
+
import type pg from 'pg';
|
|
1
3
|
export declare function ouvrirUneBaseDEssai(): Promise<{
|
|
2
4
|
adresse: string;
|
|
3
5
|
fermer: () => Promise<void>;
|
|
4
6
|
}>;
|
|
7
|
+
export declare function ouvrirLaBaseDUnTest(t: TestContext, migrations?: URL): Promise<pg.Pool>;
|
package/src/base-d-essai.js
CHANGED
|
@@ -1,9 +1,10 @@
|
|
|
1
1
|
import { PGlite } from '@electric-sql/pglite';
|
|
2
2
|
import { PGLiteSocketServer } from '@electric-sql/pglite-socket';
|
|
3
|
+
import { appliquerLesMigrations, ouvrirLaBase } from './base.js';
|
|
3
4
|
// Une vraie Postgres en mémoire pour les tests, sans service : PGlite, joint par le protocole
|
|
4
5
|
// de Postgres. PGlite n'a qu'une session : la base n'accepte qu'une connexion à la fois, pour
|
|
5
6
|
// que deux transactions ne s'y mêlent jamais sans bruit. Une app s'y branche avec un pool
|
|
6
|
-
// d'une connexion (`ouvrirLaBase(adresse, 1)`).
|
|
7
|
+
// d'une connexion (`ouvrirLaBase(adresse, 1)`) : `ouvrirLaBaseDUnTest` le rend.
|
|
7
8
|
export async function ouvrirUneBaseDEssai() {
|
|
8
9
|
const db = await PGlite.create();
|
|
9
10
|
const serveur = new PGLiteSocketServer({ db, host: '127.0.0.1', port: 0, maxConnections: 1 });
|
|
@@ -16,3 +17,18 @@ export async function ouvrirUneBaseDEssai() {
|
|
|
16
17
|
},
|
|
17
18
|
};
|
|
18
19
|
}
|
|
20
|
+
// La base d'un test : une base d'essai neuve, jointe par un pool d'une connexion, avec les
|
|
21
|
+
// migrations du dossier `migrations` quand il est donné. Le pool et la base se ferment à la fin du
|
|
22
|
+
// test.
|
|
23
|
+
export async function ouvrirLaBaseDUnTest(t, migrations) {
|
|
24
|
+
const essai = await ouvrirUneBaseDEssai();
|
|
25
|
+
const base = ouvrirLaBase(essai.adresse, 1);
|
|
26
|
+
t.after(async () => {
|
|
27
|
+
await base.end();
|
|
28
|
+
await essai.fermer();
|
|
29
|
+
});
|
|
30
|
+
if (migrations) {
|
|
31
|
+
await appliquerLesMigrations(base, migrations);
|
|
32
|
+
}
|
|
33
|
+
return base;
|
|
34
|
+
}
|
package/src/faux-core.js
CHANGED
|
@@ -7,8 +7,7 @@ import { sansLeChemin } from './sans-le-chemin.js';
|
|
|
7
7
|
// Un faux core pour les tests des apps : il sert sa clé publique et signe des jetons, fabriqués
|
|
8
8
|
// ici à la main, sans le code du core.
|
|
9
9
|
export const { privateKey: cleDuFauxCore, publicKey: clePubliqueDuFauxCore } = generateKeyPairSync('ed25519');
|
|
10
|
-
// Le jeton porte les groupes de la personne quand elle en a (`groupes`)
|
|
11
|
-
// comme celui d'un core d'avant 1.7.
|
|
10
|
+
// Le jeton porte les groupes de la personne quand elle en a (`groupes`).
|
|
12
11
|
export function fabriquerUnJeton(personne, app, cle = cleDuFauxCore) {
|
|
13
12
|
const iat = Math.floor(Date.now() / 1000);
|
|
14
13
|
const b64 = (valeur) => Buffer.from(JSON.stringify(valeur)).toString('base64url');
|
|
@@ -36,7 +35,7 @@ function estOuverte(app, proprietaire, groupes) {
|
|
|
36
35
|
return proprietaire || acces.some((avec) => avec === 'equipe' || groupes.includes(avec));
|
|
37
36
|
}
|
|
38
37
|
// Ce que le core rend à `/session` des apps déclarées, pour une personne, dans sa forme
|
|
39
|
-
// (bibliotheque/CLAUDE.md, « Les
|
|
38
|
+
// (bibliotheque/CLAUDE.md, « Les entrées de la bibliothèque ») : les apps qui lui sont ouvertes, d'après
|
|
40
39
|
// ses groupes, dans l'ordre de leur titre, chacune avec ses réglages quand la personne a le droit de
|
|
41
40
|
// les voir, les écrans qu'elle a le droit de voir, avec leur chemin, et son lien (son premier écran
|
|
42
41
|
// visible, sinon ses réglages, sinon son lien déclaré) ; puis la barre de départ : le premier écran
|
|
@@ -77,12 +76,13 @@ export function sessionDuCore(apps, proprietaire, nomDeLOS, groupes = []) {
|
|
|
77
76
|
// l'annuaire, dans l'ordre de leur nom), les apps qui lui sont ouvertes, la barre (`sessionDuCore`,
|
|
78
77
|
// d'après `apps`, déclarées comme par le kit, à plat et rangée, et son accueil) et le thème
|
|
79
78
|
// (`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.
|
|
81
|
-
//
|
|
82
|
-
// (
|
|
83
|
-
//
|
|
84
|
-
//
|
|
85
|
-
//
|
|
79
|
+
// Il sert les éléments de cette barre à `/espace/barre`, comme le geste du core. Une app qu'il ne
|
|
80
|
+
// déclare pas est fermée à tous, comme au core : le test d'une app qui reconnaît la personne à sa
|
|
81
|
+
// session (une page, un geste d'écran, `POST /outils`) la déclare.
|
|
82
|
+
// Il sert l'annuaire (`GET /annuaire`) : `annuaire`, ou, sans lui, les personnes des sessions,
|
|
83
|
+
// actives, sans groupe. L'annuaire est tenu par référence et relu à chaque requête : un test qui
|
|
84
|
+
// retire un membre d'un groupe ou désactive une personne en cours de route, sur l'objet qu'il a
|
|
85
|
+
// passé, le voit à l'appel suivant.
|
|
86
86
|
// Il sert `theme.logo` sur `/theme/logo.svg`, lu à chaque requête (un test le change en cours de
|
|
87
87
|
// route), ou 404 sans logo.
|
|
88
88
|
// Il reçoit les notifications des apps à `POST /notifier`, comme le core : la clé commune
|
|
@@ -123,7 +123,7 @@ export async function lancerLeFauxCore(t, sessions = {}, theme = {}, apps = [],
|
|
|
123
123
|
reponse.end(JSON.stringify({
|
|
124
124
|
...personne,
|
|
125
125
|
groupes,
|
|
126
|
-
|
|
126
|
+
apps: ouvertes,
|
|
127
127
|
barre,
|
|
128
128
|
rangement,
|
|
129
129
|
accueil,
|
package/src/flux.js
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
// (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
|
-
// Un commentaire toutes les 25 secondes
|
|
5
|
+
// Un commentaire toutes les 25 secondes, qui garde la connexion ouverte à travers le proxy.
|
|
6
6
|
export const delaiDuBattement = 25_000;
|
|
7
7
|
// Ce qu'attend le navigateur avant de rouvrir un flux fermé, en millisecondes.
|
|
8
8
|
export const delaiDeReconnexion = 2_000;
|
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
|
|
3
|
+
// Les liens signés d'une app (bibliotheque/CLAUDE.md, « Les entrées de la bibliothèque ») : 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.d.ts
CHANGED
|
@@ -6,8 +6,11 @@ export declare class Refus extends Error {
|
|
|
6
6
|
export type ResultatDOutil = string | {
|
|
7
7
|
content: CallToolResult['content'];
|
|
8
8
|
};
|
|
9
|
+
export type SorteDUnOutil = 'lecture' | 'ecriture' | 'definitif';
|
|
9
10
|
export type Outil = {
|
|
10
11
|
nom: string;
|
|
12
|
+
titre?: string;
|
|
13
|
+
sorte?: SorteDUnOutil;
|
|
11
14
|
description: string;
|
|
12
15
|
schema: Tool['inputSchema'];
|
|
13
16
|
pour?: (personne: Personne) => boolean;
|
package/src/mcp.js
CHANGED
|
@@ -52,7 +52,7 @@ export function creerLeMcp(options) {
|
|
|
52
52
|
serveur.setRequestHandler('tools/list', async () => ({
|
|
53
53
|
tools: options.outils
|
|
54
54
|
.filter((outil) => !outil.pour || outil.pour(personne))
|
|
55
|
-
.map(
|
|
55
|
+
.map(outilDeLaListe),
|
|
56
56
|
}));
|
|
57
57
|
serveur.setRequestHandler('tools/call', async (requete) => ((await appelerLOutil(requete.params.name, requete.params.arguments ?? {}, personne)).resultat));
|
|
58
58
|
return serveur;
|
|
@@ -133,7 +133,25 @@ export function creerLeMcp(options) {
|
|
|
133
133
|
await traiterLeMcp(requete, reponse);
|
|
134
134
|
};
|
|
135
135
|
}
|
|
136
|
-
//
|
|
136
|
+
// Les annotations MCP de chaque sorte, que le client de Claude lit pour ranger les outils et
|
|
137
|
+
// demander l'accord.
|
|
138
|
+
const annotationsDeLaSorte = {
|
|
139
|
+
lecture: { readOnlyHint: true },
|
|
140
|
+
ecriture: { readOnlyHint: false, destructiveHint: false },
|
|
141
|
+
definitif: { readOnlyHint: false, destructiveHint: true },
|
|
142
|
+
};
|
|
143
|
+
// Un outil tel que `tools/list` le rend : son titre en `title`, sa sorte en annotations, chacun
|
|
144
|
+
// seulement s'il le déclare.
|
|
145
|
+
function outilDeLaListe(outil) {
|
|
146
|
+
return {
|
|
147
|
+
name: outil.nom,
|
|
148
|
+
...(outil.titre === undefined ? {} : { title: outil.titre }),
|
|
149
|
+
description: outil.description,
|
|
150
|
+
inputSchema: outil.schema,
|
|
151
|
+
...(outil.sorte === undefined ? {} : { annotations: { ...annotationsDeLaSorte[outil.sorte] } }),
|
|
152
|
+
};
|
|
153
|
+
}
|
|
154
|
+
// Le chemin de la requête dans l'app : le proxy retire le chemin de l'app, retiré ici
|
|
137
155
|
// s'il arrive quand même.
|
|
138
156
|
function cheminDansLApp(requete, adresse) {
|
|
139
157
|
const chemin = new URL(requete.url ?? '/', 'http://app').pathname;
|
package/src/partage.js
CHANGED
|
@@ -16,10 +16,10 @@ export function suffit(droit, attendu) {
|
|
|
16
16
|
export function ouverturesDe(personne) {
|
|
17
17
|
return ['equipe', `personne:${personne.id}`, ...(personne.groupes ?? []).map((groupe) => `groupe:${groupe}`)];
|
|
18
18
|
}
|
|
19
|
-
// Lit l'annuaire du core (`CORE_ADRESSE/annuaire`), gardé `dureeDeLAnnuaire`. Un core qui
|
|
20
|
-
// pas
|
|
21
|
-
//
|
|
22
|
-
//
|
|
19
|
+
// Lit l'annuaire du core (`CORE_ADRESSE/annuaire`), gardé `dureeDeLAnnuaire`. Un core qui ne le
|
|
20
|
+
// donne pas, ou qui ne répond pas, lève une erreur, qui n'est pas gardée. `{ sansCache: true }` le
|
|
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.
|
|
23
23
|
// `horloge` ne sert qu'aux tests.
|
|
24
24
|
export function creerLAnnuaire(adresseDuCore = process.env.CORE_ADRESSE, horloge = Date.now) {
|
|
25
25
|
let garde;
|
|
@@ -41,9 +41,6 @@ export function creerLAnnuaire(adresseDuCore = process.env.CORE_ADRESSE, horloge
|
|
|
41
41
|
}
|
|
42
42
|
async function demanderLAnnuaire(adresse) {
|
|
43
43
|
const reponse = await fetch(adresse, { signal: AbortSignal.timeout(5000) });
|
|
44
|
-
if (reponse.status === 404) {
|
|
45
|
-
return { personnes: [], groupes: [] };
|
|
46
|
-
}
|
|
47
44
|
if (!reponse.ok) {
|
|
48
45
|
throw new Error(`Le core ne donne pas l'annuaire : ${reponse.status}.`);
|
|
49
46
|
}
|
|
@@ -478,6 +475,8 @@ export function creerLePartage(options) {
|
|
|
478
475
|
export function outilDeDonnerLesChoses(partage, { apresUnDon } = {}) {
|
|
479
476
|
return {
|
|
480
477
|
nom: 'donner_les_choses',
|
|
478
|
+
titre: 'Donner ce qu\'avait une personne désactivée',
|
|
479
|
+
sorte: 'definitif',
|
|
481
480
|
description: 'Au propriétaire de l\'OS seul : donne toutes les choses de cette app d\'une personne désactivée (`de`, son courriel) à une personne active de l\'équipe (`a`), qui en devient propriétaire ; leur partage reste. Une chose rangée dans une autre suit sa racine. Refusé pour une personne encore active : la désactiver d\'abord dans « Équipe ». Rend `{ nombre, choses }`, les choses données.',
|
|
482
481
|
schema: schemaDeDonnerLesChoses(),
|
|
483
482
|
pour: (personne) => personne.proprietaire,
|
package/src/session.js
CHANGED
|
@@ -20,8 +20,7 @@ export function creerLaSession(adresse = process.env.ADRESSE, adresseDuCore = pr
|
|
|
20
20
|
}
|
|
21
21
|
// La session de la personne connectée, ou rien. Un core qui ne répond pas lève une erreur : l'app
|
|
22
22
|
// répond par une erreur plutôt que de renvoyer vers une connexion qui ne répondrait pas non plus.
|
|
23
|
-
// Une app est ouverte à la personne quand elle est parmi les apps que rend le core.
|
|
24
|
-
// rend pas les groupes ou les apps (d'avant 1.7, où toute app est ouverte à tous) n'en ferme aucune.
|
|
23
|
+
// Une app est ouverte à la personne quand elle est parmi les apps que rend le core.
|
|
25
24
|
async function lireLaSession(requete) {
|
|
26
25
|
if (!adresseDuCore) {
|
|
27
26
|
throw new Error('La variable CORE_ADRESSE manque : l\'adresse interne du core vient du kit.');
|
|
@@ -45,7 +44,7 @@ export function creerLaSession(adresse = process.env.ADRESSE, adresseDuCore = pr
|
|
|
45
44
|
const lues = appsDe(apps);
|
|
46
45
|
return {
|
|
47
46
|
personne: { id, email, nom, proprietaire, groupes: groupesDe(groupes), apps: lues, barre: barreDe(barre), theme: themeDe(theme) },
|
|
48
|
-
ouvre: (app) =>
|
|
47
|
+
ouvre: (app) => lues.some((lue) => lue.nom === app),
|
|
49
48
|
corps,
|
|
50
49
|
};
|
|
51
50
|
}
|
|
@@ -116,7 +115,7 @@ function appsDe(apps) {
|
|
|
116
115
|
});
|
|
117
116
|
}
|
|
118
117
|
// Les groupes de la personne, `[{ id, nom }]` dans `/session` : leurs identifiants, comme dans le
|
|
119
|
-
// jeton.
|
|
118
|
+
// jeton.
|
|
120
119
|
function groupesDe(groupes) {
|
|
121
120
|
return listeDe(groupes).flatMap(({ id }) => (typeof id === 'string' ? [id] : []));
|
|
122
121
|
}
|
package/src/theme.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
// Le thème du client, que sert le core (bibliotheque/CLAUDE.md, « Les
|
|
1
|
+
// Le thème du client, que sert le core (bibliotheque/CLAUDE.md, « Les entrées de la bibliothèque ») : ses
|
|
2
2
|
// variables CSS, lues à CORE_ADRESSE et gardées une minute. Si le core ne répond pas, le thème est
|
|
3
3
|
// vide et la page garde les couleurs du navigateur. `horloge` ne sert qu'aux tests.
|
|
4
4
|
export function creerLeLecteurDuTheme(adresseDuCore = process.env.CORE_ADRESSE, horloge = Date.now) {
|
package/src/vite.js
CHANGED
|
@@ -99,12 +99,12 @@ function configuration(dossier, base) {
|
|
|
99
99
|
export async function construireLaPage(dossier) {
|
|
100
100
|
await build({ ...configuration(dossier, lirePiece(dossier).base), mode: 'production' });
|
|
101
101
|
}
|
|
102
|
-
// Les chemins sous la base d'une
|
|
103
|
-
// l'app : les siens, d'où Vite sert la page et ses modules (`@vite/client`, `@react-refresh`,
|
|
102
|
+
// Les chemins sous la base d'une pièce que le serveur de développement garde, sans les relayer à
|
|
103
|
+
// l'app ou au core : les siens, d'où Vite sert la page et ses modules (`@vite/client`, `@react-refresh`,
|
|
104
104
|
// `@fs/…`, `@id/…`, et chaque fichier du dossier `espace/`, comme `<base>page.tsx`) ; le websocket du
|
|
105
105
|
// rechargement à chaud (son protocole, `vite-hmr` ou `vite-ping`) ; et le `GET` d'un écran du
|
|
106
|
-
// manifeste, dont il sert la page : `<base><écran>` et ce qui est dessous,
|
|
107
|
-
// app qui a des réglages, et, pour une app à choses (son écran `liste`), l'écran d'une chose et la
|
|
106
|
+
// manifeste, dont il sert la page : `<base><écran>` et ce qui est dessous (pour le core, `/bienvenue`
|
|
107
|
+
// ou `/documentation/<app>`), `<base>reglages` pour une app qui a des réglages, et, pour une app à choses (son écran `liste`), l'écran d'une chose et la
|
|
108
108
|
// chose seule (`estUnEcranDesChoses`). La fonction rendue le dit d'une requête.
|
|
109
109
|
export function cheminsGardes(dossier) {
|
|
110
110
|
const page = join(dossier, 'espace');
|
|
@@ -142,15 +142,28 @@ export function cheminsGardes(dossier) {
|
|
|
142
142
|
return ecrans.some((ecran) => dansLaBase === ecran || dansLaBase.startsWith(`${ecran}/`)) || (aChoses && estUnEcranDesChoses(`/${dansLaBase}`));
|
|
143
143
|
};
|
|
144
144
|
}
|
|
145
|
-
// Les relais du serveur de développement.
|
|
146
|
-
//
|
|
147
|
-
//
|
|
148
|
-
//
|
|
149
|
-
//
|
|
150
|
-
//
|
|
151
|
-
//
|
|
152
|
-
//
|
|
145
|
+
// Les relais du serveur de développement.
|
|
146
|
+
// Pour le core, la pièce est le core lancé en local, à `core`, avec pour `ADRESSE` celle du serveur
|
|
147
|
+
// de développement : tout ce que `garde` ne garde pas lui va, quelle qu'en soit la méthode,
|
|
148
|
+
// websockets compris, avec l'origine et l'hôte du serveur de développement.
|
|
149
|
+
// Pour une app, vers le core : la connexion et l'auth, la session, le thème et les gestes du core
|
|
150
|
+
// (sous `/espace/`), en lui présentant son origine et son hôte, ses cookies posés pour le serveur de
|
|
151
|
+
// développement, et ses renvois vers lui-même ramenés au serveur de développement.
|
|
152
|
+
// `/theme/variables.css` cite les polices à l'adresse publique du core : le relais la ramène au
|
|
153
|
+
// serveur de développement, d'où la page charge les polices, de sa propre origine. Vers l'app lancée
|
|
154
|
+
// en local : tout ce qui est sous sa base et que `garde` ne garde pas, quelle qu'en soit la méthode,
|
|
155
|
+
// websockets compris, sans le chemin de l'app, comme le proxy du serveur, avec l'origine et l'hôte
|
|
156
|
+
// du serveur de développement.
|
|
153
157
|
export function relais(options) {
|
|
158
|
+
if (options.base === '/') {
|
|
159
|
+
return {
|
|
160
|
+
'^/': {
|
|
161
|
+
target: new URL(options.core).origin,
|
|
162
|
+
ws: true,
|
|
163
|
+
bypass: (requete) => (options.garde(requete) ? requete.url : undefined),
|
|
164
|
+
},
|
|
165
|
+
};
|
|
166
|
+
}
|
|
154
167
|
const origineDuCore = new URL(options.core).origin;
|
|
155
168
|
const versLeCore = {
|
|
156
169
|
target: origineDuCore,
|
|
@@ -192,20 +205,18 @@ export function relais(options) {
|
|
|
192
205
|
'^/theme/variables\\.css': variablesDuCore,
|
|
193
206
|
'^/(connexion|deconnexion|auth/|mot-de-passe|espace/|theme/)': versLeCore,
|
|
194
207
|
};
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
};
|
|
202
|
-
}
|
|
208
|
+
relais[`^${options.base}`] = {
|
|
209
|
+
target: new URL(options.app).origin,
|
|
210
|
+
ws: true,
|
|
211
|
+
bypass: (requete) => (options.garde(requete) ? requete.url : undefined),
|
|
212
|
+
rewrite: (chemin) => chemin.slice(options.base.length - 1),
|
|
213
|
+
};
|
|
203
214
|
return relais;
|
|
204
215
|
}
|
|
205
216
|
// La configuration du serveur de développement de la pièce, sur `http://localhost:<port>`
|
|
206
217
|
// (`portDeDeveloppement` par défaut), à l'écoute de `hote` (localhost par défaut ; `0.0.0.0` dans un
|
|
207
|
-
// conteneur que joint un proxy), reliée au core de `core` (celui d'un espace ou un core
|
|
208
|
-
// et, pour une app, à l'app lancée en local à `app`. Après la connexion, le core ramène à `/` : pour
|
|
218
|
+
// conteneur que joint un proxy), reliée au core de `core` (pour une app, celui d'un espace ou un core
|
|
219
|
+
// local ; pour le core, le core lancé en local) et, pour une app, à l'app lancée en local à `app`. Après la connexion, le core ramène à `/` : pour
|
|
209
220
|
// une app, la racine mène à son premier écran.
|
|
210
221
|
export function configurationDuDeveloppement(dossier, options) {
|
|
211
222
|
const piece = lirePiece(dossier);
|