Saltar al contenido
Rafhael Marsigli
5 min de lectura

Garantiza 100% de tipado seguro de Laravel a React

Garantiza 100% de tipado seguro de Laravel a React

Si seguiste mis posts recientes, sabes que estoy en una cruzada para eliminar la “magia” de mis aplicaciones Laravel. Cambié arrays asociativos flojos por DTOs estrictos y reemplacé Observers implícitos por Services explícitos. Mi backend ahora es una verdadera fortaleza de estabilidad.

Pero, hace poco, me di cuenta de que todavía había un enorme agujero en mi armadura.

Pasaba horas creando objetos UserData perfectamente tipados en PHP. Luego los enviaba a Inertia.js y… poof. Apenas esos datos cruzaban el puente hacia React (o Vue), se volvían el Lejano Oeste. Mis componentes de frontend trataban las props como any o, peor aún, yo terminaba escribiendo a mano interfaces TypeScript que siempre estaban desincronizadas con el backend.

Así fue como corregí la última brecha del stack usando Laravel Data de Spatie combinado con Spatie TypeScript Transformer.

La sincronización manual es una pesadilla

Seamos sinceros: mantener los tipos del frontend sincronizados con los modelos del backend es una batalla perdida.

Cambias una propiedad en PHP de is_active a status. Actualizas la base de datos. Actualizas el DTO. Pero olvidas actualizar la interfaz UserProps en el archivo types.ts del frontend.

El compilador no se queja. El build pasa. Haces el deploy. Entonces un usuario hace clic en un botón y la pantalla queda en blanco. Uncaught TypeError: Cannot read properties of undefined.

Aceptamos esa fragilidad como “parte del trabajo”. No tiene por qué ser así.

Automatizando el contrato

La solución es dejar que el propio código PHP escriba el código TypeScript. Como ya usamos spatie/laravel-data para definir nuestras estructuras de datos, podemos usar el paquete spatie/laravel-typescript-transformer para generar automáticamente las definiciones en TS cada vez que nuestras clases cambien.

Esto no es solo un “nice to have”. Es la diferencia entre esperar que el frontend funcione y saber que funciona.

El “not-magic” en acción

Mira cómo funciona la configuración. Instalas el paquete y, de repente, tus DTOs se vuelven la única fuente de verdad de toda la aplicación, de punta a punta.

Miremos nuestra confiable clase UserData del post anterior. Con una configuración simple, podemos instruir a Laravel para que transforme esa clase en una interfaz TypeScript automáticamente.

namespace App\Data;
use Spatie\LaravelData\Data;
use Spatie\TypeScriptTransformer\Attributes\TypeScript;
#[TypeScript]
class UserData extends Data
{
public function __construct(
public int $id,
public string $name,
public string $email,
public ?string $role, // nullable string
/** @var array<int, string> */
public array $permissions
) {}
}

Ejecutas un comando simple: php artisan typescript:transform.

Y ese archivo se crea automáticamente en:

export type UserData = {
id: number;
name: string;
email: string;
role: string | null;
permissions: Array<string>;
}

¡Mira esa precisión! Trató ?string como string | null. Entendió el PHPDoc del array. No escribí ni un solo carácter de eso.

Refactorizando el componente de frontend

Ahora, miremos un componente React usando Inertia. Antes, yo andaba adivinando qué había dentro de user. Ahora tengo soporte completo del IDE.

import React from 'react';
import { UserData } from '@/types/generated'; // Importado do arquivo gerado automaticamente
interface Props {
user: UserData; // Tipagem estrita!
}
export default function UserProfile({ user }: Props) {
// O autocomplete funciona aqui!
// Se eu digitar "user.", o VS Code sugere "email", "role", etc.
return (
<div className="p-4 shadow">
<h1>{user.name}</h1>
{/* Erro de TypeScript: a propriedade 'isAdmin' não existe no tipo 'UserData'. */}
{/* O compilador detecta meu erro de digitação antes mesmo de eu salvar o arquivo! */}
{user.isAdmin && <span className="badge">Admin</span>}
{/* Uso correto com base no DTO */}
{user.role === 'admin' && <span className="badge">Admin</span>}
</div>
);
}

El workflow del “Ay, rompí todo”

El verdadero valor de este enfoque aparece cuando refactorizas.

Imagina que decides que permissions ya no debe ser un array de strings, sino un array de objetos. Cambias el DTO en PHP. Ejecutas el comando del transformer. Inmediatamente, la terminal se pone roja. El build de React falla. TypeScript señala exactamente cada archivo del frontend donde estabas haciendo map sobre permissions esperando un string.

No necesitas salir a cazar bugs. El compilador te entrega una lista clara de lo que hay que corregir. Esa tranquilidad no tiene precio.

Lidiando con Enums

Y se pone aún mejor. Esto funciona perfectamente con los Enums de PHP.

Ahora, la lógica del frontend no puede, por accidente, verificar un role que no existe. Efectivamente erradicaste las “magic strings” de toda tu base de código — desde la columna en la base de datos hasta la condición en el JSX de React.

#[TypeScript]
enum UserRole: string
{
case Admin = 'admin';
case Editor = 'editor';
case Customer = 'customer';
}

Queda:

export type UserRole = 'admin' | 'editor' | 'customer'

Un lenguaje para gobernar el mundo todo

Hablamos mucho de “Backend” y “Frontend” como si fueran dos mundos distintos. Pero en una aplicación monolítica Laravel + Inertia, comparten el mismo dominio.

Al usar spatie/laravel-data junto con el typescript-transformer, construyes ese puente. Dejas de ser solo un desarrollador PHP o un desarrollador React; pasas a ser un Arquitecto de Aplicaciones.

Sí, configurar este pipeline toma unos 30 minutos. Pero las horas que ahorras depurando errores como “undefined is not an object” son incalculables. Deja de escribir interfaces manualmente. Deja que la máquina haga el trabajo.

Empieza a escribir para encontrar algo.