Référence de caisse

Cette page documente chaque caisse de l'espace de travail bext. Utilisez-le pour trouver où se trouve une fonctionnalité, quels types elle expose et comment les caisses dépendent les unes des autres. Pour la présentation de haut niveau et la matrice des indicateurs de fonctionnalités, voir Présentation de l'architecture.

L'espace de travail contient environ 38 caisses de niveau supérieur plus environ 33 caisses d'implémentation de référence sous crates/bext-impls/. La version des fonctionnalités par défaut relie V8 + le bundle bext - turbopack ; tout le reste est limité aux fonctionnalités, donc une construction minimale reste petite.

Serveur + noyau#

bext -serveur#

Binaire principal — serveur HTTP actix-web, routeur de mascarade, vhost.

Modules clés :

bext -noyau#

Logique partagée sur le serveur, le plug-in NAPI et les outils CLI.

Modules clés :

bext -impls#

Implémentations de traits qui collent le noyau bext à des écosystèmes facultatifs.

Un répertoire de petites caisses d'adaptateurs. Chacun implémente un trait défini dans bext-core ou bext-plugin-api. La version de base ne lie aucun d’entre eux ; Les fonctionnalités de bext-server choisissent celles que vous souhaitez.

Ceux-ci sont délibérément petits. Choisissez ceux dont vous avez besoin ; rien d'autre n'entre en ligne de compte.

bext-licence#

Validation de la clé de licence Ed25519 hors ligne.

Types de clés : LicensePayload, Tier, Feature, validate_key(). Délai de grâce de 14 jours après expiration ; les fonctionnalités du moteur restent actives.

bext-keygen#

Utilitaire de génération de clé de licence (binaire).

Outil interne. Signe les blobs LicensePayload avec la clé privée Ed25519.

PRISM / pipeline-cadre#

bext-turbopack#

API directe autour d'utoo / Turbopack — Bundle JSX/TSX → JS.

Possède les sites d'appel Passe de compilation PRISM. Deux hooks appellent bext-core::transform::prism_compile :

• compile_closure — source d'entrée lors de la compilation à la première demande
• transform_with_analysis_opts — chaque importation transitive traversée par le bundler

Modules : direct (compiler les points d'entrée, l'intégration de transformation, la marche de clôture transitive et le TscRsPipeWorker qui pilote le sous-processus tsc-rs --pipe), prism (configuration du bundle spécifique à PRISM + échafaudage de test d'équivalence d'octets), registry (cache de module compilé), watcher (observateur de fichiers invalidant le registre lors de l'enregistrement).

Le transpile TSX→JS réel est délégué au frontend tsc-rs ; Turbopack gère la résolution des modules, le parcours de fermeture transitive et l'assemblage de paquets. Le flux complet du temps de demande se trouve dans le Pipeline de rendu PRISM.

bext-v8#

Isolat rusty_v8 SSR.

Modules : eval (isolat V8 + thread d'évaluation + caches de contexte chaud, utilisés à la fois par les compatibilités PRISM SSR et Next.js, avec la pompe de rendu en streaming vers la réponse HTTP), subprocess (client de pool de travailleurs hors processus + protocole de cadrage), multiplex (pilote coopératif exécutant N rendus par isolat), render_deadline (chien de garde in-V8 terminate_execution), bridge (pont JS↔Rust + récupération de bouclage), prism_pool (pool de rendu PRISM en cours), pool (pool d'isolement React par site hérité), snapshot (blob d'instantané de démarrage V8).

La topologie complète (configuration du processus, admission et contre-pression, chien de garde et disjoncteur, ainsi que l'autopsie du gel du 10/06/2026) se trouve dans le Piscine de rendu V8. Le même runtime isolé est réutilisé par bext-plugin-v8 pour le sandboxing des plugins. Voir Plugins V8.

bext - react -compilateur#

Intégration du compilateur SWC + React.

Mémorisation automatique (compilateur React) pour les îlots clients et réduction des fonctions pures pour les chemins de code SSR uniquement. S'exécute dans le cadre des transformations source du bundler lorsque le compilateur React est activé dans bext.config.toml.

bext -css#

Moteur v4 Tailwind natif de Rust.

Scanner utilitaire (parcourt les sources PRISM/JSX, extrait les noms de classe) et générateur de classe JIT. La sortie est un CSS de portée route extrait au moment de la construction et servi à partir du cache d’actifs. Aucun binaire de nœud tailwindcss n’est nécessaire.

bext -importation#

Scanner de directives « utiliser le serveur » / « utiliser le client » / « utiliser le cache » compatible AST.

Utilisé par le bundler pour découvrir les limites avant de diviser le graphique en bundles client/serveur. Alimente le chemin de compilation RSC [framework] type = "nextjs" et les îlots PRISM.

bext -proxy#

Sous-système de proxy inverse.

Pools en amont, équilibrage de charge, disjoncteurs, tentatives, proxy gRPC, proxy WebSocket. Extrait de bext-server en 2026-04 pour réduire le temps de reconstruction incrémentiel.

Extensions#

bext -plugin-api#

Définitions de traits et types partagés. Délibérément léger.

Types publics :

Les caisses d'invités WASM peuvent en dépendre sans avoir recours à Actix-Web, V8 ou quoi que ce soit d'autre de lourd.

bext -plugin#

Module complémentaire NAPI pour Bun (mode plugin natif).

Utilisé lorsque bext est invoqué en tant que module natif Node/Bun (la version héritée du « plugin ») au lieu d'en tant que serveur autonome. Expose apply_source_transforms et le pool SSR sur NAPI.

bext -plugin-wasm#

wasmtime sandbox pour les plugins de cycle de vie WASM.

Modules : adapter (pont de traits), host_functions (importations d'hôtes), kv (stockage limité), queue (file d'attente de messages), runtime (gestion des instances wasmtime), sandbox (limitation de débit, application des quotas, liste d'autorisation d'URL).

bext-plugin-v8#

V8 isole le bac à sable pour le plugin JS.

Niveau de plugin de première classe partageant le même moteur V8 que le pipeline SSR utilise (donc pas de temps d'exécution supplémentaire à expédier). Modèle de thread à thread épinglé par isolat, préemption du carburant via le chien de garde, ABI des fonctions JSON sur l'hôte. Voir Plugins V8.

bext -plugin-quickjs#

Bac à sable de l'interprète QuickJS.

Optimisé pour une empreinte réduite et une interprétation déterministe. Modules : api (enregistrement mondial JS — console, bext.storage, bext.fetch, bext.config, bext.metric ), runtime (environnement d'exécution QuickJS avec limites de mémoire, limites de pile et application du délai d'expiration basé sur les interruptions).

bext -plugin-lua#

Exécution du plug-in Lua 5.4.

Pour les auteurs de middleware qui préfèrent Lua. En mode bac à sable via le mode sans échec de mlua et une table de fonctions hôte similaire à la liaison V8.

bext -plugin-nsjail#

Bac à sable au niveau du processus avec IPC JSON-over-stdio.

Modules : config (détection d'interprète depuis shebang/extension), ipc (protocole de ligne JSON avec une longueur de ligne maximale de 10 Mo), runtime (gestion des processus enfants), sandbox (configuration de l'espace de noms Linux lorsqu'il est disponible).

Réseaux + protocoles#

bext -tls#

Fourniture et gestion automatiques des certificats TLS.

Types de clés : AcmeClient (Let's Encrypt / ZeroSSL), SniCertResolver (SNI multidomaine), OcspStapler (agrafage OCSP en arrière-plan), RenewalManager (renouvellement automatique), CertStore ( SQLite -stockage sauvegardé), OnDemandProvisioner (mise à disposition à première demande), MtlsConfig (certificats client TLS mutuels).

bext -temps réel#

Hub de pub/sub SSE et WebSocket.

Types de clés : BextHub (courtier central), TopicAuth (règles d'autorisation par sujet), SseStream, WsSession, RedisRelay (nécessite Fonctionnalité redis).

bext -waf#

Pare-feu d’applications Web .

Types de clés : WafDecision (Autoriser/Bloquer/RateLimit/Challenge), WafRequest, RuleEngine (SQLi/XSS/détection de traversée), IpFilter (listes CIDR), GeoBlocker, BotDetector, DdosGuard, EnhancedRateLimiter, WafAuditLog.

bext -ebpf#

Accélération au niveau du noyau eBPF.

Modules : xdp (filtrage de paquets), tracing_probes (demande d'uprobes en cascade), tcp (intelligence de connexion via sock_ops), seccomp (liste autorisée d'appels système pour les sandbox de plug-in), capability (détection des capacités Linux).

bext -php#

PHP SAPI intégré pour l'exécution PHP en cours de processus.

Types de clés : PhpPool (pool de threads de nœuds de calcul PHP), PhpState (descripteur de niveau supérieur pour AppState).

bext-protocole-mqtt#

Courtier de passerelle MQTT 5.

Routage des sujets, QoS 0/1/2, sessions persistantes, messages conservés. Ponts vers bext-realtime afin que les clients SSE/WebSocket puissent s'abonner au même espace de noms de sujet.

bext -protocole-grpc#

Prise en charge de gRPC propriétaire.

registre de services basé sur tonique, gestion des codecs, transcodage gRPC-Web afin que les navigateurs puissent appeler les mêmes services sans couche proxy.

bext -protocole- caldav#

Prise en charge du protocole CalDAV / CardDAV.

Méthodes WebDAV, iCalendar, vCard. Utile pour les surfaces CRM/calendrier.

Compatibilité nginx#

bext - nginx -compatible#

Analyseur et convertisseur nginx.conf.

Modules : lexer, ast (configuration nginx AST), convert (configuration AST → bext), detect (détection automatique de nginx.conf sur disque). Alimente le « mode mascarade » dans lequel bext remplace nginx sans aucun changement de configuration du côté de l'opérateur.

bext - nginx -cale#

Remplacement binaire nginx.

Imite l'interface de ligne de commande nginx : fichier PID, rechargement SIGHUP, génération de remplacement systemd. Permet à bext de s'asseoir derrière l'existant Flux de travail systemctl reload nginx.

Adaptateurs de framework#

Chaque adaptateur implémente le trait FrameworkAdapter de bext-core. La détection examine les fichiers package.json/config ; créer des shells sur la propre CLI du framework ; serve exécute la sortie produite via bext SSR ou sous la forme d'un ensemble d'actifs statiques.

PRISM est et non un adaptateur de framework - il appartient à bext-core (la passe de compilation) et à bext-turbopack (les sites d'appel). Next.js et Hono sont gérés en ligne dans le pipeline SSR de bext-server plutôt que via un adaptateur de caisse.

Outillage / DX#

bext -dx#

Moteur d’expérience développeur.

Format TOML/lint, plugin/infra/route graph, provenance env, magasin secret. Partagé par la CLI bext et la bext-lsp.

bext -lsp#

Serveur de langue pour bext.config.toml.

Réutilise les règles bext -dx afin que VS Code, Zed, nvim et Helix partagent tous un seul moteur de diagnostic. Complétions, survols, "aller à la définition du plugin".

bext -tui#

Tableau de bord de gestion des terminaux.

Interface utilisateur de déploiement en direct/diffusion de journaux basée sur Ratatui. Utile pour les serveurs sans tête sur lesquels vous souhaitez regarder un déploiement à partir d'un TTY.

bext-banc-historique#

Magasin d’historique des performances.

Base de données d'historique de performances basée sur SQLite, utilisée par le tableau de bord de référence et le détecteur de régression CI. Stocke les numéros de référence par validation (SSR µs/req, TTFB, taille du bundle, etc.) afin que les régressions soient interceptées avant leur expédition.

Faisceaux d'essai#

Vivez sous harnesses/ (la plupart sont également membres de l'espace de travail et partagent donc des artefacts de build) :

Caisses binaires#

Combinaisons d'indicateurs de fonctionnalités#

# Community (free) — minimal build, ~45s cold compile
cargo build --release -p bext-server --no-default-features

# Default — V8 + Turbopack + route-css + react-compiler
cargo build --release -p bext-server

# Pro — security + performance features
cargo build --release -p bext-server \
  --features "waf,h3-quic,redis,otel,plugins,nginx-compat,realtime,websocket-proxy"

# Enterprise — everything
cargo build --release -p bext-server --all-features

# Custom — pick what you need
cargo build --release -p bext-server --features "waf,redis,plugins"

Une construction minimale prend environ 45 secondes sur un MacBook Pro M2. La construction complète de la production avec v8 + turbopack + route-css + react-compiler + nginx-compat + tls + redis + realtime + waf + php + h3-quic prend ~5 minutes à froid et ~30 secondes à chaud. Voir Présentation de l'architecture pour le tableau complet des indicateurs de fonctionnalités.

En rapport#

• Présentation de l'architecture — structure de l'espace de travail, graphique de dépendances et matrice d'indicateurs de fonctionnalités
• Transformer le pipeline — comment bext-core::transform s'intègre dans le chemin de compilation
• Piscine de rendu V8 — Topologie bext-v8 et modèle de résilience du pool
• Frontend TypeScript (tsc-rs) — les caisses tsc-rs consommées par bext-core
• Extensions — comment les caisses sandbox du plug-in ( bext-plugin-* ) sont utilisées
• Contribuer — discipline de superposition et comment ajouter une nouvelle caisse