@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 +14 -9
- 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/compte.js +5 -5
- package/src/espace/barre.d.ts +4 -0
- package/src/espace/barre.js +2 -2
- package/src/espace/choses.d.ts +3 -1
- package/src/espace/panneau-du-partage.js +36 -16
- package/src/faux-core.d.ts +1 -0
- package/src/faux-core.js +15 -7
- package/src/jeton.d.ts +1 -0
- package/src/jeton.js +19 -2
- package/src/partage.d.ts +7 -1
- package/src/partage.js +62 -19
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
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/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
|
|
11
|
-
// lecture ou en modification, et le donner (`creerLePartageDesComptes`).
|
|
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)) };
|
package/src/espace/barre.d.ts
CHANGED
|
@@ -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>;
|
package/src/espace/barre.js
CHANGED
|
@@ -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`)
|
|
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
|
}
|
package/src/espace/choses.d.ts
CHANGED
|
@@ -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
|
|
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'
|
|
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
|
-
|
|
141
|
-
|
|
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(
|
|
144
|
-
} }), _jsx(GesteAuBoutDeLaLigne, { nom: `Retirer ${
|
|
145
|
-
: _jsx("span", { className: "text-[13px] text-gris", children: libelleDuDroit(ouverture.droit) }) },
|
|
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
|
-
|
|
199
|
-
|
|
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
|
package/src/faux-core.d.ts
CHANGED
|
@@ -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
|
|
16
|
-
|
|
17
|
-
proprietaire: personne.proprietaire, ...(personne.groupes ? { groupes: personne.groupes } : {})
|
|
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`,
|
|
102
|
-
//
|
|
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
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/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
|
|
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,
|
|
250
|
-
// les
|
|
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
|
|
266
|
-
// inconnus sont refusés, `refus` en tête du texte.
|
|
267
|
-
|
|
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
|
|
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.
|
|
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
|
|
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(...[...
|
|
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
|
|
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
|
|
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 });
|