feat: add toJson() to all Event subclasses and fix NotifyEvent constructor inconsistency

Author: SERDUN

packages/webtrit_signaling/AGENTS.md

@@ -66,10 +66,16 @@ or disconnect.
 All extend `WebtritSignalingException`:
 
 - `WebtritSignalingErrorException` — server returned error code
-- `WebtritSignalingDisconnectedException` — socket closed unexpectedly
-- `WebtritSignalingTransactionTimeoutException` — no response within timeout
-- `WebtritSignalingKeepaliveTransactionTimeoutException` — keepalive timed out
+- `WebtritSignalingDisconnectedException` — `execute()` called after `disconnect()` (subscription already nil)
+- `WebtritSignalingUnknownMessageException` — unrecognised inbound message kind
+- `WebtritSignalingUnknownResponseException` — response with no matching transaction
 - `WebtritSignalingBadStateException` — API misuse (e.g. calling `listen()` twice)
+- `WebtritSignalingTransactionException` ← abstract base for transaction errors
+  - `WebtritSignalingTransactionTimeoutException` — no response within 10 s timeout
+    - `WebtritSignalingKeepaliveTransactionTimeoutException` — keepalive timed out
+  - `WebtritSignalingTransactionUnavailableException` — transaction slot unavailable
+  - `WebtritSignalingTransactionTerminateException` ← abstract base for terminations
+    - `WebtritSignalingTransactionTerminateByDisconnectException` — in-flight transaction cancelled because socket closed
 
 ## Constraints
 
@@ -78,13 +84,38 @@ All extend `WebtritSignalingException`:
 - Callback API, not streams. `listen()` is single-use.
 - Outbound JSON: requests implement `toJson()` — do not bypass.
 
+## Static Helpers
+
+```dart
+WebtritSignalingClient.generateTransactionId()   // random ID for Request.transaction
+WebtritSignalingClient.generateCallId()          // random 24-char call ID
+WebtritSignalingClient.buildTenantUrl(base, id)  // appends /tenant/{id} (@visibleForTesting)
+WebtritSignalingClient.subprotocol               // 'webtrit-protocol'
+WebtritSignalingClient.defaultExecuteTransactionTimeoutDuration  // 10 s
+```
+
 ## Test Patterns
 
+### Unit tests
+
 - JSON fixtures in `test/src/events/event_jsons.dart` and `error_event_jsons.dart`.
 - `MockWebSocketChannel` + `MockWebSocketSink` via `mocktail`; `StreamController` injects server messages.
 - `fake_async` for deterministic keepalive/timeout tests.
 - `FakeWebtritSignalingClient` in `test/src/factories/` for higher-level tests.
 
+### Live tests (`test/live_call_test.dart`, tag `live`)
+
+Two-client strategy — `clientA` (caller) and `clientB` (callee) connect to a real server.
+Callee answers programmatically via `AcceptRequest` (no auto-answer on the test server).
+
+Key patterns:
+
+- Pre-register all `awaitEvent<T>()` futures **before** sending any request to avoid missing events on a broadcast stream.
+- Fetch fresh session tokens in each `setUp` — WebTrit tokens are invalidated when the WebSocket session closes.
+- Use `force=false` in `connect()` — `tearDown` disconnects cleanly so no stale sessions exist.
+- `_LiveClient.awaitEvent<T>` wraps the broadcast stream with a `Completer`; fails immediately on `CallErrorEvent / LineErrorEvent / SessionErrorEvent`.
+- Cleanup after tests where server behaviour is non-deterministic (multi-endpoint SIP accounts) uses `try/catch` around `HangupRequest` instead of awaiting `HangupEvent`.
+
 ## Commands
 
 ```bash
@@ -93,6 +124,14 @@ dart test test/webtrit_signaling_test.dart
 dart test --name "buildTenantUrl"
 dart analyze
 dart format .
+
+# Live integration tests (requires real server credentials)
+WEBTRIT_APP_TEST_CUSTOM_CORE_URL=<host> \
+WEBTRIT_APP_TEST_EMAIL_CREDENTIAL=<caller> \
+WEBTRIT_APP_TEST_EMAIL_VERIFY_CREDENTIAL=<caller-password> \
+WEBTRIT_APP_TEST_CALLEE_CREDENTIAL=<callee> \
+WEBTRIT_APP_TEST_CALLEE_VERIFY_CREDENTIAL=<callee-password> \
+dart test test/live_call_test.dart --tags live --reporter expanded
 ```
 
 Connection endpoint: `wss://<host>/signaling/v1?token=<token>[&force=<true|false>]`

packages/webtrit_signaling/lib/src/events/call/accepted_event.dart

@@ -19,6 +19,14 @@ class AcceptedEvent extends CallEvent {
 
   static const typeValue = 'accepted';
 
+  @override
+  Map<String, dynamic> toJson() => {
+    ...callBaseJson(typeValue),
+    if (callee != null) 'callee': callee,
+    if (isFocus != null) 'is_focus': isFocus,
+    if (jsep != null) 'jsep': jsep,
+  };
+
   factory AcceptedEvent.fromJson(Map<String, dynamic> json) {
     final eventTypeValue = json[Event.typeKey];
     if (eventTypeValue != typeValue) {

packages/webtrit_signaling/lib/src/events/call/accepting_event.dart

@@ -5,6 +5,9 @@ class AcceptingEvent extends CallEvent {
 
   static const typeValue = 'accepting';
 
+  @override
+  Map<String, dynamic> toJson() => callBaseJson(typeValue);
+
   factory AcceptingEvent.fromJson(Map<String, dynamic> json) {
     final eventTypeValue = json[Event.typeKey];
     if (eventTypeValue != typeValue) {

packages/webtrit_signaling/lib/src/events/call/call_error_event.dart

@@ -17,6 +17,9 @@ class CallErrorEvent extends CallEvent implements ErrorEvent {
   @override
   List<Object?> get props => [...super.props, code, reason];
 
+  @override
+  Map<String, dynamic> toJson() => {...callBaseJson(ErrorEvent.typeValue), 'code': code, 'reason': reason};
+
   static CallErrorEvent? tryFromJson(Map<String, dynamic> json) {
     final eventTypeValue = json[Event.typeKey];
     if (eventTypeValue != ErrorEvent.typeValue) {

packages/webtrit_signaling/lib/src/events/call/calling_event.dart

@@ -5,6 +5,9 @@ class CallingEvent extends CallEvent {
 
   static const typeValue = 'calling';
 
+  @override
+  Map<String, dynamic> toJson() => callBaseJson(typeValue);
+
   factory CallingEvent.fromJson(Map<String, dynamic> json) {
     final eventTypeValue = json[Event.typeKey];
     if (eventTypeValue != typeValue) {

packages/webtrit_signaling/lib/src/events/call/declining_event.dart

@@ -17,6 +17,9 @@ class DecliningEvent extends CallEvent {
 
   static const typeValue = 'declining';
 
+  @override
+  Map<String, dynamic> toJson() => {...callBaseJson(typeValue), 'code': code, if (referId != null) 'refer_id': referId};
+
   factory DecliningEvent.fromJson(Map<String, dynamic> json) {
     final eventTypeValue = json[Event.typeKey];
     if (eventTypeValue != typeValue) {

packages/webtrit_signaling/lib/src/events/call/hangingup_event.dart

@@ -5,6 +5,9 @@ class HangingupEvent extends CallEvent {
 
   static const typeValue = 'hangingup';
 
+  @override
+  Map<String, dynamic> toJson() => callBaseJson(typeValue);
+
   factory HangingupEvent.fromJson(Map<String, dynamic> json) {
     final eventTypeValue = json[Event.typeKey];
     if (eventTypeValue != typeValue) {

packages/webtrit_signaling/lib/src/events/call/hangup_event.dart

@@ -17,6 +17,9 @@ class HangupEvent extends CallEvent {
 
   static const typeValue = 'hangup';
 
+  @override
+  Map<String, dynamic> toJson() => {...callBaseJson(typeValue), 'code': code, 'reason': reason};
+
   factory HangupEvent.fromJson(Map<String, dynamic> json) {
     final eventTypeValue = json[Event.typeKey];
     if (eventTypeValue != typeValue) {

packages/webtrit_signaling/lib/src/events/call/holding_event.dart

@@ -5,6 +5,9 @@ class HoldingEvent extends CallEvent {
 
   static const typeValue = 'holding';
 
+  @override
+  Map<String, dynamic> toJson() => callBaseJson(typeValue);
+
   factory HoldingEvent.fromJson(Map<String, dynamic> json) {
     final eventTypeValue = json[Event.typeKey];
     if (eventTypeValue != typeValue) {

packages/webtrit_signaling/lib/src/events/call/incoming_call_event.dart

@@ -36,6 +36,18 @@ class IncomingCallEvent extends CallEvent {
 
   static const typeValue = 'incoming_call';
 
+  @override
+  Map<String, dynamic> toJson() => {
+    ...callBaseJson(typeValue),
+    'callee': callee,
+    'caller': caller,
+    if (callerDisplayName != null) 'caller_display_name': callerDisplayName,
+    if (referredBy != null) 'referred_by': referredBy,
+    if (replaceCallId != null) 'replace_call_id': replaceCallId,
+    if (isFocus != null) 'is_focus': isFocus,
+    if (jsep != null) 'jsep': jsep,
+  };
+
   factory IncomingCallEvent.fromJson(Map<String, dynamic> json) {
     final eventTypeValue = json[Event.typeKey];
     if (eventTypeValue != typeValue) {