chore(types,shared): Move ClerkAPIResponseError to @clerk/types

.changeset/good-toys-serve.md

@@ -0,0 +1,6 @@
+---
+'@clerk/shared': patch
+'@clerk/types': patch
+---
+
+Export `ClerkAPIResponseError` interface from types package.

.typedoc/__tests__/__snapshots__/file-structure.test.ts.snap

@@ -10,6 +10,7 @@ exports[`Typedoc output > should have a deliberate file structure 1`] = `
   "types/check-authorization-params-from-session-claims.mdx",
   "types/check-authorization-with-custom-permissions.mdx",
   "types/clerk-api-error.mdx",
+  "types/clerk-api-response-error.mdx",
   "types/clerk-host-router.mdx",
   "types/clerk-jwt-claims.mdx",
   "types/clerk-paginated-response.mdx",

packages/shared/src/error.ts

@@ -1,4 +1,8 @@
-import type { ClerkAPIError, ClerkAPIErrorJSON } from '@clerk/types';
+import type {
+  ClerkAPIError,
+  ClerkAPIErrorJSON,
+  ClerkAPIResponseError as ClerkAPIResponseErrorInterface,
+} from '@clerk/types';
 
 export function isUnauthorizedError(e: any): boolean {
   const status = e?.status;
@@ -116,7 +120,7 @@ export function errorToJSON(error: ClerkAPIError | null): ClerkAPIErrorJSON {
   };
 }
 
-export class ClerkAPIResponseError extends Error {
+export class ClerkAPIResponseError extends Error implements ClerkAPIResponseErrorInterface {
   clerkError: true;
 
   status: number;

packages/types/src/api.ts

@@ -43,3 +43,15 @@ export interface ClerkRuntimeError {
   code: string;
   message: string;
 }
+
+/**
+ * Interface representing a Clerk API Response Error.
+ */
+export interface ClerkAPIResponseError extends Error {
+  clerkError: true;
+  status: number;
+  message: string;
+  clerkTraceId?: string;
+  retryAfter?: number;
+  errors: ClerkAPIError[];
+}