@koloseum/utils 0.2.14 → 0.2.15

package/dist/utils.d.ts

@@ -223,9 +223,10 @@ export declare const Utility: {
     /**
      * Parses a `PostgrestError` object and returns a custom error object if any has occurred.
      * @param {PostgrestError | null} postgrestError - The `PostgrestError` object, or `null` if no error occurred
+     * @param {boolean} clientSafe - Whether to clamp 5xx errors down to 422 to prevent Sentry from capturing them as unhandled; defaults to `true`
      * @returns An object with an `error` if any has occurred
      */
-    parsePostgrestError: (postgrestError: PostgrestError | null) => {
+    parsePostgrestError: (postgrestError: PostgrestError | null, clientSafe?: boolean) => {
         error?: CustomError;
     };
     /**

package/dist/utils.js

@@ -1268,17 +1268,21 @@ export const Utility = {
     /**
      * Parses a `PostgrestError` object and returns a custom error object if any has occurred.
      * @param {PostgrestError | null} postgrestError - The `PostgrestError` object, or `null` if no error occurred
+     * @param {boolean} clientSafe - Whether to clamp 5xx errors down to 422 to prevent Sentry from capturing them as unhandled; defaults to `true`
      * @returns An object with an `error` if any has occurred
      */
-    parsePostgrestError: (postgrestError) => {
+    parsePostgrestError: (postgrestError, clientSafe = true) => {
         // Return undefined if no error occurred
         let error;
         if (!postgrestError)
             return { error };
-        // Return custom error if hint is a number between 400 and 599
+        // Get custom error code from hint
         const customErrorCode = Number(postgrestError.hint);
+        // Clamp 5xx errors down to 422 to prevent Sentry from capturing them as unhandled; see https://koloseum-technologies.sentry.io/issues/6766267685/
+        let statusCode = clientSafe ? (customErrorCode >= 500 ? 422 : customErrorCode) : customErrorCode;
+        // Return custom error if hint is a number between 400 and 599
         if (!isNaN(customErrorCode) && customErrorCode >= 400 && customErrorCode <= 599) {
-            error = Utility.customError(customErrorCode, postgrestError.message);
+            error = Utility.customError(statusCode, postgrestError.message);
             return { error };
         }
         // Map Postgrest error codes to custom error codes
@@ -1316,11 +1320,12 @@ export const Utility = {
         // Return custom error if Postgrest error code is found
         for (const { code, status } of errorMap)
             if (postgrestError.code === code || postgrestError.code.startsWith(code)) {
-                error = Utility.customError(status, Status.ERROR);
+                statusCode = clientSafe ? (status >= 500 ? 422 : status) : status;
+                error = Utility.customError(statusCode, Status.ERROR);
                 return { error };
             }
         // Return generic error
-        error = Utility.customError(500, Status.ERROR);
+        error = Utility.customError(clientSafe ? 422 : 500, Status.ERROR);
         return { error };
     },
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@koloseum/utils",
-	"version": "0.2.14",
+	"version": "0.2.15",
 	"author": "Koloseum Technologies Limited",
 	"type": "module",
 	"description": "Utility logic for use across Koloseum web apps (TypeScript)",