<?php
/**
 * Known cookies database.
 *
 * This file contains a curated list of commonly used cookies with their
 * suggested consent categories. When a scan detects a cookie from this
 * list, the category is automatically populated.
 *
 * Cookie patterns support:
 * - Exact match: 'cookie_name'
 * - Prefix match: 'cookie_prefix_*' (matches cookie_prefix_anything)
 * - Suffix match: '*_cookie_suffix' (matches anything_cookie_suffix)
 *
 * Categories:
 * - required: Essential cookies (always allowed, cannot be disabled)
 * - statistics: Analytics and tracking (e.g., Google Analytics)
 * - statistics-anonymous: Anonymized statistics (e.g., privacy-friendly analytics)
 * - marketing: Advertising and marketing (e.g., Facebook Pixel, Google Ads)
 * - preferences: User preferences and personalization
 * - unclassified: Not yet categorized (blocked by default)
 *
 * @package AdSimple\CookieManager
 */

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

return [
	// =========================================================================
	// GOOGLE ANALYTICS & TAG MANAGER
	// =========================================================================
	'_ga'             => [
		'name'     => 'Google Analytics',
		'category' => 'statistics',
		'provider' => 'Google LLC',
		'purpose'  => 'Used to distinguish users for analytics.',
		'expires'  => '2 years',
	],
	'_ga_*'           => [
		'name'     => 'Google Analytics 4',
		'category' => 'statistics',
		'provider' => 'Google LLC',
		'purpose'  => 'Used to persist session state for GA4.',
		'expires'  => '2 years',
	],
	'_gid'            => [
		'name'     => 'Google Analytics',
		'category' => 'statistics',
		'provider' => 'Google LLC',
		'purpose'  => 'Used to distinguish users for analytics.',
		'expires'  => '24 hours',
	],
	'_gat'            => [
		'name'     => 'Google Analytics',
		'category' => 'statistics',
		'provider' => 'Google LLC',
		'purpose'  => 'Used to throttle request rate.',
		'expires'  => '1 minute',
	],
	'_gat_*'          => [
		'name'     => 'Google Analytics',
		'category' => 'statistics',
		'provider' => 'Google LLC',
		'purpose'  => 'Used to throttle request rate.',
		'expires'  => '1 minute',
	],
	'__utma'          => [
		'name'     => 'Google Analytics (Classic)',
		'category' => 'statistics',
		'provider' => 'Google LLC',
		'purpose'  => 'Used to distinguish users and sessions.',
		'expires'  => '2 years',
	],
	'__utmb'          => [
		'name'     => 'Google Analytics (Classic)',
		'category' => 'statistics',
		'provider' => 'Google LLC',
		'purpose'  => 'Used to determine new sessions/visits.',
		'expires'  => '30 minutes',
	],
	'__utmc'          => [
		'name'     => 'Google Analytics (Classic)',
		'category' => 'statistics',
		'provider' => 'Google LLC',
		'purpose'  => 'Used with __utmb to determine if new session.',
		'expires'  => 'Session',
	],
	'__utmz'          => [
		'name'     => 'Google Analytics (Classic)',
		'category' => 'statistics',
		'provider' => 'Google LLC',
		'purpose'  => 'Stores the traffic source or campaign.',
		'expires'  => '6 months',
	],
	'__utmv'          => [
		'name'     => 'Google Analytics (Classic)',
		'category' => 'statistics',
		'provider' => 'Google LLC',
		'purpose'  => 'Used to store visitor-level custom variable data.',
		'expires'  => '2 years',
	],
	'_gcl_au'         => [
		'name'     => 'Google Ads Conversion Linker',
		'category' => 'marketing',
		'provider' => 'Google LLC',
		'purpose'  => 'Used to store and track conversions.',
		'expires'  => '90 days',
	],
	'_gac_*'          => [
		'name'     => 'Google Ads Conversion',
		'category' => 'marketing',
		'provider' => 'Google LLC',
		'purpose'  => 'Contains campaign related information.',
		'expires'  => '90 days',
	],

	// =========================================================================
	// FACEBOOK / META
	// =========================================================================
	'_fbp'            => [
		'name'     => 'Facebook Pixel',
		'category' => 'marketing',
		'provider' => 'Meta Platforms Inc',
		'purpose'  => 'Used to deliver, measure and improve ads.',
		'expires'  => '3 months',
	],
	'_fbc'            => [
		'name'     => 'Facebook Click ID',
		'category' => 'marketing',
		'provider' => 'Meta Platforms Inc',
		'purpose'  => 'Stores the Facebook click identifier.',
		'expires'  => '3 months',
	],
	'fr'              => [
		'name'     => 'Facebook',
		'category' => 'marketing',
		'provider' => 'Meta Platforms Inc',
		'purpose'  => 'Used for advertising and analytics.',
		'expires'  => '3 months',
	],
	'tr'              => [
		'name'     => 'Facebook Pixel',
		'category' => 'marketing',
		'provider' => 'Meta Platforms Inc',
		'purpose'  => 'Used by Facebook for tracking.',
		'expires'  => 'Session',
	],

	// =========================================================================
	// HOTJAR
	// =========================================================================
	'_hjSessionUser_*' => [
		'name'     => 'Hotjar',
		'category' => 'statistics',
		'provider' => 'Hotjar Ltd',
		'purpose'  => 'Set when a user first lands on a page with the Hotjar script.',
		'expires'  => '1 year',
	],
	'_hjSession_*'    => [
		'name'     => 'Hotjar',
		'category' => 'statistics',
		'provider' => 'Hotjar Ltd',
		'purpose'  => 'Holds current session data.',
		'expires'  => '30 minutes',
	],
	'_hjid'           => [
		'name'     => 'Hotjar',
		'category' => 'statistics',
		'provider' => 'Hotjar Ltd',
		'purpose'  => 'Set when a user first lands on a page.',
		'expires'  => '1 year',
	],
	'_hjFirstSeen'    => [
		'name'     => 'Hotjar',
		'category' => 'statistics',
		'provider' => 'Hotjar Ltd',
		'purpose'  => 'Identifies new user\'s first session.',
		'expires'  => 'Session',
	],
	'_hjIncludedInSessionSample*' => [
		'name'     => 'Hotjar',
		'category' => 'statistics',
		'provider' => 'Hotjar Ltd',
		'purpose'  => 'Set to determine if the user is in a sample.',
		'expires'  => '2 minutes',
	],
	'_hjAbsoluteSessionInProgress' => [
		'name'     => 'Hotjar',
		'category' => 'statistics',
		'provider' => 'Hotjar Ltd',
		'purpose'  => 'Used to detect the first pageview session.',
		'expires'  => '30 minutes',
	],

	// =========================================================================
	// MICROSOFT CLARITY
	// =========================================================================
	'_clck'           => [
		'name'     => 'Microsoft Clarity',
		'category' => 'statistics',
		'provider' => 'Microsoft Corporation',
		'purpose'  => 'Persists the Clarity User ID and preferences.',
		'expires'  => '1 year',
	],
	'_clsk'           => [
		'name'     => 'Microsoft Clarity',
		'category' => 'statistics',
		'provider' => 'Microsoft Corporation',
		'purpose'  => 'Connects multiple page views for session replay.',
		'expires'  => '1 day',
	],
	'CLID'            => [
		'name'     => 'Microsoft Clarity',
		'category' => 'statistics',
		'provider' => 'Microsoft Corporation',
		'purpose'  => 'Identifies first-time Clarity users.',
		'expires'  => '1 year',
	],

	// =========================================================================
	// LINKEDIN
	// =========================================================================
	'li_gc'           => [
		'name'     => 'LinkedIn',
		'category' => 'marketing',
		'provider' => 'LinkedIn Corporation',
		'purpose'  => 'Stores consent of guests regarding use of cookies.',
		'expires'  => '6 months',
	],
	'lidc'            => [
		'name'     => 'LinkedIn',
		'category' => 'marketing',
		'provider' => 'LinkedIn Corporation',
		'purpose'  => 'Used for routing.',
		'expires'  => '24 hours',
	],
	'bcookie'         => [
		'name'     => 'LinkedIn',
		'category' => 'marketing',
		'provider' => 'LinkedIn Corporation',
		'purpose'  => 'Browser identifier cookie.',
		'expires'  => '1 year',
	],
	'bscookie'        => [
		'name'     => 'LinkedIn',
		'category' => 'marketing',
		'provider' => 'LinkedIn Corporation',
		'purpose'  => 'Secure browser identifier cookie.',
		'expires'  => '1 year',
	],
	'li_sugr'         => [
		'name'     => 'LinkedIn Insight Tag',
		'category' => 'marketing',
		'provider' => 'LinkedIn Corporation',
		'purpose'  => 'Used for tracking conversions.',
		'expires'  => '90 days',
	],
	'UserMatchHistory' => [
		'name'     => 'LinkedIn',
		'category' => 'marketing',
		'provider' => 'LinkedIn Corporation',
		'purpose'  => 'LinkedIn Ads ID syncing.',
		'expires'  => '30 days',
	],
	'AnalyticsSyncHistory' => [
		'name'     => 'LinkedIn',
		'category' => 'marketing',
		'provider' => 'LinkedIn Corporation',
		'purpose'  => 'Used to store analytics sync.',
		'expires'  => '30 days',
	],
	'lms_analytics'   => [
		'name'     => 'LinkedIn',
		'category' => 'marketing',
		'provider' => 'LinkedIn Corporation',
		'purpose'  => 'Used to identify LinkedIn Members off LinkedIn.',
		'expires'  => '30 days',
	],
	'lms_ads'         => [
		'name'     => 'LinkedIn',
		'category' => 'marketing',
		'provider' => 'LinkedIn Corporation',
		'purpose'  => 'Used for ad targeting.',
		'expires'  => '30 days',
	],

	// =========================================================================
	// TWITTER / X
	// =========================================================================
	'personalization_id' => [
		'name'     => 'Twitter/X',
		'category' => 'marketing',
		'provider' => 'X Corp',
		'purpose'  => 'Used for advertising and analytics.',
		'expires'  => '2 years',
	],
	'guest_id'        => [
		'name'     => 'Twitter/X',
		'category' => 'marketing',
		'provider' => 'X Corp',
		'purpose'  => 'Identifies user as a guest.',
		'expires'  => '2 years',
	],
	'guest_id_ads'    => [
		'name'     => 'Twitter/X',
		'category' => 'marketing',
		'provider' => 'X Corp',
		'purpose'  => 'Used for advertising.',
		'expires'  => '2 years',
	],
	'guest_id_marketing' => [
		'name'     => 'Twitter/X',
		'category' => 'marketing',
		'provider' => 'X Corp',
		'purpose'  => 'Used for marketing.',
		'expires'  => '2 years',
	],
	'muc_ads'         => [
		'name'     => 'Twitter/X',
		'category' => 'marketing',
		'provider' => 'X Corp',
		'purpose'  => 'Used for advertising.',
		'expires'  => '2 years',
	],

	// =========================================================================
	// PINTEREST
	// =========================================================================
	'_pinterest_ct_ua' => [
		'name'     => 'Pinterest',
		'category' => 'marketing',
		'provider' => 'Pinterest Inc',
		'purpose'  => 'Used for tracking conversions.',
		'expires'  => '1 year',
	],
	'_pin_unauth'     => [
		'name'     => 'Pinterest',
		'category' => 'marketing',
		'provider' => 'Pinterest Inc',
		'purpose'  => 'Groups actions for unauthenticated users.',
		'expires'  => '1 year',
	],

	// =========================================================================
	// TIKTOK
	// =========================================================================
	'_ttp'            => [
		'name'     => 'TikTok',
		'category' => 'marketing',
		'provider' => 'ByteDance Ltd',
		'purpose'  => 'Used to measure and improve the performance of ad campaigns.',
		'expires'  => '13 months',
	],
	'_tt_enable_cookie' => [
		'name'     => 'TikTok',
		'category' => 'marketing',
		'provider' => 'ByteDance Ltd',
		'purpose'  => 'Used to identify visitors for advertising.',
		'expires'  => '13 months',
	],

	// =========================================================================
	// HUBSPOT
	// =========================================================================
	'__hssc'          => [
		'name'     => 'HubSpot',
		'category' => 'marketing',
		'provider' => 'HubSpot Inc',
		'purpose'  => 'Tracks sessions.',
		'expires'  => '30 minutes',
	],
	'__hssrc'         => [
		'name'     => 'HubSpot',
		'category' => 'marketing',
		'provider' => 'HubSpot Inc',
		'purpose'  => 'Determines if the user has restarted their browser.',
		'expires'  => 'Session',
	],
	'__hstc'          => [
		'name'     => 'HubSpot',
		'category' => 'marketing',
		'provider' => 'HubSpot Inc',
		'purpose'  => 'Main cookie for tracking visitors.',
		'expires'  => '13 months',
	],
	'hubspotutk'      => [
		'name'     => 'HubSpot',
		'category' => 'marketing',
		'provider' => 'HubSpot Inc',
		'purpose'  => 'Keeps track of a visitor\'s identity.',
		'expires'  => '13 months',
	],

	// =========================================================================
	// STRIPE (Required for payments)
	// =========================================================================
	'__stripe_mid'    => [
		'name'     => 'Stripe',
		'category' => 'required',
		'provider' => 'Stripe Inc',
		'purpose'  => 'Fraud prevention.',
		'expires'  => '1 year',
	],
	'__stripe_sid'    => [
		'name'     => 'Stripe',
		'category' => 'required',
		'provider' => 'Stripe Inc',
		'purpose'  => 'Fraud prevention.',
		'expires'  => '30 minutes',
	],

	// =========================================================================
	// PAYPAL (Required for payments)
	// =========================================================================
	'paypal_*'        => [
		'name'     => 'PayPal',
		'category' => 'required',
		'provider' => 'PayPal Holdings Inc',
		'purpose'  => 'Used for payment processing.',
		'expires'  => 'Varies',
	],

	// =========================================================================
	// WORDPRESS / WOOCOMMERCE (Required)
	// =========================================================================
	'wordpress_*'     => [
		'name'     => 'WordPress',
		'category' => 'required',
		'provider' => 'WordPress',
		'purpose'  => 'Used for authentication.',
		'expires'  => 'Session',
	],
	'wp-settings-*'   => [
		'name'     => 'WordPress',
		'category' => 'required',
		'provider' => 'WordPress',
		'purpose'  => 'Used to customize admin interface.',
		'expires'  => '1 year',
	],
	'wordpress_logged_in_*' => [
		'name'     => 'WordPress',
		'category' => 'required',
		'provider' => 'WordPress',
		'purpose'  => 'Indicates when you\'re logged in.',
		'expires'  => 'Session',
	],
	'wordpress_test_cookie' => [
		'name'     => 'WordPress',
		'category' => 'required',
		'provider' => 'WordPress',
		'purpose'  => 'Tests if cookies are enabled.',
		'expires'  => 'Session',
	],
	'woocommerce_cart_hash' => [
		'name'     => 'WooCommerce',
		'category' => 'required',
		'provider' => 'WooCommerce',
		'purpose'  => 'Helps WooCommerce determine cart changes.',
		'expires'  => 'Session',
	],
	'woocommerce_items_in_cart' => [
		'name'     => 'WooCommerce',
		'category' => 'required',
		'provider' => 'WooCommerce',
		'purpose'  => 'Helps WooCommerce determine cart changes.',
		'expires'  => 'Session',
	],
	'wp_woocommerce_session_*' => [
		'name'     => 'WooCommerce',
		'category' => 'required',
		'provider' => 'WooCommerce',
		'purpose'  => 'Contains a unique code for each customer.',
		'expires'  => '2 days',
	],

	// =========================================================================
	// MATOMO (Privacy-friendly analytics)
	// =========================================================================
	'_pk_id.*'        => [
		'name'     => 'Matomo',
		'category' => 'statistics-anonymous',
		'provider' => 'Matomo',
		'purpose'  => 'Used to store a few details about the user.',
		'expires'  => '13 months',
	],
	'_pk_ses.*'       => [
		'name'     => 'Matomo',
		'category' => 'statistics-anonymous',
		'provider' => 'Matomo',
		'purpose'  => 'Short lived cookies used for temporarily storing data.',
		'expires'  => '30 minutes',
	],
	'_pk_ref.*'       => [
		'name'     => 'Matomo',
		'category' => 'statistics-anonymous',
		'provider' => 'Matomo',
		'purpose'  => 'Stores the attribution information.',
		'expires'  => '6 months',
	],
	'_pk_cvar.*'      => [
		'name'     => 'Matomo',
		'category' => 'statistics-anonymous',
		'provider' => 'Matomo',
		'purpose'  => 'Stores the visitor\'s custom variables.',
		'expires'  => '30 minutes',
	],
	'mtm_consent'     => [
		'name'     => 'Matomo',
		'category' => 'statistics-anonymous',
		'provider' => 'Matomo',
		'purpose'  => 'Stores the user consent for tracking.',
		'expires'  => '13 months',
	],

	// =========================================================================
	// INTERCOM
	// =========================================================================
	'intercom-id-*'   => [
		'name'     => 'Intercom',
		'category' => 'marketing',
		'provider' => 'Intercom Inc',
		'purpose'  => 'Anonymous visitor identifier.',
		'expires'  => '9 months',
	],
	'intercom-session-*' => [
		'name'     => 'Intercom',
		'category' => 'marketing',
		'provider' => 'Intercom Inc',
		'purpose'  => 'Session identifier for open chat.',
		'expires'  => '1 week',
	],

	// =========================================================================
	// CLOUDFLARE
	// =========================================================================
	'__cf_bm'         => [
		'name'     => 'Cloudflare',
		'category' => 'required',
		'provider' => 'Cloudflare Inc',
		'purpose'  => 'Bot management, distinguishes humans from bots.',
		'expires'  => '30 minutes',
	],
	'cf_clearance'    => [
		'name'     => 'Cloudflare',
		'category' => 'required',
		'provider' => 'Cloudflare Inc',
		'purpose'  => 'Used for Cloudflare DDoS protection.',
		'expires'  => '1 year',
	],

	// =========================================================================
	// YOUTUBE
	// =========================================================================
	'YSC'             => [
		'name'     => 'YouTube',
		'category' => 'marketing',
		'provider' => 'Google LLC',
		'purpose'  => 'Registers a unique ID to keep statistics of videos watched.',
		'expires'  => 'Session',
	],
	'VISITOR_INFO1_LIVE' => [
		'name'     => 'YouTube',
		'category' => 'marketing',
		'provider' => 'Google LLC',
		'purpose'  => 'Tries to estimate user bandwidth.',
		'expires'  => '6 months',
	],
	'PREF'            => [
		'name'     => 'YouTube',
		'category' => 'marketing',
		'provider' => 'Google LLC',
		'purpose'  => 'Stores user preferences and other information.',
		'expires'  => '8 months',
	],

	// =========================================================================
	// VIMEO
	// =========================================================================
	'vuid'            => [
		'name'     => 'Vimeo',
		'category' => 'marketing',
		'provider' => 'Vimeo Inc',
		'purpose'  => 'Collects data on your visits to websites with embedded Vimeo videos.',
		'expires'  => '2 years',
	],
	'player'          => [
		'name'     => 'Vimeo',
		'category' => 'marketing',
		'provider' => 'Vimeo Inc',
		'purpose'  => 'Saves user preferences when playing embedded videos.',
		'expires'  => '1 year',
	],

	// =========================================================================
	// CRISP CHAT
	// =========================================================================
	'crisp-client/*'  => [
		'name'     => 'Crisp',
		'category' => 'marketing',
		'provider' => 'Crisp IM SARL',
		'purpose'  => 'Used for live chat support.',
		'expires'  => '6 months',
	],

	// =========================================================================
	// ZENDESK
	// =========================================================================
	'__zlcmid'        => [
		'name'     => 'Zendesk',
		'category' => 'marketing',
		'provider' => 'Zendesk Inc',
		'purpose'  => 'Stores visitor identifier for live chat.',
		'expires'  => '1 year',
	],

	// =========================================================================
	// COOKIE CONSENT (Required)
	// =========================================================================
	'as_cm_consent'   => [
		'name'     => 'AdSimple Cookie Manager',
		'category' => 'required',
		'provider' => 'AdSimple',
		'purpose'  => 'Stores the user\'s cookie consent preferences.',
		'expires'  => '180 days',
	],
	'as_cm_consent_preview' => [
		'name'     => 'AdSimple Cookie Manager',
		'category' => 'required',
		'provider' => 'AdSimple',
		'purpose'  => 'Used for consent banner preview.',
		'expires'  => 'Session',
	],
	'cookieconsent_*' => [
		'name'     => 'Cookie Consent',
		'category' => 'required',
		'provider' => 'Various',
		'purpose'  => 'Stores the user\'s cookie consent preferences.',
		'expires'  => '1 year',
	],
];