@whooshbang/contracts 1.0.0-rc.13

package/fixtures/whooshbang-events-v1/delivery/cases.json

@@ -0,0 +1,418 @@
+{
+  "schema": "whooshbang.webhook-delivery-cases.v1",
+  "cases": [
+    {
+      "id": "network-failure",
+      "attempt": 1,
+      "first_attempt_at_epoch_seconds": 1785000000,
+      "now_epoch_seconds": 1785000060,
+      "outcome": {
+        "kind": "network_failure"
+      },
+      "expected": {
+        "action": "retry",
+        "reason": "network_failure",
+        "latest_retry_at_epoch_seconds": 1785086400
+      }
+    },
+    {
+      "id": "http-200",
+      "attempt": 1,
+      "first_attempt_at_epoch_seconds": 1785000000,
+      "now_epoch_seconds": 1785000060,
+      "outcome": {
+        "kind": "http",
+        "status": 200
+      },
+      "expected": {
+        "action": "accepted",
+        "reason": "http_2xx"
+      }
+    },
+    {
+      "id": "http-204",
+      "attempt": 1,
+      "first_attempt_at_epoch_seconds": 1785000000,
+      "now_epoch_seconds": 1785000060,
+      "outcome": {
+        "kind": "http",
+        "status": 204
+      },
+      "expected": {
+        "action": "accepted",
+        "reason": "http_2xx"
+      }
+    },
+    {
+      "id": "http-299",
+      "attempt": 1,
+      "first_attempt_at_epoch_seconds": 1785000000,
+      "now_epoch_seconds": 1785000060,
+      "outcome": {
+        "kind": "http",
+        "status": 299
+      },
+      "expected": {
+        "action": "accepted",
+        "reason": "http_2xx"
+      }
+    },
+    {
+      "id": "redirect-300",
+      "attempt": 1,
+      "first_attempt_at_epoch_seconds": 1785000000,
+      "now_epoch_seconds": 1785000060,
+      "outcome": {
+        "kind": "http",
+        "status": 300
+      },
+      "expected": {
+        "action": "terminal",
+        "reason": "redirect_not_followed"
+      }
+    },
+    {
+      "id": "redirect-399",
+      "attempt": 1,
+      "first_attempt_at_epoch_seconds": 1785000000,
+      "now_epoch_seconds": 1785000060,
+      "outcome": {
+        "kind": "http",
+        "status": 399
+      },
+      "expected": {
+        "action": "terminal",
+        "reason": "redirect_not_followed"
+      }
+    },
+    {
+      "id": "http-400-terminal",
+      "attempt": 1,
+      "first_attempt_at_epoch_seconds": 1785000000,
+      "now_epoch_seconds": 1785000060,
+      "outcome": {
+        "kind": "http",
+        "status": 400
+      },
+      "expected": {
+        "action": "terminal",
+        "reason": "http_terminal"
+      }
+    },
+    {
+      "id": "http-401-terminal",
+      "attempt": 1,
+      "first_attempt_at_epoch_seconds": 1785000000,
+      "now_epoch_seconds": 1785000060,
+      "outcome": {
+        "kind": "http",
+        "status": 401
+      },
+      "expected": {
+        "action": "terminal",
+        "reason": "http_terminal"
+      }
+    },
+    {
+      "id": "http-422-terminal",
+      "attempt": 1,
+      "first_attempt_at_epoch_seconds": 1785000000,
+      "now_epoch_seconds": 1785000060,
+      "outcome": {
+        "kind": "http",
+        "status": 422
+      },
+      "expected": {
+        "action": "terminal",
+        "reason": "http_terminal"
+      }
+    },
+    {
+      "id": "http-408-retry",
+      "attempt": 1,
+      "first_attempt_at_epoch_seconds": 1785000000,
+      "now_epoch_seconds": 1785000060,
+      "outcome": {
+        "kind": "http",
+        "status": 408
+      },
+      "expected": {
+        "action": "retry",
+        "reason": "retryable_http_status",
+        "latest_retry_at_epoch_seconds": 1785086400
+      }
+    },
+    {
+      "id": "http-425-retry",
+      "attempt": 1,
+      "first_attempt_at_epoch_seconds": 1785000000,
+      "now_epoch_seconds": 1785000060,
+      "outcome": {
+        "kind": "http",
+        "status": 425
+      },
+      "expected": {
+        "action": "retry",
+        "reason": "retryable_http_status",
+        "latest_retry_at_epoch_seconds": 1785086400
+      }
+    },
+    {
+      "id": "http-429-retry",
+      "attempt": 1,
+      "first_attempt_at_epoch_seconds": 1785000000,
+      "now_epoch_seconds": 1785000060,
+      "outcome": {
+        "kind": "http",
+        "status": 429
+      },
+      "expected": {
+        "action": "retry",
+        "reason": "retryable_http_status",
+        "latest_retry_at_epoch_seconds": 1785086400
+      }
+    },
+    {
+      "id": "http-429-safe-retry-after",
+      "attempt": 1,
+      "first_attempt_at_epoch_seconds": 1785000000,
+      "now_epoch_seconds": 1785000060,
+      "outcome": {
+        "kind": "http",
+        "status": 429,
+        "retry_after": "120"
+      },
+      "expected": {
+        "action": "retry",
+        "reason": "retryable_http_status",
+        "latest_retry_at_epoch_seconds": 1785086400,
+        "retry_after_seconds": 120
+      }
+    },
+    {
+      "id": "http-429-http-date-ignored",
+      "attempt": 1,
+      "first_attempt_at_epoch_seconds": 1785000000,
+      "now_epoch_seconds": 1785000060,
+      "outcome": {
+        "kind": "http",
+        "status": 429,
+        "retry_after": "Sat, 25 Jul 2026 18:30:00 GMT"
+      },
+      "expected": {
+        "action": "retry",
+        "reason": "retryable_http_status",
+        "latest_retry_at_epoch_seconds": 1785086400
+      }
+    },
+    {
+      "id": "http-429-unsafe-delay-ignored",
+      "attempt": 1,
+      "first_attempt_at_epoch_seconds": 1785000000,
+      "now_epoch_seconds": 1785000060,
+      "outcome": {
+        "kind": "http",
+        "status": 429,
+        "retry_after": "86401"
+      },
+      "expected": {
+        "action": "retry",
+        "reason": "retryable_http_status",
+        "latest_retry_at_epoch_seconds": 1785086400
+      }
+    },
+    {
+      "id": "http-429-delay-past-window-ignored",
+      "attempt": 7,
+      "first_attempt_at_epoch_seconds": 1785000000,
+      "now_epoch_seconds": 1785086390,
+      "outcome": {
+        "kind": "http",
+        "status": 429,
+        "retry_after": "20"
+      },
+      "expected": {
+        "action": "retry",
+        "reason": "retryable_http_status",
+        "latest_retry_at_epoch_seconds": 1785086400
+      }
+    },
+    {
+      "id": "http-500-retry",
+      "attempt": 1,
+      "first_attempt_at_epoch_seconds": 1785000000,
+      "now_epoch_seconds": 1785000060,
+      "outcome": {
+        "kind": "http",
+        "status": 500
+      },
+      "expected": {
+        "action": "retry",
+        "reason": "retryable_http_status",
+        "latest_retry_at_epoch_seconds": 1785086400
+      }
+    },
+    {
+      "id": "http-503-safe-retry-after",
+      "attempt": 1,
+      "first_attempt_at_epoch_seconds": 1785000000,
+      "now_epoch_seconds": 1785000060,
+      "outcome": {
+        "kind": "http",
+        "status": 503,
+        "retry_after": "300"
+      },
+      "expected": {
+        "action": "retry",
+        "reason": "retryable_http_status",
+        "latest_retry_at_epoch_seconds": 1785086400,
+        "retry_after_seconds": 300
+      }
+    },
+    {
+      "id": "http-503-delay-at-window",
+      "attempt": 7,
+      "first_attempt_at_epoch_seconds": 1785000000,
+      "now_epoch_seconds": 1785086300,
+      "outcome": {
+        "kind": "http",
+        "status": 503,
+        "retry_after": "100"
+      },
+      "expected": {
+        "action": "retry",
+        "reason": "retryable_http_status",
+        "latest_retry_at_epoch_seconds": 1785086400,
+        "retry_after_seconds": 100
+      }
+    },
+    {
+      "id": "http-504-retry-after-ignored",
+      "attempt": 1,
+      "first_attempt_at_epoch_seconds": 1785000000,
+      "now_epoch_seconds": 1785000060,
+      "outcome": {
+        "kind": "http",
+        "status": 504,
+        "retry_after": "120"
+      },
+      "expected": {
+        "action": "retry",
+        "reason": "retryable_http_status",
+        "latest_retry_at_epoch_seconds": 1785086400
+      }
+    },
+    {
+      "id": "http-599-retry",
+      "attempt": 1,
+      "first_attempt_at_epoch_seconds": 1785000000,
+      "now_epoch_seconds": 1785000060,
+      "outcome": {
+        "kind": "http",
+        "status": 599
+      },
+      "expected": {
+        "action": "retry",
+        "reason": "retryable_http_status",
+        "latest_retry_at_epoch_seconds": 1785086400
+      }
+    },
+    {
+      "id": "attempt-eight-network-terminal",
+      "attempt": 8,
+      "first_attempt_at_epoch_seconds": 1785000000,
+      "now_epoch_seconds": 1785000060,
+      "outcome": {
+        "kind": "network_failure"
+      },
+      "expected": {
+        "action": "terminal",
+        "reason": "attempt_limit_exhausted"
+      }
+    },
+    {
+      "id": "attempt-eight-503-terminal",
+      "attempt": 8,
+      "first_attempt_at_epoch_seconds": 1785000000,
+      "now_epoch_seconds": 1785000060,
+      "outcome": {
+        "kind": "http",
+        "status": 503,
+        "retry_after": "30"
+      },
+      "expected": {
+        "action": "terminal",
+        "reason": "attempt_limit_exhausted"
+      }
+    },
+    {
+      "id": "network-at-window-terminal",
+      "attempt": 7,
+      "first_attempt_at_epoch_seconds": 1785000000,
+      "now_epoch_seconds": 1785086400,
+      "outcome": {
+        "kind": "network_failure"
+      },
+      "expected": {
+        "action": "terminal",
+        "reason": "delivery_window_exhausted"
+      }
+    },
+    {
+      "id": "http-429-at-window-terminal",
+      "attempt": 7,
+      "first_attempt_at_epoch_seconds": 1785000000,
+      "now_epoch_seconds": 1785086400,
+      "outcome": {
+        "kind": "http",
+        "status": 429
+      },
+      "expected": {
+        "action": "terminal",
+        "reason": "delivery_window_exhausted"
+      }
+    },
+    {
+      "id": "network-just-inside-window",
+      "attempt": 7,
+      "first_attempt_at_epoch_seconds": 1785000000,
+      "now_epoch_seconds": 1785086399,
+      "outcome": {
+        "kind": "network_failure"
+      },
+      "expected": {
+        "action": "retry",
+        "reason": "network_failure",
+        "latest_retry_at_epoch_seconds": 1785086400
+      }
+    },
+    {
+      "id": "http-100-unexpected",
+      "attempt": 1,
+      "first_attempt_at_epoch_seconds": 1785000000,
+      "now_epoch_seconds": 1785000060,
+      "outcome": {
+        "kind": "http",
+        "status": 100
+      },
+      "expected": {
+        "action": "terminal",
+        "reason": "unexpected_http_status"
+      }
+    },
+    {
+      "id": "http-199-unexpected",
+      "attempt": 1,
+      "first_attempt_at_epoch_seconds": 1785000000,
+      "now_epoch_seconds": 1785000060,
+      "outcome": {
+        "kind": "http",
+        "status": 199
+      },
+      "expected": {
+        "action": "terminal",
+        "reason": "unexpected_http_status"
+      }
+    }
+  ]
+}

package/fixtures/whooshbang-events-v1/events/agent-binding-degraded.json

@@ -0,0 +1,17 @@
+{
+  "schema": "whooshbang.event.v1",
+  "id": "evt_agent_binding_degraded_synthetic",
+  "type": "agent_binding.degraded",
+  "created_at": "2026-07-25T18:12:00Z",
+  "account_id": "acct_synthetic_customer_events",
+  "project_id": "proj_synthetic_customer_events",
+  "environment": "test",
+  "data": {
+    "agent_binding_id": "agent_binding_synthetic_relay",
+    "binding_id": "binding_synthetic_telegram",
+    "notifier_id": "notifier_synthetic_telegram",
+    "state": "degraded",
+    "degradation_code": "interaction_fallback_active",
+    "degraded_at": "2026-07-25T18:12:00Z"
+  }
+}

package/fixtures/whooshbang-events-v1/events/interaction-expired.json

@@ -0,0 +1,16 @@
+{
+  "schema": "whooshbang.event.v1",
+  "id": "evt_interaction_expired_synthetic",
+  "type": "interaction.expired",
+  "created_at": "2026-07-25T18:30:00Z",
+  "account_id": "acct_synthetic_customer_events",
+  "project_id": "proj_synthetic_customer_events",
+  "environment": "test",
+  "data": {
+    "interaction_id": "interaction_synthetic_expired",
+    "message_id": "message_synthetic_interaction",
+    "correlation_id": "correlation_synthetic_interaction",
+    "interaction_type": "confirm",
+    "expired_at": "2026-07-25T18:30:00Z"
+  }
+}

package/fixtures/whooshbang-events-v1/events/interaction-received.json

@@ -0,0 +1,23 @@
+{
+  "schema": "whooshbang.event.v1",
+  "id": "evt_interaction_received_synthetic",
+  "type": "interaction.received",
+  "created_at": "2026-07-25T18:11:00Z",
+  "account_id": "acct_synthetic_customer_events",
+  "project_id": "proj_synthetic_customer_events",
+  "environment": "test",
+  "data": {
+    "interaction_id": "interaction_synthetic_confirm",
+    "message_id": "message_synthetic_interaction",
+    "binding_id": "binding_synthetic_telegram",
+    "channel": "telegram",
+    "correlation_id": "correlation_synthetic_interaction",
+    "interaction_type": "confirm",
+    "response": {
+      "type": "confirm",
+      "value": true
+    },
+    "occurred_at": "2026-07-25T18:10:30Z",
+    "expires_at": "2026-07-25T18:30:00Z"
+  }
+}

package/fixtures/whooshbang-events-v1/events/message-delivered.json

@@ -0,0 +1,16 @@
+{
+  "schema": "whooshbang.event.v1",
+  "id": "evt_message_delivered_synthetic",
+  "type": "message.delivered",
+  "created_at": "2026-07-25T18:08:00Z",
+  "account_id": "acct_synthetic_customer_events",
+  "project_id": "proj_synthetic_customer_events",
+  "environment": "test",
+  "data": {
+    "message_id": "message_synthetic_customer_event",
+    "correlation_id": "correlation_synthetic_customer_event",
+    "state": "delivered",
+    "evidence": "provider_delivery_receipt",
+    "delivered_at": "2026-07-25T18:08:00Z"
+  }
+}

package/fixtures/whooshbang-events-v1/events/message-expired.json

@@ -0,0 +1,15 @@
+{
+  "schema": "whooshbang.event.v1",
+  "id": "evt_message_expired_synthetic",
+  "type": "message.expired",
+  "created_at": "2026-07-25T18:10:00Z",
+  "account_id": "acct_synthetic_customer_events",
+  "project_id": "proj_synthetic_customer_events",
+  "environment": "test",
+  "data": {
+    "message_id": "message_synthetic_expired",
+    "correlation_id": "correlation_synthetic_customer_event",
+    "state": "expired",
+    "expired_at": "2026-07-25T18:10:00Z"
+  }
+}

package/fixtures/whooshbang-events-v1/events/message-failed.json

@@ -0,0 +1,17 @@
+{
+  "schema": "whooshbang.event.v1",
+  "id": "evt_message_failed_synthetic",
+  "type": "message.failed",
+  "created_at": "2026-07-25T18:09:00Z",
+  "account_id": "acct_synthetic_customer_events",
+  "project_id": "proj_synthetic_customer_events",
+  "environment": "test",
+  "data": {
+    "message_id": "message_synthetic_customer_event",
+    "correlation_id": "correlation_synthetic_customer_event",
+    "state": "terminal_failed",
+    "failure_code": "provider_terminal",
+    "retryable": false,
+    "failed_at": "2026-07-25T18:09:00Z"
+  }
+}

package/fixtures/whooshbang-events-v1/events/message-provider-accepted.json

@@ -0,0 +1,15 @@
+{
+  "schema": "whooshbang.event.v1",
+  "id": "evt_message_provider_accepted_synthetic",
+  "type": "message.provider_accepted",
+  "created_at": "2026-07-25T18:07:00Z",
+  "account_id": "acct_synthetic_customer_events",
+  "project_id": "proj_synthetic_customer_events",
+  "environment": "test",
+  "data": {
+    "message_id": "message_synthetic_customer_event",
+    "correlation_id": "correlation_synthetic_customer_event",
+    "state": "provider_accepted",
+    "accepted_at": "2026-07-25T18:07:00Z"
+  }
+}

package/fixtures/whooshbang-events-v1/events/subscription-activated.json

@@ -0,0 +1,18 @@
+{
+  "schema": "whooshbang.event.v1",
+  "id": "evt_subscription_activated_synthetic",
+  "type": "subscription.activated",
+  "created_at": "2026-07-25T18:05:00Z",
+  "account_id": "acct_synthetic_customer_events",
+  "project_id": "proj_synthetic_customer_events",
+  "environment": "test",
+  "data": {
+    "subscription_link_id": "slink_synthetic_001",
+    "binding_id": "binding_synthetic_telegram",
+    "subscriber_id": "subscriber_synthetic_customer",
+    "notifier_id": "notifier_synthetic_telegram",
+    "channel": "telegram",
+    "state": "activated",
+    "activated_at": "2026-07-25T18:05:00Z"
+  }
+}

package/fixtures/whooshbang-events-v1/events/subscription-revoked.json

@@ -0,0 +1,18 @@
+{
+  "schema": "whooshbang.event.v1",
+  "id": "evt_subscription_revoked_synthetic",
+  "type": "subscription.revoked",
+  "created_at": "2026-07-25T18:06:00Z",
+  "account_id": "acct_synthetic_customer_events",
+  "project_id": "proj_synthetic_customer_events",
+  "environment": "test",
+  "data": {
+    "subscription_link_id": "slink_synthetic_001",
+    "binding_id": "binding_synthetic_telegram",
+    "subscriber_id": "subscriber_synthetic_customer",
+    "notifier_id": "notifier_synthetic_telegram",
+    "channel": "telegram",
+    "state": "revoked",
+    "revoked_at": "2026-07-25T18:06:00Z"
+  }
+}