classification) ? $cookie->classification : ''; $decoded = is_array($value) ? $value : json_decode((string) $value, true); return is_array($decoded) ? $decoded : array(); } public static function matching_rules($cookie) { $domain = strtolower(ltrim(isset($cookie->domain) ? (string) $cookie->domain : '', '.')); $name = isset($cookie->name) ? (string) $cookie->name : ''; return array_values(array_filter(self::data()['rules'], function ($rule) use ($domain, $name) { $matches = in_array($name, $rule['names'], true) || (!empty($rule['pattern']) && preg_match('~' . $rule['pattern'] . '~', $name)); if (!$matches) { return false; } if (empty($rule['domains'])) { return true; } foreach ($rule['domains'] as $allowed) { if ($domain === $allowed || substr($domain, -strlen('.' . $allowed)) === '.' . $allowed) { return true; } } return false; })); } public static function resolve($cookie) { $cookie = clone $cookie; $old = self::metadata($cookie); $matches = self::matching_rules($cookie); $identities = array(); foreach ($matches as $candidate) { if (empty($candidate['aiOnly'])) { $identities[$candidate['category'] . '|' . $candidate['provider']] = true; } } $conflicting = count($identities) > 1; if ($conflicting) { $matches = array(); } $rule = null; foreach ($matches as $candidate) { if (empty($candidate['aiOnly']) || ( isset($old['source'], $old['status'], $old['ruleId'], $old['category'], $old['provider']) && $old['source'] === 'ai' && $old['status'] === 'resolved' && $old['ruleId'] === $candidate['id'] && $old['category'] === $candidate['category'] && $old['provider'] === $candidate['provider'] && $candidate['category'] !== 'required' && empty($candidate['requiresReview']) )) { $rule = $candidate; break; } } $metadata = array( 'status' => 'needs_review', 'source' => 'unknown', 'catalogueVersion' => self::data()['version'], 'ruleId' => '', 'category' => 'unclassified', 'provider' => ltrim((string) $cookie->domain, '.'), 'reason' => $conflicting ? 'Verified provider information conflicts.' : 'No verified information supports this cookie purpose.', 'evidence' => array(), ); if ($rule) { $source = self::data()['sources'][$rule['sourceId']]; $metadata = array( 'status' => !empty($rule['requiresReview']) ? 'needs_review' : 'resolved', 'source' => !empty($rule['aiOnly']) ? 'ai' : 'catalogue', 'catalogueVersion' => self::data()['version'], 'ruleId' => $rule['id'], 'category' => $rule['category'], 'provider' => $rule['provider'], 'reason' => !empty($rule['requiresReview']) ? ($rule['reviewReason'] ?? 'Provider information describes multiple or context-dependent purposes. Confirm the use on this site.') : '', 'evidence' => array(array('sourceId' => $rule['sourceId'], 'url' => $source['url'])), ); } $metadata['evidenceSignature'] = hash('sha256', json_encode(array( $metadata['category'], $metadata['provider'], $metadata['status'], $metadata['ruleId'], $metadata['evidence'], $rule ? $rule['descriptions'] : array(), ))); if (!empty($cookie->reviewed) && empty($old['approval'])) { $old['approval'] = array('category' => $metadata['category'], 'provider' => $metadata['provider'], 'evidenceSignature' => $metadata['evidenceSignature']); } if (!empty($old['approval']) && is_array($old['approval'])) { $metadata['approval'] = $old['approval']; if (!empty($cookie->reviewed) && (($old['approval']['category'] ?? '') !== $metadata['category'] || ($old['approval']['provider'] ?? '') !== $metadata['provider'] || (!empty($old['approval']['evidenceSignature']) && $old['approval']['evidenceSignature'] !== $metadata['evidenceSignature']))) { $metadata['approvalConflict'] = true; $metadata['reason'] = 'Provider evidence changed since your approval. Your saved edits are preserved; confirm the new information.'; } } if (!empty($old['identityConflict'])) { $metadata['identityConflict'] = true; $metadata['status'] = 'needs_review'; $metadata['reason'] = 'An older approval had no cookie path and matches multiple current cookies. Confirm this entry individually.'; } $categories = array('required', 'preferences', 'analytics', 'marketing', 'unclassified'); if (empty($cookie->reviewed) || !in_array($cookie->category, $categories, true)) { $cookie->category = $metadata['category']; } $cookie->provider = $metadata['provider'] !== '' ? $metadata['provider'] : 'Unknown'; $cookie->display_category = $cookie->category === 'required' && $rule && !empty($rule['displayCategory']) ? $rule['displayCategory'] : $cookie->category; $cookie->classification = json_encode($metadata); $cookie->catalogue_descriptions = $rule ? $rule['descriptions'] : array(); return $cookie; } public static function review_state($cookie) { $metadata = self::metadata($cookie); if (!empty($metadata['approvalConflict']) || !empty($metadata['identityConflict'])) { return 'needs_review'; } if (!empty($cookie->reviewed) && $cookie->category !== 'unclassified') { return 'reviewed'; } return isset($metadata['status']) && $metadata['status'] === 'resolved' ? 'automatic' : 'needs_review'; } public static function description($cookie, $language) { $descriptions = isset($cookie->catalogue_descriptions) ? $cookie->catalogue_descriptions : array(); if (isset($descriptions[$language])) { return $descriptions[$language]; } return ''; } }