@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 +9 -6
- package/manifeste.json +1 -1
- package/package.json +1 -1
- package/src/appeler.d.ts +4 -2
- package/src/appeler.js +36 -24
- package/src/faux-core.d.ts +2 -0
- package/src/faux-core.js +48 -11
- package/src/jeton.d.ts +1 -0
- package/src/jeton.js +19 -2
- package/src/notifier.js +1 -1
- package/src/partage.d.ts +1 -1
- package/src/partage.js +21 -10
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
|
|
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
|
|
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
package/package.json
CHANGED
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 =
|
|
13
|
-
export
|
|
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,
|
|
8
|
-
//
|
|
9
|
-
//
|
|
10
|
-
//
|
|
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
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
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
|
}
|
package/src/faux-core.d.ts
CHANGED
|
@@ -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
|
|
15
|
-
|
|
16
|
-
proprietaire: personne.proprietaire, ...(personne.groupes ? { groupes: personne.groupes } : {})
|
|
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
|
|
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
|
|
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é
|
|
89
|
-
// (
|
|
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
|
-
|
|
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
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 (
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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 });
|