@feelflow/ffid-sdk 4.3.0 → 5.0.1

package/README.md

@@ -21,6 +21,39 @@ pnpm add @feelflow/ffid-sdk
 
 サービスを FFID Platform に統合する詳細なガイドは **[Integration Guide](./docs/INTEGRATION_GUIDE.md)** を参照してください。OAuth フロー、フロントエンド/バックエンド実装パターン、セキュリティチェックリスト、アンチパターン集を網羅しています。
 
+### Cookie 同意管理基盤 (v5.0.0+)
+
+GDPR / ePrivacy / 改正電気通信事業法 / APPI 準拠の Cookie 同意 UI を **15 分以内** に導入できます (opt-in、v4.x 完全互換)。
+
+- **[Cookie Consent Integration Guide](./docs/cookie-consent-guide.md)** — 17 章の詳細統合手順 (App Router / Pages Router / Vite / Consent Mode v2 / Sentry replay / RSC / i18n / A11y / エラーハンドリング)
+- **[v4 → v5 Migration Guide](./docs/MIGRATION_v5.md)** — minimal / full アップグレード手順、自前 gtag からの移譲、Rollback
+- **[Troubleshooting Q&A](./docs/cookie-consent-troubleshooting.md)** — Banner / GA / Cookie / TypeScript / API / Sentry のよくある詰まりポイント
+- **動作サンプル**: [App Router](./examples/cookie-consent/nextjs-app-router/) / [Pages Router](./examples/cookie-consent/nextjs-pages-router/) / [Vite + React](./examples/cookie-consent/vite-react/)
+
+```tsx
+// app/layout.tsx (App Router、最短 3 ステップ)
+import {
+  FFIDProvider,
+  FFIDAnalyticsProvider,
+  FFIDCookieBanner,
+} from '@feelflow/ffid-sdk'
+
+export default function RootLayout({ children }) {
+  return (
+    <FFIDProvider serviceCode="your-service">
+      <FFIDAnalyticsProvider
+        baseUrl={process.env.NEXT_PUBLIC_FFID_BASE_URL!}
+        serviceApiKey={process.env.FFID_SERVICE_API_KEY!}
+        gaMeasurementId={process.env.NEXT_PUBLIC_GA_ID ?? null}
+      >
+        {children}
+        <FFIDCookieBanner />
+      </FFIDAnalyticsProvider>
+    </FFIDProvider>
+  )
+}
+```
+
 ## クイックスタート
 
 ### 1. プロバイダーを設定（5行で完了！）