Communitygithub.com

ComeOnOliver/skillshub

Habilidade conceitual para construir um cliente de API em Next.js que gerencia tokens JWT.

O que é skillshub?

Esta habilidade conceitual fornece um guia completo para implementar um cliente de API robusto em Next.js, focado no gerenciamento de tokens JWT para autenticação. Ela é ideal para desenvolvedores que precisam centralizar a comunicação com APIs, automatizar o anexo de tokens de autorização, lidar com expiração e renovação de tokens de forma transparente, e padronizar o tratamento de erros. A habilidade suporta tanto o App Router quanto o Pages Router do Next.js e aborda integrações tanto no lado do cliente quanto no servidor. O guia inclui capacidades essenciais como anexo automático de tokens, renovação concorrente, parsing de erros de autenticação (401, 403) e centralização de chamadas de API, além de considerações de segurança, desempenho e testes. Apesar de ser conceitual, oferece um framework prático para arquitetar soluções de API reais, com padrões de integração para componentes React e hooks.

Funciona com✓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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Habilidade de Cliente de API Frontend com JWT

Quando Usar Esta Habilidade

Use esta habilidade conceitual quando precisar implementar um cliente de API robusto em Next.js que gerencie tokens JWT para autenticação. Esta habilidade é apropriada para:

  • Criar uma camada centralizada de comunicação com a API em aplicações Next.js
  • Gerenciar autenticação baseada em JWT em múltiplos endpoints de API
  • Lidar com expiração e renovação de tokens
  • Padronizar o parsing e tratamento de erros
  • Implementar padrões seguros de comunicação com a API

Esta habilidade NÃO deve ser usada para:

  • Aplicações sem autenticação baseada em JWT
  • Sites estáticos sem necessidade de comunicação com API
  • Aplicações usando métodos de autenticação alternativos (chaves de API, credenciais OAuth 2.0, etc.)
  • Aplicações simples com interação mínima com API

Pré-requisitos

  • Aplicação Next.js (App Router ou Pages Router)
  • Compreensão de conceitos de JWT (JSON Web Token)
  • Conhecimento de cabeçalhos HTTP e mecanismos de autorização
  • Entendimento básico de operações assíncronas em JavaScript
  • Consciência dos contextos de execução do lado do cliente versus do lado do servidor

Framework Conceitual de Implementação

Capacidade de Anexar Cabeçalho de Autorização

  • Anexar automaticamente tokens JWT às requisições de API como cabeçalhos de Autorização
  • Determinar quando incluir tokens com base no tipo de requisição e endpoint
  • Gerenciar o anexo de tokens tanto para requisições do lado do cliente quanto do servidor
  • Gerenciar a inclusão de tokens em requisições de origens cruzadas de forma apropriada
  • Garantir a formatação correta do cabeçalho ("Bearer ")

Capacidade de Tratar Expiração de Token

  • Detectar a expiração do token JWT antes de fazer requisições à API
  • Implementar mecanismos automáticos de renovação de token
  • Tratar falhas na renovação de token de forma graciosa
  • Manter a continuidade da sessão durante a renovação do token
  • Coordenar a renovação de token em múltiplas requisições concorrentes
  • Armazenar tokens atualizados de forma segura após a renovação

Capacidade de Analisar Respostas de Erro

  • Analisar respostas de erro estruturadas dos endpoints da API
  • Identificar erros relacionados à autenticação (401, 403) para tratamento especial
  • Extrair mensagens de erro significativas para feedback ao usuário
  • Tratar diferentes formatos de resposta de erro de forma consistente
  • Distinguir entre erros do cliente, erros do servidor e problemas de rede
  • Fornecer feedback apropriado ao usuário com base nos tipos de erro

Capacidade de Centralizar Chamadas de API

  • Criar uma interface unificada para todas as comunicações com a API
  • Padronizar o tratamento de requisições e respostas em toda a aplicação
  • Implementar tratamento e registro de erros consistentes
  • Gerenciar interceptadores de requisição/resposta para preocupações transversais
  • Fornecer padrões de chamada de API com tipagem segura (ao usar TypeScript)
  • Habilitar cache e desduplicação de requisições quando apropriado

Entrada/Saída Esperadas

Requisitos de Entrada:

  1. Gerenciamento de Token JWT:

    • Token JWT válido para autorização
    • Configuração do endpoint de renovação de token
    • Mecanismo de armazenamento de token (localStorage, cookies, etc.)
    • Tempo de expiração do token e sincronismo de renovação
  2. Configuração da API:

    • URL base da API para requisições
    • Configuração de timeout de requisição
    • Cabeçalhos personalizados e opções de requisição
    • Configurações específicas por endpoint
  3. Parâmetros de Requisição:

    • Método HTTP (GET, POST, PUT, DELETE, etc.)
    • URL da requisição ou identificador do endpoint
    • Corpo da requisição para operações POST/PUT
    • Parâmetros de consulta e variáveis de caminho

Formatos de Saída:

  1. Resposta de API Bem-sucedida:

    • Códigos de status HTTP 200-299
    • Dados de resposta analisados conforme formato esperado
    • Informações de token atualizadas quando aplicável
    • Estrutura de resposta consistente em todos os endpoints
  2. Resposta de Erro de Autenticação:

    • HTTP 401 Não Autorizado para tokens expirados/inválidos
    • Tentativa automática de renovação de token
    • Redirecionamento para a página de login após falha na renovação
    • Mensagens de erro claras para problemas de autenticação
  3. Resposta de Erro de Autorização:

    • HTTP 403 Proibido para permissões insuficientes
    • Tratamento de erro apropriado com base no nível de permissão
    • Feedback ao usuário sobre restrição de acesso
  4. Resposta de Erro Geral:

    • Objeto de erro estruturado com mensagem e código
    • Código de status HTTP apropriado
    • Informações detalhadas de erro para depuração
    • Mensagens de erro amigáveis ao usuário para exibição na interface

Padrões de Integração

Integração do Lado do Cliente

  • Tratar chamadas de API de componentes do cliente e renderização do lado do cliente
  • Gerenciar armazenamento e recuperação de token no contexto do navegador
  • Implementar interceptadores de requisição para anexar cabeçalhos
  • Coordenar com o gerenciamento de estado de autenticação

Integração do Lado do Servidor (quando aplicável)

  • Tratar chamadas de API de componentes do servidor
  • Gerenciar a transmissão segura de tokens entre servidor e cliente
  • Implementar validação de token no lado do servidor
  • Tratar respostas de erro do servidor de forma apropriada

Integração com Componentes React

  • Fornecer hooks para comunicação com API em componentes funcionais
  • Permitir acesso ao cliente de API baseado em contexto
  • Suportar padrões de componentes funcionais e de classe
  • Implementar mecanismos adequados de limpeza e cancelamento

Considerações de Segurança

  1. Armazenamento de Token: Armazenamento seguro de tokens JWT para prevenir ataques XSS
  2. Transmissão de Cabeçalho: Uso de HTTPS para todas as comunicações com a API
  3. Renovação de Token: Implementação de mecanismos seguros de renovação de token
  4. Informações de Erro: Evitar exposição de informações sensíveis em mensagens de erro
  5. Validação de Requisição: Validar parâmetros de requisição antes de enviar
  6. Validação de Resposta: Verificar integridade e formato da resposta
  7. Requisições entre Sites: Implementar tratamento adequado de CORS

Implicações de Desempenho

  • Otimizar recuperação e anexo de token para sobrecarga mínima
  • Implementar renovação eficiente de token para evitar bloqueio de requisições
  • Considerar estratégias de cache de requisições para melhor desempenho
  • Minimizar chamadas de API redundantes por meio de gerenciamento de estado adequado
  • Implementar agrupamento de requisições quando apropriado
  • Monitorar e otimizar o tempo das requisições de rede

Tratamento de Erros e Validação

  • Validar formato e expiração do token JWT antes das requisições
  • Tratar problemas de conectividade de rede de forma graciosa
  • Implementar mecanismos de repetição para falhas transitórias
  • Fornecer comportamentos de fallback para falhas críticas de API
  • Registrar erros apropriadamente para depuração sem expor informações sensíveis
  • Implementar padrões de disjuntor para resiliência do serviço

Considerações de Teste

  • Testar funcionalidade de anexo de token com tokens válidos/inválidos
  • Verificar se os mecanismos de renovação de token funcionam corretamente
  • Validar o parsing de respostas de erro em diferentes tipos de erro
  • Testar o comportamento do cliente de API nos contextos de cliente e servidor
  • Verificar a limpeza e cancelamento adequados de requisições
  • Testar o tratamento de requisições concorrentes e coordenação de renovação de token

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

Habilidades Relacionadas