@exodus/error-tracking 3.3.2 → 3.4.0

package/CHANGELOG.md

@@ -3,6 +3,12 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [3.4.0](https://github.com/ExodusMovement/exodus-hydra/compare/@exodus/error-tracking@3.3.2...@exodus/error-tracking@3.4.0) (2026-04-03)
+
+### Features
+
+- feat: add `unsafe__errorTracking` module (#15400)
+
 ## [3.3.2](https://github.com/ExodusMovement/exodus-hydra/compare/@exodus/error-tracking@3.3.1...@exodus/error-tracking@3.3.2) (2026-02-12)
 
 ### Bug Fixes

package/atoms/index.js

@@ -18,3 +18,10 @@ export const remoteErrorTrackingEnabledAtomDefinition = {
   // eslint-disable-next-line @exodus/hydra/in-memory-atom-default-value
   factory: () => createInMemoryAtom(),
 }
+
+export const unsafeRemoteErrorTrackingEnabledAtomDefinition = {
+  id: 'unsafeRemoteErrorTrackingEnabledAtom',
+  type: 'atom',
+  // eslint-disable-next-line @exodus/hydra/in-memory-atom-default-value
+  factory: () => createInMemoryAtom(),
+}

package/index.js

@@ -1,9 +1,17 @@
 import typeforce from '@exodus/typeforce'
 
 import { errorTrackingApiDefinition } from './api/index.js'
-import { errorsAtomDefinition, remoteErrorTrackingEnabledAtomDefinition } from './atoms/index.js'
+import {
+  errorsAtomDefinition,
+  remoteErrorTrackingEnabledAtomDefinition,
+  unsafeRemoteErrorTrackingEnabledAtomDefinition,
+} from './atoms/index.js'
 import errorTrackingReportDefinition from './report/index.js'
-import { errorTrackingDefinition, remoteErrorTrackingDefinition } from './module/index.js'
+import {
+  errorTrackingDefinition,
+  remoteErrorTrackingDefinition,
+  unsafeErrorTrackingDefinition,
+} from './module/index.js'
 import errorTrackingPluginDefinition from './plugin/index.js'
 
 const defaultConfig = {
@@ -46,6 +54,9 @@ const errorTracking = (config = Object.create(null)) => {
       {
         definition: remoteErrorTrackingEnabledAtomDefinition,
       },
+      {
+        definition: unsafeRemoteErrorTrackingEnabledAtomDefinition,
+      },
       {
         definition: errorTrackingApiDefinition,
       },
@@ -58,6 +69,10 @@ const errorTracking = (config = Object.create(null)) => {
         definition: remoteErrorTrackingDefinition,
         config: sentryConfig,
       },
+      {
+        if: remoteErrorTrackingAvailable,
+        definition: unsafeErrorTrackingDefinition,
+      },
       // deprecated, errors will go to sentry
       {
         definition: errorTrackingReportDefinition,

package/module/index.js

@@ -1,2 +1,3 @@
 export { errorTrackingDefinition } from './error-tracking.js'
 export { remoteErrorTrackingDefinition } from './remote-error-tracking.js'
+export { unsafeErrorTrackingDefinition } from './unsafe-error-tracking.js'

package/module/unsafe-error-tracking.js

@@ -0,0 +1,34 @@
+import { captureStackTrace } from '@exodus/errors'
+
+const createUnsafeErrorTracking = ({
+  unsafeRemoteErrorTrackingEnabledAtom,
+  remoteErrorTracking,
+  logger,
+}) => {
+  const track = async ({ error, context }) => {
+    if (!remoteErrorTracking) return
+
+    if (!(error instanceof Error)) {
+      logger.error(new TypeError('error must be an instance of Error'))
+      return
+    }
+
+    captureStackTrace(error)
+    logger.error(error)
+    const enabled = await unsafeRemoteErrorTrackingEnabledAtom.get()
+    if (!enabled) return
+
+    await remoteErrorTracking.track({ error, context })
+  }
+
+  return { track }
+}
+
+export const unsafeErrorTrackingDefinition = {
+  // eslint-disable-next-line @exodus/hydra/dependency-ids
+  id: 'unsafe__errorTracking',
+  type: 'module',
+  factory: createUnsafeErrorTracking,
+  dependencies: ['unsafeRemoteErrorTrackingEnabledAtom', 'remoteErrorTracking?', 'logger'],
+  public: true,
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exodus/error-tracking",
-  "version": "3.3.2",
+  "version": "3.4.0",
   "type": "module",
   "description": "A simple error tracking package to let any feature collect errors and create the report",
   "author": "Exodus Movement, Inc.",
@@ -33,7 +33,7 @@
   },
   "dependencies": {
     "@exodus/atoms": "^9.0.0",
-    "@exodus/basic-utils": "^3.0.1",
+    "@exodus/basic-utils": "^3.7.3",
     "@exodus/errors": "^3.7.0",
     "@exodus/safe-string": "^1.4.0",
     "@exodus/sentry-client": "^6.2.0",
@@ -41,11 +41,11 @@
     "@exodus/zod": "^3.24.2"
   },
   "devDependencies": {
-    "@exodus/traceparent": "^2.0.0"
+    "@exodus/traceparent": "^3.0.1"
   },
   "publishConfig": {
     "access": "public",
     "provenance": false
   },
-  "gitHead": "fe153ece541b24d322016b462ea1331a11811ed2"
+  "gitHead": "d70ddc5076017b6f1b5845c99eff340fc5ef0cdf"
 }

package/plugin/index.js

@@ -1,6 +1,9 @@
 import { combine, compute } from '@exodus/atoms'
 
-import { whyIsRemoteTrackingDisabled } from './why-is-remote-tracking-disabled.js'
+import {
+  whyIsRemoteTrackingDisabled,
+  whyIsUnsafeRemoteTrackingDisabled,
+} from './why-is-remote-tracking-disabled.js'
 
 function errorTrackingPlugin({
   abTestingAtom,
@@ -8,6 +11,7 @@ function errorTrackingPlugin({
   walletCreatedAtAtom,
   getBuildMetadata,
   remoteErrorTrackingEnabledAtom,
+  unsafeRemoteErrorTrackingEnabledAtom,
   config: {
     remoteErrorTrackingABExperimentId,
     remoteErrorTrackingFundedWalletsABExperimentId,
@@ -18,6 +22,16 @@ function errorTrackingPlugin({
 }) {
   const subscriptions = []
 
+  const toEnabled = (reasonDisabled, label) => {
+    if (reasonDisabled) {
+      logger.debug(`${label} is disabled: ${reasonDisabled}`)
+      return false
+    }
+
+    logger.debug(`${label} is enabled`)
+    return true
+  }
+
   const onAssetsSynced = async () => {
     if (!abTestingAtom) {
       logger.debug('remote error tracking is disabled, ab-testing feature not found')
@@ -32,31 +46,43 @@ function errorTrackingPlugin({
         earliestTxDate: earliestTxDateAtom,
         walletCreatedAt: walletCreatedAtAtom,
       }),
-      selector: async ({ abTesting, earliestTxDate, walletCreatedAt }) => {
-        const reasonDisabled = whyIsRemoteTrackingDisabled({
-          remoteErrorTrackingABExperimentId,
-          remoteErrorTrackingFundedWalletsABExperimentId,
-          abTesting,
-          trackWalletsCreatedAfter,
-          walletCreatedAt,
-          trackFundedWallets,
-          earliestTxDate,
-          buildMetadata: await getBuildMetadata(),
-          logger,
-        })
+      selector: async ({ abTesting, earliestTxDate, walletCreatedAt }) =>
+        toEnabled(
+          whyIsRemoteTrackingDisabled({
+            remoteErrorTrackingABExperimentId,
+            remoteErrorTrackingFundedWalletsABExperimentId,
+            abTesting,
+            trackWalletsCreatedAfter,
+            walletCreatedAt,
+            trackFundedWallets,
+            earliestTxDate,
+            buildMetadata: await getBuildMetadata(),
+            logger,
+          }),
+          'remote error tracking'
+        ),
+    })
 
-        if (reasonDisabled) {
-          logger.debug(`remote error tracking is disabled: ${reasonDisabled}`)
-          return false
-        }
+    subscriptions.push(
+      internalRemoteErrorTrackingEnabledAtom.observe(remoteErrorTrackingEnabledAtom.set)
+    )
 
-        logger.debug('remote error tracking is enabled')
-        return true
-      },
+    const internalUnsafeRemoteErrorTrackingEnabledAtom = compute({
+      atom: abTestingAtom,
+      selector: async (abTesting) =>
+        toEnabled(
+          whyIsUnsafeRemoteTrackingDisabled({
+            remoteErrorTrackingABExperimentId,
+            abTesting,
+            buildMetadata: await getBuildMetadata(),
+            logger,
+          }),
+          'unsafe remote error tracking'
+        ),
     })
 
     subscriptions.push(
-      internalRemoteErrorTrackingEnabledAtom.observe(remoteErrorTrackingEnabledAtom.set)
+      internalUnsafeRemoteErrorTrackingEnabledAtom.observe(unsafeRemoteErrorTrackingEnabledAtom.set)
     )
   }
 
@@ -80,6 +106,7 @@ const errorTrackingPluginDefinition = {
     'earliestTxDateAtom',
     'walletCreatedAtAtom',
     'remoteErrorTrackingEnabledAtom',
+    'unsafeRemoteErrorTrackingEnabledAtom',
     'getBuildMetadata',
     'config',
     'logger',

package/plugin/why-is-remote-tracking-disabled.js

@@ -59,6 +59,14 @@ export class ErrorTrackingAbExperiment {
   }
 }
 
+function whyIsExperimentDisabled({ experimentId, abTesting, logger, prefix = '' }) {
+  const experiment = new ErrorTrackingAbExperiment({ experimentId, abTesting, logger })
+
+  if (!experiment.hasExperimentId) return `${prefix}missing-ab-experiment-id`
+  if (!experiment.enabled) return `${prefix}ab-experiment-disabled`
+  if (experiment.variant !== 'enabled') return `${prefix}ab-experiment-variant-disabled`
+}
+
 export function whyIsRemoteTrackingDisabled({
   remoteErrorTrackingABExperimentId,
   remoteErrorTrackingFundedWalletsABExperimentId,
@@ -72,20 +80,12 @@ export function whyIsRemoteTrackingDisabled({
 }) {
   if (buildMetadata.dev) return 'dev-mode'
 
-  const unfundedExperiment = new ErrorTrackingAbExperiment({
+  const baseDisabledReason = whyIsExperimentDisabled({
     experimentId: remoteErrorTrackingABExperimentId,
     abTesting,
     logger,
   })
-
-  if (!unfundedExperiment.hasExperimentId) return 'missing-ab-experiment-id'
-  if (!unfundedExperiment.enabled) {
-    return 'ab-experiment-disabled'
-  }
-
-  if (unfundedExperiment.variant !== 'enabled') {
-    return 'ab-experiment-variant-disabled'
-  }
+  if (baseDisabledReason) return baseDisabledReason
 
   if (
     trackWalletsCreatedAfter &&
@@ -103,21 +103,26 @@ export function whyIsRemoteTrackingDisabled({
   }
 
   // FUNDED WALLETS: separate AB experiment
-  const fundedExperiment = new ErrorTrackingAbExperiment({
+  const fundedDisabledReason = whyIsExperimentDisabled({
     experimentId: remoteErrorTrackingFundedWalletsABExperimentId,
     abTesting,
     logger,
+    prefix: 'funded-wallets-',
   })
+  if (fundedDisabledReason) return fundedDisabledReason
+}
 
-  if (!fundedExperiment.hasExperimentId) {
-    return 'missing-funded-wallets-ab-experiment-id'
-  }
-
-  if (!fundedExperiment.enabled) {
-    return 'funded-wallets-ab-experiment-disabled'
-  }
+export function whyIsUnsafeRemoteTrackingDisabled({
+  remoteErrorTrackingABExperimentId,
+  abTesting,
+  buildMetadata,
+  logger,
+}) {
+  if (buildMetadata.dev) return 'dev-mode'
 
-  if (fundedExperiment.variant !== 'enabled') {
-    return 'funded-wallets-ab-experiment-variant-disabled'
-  }
+  return whyIsExperimentDisabled({
+    experimentId: remoteErrorTrackingABExperimentId,
+    abTesting,
+    logger,
+  })
 }