@indos/bibliotheque 1.12.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.
- package/CHANGELOG.md +19 -0
- package/package.json +33 -2
- package/src/app.js +7 -12
- package/src/direct/page.d.ts +34 -0
- package/src/direct/page.js +145 -0
- package/src/direct.d.ts +63 -0
- package/src/direct.js +411 -0
- package/src/espace/choses.d.ts +9 -0
- package/src/espace/choses.js +5 -0
- package/src/espace/coquille.js +4 -1
- package/src/espace/ecran-d-une-chose.js +3 -3
- package/src/espace/essai.d.ts +37 -0
- package/src/espace/essai.js +117 -0
- package/src/espace/index.d.ts +1 -1
- package/src/espace/index.js +1 -1
- package/src/espace/menu-d-une-chose.js +3 -3
- package/src/espace/panneau-du-partage.js +3 -3
- package/src/faux-core.d.ts +23 -0
- package/src/faux-core.js +81 -0
- package/src/fichiers-d-une-chose.d.ts +37 -0
- package/src/fichiers-d-une-chose.js +136 -0
- package/src/forme-du-direct.d.ts +28 -0
- package/src/forme-du-direct.js +70 -0
- package/src/presence.d.ts +6 -0
- package/src/presence.js +6 -3
- package/src/remplacements.d.ts +26 -0
- package/src/remplacements.js +41 -0
- package/src/sans-le-chemin.d.ts +1 -0
- package/src/sans-le-chemin.js +9 -0
- package/src/signaux.d.ts +5 -0
- package/src/signaux.js +20 -0
- package/src/ui/direct.d.ts +4 -5
- package/src/ui/direct.js +24 -2
- package/src/ui/index.d.ts +1 -1
- package/src/ui/index.js +1 -1
- package/src/vite.js +4 -2
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,25 @@
|
|
|
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
|
+
|
|
5
24
|
## 1.12.0
|
|
6
25
|
|
|
7
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é.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@indos/bibliotheque",
|
|
3
|
-
"version": "1.
|
|
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"
|
|
@@ -100,6 +104,26 @@
|
|
|
100
104
|
"types": "./src/presence.d.ts",
|
|
101
105
|
"default": "./src/presence.js"
|
|
102
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
|
+
},
|
|
103
127
|
"./ui": {
|
|
104
128
|
"types": "./src/ui/index.d.ts",
|
|
105
129
|
"default": "./src/ui/index.js"
|
|
@@ -110,9 +134,15 @@
|
|
|
110
134
|
"page-de-l-espace": "./bin/page-de-l-espace.js"
|
|
111
135
|
},
|
|
112
136
|
"dependencies": {
|
|
137
|
+
"@hocuspocus/common": "4.7.1",
|
|
138
|
+
"@hocuspocus/provider": "4.7.1",
|
|
139
|
+
"@hocuspocus/server": "4.7.1",
|
|
113
140
|
"@modelcontextprotocol/node": "2.1.1",
|
|
114
141
|
"@modelcontextprotocol/server": "2.3.1",
|
|
115
|
-
"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"
|
|
116
146
|
},
|
|
117
147
|
"peerDependencies": {
|
|
118
148
|
"react": "19.3.1",
|
|
@@ -132,6 +162,7 @@
|
|
|
132
162
|
"jsdom": "30.1.3",
|
|
133
163
|
"@electric-sql/pglite": "0.5.10",
|
|
134
164
|
"@electric-sql/pglite-socket": "0.2.13",
|
|
165
|
+
"@modelcontextprotocol/client": "2.3.1",
|
|
135
166
|
"@types/react": "19.3.0",
|
|
136
167
|
"@types/react-dom": "19.3.0",
|
|
137
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.
|
|
145
|
-
return
|
|
139
|
+
if (requete.headers['sec-fetch-mode'] === 'navigate') {
|
|
140
|
+
return true;
|
|
146
141
|
}
|
|
147
|
-
return requete.
|
|
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
|
+
}
|
package/src/direct.d.ts
ADDED
|
@@ -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>;
|