feat(shared,types): Add clerk trace id to existing errors

Author: nikosdouvlis

packages/shared/src/errors/parseError.ts

@@ -19,6 +19,7 @@ export function parseError(error: ClerkAPIErrorJSON): ClerkAPIError {
     code: error.code,
     message: error.message,
     longMessage: error.long_message,
+    clerkTraceId: error.clerk_trace_id,
     meta: {
       paramName: error?.meta?.param_name,
       sessionId: error?.meta?.session_id,

packages/types/src/api.ts

@@ -14,6 +14,10 @@ export interface ClerkAPIError {
    * A more detailed message that describes the error.
    */
   longMessage?: string;
+  /**
+   * A trace ID that can be used to identify the error in the Clerk API logs.
+   */
+  clerkTraceId?: string;
   /**
    * Additional information about the error.
    */

packages/types/src/json.ts

@@ -363,6 +363,7 @@ export interface ClerkAPIErrorJSON {
   code: string;
   message: string;
   long_message?: string;
+  clerk_trace_id?: string;
   meta?: {
     param_name?: string;
     session_id?: string;