@enfyra/sdk-nuxt 0.3.9 → 0.3.11

package/dist/composables/useEnfyraApi.mjs

@@ -1,6 +1,6 @@
 import { ref, unref, toRaw } from "vue";
 import { $fetch } from "../utils/http";
-import { getAppUrl } from "../utils/url";
+import { getAppUrl, normalizeUrl } from "../utils/url";
 import { ENFYRA_API_PREFIX } from "../constants/config";
 import { useRuntimeConfig, useFetch, useRequestHeaders } from "#imports";
 function handleError(error, context, customHandler) {
@@ -25,7 +25,11 @@ export function useEnfyraApi(path, opts = {}) {
     const config = useRuntimeConfig().public.enfyraSDK;
     const basePath = (typeof path === "function" ? path() : path).replace(/^\/?api\/?/, "").replace(/^\/+/, "");
     const appUrl = getAppUrl();
-    const finalUrl = appUrl + (config?.apiPrefix || ENFYRA_API_PREFIX) + "/" + basePath;
+    const finalUrl = normalizeUrl(
+      appUrl,
+      config?.apiPrefix || ENFYRA_API_PREFIX,
+      basePath
+    );
     const clientHeaders = process.client ? {} : useRequestHeaders([
       "authorization",
       "cookie",
@@ -76,7 +80,7 @@ export function useEnfyraApi(path, opts = {}) {
       const buildPath = (...segments) => {
         return segments.filter(Boolean).join("/");
       };
-      const fullBaseURL = apiUrl + (apiPrefix || ENFYRA_API_PREFIX);
+      const fullBaseURL = normalizeUrl(apiUrl, apiPrefix || ENFYRA_API_PREFIX);
       async function processBatch(items, processor) {
         const results = [];
         const progressResults = [];

package/dist/module.cjs

@@ -10,11 +10,18 @@ const module$1 = kit.defineNuxtModule({
     configKey: "enfyraSDK"
   },
   defaults: {
-    apiUrl: ""
+    apiUrl: "",
+    apiPrefix: config_mjs.ENFYRA_API_PREFIX
   },
   setup(options, nuxt) {
+    const normalizedOptions = {
+      ...options,
+      apiUrl: typeof options.apiUrl === "string" ? options.apiUrl.replace(/\/+$/, "") : options.apiUrl,
+      apiPrefix: typeof options.apiPrefix === "string" ? options.apiPrefix.trim() ? "/" + options.apiPrefix.replace(/^\/+|\/+$/g, "").replace(/\/+/g, "/") : config_mjs.ENFYRA_API_PREFIX : config_mjs.ENFYRA_API_PREFIX
+    };
+    const apiPrefix = normalizedOptions.apiPrefix;
     const { resolve } = kit.createResolver((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('module.cjs', document.baseURI).href)));
-    if (!options.apiUrl) {
+    if (!normalizedOptions.apiUrl) {
       console.warn(
         `[Enfyra SDK Nuxt] Missing required configuration:
 - apiUrl is required
@@ -24,18 +31,18 @@ enfyraSDK: {
 }`
       );
       nuxt.options.runtimeConfig.public.enfyraSDK = {
-        ...options,
-        apiPrefix: config_mjs.ENFYRA_API_PREFIX,
+        ...normalizedOptions,
+        apiPrefix,
         configError: true,
         configErrorMessage: "Enfyra SDK: apiUrl is required. Please configure it in nuxt.config.ts"
       };
     } else {
       nuxt.options.runtimeConfig.public.enfyraSDK = {
-        ...options,
-        apiPrefix: config_mjs.ENFYRA_API_PREFIX
+        ...normalizedOptions,
+        apiPrefix
       };
     }
-    if (!options.apiUrl) {
+    if (!normalizedOptions.apiUrl) {
       kit.addPlugin({
         src: resolve("./runtime/plugin/config-error.client"),
         mode: "client"
@@ -47,12 +54,12 @@ enfyraSDK: {
       middleware: true
     });
     kit.addServerHandler({
-      route: `${config_mjs.ENFYRA_API_PREFIX}/login`,
+      route: `${apiPrefix}/login`,
       handler: resolve("./runtime/server/api/login.post"),
       method: "post"
     });
     kit.addServerHandler({
-      route: `${config_mjs.ENFYRA_API_PREFIX}/logout`,
+      route: `${apiPrefix}/logout`,
       handler: resolve("./runtime/server/api/logout.post"),
       method: "post"
     });
@@ -61,7 +68,7 @@ enfyraSDK: {
       handler: resolve("./runtime/server/api/all")
     });
     kit.addServerHandler({
-      route: `${config_mjs.ENFYRA_API_PREFIX}/**`,
+      route: `${apiPrefix}/**`,
       handler: resolve("./runtime/server/api/all")
     });
   }

package/dist/module.d.cts

@@ -2,8 +2,10 @@ import * as _nuxt_schema from '@nuxt/schema';
 
 declare const _default: _nuxt_schema.NuxtModule<{
     apiUrl: string;
+    apiPrefix: string;
 }, {
     apiUrl: string;
+    apiPrefix: string;
 }, false>;
 
 export { _default as default };

package/dist/module.d.mts

@@ -2,8 +2,10 @@ import * as _nuxt_schema from '@nuxt/schema';
 
 declare const _default: _nuxt_schema.NuxtModule<{
     apiUrl: string;
+    apiPrefix: string;
 }, {
     apiUrl: string;
+    apiPrefix: string;
 }, false>;
 
 export { _default as default };

package/dist/module.d.ts

@@ -2,8 +2,10 @@ import * as _nuxt_schema from '@nuxt/schema';
 
 declare const _default: _nuxt_schema.NuxtModule<{
     apiUrl: string;
+    apiPrefix: string;
 }, {
     apiUrl: string;
+    apiPrefix: string;
 }, false>;
 
 export { _default as default };

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "@enfyra/sdk-nuxt",
   "configKey": "enfyraSDK",
-  "version": "0.3.9",
+  "version": "0.3.11",
   "builder": {
     "@nuxt/module-builder": "0.8.4",
     "unbuild": "2.0.0"

package/dist/module.mjs

@@ -7,11 +7,18 @@ const module = defineNuxtModule({
     configKey: "enfyraSDK"
   },
   defaults: {
-    apiUrl: ""
+    apiUrl: "",
+    apiPrefix: ENFYRA_API_PREFIX
   },
   setup(options, nuxt) {
+    const normalizedOptions = {
+      ...options,
+      apiUrl: typeof options.apiUrl === "string" ? options.apiUrl.replace(/\/+$/, "") : options.apiUrl,
+      apiPrefix: typeof options.apiPrefix === "string" ? options.apiPrefix.trim() ? "/" + options.apiPrefix.replace(/^\/+|\/+$/g, "").replace(/\/+/g, "/") : ENFYRA_API_PREFIX : ENFYRA_API_PREFIX
+    };
+    const apiPrefix = normalizedOptions.apiPrefix;
     const { resolve } = createResolver(import.meta.url);
-    if (!options.apiUrl) {
+    if (!normalizedOptions.apiUrl) {
       console.warn(
         `[Enfyra SDK Nuxt] Missing required configuration:
 - apiUrl is required
@@ -21,18 +28,18 @@ enfyraSDK: {
 }`
       );
       nuxt.options.runtimeConfig.public.enfyraSDK = {
-        ...options,
-        apiPrefix: ENFYRA_API_PREFIX,
+        ...normalizedOptions,
+        apiPrefix,
         configError: true,
         configErrorMessage: "Enfyra SDK: apiUrl is required. Please configure it in nuxt.config.ts"
       };
     } else {
       nuxt.options.runtimeConfig.public.enfyraSDK = {
-        ...options,
-        apiPrefix: ENFYRA_API_PREFIX
+        ...normalizedOptions,
+        apiPrefix
       };
     }
-    if (!options.apiUrl) {
+    if (!normalizedOptions.apiUrl) {
       addPlugin({
         src: resolve("./runtime/plugin/config-error.client"),
         mode: "client"
@@ -44,12 +51,12 @@ enfyraSDK: {
       middleware: true
     });
     addServerHandler({
-      route: `${ENFYRA_API_PREFIX}/login`,
+      route: `${apiPrefix}/login`,
       handler: resolve("./runtime/server/api/login.post"),
       method: "post"
     });
     addServerHandler({
-      route: `${ENFYRA_API_PREFIX}/logout`,
+      route: `${apiPrefix}/logout`,
       handler: resolve("./runtime/server/api/logout.post"),
       method: "post"
     });
@@ -58,7 +65,7 @@ enfyraSDK: {
       handler: resolve("./runtime/server/api/all")
     });
     addServerHandler({
-      route: `${ENFYRA_API_PREFIX}/**`,
+      route: `${apiPrefix}/**`,
       handler: resolve("./runtime/server/api/all")
     });
   }

package/dist/runtime/server/api/login.post.js

@@ -13,12 +13,13 @@ import {
   REFRESH_TOKEN_KEY,
   EXP_TIME_KEY
 } from "../../../constants/auth";
+import { normalizeUrl } from "../../../utils/url";
 export default defineEventHandler(async (event) => {
   const config = useRuntimeConfig();
   const apiUrl = config.public.enfyraSDK?.apiUrl;
   try {
     const body = await readBody(event);
-    const response = await $fetch(`${apiUrl}/auth/login`, {
+    const response = await $fetch(normalizeUrl(apiUrl, "/auth/login"), {
       method: "POST",
       body,
       headers: {

package/dist/runtime/server/api/login.post.mjs

@@ -13,12 +13,13 @@ import {
   REFRESH_TOKEN_KEY,
   EXP_TIME_KEY
 } from "../../../constants/auth";
+import { normalizeUrl } from "../../../utils/url";
 export default defineEventHandler(async (event) => {
   const config = useRuntimeConfig();
   const apiUrl = config.public.enfyraSDK?.apiUrl;
   try {
     const body = await readBody(event);
-    const response = await $fetch(`${apiUrl}/auth/login`, {
+    const response = await $fetch(normalizeUrl(apiUrl, "/auth/login"), {
       method: "POST",
       body,
       headers: {

package/dist/runtime/server/api/logout.post.js

@@ -6,12 +6,13 @@ import {
   REFRESH_TOKEN_KEY,
   EXP_TIME_KEY
 } from "../../../constants/auth";
+import { normalizeUrl } from "../../../utils/url";
 export default defineEventHandler(async (event) => {
   const config = useRuntimeConfig();
   const apiUrl = config.public?.enfyraSDK?.apiUrl;
   const refreshToken = getCookie(event, REFRESH_TOKEN_KEY);
   try {
-    const result = await $fetch(`${apiUrl}/auth/logout`, {
+    const result = await $fetch(normalizeUrl(apiUrl, "/auth/logout"), {
       method: "POST",
       headers: {
         cookie: getHeader(event, "cookie") || "",

package/dist/runtime/server/api/logout.post.mjs

@@ -6,12 +6,13 @@ import {
   REFRESH_TOKEN_KEY,
   EXP_TIME_KEY
 } from "../../../constants/auth";
+import { normalizeUrl } from "../../../utils/url";
 export default defineEventHandler(async (event) => {
   const config = useRuntimeConfig();
   const apiUrl = config.public?.enfyraSDK?.apiUrl;
   const refreshToken = getCookie(event, REFRESH_TOKEN_KEY);
   try {
-    const result = await $fetch(`${apiUrl}/auth/logout`, {
+    const result = await $fetch(normalizeUrl(apiUrl, "/auth/logout"), {
       method: "POST",
       headers: {
         cookie: getHeader(event, "cookie") || "",

package/dist/utils/config.mjs

@@ -5,11 +5,7 @@ const config = ref({
 });
 export function useEnfyraConfig() {
   const setConfig = (newConfig) => {
-    const normalizedConfig = { ...newConfig };
-    if (typeof normalizedConfig.apiUrl === "string") {
-      normalizedConfig.apiUrl = normalizedConfig.apiUrl.replace(/\/+$/, "");
-    }
-    config.value = { ...config.value, ...normalizedConfig };
+    config.value = { ...config.value, ...newConfig };
   };
   const getConfig = () => config.value;
   return {

package/dist/utils/server/proxy.mjs

@@ -1,11 +1,12 @@
 import { proxyRequest } from "h3";
 import { useRuntimeConfig } from "#imports";
 import { ENFYRA_API_PREFIX } from "../../constants/config";
+import { normalizeUrl } from "../../utils/url";
 export function proxyToAPI(event, customPath) {
   const config = useRuntimeConfig();
   const apiPrefix = config.public?.enfyraSDK?.apiPrefix || ENFYRA_API_PREFIX;
   const rawPath = customPath || event.path.replace(new RegExp(`^${apiPrefix}`), "");
-  const targetUrl = `${config.public?.enfyraSDK?.apiUrl}${rawPath}`;
+  const targetUrl = normalizeUrl(config.public?.enfyraSDK?.apiUrl, rawPath);
   const headers = event.context.proxyHeaders || {};
   return proxyRequest(event, targetUrl, {
     headers

package/dist/utils/server/refreshToken.mjs

@@ -5,6 +5,7 @@ import {
   REFRESH_TOKEN_KEY,
   EXP_TIME_KEY
 } from "../../constants/auth";
+import { normalizeUrl } from "../../utils/url";
 export function decodeJWT(token) {
   try {
     const parts = token.split(".");
@@ -39,7 +40,7 @@ export function validateTokens(event) {
 }
 export async function refreshAccessToken(event, refreshToken, apiUrl) {
   try {
-    const response = await $fetch(`${apiUrl}/auth/refresh-token`, {
+    const response = await $fetch(normalizeUrl(apiUrl, "/auth/refresh-token"), {
       method: "POST",
       body: { refreshToken }
     });

package/dist/utils/url.mjs

@@ -1,3 +1,20 @@
+export function normalizeUrl(...segments) {
+  const validSegments = segments.filter((s) => Boolean(s));
+  if (validSegments.length === 0) return "";
+  let result = validSegments[0].replace(/\/+$/, "");
+  for (let i = 1; i < validSegments.length; i++) {
+    const segment = validSegments[i].replace(/^\/+/, "").replace(/\/+$/, "").replace(/\/+/g, "/");
+    if (segment) {
+      result += "/" + segment;
+    }
+  }
+  return result;
+}
+export function joinUrlPath(...paths) {
+  const validPaths = paths.filter((p) => Boolean(p));
+  if (validPaths.length === 0) return "";
+  return validPaths.map((path) => path.replace(/^\/+/, "").replace(/\/+$/, "")).filter(Boolean).join("/");
+}
 export function getAppUrl() {
   if (process.client && typeof window !== "undefined") {
     return window.location.origin;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enfyra/sdk-nuxt",
-  "version": "0.3.9",
+  "version": "0.3.11",
   "description": "Nuxt SDK for Enfyra CMS",
   "repository": {
     "type": "git",
@@ -47,20 +47,15 @@
     "vue": "^3.0.0"
   },
   "dependencies": {
-    "@vitejs/plugin-vue": "^5.2.0",
-    "cookie": "^0.6.0",
-    "glob": "^8.1.0",
     "h3": "^1.15.4",
-    "jwt-decode": "^4.0.0",
-    "nuxt": "^3.18.1",
-    "ofetch": "^1.3.3",
-    "vite": "^6.0.7"
+    "ofetch": "^1.3.3"
   },
   "devDependencies": {
     "@nuxt/module-builder": "^0.8.4",
-    "@types/cookie": "^0.6.0",
     "@vitest/ui": "^3.2.4",
+    "nuxt": "^3.18.1",
     "typescript": "^5.0.0",
+    "vite": "^6.0.7",
     "vite-plugin-dts": "^4.3.0",
     "vitest": "^3.2.4"
   }

package/src/composables/useEnfyraApi.ts

@@ -8,7 +8,7 @@ import type {
   BatchProgress,
 } from "../types";
 import { $fetch } from "../utils/http";
-import { getAppUrl } from "../utils/url";
+import { getAppUrl, normalizeUrl } from "../utils/url";
 import { ENFYRA_API_PREFIX } from "../constants/config";
 
 import { useRuntimeConfig, useFetch, useRequestHeaders } from "#imports";
@@ -59,8 +59,11 @@ export function useEnfyraApi<T = any>(
       .replace(/^\/+/, "");
 
     const appUrl = getAppUrl();
-    const finalUrl =
-      appUrl + (config?.apiPrefix || ENFYRA_API_PREFIX) + "/" + basePath;
+    const finalUrl = normalizeUrl(
+      appUrl,
+      config?.apiPrefix || ENFYRA_API_PREFIX,
+      basePath
+    );
 
     const clientHeaders = process.client
       ? {}
@@ -141,7 +144,7 @@ export function useEnfyraApi<T = any>(
         return segments.filter(Boolean).join("/");
       };
 
-      const fullBaseURL = apiUrl + (apiPrefix || ENFYRA_API_PREFIX);
+      const fullBaseURL = normalizeUrl(apiUrl, apiPrefix || ENFYRA_API_PREFIX);
 
       async function processBatch<T>(
         items: any[],

package/src/constants/config.ts

@@ -1,5 +1 @@
-/**
- * Hardcoded API prefix for all Enfyra SDK routes
- * This ensures no conflicts with application routes
- */
 export const ENFYRA_API_PREFIX = "/enfyra/api";

package/src/module.ts

@@ -14,11 +14,27 @@ export default defineNuxtModule({
   },
   defaults: {
     apiUrl: "",
+    apiPrefix: ENFYRA_API_PREFIX,
   },
   setup(options, nuxt) {
+    const normalizedOptions = {
+      ...options,
+      apiUrl:
+        typeof options.apiUrl === "string"
+          ? options.apiUrl.replace(/\/+$/, "")
+          : options.apiUrl,
+      apiPrefix:
+        typeof options.apiPrefix === "string"
+          ? (options.apiPrefix.trim() 
+              ? "/" + options.apiPrefix.replace(/^\/+|\/+$/g, "").replace(/\/+/g, "/")
+              : ENFYRA_API_PREFIX)
+          : ENFYRA_API_PREFIX,
+    };
+
+    const apiPrefix = normalizedOptions.apiPrefix;
     const { resolve } = createResolver(import.meta.url);
 
-    if (!options.apiUrl) {
+    if (!normalizedOptions.apiUrl) {
       console.warn(
         `[Enfyra SDK Nuxt] Missing required configuration:\n` +
           `- apiUrl is required\n` +
@@ -29,20 +45,20 @@ export default defineNuxtModule({
       );
       
       nuxt.options.runtimeConfig.public.enfyraSDK = {
-        ...options,
-        apiPrefix: ENFYRA_API_PREFIX,
+        ...normalizedOptions,
+        apiPrefix: apiPrefix,
         configError: true,
         configErrorMessage: 'Enfyra SDK: apiUrl is required. Please configure it in nuxt.config.ts'
       };
     } else {
       nuxt.options.runtimeConfig.public.enfyraSDK = {
-        ...options,
-        apiPrefix: ENFYRA_API_PREFIX,
+        ...normalizedOptions,
+        apiPrefix: apiPrefix,
       };
     }
 
 
-    if (!options.apiUrl) {
+    if (!normalizedOptions.apiUrl) {
       addPlugin({
         src: resolve("./runtime/plugin/config-error.client"),
         mode: 'client'
@@ -57,13 +73,13 @@ export default defineNuxtModule({
     });
 
     addServerHandler({
-      route: `${ENFYRA_API_PREFIX}/login`,
+      route: `${apiPrefix}/login`,
       handler: resolve("./runtime/server/api/login.post"),
       method: "post",
     });
 
     addServerHandler({
-      route: `${ENFYRA_API_PREFIX}/logout`,
+      route: `${apiPrefix}/logout`,
       handler: resolve("./runtime/server/api/logout.post"),
       method: "post",
     });
@@ -75,7 +91,7 @@ export default defineNuxtModule({
     });
 
     addServerHandler({
-      route: `${ENFYRA_API_PREFIX}/**`,
+      route: `${apiPrefix}/**`,
       handler: resolve("./runtime/server/api/all"),
     });
   },

package/src/runtime/server/api/login.post.ts

@@ -13,6 +13,7 @@ import {
   REFRESH_TOKEN_KEY,
   EXP_TIME_KEY,
 } from "../../../constants/auth";
+import { normalizeUrl } from "../../../utils/url";
 
 export default defineEventHandler(async (event) => {
   const config = useRuntimeConfig();
@@ -20,7 +21,7 @@ export default defineEventHandler(async (event) => {
 
   try {
     const body = await readBody(event);
-    const response = await $fetch<any>(`${apiUrl}/auth/login`, {
+    const response = await $fetch<any>(normalizeUrl(apiUrl, "/auth/login"), {
       method: "POST",
       body,
       headers: {

package/src/runtime/server/api/logout.post.ts

@@ -6,6 +6,7 @@ import {
   REFRESH_TOKEN_KEY,
   EXP_TIME_KEY,
 } from "../../../constants/auth";
+import { normalizeUrl } from "../../../utils/url";
 
 export default defineEventHandler(async (event) => {
   const config = useRuntimeConfig();
@@ -14,7 +15,7 @@ export default defineEventHandler(async (event) => {
   const refreshToken = getCookie(event, REFRESH_TOKEN_KEY);
 
   try {
-    const result = await $fetch(`${apiUrl}/auth/logout`, {
+    const result = await $fetch(normalizeUrl(apiUrl, "/auth/logout"), {
       method: "POST",
       headers: {
         cookie: getHeader(event, "cookie") || "",

package/src/utils/config.ts

@@ -8,13 +8,7 @@ const config = ref<EnfyraConfig>({
 
 export function useEnfyraConfig() {
   const setConfig = (newConfig: Partial<EnfyraConfig>) => {
-    const normalizedConfig = { ...newConfig };
-
-    if (typeof normalizedConfig.apiUrl === 'string') {
-      normalizedConfig.apiUrl = normalizedConfig.apiUrl.replace(/\/+$/, '');
-    }
-
-    config.value = { ...config.value, ...normalizedConfig };
+    config.value = { ...config.value, ...newConfig };
   };
 
   const getConfig = () => config.value;

package/src/utils/server/proxy.ts

@@ -1,13 +1,14 @@
 import { H3Event, proxyRequest } from "h3";
 import { useRuntimeConfig } from "#imports";
 import { ENFYRA_API_PREFIX } from "../../constants/config";
+import { normalizeUrl } from "../../utils/url";
 
 export function proxyToAPI(event: H3Event, customPath?: string) {
   const config = useRuntimeConfig();
   const apiPrefix = config.public?.enfyraSDK?.apiPrefix || ENFYRA_API_PREFIX;
   const rawPath =
     customPath || event.path.replace(new RegExp(`^${apiPrefix}`), "");
-  const targetUrl = `${config.public?.enfyraSDK?.apiUrl}${rawPath}`;
+  const targetUrl = normalizeUrl(config.public?.enfyraSDK?.apiUrl, rawPath);
 
   const headers = event.context.proxyHeaders || {};
 

package/src/utils/server/refreshToken.ts

@@ -5,6 +5,7 @@ import {
   REFRESH_TOKEN_KEY,
   EXP_TIME_KEY,
 } from "../../constants/auth";
+import { normalizeUrl } from "../../utils/url";
 
 interface TokenValidationResult {
   accessToken: string | null;
@@ -58,7 +59,7 @@ export async function refreshAccessToken(
   apiUrl: string
 ): Promise<string> {
   try {
-    const response = await $fetch(`${apiUrl}/auth/refresh-token`, {
+    const response = await $fetch(normalizeUrl(apiUrl, "/auth/refresh-token"), {
       method: "POST",
       body: { refreshToken },
     });

package/src/utils/url.ts

@@ -1,3 +1,42 @@
+/**
+ * Normalizes URL segments to avoid double slashes when concatenating
+ * Removes trailing slashes from base URL and leading slashes from path segments
+ * Also normalizes multiple consecutive slashes within segments
+ */
+export function normalizeUrl(...segments: (string | undefined | null)[]): string {
+  const validSegments = segments.filter((s): s is string => Boolean(s));
+  if (validSegments.length === 0) return '';
+
+  // First segment is the base URL - remove trailing slashes
+  let result = validSegments[0].replace(/\/+$/, '');
+
+  // For remaining segments, remove leading and trailing slashes, normalize internal slashes, then join
+  for (let i = 1; i < validSegments.length; i++) {
+    const segment = validSegments[i]
+      .replace(/^\/+/, '') // Remove leading slashes
+      .replace(/\/+$/, '')  // Remove trailing slashes
+      .replace(/\/+/g, '/'); // Normalize multiple consecutive slashes to single slash
+    if (segment) {
+      result += '/' + segment;
+    }
+  }
+
+  return result;
+}
+
+/**
+ * Joins URL paths safely, avoiding double slashes
+ */
+export function joinUrlPath(...paths: (string | undefined | null)[]): string {
+  const validPaths = paths.filter((p): p is string => Boolean(p));
+  if (validPaths.length === 0) return '';
+
+  return validPaths
+    .map(path => path.replace(/^\/+/, '').replace(/\/+$/, ''))
+    .filter(Boolean)
+    .join('/');
+}
+
 export function getAppUrl(): string {
   if (process.client && typeof window !== 'undefined') {
     return window.location.origin;