@koloseum/utils 0.2.13 → 0.2.15

package/dist/utils.d.ts

@@ -109,6 +109,12 @@ export declare const Utility: {
      * @returns {Promise<County[]>} A list of objects with the county `name`, `code`, and a list of `subCounties`
      */
     getKenyaCounties: (sortBy?: "name" | "code") => Promise<County[]>;
+    /**
+     * Formats a date to an ISO string in Kenyan time, i.e. `Africa/Nairobi` (UTC+3).
+     * @param {Date | string | number | null} date - The date to format
+     * @returns {string} The formatted date in ISO string format, or an empty string if invalid input
+     */
+    getKenyanISOString: (date: Date | string | number | null) => string;
     /**
      * Returns the URL for a menu item based on the slug.
      * @param {string} base - The base URL
@@ -217,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

@@ -358,6 +358,23 @@ export const Utility = {
         // Return sorted counties
         return counties.sort((a, b) => (sortBy === "name" ? a.name.localeCompare(b.name) : a.code - b.code));
     },
+    /**
+     * Formats a date to an ISO string in Kenyan time, i.e. `Africa/Nairobi` (UTC+3).
+     * @param {Date | string | number | null} date - The date to format
+     * @returns {string} The formatted date in ISO string format, or an empty string if invalid input
+     */
+    getKenyanISOString: (date) => {
+        // Return empty string if no date is provided or input is invalid
+        if (!date || (typeof date !== "string" && typeof date !== "number" && !(date instanceof Date)))
+            return "";
+        // Get locale string to format
+        const dateObj = date instanceof Date ? date : new Date(date);
+        const localeString = dateObj.toLocaleString("sv-SE", {
+            timeZone: "Africa/Nairobi"
+        });
+        // Return formatted string
+        return localeString.replace(" ", "T") + "+03:00";
+    },
     /**
      * Returns the URL for a menu item based on the slug.
      * @param {string} base - The base URL
@@ -1251,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
@@ -1299,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.13",
+	"version": "0.2.15",
 	"author": "Koloseum Technologies Limited",
 	"type": "module",
 	"description": "Utility logic for use across Koloseum web apps (TypeScript)",