@koloseum/utils 0.1.15 → 0.1.16

package/dist/utils.d.ts

@@ -3,6 +3,7 @@ import type { CustomError, Microservice, MicroserviceGroup, MicroserviceObject }
 import type { PronounsCheckboxes, SocialMediaPlatform } from "@koloseum/types/public-auth";
 import type { Page } from "@sveltejs/kit";
 import type { SupabaseClient, PostgrestError } from "@supabase/supabase-js";
+import type { suprsend } from "@suprsend/node-sdk";
 import type { IOptions } from "@suprsend/web-components/dist/types/interface.d.ts";
 import type { MobilePhoneLocale } from "validator";
 export declare const Status: {
@@ -173,4 +174,20 @@ export declare const Utility: {
      * @returns `true` if the handle is valid; `false` otherwise
      */
     validateSocialMediaHandle: (handle: string) => boolean;
+    /**
+     * Validates a SuprSend subscriber. If the subscriber does not exist, it will be created with the provided person data.
+     * @param {suprsend.Suprsend} suprSend - The SuprSend instance.
+     * @param {string} userId - The user ID.
+     * @param {Object} personData - The person data; required if the subscriber does not exist.
+     * @returns {Promise<{ error?: CustomError; success?: true }>} A promise that resolves to an object with an error if the subscriber validation fails, or indicating success otherwise.
+     */
+    validateSuprSendSubscriber: (suprSend: suprsend.Suprsend, userId: string, personData?: {
+        firstName: string;
+        lastName: string;
+        phone: string;
+        pseudonym?: string;
+    }) => Promise<{
+        error?: CustomError;
+        success?: true;
+    }>;
 };

package/dist/utils.js

@@ -690,5 +690,43 @@ export const Utility = {
      */
     validateSocialMediaHandle: (handle) => !isURL(handle, { require_protocol: false }) &&
         !handle.startsWith("@") &&
-        Boolean(handle.match(Utility.socialMediaHandleRegex))
+        Boolean(handle.match(Utility.socialMediaHandleRegex)),
+    /**
+     * Validates a SuprSend subscriber. If the subscriber does not exist, it will be created with the provided person data.
+     * @param {suprsend.Suprsend} suprSend - The SuprSend instance.
+     * @param {string} userId - The user ID.
+     * @param {Object} personData - The person data; required if the subscriber does not exist.
+     * @returns {Promise<{ error?: CustomError; success?: true }>} A promise that resolves to an object with an error if the subscriber validation fails, or indicating success otherwise.
+     */
+    validateSuprSendSubscriber: async (suprSend, userId, personData) => {
+        // Check if subscriber exists
+        try {
+            await suprSend.users.get(userId);
+        }
+        catch (_err) {
+            // If person data is not provided, return an error
+            if (!personData)
+                return { error: Utility.customError(400, "Person data is required to create a SuprSend subscriber.") };
+            // Destructure person data
+            const { firstName, lastName, phone, pseudonym } = personData;
+            // Create subscriber
+            const subscriber = suprSend.user.get_instance(userId);
+            if (!subscriber)
+                return { error: Utility.customError(500, Status.ERROR) };
+            // Set subscriber details
+            subscriber.set_preferred_language("en");
+            subscriber.set_timezone("Africa/Nairobi");
+            subscriber.set("firstName", firstName);
+            subscriber.set("lastName", lastName);
+            subscriber.set("phone", `+${phone}`);
+            if (pseudonym)
+                subscriber.set("pseudonym", pseudonym);
+            // Save subscriber
+            const response = await subscriber.save();
+            if (!response.success)
+                return { error: Utility.customError(500, Status.ERROR) };
+        }
+        // Return success
+        return { success: true };
+    }
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@koloseum/utils",
-	"version": "0.1.15",
+	"version": "0.1.16",
 	"author": "Koloseum Technologies Limited",
 	"type": "module",
 	"description": "Utility logic for use across Koloseum web apps (TypeScript)",
@@ -37,6 +37,7 @@
 	"devDependencies": {
 		"@koloseum/types": "^0.1.12",
 		"@playwright/test": "^1.50.1",
+		"@suprsend/node-sdk": "^1.13.0",
 		"@suprsend/web-components": "^0.2.1",
 		"@types/sanitize-html": "^2.13.0",
 		"@types/validator": "^13.12.2",