From f79f436462011cca012228078daeb02c8b982640 Mon Sep 17 00:00:00 2001
From: Dobrunia Kostrigin <48620984+Dobrunia@users.noreply.github.com>
Date: Mon, 6 Jul 2026 22:15:13 +0300
Subject: [PATCH 1/3] feat: add traceContext to event data

Introduces traceContext to the EventData interface, allowing for trace metadata to link related events within the same execution chain. This change includes updates to the index files to export the new traceContext module.
---
 build/index.d.ts                       | 1 +
 build/index.js                         | 1 +
 build/src/base/event/event.d.ts        | 5 +++++
 build/src/base/event/traceContext.d.ts | 9 +++++++++
 build/src/base/event/traceContext.js   | 2 ++
 index.ts                               | 1 +
 src/base/event/event.ts                | 6 ++++++
 src/base/event/traceContext.ts         | 9 +++++++++
 8 files changed, 34 insertions(+)
 create mode 100644 build/src/base/event/traceContext.d.ts
 create mode 100644 build/src/base/event/traceContext.js
 create mode 100644 src/base/event/traceContext.ts

diff --git a/build/index.d.ts b/build/index.d.ts
index 69b99d6..26b01df 100644
--- a/build/index.d.ts
+++ b/build/index.d.ts
@@ -7,6 +7,7 @@ export * from './src/base/event/breadcrumb';
 export * from './src/base/event/event';
 export * from './src/base/event/sourceCodeLine';
 export * from './src/base/event/taskManagerItem';
+export * from './src/base/event/traceContext';
 export * from './src/base/event/addons';
 export * from './src/base/integrations/integrationToken';
 export * from './src/base/project/ProjectTaskManager';
diff --git a/build/index.js b/build/index.js
index d28d535..1c8077c 100644
--- a/build/index.js
+++ b/build/index.js
@@ -23,6 +23,7 @@ __exportStar(require("./src/base/event/breadcrumb"), exports);
 __exportStar(require("./src/base/event/event"), exports);
 __exportStar(require("./src/base/event/sourceCodeLine"), exports);
 __exportStar(require("./src/base/event/taskManagerItem"), exports);
+__exportStar(require("./src/base/event/traceContext"), exports);
 __exportStar(require("./src/base/event/addons"), exports);
 __exportStar(require("./src/base/integrations/integrationToken"), exports);
 __exportStar(require("./src/base/project/ProjectTaskManager"), exports);
diff --git a/build/src/base/event/event.d.ts b/build/src/base/event/event.d.ts
index fed7107..eccd01f 100644
--- a/build/src/base/event/event.d.ts
+++ b/build/src/base/event/event.d.ts
@@ -3,6 +3,7 @@ import type { AffectedUser } from './affectedUser.ts';
 import type { EventAddons } from './addons/index.ts';
 import type { Json } from '../../utils/index.ts';
 import type { Breadcrumb } from './breadcrumb.ts';
+import type { TraceContext } from './traceContext.ts';
 /**
  * Information about event (Payload of the event)
  * That object will be sent as 'payload' from the Collector to the workers
@@ -45,6 +46,10 @@ export interface EventData<Addons extends EventAddons> {
      * Catcher version
      */
     catcherVersion?: string;
+    /**
+     * Trace metadata for linking related events within the same execution chain.
+     */
+    traceContext?: TraceContext;
 }
 /**
  * Event data with decoded unsafe fields
diff --git a/build/src/base/event/traceContext.d.ts b/build/src/base/event/traceContext.d.ts
new file mode 100644
index 0000000..aa2f147
--- /dev/null
+++ b/build/src/base/event/traceContext.d.ts
@@ -0,0 +1,9 @@
+/**
+ * Trace metadata attached to error events for linking related frontend/backend occurrences.
+ */
+export interface TraceContext {
+    /**
+     * Shared identifier for events from the same execution chain.
+     */
+    traceId: string;
+}
diff --git a/build/src/base/event/traceContext.js b/build/src/base/event/traceContext.js
new file mode 100644
index 0000000..c8ad2e5
--- /dev/null
+++ b/build/src/base/event/traceContext.js
@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
diff --git a/index.ts b/index.ts
index 34bdae8..85f4612 100644
--- a/index.ts
+++ b/index.ts
@@ -10,6 +10,7 @@ export * from './src/base/event/breadcrumb';
 export * from './src/base/event/event';
 export * from './src/base/event/sourceCodeLine';
 export * from './src/base/event/taskManagerItem';
+export * from './src/base/event/traceContext';
 export * from './src/base/event/addons';
 
 export * from './src/base/integrations/integrationToken';
diff --git a/src/base/event/event.ts b/src/base/event/event.ts
index 57ad22f..ce1f80c 100644
--- a/src/base/event/event.ts
+++ b/src/base/event/event.ts
@@ -3,6 +3,7 @@ import type { AffectedUser } from './affectedUser.ts';
 import type { EventAddons } from './addons/index.ts';
 import type { Json } from '../../utils/index.ts';
 import type { Breadcrumb } from './breadcrumb.ts';
+import type { TraceContext } from './traceContext.ts';
 
 /**
  * Information about event (Payload of the event)
@@ -54,6 +55,11 @@ export interface EventData<Addons extends EventAddons> {
    * Catcher version
    */
   catcherVersion?: string;
+
+  /**
+   * Trace metadata for linking related events within the same execution chain.
+   */
+  traceContext?: TraceContext;
 }
 
 /**
diff --git a/src/base/event/traceContext.ts b/src/base/event/traceContext.ts
new file mode 100644
index 0000000..8dd955e
--- /dev/null
+++ b/src/base/event/traceContext.ts
@@ -0,0 +1,9 @@
+/**
+ * Trace metadata attached to error events for linking related frontend/backend occurrences.
+ */
+export interface TraceContext {
+  /**
+   * Shared identifier for events from the same execution chain.
+   */
+  traceId: string;
+}

From 09cbbc1ac6940652df4dd07a0e1ab00ed946c7b8 Mon Sep 17 00:00:00 2001
From: Dobrunia Kostrigin <48620984+Dobrunia@users.noreply.github.com>
Date: Mon, 6 Jul 2026 22:16:07 +0300
Subject: [PATCH 2/3] version

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

diff --git a/package.json b/package.json
index ca1136c..122ff8d 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@hawk.so/types",
-  "version": "0.6.4",
+  "version": "0.6.5",
   "description": "TypeScript definitions for Hawk",
   "types": "build/index.d.ts",
   "main": "build/index.js",

From 2f358dae8fe4056e8529839dca890feb6ebdf7d9 Mon Sep 17 00:00:00 2001
From: Dobrunia Kostrigin <48620984+Dobrunia@users.noreply.github.com>
Date: Tue, 7 Jul 2026 00:23:33 +0300
Subject: [PATCH 3/3] refactor: replace traceContext with trace in event data

This update modifies the EventData interface to use a new trace type, EventTrace, instead of the deprecated TraceContext. The corresponding traceContext module has been removed, and the index files have been updated to reflect this change.
---
 build/index.d.ts                | 2 +-
 build/index.js                  | 2 +-
 build/src/base/event/event.d.ts | 6 +++---
 build/src/base/event/trace.d.ts | 9 +++++++++
 build/src/base/event/trace.js   | 2 ++
 index.ts                        | 2 +-
 src/base/event/event.ts         | 6 +++---
 src/base/event/trace.ts         | 9 +++++++++
 src/base/event/traceContext.ts  | 9 ---------
 9 files changed, 29 insertions(+), 18 deletions(-)
 create mode 100644 build/src/base/event/trace.d.ts
 create mode 100644 build/src/base/event/trace.js
 create mode 100644 src/base/event/trace.ts
 delete mode 100644 src/base/event/traceContext.ts

diff --git a/build/index.d.ts b/build/index.d.ts
index 26b01df..4393605 100644
--- a/build/index.d.ts
+++ b/build/index.d.ts
@@ -7,7 +7,7 @@ export * from './src/base/event/breadcrumb';
 export * from './src/base/event/event';
 export * from './src/base/event/sourceCodeLine';
 export * from './src/base/event/taskManagerItem';
-export * from './src/base/event/traceContext';
+export * from './src/base/event/trace';
 export * from './src/base/event/addons';
 export * from './src/base/integrations/integrationToken';
 export * from './src/base/project/ProjectTaskManager';
diff --git a/build/index.js b/build/index.js
index 1c8077c..6f4a9ec 100644
--- a/build/index.js
+++ b/build/index.js
@@ -23,7 +23,7 @@ __exportStar(require("./src/base/event/breadcrumb"), exports);
 __exportStar(require("./src/base/event/event"), exports);
 __exportStar(require("./src/base/event/sourceCodeLine"), exports);
 __exportStar(require("./src/base/event/taskManagerItem"), exports);
-__exportStar(require("./src/base/event/traceContext"), exports);
+__exportStar(require("./src/base/event/trace"), exports);
 __exportStar(require("./src/base/event/addons"), exports);
 __exportStar(require("./src/base/integrations/integrationToken"), exports);
 __exportStar(require("./src/base/project/ProjectTaskManager"), exports);
diff --git a/build/src/base/event/event.d.ts b/build/src/base/event/event.d.ts
index eccd01f..084307d 100644
--- a/build/src/base/event/event.d.ts
+++ b/build/src/base/event/event.d.ts
@@ -3,7 +3,7 @@ import type { AffectedUser } from './affectedUser.ts';
 import type { EventAddons } from './addons/index.ts';
 import type { Json } from '../../utils/index.ts';
 import type { Breadcrumb } from './breadcrumb.ts';
-import type { TraceContext } from './traceContext.ts';
+import type { EventTrace } from './trace.ts';
 /**
  * Information about event (Payload of the event)
  * That object will be sent as 'payload' from the Collector to the workers
@@ -47,9 +47,9 @@ export interface EventData<Addons extends EventAddons> {
      */
     catcherVersion?: string;
     /**
-     * Trace metadata for linking related events within the same execution chain.
+     * Distributed trace metadata for linking related events within the same execution chain.
      */
-    traceContext?: TraceContext;
+    trace?: EventTrace;
 }
 /**
  * Event data with decoded unsafe fields
diff --git a/build/src/base/event/trace.d.ts b/build/src/base/event/trace.d.ts
new file mode 100644
index 0000000..ae69bca
--- /dev/null
+++ b/build/src/base/event/trace.d.ts
@@ -0,0 +1,9 @@
+/**
+ * Distributed trace metadata attached to error and performance events.
+ */
+export interface EventTrace {
+    /**
+     * Shared identifier for events from the same execution chain.
+     */
+    id: string;
+}
diff --git a/build/src/base/event/trace.js b/build/src/base/event/trace.js
new file mode 100644
index 0000000..c8ad2e5
--- /dev/null
+++ b/build/src/base/event/trace.js
@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
diff --git a/index.ts b/index.ts
index 85f4612..51425e7 100644
--- a/index.ts
+++ b/index.ts
@@ -10,7 +10,7 @@ export * from './src/base/event/breadcrumb';
 export * from './src/base/event/event';
 export * from './src/base/event/sourceCodeLine';
 export * from './src/base/event/taskManagerItem';
-export * from './src/base/event/traceContext';
+export * from './src/base/event/trace';
 export * from './src/base/event/addons';
 
 export * from './src/base/integrations/integrationToken';
diff --git a/src/base/event/event.ts b/src/base/event/event.ts
index ce1f80c..f30f774 100644
--- a/src/base/event/event.ts
+++ b/src/base/event/event.ts
@@ -3,7 +3,7 @@ import type { AffectedUser } from './affectedUser.ts';
 import type { EventAddons } from './addons/index.ts';
 import type { Json } from '../../utils/index.ts';
 import type { Breadcrumb } from './breadcrumb.ts';
-import type { TraceContext } from './traceContext.ts';
+import type { EventTrace } from './trace.ts';
 
 /**
  * Information about event (Payload of the event)
@@ -57,9 +57,9 @@ export interface EventData<Addons extends EventAddons> {
   catcherVersion?: string;
 
   /**
-   * Trace metadata for linking related events within the same execution chain.
+   * Distributed trace metadata for linking related events within the same execution chain.
    */
-  traceContext?: TraceContext;
+  trace?: EventTrace;
 }
 
 /**
diff --git a/src/base/event/trace.ts b/src/base/event/trace.ts
new file mode 100644
index 0000000..5445d8c
--- /dev/null
+++ b/src/base/event/trace.ts
@@ -0,0 +1,9 @@
+/**
+ * Distributed trace metadata attached to error and performance events.
+ */
+export interface EventTrace {
+  /**
+   * Shared identifier for events from the same execution chain.
+   */
+  id: string;
+}
diff --git a/src/base/event/traceContext.ts b/src/base/event/traceContext.ts
deleted file mode 100644
index 8dd955e..0000000
--- a/src/base/event/traceContext.ts
+++ /dev/null
@@ -1,9 +0,0 @@
-/**
- * Trace metadata attached to error events for linking related frontend/backend occurrences.
- */
-export interface TraceContext {
-  /**
-   * Shared identifier for events from the same execution chain.
-   */
-  traceId: string;
-}