feat: add raw_json() to the event returned by webhook verification

[razor-x]

Follow-up to #651. That PR made parsing degrade instead of raise, but it did not keep the payload — so this is the half that actually lets a handler reach something the SDK does not know about yet.

The gap

from_dict reads only the properties it was generated for, so a field Seam adds to an existing event between SDK releases is silently discarded:

Device.from_dict({'device_id': 'd', 'brand_new_field': 'kept?'})
# brand_new_field: <<DROPPED>>

There was no way to recover it short of upgrading the SDK.

The change

SeamWebhook.verify() now returns an event carrying raw_json():

event = webhook.verify(payload, headers)
json.loads(event.raw_json())["a_field_this_version_predates"]

DeepAttrDict answers the same call, so the unrecognized-event branch and the typed branch are handled the same way. That matters more than it first appears: the fallback is not otherwise interchangeable with a generated event, because reading a missing key raises AttributeError where a dataclass returns None. Generic code written against the declared union breaks on it:

def log_any_event(ev):
    return f'{ev.event_type} in {ev.workspace_id}'

log_any_event(known_event)        # 'device.connected in w'
log_any_event(unrecognized_event) # AttributeError: workspace_id

raw_json() gives both branches one thing that always works.

Scope

Events only. It exists for the verify return, not as a general accessor on every model — Device, action attempts and the rest are untouched, and there is a test pinning that.

A method rather than a property because the call is where the serialization happens: the event retains the decoded payload and serializes on demand. The retained payload is repr=False and compare=False, so it changes neither the repr nor equality.

Verification

just lint && just test — 289 tests, mypy clean, pylint 10.00/10, black clean.

New tests cover recovering a dropped field, round-tripping a known and an unrecognized event, absence from the repr, equality being unaffected, and raw_json not leaking onto non-event models.

🤖 Generated with Claude Code

https://claude.ai/code/session_01M2kJ4nGaM8imZCVMEKjmXA

---

Generated by Claude Code