@koloseum/utils 0.2.12 → 0.2.14

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@koloseum/utils",
-	"version": "0.2.12",
+	"version": "0.2.14",
 	"author": "Koloseum Technologies Limited",
 	"type": "module",
 	"description": "Utility logic for use across Koloseum web apps (TypeScript)",
@@ -32,6 +32,7 @@
 		"@supabase/supabase-js": "^2.50.1",
 		"@sveltejs/kit": "^2.22.0",
 		"kenya-administrative-divisions": "^0.0.18",
+		"postgres-interval": "^4.0.2",
 		"sanitize-html": "^2.17.0",
 		"uuid": "^11.1.0",
 		"validator": "^13.15.15"
@@ -43,7 +44,6 @@
 		"@types/sanitize-html": "^2.16.0",
 		"@types/uuid": "^10.0.0",
 		"@types/validator": "^13.15.2",
-		"postgres-interval": "^4.0.2",
 		"prettier": "^3.6.0",
 		"typescript": "^5.8.3",
 		"vitest": "^3.2.4"