Tema 14 · Estado Global con Pinia

14. Gestión de Estado Global con Pinia: State, Getters y Actions sin Boilerplate

Integra el gestor de estado oficial moderno de Vue 3: define stores con defineStore (Option Store o Setup Store), accede al estado reactivo y ejecuta acciones síncronas o asíncronas con soporte TypeScript nativo.

El Estándar Oficial de Estado Global: Pinia

Para aplicaciones complejas donde múltiples vistas y componentes desconectados necesitan leer y mutar los mismos datos (sesión de usuario, carrito de compras, notificaciones globales), Vue adoptó oficialmente a Pinia como el reemplazo definitivo y moderno de Vuex.

1. ¿Por qué Pinia Jubiló a Vuex?

Característica Vuex 3/4 (Legado) Pinia (Estándar Moderno Oficial)
Mutations Obligatorias. Requería separar la mutación síncrona de las acciones. Eliminadas por completo. Las Actions mutan el estado directamente.
Tipado con TypeScript Pobre, requería wrappers complejos y cadenas mágicas (strings). 100% nativo: Autocompletado e inferencia perfecta de tipos.
Estructura Un único Store monolítico con módulos anidados. Multi-Store plano: Creas múltiples stores independientes según el dominio.
Boilerplate Extremadamente verboso. Mínimo y natural; código limpio que se siente como JavaScript puro.

2. Anatomía de un Store con defineStore()

Pinia permite dos sintaxis: Option Stores (similar a Options API) y Setup Stores (idéntico a Composition API con ref y computed):

// Option Store:
import { defineStore } from 'pinia';

export const useCarritoStore = defineStore('carrito', {
  // 1. Estado reactivo fuente
  state: () => ({
    articulos: [],
    cupon: null
  }),

  // 2. Cálculos derivados con caché automática (Getters)
  getters: {
    totalItems: (state) => state.articulos.length,
    precioFinal(state) {
      const subtotal = state.articulos.reduce((acc, a) => acc + a.precio, 0);
      return state.cupon ? subtotal * 0.9 : subtotal;
    }
  },

  // 3. Métodos síncronos o asíncronos que modifican el estado (Actions)
  actions: {
    agregar(producto) {
      this.articulos.push(producto);
    },
    async procesarPago() {
      await fetch('/api/checkout', { method: 'POST', body: JSON.stringify(this.articulos) });
      this.articulos = [];
    }
  }
});

3. Destructuración Segura con storeToRefs()

Al igual que con reactive, si destructuras un store de Pinia directamente perderás la reactividad. Pinia provee el helper storeToRefs():

import { storeToRefs } from 'pinia';
const store = useCarritoStore();

// Las propiedades reactivas (state y getters) usan storeToRefs:
const { articulos, totalItems } = storeToRefs(store);

// Las acciones (funciones) se destructuran directamente:
const { agregar, procesarPago } = store;

⚡ Gestión de Estado Centralizada con Pinia

Store reactivo con state, getters computados y acciones síncronas/asíncronas.

index.html
Solo lectura
<!DOCTYPE html>
<html lang="es">
<head>
  <meta charset="utf-8">
  <title>Pinia State Management en Vue 3</title>
  <link href="https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css" rel="stylesheet">
</head>
<body class="p-4 bg-light">
  <div id="app" class="card shadow-sm p-4 mx-auto" style="max-width: 520px;">
    <!-- Barra superior de la tienda -->
    <div class="d-flex justify-content-between align-items-center mb-3">
      <h5 class="fw-bold text-success mb-0">Tienda con Pinia</h5>
      <span class="badge bg-warning text-dark fs-6">
        🛒 {{ carritoStore.totalArticulos }} items (\${{ carritoStore.totalPrecio }})
      </span>
    </div>

    <!-- Catálogo -->
    <h6 class="small text-secondary fw-bold">Catálogo de Cursos:</h6>
    <div class="vstack gap-2 mb-3">
      <div v-for="curso in catalogo" :key="curso.id" class="p-2 bg-white border rounded d-flex justify-content-between align-items-center">
        <div>
          <span class="fw-bold">{{ curso.titulo }}</span>
          <span class="text-muted small ms-2">\${{ curso.precio }}</span>
        </div>
        <button @click="carritoStore.agregarAlCarrito(curso)" class="btn btn-sm btn-outline-success">
          + Agregar
        </button>
      </div>
    </div>

    <!-- Vista del Carrito Global -->
    <div class="p-3 bg-white border rounded">
      <div class="d-flex justify-content-between align-items-center mb-2">
        <h6 class="fw-bold mb-0">Carrito Global:</h6>
        <button @click="carritoStore.vaciar" :disabled="carritoStore.articulos.length === 0" class="btn btn-sm btn-outline-danger py-0">
          Vaciar
        </button>
      </div>

      <ul v-if="carritoStore.articulos.length > 0" class="list-group list-group-flush small mb-2">
        <li v-for="(item, idx) in carritoStore.articulos" :key="idx" class="list-group-item d-flex justify-content-between py-1 px-0">
          <span>{{ item.titulo }}</span>
          <span class="fw-bold">\${{ item.precio }}</span>
        </li>
      </ul>
      <div v-else class="text-muted small py-2">El carrito está vacío.</div>

      <div class="border-top pt-2 d-flex justify-content-between fw-bold text-success">
        <span>Total Acumulado:</span>
        <span>\${{ carritoStore.totalPrecio }}</span>
      </div>
    </div>
  </div>

    <script src="/assets/vendor/vue/vue.global.prod.js"></script>
  <script src="/assets/vendor/vue/vue-demi.iife.js"></script>
  <script src="/assets/vendor/vue/pinia.iife.prod.js"></script>
  <script>
    if (!window.Vue) {
      document.write('<script src="https://cdn.jsdelivr.net/npm/vue@3/dist/vue.global.prod.js"><\/script>');
    }
    if (!window.Pinia) {
      document.write('<script src="https://cdn.jsdelivr.net/npm/[email protected]/lib/index.iife.js"><\/script><script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/pinia.iife.prod.js"><\/script>');
    }
  </script>

  <script>
    const { createApp, ref } = Vue;
    const { createPinia, defineStore } = Pinia;

    // 1. DEFINICIÓN DEL STORE GLOBAL DE PINIA:
    const useCarritoStore = defineStore('carrito', {
      state: () => ({
        articulos: []
      }),
      getters: {
        totalArticulos: (state) => state.articulos.length,
        totalPrecio: (state) => state.articulos.reduce((total, a) => total + a.precio, 0)
      },
      actions: {
        agregarAlCarrito(producto) {
          this.articulos.push({ ...producto });
        },
        vaciar() {
          this.articulos = [];
        }
      }
    });

    const app = createApp({
      setup() {
        const carritoStore = useCarritoStore();

        const catalogo = ref([
          { id: 1, titulo: 'Vue 3 Avanzado', precio: 35 },
          { id: 2, titulo: 'TypeScript para Frontend', precio: 40 },
          { id: 3, titulo: 'Arquitectura con Pinia', precio: 25 }
        ]);

        return {
          carritoStore,
          catalogo
        };
      }
    });

    // 2. INSTALAR PINIA EN LA APLICACIÓN:
    app.use(createPinia());
    app.mount('#app');
  </script>
</body>
</html>
Pruébalo tú mismo » Se abre en una nueva pestaña con ejecución en vivo
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Por qué Pinia eliminó el concepto de "Mutations" que existía en su predecesor Vuex?
🦉
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.

🚀 ¿Quieres dominar Vue.js 3 Profesional: Composition API, Script Setup, Pinia & Vite y crear proyectos reales?

Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.