@indos/bibliotheque 4.4.0 → 4.6.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 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
 
@@ -77,7 +77,7 @@ Une entrée de `exports` par fonction (`package.json`), nommée par ce qu'elle f
77
77
  - Des octets servis en pièce jointe prennent `enTetesDUnTelechargement` (`sandbox`, `nosniff`).
78
78
  - `identifiant(id)` rend l'UUID en minuscules, ou rien : l'app répond alors « absente » sans demander à la base.
79
79
  - Le type d'un fichier qui entre se lit par `typeDuFichier`.
80
- - Le jeton du core (`jeton`) est vérifié en Ed25519 seul, pour l'app visée, une minute.
80
+ - Le jeton du core (`jeton`) est vérifié en Ed25519 seul, pour l'app visée, une minute. Il nomme qui appelle (`Personne`) : une personne de l'équipe, ou le compte d'une app, dont `app` est le nom de l'app, `id` `app:<nom>`, `nom` le titre de l'app et `email` vide, jamais propriétaire de l'OS, dans aucun groupe. Un jeton qui porte `app` hors de ces règles est refusé.
81
81
 
82
82
  ### Le MCP d'une app
83
83
 
@@ -90,6 +90,8 @@ Une entrée de `exports` par fonction (`package.json`), nommée par ce qu'elle f
90
90
  Un outil qui porte plusieurs gestes déclare la sorte la plus forte. Un outil sans titre ni sorte se liste sans `title` ni annotations.
91
91
  - Un geste définitif (supprimer, publier, émettre, annuler) prend `confirmer: true` ; sans lui, un `Refus` qui dit quoi demander à la personne.
92
92
  - Un argument manquant ou un choix à faire est un refus qui nomme les choix (« Préciser `compte` parmi : … ») ; un choix unique se prend sans demander.
93
+ - Un outil sert une personne ou le compte d'une app (`personne.app`) : `pour: (personne) => personne.proprietaire` ferme l'outil au compte, du même texte qu'un outil inconnu.
94
+ - `creerLAppel(par)` rend `appeler(app, outil, arguments, personne)` (`Appeler`), pour une personne ou pour le compte d'une app, pour qui l'app appelée poursuit (`app:<nom>`). `creerLAppelSousSonCompte(par)` rend `appeler(app, outil, arguments)` : l'app appelle sous son propre compte, quand personne de l'équipe ne demande, dans les apps de son `appelle`.
93
95
 
94
96
  #### Un écran appelle ses outils
95
97
 
@@ -122,7 +124,7 @@ Un geste d'écran est un appel de la page à sa pièce, en JSON, avec la session
122
124
 
123
125
  ### Les fichiers
124
126
 
125
- Une app qui dépose un fichier dans les fichiers d'une personne, ou en lit un, passe par `@indos/bibliotheque/fichiers`, déclare `appelle: ["fichiers"]` et lui donne l'appel de `creerLAppel`. Aucun octet ne passe par l'appel : `televerser` et `telecharger` rendent un lien signé de dix minutes.
127
+ Une app qui dépose un fichier dans les fichiers d'une personne ou du compte d'une app, ou en lit un, passe par `@indos/bibliotheque/fichiers`, déclare `appelle: ["fichiers"]` et lui donne l'appel de `creerLAppel`. Aucun octet ne passe par l'appel : `televerser` et `telecharger` rendent un lien signé de dix minutes.
126
128
 
127
129
  - `deposerUnFichier`, `donnerALEntreprise`, `demanderUnFichier`, `telechargerUnFichier` (jamais plus que la taille de la fiche, empreinte SHA-256 vérifiée).
128
130
  - Une app qui copie un fichier de la personne dans une chose passe par `prendreUnFichier(appeler, personne, id, { plafond, app, rien, conseil })`, qui coupe la lecture au plafond quoi que dise la fiche ; un fichier trop gros est un `Refus`, la même phrase dans chaque app.
@@ -154,13 +156,14 @@ Un outil ou un geste paginé reçoit `page`, un entier à partir de 1 (1 s'il ma
154
156
 
155
157
  Une chose est toujours à une personne et s'ouvre à des personnes, à des groupes ou à toute l'équipe, en lecture ou en modification. Le core tient l'accès à l'app ; l'app tient le partage de ses choses dans sa base, par `@indos/bibliotheque/partage`. Les groupes viennent du jeton et de la session, signés par le core. Le propriétaire de l'OS ouvre toute app, pas toute chose, sauf dans une app qui déclare `auProprietaireDeLOS`.
156
158
 
157
- - La table `partage` recopie `modeles/partage.sql` dans une migration de l'app : `(<chose>, avec, droit)`, `avec` valant `personne:<id>`, `groupe:<id>` ou `equipe`, `droit` `lecture` ou `modification`. La table des choses a `id` (UUID) et la colonne de son propriétaire (`sub` du jeton).
159
+ - La table `partage` recopie `modeles/partage.sql` dans une migration de l'app : `(<chose>, avec, droit)`, `avec` valant `personne:<id>` (`personne:app:<nom>` pour le compte d'une app), `groupe:<id>` ou `equipe`, `droit` `lecture` ou `modification`. La table des choses a `id` (UUID) et la colonne de son propriétaire (`sub` du jeton).
158
160
  - `creerLePartage(options)` : `base`, `chose`, `laChose`, `absente(id)` ; le reste selon l'app, dit par `OptionsDuPartage`.
159
161
  - Chaque geste dit le droit qu'il demande (`lire(personne, id, { droit })`, `droitSur`, `suffit`). Un droit qui ne suffit pas répond comme une chose absente, la même phrase. Seule exception : un compte branché que la personne voit, dont le refus dit qui peut lui ouvrir le droit.
162
+ - Le compte d'une app est hors de l'équipe et dans aucun groupe : `ouverturesDe` ne lui rend que `personne:app:<nom>`. Il a ce qu'il crée et ce qui lui est ouvert nommément. Tout droit sur une chose se lit par `ouverturesDe` (`pourLaPersonne`, `lire`, `chercher`), jamais par une requête qui cite elle-même `equipe` ou un groupe.
160
163
  - `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
164
  - `ouvrirALaCreation(client, id)` s'appelle à chaque création, juste après l'`insert`, dans la transaction.
162
165
  - `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.
166
+ - 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
167
  - 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
168
  - `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
169
  - 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 +359,7 @@ Chaque écran prend de la bibliothèque ce qui se dessine pareil partout. Quatre
356
359
  Les tests de chaque app reposent sur ces aides ; ce qui reste dans ses tests lui est propre.
357
360
 
358
361
  - 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.
362
+ - `lancerLeFauxCore` : sessions, annuaire, apps déclarées, notifications, `fabriquerUnJeton`, qui fabrique aussi le jeton du compte d'une app (`compteDUneApp(app, titre)`). 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
363
  - `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
364
  - `servirLApp`, `connecter` (un client MCP, comme le core qui relaie Claude), `appeler` (rend `{ erreur, refus, texte, json }`).
362
365
  - 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
@@ -1,5 +1,5 @@
1
1
  {
2
2
  "nom": "bibliotheque",
3
- "version": "4.4.0",
3
+ "version": "4.6.0",
4
4
  "dependances": {}
5
5
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@indos/bibliotheque",
3
- "version": "4.4.0",
3
+ "version": "4.6.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",
package/src/appeler.d.ts CHANGED
@@ -9,5 +9,7 @@ export type ResultatDUnOutil = {
9
9
  _meta?: Record<string, unknown>;
10
10
  };
11
11
  export declare function estUnRefus(resultat: ResultatDUnOutil): boolean;
12
- export type Appeler = ReturnType<typeof creerLAppel>;
13
- export declare function creerLAppel(par: string, adresseDuCore?: string | undefined, cle?: string | undefined): (app: string, outil: string, arguments_: Record<string, unknown>, personne: Personne) => Promise<ResultatDUnOutil>;
12
+ export type Appeler = (app: string, outil: string, arguments_: Record<string, unknown>, personne: Personne) => Promise<ResultatDUnOutil>;
13
+ export type AppelerSousSonCompte = (app: string, outil: string, arguments_: Record<string, unknown>) => Promise<ResultatDUnOutil>;
14
+ export declare function creerLAppel(par: string, adresseDuCore?: string | undefined, cle?: string | undefined): Appeler;
15
+ export declare function creerLAppelSousSonCompte(par: string, adresseDuCore?: string | undefined, cle?: string | undefined): AppelerSousSonCompte;
package/src/appeler.js CHANGED
@@ -4,29 +4,41 @@
4
4
  export function estUnRefus(resultat) {
5
5
  return resultat.isError === true && resultat._meta?.['indos/refus'] === true;
6
6
  }
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 la clé commune des apps dans
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
- // d'un appel que le core refuse (clé, personne ou app inconnue) ou qui n'aboutit pas.
7
+ // L'appel d'une app à l'outil d'une autre, par le core (bibliotheque/CLAUDE.md, « Le MCP d'une
8
+ // app »), pour une personne. Une personne qui est le compte d'une app (`personne.app`) part sous son
9
+ // identifiant, `app:<nom>` : l'app appelée poursuit pour le compte qui l'a appelée. `par` est le nom
10
+ // de l'app qui appelle ; le kit passe sa clé d'appel dans CLE_D_APPEL à toute app dont le compose la
11
+ // cite, transmise telle quelle au core. Le résultat est celui de l'outil, refus compris ; une erreur
12
+ // ne vient que d'un appel que le core refuse (clé, personne ou app inconnue, app hors de `appelle`)
13
+ // ou qui n'aboutit pas.
11
14
  export function creerLAppel(par, adresseDuCore = process.env.CORE_ADRESSE, cle = process.env.CLE_D_APPEL) {
12
- return async function appeler(app, outil, arguments_, personne) {
13
- if (!adresseDuCore) {
14
- throw new Error('La variable CORE_ADRESSE manque : l\'adresse interne du core vient du kit.');
15
- }
16
- if (!cle) {
17
- throw new Error(`La variable CLE_D_APPEL manque : le compose de ${par} doit la citer, pour appeler ${app}.`);
18
- }
19
- const reponse = await fetch(new URL('/appeler', adresseDuCore), {
20
- method: 'POST',
21
- headers: { authorization: `Bearer ${cle}`, 'content-type': 'application/json' },
22
- body: JSON.stringify({ par, personne: personne.id, app, outil, arguments: arguments_ }),
23
- // Le core laisse 60 s pour joindre l'app, puis 60 s à l'outil.
24
- signal: AbortSignal.timeout(125_000),
25
- });
26
- const corps = (await reponse.json().catch(() => ({})));
27
- if (!reponse.ok) {
28
- throw new Error(`Le core refuse l'appel de ${app}_${outil} : ${corps.erreur ?? reponse.status}`);
29
- }
30
- return corps;
31
- };
15
+ return (app, outil, arguments_, personne) => appelerParLeCore({ par, adresseDuCore, cle }, app, outil, arguments_, personne);
16
+ }
17
+ // L'appel d'une app à l'outil d'une autre, par le core, sans personne : l'app agit sous son propre
18
+ // compte, `app:<par>`, dans les apps de son `appelle`, quand personne de l'équipe ne demande. Le core
19
+ // le refuse avec la clé commune des apps. Le reste comme `creerLAppel`.
20
+ export function creerLAppelSousSonCompte(par, adresseDuCore = process.env.CORE_ADRESSE, cle = process.env.CLE_D_APPEL) {
21
+ return (app, outil, arguments_) => appelerParLeCore({ par, adresseDuCore, cle }, app, outil, arguments_, undefined);
22
+ }
23
+ // `POST /appeler` au core : le corps porte `personne`, l'identifiant de l'auteur, quand il y en a
24
+ // une ; sans elle, l'app appelle sous son compte.
25
+ async function appelerParLeCore({ par, adresseDuCore, cle }, app, outil, arguments_, personne) {
26
+ if (!adresseDuCore) {
27
+ throw new Error('La variable CORE_ADRESSE manque : l\'adresse interne du core vient du kit.');
28
+ }
29
+ if (!cle) {
30
+ throw new Error(`La variable CLE_D_APPEL manque : le compose de ${par} doit la citer, pour appeler ${app}.`);
31
+ }
32
+ const reponse = await fetch(new URL('/appeler', adresseDuCore), {
33
+ method: 'POST',
34
+ headers: { authorization: `Bearer ${cle}`, 'content-type': 'application/json' },
35
+ body: JSON.stringify({ par, ...(personne ? { personne: personne.id } : {}), app, outil, arguments: arguments_ }),
36
+ // Le core laisse 60 s pour joindre l'app, puis 60 s à l'outil.
37
+ signal: AbortSignal.timeout(125_000),
38
+ });
39
+ const corps = (await reponse.json().catch(() => ({})));
40
+ if (!reponse.ok) {
41
+ throw new Error(`Le core refuse l'appel de ${app}_${outil} : ${corps.erreur ?? reponse.status}`);
42
+ }
43
+ return corps;
32
44
  }
@@ -8,8 +8,10 @@ import type { Personne } from './jeton.ts';
8
8
  import type { Annuaire } from './partage.ts';
9
9
  export declare const cleDuFauxCore: KeyObject, clePubliqueDuFauxCore: KeyObject;
10
10
  export declare function fabriquerUnJeton(personne: Personne, app: string, cle?: KeyObject): string;
11
+ export declare function compteDUneApp(app: string, titre: string): Personne;
11
12
  export declare const logoDEssai = "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 10 10\"><rect width=\"10\" height=\"10\"/></svg>";
12
13
  export declare const cleDAppelDuFauxCore = "cle-d-appel-du-faux-core";
14
+ export declare function fabriquerUneCleDAppel(app: string): string;
13
15
  export type NotificationRecue = {
14
16
  par: string;
15
17
  pour: string;
package/src/faux-core.js CHANGED
@@ -3,25 +3,51 @@ 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.
9
10
  export const { privateKey: cleDuFauxCore, publicKey: clePubliqueDuFauxCore } = generateKeyPairSync('ed25519');
10
- // Le jeton porte les groupes de la personne quand elle en a (`groupes`).
11
+ // Le jeton porte les groupes de la personne quand elle en a (`groupes`). Pour le compte d'une app
12
+ // (`personne.app`), il est celui du core : `sub` `app:<nom>`, `app`, `nom`, `proprietaire: false`,
13
+ // `groupes: []`, sans `email`.
11
14
  export function fabriquerUnJeton(personne, app, cle = cleDuFauxCore) {
12
15
  const iat = Math.floor(Date.now() / 1000);
13
16
  const b64 = (valeur) => Buffer.from(JSON.stringify(valeur)).toString('base64url');
14
- const donnees = `${b64({ alg: 'EdDSA', typ: 'JWT' })}.${b64({
15
- iss: 'core', sub: personne.id, aud: app, email: personne.email, nom: personne.nom,
16
- proprietaire: personne.proprietaire, ...(personne.groupes ? { groupes: personne.groupes } : {}), iat, exp: iat + 60,
17
- })}`;
17
+ const qui = personne.app !== undefined
18
+ ? { sub: `app:${personne.app}`, nom: personne.nom, app: personne.app, proprietaire: false, groupes: [] }
19
+ : { sub: personne.id, email: personne.email, nom: personne.nom, proprietaire: personne.proprietaire, ...(personne.groupes ? { groupes: personne.groupes } : {}) };
20
+ const donnees = `${b64({ alg: 'EdDSA', typ: 'JWT' })}.${b64({ iss: 'core', ...qui, aud: app, iat, exp: iat + 60 })}`;
18
21
  return `${donnees}.${sign(null, Buffer.from(donnees), cle).toString('base64url')}`;
19
22
  }
23
+ // Le compte d'une app, tel que le vérificateur le rend : à donner à `connecter` ou à
24
+ // `fabriquerUnJeton`.
25
+ export function compteDUneApp(app, titre) {
26
+ return { id: `app:${app}`, email: '', nom: titre, proprietaire: false, groupes: [], app };
27
+ }
20
28
  // Un logo d'essai, à donner au faux core.
21
29
  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 attend à `/notifier`, que le test donne à l'app
23
- // (`creerLeNotificateur(par, adresse, cleDAppelDuFauxCore)`, ou `CLE_D_APPEL`).
30
+ // La clé commune des apps que le faux core reconnaît à `/notifier` et à `/annuaire`, que le test
31
+ // donne à l'app (`creerLeNotificateur(par, adresse, cleDAppelDuFauxCore)`, ou `CLE_D_APPEL`) : l'app
32
+ // y notifie sous le nom qu'elle se donne.
24
33
  export const cleDAppelDuFauxCore = 'cle-d-appel-du-faux-core';
34
+ // La clé maître du faux core, dont dérive la clé d'appel de chaque app.
35
+ const cleMaitreDuFauxCore = Buffer.alloc(32, 9);
36
+ // La clé d'appel d'une app, dans la forme que le kit écrit dans `CLE_D_APPEL` : `<app>.<clé>`, la
37
+ // clé `deriver(clé du core, "appel/<app>")` en base64, ici celle du faux core. Avec elle, l'app
38
+ // notifie sous son seul nom.
39
+ export function fabriquerUneCleDAppel(app) {
40
+ return `${app}.${deriver(cleMaitreDuFauxCore, `appel/${app}`).toString('base64')}`;
41
+ }
42
+ // Qui appelle le faux core, d'après l'en-tête `Authorization`, comme au core : l'app que nomme sa
43
+ // clé, la clé commune, ou rien.
44
+ function quiAppelle(entete) {
45
+ if (entete === `Bearer ${cleDAppelDuFauxCore}`) {
46
+ return { commune: true };
47
+ }
48
+ const app = /^Bearer ([a-z0-9]+(?:-[a-z0-9]+)*)\./.exec(entete ?? '')?.[1];
49
+ return app && entete === `Bearer ${fabriquerUneCleDAppel(app)}` ? { app } : undefined;
50
+ }
25
51
  const notificationsRecues = new Map();
26
52
  // Les notifications qu'a reçues le faux core d'`adresse` (celle que rend `lancerLeFauxCore`), dans
27
53
  // l'ordre d'arrivée, une par personne, de `pour` seulement quand il est donné.
@@ -80,13 +106,14 @@ export function sessionDuCore(apps, proprietaire, nomDeLOS, groupes = []) {
80
106
  // déclare pas est fermée à tous, comme au core : le test d'une app qui reconnaît la personne à sa
81
107
  // session (une page, un geste d'écran, `POST /outils`) la déclare.
82
108
  // 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
109
+ // actives, sans groupe ; sans en-tête `Authorization`, ou avec la clé d'une app
110
+ // (`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
111
  // retire un membre d'un groupe ou désactive une personne en cours de route, sur l'objet qu'il a
85
112
  // passé, le voit à l'appel suivant.
86
113
  // Il sert `theme.logo` sur `/theme/logo.svg`, lu à chaque requête (un test le change en cours de
87
114
  // route), ou 404 sans logo.
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 ;
115
+ // Il reçoit les notifications des apps à `POST /notifier`, comme le core : la clé d'une app, `par`
116
+ // étant son nom (401 sinon), ou la clé commune ; `{ par, pour, auteur?, sorte, phrase, chemin }`, un chemin sous l'app ;
90
117
  // il les garde, à lire par `notificationsDuFauxCore`, et répond `{ notifiees }`. Avec
91
118
  // `notifications: true`, la session porte le nombre de notifications reçues par la personne, comme
92
119
  // celle du core.
@@ -133,6 +160,11 @@ export async function lancerLeFauxCore(t, sessions = {}, theme = {}, apps = [],
133
160
  return;
134
161
  }
135
162
  if (requete.url === '/annuaire') {
163
+ if (requete.headers.authorization !== undefined && !quiAppelle(requete.headers.authorization)) {
164
+ reponse.writeHead(401, { 'content-type': 'application/json' });
165
+ reponse.end(JSON.stringify({ erreur: 'La clé d\'appel ne convient pas.' }));
166
+ return;
167
+ }
136
168
  reponse.writeHead(200, { 'content-type': 'application/json' });
137
169
  reponse.end(JSON.stringify(servi));
138
170
  return;
@@ -155,7 +187,8 @@ async function recevoirUneNotification(requete, reponse, adresse) {
155
187
  reponse.writeHead(statut, { 'content-type': 'application/json' });
156
188
  reponse.end(JSON.stringify(corps));
157
189
  };
158
- if (requete.headers.authorization !== `Bearer ${cleDAppelDuFauxCore}`) {
190
+ const appelant = quiAppelle(requete.headers.authorization);
191
+ if (!appelant) {
159
192
  repondre(401, { erreur: 'La clé d\'appel est refusée.' });
160
193
  return;
161
194
  }
@@ -178,6 +211,10 @@ async function recevoirUneNotification(requete, reponse, adresse) {
178
211
  repondre(400, { erreur: 'Il faut {"par", "pour", "auteur"?, "sorte", "phrase", "chemin"}.' });
179
212
  return;
180
213
  }
214
+ if ('app' in appelant && par !== appelant.app) {
215
+ repondre(401, { erreur: `La clé d'appel est celle de l'app ${appelant.app} : \`par\` doit être ${appelant.app}.` });
216
+ return;
217
+ }
181
218
  if (chemin !== `/${par}` && !chemin.startsWith(`/${par}/`)) {
182
219
  repondre(400, { erreur: `Le chemin d'une notification est sous /${par}.` });
183
220
  return;
package/src/jeton.d.ts CHANGED
@@ -4,6 +4,7 @@ export type Personne = {
4
4
  nom: string;
5
5
  proprietaire: boolean;
6
6
  groupes?: string[];
7
+ app?: string;
7
8
  };
8
9
  export declare class JetonRefuse extends Error {
9
10
  }
package/src/jeton.js CHANGED
@@ -2,7 +2,10 @@ import { createPublicKey, verify } from 'node:crypto';
2
2
  export class JetonRefuse extends Error {
3
3
  }
4
4
  // Vérifie le jeton court que le core joint à chaque appel d'une app (bibliotheque/CLAUDE.md, « Le
5
- // MCP d'une app ») : un JWT signé en Ed25519, valable une minute, pour cette app.
5
+ // MCP d'une app ») : un JWT signé en Ed25519, valable une minute, pour cette app. Il nomme une
6
+ // personne, ou le compte d'une app : `app` le nom de l'app, `sub` `app:<nom>`, `proprietaire` faux,
7
+ // sans `email` ; un jeton qui porte `app` sans tenir ces règles est refusé, comme un jeton de
8
+ // personne dont `sub` commence par `app:`.
6
9
  // La clé publique vient du core, à CORE_ADRESSE ; elle reste en mémoire, et se relit quand une
7
10
  // signature échoue (le core a changé de clé), une fois par minute au plus.
8
11
  // `horloge` ne sert qu'aux tests.
@@ -54,7 +57,11 @@ export function creerLeVerificateur(app, adresseDuCore = process.env.CORE_ADRESS
54
57
  throw new JetonRefuse('Le jeton a expiré.');
55
58
  }
56
59
  const { sub, email, nom, proprietaire, groupes } = contenu;
57
- if (typeof sub !== 'string' || typeof email !== 'string' || typeof nom !== 'string' || typeof proprietaire !== 'boolean') {
60
+ if (contenu.app !== undefined) {
61
+ return compteDUneApp(contenu);
62
+ }
63
+ // `app:` n'ouvre que le compte d'une app : un jeton de personne ne prend pas cet identifiant.
64
+ if (typeof sub !== 'string' || sub.startsWith('app:') || typeof email !== 'string' || typeof nom !== 'string' || typeof proprietaire !== 'boolean') {
58
65
  throw new JetonRefuse('Le jeton ne nomme pas la personne.');
59
66
  }
60
67
  if (groupes === undefined) {
@@ -66,6 +73,16 @@ export function creerLeVerificateur(app, adresseDuCore = process.env.CORE_ADRESS
66
73
  return { id: sub, email, nom, proprietaire, groupes };
67
74
  };
68
75
  }
76
+ // Le compte d'une app que nomme le jeton : il n'a ni courriel, ni groupe, et n'est jamais
77
+ // propriétaire de l'OS.
78
+ function compteDUneApp({ app, sub, email, nom, proprietaire, groupes }) {
79
+ if (typeof app !== 'string' || !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(app) || sub !== `app:${app}` ||
80
+ typeof nom !== 'string' || proprietaire !== false || email !== undefined ||
81
+ (groupes !== undefined && (!Array.isArray(groupes) || groupes.length > 0))) {
82
+ throw new JetonRefuse('Le jeton ne nomme pas le compte d\'une app.');
83
+ }
84
+ return { id: sub, email: '', nom, proprietaire: false, groupes: [], app };
85
+ }
69
86
  function estValide(donnees, cle, signature) {
70
87
  try {
71
88
  return verify(null, donnees, cle, signature);
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 la clé commune des apps
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
@@ -12,23 +12,34 @@ const ordreDesDroits = { lecture: 1, modification: 2, proprietaire: 3 };
12
12
  export function suffit(droit, attendu) {
13
13
  return droit !== undefined && ordreDesDroits[droit] >= ordreDesDroits[attendu];
14
14
  }
15
- // Les valeurs de `avec` qui ouvrent une chose à la personne : elle, ses groupes, l'équipe.
15
+ // Les valeurs de `avec` qui ouvrent une chose à la personne : elle, ses groupes, l'équipe. Le
16
+ // compte d'une app est hors de l'équipe et dans aucun groupe : une chose ne lui est ouverte que
17
+ // nommément, `personne:app:<nom>`.
16
18
  export function ouverturesDe(personne) {
19
+ if (personne.app !== undefined) {
20
+ return [`personne:${personne.id}`];
21
+ }
17
22
  return ['equipe', `personne:${personne.id}`, ...(personne.groupes ?? []).map((groupe) => `groupe:${groupe}`)];
18
23
  }
24
+ // Qui appelle, dans le texte d'un refus : le courriel d'une personne, le nom du compte d'une app,
25
+ // qui n'a pas de courriel.
26
+ function designer(personne) {
27
+ return personne.email || personne.nom;
28
+ }
19
29
  // Lit l'annuaire du core (`CORE_ADRESSE/annuaire`), gardé `dureeDeLAnnuaire`. Un core qui ne le
20
30
  // donne pas, ou qui ne répond pas, lève une erreur, qui n'est pas gardée. `{ sansCache: true }` le
21
31
  // 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.
32
+ // désactivée ; la lecture remplace celle gardée. `cle`, la clé d'appel de l'app (`CLE_D_APPEL` par
33
+ // défaut), part en `Authorization: Bearer <cle>` ; sans elle, l'annuaire se demande sans en-tête.
23
34
  // `horloge` ne sert qu'aux tests.
24
- export function creerLAnnuaire(adresseDuCore = process.env.CORE_ADRESSE, horloge = Date.now) {
35
+ export function creerLAnnuaire(adresseDuCore = process.env.CORE_ADRESSE, horloge = Date.now, cle = process.env.CLE_D_APPEL) {
25
36
  let garde;
26
37
  return function lireLAnnuaire({ sansCache = false } = {}) {
27
38
  if (!adresseDuCore) {
28
39
  return Promise.reject(new Error('La variable CORE_ADRESSE manque : l\'adresse interne du core vient du kit.'));
29
40
  }
30
41
  if (sansCache || !garde || horloge() - garde.lu >= dureeDeLAnnuaire) {
31
- const lecture = { lu: horloge(), annuaire: demanderLAnnuaire(new URL('/annuaire', adresseDuCore)) };
42
+ const lecture = { lu: horloge(), annuaire: demanderLAnnuaire(new URL('/annuaire', adresseDuCore), cle) };
32
43
  lecture.annuaire.catch(() => {
33
44
  if (garde === lecture) {
34
45
  garde = undefined;
@@ -39,8 +50,8 @@ export function creerLAnnuaire(adresseDuCore = process.env.CORE_ADRESSE, horloge
39
50
  return garde.annuaire;
40
51
  };
41
52
  }
42
- async function demanderLAnnuaire(adresse) {
43
- const reponse = await fetch(adresse, { signal: AbortSignal.timeout(5000) });
53
+ async function demanderLAnnuaire(adresse, cle) {
54
+ const reponse = await fetch(adresse, { headers: cle ? { authorization: `Bearer ${cle}` } : {}, signal: AbortSignal.timeout(5000) });
44
55
  if (!reponse.ok) {
45
56
  throw new Error(`Le core ne donne pas l'annuaire : ${reponse.status}.`);
46
57
  }
@@ -165,7 +176,7 @@ export function creerLePartage(options) {
165
176
  // lit le droit : la racine, ou la chose elle-même.
166
177
  const depuis = racine ? `${table} join ${table} as racine on racine.id = ${table}.${racine}` : table;
167
178
  const aliasDuDroit = racine ? 'racine' : table;
168
- const lireLAnnuaire = creerLAnnuaire(options.adresseDuCore ?? process.env.CORE_ADRESSE);
179
+ const lireLAnnuaire = creerLAnnuaire(options.adresseDuCore ?? process.env.CORE_ADRESSE, Date.now, options.cleDAppel);
169
180
  const { chemin } = options;
170
181
  const nomAffiche = (lu) => (lu?.trim() ? lu : options.sansNom ?? 'Sans titre');
171
182
  // La notification d'une chose : `notifier` ne lève jamais, et part après l'écriture, hors de toute
@@ -367,7 +378,7 @@ export function creerLePartage(options) {
367
378
  throw new Refus('Dire avec qui partager : `personnes`, `groupes` ou `equipe: true`.');
368
379
  }
369
380
  if (visees.some((cible) => cible.avec === `personne:${personne.id}`)) {
370
- throw new Refus(`Rien n'est partagé : ${laChose} est déjà à ${personne.email}.`);
381
+ throw new Refus(`Rien n'est partagé : ${laChose} est déjà à ${designer(personne)}.`);
371
382
  }
372
383
  for (const cible of visees) {
373
384
  const connue = annuaire.personnes.find((une) => `personne:${une.id}` === cible.avec);
@@ -423,13 +434,13 @@ export function creerLePartage(options) {
423
434
  const annuaire = await lireLAnnuaire();
424
435
  const a = personneDuCourriel(annuaire, arguments_.a, 'Rien n\'est donné');
425
436
  if (a.id === personne.id) {
426
- throw new Refus(`Rien n'est donné : ${laChose} est déjà à ${personne.email}.`);
437
+ throw new Refus(`Rien n'est donné : ${laChose} est déjà à ${designer(personne)}.`);
427
438
  }
428
439
  if (!a.active) {
429
440
  throw new Refus(`Rien n'est donné : ${a.nom} (${a.email}) est désactivée et ne se connecte plus.`);
430
441
  }
431
442
  if (arguments_.confirmer !== true) {
432
- throw new Refus(`Rien n'est donné : ${laChose} « ${lue.nom} » passerait à ${a.nom} (${a.email}), qui en deviendrait propriétaire ; elle ne serait plus à ${personne.email}, qui n'y garderait que ce que son partage lui ouvre. Dire à la personne ce qui change, et ne rappeler avec confirmer: true qu'après son accord explicite.`);
443
+ throw new Refus(`Rien n'est donné : ${laChose} « ${lue.nom} » passerait à ${a.nom} (${a.email}), qui en deviendrait propriétaire ; elle ne serait plus à ${designer(personne)}, qui n'y garderait que ce que son partage lui ouvre. Dire à la personne ce qui change, et ne rappeler avec confirmer: true qu'après son accord explicite.`);
433
444
  }
434
445
  await enTransaction(base, async (client) => {
435
446
  await exigerLaPropriete(personne, lue.id, { client });