Communitygithub.com

skillshub de ComeOnOliver

Una habilidad conceptual para construir un cliente API en Next.js que maneje tokens JWT.

¿Qué es skillshub de ComeOnOliver?

Esta habilidad conceptual proporciona un marco de trabajo para implementar un cliente API robusto en Next.js con autenticación basada en tokens JWT. Su objetivo principal es centralizar la comunicación con la API, gestionar la autenticación, manejar la expiración y renovación de tokens, y estandarizar el parseo de respuestas de error. Es útil para desarrolladores que construyen aplicaciones Next.js (con App Router o Pages Router) que requieren múltiples endpoints autenticados, garantizando un manejo consistente de errores, seguridad y un rendimiento optimizado. La habilidad cubre la integración tanto del lado del cliente como del servidor, y ofrece pautas sobre almacenamiento seguro de tokens, rendimiento y pruebas. Esta habilidad es adecuada para aplicaciones que ya emplean JWT como método de autenticación principal y necesitan estandarizar las interacciones con la API. No debe usarse para sitios estáticos, aplicaciones sin autenticación o aquellas que utilicen métodos alternativos como claves API o OAuth 2.0. Proporciona un plan conceptual para interfaces unificadas, gestión de tokens, y manejo integral de errores, lo que facilita el desarrollo y mantenimiento del código de comunicación con la API.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/aiskillstore/marketplace/abdul-haseeb360/frontend-api-client-with-jwt

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Habilidad de Cliente API Frontend con JWT

Cuándo Usar Esta Habilidad

Usa esta habilidad conceptual cuando necesites implementar un cliente API robusto en Next.js que maneje correctamente tokens JWT para autenticación. Esta habilidad es adecuada para:

  • Crear una capa de comunicación centralizada con la API en aplicaciones Next.js
  • Gestionar la autenticación basada en JWT en múltiples endpoints de la API
  • Manejar escenarios de expiración y renovación de tokens
  • Estandarizar el parseo y manejo de respuestas de error
  • Implementar patrones de comunicación segura con la API

Esta habilidad NO debe usarse para:

  • Aplicaciones sin autenticación basada en JWT
  • Sitios estáticos sin necesidades de comunicación con API
  • Aplicaciones que usen métodos de autenticación alternativos (claves API, credenciales de cliente OAuth 2.0, etc.)
  • Aplicaciones simples con interacción mínima con la API

Prerrequisitos

  • Aplicación Next.js (ya sea App Router o Pages Router)
  • Comprensión de conceptos de JWT (JSON Web Token)
  • Conocimiento de cabeceras HTTP y mecanismos de autorización
  • Comprensión básica de operaciones asíncronas en JavaScript
  • Conciencia de los contextos de ejecución del lado del cliente y del servidor

Marco de Implementación Conceptual

Capacidad de Adjuntar Cabecera de Autorización

  • Adjuntar automáticamente tokens JWT a las solicitudes de la API como cabeceras Authorization
  • Determinar cuándo incluir tokens según el tipo de solicitud y el endpoint
  • Manejar la adjunción de tokens tanto para solicitudes del lado del cliente como del servidor
  • Gestionar la inclusión de tokens en solicitudes de origen cruzado de manera apropiada
  • Asegurar un formato correcto de la cabecera ("Bearer ")

Capacidad de Manejo de Expiración de Tokens

  • Detectar la expiración del token JWT antes de realizar solicitudes a la API
  • Implementar mecanismos automáticos de renovación de tokens
  • Manejar fallos en la renovación de tokens de manera elegante
  • Mantener la continuidad de la sesión durante la renovación del token
  • Coordinar la renovación de tokens en múltiples solicitudes concurrentes
  • Almacenar tokens actualizados de forma segura después de la renovación

Capacidad de Parseo de Respuestas de Error

  • Parsear respuestas de error estructuradas de los endpoints de la API
  • Identificar errores relacionados con la autenticación (401, 403) para un manejo especial
  • Extraer mensajes de error significativos para la retroalimentación al usuario
  • Manejar diferentes formatos de respuestas de error de manera consistente
  • Distinguir entre errores del cliente, errores del servidor y problemas de red
  • Proporcionar retroalimentación adecuada al usuario según el tipo de error

Capacidad de Centralización de Llamadas a la API

  • Crear una interfaz unificada para todas las comunicaciones con la API
  • Estandarizar el manejo de solicitudes y respuestas en toda la aplicación
  • Implementar manejo y registro de errores consistente
  • Gestionar interceptores de solicitud/respuesta para preocupaciones transversales
  • Proporcionar patrones de llamada a la API con seguridad de tipos (cuando se use TypeScript)
  • Habilitar el almacenamiento en caché y la deduplicación de solicitudes cuando sea apropiado

Entrada/Salida Esperada

Requisitos de Entrada:

  1. Gestión de Tokens JWT:

    • Token JWT válido para autorización
    • Configuración del endpoint de renovación de tokens
    • Mecanismo de almacenamiento de tokens (localStorage, cookies, etc.)
    • Tiempo de expiración del token y momento de renovación
  2. Configuración de la API:

    • URL base de la API para las solicitudes
    • Configuración de tiempo de espera de la solicitud
    • Cabeceras personalizadas y opciones de solicitud
    • Configuraciones específicas de endpoint
  3. Parámetros de Solicitud:

    • Método HTTP (GET, POST, PUT, DELETE, etc.)
    • URL de la solicitud o identificador de endpoint
    • Cuerpo de la solicitud para operaciones POST/PUT
    • Parámetros de consulta y variables de ruta

Formatos de Salida:

  1. Respuesta Exitosa de la API:

    • Códigos de estado HTTP 200-299
    • Datos de respuesta parseados que coincidan con el formato esperado
    • Información de token actualizada cuando corresponda
    • Estructura de respuesta consistente en todos los endpoints
  2. Respuesta de Error de Autenticación:

    • HTTP 401 No Autorizado para tokens caducados/inválidos
    • Intento automático de renovación de token
    • Redirección a la página de inicio de sesión después de un fallo de renovación
    • Mensajería de error clara para problemas de autenticación
  3. Respuesta de Error de Autorización:

    • HTTP 403 Prohibido para permisos insuficientes
    • Manejo de errores apropiado según el nivel de permiso
    • Retroalimentación al usuario sobre la restricción de acceso
  4. Respuesta de Error General:

    • Objeto de error estructurado con mensaje y código
    • Código de estado HTTP apropiado
    • Información de error detallada para depuración
    • Mensajes de error amigables para el usuario para la visualización en la UI

Patrones de Integración

Integración del Lado del Cliente

  • Manejar llamadas a la API desde componentes del cliente y renderizado del lado del cliente
  • Gestionar el almacenamiento y recuperación de tokens en el contexto del navegador
  • Implementar interceptores de solicitud para la adjunción de cabeceras
  • Coordinar con la gestión del estado de autenticación

Integración del Lado del Servidor (cuando corresponda)

  • Manejar llamadas a la API desde componentes del servidor
  • Gestionar la transmisión segura de tokens entre el servidor y el cliente
  • Implementar validación de tokens del lado del servidor
  • Manejar respuestas de error del lado del servidor de manera apropiada

Integración con Componentes React

  • Proporcionar hooks para la comunicación con la API en componentes funcionales
  • Habilitar el acceso al cliente API basado en contexto
  • Soportar tanto patrones de componentes funcionales como de clase
  • Implementar mecanismos adecuados de limpieza y cancelación

Consideraciones de Seguridad

  1. Almacenamiento de Tokens: Almacenamiento seguro de tokens JWT para prevenir ataques XSS
  2. Transmisión de Cabeceras: Usar HTTPS para todas las comunicaciones con la API
  3. Renovación de Tokens: Implementar mecanismos seguros de renovación de tokens
  4. Información de Error: Evitar exponer información sensible en mensajes de error
  5. Validación de Solicitudes: Validar parámetros de solicitud antes de enviar
  6. Validación de Respuestas: Verificar la integridad y el formato de la respuesta
  7. Solicitudes de Sitio Cruzado: Implementar un manejo adecuado de CORS

Implicaciones de Rendimiento

  • Optimizar la recuperación y adjunción de tokens para una sobrecarga mínima
  • Implementar una renovación eficiente de tokens para evitar bloqueos en las solicitudes
  • Considerar estrategias de almacenamiento en caché de solicitudes para mejorar el rendimiento
  • Minimizar llamadas redundantes a la API mediante una gestión de estado adecuada
  • Implementar agrupación de solicitudes cuando sea apropiado
  • Monitorear y optimizar el tiempo de las solicitudes de red

Manejo de Errores y Validación

  • Validar el formato y la expiración del token JWT antes de las solicitudes
  • Manejar problemas de conectividad de red de manera elegante
  • Implementar mecanismos de reintento para fallos transitorios
  • Proporcionar comportamientos alternativos para fallos críticos de la API
  • Registrar errores adecuadamente para depuración sin exponer información sensible
  • Implementar patrones de interruptor de circuito para la resiliencia del servicio

Consideraciones de Pruebas

  • Probar la funcionalidad de adjunción de tokens con tokens válidos/inválidos
  • Verificar que los mecanismos de renovación de tokens funcionen correctamente
  • Validar el parseo de respuestas de error en diferentes tipos de error
  • Probar el comportamiento del cliente API tanto en contextos de cliente como de servidor
  • Verificar la limpieza y cancelación adecuada de solicitudes
  • Probar el manejo de solicitudes concurrentes y la coordinación de renovación de tokens

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Next.js 16+ uses App Router with Server Components by default. Client Components are only used when interactivity is needed (hooks, event handlers, browser APIs).

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Skills relacionados