# SPDX-FileCopyrightText: 2026 Dennis Fink # # SPDX-License-Identifier: BSD-3-Clause """URL fingerprints and UUID timestamp utilities.""" import json from datetime import UTC, datetime from hashlib import sha256 from uuid import UUID def uuid7_to_datetime(identifier: UUID) -> datetime: """Convert a UUID version 7 timestamp to a datetime. :param identifier: UUID whose embedded timestamp should be converted. :returns: Timestamp as a timezone-aware UTC datetime. """ return datetime.fromtimestamp(identifier.time / 1000, tz=UTC) def source_target_digest(source: str, target: str) -> str: """Fingerprint an unambiguous, ordered source/target pair. :param source: Webmention source URL. :param target: Webmention target URL. :returns: SHA-256 hexadecimal digest of the ordered URL pair. """ encoded = json.dumps( [source, target], ensure_ascii=False, separators=(",", ":") ).encode("utf-8") return sha256(encoded).hexdigest() def target_digest(target: str) -> str: """Fingerprint an outgoing target (unique within each source ID). :param target: Outgoing Webmention target URL. :returns: SHA-256 hexadecimal digest of the target URL. """ return sha256(target.encode("utf-8")).hexdigest()