@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.
Files changed (43) hide show
  1. package/CLAUDE.md +154 -153
  2. package/README.md +2 -2
  3. package/bin/bibliotheque.d.ts +1 -0
  4. package/bin/bibliotheque.js +63 -0
  5. package/bin/page-de-l-espace.js +2 -2
  6. package/manifeste.json +5 -0
  7. package/modeles/app-du-client/.github/workflows/publier-l-image.yml +31 -0
  8. package/modeles/app-du-client/DOCUMENTATION.md +27 -0
  9. package/modeles/app-du-client/Dockerfile +34 -0
  10. package/modeles/app-du-client/Dockerfile.dockerignore +3 -0
  11. package/modeles/app-du-client/GUIDE.md +3 -0
  12. package/modeles/app-du-client/README.md +47 -0
  13. package/modeles/app-du-client/espace/ecrans/entrees.tsx +57 -0
  14. package/modeles/app-du-client/espace/index.html +9 -0
  15. package/modeles/app-du-client/espace/page.tsx +6 -0
  16. package/modeles/app-du-client/espace/requetes/entrees.ts +16 -0
  17. package/modeles/app-du-client/espace/routes.ts +12 -0
  18. package/modeles/app-du-client/espace/tsconfig.json +7 -0
  19. package/modeles/app-du-client/essai/poser.sql +6 -0
  20. package/modeles/app-du-client/logo.svg +1 -0
  21. package/modeles/app-du-client/manifeste.json +12 -0
  22. package/modeles/app-du-client/migrations/0001-creer-les-entrees.sql +10 -0
  23. package/modeles/app-du-client/package.json +20 -0
  24. package/modeles/app-du-client/src/demarrer.ts +17 -0
  25. package/modeles/app-du-client/src/outils.ts +52 -0
  26. package/modeles/app-du-client/src/serveur.ts +46 -0
  27. package/modeles/app-du-client/tests/espace/entrees.test.tsx +58 -0
  28. package/modeles/app-du-client/tests/serveur.test.ts +112 -0
  29. package/modeles/app-du-client/tsconfig.json +22 -0
  30. package/package.json +3 -2
  31. package/src/app.js +4 -4
  32. package/src/appeler.js +1 -1
  33. package/src/base-d-essai.d.ts +3 -0
  34. package/src/base-d-essai.js +17 -1
  35. package/src/faux-core.js +10 -10
  36. package/src/flux.js +1 -1
  37. package/src/liens.js +1 -1
  38. package/src/mcp.d.ts +3 -0
  39. package/src/mcp.js +20 -2
  40. package/src/partage.js +6 -7
  41. package/src/session.js +3 -4
  42. package/src/theme.js +1 -1
  43. 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.2.0",
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 Coolify
10
- // et de la surveillance ; tout le reste va à l'app.
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 de Coolify (Traefik) garde 90 s une connexion inactive vers l'app et peut y
22
- // envoyer la requête suivante : l'app la garde plus longtemps que lui, sinon c'est une 502.
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 pièces »). `par` est le nom de l'app qui appelle ; le kit passe la clé commune des apps dans
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) {
@@ -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>;
@@ -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`), et ne les porte pas sinon,
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 pièces ») : les apps qui lui sont ouvertes, d'après
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. 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
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.
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
- ...(apps.length ? { apps: ouvertes } : {}),
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 : le proxy de Coolify coupe une connexion muette à 90.
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 pièces ») : dix minutes, une charge
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((outil) => ({ name: outil.nom, description: outil.description, inputSchema: outil.schema })),
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
- // Le chemin de la requête dans l'app : le proxy de Coolify retire le chemin de l'app, retiré ici
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 n'en a
20
- // pas (d'avant 1.7, 404) rend un annuaire vide ; un core qui ne répond pas lève une erreur, qui
21
- // n'est pas gardée. `{ sansCache: true }` le relit au core, pour un geste qui décide sur ce qu'il
22
- // dit, comme le don des choses d'une personne désactivée ; la lecture remplace celle gardée.
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. Un core qui ne
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) => !Array.isArray(groupes) || !Array.isArray(apps) || lues.some((lue) => lue.nom === 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. Un core qui ne les rend pas (d'avant 1.7) la met dans aucun groupe.
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 pièces ») : ses
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 app que le serveur de développement garde, sans les relayer à
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, `<base>reglages` pour une
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. Vers le core : la connexion et l'auth, la session, le
146
- // thème et les gestes du core (sous `/espace/`), en lui présentant son origine et son hôte, ses
147
- // cookies posés pour le serveur de développement, et ses renvois vers lui-même ramenés au serveur
148
- // de développement. `/theme/variables.css` cite les polices à l'adresse publique du core : le relais
149
- // la ramène au serveur de développement, d'où la page charge les polices, de sa propre origine. Vers
150
- // l'app lancée en local (une app, pas le core) : tout ce qui est sous sa base et que `garde` ne
151
- // garde pas, quelle qu'en soit la méthode, websockets compris, sans le chemin de l'app, comme le
152
- // proxy du serveur, avec l'origine et l'hôte du serveur de développement.
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
- if (options.base !== '/') {
196
- relais[`^${options.base}`] = {
197
- target: new URL(options.app).origin,
198
- ws: true,
199
- bypass: (requete) => (options.garde(requete) ? requete.url : undefined),
200
- rewrite: (chemin) => chemin.slice(options.base.length - 1),
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 local)
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);