@indos/bibliotheque 4.5.0 → 4.7.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
@@ -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.
@@ -152,15 +154,17 @@ Un outil ou un geste paginé reçoit `page`, un entier à partir de 1 (1 s'il ma
152
154
 
153
155
  ### Le partage
154
156
 
155
- 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`.
157
+ Une chose est toujours à une personne, ou au compte de l'app qui l'a créée, et s'ouvre à des personnes, à des groupes, à toute l'équipe ou au compte d'une app, 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, par `apps` de `partager`. Il n'est jamais notifié d'un partage. 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
- - `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, 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.
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. Les cibles de `partager` et `ne_plus_partager` : `personnes` (des courriels), `groupes` (des noms), `apps` (des noms d'apps, pour leur compte), `equipe`. Un partage qui s'élargit (une cible nouvelle, la lecture qui passe en modification) et un don demandent `confirmer: true` ; le refus dit à qui la chose s'ouvrirait (« à l'app Boutique » pour un compte). Sans cible, ils refusent. `donner` ne donne qu'à une personne de l'équipe, jamais à un compte.
166
+ - Les cibles se cherchent dans l'annuaire du core (`personnes`, `groupes`, `apps`), lu avec la clé d'appel de l'app quand elle l'a et gardé cinq secondes : une personne, un groupe ou une app inconnus (le refus nomme les apps), une personne désactivée ou soi-même sont refusés. Le compte d'une app retirée qui a une ouverture se retire encore par son nom. 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.
167
+ - Le partage lu (`partageDe`, ce que `lire` en rend) nomme chaque ouverture (`Ouverture`) : toute l'équipe, puis un groupe par son nom, une personne avec son courriel, le compte d'une app par le titre de l'app avec son nom (`{ avec: 'app', nom, app, droit }`) ; un groupe supprimé et une app retirée se disent tels. `nomDe` nomme qui possède une chose, une personne ou un compte, par le titre de son app.
164
168
  - 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
169
  - `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
170
  - Après un partage, un don ou une publication, l'outil relit ce qui en dépend (le droit des connexions en direct).
@@ -172,7 +176,7 @@ Une app notifie une personne de ce qu'un autre a fait et qui la concerne : `cree
172
176
 
173
177
  - L'auteur n'est jamais notifié de son propre geste, Claude agissant pour lui compris.
174
178
  - `notifier` part après l'écriture validée, jamais dans une transaction, une fois, délai de 3 secondes, et ne lève jamais. Un échec s'écrit au journal sans l'adresse des personnes ni la phrase.
175
- - Le partage des choses et des comptes notifie seul quand l'app déclare le chemin de ses choses (`chemin`, `app`) : un partage qui s'élargit et un don, à qui y gagne ; ni un retrait, ni un repartage à l'identique.
179
+ - Le partage des choses et des comptes notifie seul quand l'app déclare le chemin de ses choses (`chemin`, `app`) : un partage qui s'élargit et un don, à qui y gagne ; ni un retrait, ni un repartage à l'identique, ni le compte d'une app.
176
180
 
177
181
  ### Les fichiers d'une chose
178
182
 
@@ -230,7 +234,7 @@ L'accès d'une personne à un service extérieur (une boîte mail, un agenda, un
230
234
 
231
235
  ### Le partage des comptes
232
236
 
233
- `creerLePartageDesComptes(options)` donne à la table des comptes le partage de toute chose ; `comptesVisibles`, `choisirLeCompte(personne, compte, { droit, aucun })`, `personneDuLien`, `quiRebranche`. La lecture consulte, la modification agit aussi, la propriété seule modifie le branchement, le retire, le partage, le donne et publie un lien chez le fournisseur ; le propriétaire de l'OS n'a aucun droit de plus. Partager et donner un compte ne sont que des gestes d'écran : aucun outil ne les offre. Au départ d'une personne, `donner_les_choses` ne passe que les comptes ouverts à quelqu'un et `donnable`.
237
+ `creerLePartageDesComptes(options)` donne à la table des comptes le partage de toute chose ; `comptesVisibles`, `choisirLeCompte(personne, compte, { droit, aucun })`, `personneDuLien`, `quiRebranche`. La lecture consulte, la modification agit aussi, la propriété seule modifie le branchement, le retire, le partage, le donne et publie un lien chez le fournisseur ; le propriétaire de l'OS n'a aucun droit de plus. Partager et donner un compte ne sont que des gestes d'écran : aucun outil ne les offre. Le propriétaire d'un compte l'ouvre au compte d'une app comme à une personne (`apps` des gestes `partager` et `ne-plus-partager`) : l'app s'en sert sous son compte, avec le droit ouvert. Au départ d'une personne, `donner_les_choses` ne passe que les comptes ouverts à quelqu'un et `donnable`.
234
238
 
235
239
  ## La page de l'espace
236
240
 
@@ -283,6 +287,7 @@ Une app dont la personne liste et ouvre des choses (pages, documents, contacts,
283
287
  - Un geste propre qui change les choses les relit par `useRelireLesChoses(app)`.
284
288
  - Un geste définitif passe par `ConfirmationDUnGeste`. Quand seul le serveur connaît sa portée, l'écran appelle sans accord ; le refus qui demande l'accord (`demandeLAccord`) devient la question, en mots de la personne, et le verbe rappelle avec `confirmer: true`. Le texte du refus, écrit pour Claude, ne se montre jamais. Un autre refus se lit mot pour mot.
285
289
  - Supprimer est toujours dans le ⋯. Une chose rangée dans une autre n'a pas « Partager… » : elle suit sa racine.
290
+ - Le panneau du partage, celui des comptes branchés compris, propose dans « Ouvrir à » toute l'équipe, les groupes, les personnes, puis les apps (« App <titre> »), lus à `/espace/annuaire` du core ; une ouverture au compte d'une app se montre au titre de l'app, « App » sous lui, et celle d'une app retirée n'a que « Retirer ».
286
291
  - `useDansLApercu()` dit qu'un corps est rendu dans l'aperçu.
287
292
 
288
293
  ### Le direct à l'écran
@@ -356,7 +361,7 @@ Chaque écran prend de la bibliothèque ce qui se dessine pareil partout. Quatre
356
361
  Les tests de chaque app reposent sur ces aides ; ce qui reste dans ses tests lui est propre.
357
362
 
358
363
  - Node :
359
- - `lancerLeFauxCore` : sessions, annuaire, apps déclarées, notifications, `fabriquerUnJeton`. Il reconnaît la clé d'une app, `fabriquerUneCleDAppel(app)`, sous laquelle l'app notifie sous son seul nom, et la clé commune, `cleDAppelDuFauxCore` ; il sert l'annuaire sans clé ou sous l'une d'elles. Une app qu'il ne déclare pas est fermée à tous, comme au core : le test d'une app qui reconnaît la personne à sa session (une page, un geste d'écran, `POST /outils`) la déclare.
364
+ - `lancerLeFauxCore` : sessions, annuaire (avec les `apps` que le test lui donne, pour partager avec leur compte), 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
365
  - `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
366
  - `servirLApp`, `connecter` (un client MCP, comme le core qui relaie Claude), `appeler` (rend `{ erreur, refus, texte, json }`).
362
367
  - 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.5.0",
3
+ "version": "4.7.0",
4
4
  "dependances": {}
5
5
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@indos/bibliotheque",
3
- "version": "4.5.0",
3
+ "version": "4.7.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 sa clé d'appel dans
9
- // CLE_D_APPEL à toute app dont le compose la cite, transmise telle quelle au core. Le résultat est celui de l'outil, refus compris ; une erreur ne vient que
10
- // 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
  }
package/src/compte.js CHANGED
@@ -7,9 +7,9 @@ import { creerLaSession } from './session.js';
7
7
  // personne à un service extérieur, comme une boîte mail, un agenda ou un kDrive. Il vit dans la
8
8
  // base de l'app qui s'en sert, son secret chiffré ; la personne le branche, le modifie et le retire
9
9
  // dans les réglages de l'app, sur l'écran commun des comptes. Il est à elle seule tant qu'elle ne
10
- // l'ouvre à personne ; elle peut l'ouvrir à des personnes, à des groupes ou à toute l'équipe, en
11
- // lecture ou en modification, et le donner (`creerLePartageDesComptes`). Claude ne voit jamais son
12
- // secret.
10
+ // l'ouvre à personne ; elle peut l'ouvrir à des personnes, à des groupes, à toute l'équipe ou au
11
+ // compte d'une app, en lecture ou en modification, et le donner (`creerLePartageDesComptes`).
12
+ // Claude ne voit jamais son secret.
13
13
  // Le secret d'un compte (un mot de passe, un jeton), chiffré en AES-256-GCM par une clé de l'app
14
14
  // tirée de `CLE` (`deriver(CLE, <usage>)`) : le vecteur (12 octets), l'étiquette (16) et le
15
15
  // chiffré, ensemble en base64. L'identifiant du compte entre dans les données authentifiées : un
@@ -223,8 +223,8 @@ export function creerLesGestesDesComptes(options) {
223
223
  };
224
224
  if (partage) {
225
225
  // Les arguments des gestes du partage : ceux des outils `partager` et `ne_plus_partager` d'une
226
- // chose, sans rien d'autre.
227
- const cibles = (corps) => ({ personnes: corps.personnes, groupes: corps.groupes, equipe: corps.equipe });
226
+ // chose, sans rien d'autre : des personnes, des groupes, toute l'équipe, des comptes d'apps.
227
+ const cibles = (corps) => ({ personnes: corps.personnes, groupes: corps.groupes, apps: corps.apps, equipe: corps.equipe });
228
228
  Object.assign(gestes, {
229
229
  async partage(personne, corps) {
230
230
  return { ouvertures: await partage.partageDe(await idDuProprietaire(personne, corps)) };
@@ -12,6 +12,10 @@ export type AnnuaireDeLEcran = {
12
12
  id: string;
13
13
  nom: string;
14
14
  }[];
15
+ apps?: {
16
+ nom: string;
17
+ titre: string;
18
+ }[];
15
19
  };
16
20
  export declare function epingler(epingle: Epingle): Promise<unknown>;
17
21
  export declare function desepingler(epingle: Pick<Epingle, 'chemin'>): Promise<unknown>;
@@ -10,8 +10,8 @@ export function epingler(epingle) {
10
10
  export function desepingler(epingle) {
11
11
  return faireUnGeste('/espace/desepingler', { chemin: epingle.chemin });
12
12
  }
13
- // `POST /espace/annuaire`, `{}` : les personnes actives (`id`, `nom`, `email`) et les groupes (`id`,
14
- // `nom`), pour le panneau du partage.
13
+ // `POST /espace/annuaire`, `{}` : les personnes actives (`id`, `nom`, `email`), les groupes (`id`,
14
+ // `nom`) et les apps (`nom`, `titre`), pour le panneau du partage.
15
15
  export function lireLAnnuaire() {
16
16
  return faireUnGeste('/espace/annuaire');
17
17
  }
@@ -25,14 +25,16 @@ export type CritereDeRecherche = {
25
25
  page: number;
26
26
  };
27
27
  export type OuvertureDUneChose = {
28
- avec: 'equipe' | 'groupe' | 'personne';
28
+ avec: 'equipe' | 'groupe' | 'personne' | 'app';
29
29
  nom: string;
30
30
  email?: string;
31
+ app?: string;
31
32
  droit: 'lecture' | 'modification';
32
33
  };
33
34
  export type CiblesDuPartage = {
34
35
  personnes?: string[];
35
36
  groupes?: string[];
37
+ apps?: string[];
36
38
  equipe?: true;
37
39
  };
38
40
  export type ColonneDUneChose<C extends ChoseTrouvee = ChoseTrouvee> = {
@@ -24,15 +24,19 @@ function ciblesDe(ouverture) {
24
24
  if (ouverture.avec === 'groupe') {
25
25
  return { groupes: [ouverture.nom] };
26
26
  }
27
+ if (ouverture.avec === 'app') {
28
+ return ouverture.app ? { apps: [ouverture.app] } : undefined;
29
+ }
27
30
  return ouverture.email ? { personnes: [ouverture.email] } : undefined;
28
31
  }
29
- // À qui s'ouvre une cible, dans une phrase : « à toute l'équipe », « au groupe Atelier », « à Léa ».
32
+ // À qui s'ouvre une cible, dans une phrase : « à toute l'équipe », « au groupe Atelier », « à Léa »,
33
+ // « à l'app Boutique ».
30
34
  function quiDe(avec, nom) {
31
- return avec === 'equipe' ? 'à toute l\'équipe' : avec === 'groupe' ? `au groupe ${nom}` : `à ${nom}`;
35
+ return avec === 'equipe' ? 'à toute l\'équipe' : avec === 'groupe' ? `au groupe ${nom}` : avec === 'app' ? `à l'app ${nom}` : `à ${nom}`;
32
36
  }
33
- // Une cible en tête de phrase : « Toute l'équipe », « Le groupe Atelier », « Léa ».
37
+ // Une cible en tête de phrase : « Toute l'équipe », « Le groupe Atelier », « Léa », « L'app Boutique ».
34
38
  function sujetDe(avec, nom) {
35
- return avec === 'equipe' ? 'Toute l\'équipe' : avec === 'groupe' ? `Le groupe ${nom}` : nom;
39
+ return avec === 'equipe' ? 'Toute l\'équipe' : avec === 'groupe' ? `Le groupe ${nom}` : avec === 'app' ? `L'app ${nom}` : nom;
36
40
  }
37
41
  // La valeur d'une cible dans la liste « Ouvrir à », et ses cibles.
38
42
  function ciblesDeLaValeur(valeur) {
@@ -40,7 +44,7 @@ function ciblesDeLaValeur(valeur) {
40
44
  return { equipe: true };
41
45
  }
42
46
  const [sorte, ...reste] = valeur.split(':');
43
- return sorte === 'groupe' ? { groupes: [reste.join(':')] } : { personnes: [reste.join(':')] };
47
+ return sorte === 'groupe' ? { groupes: [reste.join(':')] } : sorte === 'app' ? { apps: [reste.join(':')] } : { personnes: [reste.join(':')] };
44
48
  }
45
49
  // Le partage lu par la pastille, que le panneau reprend sans le relire ; chaque geste du panneau et
46
50
  // sa fermeture le relisent.
@@ -102,15 +106,26 @@ function ContenuDuPartage({ choses, chose, mots, avertissement, fermer, surFerme
102
106
  },
103
107
  });
104
108
  const ouvertures = partage.data ?? [];
105
- const dejaOuvertes = new Set(ouvertures.map((ouverture) => (ouverture.avec === 'equipe' ? 'equipe' : ouverture.avec === 'groupe' ? `groupe:${ouverture.nom}` : `personne:${ouverture.email ?? ''}`)));
109
+ const valeurDe = (ouverture) => (ouverture.avec === 'equipe' ? 'equipe' : ouverture.avec === 'groupe' ? `groupe:${ouverture.nom}` : ouverture.avec === 'app' ? `app:${ouverture.app ?? ''}` : `personne:${ouverture.email ?? ''}`);
110
+ const dejaOuvertes = new Set(ouvertures.map(valeurDe));
111
+ const apps = annuaire.data?.apps ?? [];
106
112
  const options = [
107
113
  { valeur: 'equipe', libelle: 'Toute l\'équipe' },
108
114
  ...(annuaire.data?.groupes ?? []).map((groupe) => ({ valeur: `groupe:${groupe.nom}`, libelle: `Groupe ${groupe.nom}` })),
109
115
  ...(annuaire.data?.personnes ?? []).filter((personne) => personne.email !== session.email).map((personne) => ({ valeur: `personne:${personne.email}`, libelle: personne.nom })),
116
+ ...apps.map((app) => ({ valeur: `app:${app.nom}`, libelle: `App ${app.titre}` })),
110
117
  ].filter((option) => !dejaOuvertes.has(option.valeur));
111
118
  const libelleDe = (valeur) => options.find((option) => option.valeur === valeur)?.libelle ?? valeur;
112
- const sorteDeLaValeur = (valeur) => (valeur === 'equipe' ? 'equipe' : valeur.startsWith('groupe:') ? 'groupe' : 'personne');
113
- const nomDeLaValeur = (valeur) => (valeur === 'equipe' ? '' : valeur.startsWith('groupe:') ? valeur.slice('groupe:'.length) : libelleDe(valeur));
119
+ const sorteDeLaValeur = (valeur) => (valeur === 'equipe' ? 'equipe' : valeur.startsWith('groupe:') ? 'groupe' : valeur.startsWith('app:') ? 'app' : 'personne');
120
+ const nomDeLaValeur = (valeur) => (valeur === 'equipe'
121
+ ? ''
122
+ : valeur.startsWith('groupe:')
123
+ ? valeur.slice('groupe:'.length)
124
+ : valeur.startsWith('app:')
125
+ ? apps.find((app) => `app:${app.nom}` === valeur)?.titre ?? valeur.slice('app:'.length)
126
+ : libelleDe(valeur));
127
+ // Le compte d'une app que l'annuaire ne connaît plus : son app est retirée.
128
+ const estRetiree = (ouverture) => ouverture.avec === 'app' && annuaire.data !== undefined && !apps.some((app) => app.nom === ouverture.app);
114
129
  const droitPublic = droitDuLien(choses, chose);
115
130
  const publication = motsDeLaPublication(choses.publication, choses, droitPublic);
116
131
  const droitsDuLien = choses.publication?.droits ?? [];
@@ -137,12 +152,15 @@ function ContenuDuPartage({ choses, chose, mots, avertissement, fermer, surFerme
137
152
  ? (_jsxs("span", { className: "flex items-center gap-1.5", children: [_jsx("span", { className: "text-[13px] text-gris", children: "Propri\u00E9taire" }), _jsx(DonDeLaPropriete, { choses: choses, chose: chose, apres: fermer, surFermee: surFermee })] }))
138
153
  : _jsx("span", { className: "text-[13px] text-gris", children: "Propri\u00E9taire" }) }), ouvertures.map((ouverture) => {
139
154
  const cibles = ciblesDe(ouverture);
140
- return (_jsx(LigneDuPartage, { nom: ouverture.nom, detail: ouverture.email, fin: proprietaire && cibles && choses.partager && choses.nePlusPartager
141
- ? (_jsxs("span", { className: "flex items-center gap-1.5", children: [_jsx(Choix, { libelle: `Droit de ${ouverture.nom}`, libelleMasque: true, taille: "petite", options: droits, valeur: ouverture.droit, disabled: geste.isPending, onValeurChange: (valeur) => {
155
+ const retiree = estRetiree(ouverture);
156
+ const nomAccessible = ouverture.avec === 'app' && !retiree ? `l'app ${ouverture.nom}` : ouverture.nom;
157
+ const sujet = retiree ? 'Une app retirée' : sujetDe(ouverture.avec, ouverture.nom);
158
+ return (_jsx(LigneDuPartage, { nom: ouverture.nom, detail: ouverture.avec === 'app' ? undefined : ouverture.email, sorte: ouverture.avec === 'app' ? 'App' : undefined, fin: proprietaire && cibles && choses.partager && choses.nePlusPartager
159
+ ? (_jsxs("span", { className: "flex items-center gap-1.5", children: [!retiree && (_jsx(Choix, { libelle: `Droit de ${nomAccessible}`, libelleMasque: true, taille: "petite", options: droits, valeur: ouverture.droit, disabled: geste.isPending, onValeurChange: (valeur) => {
142
160
  const nouveau = valeur;
143
- geste.mutate({ geste: 'partager', cibles, qui: quiDe(ouverture.avec, ouverture.nom), droit: nouveau, fait: accesDonne(sujetDe(ouverture.avec, ouverture.nom), chose.nom, nouveau) });
144
- } }), _jsx(GesteAuBoutDeLaLigne, { nom: `Retirer ${ouverture.nom}`, disabled: geste.isPending, onClick: () => geste.mutate({ geste: 'nePlusPartager', cibles, fait: `${sujetDe(ouverture.avec, ouverture.nom)} n'a plus accès à « ${chose.nom} ».` }), children: "Retirer" })] }))
145
- : _jsx("span", { className: "text-[13px] text-gris", children: libelleDuDroit(ouverture.droit) }) }, `${ouverture.avec}:${ouverture.email ?? ouverture.nom}`));
161
+ geste.mutate({ geste: 'partager', cibles, qui: quiDe(ouverture.avec, ouverture.nom), droit: nouveau, fait: accesDonne(sujet, chose.nom, nouveau) });
162
+ } })), _jsx(GesteAuBoutDeLaLigne, { nom: `Retirer ${nomAccessible}`, disabled: geste.isPending, onClick: () => geste.mutate({ geste: 'nePlusPartager', cibles, fait: `${sujet} n'a plus accès à « ${chose.nom} ».` }), children: "Retirer" })] }))
163
+ : _jsx("span", { className: "text-[13px] text-gris", children: libelleDuDroit(ouverture.droit) }) }, valeurDe(ouverture)));
146
164
  })] })), proprietaire && choses.partager
147
165
  ? (_jsxs("form", { className: "mt-3 grid grid-cols-[minmax(0,1fr)_150px_auto] items-end gap-2 max-[760px]:grid-cols-[minmax(0,1fr)]", onSubmit: (evenement) => {
148
166
  evenement.preventDefault();
@@ -150,7 +168,7 @@ function ContenuDuPartage({ choses, chose, mots, avertissement, fermer, surFerme
150
168
  const sorte = sorteDeLaValeur(avec);
151
169
  geste.mutate({ geste: 'partager', cibles: ciblesDeLaValeur(avec), qui: quiDe(sorte, nomDeLaValeur(avec)), droit, fait: accesDonne(sujetDe(sorte, nomDeLaValeur(avec)), chose.nom, droit) });
152
170
  }
153
- }, children: [_jsx(Choix, { libelle: "Ouvrir \u00E0", indication: "Une personne, un groupe", options: options, valeur: avec, onValeurChange: setAvec, focusALOuverture: true }), _jsx(Choix, { libelle: "Droit", options: droits, valeur: droit, onValeurChange: (valeur) => setDroit(valeur) }), _jsx(Bouton, { type: "submit", disabled: !avec || geste.isPending, children: "Ouvrir" })] }))
171
+ }, children: [_jsx(Choix, { libelle: "Ouvrir \u00E0", indication: "Une personne, un groupe, une app", options: options, valeur: avec, onValeurChange: setAvec, focusALOuverture: true }), _jsx(Choix, { libelle: "Droit", options: droits, valeur: droit, onValeurChange: (valeur) => setDroit(valeur) }), _jsx(Bouton, { type: "submit", disabled: !avec || geste.isPending, children: "Ouvrir" })] }))
154
172
  : !proprietaire && (_jsxs("p", { className: "mt-3 mb-0 text-gris", children: ["Seul", mots.e, " ", chose.auteur ?? 'la personne', ", qui ", mots.pronom, " poss\u00E8de, peut changer son partage."] })), choses.publier && (_jsxs("section", { "aria-labelledby": `hors-de-l-equipe-${chose.id}`, children: [_jsx(TitreDeSection, { id: `hors-de-l-equipe-${chose.id}`, className: "mt-7 mb-2", children: "Hors de l'\u00E9quipe" }), _jsx("p", { className: "m-0 mb-3 text-gris", children: publication.phrase }), chose.publiee
155
173
  ? (_jsxs("div", { className: "grid justify-items-start gap-2.5", children: [_jsxs("div", { className: "flex w-full min-w-0 items-center gap-2", children: [typeof chose.adresse_publique === 'string' && _jsx(AdressePublique, { adresse: chose.adresse_publique }), proprietaire && droitsDuLien.length > 1 && (_jsx(Choix, { libelle: "Droit du lien", libelleMasque: true, taille: "petite", options: droitsDuLien.map((valeur) => ({ valeur, libelle: libelleDuDroit(valeur) })), valeur: droitPublic, disabled: geste.isPending, onValeurChange: (valeur) => {
156
174
  const nouveau = valeur;
@@ -195,8 +213,10 @@ function AdressePublique({ adresse }) {
195
213
  return (_jsxs("div", { className: "flex w-full min-w-0 items-center gap-1 rounded-md bg-surface py-0.5 pr-0.5 pl-2.5", children: [_jsxs("a", { ref: lien, href: adresse, target: "_blank", rel: "noopener noreferrer", className: "flex min-w-0 flex-1 items-center gap-1 font-mono text-[12.5px] text-encre no-underline hover:text-gris", children: [_jsx("span", { "data-adresse": true, className: "min-w-0 truncate", children: adresse }), _jsx("span", { "aria-hidden": "true", className: "flex-none", children: "\u2197" })] }), _jsx("button", { type: "button", "aria-label": "Copier le lien public", title: "Copier le lien public", onClick: () => void copier(), className: "grid size-7 flex-none cursor-pointer place-items-center rounded-md border-0 bg-transparent text-gris hover:bg-survol hover:text-encre", children: iconeDeCopie })] }));
196
214
  }
197
215
  const iconeDeCopie = (_jsxs("svg", { "aria-hidden": "true", viewBox: "0 0 16 16", className: "size-[15px]", fill: "none", stroke: "currentColor", strokeWidth: "1.4", strokeLinejoin: "round", children: [_jsx("rect", { x: "5.5", y: "5.5", width: "8", height: "8", rx: "1.5" }), _jsx("path", { d: "M10.5 5.5V4a1.5 1.5 0 0 0-1.5-1.5H4A1.5 1.5 0 0 0 2.5 4v5A1.5 1.5 0 0 0 4 10.5h1.5" })] }));
198
- function LigneDuPartage({ nom, detail, fin }) {
199
- return (_jsxs("div", { className: "flex flex-wrap items-center justify-between gap-x-3 gap-y-1 border-t border-trait px-3.5 py-2.5 first:border-t-0", children: [_jsxs("span", { className: "grid min-w-0", children: [_jsx("span", { className: "font-medium [overflow-wrap:anywhere]", children: nom }), detail && _jsx("span", { className: "font-mono text-[12px] text-gris [overflow-wrap:anywhere]", children: detail })] }), fin] }));
216
+ // Une ligne du partage : son nom, sous lui le courriel d'une personne (`detail`) ou ce qu'est la
217
+ // cible quand ce n'est pas une personne de l'équipe (`sorte`, « App »), puis sa fin.
218
+ function LigneDuPartage({ nom, detail, sorte, fin }) {
219
+ return (_jsxs("div", { className: "flex flex-wrap items-center justify-between gap-x-3 gap-y-1 border-t border-trait px-3.5 py-2.5 first:border-t-0", children: [_jsxs("span", { className: "grid min-w-0", children: [_jsx("span", { className: "font-medium [overflow-wrap:anywhere]", children: nom }), detail && _jsx("span", { className: "font-mono text-[12px] text-gris [overflow-wrap:anywhere]", children: detail }), sorte && _jsx("span", { className: "text-[12px] text-gris", children: sorte })] }), fin] }));
200
220
  }
201
221
  // L'état d'une chose dans la liste et en tête du panneau : celui que l'app rend (`etat`), pour une
202
222
  // app à statut propre ; sinon celui du partage, « Partagée » ou « Privée », suivi, pour une chose
@@ -8,6 +8,7 @@ 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";
13
14
  export declare function fabriquerUneCleDAppel(app: string): string;
package/src/faux-core.js CHANGED
@@ -8,16 +8,23 @@ import { sansLeChemin } from './sans-le-chemin.js';
8
8
  // Un faux core pour les tests des apps : il sert sa clé publique et signe des jetons, fabriqués
9
9
  // ici à la main, sans le code du core.
10
10
  export const { privateKey: cleDuFauxCore, publicKey: clePubliqueDuFauxCore } = generateKeyPairSync('ed25519');
11
- // 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`.
12
14
  export function fabriquerUnJeton(personne, app, cle = cleDuFauxCore) {
13
15
  const iat = Math.floor(Date.now() / 1000);
14
16
  const b64 = (valeur) => Buffer.from(JSON.stringify(valeur)).toString('base64url');
15
- const donnees = `${b64({ alg: 'EdDSA', typ: 'JWT' })}.${b64({
16
- iss: 'core', sub: personne.id, aud: app, email: personne.email, nom: personne.nom,
17
- proprietaire: personne.proprietaire, ...(personne.groupes ? { groupes: personne.groupes } : {}), iat, exp: iat + 60,
18
- })}`;
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 })}`;
19
21
  return `${donnees}.${sign(null, Buffer.from(donnees), cle).toString('base64url')}`;
20
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
+ }
21
28
  // Un logo d'essai, à donner au faux core.
22
29
  export const logoDEssai = '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 10 10"><rect width="10" height="10"/></svg>';
23
30
  // La clé commune des apps que le faux core reconnaît à `/notifier` et à `/annuaire`, que le test
@@ -98,8 +105,9 @@ export function sessionDuCore(apps, proprietaire, nomDeLOS, groupes = []) {
98
105
  // Il sert les éléments de cette barre à `/espace/barre`, comme le geste du core. Une app qu'il ne
99
106
  // déclare pas est fermée à tous, comme au core : le test d'une app qui reconnaît la personne à sa
100
107
  // session (une page, un geste d'écran, `POST /outils`) la déclare.
101
- // Il sert l'annuaire (`GET /annuaire`) : `annuaire`, ou, sans lui, les personnes des sessions,
102
- // actives, sans groupe ; sans en-tête `Authorization`, ou avec la clé d'une app
108
+ // Il sert l'annuaire (`GET /annuaire`) : `annuaire`, ses apps comprises quand le test les donne
109
+ // (`apps`, `[{ nom, titre }]`, les comptes à qui partager), ou, sans lui, les personnes des
110
+ // sessions, actives, sans groupe ; sans en-tête `Authorization`, ou avec la clé d'une app
103
111
  // (`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
104
112
  // retire un membre d'un groupe ou désactive une personne en cours de route, sur l'objet qu'il a
105
113
  // passé, le voit à l'appel suivant.
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/partage.d.ts CHANGED
@@ -15,14 +15,20 @@ export type GroupeDeLAnnuaire = {
15
15
  nom: string;
16
16
  membres: string[];
17
17
  };
18
+ export type AppDeLAnnuaire = {
19
+ nom: string;
20
+ titre: string;
21
+ };
18
22
  export type Annuaire = {
19
23
  personnes: PersonneDeLAnnuaire[];
20
24
  groupes: GroupeDeLAnnuaire[];
25
+ apps?: AppDeLAnnuaire[];
21
26
  };
22
27
  export type Ouverture = {
23
- avec: 'equipe' | 'personne' | 'groupe';
28
+ avec: 'equipe' | 'personne' | 'groupe' | 'app';
24
29
  nom: string;
25
30
  email?: string;
31
+ app?: string;
26
32
  droit: Droit;
27
33
  };
28
34
  type Lecteur = Pick<pg.Pool, 'query'>;
package/src/partage.js CHANGED
@@ -12,10 +12,20 @@ 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
@@ -45,7 +55,7 @@ async function demanderLAnnuaire(adresse, cle) {
45
55
  if (!reponse.ok) {
46
56
  throw new Error(`Le core ne donne pas l'annuaire : ${reponse.status}.`);
47
57
  }
48
- const { personnes, groupes } = (await reponse.json());
58
+ const { personnes, groupes, apps } = (await reponse.json());
49
59
  return {
50
60
  personnes: listeDe(personnes).flatMap(({ id, nom, email, active, proprietaire }) => (typeof id === 'string' && typeof nom === 'string' && typeof email === 'string'
51
61
  ? [{ id, nom, email, active: active !== false, ...(proprietaire === true ? { proprietaire: true } : {}) }]
@@ -53,15 +63,28 @@ async function demanderLAnnuaire(adresse, cle) {
53
63
  groupes: listeDe(groupes).flatMap(({ id, nom, membres }) => (typeof id === 'string' && typeof nom === 'string'
54
64
  ? [{ id, nom, membres: Array.isArray(membres) ? membres.filter((membre) => typeof membre === 'string') : [] }]
55
65
  : [])),
66
+ ...(Array.isArray(apps)
67
+ ? { apps: listeDe(apps).flatMap(({ nom, titre }) => (typeof nom === 'string' && typeof titre === 'string' ? [{ nom, titre }] : [])) }
68
+ : {}),
56
69
  };
57
70
  }
58
71
  function listeDe(valeur) {
59
72
  return Array.isArray(valeur) ? valeur.map((element) => (element ?? {})) : [];
60
73
  }
61
- // Le nom d'une personne de l'équipe, pour un écran.
74
+ // Le préfixe de l'identifiant du compte d'une app, `app:<nom>`.
75
+ const prefixeDUnCompte = 'app:';
76
+ // Le nom d'une personne de l'équipe, pour un écran ; celui du compte d'une app (`app:<nom>`), le
77
+ // titre de son app.
62
78
  export function nomDe(annuaire, id) {
79
+ if (id.startsWith(prefixeDUnCompte)) {
80
+ return titreDe(annuaire, id.slice(prefixeDUnCompte.length)) ?? 'une app retirée';
81
+ }
63
82
  return annuaire.personnes.find((personne) => personne.id === id)?.nom ?? 'une personne inconnue';
64
83
  }
84
+ // Le titre d'une app de l'annuaire, par son nom ; rien pour une app retirée.
85
+ function titreDe(annuaire, nom) {
86
+ return annuaire.apps?.find((app) => app.nom === nom)?.titre;
87
+ }
65
88
  // « partagée par <nom> », pour un écran qui montre une chose ouverte à la personne.
66
89
  export function partageePar(annuaire, proprietaire) {
67
90
  return `partagée par ${nomDe(annuaire, proprietaire)}`;
@@ -69,9 +92,10 @@ export function partageePar(annuaire, proprietaire) {
69
92
  const confirmer = { type: 'boolean', description: 'true seulement après l\'accord explicite de la personne, sur ce qui s\'ouvre et à qui.' };
70
93
  const personnes = { type: 'array', maxItems: 50, items: { type: 'string', minLength: 3, maxLength: 320 }, description: 'Les courriels de personnes de l\'équipe.' };
71
94
  const groupes = { type: 'array', maxItems: 50, items: { type: 'string', minLength: 1, maxLength: 200 }, description: 'Les noms de groupes de l\'équipe.' };
95
+ const apps = { type: 'array', maxItems: 50, items: { type: 'string', minLength: 1, maxLength: 100 }, description: 'Les noms d\'apps, pour ouvrir à leur compte.' };
72
96
  const courriel = (description) => ({ type: 'string', minLength: 3, maxLength: 320, description });
73
97
  // Le schéma des arguments de `partager` : la chose (`argument`, que l'app décrit), et avec qui
74
- // (`personnes`, `groupes`, `equipe`), quel droit, l'accord.
98
+ // (`personnes`, `groupes`, `apps`, `equipe`), quel droit, l'accord.
75
99
  export function schemaDePartager(argument, schemaDeLaChose) {
76
100
  return {
77
101
  type: 'object',
@@ -79,6 +103,7 @@ export function schemaDePartager(argument, schemaDeLaChose) {
79
103
  [argument]: schemaDeLaChose,
80
104
  personnes,
81
105
  groupes,
106
+ apps,
82
107
  equipe: { type: 'boolean', description: 'true : toute l\'équipe.' },
83
108
  droit: { type: 'string', enum: ['lecture', 'modification'], description: '`lecture` : voir ; `modification` : voir et modifier.' },
84
109
  confirmer,
@@ -95,6 +120,7 @@ export function schemaDeNePlusPartager(argument, schemaDeLaChose) {
95
120
  [argument]: schemaDeLaChose,
96
121
  personnes,
97
122
  groupes,
123
+ apps,
98
124
  equipe: { type: 'boolean', description: 'true : toute l\'équipe.' },
99
125
  groupes_supprimes: { type: 'boolean', description: 'true : les groupes supprimés, montrés « un groupe supprimé ».' },
100
126
  },
@@ -246,10 +272,11 @@ export function creerLePartage(options) {
246
272
  const { rows } = await base.query(`select avec, droit from ${partage} where ${chose} = $1`, [id]);
247
273
  return new Map(rows.map((ligne) => [ligne.avec, ligne.droit]));
248
274
  }
249
- // Avec qui la chose est partagée, nommé par l'annuaire : toute l'équipe, puis les groupes, puis
250
- // les personnes. Un groupe supprimé n'ouvre plus rien, et se montre comme tel.
275
+ // Avec qui la chose est partagée, nommé par l'annuaire : toute l'équipe, puis les groupes, les
276
+ // personnes, et les comptes des apps, chacun au titre de son app. Un groupe supprimé n'ouvre
277
+ // plus rien, et se montre comme tel ; une app retirée aussi.
251
278
  function decrire(lignes, annuaire) {
252
- const rang = { equipe: 0, groupe: 1, personne: 2 };
279
+ const rang = { equipe: 0, groupe: 1, personne: 2, app: 3 };
253
280
  return [...lignes].map(([avec, droit]) => {
254
281
  if (avec === 'equipe') {
255
282
  return { avec: 'equipe', nom: 'Toute l\'équipe', droit };
@@ -258,13 +285,18 @@ export function creerLePartage(options) {
258
285
  if (sorte === 'groupe') {
259
286
  return { avec: 'groupe', nom: annuaire.groupes.find((groupe) => groupe.id === id)?.nom ?? 'un groupe supprimé', droit };
260
287
  }
288
+ if (id.startsWith(prefixeDUnCompte)) {
289
+ const app = id.slice(prefixeDUnCompte.length);
290
+ return { avec: 'app', nom: titreDe(annuaire, app) ?? 'une app retirée', app, droit };
291
+ }
261
292
  const connue = annuaire.personnes.find((une) => une.id === id);
262
293
  return connue ? { avec: 'personne', nom: connue.nom, email: connue.email, droit } : { avec: 'personne', nom: 'une personne inconnue', droit };
263
294
  }).sort((une, autre) => rang[une.avec] - rang[autre.avec] || une.nom.localeCompare(autre.nom, 'fr'));
264
295
  }
265
- // Les cibles que nomment les arguments, retrouvées dans l'annuaire ; une personne ou un groupe
266
- // inconnus sont refusés, `refus` en tête du texte.
267
- function cibles(arguments_, annuaire, refus) {
296
+ // Les cibles que nomment les arguments, retrouvées dans l'annuaire ; une personne, un groupe ou
297
+ // une app inconnus sont refusés, `refus` en tête du texte. `ouvertes`, les ouvertures de la chose
298
+ // pour `ne_plus_partager` : le compte d'une app retirée qui y est se retire encore.
299
+ function cibles(arguments_, annuaire, refus, ouvertes = new Set()) {
268
300
  const trouvees = arguments_.equipe === true ? [{ avec: 'equipe', quoi: 'à toute l\'équipe' }] : [];
269
301
  for (const nomDuGroupe of texts(arguments_.groupes)) {
270
302
  const groupe = annuaire.groupes.find((un) => un.nom === nomDuGroupe.trim())
@@ -280,6 +312,16 @@ export function creerLePartage(options) {
280
312
  const connue = personneDuCourriel(annuaire, email, refus);
281
313
  trouvees.push({ avec: `personne:${connue.id}`, quoi: `à ${connue.nom} (${connue.email})` });
282
314
  }
315
+ for (const nomDeLApp of texts(arguments_.apps)) {
316
+ const nomPropre = nomDeLApp.trim().toLowerCase();
317
+ const avec = `personne:${prefixeDUnCompte}${nomPropre}`;
318
+ const titre = titreDe(annuaire, nomPropre);
319
+ if (titre === undefined && !ouvertes.has(avec)) {
320
+ const connues = (annuaire.apps ?? []).map((app) => `\`${app.nom}\` (${app.titre})`).sort((une, autre) => une.localeCompare(autre, 'fr'));
321
+ throw new Refus(`${refus} : aucune app de l'OS ne s'appelle « ${nomDeLApp} ». ${connues.length ? `Ses apps : ${connues.join(', ')}.` : 'L\'OS n\'a aucune app.'}`);
322
+ }
323
+ trouvees.push({ avec, quoi: titre === undefined ? 'à une app retirée' : `à l'app ${titre}` });
324
+ }
283
325
  return [...new Map(trouvees.map((cible) => [cible.avec, cible])).values()];
284
326
  }
285
327
  return {
@@ -365,10 +407,10 @@ export function creerLePartage(options) {
365
407
  const annuaire = await lireLAnnuaire();
366
408
  const visees = cibles(arguments_, annuaire, 'Rien n\'est partagé');
367
409
  if (!visees.length) {
368
- throw new Refus('Dire avec qui partager : `personnes`, `groupes` ou `equipe: true`.');
410
+ throw new Refus('Dire avec qui partager : `personnes`, `groupes`, `apps` ou `equipe: true`.');
369
411
  }
370
412
  if (visees.some((cible) => cible.avec === `personne:${personne.id}`)) {
371
- throw new Refus(`Rien n'est partagé : ${laChose} est déjà à ${personne.email}.`);
413
+ throw new Refus(`Rien n'est partagé : ${laChose} est déjà à ${designer(personne)}.`);
372
414
  }
373
415
  for (const cible of visees) {
374
416
  const connue = annuaire.personnes.find((une) => `personne:${une.id}` === cible.avec);
@@ -398,18 +440,19 @@ export function creerLePartage(options) {
398
440
  return decrire(apres, annuaire);
399
441
  },
400
442
  // `ne_plus_partager`, au propriétaire seul : la chose ne s'ouvre plus aux cibles, ni, avec
401
- // `groupes_supprimes`, aux groupes supprimés. Sans accord : rien ne s'ouvre. Rend le partage
402
- // qui reste.
443
+ // `groupes_supprimes`, aux groupes supprimés. Le compte d'une app retirée qui a une ouverture se
444
+ // retire par le nom de l'app. Sans accord : rien ne s'ouvre. Rend le partage qui reste.
403
445
  async nePlusPartager(personne, id, arguments_) {
404
446
  ({ id } = await exigerLaPropriete(personne, id));
405
447
  const annuaire = await lireLAnnuaire();
406
- const retirees = cibles(arguments_, annuaire, 'Rien n\'est retiré').map((cible) => cible.avec);
448
+ const ouvertes = new Set((await lignesDe(id)).keys());
449
+ const retirees = cibles(arguments_, annuaire, 'Rien n\'est retiré', ouvertes).map((cible) => cible.avec);
407
450
  if (arguments_.groupes_supprimes === true) {
408
451
  const existants = new Set(annuaire.groupes.map((groupe) => `groupe:${groupe.id}`));
409
- retirees.push(...[...(await lignesDe(id)).keys()].filter((avec) => avec.startsWith('groupe:') && !existants.has(avec)));
452
+ retirees.push(...[...ouvertes].filter((avec) => avec.startsWith('groupe:') && !existants.has(avec)));
410
453
  }
411
454
  else if (!retirees.length) {
412
- throw new Refus('Dire avec qui ne plus partager : `personnes`, `groupes`, `equipe: true` ou `groupes_supprimes: true`.');
455
+ throw new Refus('Dire avec qui ne plus partager : `personnes`, `groupes`, `apps`, `equipe: true` ou `groupes_supprimes: true`.');
413
456
  }
414
457
  await base.query(`delete from ${partage} where ${chose} = $1 and avec = any($2::text[])`, [id, retirees]);
415
458
  return decrire(await lignesDe(id), annuaire);
@@ -424,13 +467,13 @@ export function creerLePartage(options) {
424
467
  const annuaire = await lireLAnnuaire();
425
468
  const a = personneDuCourriel(annuaire, arguments_.a, 'Rien n\'est donné');
426
469
  if (a.id === personne.id) {
427
- throw new Refus(`Rien n'est donné : ${laChose} est déjà à ${personne.email}.`);
470
+ throw new Refus(`Rien n'est donné : ${laChose} est déjà à ${designer(personne)}.`);
428
471
  }
429
472
  if (!a.active) {
430
473
  throw new Refus(`Rien n'est donné : ${a.nom} (${a.email}) est désactivée et ne se connecte plus.`);
431
474
  }
432
475
  if (arguments_.confirmer !== true) {
433
- 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.`);
476
+ 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.`);
434
477
  }
435
478
  await enTransaction(base, async (client) => {
436
479
  await exigerLaPropriete(personne, lue.id, { client });