elsy

Build once. Deploy anywhere.

Elsy (anciennement "Runtime Presets") est un moteur de génération de presets permettant d'exécuter une même application sur plusieurs plateformes (Node.js, Netlify, Cloudflare, AWS, Azure, Bun, Deno...) à partir d'un contrat unique basé sur le Fetch API.

interface Application {
  fetch(request: Request, ctx?: RuntimeContext): Promise<Response>;
}

Voir docs/ARCHITECTURE.md pour le détail de RuntimeContext.

• Runtime indépendant des plateformes.
• Presets déclaratifs.
• Adapters dédiés à la conversion des objets natifs.
• Builder générique.
• Basé sur les standards WinterCG.

• docs/GLOSSARY.md
• docs/ARCHITECTURE.md
• docs/ROADMAP.md
• CONTRIBUTING.md

Prérequis : Node.js ≥ 18, un compte Netlify, Netlify CLI.

corepack enable
pnpm install --frozen-lockfile
pnpm -r run build
pnpm run generate:netlify   # écrit netlify/functions/server.mjs à partir de @elsy/preset-netlify

generate:netlify exécute @elsy/builder sur netlifyPreset (packages/presets/netlify) — voir scripts/generate-netlify-function.mjs. Le fichier généré n'est pas versionné (.gitignore) : netlify.toml régénère cet artefact à chaque build, sur Netlify comme en local.

En local, avec l'émulateur Netlify réel (pas le nôtre) :

netlify dev
curl http://localhost:8888/.netlify/functions/server
# → Hello World

Déploiement réel :

netlify login
netlify link      # ou `netlify init` pour créer un nouveau site
netlify deploy --prod
curl https://<votre-site>.netlify.app/.netlify/functions/server
# → Hello World

netlify.toml redirige aussi /* vers la function : https://<votre-site>.netlify.app/ répond directement Hello World (l'Application actuelle n'a pas encore de routeur — voir packages/runtime/src/runtime.ts — donc / ou toute autre URL du site donnent la même réponse pour l'instant).

Ceci referme le point resté ouvert en Phase 4 (ROADMAP.md) : jusqu'ici, seuls les contract tests contre un émulateur HTTP local avaient validé l'adapter Netlify — pas l'infrastructure Netlify réelle.