@mostajs/http-pont

Auteur : Dr Hamid MADANI [email protected] Licence : AGPL-3.0-or-later · Niveau : N0 · Dépendances : aucune

Le pont node:http ⇄ Fetch. Il convertit un IncomingMessage en Request, et rend une Response dans un ServerResponse. Rien d'autre.

Pourquoi

De plus en plus de modules livrent des gestionnaires au standard du web : ils reçoivent une Request, ils rendent une Response. createUsageHandlers de subscriptions-plan, createApiKeyHandlers d'api-keys, le catch-all de @mostajs/socle. C'est la bonne forme : elle ne suppose aucun cadre.

Un serveur node:http n'a pas ça. Entre les deux il faut un pont — et jusqu'ici chacun l'a rebâti chez soi, avec une leçon que les autres n'avaient pas :

| copie | ce qu'elle savait | ce qu'elle ignorait | |---|---|---| | @mostajs/net, server.ts:827 | — | jetait tous les en-têtes ; méthode clouée à POST ; origine http://internal mensongère | | @mostajs/auth-lite, readForm | reprendre un req.body déjà lu | req.destroy() tuait la connexion avant le 413 | | mdseal, readBody | pause, jamais destroy | ignorait le corps déjà lu par un cadre |

Trois copies, trois leçons, chacune dans une seule copie : c'est le seuil de la règle R-G (extraire à la couche légale la plus basse). Ce module est cette couche, et ses essais gardent les trois leçons à la fois.

Emploi

import http from 'node:http';
import { servir } from '@mostajs/http-pont';

// Un gestionnaire web-standard — le vôtre, ou celui d'un module.
const gestionnaire = async (requete) => Response.json({ chemin: new URL(requete.url).pathname });

http.createServer(servir(gestionnaire, { maxOctets: 5 * 1024 * 1024 })).listen(7850);

Les pièces séparément :

import { baseDe, lireCorps, lireFormulaire, requeteDepuis, repondreVers } from '@mostajs/http-pont';

const origine = baseDe(req);                            // https://mdseal.dev — X-Forwarded-* honorés
const corps   = await lireCorps(req, { maxOctets });    // Buffer, ou erreur 413 PAYLOAD_TOO_LARGE
const champs  = await lireFormulaire(req);              // urlencoded → objet ; reprend req.body si déjà lu
const requete = await requeteDepuis(req);               // Request — TOUS les en-têtes traversent
await repondreVers(res, new Response('ok'));            // plusieurs Set-Cookie restent plusieurs

Ce qu'il ne fera jamais

Ni .env, ni session, ni cookie de connexion, ni routage, ni vocabulaire d'erreur. Un N0 dont la base doit être N0 (DEVRULES §5.bis.1) n'a aucune dépendance : seulement node:. Le jour où ce module lit une variable d'environnement, il a recommencé à être un module d'assemblage, et la restructuration qui l'a fait naître est perdue.

| ce qu'il ne fait pas | qui le fait | |---|---| | choisir quel module doit traiter un appel | @mostajs/socle | | nommer les erreurs et envelopper un résultat | @mostajs/transport-kit | | emballer une fonction métier en gestionnaire | @mostajs/service-kit | | lire les réglages de l'environnement | @mostajs/config | | authentifier, ouvrir une session, poser un cookie | @mostajs/auth-lite, @mostajs/auth-plug |

Limite assumée

Le corps est lu en mémoire, borné, avant d'être remis. new Request n'accepte un flux Node qu'au prix d'un duplex: 'half' que tous les gestionnaires ne supportent pas, et un plafond qui n'est pas appliqué à la lecture ne protège de rien. Pour un téléversement de plusieurs gigaoctets, on reste sur le flux nu — ce pont n'est pas fait pour ça.

Essais

npm test        # 13 essais, chacun nommant le défaut réel qu'il empêche de revenir