@indos/bibliotheque 1.10.0 → 1.11.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/CHANGELOG.md CHANGED
@@ -2,6 +2,26 @@
2
2
 
3
3
  Écrit pour le développeur d'une app du client, qui monte la version de la bibliothèque dans son dépôt : une section par version publiée sur npm. Une version qui demande un geste dans l'app a sa rubrique « Ruptures » : le geste, les versions exactes de React, Vite et TanStack à reprendre, et le core que demande la majeure.
4
4
 
5
+ ## 1.11.0
6
+
7
+ - Trouver et chercher une chose partagée, une fois pour toutes les apps : `creerLePartage` prend `colonnes`, `nom`, `cherche`, `ordre` et, pour des choses rangées les unes dans les autres, `racine`, et rend `trouver` (la chose ouverte à la personne avec son droit, ou rien, un identifiant qui n'est pas un UUID compris), `lire` (la chose avec le droit demandé, sinon le refus d'une chose absente) et `chercher` (le texte sans accents ni casse, les vues `toutes`, `a_moi`, `partagees`, la page et le total), avec `schemaDeChercher` pour l'outil.
8
+ - Une chose peut naître ouverte : `aLaCreation: { avec: 'equipe', droit }` dans `creerLePartage`, posée par `ouvrirALaCreation(client, id)` dans la transaction de la création. Sans elle, une chose naît privée.
9
+ - Donner une chose : `donner` passe une chose de son propriétaire à une autre personne active, avec son accord ; son partage reste. `donnerLesChoses` et l'outil entier `outilDeDonnerLesChoses` donnent toutes les choses d'une personne désactivée, au propriétaire du serveur seul, l'annuaire relu au core. Schémas : `schemaDeDonner`, `schemaDeDonnerLesChoses`.
10
+ - `auProprietaireDuServeur` : le droit qu'a le propriétaire du serveur sur toutes les choses d'une app qui le déclare.
11
+ - L'annuaire dit le propriétaire du serveur (`proprietaire`) ; `lireLAnnuaire({ sansCache: true })` le relit au core.
12
+ - « Donner à… » dans le ⋯ d'une chose, à sa propriétaire, quand l'app déclare `donner` : une fenêtre où choisir une personne active de l'équipe, puis « Donner ».
13
+ - Le panneau du partage annonce chaque geste fait en bas de l'écran, en phrase complète (« Léa a accès à « Devis » en modification. »), hors du panneau.
14
+ - Sur un téléphone, une cellule vide d'un tableau empilé ne se montre pas, ni le titre de sa colonne.
15
+ - Le surtitre d'un `Panneau` prend le titre commun d'une section, à l'encre, sans petites capitales grises.
16
+ - Une `Fenetre` ou une `Confirmation` plus haute que l'écran défile à la molette et au pavé, son contenu défilant lui-même ; sur un téléphone, une fenêtre tient toute la hauteur au plus.
17
+
18
+ ### Ruptures
19
+
20
+ - `creerLePartage` demande le pool de l'app (`pg.Pool`) dans `base`, pour donner dans une transaction.
21
+ - Un test qui lisait le message d'un geste du panneau du partage le lit dans l'annonce, hors du panneau, à sa phrase complète : « Le lien de « Devis » est ouvert. », « Léa n'a plus accès à « Devis ». ».
22
+ - Les versions de React, Vite et TanStack ne changent pas ; `npm view @indos/bibliotheque@1.11.0 peerDependencies` les donne toutes.
23
+ - Pour monter : `"@indos/bibliotheque": "1.11.0"` dans ses `dependencies`, puis `npm install` et `npm run build`.
24
+
5
25
  ## 1.10.0
6
26
 
7
27
  - Le formulaire d'une fiche : `formulaire` dans la déclaration des choses (`champs`, un composant qui rend les champs, vides ou remplis, `presentation`, `creer`, `modifier`, `peutModifier`). « Nouveau … » ouvre une fenêtre « Nouveau contact », ses champs, « Annuler » et « Créer » ; la fiche créée s'ouvre, la liste à gauche. « Modifier », en haut à droite de l'écran d'une fiche, ouvre la même fenêtre remplie, avec « Enregistrer ». Un refus se lit sous les champs, mot pour mot, la saisie gardée. Une fiche qui a un geste propre plus fort (`geste`) met « Modifier » dans son corps : `<ModifierLaFiche choses={…} chose={…} />`. `FormulaireDUneFiche` est la fenêtre seule.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@indos/bibliotheque",
3
- "version": "1.10.0",
3
+ "version": "1.11.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": "MIT",
6
6
  "type": "module",
@@ -103,6 +103,10 @@ export type DeclarationDesChoses<C extends ChoseTrouvee = ChoseTrouvee> = {
103
103
  }) => Promise<unknown>;
104
104
  nePlusPartager?: (chose: C, cibles: CiblesDuPartage) => Promise<unknown>;
105
105
  publier?: (chose: C, oui: boolean, confirmer: boolean) => Promise<unknown>;
106
+ donner?: (chose: C, don: {
107
+ a: string;
108
+ confirmer: true;
109
+ }) => Promise<unknown>;
106
110
  nouveau?: () => Promise<{
107
111
  chemin: string;
108
112
  } | undefined | void>;
@@ -1,13 +1,15 @@
1
1
  import { jsx as _jsx } from "react/jsx-runtime";
2
- import { useMutation, useQueryClient } from '@tanstack/react-query';
2
+ import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
3
3
  import { Champ, Saisie } from '../ui/champ.js';
4
+ import { Choix } from '../ui/choix.js';
4
5
  import { Confirmation } from '../ui/confirmation.js';
5
6
  import { Fenetre } from '../ui/fenetre.js';
6
7
  import { MenuDUneLigne } from '../ui/menu-d-une-ligne.js';
7
- import { useEpingle } from './barre.js';
8
+ import { lireLAnnuaire, useEpingle } from './barre.js';
8
9
  import { cleDesChoses, estRangee, motsDe } from './choses.js';
9
10
  import { depuisLaListe, useAnnoncer, useOuvrir } from './ouvrir.js';
10
11
  import { PanneauDuPartage } from './panneau-du-partage.js';
12
+ import { useSession } from './session.js';
11
13
  export function MenuDUneChose({ choses, chose, surLEcran = false, surSupprimee }) {
12
14
  const client = useQueryClient();
13
15
  const annoncer = useAnnoncer();
@@ -21,6 +23,7 @@ export function MenuDUneChose({ choses, chose, surLEcran = false, surSupprimee }
21
23
  const supprimable = Boolean(choses.supprimer) && (choses.peutSupprimer ? choses.peutSupprimer(chose) : (chose.droit ?? 'proprietaire') === 'proprietaire');
22
24
  const pleinePage = choses.pleinePage?.(chose);
23
25
  const partageable = Boolean(choses.lirePartage) && !estRangee(choses, chose);
26
+ const donnable = Boolean(choses.donner) && (chose.droit ?? 'proprietaire') === 'proprietaire' && !estRangee(choses, chose);
24
27
  const gestes = choses.gestesDuMenu?.(chose, { surLEcran, annoncer }) ?? [];
25
28
  const consequence = typeof choses.consequenceDeLaSuppression === 'function' ? choses.consequenceDeLaSuppression(chose) : choses.consequenceDeLaSuppression;
26
29
  const motsDeLaSuppression = choses.motsDeLaSuppression?.(chose) ?? {};
@@ -49,6 +52,10 @@ export function MenuDUneChose({ choses, chose, surLEcran = false, surSupprimee }
49
52
  libelle: 'Partager…',
50
53
  fenetre: ({ ouverte, onOuverteChange, retour }) => (_jsx(PanneauDuPartage, { choses: choses, chose: chose, ouvert: ouverte, onOuvertChange: onOuverteChange, retour: retour })),
51
54
  },
55
+ donnable && {
56
+ libelle: 'Donner à…',
57
+ fenetre: ({ ouverte, onOuverteChange, retour }) => (_jsx(FenetreDuDon, { choses: choses, chose: chose, ouverte: ouverte, onOuverteChange: onOuverteChange, retour: retour, surFermee: surSupprimee })),
58
+ },
52
59
  renommable && {
53
60
  libelle: 'Renommer',
54
61
  fenetre: ({ ouverte, onOuverteChange, retour }) => (_jsx(Fenetre, { titre: `Renommer ${mots.laChose}`, verbe: "Renommer", ouverte: ouverte, onOuverteChange: onOuverteChange, retour: retour, onEnvoyer: async (donnees) => {
@@ -75,3 +82,30 @@ export function MenuDUneChose({ choses, chose, surLEcran = false, surSupprimee }
75
82
  ];
76
83
  return _jsx(MenuDUneLigne, { nom: surLEcran ? undefined : chose.nom, surLEcran: surLEcran, groupes: [deLaChose, epingler, supprimer] });
77
84
  }
85
+ // La fenêtre de « Donner à… » : la personne active de l'équipe à qui la chose passe, lue à
86
+ // l'annuaire, puis « Donner ». Le clic est l'accord de la personne : l'app appelle `donner` avec
87
+ // `confirmer: true`. Le don fait s'annonce, et la liste et la chose se relisent ; une chose que son
88
+ // partage ne lui ouvre plus quitte l'écran (`surFermee`), comme une chose supprimée.
89
+ function FenetreDuDon({ choses, chose, ouverte, onOuverteChange, retour, surFermee }) {
90
+ const session = useSession();
91
+ const client = useQueryClient();
92
+ const annoncer = useAnnoncer();
93
+ const annuaire = useQuery({ queryKey: ['annuaire'], queryFn: lireLAnnuaire, enabled: ouverte });
94
+ const options = (annuaire.data?.personnes ?? [])
95
+ .filter((personne) => personne.email !== session.email)
96
+ .map((personne) => ({ valeur: personne.email, libelle: personne.nom }));
97
+ return (_jsx(Fenetre, { titre: `Donner « ${chose.nom} »`, presentation: `La personne choisie en devient propriétaire. Son partage reste tel qu'il est : vous n'y gardez que ce qu'il vous ouvre.`, verbe: "Donner", ouverte: ouverte, onOuverteChange: onOuverteChange, retour: retour, onEnvoyer: async (donnees) => {
98
+ const a = String(donnees.get('a') ?? '');
99
+ if (!a) {
100
+ throw new Error('Choisissez une personne.');
101
+ }
102
+ await choses.donner(chose, { a, confirmer: true });
103
+ annoncer(`« ${chose.nom} » est à ${options.find((option) => option.valeur === a)?.libelle ?? a}.`);
104
+ const encore = await choses.lire(chose.id).catch(() => undefined);
105
+ if (!encore) {
106
+ client.removeQueries({ queryKey: cleDesChoses(choses.app, 'chose', chose.id) });
107
+ surFermee?.();
108
+ }
109
+ await client.invalidateQueries({ queryKey: cleDesChoses(choses.app) });
110
+ }, children: _jsx(Choix, { libelle: "\u00C0", name: "a", indication: "Une personne de l'\u00E9quipe", options: options, erreur: annuaire.error?.message }) }));
111
+ }
@@ -9,6 +9,7 @@ import { Panneau } from '../ui/panneau.js';
9
9
  import { lireLAnnuaire } from './barre.js';
10
10
  import { cleDesChoses, estRangee, motsDe, motsDeLaPublication, texteDuNoeud } from './choses.js';
11
11
  import { demandeLAccord } from './confirmation-d-un-geste.js';
12
+ import { useAnnoncer } from './ouvrir.js';
12
13
  import { useSession } from './session.js';
13
14
  // Les cibles d'une ouverture, pour rappeler `partager` ou `ne_plus_partager` ; aucune pour une
14
15
  // personne que l'annuaire ne connaît plus.
@@ -25,6 +26,10 @@ function ciblesDe(ouverture) {
25
26
  function quiDe(avec, nom) {
26
27
  return avec === 'equipe' ? 'à toute l\'équipe' : avec === 'groupe' ? `au groupe ${nom}` : `à ${nom}`;
27
28
  }
29
+ // Une cible en tête de phrase : « Toute l'équipe », « Le groupe Atelier », « Léa ».
30
+ function sujetDe(avec, nom) {
31
+ return avec === 'equipe' ? 'Toute l\'équipe' : avec === 'groupe' ? `Le groupe ${nom}` : nom;
32
+ }
28
33
  // La valeur d'une cible dans la liste « Ouvrir à », et ses cibles.
29
34
  function ciblesDeLaValeur(valeur) {
30
35
  if (valeur === 'equipe') {
@@ -37,6 +42,8 @@ function ciblesDeLaValeur(valeur) {
37
42
  // sa fermeture le relisent.
38
43
  const dureeDuPartageLu = 30_000;
39
44
  const libelleDuDroit = (droit) => (droit === 'modification' ? 'Modification' : 'Lecture');
45
+ // L'annonce d'une ouverture faite : « Léa a accès à « Devis » en modification. »
46
+ const accesDonne = (sujet, nom, droit) => `${sujet} a accès à « ${nom} » en ${droit}.`;
40
47
  const droits = [{ valeur: 'lecture', libelle: 'Lecture' }, { valeur: 'modification', libelle: 'Modification' }];
41
48
  export function PanneauDuPartage({ choses, chose, ouvert, onOuvertChange, declencheur, retour }) {
42
49
  const mots = motsDe(choses);
@@ -45,10 +52,10 @@ export function PanneauDuPartage({ choses, chose, ouvert, onOuvertChange, declen
45
52
  function ContenuDuPartage({ choses, chose, mots }) {
46
53
  const session = useSession();
47
54
  const client = useQueryClient();
55
+ const annoncer = useAnnoncer();
48
56
  const proprietaire = (chose.droit ?? 'proprietaire') === 'proprietaire';
49
57
  const [avec, setAvec] = useState('');
50
58
  const [droit, setDroit] = useState('lecture');
51
- const [fait, setFait] = useState();
52
59
  // La liste des ouvertures, où va le focus quand « Retirer » fait partir sa ligne.
53
60
  const ouverturesDeLaChose = useRef(null);
54
61
  const partage = useQuery({
@@ -71,9 +78,8 @@ function ContenuDuPartage({ choses, chose, mots }) {
71
78
  }
72
79
  return choses.publier(chose, variables.oui, variables.confirmer === true);
73
80
  },
74
- onMutate: () => setFait(undefined),
75
81
  onSuccess: (_rendu, variables) => {
76
- setFait(variables.fait);
82
+ annoncer(variables.fait);
77
83
  setAvec('');
78
84
  if (variables.geste === 'nePlusPartager') {
79
85
  ouverturesDeLaChose.current?.focus();
@@ -89,7 +95,8 @@ function ContenuDuPartage({ choses, chose, mots }) {
89
95
  ...(annuaire.data?.personnes ?? []).filter((personne) => personne.email !== session.email).map((personne) => ({ valeur: `personne:${personne.email}`, libelle: personne.nom })),
90
96
  ].filter((option) => !dejaOuvertes.has(option.valeur));
91
97
  const libelleDe = (valeur) => options.find((option) => option.valeur === valeur)?.libelle ?? valeur;
92
- const quiDeLaValeur = (valeur) => (valeur === 'equipe' ? quiDe('equipe', '') : valeur.startsWith('groupe:') ? quiDe('groupe', valeur.slice('groupe:'.length)) : quiDe('personne', libelleDe(valeur)));
98
+ const sorteDeLaValeur = (valeur) => (valeur === 'equipe' ? 'equipe' : valeur.startsWith('groupe:') ? 'groupe' : 'personne');
99
+ const nomDeLaValeur = (valeur) => (valeur === 'equipe' ? '' : valeur.startsWith('groupe:') ? valeur.slice('groupe:'.length) : libelleDe(valeur));
93
100
  const publication = motsDeLaPublication(choses.publication);
94
101
  const erreur = geste.error;
95
102
  const enCours = geste.variables;
@@ -100,7 +107,7 @@ function ContenuDuPartage({ choses, chose, mots }) {
100
107
  ? { titre: `Ouvrir « ${chose.nom} » à toute personne qui a le lien ?`, texte: choses.publication?.consequence, verbe: publication.verbe }
101
108
  : undefined
102
109
  : undefined;
103
- return (_jsxs(_Fragment, { children: [fait && _jsx(Message, { titre: fait }), question && enCours
110
+ return (_jsxs(_Fragment, { children: [question && enCours
104
111
  ? (_jsxs("div", { role: "group", "aria-label": "Confirmer", className: "mb-5 rounded-lg border border-trait bg-surface px-3.5 py-3", children: [_jsx("p", { className: "m-0 font-semibold text-encre", children: question.titre }), question.texte && _jsx("p", { className: "m-0 mt-0.5 text-gris", children: question.texte }), _jsxs("div", { className: "mt-3 flex flex-wrap gap-2", children: [_jsx(Bouton, { type: "button", sorte: "secondaire", onClick: () => geste.reset(), children: "Annuler" }), _jsx(Bouton, { type: "button", disabled: geste.isPending, onClick: () => geste.mutate({ ...enCours, confirmer: true }), children: question.verbe })] })] }))
105
112
  : erreur && (_jsxs("div", { className: "mb-5", children: [_jsx(Message, { erreur: true, titre: erreur.message, className: "mb-3" }), _jsx(Bouton, { type: "button", sorte: "secondaire", onClick: () => geste.reset(), children: "Annuler" })] })), _jsx(TitreDeSection, { className: "mb-2", children: "Dans l'\u00E9quipe" }), partage.error
106
113
  ? _jsx(Message, { erreur: true, titre: partage.error.message })
@@ -109,20 +116,21 @@ function ContenuDuPartage({ choses, chose, mots }) {
109
116
  return (_jsx(LigneDuPartage, { nom: ouverture.nom, detail: ouverture.email, fin: proprietaire && cibles && choses.partager && choses.nePlusPartager
110
117
  ? (_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) => {
111
118
  const nouveau = valeur;
112
- geste.mutate({ geste: 'partager', cibles, qui: quiDe(ouverture.avec, ouverture.nom), droit: nouveau, fait: `${ouverture.nom} : ${libelleDuDroit(nouveau).toLocaleLowerCase('fr')}.` });
113
- } }), _jsx(Bouton, { type: "button", sorte: "discret", disabled: geste.isPending, onClick: () => geste.mutate({ geste: 'nePlusPartager', cibles, fait: `${ouverture.nom} n'y a plus accès.` }), children: "Retirer" })] }))
119
+ geste.mutate({ geste: 'partager', cibles, qui: quiDe(ouverture.avec, ouverture.nom), droit: nouveau, fait: accesDonne(sujetDe(ouverture.avec, ouverture.nom), chose.nom, nouveau) });
120
+ } }), _jsx(Bouton, { type: "button", sorte: "discret", disabled: geste.isPending, onClick: () => geste.mutate({ geste: 'nePlusPartager', cibles, fait: `${sujetDe(ouverture.avec, ouverture.nom)} n'a plus accès à « ${chose.nom} ».` }), children: "Retirer" })] }))
114
121
  : _jsx("span", { className: "text-[13px] text-gris", children: libelleDuDroit(ouverture.droit) }) }, `${ouverture.avec}:${ouverture.email ?? ouverture.nom}`));
115
122
  })] })), proprietaire && choses.partager
116
123
  ? (_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) => {
117
124
  evenement.preventDefault();
118
125
  if (avec) {
119
- geste.mutate({ geste: 'partager', cibles: ciblesDeLaValeur(avec), qui: quiDeLaValeur(avec), droit, fait: `${libelleDe(avec)} y a accès, en ${libelleDuDroit(droit).toLocaleLowerCase('fr')}.` });
126
+ const sorte = sorteDeLaValeur(avec);
127
+ geste.mutate({ geste: 'partager', cibles: ciblesDeLaValeur(avec), qui: quiDe(sorte, nomDeLaValeur(avec)), droit, fait: accesDonne(sujetDe(sorte, nomDeLaValeur(avec)), chose.nom, droit) });
120
128
  }
121
129
  }, children: [_jsx(Choix, { libelle: "Ouvrir \u00E0", indication: "Une personne, un groupe", options: options, valeur: avec, onValeurChange: setAvec }), _jsx(Choix, { libelle: "Droit", options: droits, valeur: droit, onValeurChange: (valeur) => setDroit(valeur) }), _jsx(Bouton, { type: "submit", disabled: !avec || geste.isPending, children: "Ouvrir" })] }))
122
130
  : !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(_Fragment, { children: [_jsx(TitreDeSection, { className: "mt-7 mb-2", children: publication.titre }), _jsx("p", { className: "m-0 mb-3 text-gris", children: publication.consequence }), chose.publiee
123
- ? (_jsxs("div", { className: "grid gap-2.5", children: [typeof chose.adresse_publique === 'string' && _jsx(AdresseACopier, { adresse: chose.adresse_publique }), proprietaire && (_jsx("div", { className: "flex flex-wrap gap-2", children: _jsx(Bouton, { type: "button", sorte: "secondaire", disabled: geste.isPending, onClick: () => geste.mutate({ geste: 'publier', oui: false, fait: 'Le lien ne mène plus à rien.' }), children: publication.fermer }) }))] }))
131
+ ? (_jsxs("div", { className: "grid gap-2.5", children: [typeof chose.adresse_publique === 'string' && _jsx(AdresseACopier, { adresse: chose.adresse_publique }), proprietaire && (_jsx("div", { className: "flex flex-wrap gap-2", children: _jsx(Bouton, { type: "button", sorte: "secondaire", disabled: geste.isPending, onClick: () => geste.mutate({ geste: 'publier', oui: false, fait: `Le lien de « ${chose.nom} » ne mène plus à rien.` }), children: publication.fermer }) }))] }))
124
132
  : proprietaire
125
- ? (_jsx(Bouton, { type: "button", sorte: "secondaire", disabled: geste.isPending, onClick: () => geste.mutate({ geste: 'publier', oui: true, fait: 'Le lien est ouvert.' }), children: publication.verbe }))
133
+ ? (_jsx(Bouton, { type: "button", sorte: "secondaire", disabled: geste.isPending, onClick: () => geste.mutate({ geste: 'publier', oui: true, fait: `Le lien de « ${chose.nom} » est ouvert.` }), children: publication.verbe }))
126
134
  : _jsx("p", { className: "m-0 text-gris", children: "Aucun lien n'est ouvert." })] }))] }));
127
135
  }
128
136
  function LigneDuPartage({ nom, detail, fin }) {
package/src/partage.d.ts CHANGED
@@ -8,6 +8,7 @@ export type PersonneDeLAnnuaire = {
8
8
  nom: string;
9
9
  email: string;
10
10
  active: boolean;
11
+ proprietaire?: boolean;
11
12
  };
12
13
  export type GroupeDeLAnnuaire = {
13
14
  id: string;
@@ -24,18 +25,35 @@ export type Ouverture = {
24
25
  email?: string;
25
26
  droit: Droit;
26
27
  };
27
- type Base = Pick<pg.Pool, 'query'>;
28
+ type Lecteur = Pick<pg.Pool, 'query'>;
28
29
  type SchemaDUnArgument = NonNullable<Outil['schema']['properties']>[string];
29
30
  export declare const dureeDeLAnnuaire = 5000;
30
31
  export declare function suffit(droit: DroitSurLaChose | undefined, attendu: DroitSurLaChose): boolean;
31
32
  export declare function ouverturesDe(personne: Personne): string[];
32
- export declare function creerLAnnuaire(adresseDuCore?: string | undefined, horloge?: () => number): () => Promise<Annuaire>;
33
+ export declare function creerLAnnuaire(adresseDuCore?: string | undefined, horloge?: () => number): ({ sansCache }?: {
34
+ sansCache?: boolean;
35
+ }) => Promise<Annuaire>;
33
36
  export declare function nomDe(annuaire: Annuaire, id: string): string;
34
37
  export declare function partageePar(annuaire: Annuaire, proprietaire: string): string;
35
38
  export declare function schemaDePartager(argument: string, schemaDeLaChose: SchemaDUnArgument): Outil['schema'];
36
39
  export declare function schemaDeNePlusPartager(argument: string, schemaDeLaChose: SchemaDUnArgument): Outil['schema'];
40
+ export declare function schemaDeDonner(argument: string, schemaDeLaChose: SchemaDUnArgument): Outil['schema'];
41
+ export declare function schemaDeDonnerLesChoses(): Outil['schema'];
42
+ export declare const vuesDeChercher: readonly ['toutes', 'a_moi', 'partagees'];
43
+ export type VueDeChercher = (typeof vuesDeChercher)[number];
44
+ export declare function schemaDeChercher(enPlus?: NonNullable<Outil['schema']['properties']>): Outil['schema'];
45
+ export type ChoseLue = Record<string, unknown> & {
46
+ droit: DroitSurLaChose;
47
+ };
48
+ export type ChosesDonnees = {
49
+ nombre: number;
50
+ choses: {
51
+ id: string;
52
+ nom: string;
53
+ }[];
54
+ };
37
55
  export type OptionsDuPartage = {
38
- base: Base;
56
+ base: pg.Pool;
39
57
  chose: string;
40
58
  table?: string;
41
59
  proprietaire?: string;
@@ -43,6 +61,16 @@ export type OptionsDuPartage = {
43
61
  laChose: string;
44
62
  absente: (id: string) => string;
45
63
  adresseDuCore?: string;
64
+ colonnes?: string;
65
+ nom?: string;
66
+ cherche?: string[];
67
+ ordre?: string;
68
+ racine?: string;
69
+ aLaCreation?: {
70
+ avec: 'equipe';
71
+ droit: Droit;
72
+ };
73
+ auProprietaireDuServeur?: Droit;
46
74
  };
47
75
  export declare function creerLePartage(options: OptionsDuPartage): {
48
76
  pourLaPersonne: (personne: Personne, { alias, depuis }?: {
@@ -53,10 +81,48 @@ export declare function creerLePartage(options: OptionsDuPartage): {
53
81
  droit: string;
54
82
  valeurs: (string | string[])[];
55
83
  };
56
- droitSur: (personne: Personne, id: string) => Promise<DroitSurLaChose | undefined>;
57
- lireLAnnuaire: () => Promise<Annuaire>;
84
+ trouver: <C = ChoseLue>(personne: Personne, id: unknown, { colonnes: liste, client }?: {
85
+ colonnes?: string;
86
+ client?: Lecteur;
87
+ }) => Promise<(C & {
88
+ droit: DroitSurLaChose;
89
+ }) | undefined>;
90
+ lireLAnnuaire: ({ sansCache }?: {
91
+ sansCache?: boolean;
92
+ }) => Promise<Annuaire>;
93
+ droitSur(personne: Personne, id: string): Promise<DroitSurLaChose | undefined>;
94
+ lire<C = ChoseLue>(personne: Personne, id: unknown, { droit, ...reste }?: {
95
+ droit?: DroitSurLaChose;
96
+ colonnes?: string;
97
+ client?: Lecteur;
98
+ }): Promise<C & {
99
+ droit: DroitSurLaChose;
100
+ }>;
101
+ chercher<C = ChoseLue>(personne: Personne, arguments_: Record<string, unknown>, { colonnes: liste, condition }?: {
102
+ colonnes?: string;
103
+ condition?: (valeur: (une: unknown) => string) => string;
104
+ }): Promise<{
105
+ lignes: (C & {
106
+ droit: DroitSurLaChose;
107
+ })[];
108
+ total: number;
109
+ }>;
110
+ ouvrirALaCreation(client: Lecteur, id: string): Promise<void>;
58
111
  partageDe(id: string): Promise<Ouverture[]>;
59
112
  partager(personne: Personne, id: string, arguments_: Record<string, unknown>): Promise<Ouverture[]>;
60
113
  nePlusPartager(personne: Personne, id: string, arguments_: Record<string, unknown>): Promise<Ouverture[]>;
114
+ donner(personne: Personne, id: string, arguments_: Record<string, unknown>): Promise<{
115
+ id: string;
116
+ proprietaire: {
117
+ nom: string;
118
+ email: string;
119
+ };
120
+ partage: Ouverture[];
121
+ }>;
122
+ donnerLesChoses(personne: Personne, arguments_: Record<string, unknown>): Promise<ChosesDonnees>;
61
123
  };
124
+ export type Partage = ReturnType<typeof creerLePartage>;
125
+ export declare function outilDeDonnerLesChoses(partage: Pick<Partage, 'donnerLesChoses'>, { apresUnDon }?: {
126
+ apresUnDon?: (id: string) => Promise<unknown> | unknown;
127
+ }): Outil;
62
128
  export {};
package/src/partage.js CHANGED
@@ -1,4 +1,8 @@
1
+ import { enTransaction } from './base.js';
2
+ import { identifiant } from './identifiant.js';
1
3
  import { Refus } from './mcp.js';
4
+ import { lignesParPage } from './pagination.js';
5
+ import { motifSansAccents, sansAccentsEnSql } from './sans-accents.js';
2
6
  // L'annuaire se garde quelques secondes : un partage qui suit un ajout à l'équipe le voit vite.
3
7
  export const dureeDeLAnnuaire = 5_000;
4
8
  const ordreDesDroits = { lecture: 1, modification: 2, proprietaire: 3 };
@@ -13,14 +17,16 @@ export function ouverturesDe(personne) {
13
17
  }
14
18
  // Lit l'annuaire du core (`CORE_ADRESSE/annuaire`), gardé `dureeDeLAnnuaire`. Un core qui n'en a
15
19
  // pas (d'avant 1.7, 404) rend un annuaire vide ; un core qui ne répond pas lève une erreur, qui
16
- // n'est pas gardée. `horloge` ne sert qu'aux tests.
20
+ // n'est pas gardée. `{ sansCache: true }` le relit au core, pour un geste qui décide sur ce qu'il
21
+ // dit, comme le don des choses d'une personne désactivée ; la lecture remplace celle gardée.
22
+ // `horloge` ne sert qu'aux tests.
17
23
  export function creerLAnnuaire(adresseDuCore = process.env.CORE_ADRESSE, horloge = Date.now) {
18
24
  let garde;
19
- return function lireLAnnuaire() {
25
+ return function lireLAnnuaire({ sansCache = false } = {}) {
20
26
  if (!adresseDuCore) {
21
27
  return Promise.reject(new Error('La variable CORE_ADRESSE manque : l\'adresse interne du core vient du kit.'));
22
28
  }
23
- if (!garde || horloge() - garde.lu >= dureeDeLAnnuaire) {
29
+ if (sansCache || !garde || horloge() - garde.lu >= dureeDeLAnnuaire) {
24
30
  const lecture = { lu: horloge(), annuaire: demanderLAnnuaire(new URL('/annuaire', adresseDuCore)) };
25
31
  lecture.annuaire.catch(() => {
26
32
  if (garde === lecture) {
@@ -42,8 +48,8 @@ async function demanderLAnnuaire(adresse) {
42
48
  }
43
49
  const { personnes, groupes } = (await reponse.json());
44
50
  return {
45
- personnes: listeDe(personnes).flatMap(({ id, nom, email, active }) => (typeof id === 'string' && typeof nom === 'string' && typeof email === 'string'
46
- ? [{ id, nom, email, active: active !== false }]
51
+ personnes: listeDe(personnes).flatMap(({ id, nom, email, active, proprietaire }) => (typeof id === 'string' && typeof nom === 'string' && typeof email === 'string'
52
+ ? [{ id, nom, email, active: active !== false, ...(proprietaire === true ? { proprietaire: true } : {}) }]
47
53
  : [])),
48
54
  groupes: listeDe(groupes).flatMap(({ id, nom, membres }) => (typeof id === 'string' && typeof nom === 'string'
49
55
  ? [{ id, nom, membres: Array.isArray(membres) ? membres.filter((membre) => typeof membre === 'string') : [] }]
@@ -64,6 +70,7 @@ export function partageePar(annuaire, proprietaire) {
64
70
  const confirmer = { type: 'boolean', description: 'true seulement après l\'accord explicite de la personne, sur ce qui s\'ouvre et à qui.' };
65
71
  const personnes = { type: 'array', maxItems: 50, items: { type: 'string', minLength: 3, maxLength: 320 }, description: 'Les courriels de personnes de l\'équipe.' };
66
72
  const groupes = { type: 'array', maxItems: 50, items: { type: 'string', minLength: 1, maxLength: 200 }, description: 'Les noms de groupes de l\'équipe.' };
73
+ const courriel = (description) => ({ type: 'string', minLength: 3, maxLength: 320, description });
67
74
  // Le schéma des arguments de `partager` : la chose (`argument`, que l'app décrit), et avec qui
68
75
  // (`personnes`, `groupes`, `equipe`), quel droit, l'accord.
69
76
  export function schemaDePartager(argument, schemaDeLaChose) {
@@ -95,41 +102,104 @@ export function schemaDeNePlusPartager(argument, schemaDeLaChose) {
95
102
  required: [argument],
96
103
  };
97
104
  }
105
+ // Le schéma des arguments de `donner` : la chose, à qui elle passe (`a`, un courriel), l'accord.
106
+ export function schemaDeDonner(argument, schemaDeLaChose) {
107
+ return {
108
+ type: 'object',
109
+ properties: {
110
+ [argument]: schemaDeLaChose,
111
+ a: courriel('Le courriel de la personne de l\'équipe, active, à qui la chose passe.'),
112
+ confirmer: { type: 'boolean', description: 'true seulement après l\'accord explicite de la personne, sur ce qui passe et à qui.' },
113
+ },
114
+ required: [argument, 'a'],
115
+ };
116
+ }
117
+ // Le schéma des arguments de `donner_les_choses` : de qui (`de`, une personne désactivée), à qui
118
+ // (`a`, une personne active), par leurs courriels.
119
+ export function schemaDeDonnerLesChoses() {
120
+ return {
121
+ type: 'object',
122
+ properties: {
123
+ de: courriel('Le courriel de la personne désactivée dont les choses passent.'),
124
+ a: courriel('Le courriel de la personne de l\'équipe, active, à qui elles passent.'),
125
+ },
126
+ required: ['de', 'a'],
127
+ };
128
+ }
129
+ // Les vues de `chercher` d'une app qui partage : toutes les choses que la personne voit, les
130
+ // siennes, celles qu'un autre lui a ouvertes.
131
+ export const vuesDeChercher = ['toutes', 'a_moi', 'partagees'];
132
+ // Le schéma des arguments de `chercher` d'une app qui partage : `texte`, `vue`, `page`, et les
133
+ // arguments propres de l'app (`enPlus`), comme les seules chartes des pages.
134
+ export function schemaDeChercher(enPlus = {}) {
135
+ return {
136
+ type: 'object',
137
+ properties: {
138
+ texte: { type: 'string', description: 'Un texte à chercher, sans tenir compte des accents ni de la casse ; sans lui, toutes.' },
139
+ vue: { type: 'string', enum: [...vuesDeChercher], description: 'Les siennes (`a_moi`), celles qu\'un autre lui a ouvertes (`partagees`), ou toutes (`toutes`, par défaut).' },
140
+ page: { type: 'integer', minimum: 1, description: 'La page de la liste, à partir de 1 ; 1 sans elle.' },
141
+ ...enPlus,
142
+ },
143
+ };
144
+ }
98
145
  export function creerLePartage(options) {
99
146
  const chose = identifiantSql(options.chose);
100
147
  const table = identifiantSql(options.table ?? options.chose);
101
148
  const proprietaire = identifiantSql(options.proprietaire ?? 'proprietaire');
102
149
  const partage = identifiantSql(options.partage ?? 'partage');
103
- const { base, laChose, absente } = options;
150
+ const nom = identifiantSql(options.nom ?? 'nom');
151
+ const racine = options.racine === undefined ? undefined : identifiantSql(options.racine);
152
+ const { base, laChose, absente, aLaCreation, auProprietaireDuServeur } = options;
153
+ const colonnes = options.colonnes ?? `${table}.*`;
154
+ const cherche = options.cherche ?? [`${table}.${nom}`];
155
+ const ordre = options.ordre ?? `${table}.modifie_le desc, ${table}.id`;
156
+ // La table des choses dans une requête, avec sa racine pour une chose rangée, et la table où se
157
+ // lit le droit : la racine, ou la chose elle-même.
158
+ const depuis = racine ? `${table} join ${table} as racine on racine.id = ${table}.${racine}` : table;
159
+ const aliasDuDroit = racine ? 'racine' : table;
104
160
  const lireLAnnuaire = creerLAnnuaire(options.adresseDuCore ?? process.env.CORE_ADRESSE);
105
161
  // Le filtre d'une requête sur les choses (`alias`, la table des choses dans la requête) : la
106
162
  // chose est à la personne, ou ouverte à elle ; et l'expression de son droit, `proprietaire`,
107
163
  // `modification`, `lecture`, ou null. Ses deux valeurs sont les paramètres `$<depuis>` et
108
- // `$<depuis + 1>` de la requête.
164
+ // `$<depuis + 1>` de la requête. Avec `auProprietaireDuServeur`, le propriétaire du serveur voit
165
+ // toute chose, avec au moins ce droit.
109
166
  function pourLaPersonne(personne, { alias = table, depuis = 1 } = {}) {
110
- const nom = identifiantSql(alias);
167
+ const nomDeLAlias = identifiantSql(alias);
111
168
  const elle = `$${depuis}`;
112
- const ouvertures = `select 1 from ${partage} as partage_ouvert where partage_ouvert.${chose} = ${nom}.id and partage_ouvert.avec = any($${depuis + 1}::text[])`;
169
+ const ouvertures = `select 1 from ${partage} as partage_ouvert where partage_ouvert.${chose} = ${nomDeLAlias}.id and partage_ouvert.avec = any($${depuis + 1}::text[])`;
170
+ const auServeur = auProprietaireDuServeur && personne.proprietaire ? auProprietaireDuServeur : undefined;
171
+ const sinon = auServeur ? `'${auServeur}'` : 'null';
113
172
  return {
114
- ouverte: `(${nom}.${proprietaire} = ${elle} or exists (${ouvertures}))`,
115
- droit: `(case when ${nom}.${proprietaire} = ${elle} then 'proprietaire'
173
+ ouverte: `(${nomDeLAlias}.${proprietaire} = ${elle} or exists (${ouvertures})${auServeur ? ' or true' : ''})`,
174
+ droit: `(case when ${nomDeLAlias}.${proprietaire} = ${elle} then 'proprietaire'
116
175
  when exists (${ouvertures} and partage_ouvert.droit = 'modification') then 'modification'
117
- when exists (${ouvertures}) then 'lecture' end)`,
176
+ when exists (${ouvertures}) then ${auServeur === 'modification' ? '\'modification\'' : '\'lecture\''} else ${sinon} end)`,
118
177
  valeurs: [personne.id, ouverturesDe(personne)],
119
178
  };
120
179
  }
121
- // Le droit de la personne sur une chose, ou rien : une chose absente, ou qui ne lui est pas ouverte.
122
- async function droitSur(personne, id) {
123
- const { droit, valeurs } = pourLaPersonne(personne, { alias: 'chose_lue', depuis: 2 });
124
- const { rows } = await base.query(`select ${droit} as droit from ${table} as chose_lue where chose_lue.id = $1`, [id, ...valeurs]);
125
- return rows[0]?.droit ?? undefined;
180
+ // Une chose ouverte à la personne, avec son droit (`droit`), ou rien : un identifiant qui n'est
181
+ // pas un UUID, une chose absente, ou qui ne lui est pas ouverte. `colonnes` remplace celles de
182
+ // l'app, comme pour lire aussi un contenu ; `client`, le client d'une transaction de l'app.
183
+ async function trouver(personne, id, { colonnes: liste = colonnes, client = base } = {}) {
184
+ const uuid = identifiant(id);
185
+ if (!uuid) {
186
+ return undefined;
187
+ }
188
+ const { ouverte, droit, valeurs } = pourLaPersonne(personne, { alias: aliasDuDroit, depuis: 2 });
189
+ const { rows } = await client.query(`select ${liste}, ${droit} as droit from ${depuis} where ${table}.id = $1 and ${ouverte}`, [uuid, ...valeurs]);
190
+ return rows[0];
126
191
  }
127
- // Seul le propriétaire partage : pour toute autre personne, la chose est absente.
128
- async function exigerLaPropriete(personne, id) {
129
- const { rows } = await base.query(`select 1 from ${table} where id = $1 and ${proprietaire} = $2`, [id, personne.id]);
192
+ // Seul le propriétaire partage et donne : pour toute autre personne, la chose est absente. Une
193
+ // chose rangée n'a pas de propriétaire à elle : elle est absente de même. Rend son identifiant, et
194
+ // son nom quand le geste le demande (`avecLeNom`), la colonne `nom` n'existant que dans une app qui
195
+ // donne.
196
+ async function exigerLaPropriete(personne, id, { client = base, avecLeNom = false } = {}) {
197
+ const uuid = identifiant(id);
198
+ const { rows } = uuid ? await client.query(`select id${avecLeNom ? `, ${nom} as nom` : ''} from ${table} where id = $1 and ${proprietaire} = $2`, [uuid, personne.id]) : { rows: [] };
130
199
  if (!rows[0]) {
131
- throw new Refus(absente(id));
200
+ throw new Refus(absente(String(id)));
132
201
  }
202
+ return rows[0];
133
203
  }
134
204
  async function lignesDe(id) {
135
205
  const { rows } = await base.query(`select avec, droit from ${partage} where ${chose} = $1`, [id]);
@@ -155,29 +225,81 @@ export function creerLePartage(options) {
155
225
  // inconnus sont refusés, `refus` en tête du texte.
156
226
  function cibles(arguments_, annuaire, refus) {
157
227
  const trouvees = arguments_.equipe === true ? [{ avec: 'equipe', quoi: 'à toute l\'équipe' }] : [];
158
- for (const nom of texts(arguments_.groupes)) {
159
- const groupe = annuaire.groupes.find((un) => un.nom === nom.trim())
160
- ?? annuaire.groupes.find((un) => un.nom.toLowerCase() === nom.trim().toLowerCase());
228
+ for (const nomDuGroupe of texts(arguments_.groupes)) {
229
+ const groupe = annuaire.groupes.find((un) => un.nom === nomDuGroupe.trim())
230
+ ?? annuaire.groupes.find((un) => un.nom.toLowerCase() === nomDuGroupe.trim().toLowerCase());
161
231
  if (!groupe) {
162
232
  const connus = annuaire.groupes.map((un) => un.nom).sort((un, autre) => un.localeCompare(autre, 'fr'));
163
- throw new Refus(`${refus} : aucun groupe de l'équipe ne s'appelle « ${nom} ». ${connus.length ? `Ses groupes : ${connus.join(', ')}.` : 'L\'équipe n\'a aucun groupe.'} Toute l'équipe se dit \`equipe: true\`.`);
233
+ throw new Refus(`${refus} : aucun groupe de l'équipe ne s'appelle « ${nomDuGroupe} ». ${connus.length ? `Ses groupes : ${connus.join(', ')}.` : 'L\'équipe n\'a aucun groupe.'} Toute l'équipe se dit \`equipe: true\`.`);
164
234
  }
165
235
  const membres = groupe.membres.flatMap((id) => annuaire.personnes.filter((une) => une.id === id && une.active).map((une) => une.nom));
166
236
  trouvees.push({ avec: `groupe:${groupe.id}`, quoi: `au groupe ${groupe.nom} (${membres.length ? membres.join(', ') : 'sans membre'})` });
167
237
  }
168
238
  for (const email of texts(arguments_.personnes)) {
169
- const connue = annuaire.personnes.find((une) => une.email.toLowerCase() === email.trim().toLowerCase());
170
- if (!connue) {
171
- throw new Refus(`${refus} : personne dans l'équipe n'a le courriel ${email}. Vérifier le courriel avec la personne.`);
172
- }
239
+ const connue = personneDuCourriel(annuaire, email, refus);
173
240
  trouvees.push({ avec: `personne:${connue.id}`, quoi: `à ${connue.nom} (${connue.email})` });
174
241
  }
175
242
  return [...new Map(trouvees.map((cible) => [cible.avec, cible])).values()];
176
243
  }
177
244
  return {
178
245
  pourLaPersonne,
179
- droitSur,
246
+ trouver,
180
247
  lireLAnnuaire,
248
+ // Le droit de la personne sur une chose, ou rien : une chose absente, ou qui ne lui est pas ouverte.
249
+ async droitSur(personne, id) {
250
+ return (await trouver(personne, id, { colonnes: `${table}.id` }))?.droit;
251
+ },
252
+ // Une chose dont la personne a le droit demandé (`droit`, la lecture par défaut) ; sinon, le
253
+ // refus d'une chose absente (`absente`), le même pour une chose absente et pour un droit qui
254
+ // ne suffit pas. Mêmes options que `trouver`.
255
+ async lire(personne, id, { droit = 'lecture', ...reste } = {}) {
256
+ const lue = await trouver(personne, id, reste);
257
+ if (!lue || !suffit(lue.droit, droit)) {
258
+ throw new Refus(absente(String(id)));
259
+ }
260
+ return lue;
261
+ },
262
+ // `chercher` d'une app qui partage : les choses que la personne voit dont le texte se trouve
263
+ // dans `cherche`, sans tenir compte des accents ni de la casse, dans la vue demandée (`toutes`
264
+ // par défaut, `a_moi`, `partagees`), chacune avec son droit : la page demandée (1 par
265
+ // défaut), `lignesParPage` choses au plus, dans l'ordre de l'app ; et le total de celles qui
266
+ // répondent. Les arguments sont ceux de l'outil, tels que Claude ou l'écran les donne ;
267
+ // `condition` ajoute une condition de l'app, ses valeurs passées par `valeur`, qui rend leur
268
+ // paramètre (`(valeur) => \`page.charte\``).
269
+ async chercher(personne, arguments_, { colonnes: liste = colonnes, condition } = {}) {
270
+ const { ouverte, droit, valeurs } = pourLaPersonne(personne, { alias: aliasDuDroit, depuis: 1 });
271
+ const parametres = [...valeurs];
272
+ const valeur = (une) => `$${parametres.push(une)}`;
273
+ const texte = typeof arguments_.texte === 'string' ? arguments_.texte.trim() : '';
274
+ const vue = vuesDeChercher.find((une) => une === arguments_.vue) ?? 'toutes';
275
+ const page = typeof arguments_.page === 'number' && Number.isInteger(arguments_.page) && arguments_.page > 1 ? arguments_.page : 1;
276
+ const conditions = [ouverte];
277
+ if (texte) {
278
+ const motif = valeur(motifSansAccents(texte));
279
+ conditions.push(`(${cherche.map((expression) => `${sansAccentsEnSql(expression)} like ${motif}`).join(' or ')})`);
280
+ }
281
+ if (vue !== 'toutes') {
282
+ conditions.push(`${aliasDuDroit}.${proprietaire} ${vue === 'a_moi' ? '=' : 'is distinct from'} $1`);
283
+ }
284
+ const enPlus = condition?.(valeur);
285
+ if (enPlus) {
286
+ conditions.push(`(${enPlus})`);
287
+ }
288
+ const ou = conditions.join(' and ');
289
+ const avant = [...parametres];
290
+ const [{ rows: lignes }, { rows: [{ total }] }] = await Promise.all([
291
+ base.query(`select ${liste}, ${droit} as droit from ${depuis} where ${ou} order by ${ordre} limit ${valeur(lignesParPage)} offset ${valeur((page - 1) * lignesParPage)}`, parametres),
292
+ base.query(`select count(*)::int as total from ${depuis} where ${ou}`, avant),
293
+ ]);
294
+ return { lignes, total };
295
+ },
296
+ // Pose sur une chose qui vient d'être créée l'ouverture que l'app déclare (`aLaCreation`),
297
+ // dans la transaction de la création (`client`) ; sans déclaration, rien : la chose naît privée.
298
+ async ouvrirALaCreation(client, id) {
299
+ if (aLaCreation) {
300
+ await client.query(`insert into ${partage} (${chose}, avec, droit) values ($1, $2, $3) on conflict do nothing`, [id, aLaCreation.avec, aLaCreation.droit]);
301
+ }
302
+ },
181
303
  // Avec qui la chose est partagée, et quel droit : ce que `lire` en rend.
182
304
  async partageDe(id) {
183
305
  return decrire(await lignesDe(id), await lireLAnnuaire());
@@ -187,7 +309,7 @@ export function creerLePartage(options) {
187
309
  // `confirmer: true`, et son refus dit à qui la chose s'ouvrirait. Restreindre n'attend pas.
188
310
  // Rend le partage qui en résulte.
189
311
  async partager(personne, id, arguments_) {
190
- await exigerLaPropriete(personne, id);
312
+ ({ id } = await exigerLaPropriete(personne, id));
191
313
  const droit = arguments_.droit === 'modification' ? 'modification' : 'lecture';
192
314
  const annuaire = await lireLAnnuaire();
193
315
  const visees = cibles(arguments_, annuaire, 'Rien n\'est partagé');
@@ -218,7 +340,7 @@ export function creerLePartage(options) {
218
340
  // `groupes_supprimes`, aux groupes supprimés. Sans accord : rien ne s'ouvre. Rend le partage
219
341
  // qui reste.
220
342
  async nePlusPartager(personne, id, arguments_) {
221
- await exigerLaPropriete(personne, id);
343
+ ({ id } = await exigerLaPropriete(personne, id));
222
344
  const annuaire = await lireLAnnuaire();
223
345
  const retirees = cibles(arguments_, annuaire, 'Rien n\'est retiré').map((cible) => cible.avec);
224
346
  if (arguments_.groupes_supprimes === true) {
@@ -231,8 +353,94 @@ export function creerLePartage(options) {
231
353
  await base.query(`delete from ${partage} where ${chose} = $1 and avec = any($2::text[])`, [id, retirees]);
232
354
  return decrire(await lignesDe(id), annuaire);
233
355
  },
356
+ // `donner`, au propriétaire seul : la chose passe à une autre personne de l'équipe, active
357
+ // (`a`, son courriel), qui en devient propriétaire ; son partage reste, sans l'ouverture à
358
+ // cette personne, qui la possède. Toujours avec l'accord de la personne (`confirmer: true`) :
359
+ // sans lui, le refus dit ce qui change. Rend le nouveau propriétaire et le partage ; l'app
360
+ // relit ensuite ce qu'elle relit après un partage (ses connexions en direct).
361
+ async donner(personne, id, arguments_) {
362
+ const lue = await exigerLaPropriete(personne, id, { avecLeNom: true });
363
+ const annuaire = await lireLAnnuaire();
364
+ const a = personneDuCourriel(annuaire, arguments_.a, 'Rien n\'est donné');
365
+ if (a.id === personne.id) {
366
+ throw new Refus(`Rien n'est donné : ${laChose} est déjà à ${personne.email}.`);
367
+ }
368
+ if (!a.active) {
369
+ throw new Refus(`Rien n'est donné : ${a.nom} (${a.email}) est désactivée et ne se connecte plus.`);
370
+ }
371
+ if (arguments_.confirmer !== true) {
372
+ 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.`);
373
+ }
374
+ await enTransaction(base, async (client) => {
375
+ await exigerLaPropriete(personne, lue.id, { client });
376
+ await client.query(`update ${table} set ${proprietaire} = $2 where id = $1`, [lue.id, a.id]);
377
+ await client.query(`delete from ${partage} where ${chose} = $1 and avec = $2`, [lue.id, `personne:${a.id}`]);
378
+ });
379
+ return { id: lue.id, proprietaire: { nom: a.nom, email: a.email }, partage: decrire(await lignesDe(lue.id), annuaire) };
380
+ },
381
+ // `donner_les_choses`, au propriétaire du serveur seul : toutes les choses d'une personne
382
+ // désactivée (`de`, son courriel) passent à une personne active (`a`), racines seules (une
383
+ // chose rangée suit sa racine) ; leur partage reste, sans l'ouverture à `a`. Que `de` est
384
+ // désactivée se lit à l'annuaire relu au core, celui gardé quelques secondes pouvant la dire
385
+ // encore active. Rend les choses données.
386
+ async donnerLesChoses(personne, arguments_) {
387
+ if (!personne.proprietaire) {
388
+ throw new Refus('Rien n\'est donné : seul le propriétaire du serveur donne les choses d\'une personne désactivée.');
389
+ }
390
+ const annuaire = await lireLAnnuaire({ sansCache: true });
391
+ const de = personneDuCourriel(annuaire, arguments_.de, 'Rien n\'est donné');
392
+ if (de.active) {
393
+ throw new Refus(`Rien n'est donné : ${de.nom} (${de.email}) est encore active. Ses choses ne se donnent ainsi qu'une fois la personne désactivée, dans « Équipe ».`);
394
+ }
395
+ const a = personneDuCourriel(annuaire, arguments_.a, 'Rien n\'est donné');
396
+ if (!a.active) {
397
+ throw new Refus(`Rien n'est donné : ${a.nom} (${a.email}) est désactivée et ne se connecte plus.`);
398
+ }
399
+ const choses = await enTransaction(base, async (client) => {
400
+ const { rows } = await client.query(`update ${table} set ${proprietaire} = $2 where ${proprietaire} = $1${racine ? ` and id = ${racine}` : ''} returning id, ${nom} as nom`, [de.id, a.id]);
401
+ await client.query(`delete from ${partage} where ${chose} = any($1::uuid[]) and avec = $2`, [rows.map((ligne) => ligne.id), `personne:${a.id}`]);
402
+ return rows;
403
+ });
404
+ choses.sort((une, autre) => une.nom.localeCompare(autre.nom, 'fr'));
405
+ return { nombre: choses.length, choses };
406
+ },
407
+ };
408
+ }
409
+ // L'outil `donner_les_choses` d'une app qui partage, le même dans chaque app : le core l'appelle au
410
+ // nom du propriétaire du serveur quand il donne les choses d'une personne désactivée, et le Claude
411
+ // du propriétaire l'a aussi. Réservé au propriétaire du serveur. `apresUnDon` relit ce que l'app
412
+ // relit après un partage, comme ses connexions en direct, pour chaque chose donnée ; son échec est
413
+ // écrit au journal de l'app, le don étant fait.
414
+ export function outilDeDonnerLesChoses(partage, { apresUnDon } = {}) {
415
+ return {
416
+ nom: 'donner_les_choses',
417
+ description: 'Au propriétaire du serveur seul : donne toutes les choses de cette app d\'une personne désactivée (`de`, son courriel) à une personne active de l\'équipe (`a`), qui en devient propriétaire ; leur partage reste. Une chose rangée dans une autre suit sa racine. Refusé pour une personne encore active : la désactiver d\'abord dans « Équipe ». Rend `{ nombre, choses }`, les choses données.',
418
+ schema: schemaDeDonnerLesChoses(),
419
+ pour: (personne) => personne.proprietaire,
420
+ executer: async (arguments_, personne) => {
421
+ const donnees = await partage.donnerLesChoses(personne, arguments_);
422
+ for (const { id } of donnees.choses) {
423
+ try {
424
+ await apresUnDon?.(id);
425
+ }
426
+ catch (erreur) {
427
+ console.error(`La relecture après le don de ${id} a échoué :`, erreur);
428
+ }
429
+ }
430
+ return JSON.stringify(donnees);
431
+ },
234
432
  };
235
433
  }
434
+ // Une personne de l'annuaire par son courriel ; une personne inconnue est refusée, `refus` en tête
435
+ // du texte.
436
+ function personneDuCourriel(annuaire, email, refus) {
437
+ const texte = typeof email === 'string' ? email.trim() : '';
438
+ const connue = annuaire.personnes.find((une) => une.email.toLowerCase() === texte.toLowerCase());
439
+ if (!connue) {
440
+ throw new Refus(`${refus} : personne dans l'équipe n'a le courriel ${texte}. Vérifier le courriel avec la personne.`);
441
+ }
442
+ return connue;
443
+ }
236
444
  // Un nom de table ou de colonne écrit dans le SQL : celui que l'app donne, en lettres simples.
237
445
  function identifiantSql(nom) {
238
446
  if (!/^[a-z_][a-z0-9_]*$/.test(nom)) {
@@ -3,5 +3,5 @@ import { AlertDialog } from 'radix-ui';
3
3
  import { Bouton } from './bouton.js';
4
4
  import { rendreLeFocus } from './focus.js';
5
5
  export function Confirmation({ titre, consequence, suites, verbe, sorte = 'detruit', onConfirmer, ouverte, onOuverteChange, retour, children }) {
6
- return (_jsxs(AlertDialog.Root, { open: ouverte, onOpenChange: onOuverteChange, children: [children && _jsx(AlertDialog.Trigger, { asChild: true, children: children }), _jsxs(AlertDialog.Portal, { children: [_jsx(AlertDialog.Overlay, { className: "fixed inset-0 z-50 bg-papier/75" }), _jsx("div", { className: "fixed inset-0 z-50 grid place-items-center overflow-y-auto p-4 pointer-events-none", children: _jsxs(AlertDialog.Content, { onCloseAutoFocus: (evenement) => rendreLeFocus(evenement, retour), className: "pointer-events-auto w-full max-w-[560px] rounded-[10px] border border-trait bg-papier p-[22px] text-encre", children: [_jsx(AlertDialog.Title, { className: "m-0 text-[17px] font-semibold", children: titre }), _jsx(AlertDialog.Description, { asChild: true, children: _jsx("div", { className: "mt-2", children: consequence }) }), suites && suites.length > 0 && (_jsx("ul", { className: "mt-2.5 list-disc pl-5 text-gris", children: suites.map((suite) => _jsx("li", { children: suite }, suite)) })), _jsxs("div", { className: "mt-[22px] flex flex-wrap items-center gap-2", children: [_jsx(AlertDialog.Cancel, { asChild: true, children: _jsx(Bouton, { type: "button", sorte: "secondaire", children: "Annuler" }) }), _jsx(AlertDialog.Action, { asChild: true, children: _jsx(Bouton, { type: "button", sorte: sorte, onClick: onConfirmer, children: verbe }) })] })] }) })] })] }));
6
+ return (_jsxs(AlertDialog.Root, { open: ouverte, onOpenChange: onOuverteChange, children: [children && _jsx(AlertDialog.Trigger, { asChild: true, children: children }), _jsxs(AlertDialog.Portal, { children: [_jsx(AlertDialog.Overlay, { className: "fixed inset-0 z-50 bg-papier/75" }), _jsx("div", { className: "fixed inset-0 z-50 grid place-items-center p-4 pointer-events-none", children: _jsxs(AlertDialog.Content, { onCloseAutoFocus: (evenement) => rendreLeFocus(evenement, retour), className: "pointer-events-auto max-h-[calc(100dvh-2rem)] w-full max-w-[560px] overflow-y-auto overscroll-contain rounded-[10px] border border-trait bg-papier p-[22px] text-encre", children: [_jsx(AlertDialog.Title, { className: "m-0 text-[17px] font-semibold", children: titre }), _jsx(AlertDialog.Description, { asChild: true, children: _jsx("div", { className: "mt-2", children: consequence }) }), suites && suites.length > 0 && (_jsx("ul", { className: "mt-2.5 list-disc pl-5 text-gris", children: suites.map((suite) => _jsx("li", { children: suite }, suite)) })), _jsxs("div", { className: "mt-[22px] flex flex-wrap items-center gap-2", children: [_jsx(AlertDialog.Cancel, { asChild: true, children: _jsx(Bouton, { type: "button", sorte: "secondaire", children: "Annuler" }) }), _jsx(AlertDialog.Action, { asChild: true, children: _jsx(Bouton, { type: "button", sorte: sorte, onClick: onConfirmer, children: verbe }) })] })] }) })] })] }));
7
7
  }
package/src/ui/fenetre.js CHANGED
@@ -31,11 +31,11 @@ export function Fenetre({ titre, presentation, verbe, onEnvoyer, declencheur, ou
31
31
  setOccupee(false);
32
32
  }
33
33
  }
34
- return (_jsxs(Dialog.Root, { open: estOuverte, onOpenChange: changer, children: [declencheur && _jsx(Dialog.Trigger, { asChild: true, children: declencheur }), _jsxs(Dialog.Portal, { children: [_jsx(Dialog.Overlay, { className: "fixed inset-0 z-50 bg-papier/75" }), _jsx("div", { className: "pointer-events-none fixed inset-0 z-50 grid place-items-center overflow-y-auto p-4 max-[760px]:place-items-start max-[760px]:p-0", children: _jsxs(Dialog.Content, { ...(presentation ? {} : { 'aria-describedby': undefined }), onOpenAutoFocus: (evenement) => {
34
+ return (_jsxs(Dialog.Root, { open: estOuverte, onOpenChange: changer, children: [declencheur && _jsx(Dialog.Trigger, { asChild: true, children: declencheur }), _jsxs(Dialog.Portal, { children: [_jsx(Dialog.Overlay, { className: "fixed inset-0 z-50 bg-papier/75" }), _jsx("div", { className: "pointer-events-none fixed inset-0 z-50 grid place-items-center p-4 max-[760px]:place-items-start max-[760px]:p-0", children: _jsxs(Dialog.Content, { ...(presentation ? {} : { 'aria-describedby': undefined }), onOpenAutoFocus: (evenement) => {
35
35
  const premier = evenement.currentTarget.querySelector(saisies);
36
36
  if (premier) {
37
37
  evenement.preventDefault();
38
38
  premier.focus();
39
39
  }
40
- }, onCloseAutoFocus: (evenement) => rendreLeFocus(evenement, retour), className: cn('pointer-events-auto w-full max-w-[560px] rounded-[10px] border border-trait bg-papier p-[22px] text-encre', 'max-[760px]:max-w-none max-[760px]:rounded-none max-[760px]:border-x-0 max-[760px]:border-t-0', className), children: [_jsx(Dialog.Title, { className: "m-0 text-[17px] font-semibold", children: titre }), presentation && (_jsx(Dialog.Description, { asChild: true, children: _jsx("div", { className: "mt-2 text-gris", children: presentation }) })), _jsxs("form", { className: "mt-4 grid gap-4", onSubmit: envoyer, children: [children, erreur && _jsx(Message, { erreur: true, titre: erreur, className: "mb-0" }), _jsxs("div", { className: "mt-1.5 flex flex-wrap items-center gap-2", children: [_jsx(Dialog.Close, { asChild: true, children: _jsx(Bouton, { type: "button", sorte: "secondaire", children: "Annuler" }) }), _jsx(Bouton, { type: "submit", disabled: occupee, "aria-busy": occupee || undefined, children: verbe })] })] })] }) })] })] }));
40
+ }, onCloseAutoFocus: (evenement) => rendreLeFocus(evenement, retour), className: cn('pointer-events-auto max-h-[calc(100dvh-2rem)] w-full max-w-[560px] overflow-y-auto overscroll-contain rounded-[10px] border border-trait bg-papier p-[22px] text-encre', 'max-[760px]:max-h-dvh max-[760px]:max-w-none max-[760px]:rounded-none max-[760px]:border-x-0 max-[760px]:border-t-0', className), children: [_jsx(Dialog.Title, { className: "m-0 text-[17px] font-semibold", children: titre }), presentation && (_jsx(Dialog.Description, { asChild: true, children: _jsx("div", { className: "mt-2 text-gris", children: presentation }) })), _jsxs("form", { className: "mt-4 grid gap-4", onSubmit: envoyer, children: [children, erreur && _jsx(Message, { erreur: true, titre: erreur, className: "mb-0" }), _jsxs("div", { className: "mt-1.5 flex flex-wrap items-center gap-2", children: [_jsx(Dialog.Close, { asChild: true, children: _jsx(Bouton, { type: "button", sorte: "secondaire", children: "Annuler" }) }), _jsx(Bouton, { type: "submit", disabled: occupee, "aria-busy": occupee || undefined, children: verbe })] })] })] }) })] })] }));
41
41
  }
package/src/ui/panneau.js CHANGED
@@ -1,6 +1,7 @@
1
1
  import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
2
  import { useRef } from 'react';
3
3
  import { Dialog } from 'radix-ui';
4
+ import { classesDuTitreDeSection } from './blocs.js';
4
5
  import { Bouton } from './bouton.js';
5
6
  import { cn } from './classes.js';
6
7
  export function Panneau({ titre, surtitre, etiquette, declencheur, ouvert, onOuvertChange, retour, className, children }) {
@@ -14,5 +15,5 @@ export function Panneau({ titre, surtitre, etiquette, declencheur, ouvert, onOuv
14
15
  evenement.preventDefault();
15
16
  cible.focus();
16
17
  }
17
- }, className: cn('fixed inset-y-0 right-0 z-50 flex w-[min(560px,100%)] flex-col border-l border-trait bg-papier text-encre', 'max-[760px]:w-full max-[760px]:border-l-0', className), children: [_jsxs("div", { className: "flex items-start justify-between gap-4 border-b border-trait px-[22px] py-4", children: [_jsxs("div", { className: "min-w-0", children: [surtitre && _jsx("p", { className: "m-0 mb-1 text-[11px] tracking-[.07em] text-gris uppercase", children: surtitre }), _jsx(Dialog.Title, { className: "m-0 font-titre text-[26px] leading-[1.1] font-normal [overflow-wrap:anywhere]", children: titre }), etiquette && _jsx("div", { className: "mt-2", children: etiquette })] }), _jsx(Dialog.Close, { asChild: true, children: _jsx(Bouton, { type: "button", sorte: "discret", children: "Fermer" }) })] }), _jsx("div", { className: "min-h-0 flex-1 overflow-y-auto px-[22px] py-5", children: children })] })] })] }));
18
+ }, className: cn('fixed inset-y-0 right-0 z-50 flex w-[min(560px,100%)] flex-col border-l border-trait bg-papier text-encre', 'max-[760px]:w-full max-[760px]:border-l-0', className), children: [_jsxs("div", { className: "flex items-start justify-between gap-4 border-b border-trait px-[22px] py-4", children: [_jsxs("div", { className: "min-w-0", children: [surtitre && _jsx("p", { className: cn(classesDuTitreDeSection, 'mb-1'), children: surtitre }), _jsx(Dialog.Title, { className: "m-0 font-titre text-[26px] leading-[1.1] font-normal [overflow-wrap:anywhere]", children: titre }), etiquette && _jsx("div", { className: "mt-2", children: etiquette })] }), _jsx(Dialog.Close, { asChild: true, children: _jsx(Bouton, { type: "button", sorte: "discret", children: "Fermer" }) })] }), _jsx("div", { className: "min-h-0 flex-1 overflow-y-auto px-[22px] py-5", children: children })] })] })] }));
18
19
  }
package/src/ui/theme.css CHANGED
@@ -94,8 +94,9 @@
94
94
  /* Le tableau sur un téléphone, jusqu'à 760 px, le seul seuil de l'espace : chaque ligne s'empile. En
95
95
  tête, les cellules que sa déclaration y met (`data-tete`), dans leur ordre, chacune sur sa ligne ;
96
96
  en haut à droite, celle de ses gestes, une colonne sans titre (`data-geste`), comme le ⋯ ; puis les
97
- autres, chacune sur sa ligne, après le titre de sa colonne en gris (`data-titre`). Les en-têtes
98
- restent lus par un lecteur d'écran, qui ne lit pas les titres recopiés. */
97
+ autres, chacune sur sa ligne, après le titre de sa colonne en gris (`data-titre`) ; une cellule
98
+ vide ne se montre pas, ni le titre de sa colonne. Les en-têtes restent lus par un lecteur d'écran,
99
+ qui ne lit pas les titres recopiés. */
99
100
  @media (max-width: 760px) {
100
101
  .tableau { overflow-x: visible; }
101
102
  .tableau table, .tableau tbody { display: block; }
@@ -113,6 +114,7 @@
113
114
  color: var(--gris);
114
115
  }
115
116
  .tableau td[colspan] { grid-column: 1 / -1; }
117
+ .tableau td:empty { display: none; }
116
118
  }
117
119
 
118
120
  @media (prefers-reduced-motion: reduce) {