refactor: share normalizeThrown; drop unsafe error as Error casts

Extract Try.normalizeThrown into src/utils/normalize.ts so transformer
error handlers can use it instead of casting unknown → Error. Keep the
private wrapper on Try for source compatibility.

Author: w01fgang

src/core/Try.ts

@@ -7,6 +7,7 @@ import {
   ValidateKeys,
   BreadcrumbExtractor as BreadcrumbExtractorType,
   BreadcrumbExtractorUtil,
+  normalizeThrown,
 } from '../utils';
 import { Reporter, NoopReporter } from './reporter';
 
@@ -788,7 +789,7 @@ export class Try<
             if (this.config.debug) {
               console.error(e);
             }
-            const error = Try.normalizeThrown(e);
+            const error = normalizeThrown(e);
             this.exec.result = { success: false, error };
             return this.exec.result;
           })
@@ -809,7 +810,7 @@ export class Try<
       if (this.config.debug) {
         console.error(e);
       }
-      const error = Try.normalizeThrown(e);
+      const error = normalizeThrown(e);
       this.exec.isAsync = false;
       this.exec.result = { success: false, error };
     } finally {
@@ -823,10 +824,7 @@ export class Try<
   }
 
   private static normalizeThrown(e: unknown): Error {
-    if (e instanceof Error) return e;
-    const wrapped = new Error(`Non-Error thrown (${typeof e})`);
-    wrapped.cause = e;
-    return wrapped;
+    return normalizeThrown(e);
   }
 
   private runFinallyCallback(): void | Promise<void> {

src/utils/index.ts

@@ -5,3 +5,4 @@
 export * from './types';
 export * from './transformers';
 export * from './breadcrumbs';
+export * from './normalize';

src/utils/normalize.ts

@@ -0,0 +1,12 @@
+/**
+ * Normalize any thrown value into a real `Error` instance. If the value is
+ * already an `Error`, returned unchanged. Otherwise wrapped in a fresh
+ * `Error` whose `message` records the `typeof` and whose `cause` preserves
+ * the original value.
+ */
+export function normalizeThrown(e: unknown): Error {
+  if (e instanceof Error) return e;
+  const wrapped = new Error(`Non-Error thrown (${typeof e})`);
+  wrapped.cause = e;
+  return wrapped;
+}

src/utils/transformers.ts

@@ -1,5 +1,6 @@
 import type { BreadcrumbTransformer } from './types';
 import { BreadcrumbTransformationError } from './types';
+import { normalizeThrown } from './normalize';
 
 /**
  * Predefined transformer functions for common use cases
@@ -61,7 +62,7 @@ export class TransformerRegistry {
       return transformer(value);
     } catch (error) {
       const transformationError = new BreadcrumbTransformationError(
-        error as Error,
+        normalizeThrown(error),
         'custom',
       );
 
@@ -87,7 +88,7 @@ export class TransformerRegistry {
       return transformer(value, paramIndex);
     } catch (error) {
       const transformationError = new BreadcrumbTransformationError(
-        error as Error,
+        normalizeThrown(error),
         transformerType,
         paramIndex,
       );