@feelflow/ffid-sdk 5.1.0 → 5.2.1

package/dist/{FFIDCookieLink-CAKupVSS.d.cts → FFIDCookieLink-DY60yHYu.d.cts}

@@ -477,6 +477,16 @@ declare const CONSENT_COOKIE_MAX_AGE_SEC: number;
  * first, then fall back to cookie. See `FFIDAnalyticsProvider.bootstrap`.
  */
 declare const CONSENT_SESSION_STORAGE_KEY = "ffid_consent_state";
+/**
+ * sessionStorage key for the dismissal timestamp ("あとで" cooldown).
+ *
+ * EDPB Guidelines 05/2020 §86 forbids treating dismissal as a refusal, so we
+ * never write this to a cookie or DB. Holding the timestamp in sessionStorage
+ * keeps it scoped to the current tab session — once the tab closes, the user
+ * is reprompted on next visit. See `FFIDAnalyticsProvider`'s
+ * `dismissalCooldownMinutes` prop for the auto-show suppression policy.
+ */
+declare const CONSENT_DISMISSAL_TIMESTAMP_KEY = "ffid_consent_dismissed_at";
 interface WriteConsentCookieOptions {
     /** Override Secure flag for non-https custom domains. Defaults to production. */
     secure?: boolean;
@@ -520,6 +530,34 @@ declare function deleteConsentCookie(opts?: WriteConsentCookieOptions): boolean;
 declare function readConsentSessionMirror(): FFIDConsentCategories | null;
 declare function writeConsentSessionMirror(cats: FFIDConsentCategories): boolean;
 declare function clearConsentSessionMirror(): void;
+/**
+ * Read the millisecond unix timestamp at which the banner was last dismissed,
+ * or `null` if absent / invalid / sessionStorage unavailable.
+ *
+ * Defensive parsing rejects non-finite values, negatives, and future-dated
+ * timestamps (clock-skew / tampering). When a corrupted value is detected,
+ * the helper **auto-heals** by clearing the slot — otherwise the same bad
+ * value would be re-parsed on every Provider mount and a buggy / extension-
+ * polluted consumer site could leave the cooldown effectively permanently
+ * disabled with no surface signal.
+ */
+declare function readConsentDismissalTimestamp(): number | null;
+/**
+ * Write the dismissal timestamp. Returns `true` on success, `false` when
+ * sessionStorage is unavailable / throws (e.g., quota, old Safari Private
+ * Browsing) **or** when `nowMs` is non-finite / negative.
+ *
+ * Callers may safely ignore the return — failure degrades to the legacy
+ * "reprompt every Provider mount" behavior, which is the published v5.1.0
+ * baseline. Dismissal carries no GDPR weight (EDPB §86) so there is no
+ * obligation to surface storage failure via `onError`.
+ */
+declare function writeConsentDismissalTimestamp(nowMs?: number): boolean;
+/**
+ * Idempotent clear of the dismissal timestamp. Safe to call when no value is
+ * present or sessionStorage is unavailable; never throws.
+ */
+declare function clearConsentDismissalTimestamp(): void;
 
 /**
  * Cookie Consent — Google Consent Mode v2 wiring.
@@ -652,11 +690,29 @@ interface FFIDAnalyticsProviderProps {
     onError?: (error: FFIDConsentError) => void;
     /** Whether to open banner automatically when no decision is on file. Default: true. */
     autoShowBanner?: boolean;
+    /**
+     * Minutes to suppress auto-reopen after the user presses "あとで" (closeBanner).
+     *
+     * The dismissal timestamp is held in `sessionStorage` only — never written
+     * to cookie or DB — so it expires when the tab closes. This is EDPB
+     * Guidelines 05/2020 §86 compliant: dismissal is not a refusal, and the
+     * user is reprompted on the next fresh visit regardless of cooldown.
+     *
+     * Accepts any `number`; non-finite (`NaN` / `±Infinity`) and negative
+     * values are treated as `0` (suppression disabled). `0` reverts to the
+     * legacy v5.1.0 "reprompt on every Provider mount" behavior. Default: 30.
+     *
+     * Manual `openBanner()` calls ignore the cooldown so consumer "Cookie 設定"
+     * links keep working, and `needsRenewal=true` overrides the cooldown so the
+     * renewal reprompt (CNIL/ICO renewal guidance — see PR #3261) is never
+     * suppressed by a UX dismissal.
+     */
+    dismissalCooldownMinutes?: number;
     /** Optional fetch override (mainly for tests). */
     fetchImpl?: typeof fetch;
     children: ReactNode;
 }
-declare function FFIDAnalyticsProvider({ baseUrl, serviceApiKey, getAccessToken, gaMeasurementId, sentryReplay, sentry, onConsentChange, onError, autoShowBanner, fetchImpl, children, }: FFIDAnalyticsProviderProps): React.JSX.Element;
+declare function FFIDAnalyticsProvider({ baseUrl, serviceApiKey, getAccessToken, gaMeasurementId, sentryReplay, sentry, onConsentChange, onError, autoShowBanner, dismissalCooldownMinutes, fetchImpl, children, }: FFIDAnalyticsProviderProps): React.JSX.Element;
 
 interface FFIDConsentContextValue {
     /** Current consent state. Always non-null; "not yet decided" is encoded by `hasDecided=false`. */
@@ -795,7 +851,14 @@ declare function useFFIDConsentPreferences(): UseFFIDConsentPreferencesReturn;
 /**
  * `<FFIDCookieBanner>` — bottom-sheet consent banner.
  *
- * Renders only when `state.hasDecided === false` or `state.needsRenewal === true`.
+ * Rendering is gated solely by `isBannerOpen` from the consent context (see
+ * `FFIDAnalyticsProvider`). The provider's bootstrap effect flips it to
+ * `true` for fresh visitors / policy-version renewal, and the banner's own
+ * buttons (or any consumer calling `closeBanner()` / `openBanner()`) flip
+ * it back. The earlier `hasDecided=false || needsRenewal=true` fallback
+ * was removed in v5.2.1 (#3289) because it overrode `setIsBannerOpen(false)`
+ * for fresh visitors and silently kept the banner mounted on "あとで" click.
+ *
  * Four buttons (spec §6.2):
  *   1. "すべて同意" (Accept all)
  *   2. "同意しない" (Necessary only — `necessary=true` is enforced by ePrivacy
@@ -916,4 +979,4 @@ interface FFIDCookieLinkProps {
 }
 declare function FFIDCookieLink({ children, className, style, id, }: FFIDCookieLinkProps): React.JSX.Element;
 
-export { GetCategoriesWireSchema as $, ALL_DENIED_EXCEPT_NECESSARY as A, FFIDConsentMergeWarningSchema as B, CONSENT_COOKIE_MAX_AGE_SEC as C, DEFAULT_CONSENT_ERROR_MESSAGES as D, type FFIDConsentSource as E, type FFIDConsentResult as F, type GetConsentMeWire as G, FFIDConsentSourceSchema as H, FFIDConsentStateSchema as I, FFIDConsentUpdateSchema as J, FFIDCookieBanner as K, type FFIDCookieBannerClassNames as L, type FFIDCookieBannerProps as M, FFIDCookieLink as N, type FFIDCookieLinkProps as O, type PostConsentWire as P, FFIDCookiePolicySchema as Q, FFIDCookieSettings as R, type FFIDCookieSettingsClassNames as S, type FFIDCookieSettingsProps as T, type FFIDInternalConsentSource as U, FFIDInternalConsentSourceSchema as V, type FFIDPublicConsentSource as W, FFIDPublicConsentSourceSchema as X, FFID_CONSENT_ERROR_CODES as Y, FFID_CONSENT_NOT_DECIDED_STATE as Z, type GetCategoriesWire as _, type FFIDConsentState as a, GetConsentMeWireSchema as a0, type GetDocumentWire as a1, GetDocumentWireSchema as a2, type GtagBridge as a3, type GtagBridgeOptions as a4, type PostConsentRequest as a5, PostConsentRequestSchema as a6, PostConsentWireSchema as a7, type PostSyncRequest as a8, PostSyncRequestSchema as a9, PostSyncWireSchema as aa, PostWithdrawWireSchema as ab, type UseFFIDConsentPreferencesReturn as ac, type UseFFIDConsentReturn as ad, clearConsentSessionMirror as ae, createGtagBridge as af, decodeConsentCookie as ag, deleteConsentCookie as ah, encodeConsentCookie as ai, mapCategoriesToGtagParams as aj, readConsentCookie as ak, readConsentSessionMirror as al, useFFIDConsent as am, useFFIDConsentPreferences as an, writeConsentCookie as ao, writeConsentSessionMirror as ap, type FFIDConsentUpdate as b, type FFIDConsentCategories as c, type FFIDConsentSyncResult as d, type FFIDConsentCategoryMetadata as e, type FFIDCookiePolicy as f, type PostSyncWire as g, type PostWithdrawWire as h, CONSENT_COOKIE_NAME as i, CONSENT_SESSION_STORAGE_KEY as j, COOKIE_VERSION as k, DEFAULT_MERGE_WARNING_MESSAGES as l, DeviceIdSchema as m, FFIDAnalyticsProvider as n, type FFIDAnalyticsProviderProps as o, FFIDConsentCategoriesSchema as p, type FFIDConsentCategoryCode as q, FFIDConsentCategoryCodeSchema as r, FFIDConsentCategoryMetadataSchema as s, FFIDConsentContext as t, type FFIDConsentContextValue as u, FFIDConsentError as v, type FFIDConsentErrorCode as w, type FFIDConsentMergeStrategy as x, FFIDConsentMergeStrategySchema as y, type FFIDConsentMergeWarning as z };
+export { type GetCategoriesWire as $, ALL_DENIED_EXCEPT_NECESSARY as A, type FFIDConsentMergeWarning as B, CONSENT_COOKIE_MAX_AGE_SEC as C, DEFAULT_CONSENT_ERROR_MESSAGES as D, FFIDConsentMergeWarningSchema as E, type FFIDConsentResult as F, type GetConsentMeWire as G, type FFIDConsentSource as H, FFIDConsentSourceSchema as I, FFIDConsentStateSchema as J, FFIDConsentUpdateSchema as K, FFIDCookieBanner as L, type FFIDCookieBannerClassNames as M, type FFIDCookieBannerProps as N, FFIDCookieLink as O, type PostConsentWire as P, type FFIDCookieLinkProps as Q, FFIDCookiePolicySchema as R, FFIDCookieSettings as S, type FFIDCookieSettingsClassNames as T, type FFIDCookieSettingsProps as U, type FFIDInternalConsentSource as V, FFIDInternalConsentSourceSchema as W, type FFIDPublicConsentSource as X, FFIDPublicConsentSourceSchema as Y, FFID_CONSENT_ERROR_CODES as Z, FFID_CONSENT_NOT_DECIDED_STATE as _, type FFIDConsentState as a, GetCategoriesWireSchema as a0, GetConsentMeWireSchema as a1, type GetDocumentWire as a2, GetDocumentWireSchema as a3, type GtagBridge as a4, type GtagBridgeOptions as a5, type PostConsentRequest as a6, PostConsentRequestSchema as a7, PostConsentWireSchema as a8, type PostSyncRequest as a9, PostSyncRequestSchema as aa, PostSyncWireSchema as ab, PostWithdrawWireSchema as ac, type UseFFIDConsentPreferencesReturn as ad, type UseFFIDConsentReturn as ae, clearConsentDismissalTimestamp as af, clearConsentSessionMirror as ag, createGtagBridge as ah, decodeConsentCookie as ai, deleteConsentCookie as aj, encodeConsentCookie as ak, mapCategoriesToGtagParams as al, readConsentCookie as am, readConsentDismissalTimestamp as an, readConsentSessionMirror as ao, useFFIDConsent as ap, useFFIDConsentPreferences as aq, writeConsentCookie as ar, writeConsentDismissalTimestamp as as, writeConsentSessionMirror as at, type FFIDConsentUpdate as b, type FFIDConsentCategories as c, type FFIDConsentSyncResult as d, type FFIDConsentCategoryMetadata as e, type FFIDCookiePolicy as f, type PostSyncWire as g, type PostWithdrawWire as h, CONSENT_COOKIE_NAME as i, CONSENT_DISMISSAL_TIMESTAMP_KEY as j, CONSENT_SESSION_STORAGE_KEY as k, COOKIE_VERSION as l, DEFAULT_MERGE_WARNING_MESSAGES as m, DeviceIdSchema as n, FFIDAnalyticsProvider as o, type FFIDAnalyticsProviderProps as p, FFIDConsentCategoriesSchema as q, type FFIDConsentCategoryCode as r, FFIDConsentCategoryCodeSchema as s, FFIDConsentCategoryMetadataSchema as t, FFIDConsentContext as u, type FFIDConsentContextValue as v, FFIDConsentError as w, type FFIDConsentErrorCode as x, type FFIDConsentMergeStrategy as y, FFIDConsentMergeStrategySchema as z };

package/dist/{FFIDCookieLink-CAKupVSS.d.ts → FFIDCookieLink-DY60yHYu.d.ts}

@@ -477,6 +477,16 @@ declare const CONSENT_COOKIE_MAX_AGE_SEC: number;
  * first, then fall back to cookie. See `FFIDAnalyticsProvider.bootstrap`.
  */
 declare const CONSENT_SESSION_STORAGE_KEY = "ffid_consent_state";
+/**
+ * sessionStorage key for the dismissal timestamp ("あとで" cooldown).
+ *
+ * EDPB Guidelines 05/2020 §86 forbids treating dismissal as a refusal, so we
+ * never write this to a cookie or DB. Holding the timestamp in sessionStorage
+ * keeps it scoped to the current tab session — once the tab closes, the user
+ * is reprompted on next visit. See `FFIDAnalyticsProvider`'s
+ * `dismissalCooldownMinutes` prop for the auto-show suppression policy.
+ */
+declare const CONSENT_DISMISSAL_TIMESTAMP_KEY = "ffid_consent_dismissed_at";
 interface WriteConsentCookieOptions {
     /** Override Secure flag for non-https custom domains. Defaults to production. */
     secure?: boolean;
@@ -520,6 +530,34 @@ declare function deleteConsentCookie(opts?: WriteConsentCookieOptions): boolean;
 declare function readConsentSessionMirror(): FFIDConsentCategories | null;
 declare function writeConsentSessionMirror(cats: FFIDConsentCategories): boolean;
 declare function clearConsentSessionMirror(): void;
+/**
+ * Read the millisecond unix timestamp at which the banner was last dismissed,
+ * or `null` if absent / invalid / sessionStorage unavailable.
+ *
+ * Defensive parsing rejects non-finite values, negatives, and future-dated
+ * timestamps (clock-skew / tampering). When a corrupted value is detected,
+ * the helper **auto-heals** by clearing the slot — otherwise the same bad
+ * value would be re-parsed on every Provider mount and a buggy / extension-
+ * polluted consumer site could leave the cooldown effectively permanently
+ * disabled with no surface signal.
+ */
+declare function readConsentDismissalTimestamp(): number | null;
+/**
+ * Write the dismissal timestamp. Returns `true` on success, `false` when
+ * sessionStorage is unavailable / throws (e.g., quota, old Safari Private
+ * Browsing) **or** when `nowMs` is non-finite / negative.
+ *
+ * Callers may safely ignore the return — failure degrades to the legacy
+ * "reprompt every Provider mount" behavior, which is the published v5.1.0
+ * baseline. Dismissal carries no GDPR weight (EDPB §86) so there is no
+ * obligation to surface storage failure via `onError`.
+ */
+declare function writeConsentDismissalTimestamp(nowMs?: number): boolean;
+/**
+ * Idempotent clear of the dismissal timestamp. Safe to call when no value is
+ * present or sessionStorage is unavailable; never throws.
+ */
+declare function clearConsentDismissalTimestamp(): void;
 
 /**
  * Cookie Consent — Google Consent Mode v2 wiring.
@@ -652,11 +690,29 @@ interface FFIDAnalyticsProviderProps {
     onError?: (error: FFIDConsentError) => void;
     /** Whether to open banner automatically when no decision is on file. Default: true. */
     autoShowBanner?: boolean;
+    /**
+     * Minutes to suppress auto-reopen after the user presses "あとで" (closeBanner).
+     *
+     * The dismissal timestamp is held in `sessionStorage` only — never written
+     * to cookie or DB — so it expires when the tab closes. This is EDPB
+     * Guidelines 05/2020 §86 compliant: dismissal is not a refusal, and the
+     * user is reprompted on the next fresh visit regardless of cooldown.
+     *
+     * Accepts any `number`; non-finite (`NaN` / `±Infinity`) and negative
+     * values are treated as `0` (suppression disabled). `0` reverts to the
+     * legacy v5.1.0 "reprompt on every Provider mount" behavior. Default: 30.
+     *
+     * Manual `openBanner()` calls ignore the cooldown so consumer "Cookie 設定"
+     * links keep working, and `needsRenewal=true` overrides the cooldown so the
+     * renewal reprompt (CNIL/ICO renewal guidance — see PR #3261) is never
+     * suppressed by a UX dismissal.
+     */
+    dismissalCooldownMinutes?: number;
     /** Optional fetch override (mainly for tests). */
     fetchImpl?: typeof fetch;
     children: ReactNode;
 }
-declare function FFIDAnalyticsProvider({ baseUrl, serviceApiKey, getAccessToken, gaMeasurementId, sentryReplay, sentry, onConsentChange, onError, autoShowBanner, fetchImpl, children, }: FFIDAnalyticsProviderProps): React.JSX.Element;
+declare function FFIDAnalyticsProvider({ baseUrl, serviceApiKey, getAccessToken, gaMeasurementId, sentryReplay, sentry, onConsentChange, onError, autoShowBanner, dismissalCooldownMinutes, fetchImpl, children, }: FFIDAnalyticsProviderProps): React.JSX.Element;
 
 interface FFIDConsentContextValue {
     /** Current consent state. Always non-null; "not yet decided" is encoded by `hasDecided=false`. */
@@ -795,7 +851,14 @@ declare function useFFIDConsentPreferences(): UseFFIDConsentPreferencesReturn;
 /**
  * `<FFIDCookieBanner>` — bottom-sheet consent banner.
  *
- * Renders only when `state.hasDecided === false` or `state.needsRenewal === true`.
+ * Rendering is gated solely by `isBannerOpen` from the consent context (see
+ * `FFIDAnalyticsProvider`). The provider's bootstrap effect flips it to
+ * `true` for fresh visitors / policy-version renewal, and the banner's own
+ * buttons (or any consumer calling `closeBanner()` / `openBanner()`) flip
+ * it back. The earlier `hasDecided=false || needsRenewal=true` fallback
+ * was removed in v5.2.1 (#3289) because it overrode `setIsBannerOpen(false)`
+ * for fresh visitors and silently kept the banner mounted on "あとで" click.
+ *
  * Four buttons (spec §6.2):
  *   1. "すべて同意" (Accept all)
  *   2. "同意しない" (Necessary only — `necessary=true` is enforced by ePrivacy
@@ -916,4 +979,4 @@ interface FFIDCookieLinkProps {
 }
 declare function FFIDCookieLink({ children, className, style, id, }: FFIDCookieLinkProps): React.JSX.Element;
 
-export { GetCategoriesWireSchema as $, ALL_DENIED_EXCEPT_NECESSARY as A, FFIDConsentMergeWarningSchema as B, CONSENT_COOKIE_MAX_AGE_SEC as C, DEFAULT_CONSENT_ERROR_MESSAGES as D, type FFIDConsentSource as E, type FFIDConsentResult as F, type GetConsentMeWire as G, FFIDConsentSourceSchema as H, FFIDConsentStateSchema as I, FFIDConsentUpdateSchema as J, FFIDCookieBanner as K, type FFIDCookieBannerClassNames as L, type FFIDCookieBannerProps as M, FFIDCookieLink as N, type FFIDCookieLinkProps as O, type PostConsentWire as P, FFIDCookiePolicySchema as Q, FFIDCookieSettings as R, type FFIDCookieSettingsClassNames as S, type FFIDCookieSettingsProps as T, type FFIDInternalConsentSource as U, FFIDInternalConsentSourceSchema as V, type FFIDPublicConsentSource as W, FFIDPublicConsentSourceSchema as X, FFID_CONSENT_ERROR_CODES as Y, FFID_CONSENT_NOT_DECIDED_STATE as Z, type GetCategoriesWire as _, type FFIDConsentState as a, GetConsentMeWireSchema as a0, type GetDocumentWire as a1, GetDocumentWireSchema as a2, type GtagBridge as a3, type GtagBridgeOptions as a4, type PostConsentRequest as a5, PostConsentRequestSchema as a6, PostConsentWireSchema as a7, type PostSyncRequest as a8, PostSyncRequestSchema as a9, PostSyncWireSchema as aa, PostWithdrawWireSchema as ab, type UseFFIDConsentPreferencesReturn as ac, type UseFFIDConsentReturn as ad, clearConsentSessionMirror as ae, createGtagBridge as af, decodeConsentCookie as ag, deleteConsentCookie as ah, encodeConsentCookie as ai, mapCategoriesToGtagParams as aj, readConsentCookie as ak, readConsentSessionMirror as al, useFFIDConsent as am, useFFIDConsentPreferences as an, writeConsentCookie as ao, writeConsentSessionMirror as ap, type FFIDConsentUpdate as b, type FFIDConsentCategories as c, type FFIDConsentSyncResult as d, type FFIDConsentCategoryMetadata as e, type FFIDCookiePolicy as f, type PostSyncWire as g, type PostWithdrawWire as h, CONSENT_COOKIE_NAME as i, CONSENT_SESSION_STORAGE_KEY as j, COOKIE_VERSION as k, DEFAULT_MERGE_WARNING_MESSAGES as l, DeviceIdSchema as m, FFIDAnalyticsProvider as n, type FFIDAnalyticsProviderProps as o, FFIDConsentCategoriesSchema as p, type FFIDConsentCategoryCode as q, FFIDConsentCategoryCodeSchema as r, FFIDConsentCategoryMetadataSchema as s, FFIDConsentContext as t, type FFIDConsentContextValue as u, FFIDConsentError as v, type FFIDConsentErrorCode as w, type FFIDConsentMergeStrategy as x, FFIDConsentMergeStrategySchema as y, type FFIDConsentMergeWarning as z };
+export { type GetCategoriesWire as $, ALL_DENIED_EXCEPT_NECESSARY as A, type FFIDConsentMergeWarning as B, CONSENT_COOKIE_MAX_AGE_SEC as C, DEFAULT_CONSENT_ERROR_MESSAGES as D, FFIDConsentMergeWarningSchema as E, type FFIDConsentResult as F, type GetConsentMeWire as G, type FFIDConsentSource as H, FFIDConsentSourceSchema as I, FFIDConsentStateSchema as J, FFIDConsentUpdateSchema as K, FFIDCookieBanner as L, type FFIDCookieBannerClassNames as M, type FFIDCookieBannerProps as N, FFIDCookieLink as O, type PostConsentWire as P, type FFIDCookieLinkProps as Q, FFIDCookiePolicySchema as R, FFIDCookieSettings as S, type FFIDCookieSettingsClassNames as T, type FFIDCookieSettingsProps as U, type FFIDInternalConsentSource as V, FFIDInternalConsentSourceSchema as W, type FFIDPublicConsentSource as X, FFIDPublicConsentSourceSchema as Y, FFID_CONSENT_ERROR_CODES as Z, FFID_CONSENT_NOT_DECIDED_STATE as _, type FFIDConsentState as a, GetCategoriesWireSchema as a0, GetConsentMeWireSchema as a1, type GetDocumentWire as a2, GetDocumentWireSchema as a3, type GtagBridge as a4, type GtagBridgeOptions as a5, type PostConsentRequest as a6, PostConsentRequestSchema as a7, PostConsentWireSchema as a8, type PostSyncRequest as a9, PostSyncRequestSchema as aa, PostSyncWireSchema as ab, PostWithdrawWireSchema as ac, type UseFFIDConsentPreferencesReturn as ad, type UseFFIDConsentReturn as ae, clearConsentDismissalTimestamp as af, clearConsentSessionMirror as ag, createGtagBridge as ah, decodeConsentCookie as ai, deleteConsentCookie as aj, encodeConsentCookie as ak, mapCategoriesToGtagParams as al, readConsentCookie as am, readConsentDismissalTimestamp as an, readConsentSessionMirror as ao, useFFIDConsent as ap, useFFIDConsentPreferences as aq, writeConsentCookie as ar, writeConsentDismissalTimestamp as as, writeConsentSessionMirror as at, type FFIDConsentUpdate as b, type FFIDConsentCategories as c, type FFIDConsentSyncResult as d, type FFIDConsentCategoryMetadata as e, type FFIDCookiePolicy as f, type PostSyncWire as g, type PostWithdrawWire as h, CONSENT_COOKIE_NAME as i, CONSENT_DISMISSAL_TIMESTAMP_KEY as j, CONSENT_SESSION_STORAGE_KEY as k, COOKIE_VERSION as l, DEFAULT_MERGE_WARNING_MESSAGES as m, DeviceIdSchema as n, FFIDAnalyticsProvider as o, type FFIDAnalyticsProviderProps as p, FFIDConsentCategoriesSchema as q, type FFIDConsentCategoryCode as r, FFIDConsentCategoryCodeSchema as s, FFIDConsentCategoryMetadataSchema as t, FFIDConsentContext as u, type FFIDConsentContextValue as v, FFIDConsentError as w, type FFIDConsentErrorCode as x, type FFIDConsentMergeStrategy as y, FFIDConsentMergeStrategySchema as z };

package/dist/{chunk-Y4JGEGPS.js → chunk-GBQGMXBM.js}

@@ -838,7 +838,7 @@ function createProfileMethods(deps) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "5.1.0";
+var SDK_VERSION = "5.2.1";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {

package/dist/{chunk-VVACPX7Q.js → chunk-UWU2757V.js}

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { createContext, useState, useRef, useCallback, useEffect, useMemo, useContext } from 'react';
+import { createContext, useCallback, useState, useRef, useEffect, useMemo, useContext } from 'react';
 import { jsx, jsxs } from 'react/jsx-runtime';
 
 var FFIDConsentCategoryCodeSchema = z.enum([
@@ -282,6 +282,7 @@ var HOURS_PER_DAY = 24;
 var DAYS_PER_YEAR = 365;
 var CONSENT_COOKIE_MAX_AGE_SEC = SECONDS_PER_MINUTE * MINUTES_PER_HOUR * HOURS_PER_DAY * DAYS_PER_YEAR;
 var CONSENT_SESSION_STORAGE_KEY = "ffid_consent_state";
+var CONSENT_DISMISSAL_TIMESTAMP_KEY = "ffid_consent_dismissed_at";
 function hasDocument() {
   return typeof document !== "undefined";
 }
@@ -372,6 +373,39 @@ function clearConsentSessionMirror() {
   } catch {
   }
 }
+function readConsentDismissalTimestamp() {
+  if (!hasSessionStorage()) return null;
+  try {
+    const raw = sessionStorage.getItem(CONSENT_DISMISSAL_TIMESTAMP_KEY);
+    if (!raw) return null;
+    const parsed = Number(raw);
+    const CLOCK_SKEW_GRACE_MS = 6e4;
+    if (!Number.isFinite(parsed) || parsed < 0 || parsed > Date.now() + CLOCK_SKEW_GRACE_MS) {
+      clearConsentDismissalTimestamp();
+      return null;
+    }
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+function writeConsentDismissalTimestamp(nowMs = Date.now()) {
+  if (!Number.isFinite(nowMs) || nowMs < 0) return false;
+  if (!hasSessionStorage()) return false;
+  try {
+    sessionStorage.setItem(CONSENT_DISMISSAL_TIMESTAMP_KEY, String(nowMs));
+    return true;
+  } catch {
+    return false;
+  }
+}
+function clearConsentDismissalTimestamp() {
+  if (!hasSessionStorage()) return;
+  try {
+    sessionStorage.removeItem(CONSENT_DISMISSAL_TIMESTAMP_KEY);
+  } catch {
+  }
+}
 
 // src/consent/storage/device-id.ts
 var DEVICE_ID_LOCAL_STORAGE_KEY = "ffid_device_id";
@@ -1012,6 +1046,8 @@ var DEFAULT_MERGE_WARNING_MESSAGES = {
   shared_device_detected: "\u3053\u306E\u7AEF\u672B\u306F\u5225\u306E\u30A2\u30AB\u30A6\u30F3\u30C8\u3067\u3082\u4F7F\u7528\u3055\u308C\u3066\u3044\u307E\u3059\u3002Cookie \u8A2D\u5B9A\u306F\u30A2\u30AB\u30A6\u30F3\u30C8\u3054\u3068\u306B\u4FDD\u5B58\u3055\u308C\u3066\u3044\u307E\u3059",
   drift_detected: "\u4FDD\u5B58\u3055\u308C\u3066\u3044\u305F\u8A2D\u5B9A\u3068\u7570\u306A\u308B\u9805\u76EE\u304C\u3042\u3063\u305F\u305F\u3081\u3001\u65B0\u3057\u304F\u8A18\u9332\u3055\u308C\u307E\u3057\u305F"
 };
+var DEFAULT_DISMISSAL_COOLDOWN_MINUTES = 30;
+var MS_PER_MINUTE = 6e4;
 function applyChanges(base, changes) {
   return {
     necessary: true,
@@ -1030,9 +1066,17 @@ function FFIDAnalyticsProvider({
   onConsentChange,
   onError,
   autoShowBanner = true,
+  dismissalCooldownMinutes = DEFAULT_DISMISSAL_COOLDOWN_MINUTES,
   fetchImpl,
   children
 }) {
+  const cooldownMs = Number.isFinite(dismissalCooldownMinutes) && dismissalCooldownMinutes > 0 ? dismissalCooldownMinutes * MS_PER_MINUTE : 0;
+  const isWithinDismissalCooldown = useCallback(() => {
+    if (cooldownMs <= 0) return false;
+    const dismissedAt = readConsentDismissalTimestamp();
+    if (dismissedAt === null) return false;
+    return Date.now() - dismissedAt < cooldownMs;
+  }, [cooldownMs]);
   const [state, setState] = useState(
     FFID_CONSENT_NOT_DECIDED_STATE
   );
@@ -1143,7 +1187,7 @@ function FFIDAnalyticsProvider({
       applyCategoriesSideEffects(result.value.categories);
       writeConsentSessionMirror(result.value.categories);
       setIsLoading(false);
-      if (!result.value.hasDecided && autoShowBanner) {
+      if (!result.value.hasDecided && autoShowBanner && !isWithinDismissalCooldown()) {
         setIsBannerOpen(true);
       }
       if (result.value.needsRenewal && autoShowBanner) {
@@ -1271,7 +1315,10 @@ function FFIDAnalyticsProvider({
     persistCategories
   ]);
   const openBanner = useCallback(() => setIsBannerOpen(true), []);
-  const closeBanner = useCallback(() => setIsBannerOpen(false), []);
+  const closeBanner = useCallback(() => {
+    if (cooldownMs > 0) writeConsentDismissalTimestamp();
+    setIsBannerOpen(false);
+  }, [cooldownMs]);
   const openPreferences = useCallback(async () => {
     if (!categoryMetadata) {
       const client = clientRef.current;
@@ -1405,7 +1452,6 @@ function FFIDCookieBanner({
   style
 }) {
   const {
-    state,
     isBannerOpen,
     acceptAll,
     acceptNecessaryOnly,
@@ -1413,7 +1459,7 @@ function FFIDCookieBanner({
     closeBanner,
     error
   } = useFFIDConsent();
-  if (!isBannerOpen && state.hasDecided && !state.needsRenewal) return null;
+  if (!isBannerOpen) return null;
   return /* @__PURE__ */ jsxs(
     "div",
     {
@@ -1790,4 +1836,4 @@ function FFIDCookieLink({
   );
 }
 
-export { ALL_DENIED_EXCEPT_NECESSARY, CONSENT_COOKIE_MAX_AGE_SEC, CONSENT_COOKIE_NAME, CONSENT_SESSION_STORAGE_KEY, COOKIE_VERSION, DEFAULT_CONSENT_ERROR_MESSAGES, DEFAULT_MERGE_WARNING_MESSAGES, DEVICE_ID_LOCAL_STORAGE_KEY, DEVICE_ID_SESSION_STORAGE_KEY, DeviceIdSchema, FFIDAnalyticsProvider, FFIDConsentCategoriesSchema, FFIDConsentCategoryCodeSchema, FFIDConsentCategoryMetadataSchema, FFIDConsentContext, FFIDConsentError, FFIDConsentMergeStrategySchema, FFIDConsentMergeWarningSchema, FFIDConsentSourceSchema, FFIDConsentStateSchema, FFIDConsentUpdateSchema, FFIDCookieBanner, FFIDCookieLink, FFIDCookiePolicySchema, FFIDCookieSettings, FFIDInternalConsentSourceSchema, FFIDPublicConsentSourceSchema, FFID_CONSENT_ERROR_CODES, FFID_CONSENT_NOT_DECIDED_STATE, GetCategoriesWireSchema, GetConsentMeWireSchema, GetDocumentWireSchema, PostConsentRequestSchema, PostConsentWireSchema, PostSyncRequestSchema, PostSyncWireSchema, PostWithdrawWireSchema, clearConsentSessionMirror, clearDeviceId, createConsentClient, createGtagBridge, decodeConsentCookie, deleteConsentCookie, encodeConsentCookie, generateDeviceId, getOrCreateDeviceId, isUuidV7, isValidDeviceId, mapCategoriesToGtagParams, mapConsentWireToState, mapMeWireToState, mapSyncWireToResult, mapWithdrawWireToState, readConsentCookie, readConsentSessionMirror, useFFIDConsent, useFFIDConsentPreferences, writeConsentCookie, writeConsentSessionMirror };
+export { ALL_DENIED_EXCEPT_NECESSARY, CONSENT_COOKIE_MAX_AGE_SEC, CONSENT_COOKIE_NAME, CONSENT_DISMISSAL_TIMESTAMP_KEY, CONSENT_SESSION_STORAGE_KEY, COOKIE_VERSION, DEFAULT_CONSENT_ERROR_MESSAGES, DEFAULT_MERGE_WARNING_MESSAGES, DEVICE_ID_LOCAL_STORAGE_KEY, DEVICE_ID_SESSION_STORAGE_KEY, DeviceIdSchema, FFIDAnalyticsProvider, FFIDConsentCategoriesSchema, FFIDConsentCategoryCodeSchema, FFIDConsentCategoryMetadataSchema, FFIDConsentContext, FFIDConsentError, FFIDConsentMergeStrategySchema, FFIDConsentMergeWarningSchema, FFIDConsentSourceSchema, FFIDConsentStateSchema, FFIDConsentUpdateSchema, FFIDCookieBanner, FFIDCookieLink, FFIDCookiePolicySchema, FFIDCookieSettings, FFIDInternalConsentSourceSchema, FFIDPublicConsentSourceSchema, FFID_CONSENT_ERROR_CODES, FFID_CONSENT_NOT_DECIDED_STATE, GetCategoriesWireSchema, GetConsentMeWireSchema, GetDocumentWireSchema, PostConsentRequestSchema, PostConsentWireSchema, PostSyncRequestSchema, PostSyncWireSchema, PostWithdrawWireSchema, clearConsentDismissalTimestamp, clearConsentSessionMirror, clearDeviceId, createConsentClient, createGtagBridge, decodeConsentCookie, deleteConsentCookie, encodeConsentCookie, generateDeviceId, getOrCreateDeviceId, isUuidV7, isValidDeviceId, mapCategoriesToGtagParams, mapConsentWireToState, mapMeWireToState, mapSyncWireToResult, mapWithdrawWireToState, readConsentCookie, readConsentDismissalTimestamp, readConsentSessionMirror, useFFIDConsent, useFFIDConsentPreferences, writeConsentCookie, writeConsentDismissalTimestamp, writeConsentSessionMirror };

package/dist/{chunk-5AJFDSMG.cjs → chunk-W2FNRQKT.cjs}

@@ -284,6 +284,7 @@ var HOURS_PER_DAY = 24;
 var DAYS_PER_YEAR = 365;
 var CONSENT_COOKIE_MAX_AGE_SEC = SECONDS_PER_MINUTE * MINUTES_PER_HOUR * HOURS_PER_DAY * DAYS_PER_YEAR;
 var CONSENT_SESSION_STORAGE_KEY = "ffid_consent_state";
+var CONSENT_DISMISSAL_TIMESTAMP_KEY = "ffid_consent_dismissed_at";
 function hasDocument() {
   return typeof document !== "undefined";
 }
@@ -374,6 +375,39 @@ function clearConsentSessionMirror() {
   } catch {
   }
 }
+function readConsentDismissalTimestamp() {
+  if (!hasSessionStorage()) return null;
+  try {
+    const raw = sessionStorage.getItem(CONSENT_DISMISSAL_TIMESTAMP_KEY);
+    if (!raw) return null;
+    const parsed = Number(raw);
+    const CLOCK_SKEW_GRACE_MS = 6e4;
+    if (!Number.isFinite(parsed) || parsed < 0 || parsed > Date.now() + CLOCK_SKEW_GRACE_MS) {
+      clearConsentDismissalTimestamp();
+      return null;
+    }
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+function writeConsentDismissalTimestamp(nowMs = Date.now()) {
+  if (!Number.isFinite(nowMs) || nowMs < 0) return false;
+  if (!hasSessionStorage()) return false;
+  try {
+    sessionStorage.setItem(CONSENT_DISMISSAL_TIMESTAMP_KEY, String(nowMs));
+    return true;
+  } catch {
+    return false;
+  }
+}
+function clearConsentDismissalTimestamp() {
+  if (!hasSessionStorage()) return;
+  try {
+    sessionStorage.removeItem(CONSENT_DISMISSAL_TIMESTAMP_KEY);
+  } catch {
+  }
+}
 
 // src/consent/storage/device-id.ts
 var DEVICE_ID_LOCAL_STORAGE_KEY = "ffid_device_id";
@@ -1014,6 +1048,8 @@ var DEFAULT_MERGE_WARNING_MESSAGES = {
   shared_device_detected: "\u3053\u306E\u7AEF\u672B\u306F\u5225\u306E\u30A2\u30AB\u30A6\u30F3\u30C8\u3067\u3082\u4F7F\u7528\u3055\u308C\u3066\u3044\u307E\u3059\u3002Cookie \u8A2D\u5B9A\u306F\u30A2\u30AB\u30A6\u30F3\u30C8\u3054\u3068\u306B\u4FDD\u5B58\u3055\u308C\u3066\u3044\u307E\u3059",
   drift_detected: "\u4FDD\u5B58\u3055\u308C\u3066\u3044\u305F\u8A2D\u5B9A\u3068\u7570\u306A\u308B\u9805\u76EE\u304C\u3042\u3063\u305F\u305F\u3081\u3001\u65B0\u3057\u304F\u8A18\u9332\u3055\u308C\u307E\u3057\u305F"
 };
+var DEFAULT_DISMISSAL_COOLDOWN_MINUTES = 30;
+var MS_PER_MINUTE = 6e4;
 function applyChanges(base, changes) {
   return {
     necessary: true,
@@ -1032,9 +1068,17 @@ function FFIDAnalyticsProvider({
   onConsentChange,
   onError,
   autoShowBanner = true,
+  dismissalCooldownMinutes = DEFAULT_DISMISSAL_COOLDOWN_MINUTES,
   fetchImpl,
   children
 }) {
+  const cooldownMs = Number.isFinite(dismissalCooldownMinutes) && dismissalCooldownMinutes > 0 ? dismissalCooldownMinutes * MS_PER_MINUTE : 0;
+  const isWithinDismissalCooldown = react.useCallback(() => {
+    if (cooldownMs <= 0) return false;
+    const dismissedAt = readConsentDismissalTimestamp();
+    if (dismissedAt === null) return false;
+    return Date.now() - dismissedAt < cooldownMs;
+  }, [cooldownMs]);
   const [state, setState] = react.useState(
     FFID_CONSENT_NOT_DECIDED_STATE
   );
@@ -1145,7 +1189,7 @@ function FFIDAnalyticsProvider({
       applyCategoriesSideEffects(result.value.categories);
       writeConsentSessionMirror(result.value.categories);
       setIsLoading(false);
-      if (!result.value.hasDecided && autoShowBanner) {
+      if (!result.value.hasDecided && autoShowBanner && !isWithinDismissalCooldown()) {
         setIsBannerOpen(true);
       }
       if (result.value.needsRenewal && autoShowBanner) {
@@ -1273,7 +1317,10 @@ function FFIDAnalyticsProvider({
     persistCategories
   ]);
   const openBanner = react.useCallback(() => setIsBannerOpen(true), []);
-  const closeBanner = react.useCallback(() => setIsBannerOpen(false), []);
+  const closeBanner = react.useCallback(() => {
+    if (cooldownMs > 0) writeConsentDismissalTimestamp();
+    setIsBannerOpen(false);
+  }, [cooldownMs]);
   const openPreferences = react.useCallback(async () => {
     if (!categoryMetadata) {
       const client = clientRef.current;
@@ -1407,7 +1454,6 @@ function FFIDCookieBanner({
   style
 }) {
   const {
-    state,
     isBannerOpen,
     acceptAll,
     acceptNecessaryOnly,
@@ -1415,7 +1461,7 @@ function FFIDCookieBanner({
     closeBanner,
     error
   } = useFFIDConsent();
-  if (!isBannerOpen && state.hasDecided && !state.needsRenewal) return null;
+  if (!isBannerOpen) return null;
   return /* @__PURE__ */ jsxRuntime.jsxs(
     "div",
     {
@@ -1795,6 +1841,7 @@ function FFIDCookieLink({
 exports.ALL_DENIED_EXCEPT_NECESSARY = ALL_DENIED_EXCEPT_NECESSARY;
 exports.CONSENT_COOKIE_MAX_AGE_SEC = CONSENT_COOKIE_MAX_AGE_SEC;
 exports.CONSENT_COOKIE_NAME = CONSENT_COOKIE_NAME;
+exports.CONSENT_DISMISSAL_TIMESTAMP_KEY = CONSENT_DISMISSAL_TIMESTAMP_KEY;
 exports.CONSENT_SESSION_STORAGE_KEY = CONSENT_SESSION_STORAGE_KEY;
 exports.COOKIE_VERSION = COOKIE_VERSION;
 exports.DEFAULT_CONSENT_ERROR_MESSAGES = DEFAULT_CONSENT_ERROR_MESSAGES;
@@ -1829,6 +1876,7 @@ exports.PostConsentWireSchema = PostConsentWireSchema;
 exports.PostSyncRequestSchema = PostSyncRequestSchema;
 exports.PostSyncWireSchema = PostSyncWireSchema;
 exports.PostWithdrawWireSchema = PostWithdrawWireSchema;
+exports.clearConsentDismissalTimestamp = clearConsentDismissalTimestamp;
 exports.clearConsentSessionMirror = clearConsentSessionMirror;
 exports.clearDeviceId = clearDeviceId;
 exports.createConsentClient = createConsentClient;
@@ -1846,8 +1894,10 @@ exports.mapMeWireToState = mapMeWireToState;
 exports.mapSyncWireToResult = mapSyncWireToResult;
 exports.mapWithdrawWireToState = mapWithdrawWireToState;
 exports.readConsentCookie = readConsentCookie;
+exports.readConsentDismissalTimestamp = readConsentDismissalTimestamp;
 exports.readConsentSessionMirror = readConsentSessionMirror;
 exports.useFFIDConsent = useFFIDConsent;
 exports.useFFIDConsentPreferences = useFFIDConsentPreferences;
 exports.writeConsentCookie = writeConsentCookie;
+exports.writeConsentDismissalTimestamp = writeConsentDismissalTimestamp;
 exports.writeConsentSessionMirror = writeConsentSessionMirror;

package/dist/{chunk-7IOAHDFM.cjs → chunk-Z4D37JR3.cjs}

@@ -840,7 +840,7 @@ function createProfileMethods(deps) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "5.1.0";
+var SDK_VERSION = "5.2.1";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {

package/dist/components/index.cjs

@@ -1,34 +1,34 @@
 'use strict';
 
-var chunk7IOAHDFM_cjs = require('../chunk-7IOAHDFM.cjs');
+var chunkZ4D37JR3_cjs = require('../chunk-Z4D37JR3.cjs');
 
 
 
 Object.defineProperty(exports, "FFIDAnnouncementBadge", {
   enumerable: true,
-  get: function () { return chunk7IOAHDFM_cjs.FFIDAnnouncementBadge; }
+  get: function () { return chunkZ4D37JR3_cjs.FFIDAnnouncementBadge; }
 });
 Object.defineProperty(exports, "FFIDAnnouncementList", {
   enumerable: true,
-  get: function () { return chunk7IOAHDFM_cjs.FFIDAnnouncementList; }
+  get: function () { return chunkZ4D37JR3_cjs.FFIDAnnouncementList; }
 });
 Object.defineProperty(exports, "FFIDInquiryForm", {
   enumerable: true,
-  get: function () { return chunk7IOAHDFM_cjs.FFIDInquiryForm; }
+  get: function () { return chunkZ4D37JR3_cjs.FFIDInquiryForm; }
 });
 Object.defineProperty(exports, "FFIDLoginButton", {
   enumerable: true,
-  get: function () { return chunk7IOAHDFM_cjs.FFIDLoginButton; }
+  get: function () { return chunkZ4D37JR3_cjs.FFIDLoginButton; }
 });
 Object.defineProperty(exports, "FFIDOrganizationSwitcher", {
   enumerable: true,
-  get: function () { return chunk7IOAHDFM_cjs.FFIDOrganizationSwitcher; }
+  get: function () { return chunkZ4D37JR3_cjs.FFIDOrganizationSwitcher; }
 });
 Object.defineProperty(exports, "FFIDSubscriptionBadge", {
   enumerable: true,
-  get: function () { return chunk7IOAHDFM_cjs.FFIDSubscriptionBadge; }
+  get: function () { return chunkZ4D37JR3_cjs.FFIDSubscriptionBadge; }
 });
 Object.defineProperty(exports, "FFIDUserMenu", {
   enumerable: true,
-  get: function () { return chunk7IOAHDFM_cjs.FFIDUserMenu; }
+  get: function () { return chunkZ4D37JR3_cjs.FFIDUserMenu; }
 });

package/dist/components/index.js

@@ -1 +1 @@
-export { FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDInquiryForm, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDSubscriptionBadge, FFIDUserMenu } from '../chunk-Y4JGEGPS.js';
+export { FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDInquiryForm, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDSubscriptionBadge, FFIDUserMenu } from '../chunk-GBQGMXBM.js';