From 5e69ee4db9645c200ac60d24deeaceab0c2c4831 Mon Sep 17 00:00:00 2001
From: Dobrunia Kostrigin <48620984+Dobrunia@users.noreply.github.com>
Date: Thu, 15 Jan 2026 04:31:13 +0300
Subject: [PATCH 1/2] feat(breadcrumbs): add Breadcrumb and related enums to
 event type definitions

- Introduced BreadcrumbLevel and BreadcrumbType enums for categorizing breadcrumbs.
- Added Breadcrumb type to represent events leading up to errors, including fields for timestamp, type, category, message, severity level, and associated data.
- Updated EventPayload to include a breadcrumbs field for tracking chronological events before an error.
---
 src/typeDefs/event.ts | 69 +++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 66 insertions(+), 3 deletions(-)

diff --git a/src/typeDefs/event.ts b/src/typeDefs/event.ts
index a82b6762..272a7bc1 100644
--- a/src/typeDefs/event.ts
+++ b/src/typeDefs/event.ts
@@ -116,6 +116,64 @@ type EventUser {
   photo: String
 }
 
+"""
+Breadcrumb severity level
+"""
+enum BreadcrumbLevel {
+  fatal
+  error
+  warning
+  info
+  debug
+}
+
+"""
+Breadcrumb type - controls categorization and UI appearance
+"""
+enum BreadcrumbType {
+  default
+  request
+  ui
+  navigation
+  logic
+  error
+}
+
+"""
+Single breadcrumb entry - represents an event that occurred before the error
+"""
+type Breadcrumb {
+  """
+  Timestamp when the breadcrumb occurred (Unix timestamp in milliseconds)
+  """
+  timestamp: Float!
+
+  """
+  Type of breadcrumb - controls UI categorization
+  """
+  type: BreadcrumbType
+
+  """
+  Category of the event - more specific than type
+  """
+  category: String
+
+  """
+  Human-readable message describing the event
+  """
+  message: String
+
+  """
+  Severity level of the breadcrumb
+  """
+  level: BreadcrumbLevel
+
+  """
+  Arbitrary key-value data associated with the breadcrumb
+  """
+  data: JSONObject
+}
+
 """
 Type representing Event payload
 """
@@ -174,6 +232,11 @@ type EventPayload {
   Custom data provided by project users
   """
   addons: EncodedJSON
+
+  """
+  Breadcrumbs - chronological trail of events before the error
+  """
+  breadcrumbs: [Breadcrumb!]
 }
 
 
@@ -337,9 +400,9 @@ type Subscription {
   """
   Sends new events from all user projects
   """
-  eventOccurred: Event! 
+  eventOccurred: Event!
 }
-  
+
 """
 Event information per day with these events
 """
@@ -453,7 +516,7 @@ extend type Mutation {
     Mark to set
     """
     mark: EventMark!
-  ): Boolean! 
+  ): Boolean!
 
   """
   Namespace that contains only mutations related to the events

From b56d6e48784c53a334c7466db8ed9a1f2dd28595 Mon Sep 17 00:00:00 2001
From: github-actions <41898282+github-actions[bot]@users.noreply.github.com>
Date: Thu, 15 Jan 2026 01:32:23 +0000
Subject: [PATCH 2/2] Bump version up to 1.2.33

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 347f350d..39873b42 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "hawk.api",
-  "version": "1.2.32",
+  "version": "1.2.33",
   "main": "index.ts",
   "license": "BUSL-1.1",
   "scripts": {