Communitygithub.com

ComeOnOliver/skillshub

Next.jsアプリケーションでJWTトークンを扱うAPIクライアントを構築するための概念スキル

skillshub とは?

このConceptual Skillは、Next.jsアプリケーションにおいて、JWT(JSON Web Token)による認証を適切に処理する堅牢なAPIクライアントを実装するための包括的なガイドを提供します。主な機能として、Authorizationヘッダーへの自動トークン添付、トークン有効期限の検出とリフレッシュ、エラーレスポンスの統一的な解析、そして全てのAPI通信を一元管理する中央集権的なインターフェースの構築が含まれます。このスキルは、Next.js(App Router/Pages Routerの両対応)を前提としており、クライアントサイドレンダリングとサーバーサイドレンダリングの両方のコンテキストで動作します。特に、複数のエンドポイントにまたがるJWT認証の管理、トークンの有効期限切れやリフレッシュのハンドリング、401/403エラーの自動処理といった機能を標準化するのに役立ちます。なお、このスキルは概念フレームワークを提供するものであり、具体的な実装コードは含まれていません。

対応✓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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

フロントエンドAPIクライアント(JWTスキル)

このスキルを使用するタイミング

この概念スキルは、Next.jsでJWTトークンを適切に処理する堅牢なAPIクライアントを実装する必要がある場合に使用します。このスキルは以下の場面に適しています:

  • Next.jsアプリケーションでの集中型API通信レイヤーの作成
  • 複数のAPIエンドポイントにわたるJWTベース認証の管理
  • トークンの有効期限切れとリフレッシュシナリオの処理
  • エラーレスポンス解析と処理の標準化
  • セキュアなAPI通信パターンの実装

このスキルは以下の場面では使用しないでください:

  • JWTベース認証を使用しないアプリケーション
  • API通信が必要ない静的サイト
  • 代替認証方式(APIキー、OAuth 2.0クライアントクレデンシャルなど)を使用するアプリケーション
  • シンプルなAPIインタラクションしかないアプリケーション

前提条件

  • Next.jsアプリケーション(App RouterまたはPages Router)
  • JWT(JSON Web Token)の概念の理解
  • HTTPヘッダーと認証メカニズムの知識
  • 非同期JavaScript処理の基本的な理解
  • クライアントサイドとサーバーサイドの実行コンテキストの認識

概念実装フレームワーク

Authorizationヘッダー添付機能

  • APIリクエストへのJWTトークンの自動Authorizationヘッダーとしての添付
  • リクエストタイプとエンドポイントに基づくトークン添付の判断
  • クライアントサイドとサーバーサイド両方のリクエストでのトークン添付処理
  • クロスオリジンリクエストにおけるトークン添付の適切な管理
  • 正しいヘッダー形式("Bearer ")の保証

トークン有効期限処理機能

  • APIリクエストを行う前のJWTトークン有効期限の検出
  • 自動トークンリフレッシュメカニズムの実装
  • トークンリフレッシュ失敗のグレースフルな処理
  • トークンリフレッシュ中のセッション維持
  • 複数の同時リクエストにわたるトークンリフレッシュの調整
  • リフレッシュ後の更新トークンの安全な保存

エラーレスポンス解析機能

  • APIエンドポイントからの構造化エラーレスポンスの解析
  • 特別処理のための認証関連エラー(401, 403)の特定
  • ユーザーフィードバックのための意味のあるエラーメッセージの抽出
  • 異なるエラーレスポンス形式の一貫した処理
  • クライアントエラー、サーバーエラー、ネットワーク問題の区別
  • エラータイプに基づく適切なユーザーフィードバックの提供

API呼び出し一元化機能

  • すべてのAPI通信用の統一インターフェースの作成
  • アプリケーション全体でのリクエスト/レスポンス処理の標準化
  • 一貫したエラーハンドリングとログ記録の実装
  • 横断的関心事へのリクエスト/レスポンスインターセプターの管理
  • タイプセーフなAPI呼び出しパターンの提供(TypeScript使用時)
  • 該当する場合のリクエストキャッシュと重複排除の有効化

期待される入出力

入力要件:

  1. JWTトークン管理:

    • 認証用の有効なJWTトークン
    • トークンリフレッシュエンドポイントの設定
    • トークン保存メカニズム(localStorage、cookiesなど)
    • トークンの有効期限とリフレッシュタイミング
  2. API設定:

    • リクエスト用のベースAPI URL
    • リクエストタイムアウト設定
    • カスタムヘッダーとリクエストオプション
    • エンドポイント固有の設定
  3. リクエストパラメータ:

    • HTTPメソッド(GET、POST、PUT、DELETEなど)
    • リクエストURLまたはエンドポイント識別子
    • POST/PUT操作用のリクエストボディ
    • クエリパラメータとパス変数

出力形式:

  1. 成功時のAPIレスポンス:

    • HTTP 200-299ステータスコード
    • 期待される形式の解析済みレスポンスデータ
    • 該当する場合の更新されたトークン情報
    • 全エンドポイントで一貫したレスポンス構造
  2. 認証エラーレスポンス:

    • 期限切れ/無効なトークンの場合はHTTP 401 Unauthorized
    • 自動トークンリフレッシュ試行
    • リフレッシュ失敗後のログインページへのリダイレクト
    • 認証問題に対する明確なエラーメッセージ
  3. 認可エラーレスポンス:

    • 権限不足の場合はHTTP 403 Forbidden
    • 権限レベルに基づく適切なエラーハンドリング
    • アクセス制限に対するユーザーフィードバック
  4. 一般的なエラーレスポンス:

    • メッセージとコードを含む構造化エラーオブジェクト
    • 適切なHTTPステータスコード
    • デバッグ用の詳細エラー情報
    • UI表示用のユーザーフレンドリーなエラーメッセージ

統合パターン

クライアントサイド統合

  • クライアントコンポーネントとクライアントサイドレンダリングからのAPI呼び出し処理
  • ブラウザコンテキストでのトークン保存と取得の管理
  • ヘッダー添付用のリクエストインターセプターの実装
  • 認証状態管理との調整

サーバーサイド統合(該当する場合)

  • サーバーコンポーネントからのAPI呼び出し処理
  • サーバーとクライアント間での安全なトークン送信管理
  • サーバーサイドでのトークン検証の実装
  • サーバーサイドエラーレスポンスの適切な処理

Reactコンポーネント統合

  • 関数コンポーネントでのAPI通信用フックの提供
  • コンテキストベースのAPIクライアントアクセスの有効化
  • 関数コンポーネントとクラスコンポーネント両方のパターンサポート
  • 適切なクリーンアップとキャンセルメカニズムの実装

セキュリティ考慮事項

  1. トークン保存: XSS攻撃を防ぐための安全なJWTトークン保存
  2. ヘッダー送信: すべてのAPI通信にHTTPSを使用
  3. トークンリフレッシュ: 安全なトークンリフレッシュメカニズムの実装
  4. エラー情報: エラーメッセージに機密情報を公開しない
  5. リクエスト検証: 送信前のリクエストパラメータの検証
  6. レスポンス検証: レスポンスの整合性と形式の検証
  7. クロスサイトリクエスト: 適切なCORS処理の実装

パフォーマンスへの影響

  • 最小オーバーヘッドのためのトークン取得と添付の最適化
  • リクエストをブロックしないための効率的なトークンリフレッシュの実装
  • パフォーマンス向上のためのリクエストキャッシュ戦略の検討
  • 適切な状態管理による冗長なAPI呼び出しの最小化
  • 該当する場合のリクエストバッチ処理の実装
  • ネットワークリクエストタイミングの監視と最適化

エラーハンドリングと検証

  • リクエスト前のJWTトークンの形式と有効期限の検証
  • ネットワーク接続問題のグレースフルな処理
  • 一時的な障害に対するリトライメカニズムの実装
  • 重要なAPI障害に対するフォールバック動作の提供
  • 機密情報を露出せずに適切なデバッグ用エラーログ記録
  • サービス回復力のためのサーキットブレーカーパターンの実装

テストの考慮事項

  • 有効/無効なトークンを使用したトークン添付機能のテスト
  • トークンリフレッシュメカニズムの正しい動作の検証
  • さまざまなエラータイプにわたるエラーレスポンス解析の検証
  • クライアントとサーバー両方のコンテキストでのAPIクライアント動作のテスト
  • 適切なクリーンアップとリクエストキャンセルの検証
  • 同時リクエスト処理とトークンリフレッシュ調整のテスト

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

関連スキル