# -*- coding: utf-8 -*-
"""Original finite-batch exercise. Python 3.9+, standard library only."""
from collections import Counter
from datetime import datetime, timezone
from pathlib import Path
import json
import platform

def normalize(row):
    if not isinstance(row, dict):
        raise ValueError('object required')
    if set(row) != {'shipment_id', 'version', 'occurred_at', 'status'}:
        raise ValueError('unexpected or missing fields')
    sid, version = row['shipment_id'], row['version']
    if not isinstance(sid, str) or not sid.strip() or len(sid) > 64:
        raise ValueError('invalid shipment_id')
    if type(version) is not int or version <= 0:
        raise ValueError('positive integer version required')
    if row['status'] not in ('in_transit', 'delivered', 'cancelled'):
        raise ValueError('invalid status')
    raw = row['occurred_at']
    if not isinstance(raw, str) or 'T' not in raw:
        raise ValueError('timestamp string required')
    try:
        stamp = datetime.fromisoformat(raw[:-1] + '+00:00' if raw.endswith('Z') else raw)
    except ValueError as exc:
        raise ValueError('invalid timestamp') from exc
    if stamp.tzinfo is None or stamp.utcoffset() is None:
        raise ValueError('timezone offset required')
    return (sid, version, stamp.astimezone(timezone.utc), row['status'])

def summarize(rows):
    # No caller-owned state is mutated; an invalid/conflicting batch returns no report.
    seen, latest = {}, {}
    received = duplicates = 0
    for raw in rows:
        received += 1
        event = normalize(raw)
        sid, version, stamp, status = event
        key = (sid, version)
        if key in seen:
            if seen[key] != event:
                raise ValueError('conflicting payload for same shipment and version')
            duplicates += 1
            continue
        seen[key] = event
        if sid not in latest or version > latest[sid][1]:
            latest[sid] = event
    counts = dict(sorted(Counter(e[3] for e in latest.values()).items()))
    return {'received': received, 'duplicates': duplicates,
            'unique_events': len(seen), 'shipments': len(latest),
            'superseded': len(seen) - len(latest), 'statuses': counts}

def check():
    data = json.loads(Path(__file__).with_name('events.json').read_text())
    expected = {'received': 7, 'duplicates': 2, 'unique_events': 5,
                'shipments': 3, 'superseded': 2,
                'statuses': {'cancelled': 1, 'delivered': 2}}
    assert summarize(data) == expected
    assert summarize(reversed(data)) == expected
    assert summarize(iter([]))['shipments'] == 0
    assert summarize(data + data)['statuses'] == expected['statuses']
    assert summarize(data + data)['duplicates'] == 9
    bad = [None, {}, dict(data[0],version=None), dict(data[0],version=True),
           dict(data[0],version=0), dict(data[0],version=-1),
           dict(data[0],occurred_at=None), dict(data[0],occurred_at='2026-11-12T08:00:00'),
           dict(data[0],status='lost'), dict(data[0],shipment_id='')]
    for row in bad:
        try: summarize([row])
        except ValueError: pass
        else: raise AssertionError('invalid event accepted')
    try: summarize(data + [dict(data[0],status='cancelled')])
    except ValueError: pass
    else: raise AssertionError('conflict accepted')
    return {'python':platform.python_version(),'result':expected,
            'checks':['order reversed','empty iterator','full replay','10 invalid variants',
                      'same-version conflict','equivalent UTC offsets'], 'passed':True}

if __name__ == '__main__':
    print(json.dumps(check(),ensure_ascii=False,indent=2))
