@koloseum/utils 0.3.1 → 0.3.3

package/dist/client.d.ts

@@ -1,5 +1,5 @@
 import type { BrowserInfo, Microservice, MicroserviceFeature, MicroserviceGroup, MicroserviceObject, MicroserviceRole, UserWithCustomMetadata } from "@koloseum/types/general";
-import type { PronounsCheckboxes } from "@koloseum/types/public-auth";
+import type { PronounsCheckboxes } from "@koloseum/types/public/auth";
 import type { IOptions } from "@suprsend/web-components/dist/types/interface.d.ts";
 import type { Page, SubmitFunction } from "@sveltejs/kit";
 export declare const Browser: {
@@ -128,4 +128,15 @@ export declare const Interface: {
      * @returns `true` if the page is active, `false` otherwise.
      */
     pageIsActive: (page: Page, slug: string | undefined, microservice?: Microservice<MicroserviceGroup>, base?: string) => boolean;
+    /**
+     * Resolves a path and returns the result.
+     * Wraps around the `resolve` function in SvelteKit's `$app/paths` module.
+     *
+     * https://svelte.dev/docs/kit/$app-paths#resolve
+     *
+     * @param path - The path to resolve
+     * @param params - The parameters to resolve the path with
+     * @returns {string} The resolved path without the leading dot
+     */
+    resolvePath: (path: string, params?: Record<string, string>) => Promise<string>;
 };

package/dist/client.js

@@ -117,7 +117,7 @@ export const Browser = {
         if (typeof window === "undefined")
             return {
                 title: "Browser compatibility issue",
-                message: "Browser detection is not available on theserver.",
+                message: "Browser detection is not available on the server.",
                 recommendations: [],
                 critical: false
             };
@@ -467,9 +467,12 @@ export const Interface = {
                     await goto(result.location);
                     return;
                 }
-                // Update form and restore button if not an OTP button
+                // Update form
+                // OTP buttons are not restored on failure/error so OTP flows keep the loading state
                 await update();
-                if (result.type === "failure" || result.type === "error" || !button.classList.contains("otp-button")) {
+                const isOtpButton = button.classList.contains("otp-button");
+                const isFailureOrError = result.type === "failure" || result.type === "error";
+                if (!isOtpButton || !isFailureOrError) {
                     button.disabled = false;
                     button.innerHTML = innerHTML;
                 }
@@ -707,5 +710,20 @@ export const Interface = {
         // Match exact or subpath otherwise
         const target = `${cleanBase}/${slug}`;
         return page.url.pathname === target || page.url.pathname.startsWith(`${target}/`);
+    },
+    /**
+     * Resolves a path and returns the result.
+     * Wraps around the `resolve` function in SvelteKit's `$app/paths` module.
+     *
+     * https://svelte.dev/docs/kit/$app-paths#resolve
+     *
+     * @param path - The path to resolve
+     * @param params - The parameters to resolve the path with
+     * @returns {string} The resolved path without the leading dot
+     */
+    resolvePath: async (path, params = {}) => {
+        const { resolve } = await import("$app/paths");
+        const resolved = resolve(path, params);
+        return resolved.charAt(0) === "." ? resolved.slice(1) : resolved;
     }
 };

package/dist/formatting.d.ts

@@ -1,4 +1,4 @@
-import type { IdentityType, PronounsItem, Sex, SocialMediaPlatform, SocialMediaPlatformObject } from "@koloseum/types/public-auth";
+import type { IdentityType, PronounsItem, Sex, SocialMediaPlatform, SocialMediaPlatformObject } from "@koloseum/types/public/auth";
 import type { MobilePhoneLocale } from "validator";
 export declare const Transform: {
     /**

package/dist/platform.d.ts

@@ -1,5 +1,5 @@
 import type { CustomError, MicroserviceGroup, MicroserviceObject, UserWithCustomMetadata } from "@koloseum/types/general";
-import type { BranchAddressObject, County } from "@koloseum/types/public-auth";
+import type { BranchAddressObject, County } from "@koloseum/types/public/auth";
 export declare const Config: {
     /**
      * A reference of microservices available on the platform, represented as an object with each user group (i.e. `public`, `players`, `lounges`, and `backroom`) having its own array of microservices. Each microservice in a list is an object with the following properties:
@@ -71,6 +71,13 @@ export declare const Resource: {
         url: URL;
         path?: string;
     };
+    /**
+     * Resolves a redirect URI.
+     * @param redirectUri - The redirect URI
+     * @param isDev - Whether the environment is development; defaults to `false`
+     * @returns A resolved redirect URL, or `undefined` if the redirect URI is invalid
+     */
+    resolveRedirectUri: (redirectUri: string | null, isDev?: boolean) => string | undefined;
     /**
      * Validates address data submitted in a form and returns the validated data.
      * @param {FormData} formData - The submitted form data

package/dist/platform.js

@@ -581,7 +581,7 @@ export const Resource = {
             }
             // Handle Landing microservice
             else if (path.startsWith("landing")) {
-                port = 5184;
+                port = 5186;
                 path = path.replace("landing", "");
             }
             // Return redirect URL
@@ -702,6 +702,29 @@ export const Resource = {
         // Return the request URL and path
         return { url, path };
     },
+    /**
+     * Resolves a redirect URI.
+     * @param redirectUri - The redirect URI
+     * @param isDev - Whether the environment is development; defaults to `false`
+     * @returns A resolved redirect URL, or `undefined` if the redirect URI is invalid
+     */
+    resolveRedirectUri: (redirectUri, isDev = false) => {
+        // Return undefined if no input
+        if (!redirectUri)
+            return undefined;
+        // Get safe redirect URL
+        const result = Resource.getSafeRedirectUrl(redirectUri, isDev);
+        if (result && "url" in result && result.url)
+            return result.url;
+        // Return redirect URI if it is a valid path-relative URL
+        if (redirectUri.startsWith("/") && !redirectUri.startsWith("//"))
+            return redirectUri;
+        // Return redirect URI if it is a valid redirect URL
+        if (Resource.validateRedirectUrl(redirectUri, isDev))
+            return redirectUri;
+        // Return undefined if the redirect URI is invalid
+        return undefined;
+    },
     /**
      * Validates address data submitted in a form and returns the validated data.
      * @param {FormData} formData - The submitted form data

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@koloseum/utils",
-	"version": "0.3.1",
+	"version": "0.3.3",
 	"author": "Koloseum Technologies Limited",
 	"type": "module",
 	"description": "Utility logic for use across Koloseum web apps (TypeScript)",
@@ -48,7 +48,8 @@
 		"build": "rm -rf dist && npx tsc",
 		"check": "npx tsc --noEmit && prettier --check .",
 		"format": "prettier --write .",
-		"test": "vitest --run"
+		"test": "vitest --run",
+		"test:coverage": "vitest run --coverage"
 	},
 	"dependencies": {
 		"@supabase/supabase-js": "^2.57.4",
@@ -61,12 +62,13 @@
 		"validator": "^13.15.15"
 	},
 	"devDependencies": {
-		"@koloseum/types": "^0.2.10",
+		"@koloseum/types": "^0.3.2",
 		"@playwright/test": "^1.55.0",
 		"@suprsend/web-components": "^0.4.0",
 		"@types/sanitize-html": "^2.16.0",
 		"@types/uuid": "^10.0.0",
 		"@types/validator": "^13.15.3",
+		"@vitest/coverage-v8": "^3.2.4",
 		"prettier": "^3.6.2",
 		"typescript": "^5.9.2",
 		"vitest": "^3.2.4"