@indos/bibliotheque 0.0.0-stage → 1.1.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 +36 -0
- package/LICENSE +21 -0
- package/README.md +8 -2
- package/bin/page-de-l-espace.d.ts +1 -0
- package/bin/page-de-l-espace.js +29 -0
- package/modeles/partage.sql +16 -0
- package/package.json +117 -4
- package/src/app.d.ts +3 -0
- package/src/app.js +30 -0
- package/src/appel-d-ecran.d.ts +18 -0
- package/src/appel-d-ecran.js +82 -0
- package/src/appeler.d.ts +13 -0
- package/src/appeler.js +33 -0
- package/src/base-d-essai.d.ts +4 -0
- package/src/base-d-essai.js +18 -0
- package/src/base.d.ts +3 -0
- package/src/base.js +49 -0
- package/src/compte.d.ts +53 -0
- package/src/compte.js +176 -0
- package/src/deriver.d.ts +2 -0
- package/src/deriver.js +28 -0
- package/src/description-des-comptes.d.ts +50 -0
- package/src/description-des-comptes.js +4 -0
- package/src/ecran.d.ts +90 -0
- package/src/ecran.js +139 -0
- package/src/espace/appel.d.ts +10 -0
- package/src/espace/appel.js +20 -0
- package/src/espace/appels.d.ts +23 -0
- package/src/espace/appels.js +81 -0
- package/src/espace/comptes.d.ts +1 -0
- package/src/espace/comptes.js +180 -0
- package/src/espace/contexte.d.ts +8 -0
- package/src/espace/contexte.js +6 -0
- package/src/espace/coquille.d.ts +2 -0
- package/src/espace/coquille.js +76 -0
- package/src/espace/ecran.d.ts +10 -0
- package/src/espace/ecran.js +23 -0
- package/src/espace/entree-active.d.ts +2 -0
- package/src/espace/entree-active.js +21 -0
- package/src/espace/erreur.d.ts +3 -0
- package/src/espace/erreur.js +23 -0
- package/src/espace/heure.d.ts +1 -0
- package/src/espace/heure.js +14 -0
- package/src/espace/index.d.ts +12 -0
- package/src/espace/index.js +13 -0
- package/src/espace/lancer.d.ts +3 -0
- package/src/espace/lancer.js +13 -0
- package/src/espace/lien.d.ts +6 -0
- package/src/espace/lien.js +43 -0
- package/src/espace/navigation.d.ts +1 -0
- package/src/espace/navigation.js +5 -0
- package/src/espace/page.d.ts +25 -0
- package/src/espace/page.js +51 -0
- package/src/espace/pagination.d.ts +8 -0
- package/src/espace/pagination.js +19 -0
- package/src/espace/session.d.ts +37 -0
- package/src/espace/session.js +13 -0
- package/src/faux-core.d.ts +29 -0
- package/src/faux-core.js +112 -0
- package/src/fichiers.d.ts +36 -0
- package/src/fichiers.js +109 -0
- package/src/jeton.d.ts +10 -0
- package/src/jeton.js +96 -0
- package/src/liens.d.ts +10 -0
- package/src/liens.js +52 -0
- package/src/mcp.d.ts +20 -0
- package/src/mcp.js +153 -0
- package/src/page.d.ts +17 -0
- package/src/page.js +127 -0
- package/src/pagination.d.ts +1 -0
- package/src/pagination.js +4 -0
- package/src/partage.d.ts +62 -0
- package/src/partage.js +248 -0
- package/src/session.d.ts +17 -0
- package/src/session.js +124 -0
- package/src/theme.d.ts +2 -0
- package/src/theme.js +52 -0
- package/src/type-de-fichier.d.ts +6 -0
- package/src/type-de-fichier.js +115 -0
- package/src/ui/annonce.d.ts +7 -0
- package/src/ui/annonce.js +18 -0
- package/src/ui/blocs.d.ts +44 -0
- package/src/ui/blocs.js +34 -0
- package/src/ui/bouton.d.ts +7 -0
- package/src/ui/bouton.js +13 -0
- package/src/ui/cases.d.ts +19 -0
- package/src/ui/cases.js +17 -0
- package/src/ui/champ.d.ts +21 -0
- package/src/ui/champ.js +25 -0
- package/src/ui/choix.d.ts +16 -0
- package/src/ui/choix.js +11 -0
- package/src/ui/classes.d.ts +2 -0
- package/src/ui/classes.js +7 -0
- package/src/ui/confirmation.d.ts +12 -0
- package/src/ui/confirmation.js +6 -0
- package/src/ui/fenetre.d.ts +13 -0
- package/src/ui/fenetre.js +40 -0
- package/src/ui/graphiques.d.ts +44 -0
- package/src/ui/graphiques.js +128 -0
- package/src/ui/index.d.ts +18 -0
- package/src/ui/index.js +20 -0
- package/src/ui/lien.d.ts +8 -0
- package/src/ui/lien.js +10 -0
- package/src/ui/menu.d.ts +8 -0
- package/src/ui/menu.js +20 -0
- package/src/ui/panneau.d.ts +12 -0
- package/src/ui/panneau.js +17 -0
- package/src/ui/repli.d.ts +12 -0
- package/src/ui/repli.js +6 -0
- package/src/ui/suggestions.d.ts +14 -0
- package/src/ui/suggestions.js +54 -0
- package/src/ui/tableau.d.ts +18 -0
- package/src/ui/tableau.js +28 -0
- package/src/ui/theme.css +112 -0
- package/src/ui/vues.d.ts +15 -0
- package/src/ui/vues.js +7 -0
- package/src/vite.d.ts +19 -0
- package/src/vite.js +195 -0
- package/tsconfig.page.json +30 -0
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
# Ce qui change dans @indos/bibliotheque
|
|
2
|
+
|
|
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
|
+
|
|
5
|
+
## 1.1.0
|
|
6
|
+
|
|
7
|
+
- `@indos/bibliotheque/fichiers` : un fichier déposé par `deposerUnFichier` avec `entreprise: true` entre comme une pièce de l'entreprise, que lit toute personne de l'équipe qui a son identifiant et qui ne se supprime pas. `donnerALEntreprise(appeler, personne, id)` fait d'une fiche de la personne une pièce de l'entreprise. La fiche rendue dit `entreprise`. Les deux demandent fichiers 1.7 ou plus récent sur le serveur.
|
|
8
|
+
- Rien à changer dans l'app pour monter : `"@indos/bibliotheque": "1.1.0"` dans ses `dependencies`, puis `npm install`.
|
|
9
|
+
|
|
10
|
+
## 1.0.0
|
|
11
|
+
|
|
12
|
+
La première version publiée sur npm. Elle donne à une app du client ce qu'une app du catalogue d'Indos a, par ses entrées :
|
|
13
|
+
|
|
14
|
+
- `@indos/bibliotheque/app` : le serveur HTTP de l'app, qui répond sur `/sante` et se ferme proprement.
|
|
15
|
+
- `@indos/bibliotheque/base` : la base de l'app, par `DATABASE_URL`, et ses migrations `.sql`, appliquées au démarrage, chacune une fois.
|
|
16
|
+
- `@indos/bibliotheque/mcp` : le MCP de l'app pour Claude, et les mêmes outils pour ses écrans. Le jeton du core est vérifié à chaque requête ; chaque personne ne voit que les outils qui lui sont permis.
|
|
17
|
+
- `@indos/bibliotheque/jeton` et `@indos/bibliotheque/session` : la personne connectée, par le jeton du core ou par sa session dans l'espace, avec ses groupes et les apps qui lui sont ouvertes.
|
|
18
|
+
- `@indos/bibliotheque/page`, `@indos/bibliotheque/espace`, `@indos/bibliotheque/ui` et `@indos/bibliotheque/ui/theme.css` : la page de l'espace en React, sa coquille, ses composants et sa feuille, au thème du client. La commande `page-de-l-espace` la construit (`construire`), la sert à chaud (`developper`) et lance ses tests (`tester`).
|
|
19
|
+
- `@indos/bibliotheque/appeler` : l'appel aux outils d'une autre app, par le core.
|
|
20
|
+
- `@indos/bibliotheque/fichiers` : déposer un fichier dans les fichiers d'une personne, et en lire un.
|
|
21
|
+
- `@indos/bibliotheque/compte` : un compte branché, son secret chiffré, et les gestes de l'écran commun des comptes.
|
|
22
|
+
- `@indos/bibliotheque/partage` : une chose de l'app ouverte à des personnes, à des groupes ou à toute l'équipe, en lecture ou en modification.
|
|
23
|
+
- `@indos/bibliotheque/theme` : le thème du client, ses polices comprises, et son logo.
|
|
24
|
+
- `@indos/bibliotheque/liens`, `@indos/bibliotheque/deriver` et `@indos/bibliotheque/type-de-fichier` : les liens signés valables dix minutes, les sous-clés de la clé de l'app, et le type d'un fichier qui entre.
|
|
25
|
+
- `@indos/bibliotheque/ecran` : la page simple rendue par le serveur, pour une page introuvable ou une erreur.
|
|
26
|
+
- `@indos/bibliotheque/faux-core` et `@indos/bibliotheque/base-d-essai` : pour les tests, un faux core et une vraie Postgres en mémoire.
|
|
27
|
+
|
|
28
|
+
### Ruptures
|
|
29
|
+
|
|
30
|
+
- Le geste : `"@indos/bibliotheque": "1.0.0"` dans les `dependencies` de l'app, à version exacte, puis `npm install`. L'app ne liste aucune des dépendances de pair : npm les installe aux versions de la bibliothèque.
|
|
31
|
+
- React et React DOM 19.3.1.
|
|
32
|
+
- Vite 8.3.5, avec `@vitejs/plugin-react` 6.1.2.
|
|
33
|
+
- TanStack Router (`@tanstack/react-router`) 1.170.44 et TanStack Query (`@tanstack/react-query`) 5.104.2.
|
|
34
|
+
- Les autres dépendances de pair (Tailwind, Radix, Vitest, Testing Library…), à version exacte elles aussi : `npm view @indos/bibliotheque@1.0.0 peerDependencies`. Une app qui en cite une la cite à cette version.
|
|
35
|
+
- Node 24 ou plus récent.
|
|
36
|
+
- Le core 1.8 ou plus récent, dans ses majeures 1 et 2 : `"core": ">=1.8 <3"` dans `dependances.core` du `module.json` de l'app.
|
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 AVQN
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,9 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @indos/bibliotheque
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
La bibliothèque des apps d'Indos : le serveur HTTP d'une app, son MCP, sa base Postgres et ses migrations, la session du core, et la page de l'espace en React, avec sa coquille, ses composants et sa commande de build, `page-de-l-espace`.
|
|
4
|
+
|
|
5
|
+
Une app du client part du modèle qu'AVQN lui remet, qui cite ce paquet à version exacte. npm installe avec lui React, Vite, TanStack et les outils de test, à ses versions exactes : l'app ne les liste pas. Son image s'installe par `npm ci --omit=dev --omit=peer` et n'a que ce que le serveur lance.
|
|
6
|
+
|
|
7
|
+
Chaque version est décrite dans `CHANGELOG.md` ; une version qui demande un geste dans l'app le dit dans sa rubrique « Ruptures ».
|
|
8
|
+
|
|
9
|
+
Licence MIT : voir `LICENSE`.
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
// La page de l'espace d'une pièce, lancée dans le dossier de la pièce par ses commandes npm
|
|
3
|
+
// (bibliotheque/CLAUDE.md, « Écrire une page »), par le lien de la bibliothèque dans ses
|
|
4
|
+
// `node_modules` (`node node_modules/@indos/bibliotheque/bin/page-de-l-espace.ts <commande>`) :
|
|
5
|
+
// - `construire` (`npm run build`) écrit le dossier construit, `dist/` ;
|
|
6
|
+
// - `developper` (`npm run dev`) la sert à chaud sur http://localhost:5173, reliée au core de
|
|
7
|
+
// `INDOS_CORE` et, pour une app, à l'app lancée en local à `INDOS_APP` ;
|
|
8
|
+
// - `tester` lance ses tests de Vitest, `tests/espace/**/*.test.tsx`.
|
|
9
|
+
import { construireLaPage, developperLaPage, testerLaPage } from '../src/vite.js';
|
|
10
|
+
const [commande] = process.argv.slice(2);
|
|
11
|
+
const dossier = process.cwd();
|
|
12
|
+
if (commande === 'construire') {
|
|
13
|
+
await construireLaPage(dossier);
|
|
14
|
+
}
|
|
15
|
+
else if (commande === 'developper') {
|
|
16
|
+
const core = process.env.INDOS_CORE;
|
|
17
|
+
if (!core) {
|
|
18
|
+
console.error('INDOS_CORE manque : le core auquel relier la page, le banc d\'essai (https://essai-sources.indos.ch) ou un core local.');
|
|
19
|
+
process.exit(1);
|
|
20
|
+
}
|
|
21
|
+
await developperLaPage(dossier, { core, app: process.env.INDOS_APP ?? 'http://localhost:3000' });
|
|
22
|
+
}
|
|
23
|
+
else if (commande === 'tester') {
|
|
24
|
+
await testerLaPage(dossier);
|
|
25
|
+
}
|
|
26
|
+
else {
|
|
27
|
+
console.error('Usage : page-de-l-espace construire | developper | tester');
|
|
28
|
+
process.exit(1);
|
|
29
|
+
}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
-- Le partage des choses de l'app (bibliotheque/CLAUDE.md, « Le partage ») : une ligne ouvre une
|
|
2
|
+
-- chose à une personne (`personne:<id>`), à un groupe (`groupe:<id>`) ou à toute l'équipe
|
|
3
|
+
-- (`equipe`), en lecture ou en modification ; une chose s'ouvre une fois au plus à chacun. Le
|
|
4
|
+
-- partage part avec sa chose. Une ligne qui cite un groupe supprimé n'ouvre plus rien, et reste
|
|
5
|
+
-- jusqu'à ce que le propriétaire de la chose la retire.
|
|
6
|
+
--
|
|
7
|
+
-- Le modèle, que l'app recopie dans sa migration : `chose` y devient le nom de la table de ses
|
|
8
|
+
-- choses (`page`), qui a `id` et `proprietaire`, l'identifiant de la personne à qui elle est.
|
|
9
|
+
create table partage (
|
|
10
|
+
chose uuid not null references chose (id) on delete cascade,
|
|
11
|
+
avec text not null check (avec = 'equipe' or avec ~ '^(personne|groupe):.+$'),
|
|
12
|
+
droit text not null check (droit in ('lecture', 'modification')),
|
|
13
|
+
partage_le timestamptz not null default now(),
|
|
14
|
+
primary key (chose, avec)
|
|
15
|
+
);
|
|
16
|
+
create index partage_par_avec on partage (avec, chose);
|
package/package.json
CHANGED
|
@@ -1,6 +1,119 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@indos/bibliotheque",
|
|
3
|
-
"version": "
|
|
4
|
-
"
|
|
5
|
-
"
|
|
6
|
-
|
|
3
|
+
"version": "1.1.0",
|
|
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
|
+
"license": "MIT",
|
|
6
|
+
"type": "module",
|
|
7
|
+
"engines": {
|
|
8
|
+
"node": ">=24"
|
|
9
|
+
},
|
|
10
|
+
"exports": {
|
|
11
|
+
"./app": {
|
|
12
|
+
"types": "./src/app.d.ts",
|
|
13
|
+
"default": "./src/app.js"
|
|
14
|
+
},
|
|
15
|
+
"./appeler": {
|
|
16
|
+
"types": "./src/appeler.d.ts",
|
|
17
|
+
"default": "./src/appeler.js"
|
|
18
|
+
},
|
|
19
|
+
"./base": {
|
|
20
|
+
"types": "./src/base.d.ts",
|
|
21
|
+
"default": "./src/base.js"
|
|
22
|
+
},
|
|
23
|
+
"./base-d-essai": {
|
|
24
|
+
"types": "./src/base-d-essai.d.ts",
|
|
25
|
+
"default": "./src/base-d-essai.js"
|
|
26
|
+
},
|
|
27
|
+
"./compte": {
|
|
28
|
+
"types": "./src/compte.d.ts",
|
|
29
|
+
"default": "./src/compte.js"
|
|
30
|
+
},
|
|
31
|
+
"./deriver": {
|
|
32
|
+
"types": "./src/deriver.d.ts",
|
|
33
|
+
"default": "./src/deriver.js"
|
|
34
|
+
},
|
|
35
|
+
"./ecran": {
|
|
36
|
+
"types": "./src/ecran.d.ts",
|
|
37
|
+
"default": "./src/ecran.js"
|
|
38
|
+
},
|
|
39
|
+
"./espace": {
|
|
40
|
+
"types": "./src/espace/index.d.ts",
|
|
41
|
+
"default": "./src/espace/index.js"
|
|
42
|
+
},
|
|
43
|
+
"./fichiers": {
|
|
44
|
+
"types": "./src/fichiers.d.ts",
|
|
45
|
+
"default": "./src/fichiers.js"
|
|
46
|
+
},
|
|
47
|
+
"./jeton": {
|
|
48
|
+
"types": "./src/jeton.d.ts",
|
|
49
|
+
"default": "./src/jeton.js"
|
|
50
|
+
},
|
|
51
|
+
"./liens": {
|
|
52
|
+
"types": "./src/liens.d.ts",
|
|
53
|
+
"default": "./src/liens.js"
|
|
54
|
+
},
|
|
55
|
+
"./mcp": {
|
|
56
|
+
"types": "./src/mcp.d.ts",
|
|
57
|
+
"default": "./src/mcp.js"
|
|
58
|
+
},
|
|
59
|
+
"./page": {
|
|
60
|
+
"types": "./src/page.d.ts",
|
|
61
|
+
"default": "./src/page.js"
|
|
62
|
+
},
|
|
63
|
+
"./partage": {
|
|
64
|
+
"types": "./src/partage.d.ts",
|
|
65
|
+
"default": "./src/partage.js"
|
|
66
|
+
},
|
|
67
|
+
"./faux-core": {
|
|
68
|
+
"types": "./src/faux-core.d.ts",
|
|
69
|
+
"default": "./src/faux-core.js"
|
|
70
|
+
},
|
|
71
|
+
"./session": {
|
|
72
|
+
"types": "./src/session.d.ts",
|
|
73
|
+
"default": "./src/session.js"
|
|
74
|
+
},
|
|
75
|
+
"./theme": {
|
|
76
|
+
"types": "./src/theme.d.ts",
|
|
77
|
+
"default": "./src/theme.js"
|
|
78
|
+
},
|
|
79
|
+
"./type-de-fichier": {
|
|
80
|
+
"types": "./src/type-de-fichier.d.ts",
|
|
81
|
+
"default": "./src/type-de-fichier.js"
|
|
82
|
+
},
|
|
83
|
+
"./ui": {
|
|
84
|
+
"types": "./src/ui/index.d.ts",
|
|
85
|
+
"default": "./src/ui/index.js"
|
|
86
|
+
},
|
|
87
|
+
"./ui/theme.css": "./src/ui/theme.css"
|
|
88
|
+
},
|
|
89
|
+
"bin": {
|
|
90
|
+
"page-de-l-espace": "./bin/page-de-l-espace.js"
|
|
91
|
+
},
|
|
92
|
+
"dependencies": {
|
|
93
|
+
"@modelcontextprotocol/node": "2.1.1",
|
|
94
|
+
"@modelcontextprotocol/server": "2.3.1",
|
|
95
|
+
"pg": "8.23.1"
|
|
96
|
+
},
|
|
97
|
+
"peerDependencies": {
|
|
98
|
+
"react": "19.3.1",
|
|
99
|
+
"react-dom": "19.3.1",
|
|
100
|
+
"radix-ui": "1.8.1",
|
|
101
|
+
"tailwind-merge": "3.7.0",
|
|
102
|
+
"tailwindcss": "4.3.3",
|
|
103
|
+
"@tailwindcss/vite": "4.3.3",
|
|
104
|
+
"@vitejs/plugin-react": "6.1.2",
|
|
105
|
+
"vite": "8.3.5",
|
|
106
|
+
"@tanstack/react-router": "1.170.44",
|
|
107
|
+
"@tanstack/react-query": "5.104.2",
|
|
108
|
+
"vitest": "5.0.5",
|
|
109
|
+
"@testing-library/react": "16.3.3",
|
|
110
|
+
"@testing-library/dom": "10.4.2",
|
|
111
|
+
"@testing-library/user-event": "14.6.8",
|
|
112
|
+
"jsdom": "30.1.3",
|
|
113
|
+
"@electric-sql/pglite": "0.5.10",
|
|
114
|
+
"@electric-sql/pglite-socket": "0.2.13",
|
|
115
|
+
"@types/react": "19.3.0",
|
|
116
|
+
"@types/react-dom": "19.3.0",
|
|
117
|
+
"@types/pg": "8.23.1"
|
|
118
|
+
}
|
|
119
|
+
}
|
package/src/app.d.ts
ADDED
package/src/app.js
ADDED
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
import { createServer } from 'node:http';
|
|
2
|
+
// Le serveur HTTP d'une app : GET /sante (et HEAD) répond « ok » pour la sonde de Coolify
|
|
3
|
+
// et de la surveillance ; tout le reste va à l'app.
|
|
4
|
+
export function creerLeServeur(traiter) {
|
|
5
|
+
return createServer((requete, reponse) => {
|
|
6
|
+
const chemin = requete.url?.split('?')[0];
|
|
7
|
+
if ((requete.method === 'GET' || requete.method === 'HEAD') && chemin === '/sante') {
|
|
8
|
+
reponse.writeHead(200, { 'content-type': 'text/plain; charset=utf-8' });
|
|
9
|
+
reponse.end('ok');
|
|
10
|
+
return;
|
|
11
|
+
}
|
|
12
|
+
traiter(requete, reponse);
|
|
13
|
+
});
|
|
14
|
+
}
|
|
15
|
+
// Lance l'app sur PORT (3000 par défaut). En PID 1 dans un conteneur, Node ne traite
|
|
16
|
+
// ni Ctrl+C ni docker stop de lui-même : l'app se ferme sur SIGINT et SIGTERM.
|
|
17
|
+
export function demarrer(nom, traiter) {
|
|
18
|
+
const serveur = creerLeServeur(traiter);
|
|
19
|
+
serveur.listen(Number(process.env.PORT || 3000), () => {
|
|
20
|
+
const { port } = serveur.address();
|
|
21
|
+
console.log(`${nom} écoute sur le port ${port}`);
|
|
22
|
+
});
|
|
23
|
+
function arreter() {
|
|
24
|
+
serveur.close();
|
|
25
|
+
serveur.closeAllConnections();
|
|
26
|
+
}
|
|
27
|
+
process.on('SIGINT', arreter);
|
|
28
|
+
process.on('SIGTERM', arreter);
|
|
29
|
+
return serveur;
|
|
30
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import type { IncomingMessage, ServerResponse } from 'node:http';
|
|
2
|
+
export type TextesDUnAppel = {
|
|
3
|
+
methode: string;
|
|
4
|
+
type: string;
|
|
5
|
+
taille: string;
|
|
6
|
+
objet: string;
|
|
7
|
+
};
|
|
8
|
+
export type ReponseDUnAppel = {
|
|
9
|
+
statut: number;
|
|
10
|
+
corps: unknown;
|
|
11
|
+
};
|
|
12
|
+
export declare function traiterUnAppelDEcran<P>(requete: IncomingMessage, reponse: ServerResponse, options: {
|
|
13
|
+
origine: string;
|
|
14
|
+
personneDe: (requete: IncomingMessage) => Promise<P | 'fermee' | undefined>;
|
|
15
|
+
textes: TextesDUnAppel;
|
|
16
|
+
accepter: (personne: P, corps: Record<string, unknown>) => Promise<ReponseDUnAppel>;
|
|
17
|
+
}): Promise<void>;
|
|
18
|
+
export declare function repondreEnJson(reponse: ServerResponse, statut: number, corps: unknown, entetes?: Record<string, string>): void;
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
// Les règles communes à l'appel d'un écran, celui d'un geste (`traiterUnGesteDEcran`,
|
|
2
|
+
// `@indos/bibliotheque/page`) et celui d'un outil (`POST /outils/<nom>`, `creerLeMcp`). Ce fichier
|
|
3
|
+
// n'est pas une entrée de `exports` : chacun le prend et y ajoute ce qu'il fait de l'appel accepté.
|
|
4
|
+
// Le corps d'un appel d'un écran : 4 Mio au plus.
|
|
5
|
+
const tailleDuCorps = 4 * 1024 * 1024;
|
|
6
|
+
// Les règles, dans l'ordre : `POST` (405) ; l'origine de la page, avant toute question au core
|
|
7
|
+
// (403) ; la personne, que rend `personneDe` (401 sans elle, 403 pour une app fermée, 503 si le core
|
|
8
|
+
// ne répond pas) ; un corps en JSON (415), de 4 Mio au plus (413), un objet (400). Puis `accepter`
|
|
9
|
+
// rend la réponse, que cette fonction écrit. Toute réponse est en JSON, sans cache, jamais lue comme
|
|
10
|
+
// autre chose.
|
|
11
|
+
export async function traiterUnAppelDEcran(requete, reponse, options) {
|
|
12
|
+
if (requete.method !== 'POST') {
|
|
13
|
+
repondreEnJson(reponse, 405, { erreur: options.textes.methode }, { allow: 'POST' });
|
|
14
|
+
return;
|
|
15
|
+
}
|
|
16
|
+
if (requete.headers.origin !== options.origine) {
|
|
17
|
+
repondreEnJson(reponse, 403, { erreur: 'Cet appel ne vient pas d\'une page de l\'app.' });
|
|
18
|
+
return;
|
|
19
|
+
}
|
|
20
|
+
let personne;
|
|
21
|
+
try {
|
|
22
|
+
personne = await options.personneDe(requete);
|
|
23
|
+
}
|
|
24
|
+
catch (erreur) {
|
|
25
|
+
repondreEnJson(reponse, 503, { erreur: `Le core ne répond pas : ${erreur.message}` });
|
|
26
|
+
return;
|
|
27
|
+
}
|
|
28
|
+
if (personne === undefined) {
|
|
29
|
+
repondreEnJson(reponse, 401, { erreur: 'Personne n\'est connecté : se connecter, puis recommencer.' });
|
|
30
|
+
return;
|
|
31
|
+
}
|
|
32
|
+
if (personne === 'fermee') {
|
|
33
|
+
repondreEnJson(reponse, 403, { erreur: 'Cette app ne vous est pas ouverte.' });
|
|
34
|
+
return;
|
|
35
|
+
}
|
|
36
|
+
if (!/^application\/json\s*(;|$)/i.test(requete.headers['content-type'] ?? '')) {
|
|
37
|
+
repondreEnJson(reponse, 415, { erreur: options.textes.type });
|
|
38
|
+
return;
|
|
39
|
+
}
|
|
40
|
+
const brut = await lireLeCorps(requete);
|
|
41
|
+
if (!brut) {
|
|
42
|
+
repondreEnJson(reponse, 413, { erreur: options.textes.taille });
|
|
43
|
+
return;
|
|
44
|
+
}
|
|
45
|
+
let corps;
|
|
46
|
+
try {
|
|
47
|
+
corps = JSON.parse(brut.toString('utf8'));
|
|
48
|
+
}
|
|
49
|
+
catch {
|
|
50
|
+
corps = undefined;
|
|
51
|
+
}
|
|
52
|
+
if (typeof corps !== 'object' || corps === null || Array.isArray(corps)) {
|
|
53
|
+
repondreEnJson(reponse, 400, { erreur: options.textes.objet });
|
|
54
|
+
return;
|
|
55
|
+
}
|
|
56
|
+
const { statut, corps: rendu } = await options.accepter(personne, corps);
|
|
57
|
+
repondreEnJson(reponse, statut, rendu);
|
|
58
|
+
}
|
|
59
|
+
// La réponse à un écran : du JSON, jamais gardé en cache, jamais lu comme autre chose. Un en-tête
|
|
60
|
+
// posé avant par `reponse.setHeader`, comme un cookie, part avec elle.
|
|
61
|
+
export function repondreEnJson(reponse, statut, corps, entetes = {}) {
|
|
62
|
+
reponse.writeHead(statut, {
|
|
63
|
+
'content-type': 'application/json; charset=utf-8',
|
|
64
|
+
'cache-control': 'no-store',
|
|
65
|
+
'x-content-type-options': 'nosniff',
|
|
66
|
+
...entetes,
|
|
67
|
+
});
|
|
68
|
+
reponse.end(JSON.stringify(corps));
|
|
69
|
+
}
|
|
70
|
+
// Le corps d'un appel, ou rien s'il dépasse la taille permise. Au-delà, le reste est lu sans être
|
|
71
|
+
// gardé : le navigateur finit son envoi, puis reçoit la réponse.
|
|
72
|
+
async function lireLeCorps(requete) {
|
|
73
|
+
const morceaux = [];
|
|
74
|
+
let taille = 0;
|
|
75
|
+
for await (const morceau of requete) {
|
|
76
|
+
taille += morceau.length;
|
|
77
|
+
if (taille <= tailleDuCorps) {
|
|
78
|
+
morceaux.push(morceau);
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
return taille <= tailleDuCorps ? Buffer.concat(morceaux) : undefined;
|
|
82
|
+
}
|
package/src/appeler.d.ts
ADDED
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import type { Personne } from './jeton.ts';
|
|
2
|
+
export type ResultatDUnOutil = {
|
|
3
|
+
content: {
|
|
4
|
+
type: string;
|
|
5
|
+
text?: string;
|
|
6
|
+
}[];
|
|
7
|
+
isError?: boolean;
|
|
8
|
+
structuredContent?: Record<string, unknown>;
|
|
9
|
+
_meta?: Record<string, unknown>;
|
|
10
|
+
};
|
|
11
|
+
export declare function estUnRefus(resultat: ResultatDUnOutil): boolean;
|
|
12
|
+
export type Appeler = ReturnType<typeof creerLAppel>;
|
|
13
|
+
export declare function creerLAppel(par: string, adresseDuCore?: string | undefined, cle?: string | undefined): (app: string, outil: string, arguments_: Record<string, unknown>, personne: Personne) => Promise<ResultatDUnOutil>;
|
package/src/appeler.js
ADDED
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
// Vrai si l'outil a refusé (`Refus` de `@indos/bibliotheque/mcp`) : l'accord de la personne
|
|
2
|
+
// manque, elle n'y a pas droit, ou la donnée est refusée. Un refus est un échec ; son texte dit
|
|
3
|
+
// pourquoi.
|
|
4
|
+
export function estUnRefus(resultat) {
|
|
5
|
+
return resultat.isError === true && resultat._meta?.['indos/refus'] === true;
|
|
6
|
+
}
|
|
7
|
+
// L'appel d'une app à l'outil d'une autre, pour une personne, par le core (docs/architecture.md,
|
|
8
|
+
// « Les apps entre elles »). `par` est le nom de l'app qui appelle ; elle déclare dans son
|
|
9
|
+
// module.json les apps qu'elle appelle (`appelle`), et le kit lui passe alors la clé commune des
|
|
10
|
+
// apps dans CLE_D_APPEL. Le résultat est celui de l'outil, refus compris ; une erreur ne vient que
|
|
11
|
+
// d'un appel que le core refuse (clé, personne ou app inconnue) ou qui n'aboutit pas.
|
|
12
|
+
export function creerLAppel(par, adresseDuCore = process.env.CORE_ADRESSE, cle = process.env.CLE_D_APPEL) {
|
|
13
|
+
return async function appeler(app, outil, arguments_, personne) {
|
|
14
|
+
if (!adresseDuCore) {
|
|
15
|
+
throw new Error('La variable CORE_ADRESSE manque : l\'adresse interne du core vient du kit.');
|
|
16
|
+
}
|
|
17
|
+
if (!cle) {
|
|
18
|
+
throw new Error(`La variable CLE_D_APPEL manque : ${par} doit déclarer ${app} dans « appelle » de son module.json.`);
|
|
19
|
+
}
|
|
20
|
+
const reponse = await fetch(new URL('/appeler', adresseDuCore), {
|
|
21
|
+
method: 'POST',
|
|
22
|
+
headers: { authorization: `Bearer ${cle}`, 'content-type': 'application/json' },
|
|
23
|
+
body: JSON.stringify({ par, personne: personne.id, app, outil, arguments: arguments_ }),
|
|
24
|
+
// Le core laisse 60 s pour joindre l'app, puis 60 s à l'outil.
|
|
25
|
+
signal: AbortSignal.timeout(125_000),
|
|
26
|
+
});
|
|
27
|
+
const corps = (await reponse.json().catch(() => ({})));
|
|
28
|
+
if (!reponse.ok) {
|
|
29
|
+
throw new Error(`Le core refuse l'appel de ${app}_${outil} : ${corps.erreur ?? reponse.status}`);
|
|
30
|
+
}
|
|
31
|
+
return corps;
|
|
32
|
+
};
|
|
33
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import { PGlite } from '@electric-sql/pglite';
|
|
2
|
+
import { PGLiteSocketServer } from '@electric-sql/pglite-socket';
|
|
3
|
+
// Une vraie Postgres en mémoire pour les tests, sans service : PGlite, joint par le protocole
|
|
4
|
+
// de Postgres. PGlite n'a qu'une session : la base n'accepte qu'une connexion à la fois, pour
|
|
5
|
+
// que deux transactions ne s'y mêlent jamais sans bruit. Une app s'y branche avec un pool
|
|
6
|
+
// d'une connexion (`ouvrirLaBase(adresse, 1)`).
|
|
7
|
+
export async function ouvrirUneBaseDEssai() {
|
|
8
|
+
const db = await PGlite.create();
|
|
9
|
+
const serveur = new PGLiteSocketServer({ db, host: '127.0.0.1', port: 0, maxConnections: 1 });
|
|
10
|
+
await serveur.start();
|
|
11
|
+
return {
|
|
12
|
+
adresse: `postgres://postgres@${serveur.getServerConn()}/postgres`,
|
|
13
|
+
async fermer() {
|
|
14
|
+
await serveur.stop();
|
|
15
|
+
await db.close();
|
|
16
|
+
},
|
|
17
|
+
};
|
|
18
|
+
}
|
package/src/base.d.ts
ADDED
package/src/base.js
ADDED
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
import { readdir, readFile } from 'node:fs/promises';
|
|
2
|
+
import pg from 'pg';
|
|
3
|
+
// La base d'une app, dans la Postgres commune du serveur : DATABASE_URL vient du kit.
|
|
4
|
+
export function ouvrirLaBase(adresse = process.env.DATABASE_URL, connexions = 5) {
|
|
5
|
+
if (!adresse) {
|
|
6
|
+
throw new Error('La variable DATABASE_URL manque : la base de l\'app vient du kit.');
|
|
7
|
+
}
|
|
8
|
+
const base = new pg.Pool({ connectionString: adresse, max: connexions });
|
|
9
|
+
// Une connexion au repos qui tombe (la Postgres redémarre) est remplacée à la requête
|
|
10
|
+
// suivante ; sans écouteur, son erreur arrêterait l'app.
|
|
11
|
+
base.on('error', (erreur) => console.error(`Connexion à la base perdue : ${erreur.message}`));
|
|
12
|
+
return base;
|
|
13
|
+
}
|
|
14
|
+
// Applique dans l'ordre de leur nom les fichiers .sql du dossier qui ne l'ont pas encore été,
|
|
15
|
+
// chacun dans sa transaction, et rend leurs noms. Un verrou empêche deux démarrages de
|
|
16
|
+
// l'app de les appliquer en même temps.
|
|
17
|
+
export async function appliquerLesMigrations(base, dossier) {
|
|
18
|
+
const fichiers = (await readdir(dossier)).filter((nom) => nom.endsWith('.sql')).sort();
|
|
19
|
+
const client = await base.connect();
|
|
20
|
+
const appliquees = [];
|
|
21
|
+
try {
|
|
22
|
+
await client.query("select pg_advisory_lock(hashtext('migrations'))");
|
|
23
|
+
await client.query('create table if not exists migration (nom text primary key, appliquee_le timestamptz not null default now())');
|
|
24
|
+
const deja = new Set((await client.query('select nom from migration')).rows.map((ligne) => ligne.nom));
|
|
25
|
+
for (const nom of fichiers) {
|
|
26
|
+
if (deja.has(nom)) {
|
|
27
|
+
continue;
|
|
28
|
+
}
|
|
29
|
+
const sql = await readFile(new URL(nom, dossier), 'utf8');
|
|
30
|
+
await client.query('begin');
|
|
31
|
+
try {
|
|
32
|
+
await client.query(sql);
|
|
33
|
+
await client.query('insert into migration (nom) values ($1)', [nom]);
|
|
34
|
+
await client.query('commit');
|
|
35
|
+
}
|
|
36
|
+
catch (erreur) {
|
|
37
|
+
await client.query('rollback');
|
|
38
|
+
throw new Error(`La migration ${nom} a échoué : ${erreur.message}`, { cause: erreur });
|
|
39
|
+
}
|
|
40
|
+
appliquees.push(nom);
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
finally {
|
|
44
|
+
// Une connexion cassée en cours de route ne retourne pas au pool : il en ouvrira une neuve.
|
|
45
|
+
const cassee = await client.query("select pg_advisory_unlock(hashtext('migrations'))").then(() => false, () => true);
|
|
46
|
+
client.release(cassee);
|
|
47
|
+
}
|
|
48
|
+
return appliquees;
|
|
49
|
+
}
|
package/src/compte.d.ts
ADDED
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
import type { IncomingMessage, ServerResponse } from 'node:http';
|
|
2
|
+
import type { EtapeDecrite, FaitDecrit } from './description-des-comptes.ts';
|
|
3
|
+
import type { Personne } from './jeton.ts';
|
|
4
|
+
export declare function chiffrer(cle: Buffer, compte: string, texte: string): string;
|
|
5
|
+
export declare function dechiffrer(cle: Buffer, compte: string, enBase64: string): string;
|
|
6
|
+
export declare function garderLeSecret(cle: Buffer, compte: string, chiffre: string, destination: unknown[], enregistree: unknown[]): string | undefined;
|
|
7
|
+
export type Champ<N extends string = string> = {
|
|
8
|
+
nom: N;
|
|
9
|
+
libelle: string;
|
|
10
|
+
genre?: 'texte' | 'email' | 'nombre' | 'identifiant' | 'secret' | 'paragraphe' | 'case';
|
|
11
|
+
requis?: boolean;
|
|
12
|
+
exemple?: string;
|
|
13
|
+
defaut?: string;
|
|
14
|
+
aide?: string;
|
|
15
|
+
groupe?: string;
|
|
16
|
+
avecLeSuivant?: boolean;
|
|
17
|
+
fixe?: boolean;
|
|
18
|
+
};
|
|
19
|
+
export type Valeurs<N extends string = string> = Record<N, string>;
|
|
20
|
+
export type CompteMontre<N extends string = string> = {
|
|
21
|
+
id: string;
|
|
22
|
+
nom: string;
|
|
23
|
+
detail?: string;
|
|
24
|
+
etats?: {
|
|
25
|
+
texte: string;
|
|
26
|
+
sorte?: 'active' | 'erreur';
|
|
27
|
+
}[];
|
|
28
|
+
valeurs: Partial<Valeurs<N>>;
|
|
29
|
+
lien?: {
|
|
30
|
+
texte: string;
|
|
31
|
+
adresse: string;
|
|
32
|
+
};
|
|
33
|
+
};
|
|
34
|
+
export type OptionsDesGestes<N extends string> = {
|
|
35
|
+
adresse: string;
|
|
36
|
+
adresseDuCore?: string;
|
|
37
|
+
textes: {
|
|
38
|
+
titre: string;
|
|
39
|
+
presentation: (personne: Personne) => string;
|
|
40
|
+
aucun: string;
|
|
41
|
+
brancher: string;
|
|
42
|
+
retirer: string;
|
|
43
|
+
etapes?: EtapeDecrite[];
|
|
44
|
+
suites?: string[];
|
|
45
|
+
faits?: Record<string, FaitDecrit>;
|
|
46
|
+
};
|
|
47
|
+
champs: Champ<N>[];
|
|
48
|
+
comptesDe: (personne: Personne) => Promise<CompteMontre<NoInfer<N>>[]>;
|
|
49
|
+
brancher: (personne: Personne, valeurs: Valeurs<N>) => Promise<string | undefined>;
|
|
50
|
+
modifier: (personne: Personne, id: string, valeurs: Valeurs<N>) => Promise<string | undefined>;
|
|
51
|
+
retirer: (personne: Personne, id: string) => Promise<unknown>;
|
|
52
|
+
};
|
|
53
|
+
export declare function creerLesGestesDesComptes<N extends string>(options: OptionsDesGestes<N>): (requete: IncomingMessage, reponse: ServerResponse, chemin: string) => Promise<boolean>;
|