@indos/bibliotheque 1.11.0 → 1.13.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.
Files changed (44) hide show
  1. package/CHANGELOG.md +36 -0
  2. package/package.json +37 -2
  3. package/src/app.js +7 -12
  4. package/src/direct/page.d.ts +34 -0
  5. package/src/direct/page.js +145 -0
  6. package/src/direct.d.ts +63 -0
  7. package/src/direct.js +411 -0
  8. package/src/espace/choses.d.ts +9 -0
  9. package/src/espace/choses.js +5 -0
  10. package/src/espace/coquille.js +4 -1
  11. package/src/espace/direct.d.ts +5 -0
  12. package/src/espace/direct.js +37 -0
  13. package/src/espace/ecran-d-une-chose.d.ts +4 -1
  14. package/src/espace/ecran-d-une-chose.js +20 -10
  15. package/src/espace/essai.d.ts +37 -0
  16. package/src/espace/essai.js +117 -0
  17. package/src/espace/index.d.ts +5 -2
  18. package/src/espace/index.js +5 -2
  19. package/src/espace/menu-d-une-chose.js +4 -4
  20. package/src/espace/navigation.d.ts +1 -0
  21. package/src/espace/navigation.js +4 -0
  22. package/src/espace/panneau-du-partage.js +3 -3
  23. package/src/faux-core.d.ts +23 -0
  24. package/src/faux-core.js +81 -0
  25. package/src/fichiers-d-une-chose.d.ts +37 -0
  26. package/src/fichiers-d-une-chose.js +136 -0
  27. package/src/forme-du-direct.d.ts +28 -0
  28. package/src/forme-du-direct.js +70 -0
  29. package/src/partage.js +1 -1
  30. package/src/presence.d.ts +8 -0
  31. package/src/presence.js +31 -0
  32. package/src/remplacements.d.ts +26 -0
  33. package/src/remplacements.js +41 -0
  34. package/src/sans-le-chemin.d.ts +1 -0
  35. package/src/sans-le-chemin.js +9 -0
  36. package/src/signaux.d.ts +5 -0
  37. package/src/signaux.js +20 -0
  38. package/src/ui/direct.d.ts +25 -0
  39. package/src/ui/direct.js +91 -0
  40. package/src/ui/etats.d.ts +1 -0
  41. package/src/ui/etats.js +3 -0
  42. package/src/ui/index.d.ts +2 -1
  43. package/src/ui/index.js +2 -1
  44. package/src/vite.js +4 -2
package/CHANGELOG.md CHANGED
@@ -2,6 +2,42 @@
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.13.0
6
+
7
+ - Le direct Yjs, écrit une fois pour toutes les apps où l'on écrit une chose à plusieurs, dans sa propre entrée : `@indos/bibliotheque/direct` pour le serveur, `creerLeDirectYjs`, et `@indos/bibliotheque/direct/page` pour la page, `ouvrirUnDirectYjs`. L'app donne le droit d'une personne sur une chose, sa chose publiée, l'état en base et son écriture ; la bibliothèque fait le contrôle à l'ouverture, sous le domaine comme sur l'hôte public, la taille des messages, le battement, la relecture du droit après un partage, un don ou une suppression, la chose pleine, l'écriture de Claude, la reconnexion et « réessayez ».
8
+ - La présence est écrite par le serveur : chaque onglet porte la personne de sa session, ou le prénom borné d'un invité, et une page ne peut plus prendre le nom d'une autre personne. `personnesDesAutres` en tire les présences d'`EtatEtPresences`, `ongletsDesAutres` chaque onglet avec ce que l'app y met, comme un curseur.
9
+ - Ce qu'une personne tape pendant que le direct se rouvre au droit qui a baissé n'est pas enregistré : la page le sait (`nonEnregistre`) et le dit, « Ce que vous venez d'écrire n'est pas enregistré : ce document ne vous est plus ouvert qu'en lecture. » (`texteDeCeQuiNEstPasEnregistre`). `texteDUnRefusDuDirect` dit un autre refus du direct.
10
+ - yjs, y-protocols et Hocuspocus sont des dépendances de la bibliothèque, à version exacte, en une seule copie dans la page.
11
+ - `@indos/bibliotheque/fichiers-d-une-chose`, `@indos/bibliotheque/remplacements`, `@indos/bibliotheque/signaux` : les fichiers d'une chose, ses remplacements et ses signaux, communs à Pages et Présentations.
12
+ - Une chose hors de la liste de son app, comme un mandat de la facturation, déclare sa liste (`liste`) : le fil dit « Facturation / Mandats / <titre> », et la supprimer ou la donner depuis son écran y ramène.
13
+ - Une app qui déclare plusieurs sortes de choses, comme les factures et les mandats de la facturation, les distingue (`sorte`) : deux choses de sortes différentes et de même identifiant ne se mêlent pas à l'écran.
14
+ - Une panne pendant un formulaire envoyé en `POST` par le navigateur (`Sec-Fetch-Mode: navigate`) rend la page simple, et non une erreur JSON.
15
+ - Les aides des tests d'une app : `servirLApp`, `connecter` et `appeler` dans `@indos/bibliotheque/faux-core` ; la session, le serveur d'essai, la page à l'essai et le test commun des réglages des comptes dans `@indos/bibliotheque/espace-d-essai`.
16
+
17
+ ### Ruptures
18
+
19
+ - `@modelcontextprotocol/client` devient une dépendance de pair, à la version 2.3.1 : une app qui le cite dans ses `devDependencies` le retire, ou le met à cette version ; sinon npm refuse l'installation.
20
+ - Une app qui écrit elle-même en Yjs prend le `yjs` de la bibliothèque, sans en citer un autre.
21
+ - Les versions de React, Vite et TanStack ne changent pas ; `npm view @indos/bibliotheque@1.13.0 peerDependencies` les donne toutes.
22
+ - Pour monter : `"@indos/bibliotheque": "1.13.0"` dans ses `dependencies`, puis `npm install` et `npm run build`.
23
+
24
+ ## 1.12.0
25
+
26
+ - Le direct à l'écran, le même dans toutes les apps où l'on écrit une chose à plusieurs. `EtatEtPresences` (`etat`, `lectureSeule`, `moi`, `autres`) dit l'état en quatre mots, « Connexion… », « En direct » avec le point à l'accent, « Reconnexion… » en gris, et « · Lecture seule », puis une pastille par personne : une seule quel que soit le nombre de ses onglets, la sienne d'abord, même seule, cinq puis « +n », le nom au survol, « (invité) » pour un invité.
27
+ - `DansLEtatDuDirect` pose l'état et les présences en haut à droite de l'écran d'une chose, avant son geste propre, depuis son corps.
28
+ - `@indos/bibliotheque/presence` : `couleurDe(id)`, la couleur d'une personne tirée de son identifiant, la même à la page et au serveur, dans toutes les apps, lisible en clair et en sombre.
29
+ - L'étiquette du nom d'une autre personne, sur son curseur, sa flèche ou sa cellule : `EtiquetteDuNom` en React, `elementDeLEtiquetteDuNom(id, nom)` dans le DOM, la même forme partout.
30
+ - Les gestes du direct : `useAnnoncerLeDroitQuiBaisse(lecture, { une, feminin })` annonce une fois « Ce tableau ne vous est plus ouvert qu'en lecture. » ; `useMontrerLaChoseIntrouvable(app)` montre l'écran commun d'une chose introuvable à la place d'une chose fermée ; `rechargerLaPage()` mène une session fermée à la connexion.
31
+ - `texteDUneChoseAbsente` s'importe aussi de `@indos/bibliotheque/ui`, pour une page hors de l'espace.
32
+ - Supprimer par le ⋯ s'annonce avec le nom de la chose : « Le document « Plan » est supprimé. », sauf quand l'app déclare `motsDeLaSuppression(chose).fait`.
33
+ - Le refus de `donnerLesChoses` pour une personne encore active se lit sans accord de genre : « Rien n'est donné : le compte de Léa (lea@exemple.ch) est encore actif. »
34
+
35
+ ### Ruptures
36
+
37
+ - Aucun geste dans le code de l'app.
38
+ - Les versions de React, Vite et TanStack ne changent pas ; `npm view @indos/bibliotheque@1.12.0 peerDependencies` les donne toutes.
39
+ - Pour monter : `"@indos/bibliotheque": "1.12.0"` dans ses `dependencies`, puis `npm install` et `npm run build`.
40
+
5
41
  ## 1.11.0
6
42
 
7
43
  - 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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@indos/bibliotheque",
3
- "version": "1.11.0",
3
+ "version": "1.13.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",
@@ -40,6 +40,10 @@
40
40
  "types": "./src/espace/index.d.ts",
41
41
  "default": "./src/espace/index.js"
42
42
  },
43
+ "./espace-d-essai": {
44
+ "types": "./src/espace/essai.d.ts",
45
+ "default": "./src/espace/essai.js"
46
+ },
43
47
  "./fichiers": {
44
48
  "types": "./src/fichiers.d.ts",
45
49
  "default": "./src/fichiers.js"
@@ -96,6 +100,30 @@
96
100
  "types": "./src/sans-accents.d.ts",
97
101
  "default": "./src/sans-accents.js"
98
102
  },
103
+ "./presence": {
104
+ "types": "./src/presence.d.ts",
105
+ "default": "./src/presence.js"
106
+ },
107
+ "./fichiers-d-une-chose": {
108
+ "types": "./src/fichiers-d-une-chose.d.ts",
109
+ "default": "./src/fichiers-d-une-chose.js"
110
+ },
111
+ "./remplacements": {
112
+ "types": "./src/remplacements.d.ts",
113
+ "default": "./src/remplacements.js"
114
+ },
115
+ "./signaux": {
116
+ "types": "./src/signaux.d.ts",
117
+ "default": "./src/signaux.js"
118
+ },
119
+ "./direct": {
120
+ "types": "./src/direct.d.ts",
121
+ "default": "./src/direct.js"
122
+ },
123
+ "./direct/page": {
124
+ "types": "./src/direct/page.d.ts",
125
+ "default": "./src/direct/page.js"
126
+ },
99
127
  "./ui": {
100
128
  "types": "./src/ui/index.d.ts",
101
129
  "default": "./src/ui/index.js"
@@ -106,9 +134,15 @@
106
134
  "page-de-l-espace": "./bin/page-de-l-espace.js"
107
135
  },
108
136
  "dependencies": {
137
+ "@hocuspocus/common": "4.7.1",
138
+ "@hocuspocus/provider": "4.7.1",
139
+ "@hocuspocus/server": "4.7.1",
109
140
  "@modelcontextprotocol/node": "2.1.1",
110
141
  "@modelcontextprotocol/server": "2.3.1",
111
- "pg": "8.23.1"
142
+ "pg": "8.23.1",
143
+ "ws": "8.21.3",
144
+ "y-protocols": "1.0.7",
145
+ "yjs": "13.6.32"
112
146
  },
113
147
  "peerDependencies": {
114
148
  "react": "19.3.1",
@@ -128,6 +162,7 @@
128
162
  "jsdom": "30.1.3",
129
163
  "@electric-sql/pglite": "0.5.10",
130
164
  "@electric-sql/pglite-socket": "0.2.13",
165
+ "@modelcontextprotocol/client": "2.3.1",
131
166
  "@types/react": "19.3.0",
132
167
  "@types/react-dom": "19.3.0",
133
168
  "@types/pg": "8.23.1"
package/src/app.js CHANGED
@@ -5,6 +5,7 @@ import { repondreEnJson } from './appel-d-ecran.js';
5
5
  import { appliquerLesMigrations, ouvrirLaBase } from './base.js';
6
6
  import { envoyerLaPage, pageSimple } from './ecran.js';
7
7
  import { fermerLesFlux } from './flux.js';
8
+ import { sansLeChemin } from './sans-le-chemin.js';
8
9
  // Le serveur HTTP d'une app : GET /sante (et HEAD) répond « ok » pour la sonde de Coolify
9
10
  // et de la surveillance ; tout le reste va à l'app.
10
11
  export function creerLeServeur(traiter) {
@@ -108,14 +109,6 @@ function lireLAdresse(nom) {
108
109
  }
109
110
  return adresse;
110
111
  }
111
- // L'adresse d'une requête sans le chemin de l'app, sa recherche gardée ; telle quelle sans lui.
112
- function sansLeChemin(url, prefixe) {
113
- const { pathname, search } = new URL(url, 'http://app');
114
- if (pathname !== prefixe && !pathname.startsWith(`${prefixe}/`)) {
115
- return url;
116
- }
117
- return `${pathname.slice(prefixe.length) || '/'}${search}`;
118
- }
119
112
  // Sert une requête et attrape l'erreur du traitement, écrite au journal avec sa pile : la page
120
113
  // simple à une navigation, une erreur JSON à un appel (un outil, un geste d'écran, une lecture de
121
114
  // la page), rien de plus sur une réponse commencée, dont la connexion se coupe.
@@ -139,10 +132,12 @@ async function servir(traitement, requete, reponse) {
139
132
  }
140
133
  }
141
134
  }
142
- // Une navigation : le navigateur charge une page, et non un appel de script.
135
+ // Une navigation : le navigateur charge une page, et non un appel de script. `Sec-Fetch-Mode:
136
+ // navigate` en est une quelle que soit la méthode, comme l'envoi d'un formulaire ; sans lui, un `GET`
137
+ // ou un `HEAD` qui demande du HTML.
143
138
  function estUneNavigation(requete) {
144
- if (requete.method !== 'GET' && requete.method !== 'HEAD') {
145
- return false;
139
+ if (requete.headers['sec-fetch-mode'] === 'navigate') {
140
+ return true;
146
141
  }
147
- return requete.headers['sec-fetch-mode'] === 'navigate' || (requete.headers.accept ?? '').includes('text/html');
142
+ return (requete.method === 'GET' || requete.method === 'HEAD') && (requete.headers.accept ?? '').includes('text/html');
148
143
  }
@@ -0,0 +1,34 @@
1
+ import { HocuspocusProvider } from '@hocuspocus/provider';
2
+ import * as Y from 'yjs';
3
+ import { type Invite } from '../forme-du-direct.ts';
4
+ import type { EtatDeLaConnexion } from '../ui/direct.tsx';
5
+ export { codes, estUneChoseAbsente, ongletsDesAutres, personneDeLEtat, personnesDesAutres, raisons, type Invite, type OngletPresent, } from '../forme-du-direct.ts';
6
+ export type EtatDuDirect = {
7
+ sorte: EtatDeLaConnexion;
8
+ } | {
9
+ sorte: 'ferme';
10
+ raison: string;
11
+ };
12
+ export type QuandLeDirect = {
13
+ etat: (etat: EtatDuDirect) => void;
14
+ lectureSeule: (oui: boolean) => void;
15
+ plein: () => void;
16
+ pret?: () => void;
17
+ nonEnregistre?: () => void;
18
+ };
19
+ export type DirectDeLaPage = {
20
+ document: Y.Doc;
21
+ provider: HocuspocusProvider;
22
+ presence: NonNullable<HocuspocusProvider['awareness']>;
23
+ fermer: () => void;
24
+ };
25
+ export type OptionsDuDirect = {
26
+ base: string;
27
+ chose: string;
28
+ invite?: Invite;
29
+ quand: QuandLeDirect;
30
+ };
31
+ export declare const reouvertureSilencieuse = 5000;
32
+ export declare const delaiAvantDeReessayer = 2000;
33
+ export declare function adresseDuDirect(base: string, chose: string): string;
34
+ export declare function ouvrirUnDirectYjs({ base, chose, invite, quand }: OptionsDuDirect): DirectDeLaPage;
@@ -0,0 +1,145 @@
1
+ import { HocuspocusProvider, HocuspocusProviderWebsocket } from '@hocuspocus/provider';
2
+ import * as Y from 'yjs';
3
+ import { cheminDuDirect, codes, raisons } from '../forme-du-direct.js';
4
+ // @indos/bibliotheque/direct/page : le direct Yjs d'une chose, côté page (bibliotheque/CLAUDE.md,
5
+ // « Le direct Yjs ») : le document Yjs, relayé par Hocuspocus sur un WebSocket, de la même origine
6
+ // que la page, et sa présence, où le serveur écrit la personne de chaque onglet. L'app écrit dans le
7
+ // document sous sa propre origine, que son historique (⌘Z) suit seule : il ne défait jamais ce qu'un
8
+ // autre, ou Claude, a écrit.
9
+ export { codes, estUneChoseAbsente, ongletsDesAutres, personneDeLEtat, personnesDesAutres, raisons, } from '../forme-du-direct.js';
10
+ // Le temps que se rouvre une connexion coupée pour un droit qui a changé, sans « Reconnexion… ».
11
+ export const reouvertureSilencieuse = 5000;
12
+ // Le temps avant de réessayer après « réessayez ».
13
+ export const delaiAvantDeReessayer = 2000;
14
+ // Le type d'un message de Hocuspocus qui dit si le serveur a pris une écriture de la page.
15
+ const etatDeLaSynchronisation = 8;
16
+ // L'adresse du direct d'une chose, de la même origine que la page : `ws(s)://<hôte><base>/direct/<id>`,
17
+ // `base` avec ou sans sa barre finale (`/documents` ou `/documents/`).
18
+ export function adresseDuDirect(base, chose) {
19
+ const adresse = new URL(`${base.replace(/\/+$/, '')}/${cheminDuDirect}/${chose}`, globalThis.location.href);
20
+ adresse.protocol = adresse.protocol === 'https:' ? 'wss:' : 'ws:';
21
+ return adresse.href;
22
+ }
23
+ // Ouvre le direct d'une chose. Il se reconnecte seul, d'une demi-seconde à huit secondes d'attente.
24
+ // Le serveur coupe une connexion dont le droit a changé (4205), que la page rouvre aussitôt, en
25
+ // restant « en direct » : la personne voit le nouveau droit, pas la reconnexion, sauf si elle dure
26
+ // plus de cinq secondes. Une connexion sans droit (4403) est fermée pour de bon, avec sa raison. Le
27
+ // refus « réessayez » (le core ou la base ne répondent pas) se réessaie après deux secondes ; tout
28
+ // autre refus ferme le direct. `{"plein":true}`, du serveur, dit la chose pleine.
29
+ export function ouvrirUnDirectYjs({ base, chose, invite, quand }) {
30
+ const document = new Y.Doc();
31
+ let ferme = false;
32
+ let dejaPret = false;
33
+ let plein = false;
34
+ let nonEnregistreDit = false;
35
+ let relance;
36
+ let reouverture;
37
+ function finirLaReouverture() {
38
+ clearTimeout(reouverture);
39
+ reouverture = undefined;
40
+ }
41
+ function fermerPourDeBon(raison) {
42
+ ferme = true;
43
+ clearTimeout(relance);
44
+ finirLaReouverture();
45
+ prise.disconnect();
46
+ quand.etat({ sorte: 'ferme', raison });
47
+ }
48
+ const prise = new HocuspocusProviderWebsocket({
49
+ url: adresseDuDirect(base, chose),
50
+ minDelay: 500,
51
+ maxDelay: 8000,
52
+ onClose: ({ event }) => {
53
+ if (event.code === codes.plusDeDroit) {
54
+ fermerPourDeBon(event.reason || raisons.introuvable);
55
+ }
56
+ else if (event.code === codes.droitChange && !ferme) {
57
+ finirLaReouverture();
58
+ reouverture = setTimeout(() => {
59
+ reouverture = undefined;
60
+ if (!ferme) {
61
+ quand.etat({ sorte: 'reconnexion' });
62
+ }
63
+ }, reouvertureSilencieuse);
64
+ }
65
+ },
66
+ });
67
+ const provider = new HocuspocusProvider({
68
+ websocketProvider: prise,
69
+ name: chose,
70
+ document,
71
+ ...(invite ? { token: JSON.stringify({ id: invite.id, prenom: invite.prenom }) } : {}),
72
+ onStatus: ({ status }) => {
73
+ if (!ferme && !reouverture && status !== 'connected') {
74
+ quand.etat({ sorte: 'reconnexion' });
75
+ }
76
+ },
77
+ onAuthenticated: ({ scope }) => quand.lectureSeule(scope === 'readonly'),
78
+ onAuthenticationFailed: ({ reason }) => {
79
+ finirLaReouverture();
80
+ if (reason === raisons.reessayez) {
81
+ quand.etat({ sorte: 'reconnexion' });
82
+ prise.disconnect();
83
+ clearTimeout(relance);
84
+ relance = setTimeout(() => {
85
+ if (!ferme) {
86
+ void prise.connect();
87
+ }
88
+ }, delaiAvantDeReessayer);
89
+ return;
90
+ }
91
+ fermerPourDeBon(reason);
92
+ },
93
+ onSynced: ({ state }) => {
94
+ if (state && !ferme) {
95
+ finirLaReouverture();
96
+ quand.etat({ sorte: 'en-direct' });
97
+ if (!dejaPret) {
98
+ dejaPret = true;
99
+ quand.pret?.();
100
+ }
101
+ }
102
+ },
103
+ onStateless: ({ payload }) => {
104
+ try {
105
+ if (JSON.parse(payload).plein === true) {
106
+ plein = true;
107
+ quand.plein();
108
+ }
109
+ }
110
+ catch {
111
+ // Un message sans état qui n'est pas du JSON ne dit rien à la page.
112
+ }
113
+ },
114
+ // Le serveur refuse ce que la page a écrit quand la connexion est en lecture seule : ce qu'elle
115
+ // a écrit pendant que la connexion se rouvrait au droit qui a baissé. Une chose pleine le dit
116
+ // déjà par son message.
117
+ onMessage: ({ message }) => {
118
+ try {
119
+ message.readVarString();
120
+ if (message.readVarUint() === etatDeLaSynchronisation && message.readVarUint() === 0 && !plein && !nonEnregistreDit) {
121
+ nonEnregistreDit = true;
122
+ quand.nonEnregistre?.();
123
+ }
124
+ }
125
+ catch {
126
+ // Un message qui ne se lit pas ne dit rien à la page.
127
+ }
128
+ },
129
+ });
130
+ provider.attach();
131
+ quand.etat({ sorte: 'connexion' });
132
+ return {
133
+ document,
134
+ provider,
135
+ presence: provider.awareness,
136
+ fermer() {
137
+ ferme = true;
138
+ clearTimeout(relance);
139
+ finirLaReouverture();
140
+ provider.destroy();
141
+ prise.destroy();
142
+ document.destroy();
143
+ },
144
+ };
145
+ }
@@ -0,0 +1,63 @@
1
+ import type { IncomingMessage, Server } from 'node:http';
2
+ import { Hocuspocus } from '@hocuspocus/server';
3
+ import { type WebSocket } from 'ws';
4
+ import * as Y from 'yjs';
5
+ import { type DroitSurLaChose } from './partage.ts';
6
+ import { type PersonnePresente } from './presence.ts';
7
+ import type { PersonneConnectee } from './session.ts';
8
+ export { cheminDuDirect, codes, raisons, type Invite } from './forme-du-direct.ts';
9
+ export declare const tailleMaximaleDUnMessage: number;
10
+ export declare const delaiDeRelecture: number;
11
+ export type DroitDuDirect = 'modification' | 'lecture';
12
+ type Entree = {
13
+ chose: string;
14
+ publique: boolean;
15
+ origine?: string;
16
+ cookie?: string;
17
+ };
18
+ type Contexte = {
19
+ entree?: Entree;
20
+ socket?: WebSocket;
21
+ droit?: DroitDuDirect;
22
+ personne?: PersonnePresente;
23
+ };
24
+ export type ReglagesDuDirectYjs = {
25
+ adresse: string;
26
+ adressePublique?: string;
27
+ session: {
28
+ personneDuGeste(requete: IncomingMessage): Promise<PersonneConnectee | 'fermee' | undefined>;
29
+ };
30
+ droitDe(personne: PersonneConnectee, chose: string): Promise<DroitSurLaChose | undefined>;
31
+ estPubliee?(chose: string): Promise<boolean>;
32
+ charger(chose: string): Promise<Uint8Array | undefined>;
33
+ enregistrer(chose: string, etat: Uint8Array, document: Y.Doc): Promise<void>;
34
+ limite: number;
35
+ textes: {
36
+ plein: string;
37
+ absente(chose: string): string;
38
+ };
39
+ apresLaFermeture?(chose: string): Promise<void>;
40
+ quandLesPresentsChangent?(chose: string, presents: PersonnePresente[]): Promise<void> | void;
41
+ delais?: {
42
+ debounce?: number;
43
+ maxDebounce?: number;
44
+ };
45
+ };
46
+ export declare function creerLeDirectYjs(reglages: ReglagesDuDirectYjs): {
47
+ hocuspocus: Hocuspocus<Contexte>;
48
+ relire: (...choses: string[]) => Promise<void>;
49
+ accueillir(serveur: Server): void;
50
+ lire(chose: string): Promise<Y.Doc | undefined>;
51
+ ecrire<T>(chose: string, geste: (document: Y.Doc) => T, options?: {
52
+ avant?: () => Promise<void>;
53
+ garder?: (etat: Uint8Array) => Promise<() => Promise<void>>;
54
+ }): Promise<T>;
55
+ estPleine: (chose: string) => boolean;
56
+ estOuverte: (chose: string) => boolean;
57
+ presences(): {
58
+ chose: string;
59
+ presents: PersonnePresente[];
60
+ }[];
61
+ fermer(): Promise<void>;
62
+ };
63
+ export type DirectYjs = ReturnType<typeof creerLeDirectYjs>;