@exodus/error-tracking 3.2.0 → 3.3.1

package/CHANGELOG.md

@@ -3,6 +3,16 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [3.3.1](https://github.com/ExodusMovement/exodus-hydra/compare/@exodus/error-tracking@3.3.0...@exodus/error-tracking@3.3.1) (2026-02-10)
+
+**Note:** Version bump only for package @exodus/error-tracking
+
+## [3.3.0](https://github.com/ExodusMovement/exodus-hydra/compare/@exodus/error-tracking@3.2.0...@exodus/error-tracking@3.3.0) (2025-11-20)
+
+### Features
+
+- feat: allow exporting `traceId` in errors context (#14099)
+
 ## [3.2.0](https://github.com/ExodusMovement/exodus-hydra/compare/@exodus/error-tracking@3.1.2...@exodus/error-tracking@3.2.0) (2025-10-14)
 
 ### Features

package/README.md

@@ -16,20 +16,46 @@ This feature is designed to be used together with `@exodus/headless`. See [using
 
 1. Open the playground https://exodus-hydra.pages.dev/features/errors
 2. Try out the some methods via the UI. These corresponds 1:1 with the `exodus.errors` API.
-3. Run `await exodus.errors.track({ namespace: 'balances', error: 'Encountered an issue when computing total balances', context: {} })` in the Dev Tools Console.
+3. Run in the Dev Tools Console:
+
+```ts
+await exodus.errors.track({
+  namespace: safeString`balances`,
+  error: new Error('Encountered an issue when computing total balances'),
+  context: {},
+})
+```
 
 ### API Side
 
 See [using the sdk](../../docs/development/using-the-sdk.md#setup-the-api-side) for more details on how features plug into the SDK and the API interface in the [type declaration](./api/index.d.ts).
 
 ```ts
+import { safeString } from '@exodus/safe-string'
 import type { SafeContextType } from '@exodus/errors'
 
 // Track error with optional context (see SafeContextType for available properties).
 const context: SafeContextType = {
   /* ... */
 }
-await exodus.errors.track({ namespace: 'wallet', error, context })
+await exodus.errors.track({ namespace: safeString`wallet`, error, context })
+```
+
+**Important:** The `namespace` parameter must be a SafeString to prevent dynamic values from being used. Use the `safeString` template tag from `@exodus/safe-string`:
+
+```ts
+// ✅ Correct - safe string namespace
+await exodus.errors.track({
+  namespace: safeString`balances`,
+  error: new Error('Failed to compute balances'),
+})
+
+// ❌ Incorrect - plain strings not allowed
+const NAMESPACE = 'my-namespace'
+await exodus.errors.track({
+  namespace: NAMESPACE,
+  error: new Error('Some error'),
+})
 ```
 
 If you're building a feature and like to use error tracking inside that feature, you can depend on `errorTracking` and will receive the module with a track method that is auto-namespaced to your feature id.

package/api/index.d.ts

@@ -1,16 +1,20 @@
+import type { SafeString } from '@exodus/safe-string'
+
 export interface ErrorTrackingApi {
   /**
    * Track an error
    * @example
    * ```typescript
+   * import { safeString } from '@exodus/safe-string'
+   *
    * exodus.errors.track({
-   *   namespace: 'balances',
+   *   namespace: safeString`balances`,
    *   error: new Error('Encountered an issue when computing total balances'),
    *   context: {},
    * })
    * ```
    */
-  track(params: { error: Error; namespace: string; context?: any }): Promise<void>
+  track(params: { error: Error; namespace: SafeString; context?: any }): Promise<void>
 }
 
 declare const errorTrackingApiDefinition: {

package/module/error-tracking.js

@@ -1,3 +1,5 @@
+import { isSafe } from '@exodus/safe-string'
+
 const MODULE_ID = 'errorTracking'
 
 const createErrorTracking = ({
@@ -16,7 +18,15 @@ const createErrorTracking = ({
     logger.error(error)
 
     if (namespace !== undefined && typeof namespace !== 'string') {
-      return onError(new Error('namespace must be a string'))
+      return onError(new TypeError('namespace must be a string'))
+    }
+
+    if (namespace !== undefined && !isSafe(namespace)) {
+      return onError(
+        new TypeError(
+          'namespace must be a safe string. Use safeString`your-namespace` from @exodus/safe-string'
+        )
+      )
     }
 
     if (!(error instanceof Error)) {

package/module/index.d.ts

@@ -1,19 +1,22 @@
 import type { ErrorsAtom } from '../atoms/index.js'
 import type { SafeContextType } from '@exodus/errors'
+import type { SafeString } from '@exodus/safe-string'
 
 export interface ErrorTrackingModule {
   /**
    * Track an error
    * @example
    * ```typescript
+   * import { safeString } from '@exodus/safe-string'
+   *
    * errorTracking.track({
-   *   namespace: 'balances',
+   *   namespace: safeString`balances`,
    *   error: new Error('Encountered an issue when computing total balances'),
    *   context: {},
    * })
    * ```
    */
-  track(params: { error: Error; namespace: string; context?: SafeContextType }): Promise<void>
+  track(params: { error: Error; namespace: SafeString; context?: SafeContextType }): Promise<void>
 }
 
 declare const errorTrackingModuleDefinition: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exodus/error-tracking",
-  "version": "3.2.0",
+  "version": "3.3.1",
   "type": "module",
   "description": "A simple error tracking package to let any feature collect errors and create the report",
   "author": "Exodus Movement, Inc.",
@@ -35,6 +35,7 @@
     "@exodus/atoms": "^9.0.0",
     "@exodus/basic-utils": "^3.0.1",
     "@exodus/errors": "^3.4.0",
+    "@exodus/safe-string": "^1.2.1",
     "@exodus/sentry-client": "^6.2.0",
     "@exodus/typeforce": "^1.19.0",
     "@exodus/zod": "^3.24.2"
@@ -43,5 +44,5 @@
     "access": "public",
     "provenance": false
   },
-  "gitHead": "1c7823e1ee4d02280aff05d67169e915ed7909ca"
+  "gitHead": "526b4891a8940214343e20e27ff694937c01aad3"
 }

package/report/index.js

@@ -1,4 +1,4 @@
-import { SafeError } from '@exodus/errors'
+import { SafeError, SafeContext } from '@exodus/errors'
 import { memoize } from '@exodus/basic-utils'
 import { z } from '@exodus/zod'
 
@@ -14,6 +14,7 @@ const errorTrackingReportDefinition = {
           namespace,
           error: SafeError.from(error),
           time,
+          context,
         })),
       }
     },
@@ -26,6 +27,7 @@ const errorTrackingReportDefinition = {
                 namespace: z.string(),
                 error: z.instanceof(SafeError),
                 time: z.number(),
+                context: SafeContext.getSchema(),
               })
               .strict()
           ),