Bun

InstallationCopier le lien de la section

bun add @zarex/bun

ZAREX_KEY=zarex_test_...

Protéger le serveurCopier le lien de la section

import { zarexBun, shield, rateLimit } from "@zarex/bun";

const wrap = zarexBun({
  key: process.env.ZAREX_KEY!,
  ipSource: "socket",
  rules: [shield(), rateLimit({ max: 100, window: "1m" })],
});

Bun.serve({
  fetch: wrap(async (request) => new Response("ok")),
});

zarexBun(...) renvoie une fonction qui enveloppe votre gestionnaire fetch. Une requête refusée reçoit automatiquement 403, ou 429 avec retry-after.

L'adresse IP du visiteurCopier le lien de la section

Bun donne l'adresse de la connexion : toutes les valeurs d'ipSource fonctionnent.

Sur Vercel et Fly.io, ipSource peut être omis. Ailleurs, l'application refuse de démarrer sans lui.

Identifiants et données de formulaireCopier le lien de la section

const wrap = zarexBun({
  key: process.env.ZAREX_KEY!,
  ipSource: "socket",
  rules: [rateLimit({ max: 100, window: "1m", characteristics: ["userId"] })],
  call: (request) => ({
    characteristics: { userId: request.headers.get("x-user-id") ?? undefined },
  }),
});

call peut aussi fournir email, phone, text et tokensRequested. Les identifiants sont hachés (SHA-256) avant l'envoi.

Personnaliser le refusCopier le lien de la section

zarexBun({
  key: process.env.ZAREX_KEY!,
  ipSource: "socket",
  rules: [shield()],
  onDeny: (request, decision) =>
    Response.json({ erreur: "Requête refusée", id: decision.id }, { status: 403 }),
});

onDeny et onDegraded reçoivent la décision complète. Pour la lire à chaque requête, utilisez createZarex et protect (voir la référence).

En-têtes de sécurité et réponsesCopier le lien de la section

secureHeaders: true et responseGuard: true s'appliquent automatiquement à toutes les réponses de votre gestionnaire.