Astro 7.0: miglioramenti per prestazioni e controllo sulla pipeline

Astro 7.0 è un aggiornamento che non si limita a rifinire le funzionalità esistenti, stravolge l'architettura interna del framework riscrivendone le componenti core in Rust e introduce alcune nuove feature cruciali per la gestione avanzata del routing, del caching e dell'integrazione con gli Agenti AI.

Per i team di sviluppo, Astro 7.0 porta con sé una drastica riduzione dei tempi di build, fino al 61% in meno, e strumenti integrati con cui gestire logiche enterprise direttamente nel framework.

Il passaggio a Rust

La novità più interessante di Astro 7.0 riguarda la velocità di compilazione e generazione. L'intera pipeline è stata migrata verso codice nativo ed è disponibile il nuovo compilatore .astro

Il precedente compilatore, basato su Go, è stato completamente riscritto in Rust sfruttando oxc per il parsing e Lightning CSS per lo scoping degli stili. Questa modifica all'architettura di base porta con sé alcune conseguenze importanti sul comportamento del markup:

• nessuna correzione automatica dell'HTML: il vecchio compilatore modificava silenziosamente il markup non valido, ad esempio spostando nodi o auto-chiudendo tag, dando spesso origine ad alcuni bug difficili da tracciare. Il nuovo compilatore tratta il codice così com'è
• Stile JSX: tag non chiusi o attributi malformati generano ora errori bloccanti in fase di compilazione.
• Gestione degli spazi bianchi: gli spazi e i ritorni a capo tra elementi inline vengono contratti secondo le convenzioni React. Per mantenere uno spazio esplicito tra due tag è necessario usare l'espressione {' '}.

Markdown e MDX con Sätteri

La gestione di Markdown e MDX abbandona la vecchia pipeline basata su unified con remark/rehype, spesso collo di bottiglia nei siti ad alta densità di contenuti. Il nuovo processore predefinito si chiama Sätteri, è scritto naturalmente in Rust e integra funzionalità che prima richiedevano plugin esterni come GFM, tabelle, formule matematiche in Math, ID degli heading e frontmatter.

Se un progetto dipende strettamente da plugin remark/rehype custom è comunque possibile riattivare la vecchia pipeline tramite il pacchetto @astrojs/markdown-remark.

Queued Rendering, aggiornamento a Vite 8 e Rolldown in Astro 7

Diventa stabile il nuovo motore di rendering basato su code (stack) anziché su funzioni ricorsive. Esso riduce l'impronta di memoria e velocizza la generazione delle pagine di circa 2.4 volte rispetto al passato.

Astro 7 adotta Vite 8 che introduce come novità assoluta Rolldown, il bundler scritto in Rust destinato a sostituire sia esbuild che Rollup. Rolldown supporta le stesse API dei plugin di Rollup e Vite. Astro 7 include poi un layer di compatibilità che converte automaticamente le opzioni rollupOptions ed esbuild esistenti.

Per la maggior parte dei progetti il passaggio avviene senza configurazione e risulterà molto probabilmente indolore.

Advanced Routing: controllo della request pipeline

Fino ad oggi gestire delle logiche middleware complesse, come per esempio eseguire l'autenticazione prima delle Astro Actions o tracciare i tempi di risposta solo per il rendering delle pagine, richiedeva dei workaround.

Astro 7 introduce l'Advanced Routing tramite l'entry point src/fetch.ts. Questo file esporta un handler fetch standard in stile Cloudflare Workers o Bun che intercetta qualsiasi richiesta prima che entri nel ciclo di vita di Astro.

L'architettura è compatibile con Hono e permette di strutturare la pipeline con middleware di terze parti e moduli Astro:

import { Hono } from 'hono';
import { actions, middleware, pages, i18n } from 'astro/hono';
import { auth } from './middleware/auth';
import { timing } from './middleware/timing';

const app = new Hono();
app.use(i18n());
app.use(auth());
app.use(actions());
app.use(middleware());
app.use(timing());
app.use(pages());

export default app;

Route Caching e supporto CDN in Astro 7

Gestire il caching delle pagine renderizzate on-demand è sempre stato complesso a causa delle differenze tra i vari provider cloud. Astro 7 stabilizza le API di Route Caching in quanto mette a disposizione un'interfaccia agnostica basata sulle semantiche HTTP.

Si possono quindi configurare le regole centralmente, cioè nel file di configurazione, o gestirle dinamicamente a livello di singola pagina tramite l'oggetto Astro.cache:

// src/pages/products/[id].astro
Astro.cache.set({
  maxAge: 120, // Cache di 2 minuti
  swr: 60,     // Stale-while-revalidate per 1 minuto
  tags: ['products'], // Tag per invalidazione mirata
});

Con cache.invalidate({ tags: [...] }), o cache.invalidate({ path: '...' }), è possibile creare endpoint webhook per un CMS in modo da svuotare la cache istantaneamente senza dover rieseguire la build dell'applicazione.

Oltre al provider in-memory, Astro 7 offre dei provider nativi per Netlify, Vercel e Cloudflare ma in private beta. La loro funzione è quella di tradurre le direttive di Astro in header HTTP proprietari della CDN. Le richieste vengono così servite direttamente dall'Edge Network senza invocare la funzione Serverless.

Integrazione di Agenti AI e Log

L'evoluzione dei flussi di lavoro guidati da assistenti e agenti AI richiede che i tool di sviluppo parlino un linguaggio macchina e gestiscano i processi in modo asincrono.

Durante lo sviluppo dell'aggiornamento si è tenuto conto del fatto che gli agenti AI spesso falliscono con i processi CLI persistenti. La nuova modalità Background Dev Server, tramite astro dev --background, avvia il server di sviluppo in background, si distacca dal terminale non appena il server è pronto ed è completamente idempotente in quanto evita la creazione di processi zombie o server duplicati. Include inoltre un suo endpoint di health check in /_astro/status.

Da segnalare infine il JSON Logging che è stato richiesto a gran voce anche per i contesti di produzione e per l'integrazione con aggregatori di log come Grafana Loki, Kibana o AWS CloudWatch. Astro 7 permette di abbandonare i log formattati per umani a favore di output JSON componibili con l'API logHandlers.compose().

Aggiornamento ad Astro 7

Per aggiornare un progetto esistente ad Astro 7.0, il team di core maintainer consiglia l'utilizzo del tool automatizzato da CLI:

npx @astrojs/upgrade

In alternativa, per l'aggiornamento manuale dei pacchetti è possibile lanciare l'istruzione:

npm install astro@latest

Prima di procedere al deploy è meglio di verificare i file di configurazione astro.config.mjs per spostare le chiavi cache e routeRules fuori dal vecchio blocco experimental, ora infatti si tratta di API stabili di livello top-level.