crelte 0.5.0-beta.3 → 0.5.0-beta.4

package/dist/routing/index.d.ts

@@ -3,5 +3,6 @@ import Route, { type RouteOptions } from './route/Route.js';
 import Request, { type RequestOptions, type DelayRender } from './route/Request.js';
 import Site from './Site.js';
 import BaseRoute from './route/BaseRoute.js';
-export { Router, UpdateRequest, BaseRoute, Route, RouteOptions, Site, Request, DelayRender, RequestOptions, };
+import { shouldInterceptClick } from './utils.js';
+export { Router, UpdateRequest, BaseRoute, Route, RouteOptions, Site, Request, DelayRender, RequestOptions, shouldInterceptClick, };
 //# sourceMappingURL=index.d.ts.map

package/dist/routing/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/routing/index.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,EAAE,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,KAAK,EAAE,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,OAAO,EAAE,EACf,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,SAAS,MAAM,sBAAsB,CAAC;AAE7C,OAAO,EACN,MAAM,EACN,aAAa,EACb,SAAS,EACT,KAAK,EACL,YAAY,EACZ,IAAI,EACJ,OAAO,EACP,WAAW,EACX,cAAc,GACd,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/routing/index.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,EAAE,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,KAAK,EAAE,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,OAAO,EAAE,EACf,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,SAAS,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,EACN,MAAM,EACN,aAAa,EACb,SAAS,EACT,KAAK,EACL,YAAY,EACZ,IAAI,EACJ,OAAO,EACP,WAAW,EACX,cAAc,EACd,oBAAoB,GACpB,CAAC"}

package/dist/routing/index.js

@@ -3,4 +3,5 @@ import Route from './route/Route.js';
 import Request from './route/Request.js';
 import Site from './Site.js';
 import BaseRoute from './route/BaseRoute.js';
-export { Router, BaseRoute, Route, Site, Request, };
+import { shouldInterceptClick } from './utils.js';
+export { Router, BaseRoute, Route, Site, Request, shouldInterceptClick, };

package/dist/routing/router/ClientRouter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ClientRouter.d.ts","sourceRoot":"","sources":["../../../src/routing/router/ClientRouter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,UAAU,EAAE,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,MAAM,mBAAmB,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,MAAM,mBAAmB,GAAG;IACjC,kBAAkB,EAAE,OAAO,CAAC;CAC5B,GAAG,iBAAiB,CAAC;AAEtB,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,UAAU;IACnD,OAAO,CAAC,qBAAqB,CAAa;IAC1C,OAAO,CAAC,kBAAkB,CAAU;IAEpC,OAAO,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;gBAEd,KAAK,EAAE,eAAe,EAAE,EAAE,IAAI,EAAE,mBAAmB;IAQ/D;;OAEG;IACG,IAAI;IAuBV;;OAEG;IACG,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IA6ChD,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,GAAE,cAAmB;IAYpD,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,GAAE,cAAmB;IAiB7D;;;OAGG;IACG,qBAAqB,CAC1B,GAAG,EAAE,OAAO,EACZ,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GACnC,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IASxB,MAAM;IAiEN,QAAQ;IAgCR,YAAY,CAAC,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,GAAG,IAAI;CAwEpD"}
+{"version":3,"file":"ClientRouter.d.ts","sourceRoot":"","sources":["../../../src/routing/router/ClientRouter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,UAAU,EAAE,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,MAAM,mBAAmB,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAG7C,MAAM,MAAM,mBAAmB,GAAG;IACjC,kBAAkB,EAAE,OAAO,CAAC;CAC5B,GAAG,iBAAiB,CAAC;AAEtB,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,UAAU;IACnD,OAAO,CAAC,qBAAqB,CAAa;IAC1C,OAAO,CAAC,kBAAkB,CAAU;IAEpC,OAAO,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;gBAEd,KAAK,EAAE,eAAe,EAAE,EAAE,IAAI,EAAE,mBAAmB;IAQ/D;;OAEG;IACG,IAAI;IAuBV;;OAEG;IACG,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IA6ChD,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,GAAE,cAAmB;IAYpD,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,GAAE,cAAmB;IAiB7D;;;OAGG;IACG,qBAAqB,CAC1B,GAAG,EAAE,OAAO,EACZ,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GACnC,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IASxB,MAAM;IAgEN,QAAQ;IAgCR,YAAY,CAAC,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,GAAG,IAAI;CAwEpD"}

package/dist/routing/router/ClientRouter.js

@@ -1,4 +1,5 @@
 import BaseRouter from './BaseRouter.js';
+import { shouldInterceptClick } from '../utils.js';
 export default class ClientRouter extends BaseRouter {
     scrollDebounceTimeout;
     preloadOnMouseOver;
@@ -103,16 +104,13 @@ export default class ClientRouter extends BaseRouter {
         window.addEventListener('click', async (e) => {
             // @ts-ignore
             const link = e.target.closest('a');
-            const openInNewTab = e.metaKey || e.ctrlKey || e.shiftKey;
-            const saveLink = e.altKey;
-            if (!link || !link.href || openInNewTab || saveLink)
-                return;
-            if (link.target.toLowerCase() === '_blank')
-                return;
-            if (!link.href.startsWith('http'))
+            if (!shouldInterceptClick(e, link))
                 return;
             e.preventDefault();
-            const req = this.targetToRequest(link.href, { origin: 'click' });
+            const req = this.targetToRequest(link.href, {
+                origin: 'click',
+                context: { ...link.dataset },
+            });
             const currRoute = this.route.get();
             const routeEq = currRoute && currRoute.eqUrl(req) && currRoute.eqSearch(req);
             // this means the route is the same maybe with a different hash

package/dist/routing/utils.d.ts

@@ -2,4 +2,8 @@ import Site from './Site.js';
 export declare function trimSlashEnd(str: string): string;
 export declare function orDef<T>(a: T | undefined, def: T): T;
 export declare function preferredSite(sites: Site[], languages: string[]): Site | null;
+/**
+ * Returns true if the click should be intercepted
+ */
+export declare function shouldInterceptClick(e: PointerEvent, link: HTMLAnchorElement | undefined): boolean;
 //# sourceMappingURL=utils.d.ts.map

package/dist/routing/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/routing/utils.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,UAEvC;AAGD,wBAAgB,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAEpD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,IAAI,CAK7E"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/routing/utils.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,UAEvC;AAGD,wBAAgB,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAEpD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,IAAI,CAK7E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CACnC,CAAC,EAAE,YAAY,EACf,IAAI,EAAE,iBAAiB,GAAG,SAAS,GACjC,OAAO,CAQT"}

package/dist/routing/utils.js

@@ -11,3 +11,17 @@ export function preferredSite(sites, languages) {
     const lang = matchLanguages(Array.from(map.keys()), languages);
     return lang ? map.get(lang) : null;
 }
+/**
+ * Returns true if the click should be intercepted
+ */
+export function shouldInterceptClick(e, link) {
+    const openInNewTab = e.metaKey || e.ctrlKey || e.shiftKey;
+    const saveLink = e.altKey;
+    if (!link || !link.href || openInNewTab || saveLink)
+        return false;
+    if (link.target.toLowerCase() === '_blank')
+        return false;
+    if (!link.href.startsWith('http'))
+        return false;
+    return true;
+}

package/dist/server/CrelteServer.d.ts

@@ -51,7 +51,22 @@ export default class CrelteServerRequest {
      */
     getEnv(name: 'ENDPOINT_URL'): string;
     getEnv(name: 'CRAFT_WEB_URL'): string;
+    getEnv(name: 'FRONTEND_URL'): string;
     getEnv(name: string): string | null;
+    /**
+     * returns the frontend url with an optional path
+     *
+     * ## Note
+     * For the origin the `FRONTEND_URL` env variable is used
+     */
+    frontendUrl(path?: string): URL;
+    /**
+     * returns the backend url with an optional path
+     *
+     * ## Note
+     * For the origin the `ENDPOINT_URL` env variable is used
+     */
+    backendUrl(path?: string): URL;
     /**
      * Returns the primary site
      */

package/dist/server/CrelteServer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CrelteServer.d.ts","sourceRoot":"","sources":["../../src/server/CrelteServer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAW,IAAI,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,aAAa,MAAM,cAAc,CAAC;AAEzC,MAAM,MAAM,0BAA0B,GAAG;IACxC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,EAAE,IAAI,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,CAAC,OAAO,OAAO,mBAAmB;IACvC;;OAEG;IACH,GAAG,EAAE,aAAa,CAAC;IAEnB,OAAO,CAAC,IAAI,CAAsB;IAClC,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,QAAQ,CAAU;IAC1B,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC;gBAEhB,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,0BAA0B;IAchE;;;;;;;OAOG;IACH,IAAI,IAAI,IAAI,IAAI,CAEf;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,IAAI,EAAE,CAElB;IAED;;OAEG;IACH,IAAI,kBAAkB,IAAI,MAAM,EAAE,CAEjC;IAED;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM;IACpC,MAAM,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM;IACrC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKnC;;OAEG;IACH,WAAW,IAAI,IAAI;IAInB;;;;OAIG;IACH,aAAa,IAAI,IAAI,GAAG,IAAI;IAI5B;;;;;;;OAOG;IACG,KAAK,CACV,KAAK,EAAE,KAAK,EACZ,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACvC,IAAI,GAAE,YAAiB,GACrB,OAAO,CAAC,OAAO,CAAC;IAInB,cAAc;IACd,gBAAgB,CAAC,IAAI,EAAE,QAAQ;CAG/B"}
+{"version":3,"file":"CrelteServer.d.ts","sourceRoot":"","sources":["../../src/server/CrelteServer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAW,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,aAAa,MAAM,cAAc,CAAC;AAEzC,MAAM,MAAM,0BAA0B,GAAG;IACxC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,EAAE,IAAI,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,CAAC,OAAO,OAAO,mBAAmB;IACvC;;OAEG;IACH,GAAG,EAAE,aAAa,CAAC;IAEnB,OAAO,CAAC,IAAI,CAAsB;IAClC,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,QAAQ,CAAU;IAC1B,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC;gBAEhB,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,0BAA0B;IAchE;;;;;;;OAOG;IACH,IAAI,IAAI,IAAI,IAAI,CAEf;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,IAAI,EAAE,CAElB;IAED;;OAEG;IACH,IAAI,kBAAkB,IAAI,MAAM,EAAE,CAEjC;IAED;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM;IACpC,MAAM,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM;IACrC,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM;IACpC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKnC;;;;;OAKG;IACH,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,GAAG;IAI/B;;;;;OAKG;IACH,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,GAAG;IAI9B;;OAEG;IACH,WAAW,IAAI,IAAI;IAInB;;;;OAIG;IACH,aAAa,IAAI,IAAI,GAAG,IAAI;IAI5B;;;;;;;OAOG;IACG,KAAK,CACV,KAAK,EAAE,KAAK,EACZ,SAAS,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACvC,IAAI,GAAE,YAAiB,GACrB,OAAO,CAAC,OAAO,CAAC;IAInB,cAAc;IACd,gBAAgB,CAAC,IAAI,EAAE,QAAQ;CAG/B"}

package/dist/server/CrelteServer.js

@@ -1,5 +1,6 @@
 import ServerCookies from '../cookies/ServerCookies.js';
 import { Request } from '../routing/index.js';
+import { urlWithPath } from '../utils.js';
 export default class CrelteServerRequest {
     /**
      * The current request
@@ -58,6 +59,24 @@ export default class CrelteServerRequest {
     getEnv(name) {
         return this._env.get(name) ?? null;
     }
+    /**
+     * returns the frontend url with an optional path
+     *
+     * ## Note
+     * For the origin the `FRONTEND_URL` env variable is used
+     */
+    frontendUrl(path) {
+        return urlWithPath(this.getEnv('FRONTEND_URL'), path);
+    }
+    /**
+     * returns the backend url with an optional path
+     *
+     * ## Note
+     * For the origin the `ENDPOINT_URL` env variable is used
+     */
+    backendUrl(path) {
+        return urlWithPath(this.getEnv('ENDPOINT_URL'), path);
+    }
     /**
      * Returns the primary site
      */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "crelte",
-	"version": "0.5.0-beta.3",
+	"version": "0.5.0-beta.4",
 	"author": "Crelte <support@crelte.com>",
 	"type": "module",
 	"scripts": {

package/src/routing/index.ts

@@ -6,6 +6,7 @@ import Request, {
 } from './route/Request.js';
 import Site from './Site.js';
 import BaseRoute from './route/BaseRoute.js';
+import { shouldInterceptClick } from './utils.js';
 
 export {
 	Router,
@@ -17,4 +18,5 @@ export {
 	Request,
 	DelayRender,
 	RequestOptions,
+	shouldInterceptClick,
 };

package/src/routing/router/ClientRouter.ts

@@ -3,6 +3,7 @@ import BaseRouter, { BaseRouterOptions } from './BaseRouter.js';
 import { Request, RequestOptions } from '../index.js';
 import Route from '../route/Route.js';
 import { SiteFromGraphQl } from '../Site.js';
+import { shouldInterceptClick } from '../utils.js';
 
 export type ClientRouterOptions = {
 	preloadOnMouseOver: boolean;
@@ -145,15 +146,14 @@ export default class ClientRouter extends BaseRouter {
 		window.addEventListener('click', async e => {
 			// @ts-ignore
 			const link = e.target.closest('a');
-			const openInNewTab = e.metaKey || e.ctrlKey || e.shiftKey;
-			const saveLink = e.altKey;
-			if (!link || !link.href || openInNewTab || saveLink) return;
-			if (link.target.toLowerCase() === '_blank') return;
-			if (!link.href.startsWith('http')) return;
+			if (!shouldInterceptClick(e, link)) return;
 
 			e.preventDefault();
 
-			const req = this.targetToRequest(link.href, { origin: 'click' });
+			const req = this.targetToRequest(link.href, {
+				origin: 'click',
+				context: { ...link.dataset },
+			});
 			const currRoute = this.route.get();
 			const routeEq =
 				currRoute && currRoute.eqUrl(req) && currRoute.eqSearch(req);

package/src/routing/utils.ts

@@ -16,3 +16,19 @@ export function preferredSite(sites: Site[], languages: string[]): Site | null {
 	const lang = matchLanguages(Array.from(map.keys()), languages);
 	return lang ? map.get(lang)! : null;
 }
+
+/**
+ * Returns true if the click should be intercepted
+ */
+export function shouldInterceptClick(
+	e: PointerEvent,
+	link: HTMLAnchorElement | undefined,
+): boolean {
+	const openInNewTab = e.metaKey || e.ctrlKey || e.shiftKey;
+	const saveLink = e.altKey;
+	if (!link || !link.href || openInNewTab || saveLink) return false;
+	if (link.target.toLowerCase() === '_blank') return false;
+	if (!link.href.startsWith('http')) return false;
+
+	return true;
+}

package/src/server/CrelteServer.ts

@@ -2,6 +2,7 @@ import { Cookies } from '../cookies/index.js';
 import ServerCookies from '../cookies/ServerCookies.js';
 import { Queries, Query, QueryOptions } from '../queries/index.js';
 import { Request, Site } from '../routing/index.js';
+import { urlWithPath } from '../utils.js';
 import ServerRequest from './Request.js';
 
 export type CrelteServerRequestOptions = {
@@ -84,11 +85,32 @@ export default class CrelteServerRequest {
 	 */
 	getEnv(name: 'ENDPOINT_URL'): string;
 	getEnv(name: 'CRAFT_WEB_URL'): string;
+	getEnv(name: 'FRONTEND_URL'): string;
 	getEnv(name: string): string | null;
 	getEnv(name: string): string | null {
 		return this._env.get(name) ?? null;
 	}
 
+	/**
+	 * returns the frontend url with an optional path
+	 *
+	 * ## Note
+	 * For the origin the `FRONTEND_URL` env variable is used
+	 */
+	frontendUrl(path?: string): URL {
+		return urlWithPath(this.getEnv('FRONTEND_URL'), path);
+	}
+
+	/**
+	 * returns the backend url with an optional path
+	 *
+	 * ## Note
+	 * For the origin the `ENDPOINT_URL` env variable is used
+	 */
+	backendUrl(path?: string): URL {
+		return urlWithPath(this.getEnv('ENDPOINT_URL'), path);
+	}
+
 	/**
 	 * Returns the primary site
 	 */