@owlmeans/route 0.1.0

package/build/index.d.ts

@@ -0,0 +1,5 @@
+export * from './types.js';
+export * from './consts.js';
+export * from './helper.js';
+export * from './model.js';
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA"}

package/build/index.js

@@ -0,0 +1,5 @@
+export * from './types.js';
+export * from './consts.js';
+export * from './helper.js';
+export * from './model.js';
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA"}

package/build/model.d.ts

@@ -0,0 +1,5 @@
+import type { CommonRoute, CommonRouteModel } from './types.js';
+import type { CreateRouteSignature } from './utils/types.js';
+export declare const makeRouteModel: (route: CommonRoute) => CommonRouteModel;
+export declare const createRoute: CreateRouteSignature<CommonRoute>;
+//# sourceMappingURL=model.d.ts.map

package/build/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAC/D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAI5D,eAAO,MAAM,cAAc,UAAW,WAAW,KAAG,gBAOnD,CAAA;AAED,eAAO,MAAM,WAAW,EAAE,oBAAoB,CAAC,WAAW,CAUzD,CAAA"}

package/build/model.js

@@ -0,0 +1,20 @@
+import { resolve } from './utils/route.js';
+import { AppType } from '@owlmeans/context';
+export const makeRouteModel = (route) => {
+    const model = {
+        route,
+        resolve: ctx => resolve(route)(ctx)
+    };
+    return model;
+};
+export const createRoute = (alias, path, opts) => {
+    const route = {
+        alias,
+        type: AppType.Backend,
+        path,
+        resolved: false,
+        ...(typeof opts === 'string' ? { parent: opts } : opts)
+    };
+    return route;
+};
+//# sourceMappingURL=model.js.map

package/build/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAC1C,OAAO,EAAE,OAAO,EAA6B,MAAM,mBAAmB,CAAA;AAEtE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAkB,EAAoB,EAAE;IACrE,MAAM,KAAK,GAAqB;QAC9B,KAAK;QACL,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAA2C,CAAC;KAC5E,CAAA;IAED,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,WAAW,GAAsC,CAAC,KAAK,EAAE,IAAI,EAAE,IAAK,EAAE,EAAE;IACnF,MAAM,KAAK,GAAgB;QACzB,KAAK;QACL,IAAI,EAAE,OAAO,CAAC,OAAO;QACrB,IAAI;QACJ,QAAQ,EAAE,KAAK;QACf,GAAG,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;KACxD,CAAA;IAED,OAAO,KAAK,CAAA;AACd,CAAC,CAAA"}

package/build/types.d.ts

@@ -0,0 +1,35 @@
+import type { AppType, BasicContext, BasicConfig } from '@owlmeans/context';
+import type { RouteProtocols, RouteMethod } from './consts';
+export interface CommonRoute extends BasicRoute {
+    alias: string;
+    path: string;
+    parent?: string;
+    default?: boolean;
+    method?: RouteMethod;
+    protocol?: RouteProtocols;
+    secure?: boolean;
+}
+export interface CommonServiceRoute extends BasicRoute {
+    home?: string;
+    service: string;
+    default?: boolean;
+}
+export interface BasicRoute {
+    type: AppType;
+    service?: string;
+    host?: string;
+    port?: number;
+    base?: string;
+    resolved: boolean;
+}
+export interface ResolvedServiceRoute extends CommonServiceRoute {
+    host: string;
+    resolved: true;
+}
+export interface CommonRouteModel {
+    route: CommonRoute;
+    resolve: <C extends BasicConfig, T extends BasicContext<C>>(context: T) => Promise<CommonRoute>;
+}
+export interface RouteOptions extends Partial<CommonRoute> {
+}
+//# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAE3D,MAAM,WAAW,WAAY,SAAQ,UAAU;IAC7C,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,QAAQ,CAAC,EAAE,cAAc,CAAA;IACzB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,kBAAmB,SAAQ,UAAU;IACpD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,IAAI,CAAA;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,WAAW,CAAA;IAClB,OAAO,EAAE,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,WAAW,CAAC,CAAA;CAChG;AAED,MAAM,WAAW,YAAa,SAAQ,OAAO,CAAC,WAAW,CAAC;CACzD"}

package/build/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/build/utils/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types.js';
+export * from './service.js';
+export * from './route.js';
+//# sourceMappingURL=index.d.ts.map

package/build/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA"}

package/build/utils/index.js

@@ -0,0 +1,4 @@
+export * from './types.js';
+export * from './service.js';
+export * from './route.js';
+//# sourceMappingURL=index.js.map

package/build/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA"}

package/build/utils/route.d.ts

@@ -0,0 +1,9 @@
+import type { BasicConfig, BasicContext } from '@owlmeans/context';
+import type { CommonRoute } from '../types.js';
+type Config = BasicConfig;
+export declare const getParentRoute: <C extends Config, T extends BasicContext<C>>(context: T, route: CommonRoute) => Promise<CommonRoute | null>;
+export declare const overrideParams: (route: CommonRoute, overrides?: Partial<CommonRoute>, filter?: string[]) => void;
+export declare const resolve: <C extends Config, T extends BasicContext<C>>(route: CommonRoute) => (context: T) => Promise<CommonRoute>;
+export declare const prependBase: (route: CommonRoute) => string;
+export {};
+//# sourceMappingURL=route.d.ts.map

package/build/utils/route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../src/utils/route.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAc,MAAM,mBAAmB,CAAA;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAwC,MAAM,aAAa,CAAA;AAKpF,KAAK,MAAM,GAAG,WAAW,CAAA;AAEzB,eAAO,MAAM,cAAc,GAAU,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,SAAS,WAAW,KAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAkB5I,CAAA;AAED,eAAO,MAAM,cAAc,UAAW,WAAW,cAAc,OAAO,CAAC,WAAW,CAAC,WAAW,MAAM,EAAE,SAOrG,CAAA;AAED,eAAO,MAAM,OAAO,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,SAAS,WAAW,eAAqB,CAAC,yBA8D5G,CAAA;AAcD,eAAO,MAAM,WAAW,UAAW,WAAW,WAO7C,CAAA"}

package/build/utils/route.js

@@ -0,0 +1,103 @@
+import { isServiceRoute, isServiceRouteResolved } from './service.js';
+import { normalizePath } from '../helper.js';
+import { SEP } from '../consts.js';
+export const getParentRoute = async (context, route) => {
+    if (route.parent != null) {
+        const parent = context.module(route.parent);
+        assertCycle(context, route, parent.route.route);
+        if (parent.route == null) {
+            throw new SyntaxError('Parent module doesn\'t provide a route');
+        }
+        if (!parent.route.route.resolved) {
+            if (parent.resolve != null) {
+                await parent.resolve();
+            }
+            else {
+                return await parent.route.resolve(context);
+            }
+        }
+        return parent.route.route;
+    }
+    return null;
+};
+export const overrideParams = (route, overrides, filter) => {
+    Object.entries(overrides ?? {}).forEach(([key, value]) => {
+        if (route[key] == null
+            && (filter == null || filter.includes(key))) {
+            route[key] = value;
+        }
+    });
+};
+export const resolve = (route) => async (context) => {
+    if (route.resolved)
+        return route;
+    route.resolved = true;
+    if (context.cfg.services == null) {
+        throw new SyntaxError('Services aren\'t configured to resolve routes');
+    }
+    const firstGuessService = context.cfg.services[route.service ?? context.cfg.service];
+    if (firstGuessService != null && !isServiceRoute(firstGuessService)) {
+        throw new SyntaxError('Service is not a valid service route');
+    }
+    const service = firstGuessService?.type === route.type ? firstGuessService
+        : Object.values(context.cfg.services).find((service) => {
+            const _service = service;
+            return _service.default === true && _service.type === route.type;
+        }) ?? Object.values(context.cfg.services).find((service) => {
+            const _service = service;
+            return _service.type === route.type;
+        });
+    if (!isServiceRoute(service)) {
+        throw new SyntaxError('Service is not a valid service route');
+    }
+    if (!service.resolved && service.host != null) {
+        service.resolved = true;
+    }
+    if (!isServiceRouteResolved(service)) {
+        throw new SyntaxError('Service route is not resolved');
+    }
+    overrideParams(route, service, ['host', 'port', 'service', 'base']);
+    // Internal host access is non secure only
+    // it's required for server side client routes
+    if ("internalHost" in route) {
+        if (route.internalHost === route.host) {
+            route.secure = false;
+        }
+    }
+    else if ("internalHost" in service) {
+        if (service.internalHost === route.host) {
+            route.secure = false;
+        }
+    }
+    const parent = await getParentRoute(context, route);
+    if (parent != null) {
+        route.path = (parent.path.startsWith(SEP) ? SEP : '')
+            + normalizePath(normalizePath(parent.path) + SEP + normalizePath(route.path));
+    }
+    // Moved base resolution to the final service
+    // if (parent == null && route.base != null && route.base.trim() !== '') {
+    //   route.path = SEP + normalizePath(route.base) + SEP + normalizePath(route.path)
+    //   // route.path = route.base.startsWith(SEP) ? SEP + route.path : route.path
+    // }
+    return route;
+};
+/**
+ * @throws {SyntaxError}
+ */
+const assertCycle = (context, route, parent) => {
+    while (parent.parent != null) {
+        if (parent.parent === route.alias) {
+            throw new SyntaxError(`Route parentship cycle detected. Parent: ${parent.alias} has his child as ancestor ${route.alias}`);
+        }
+        parent = context.module(parent.parent).route.route;
+    }
+};
+export const prependBase = (route) => {
+    let path = route.path;
+    if (route.base != null && route.base.trim() !== '') {
+        path = SEP + normalizePath(route.base) + SEP + normalizePath(route.path);
+        // route.path = route.base.startsWith(SEP) ? SEP + route.path : route.path
+    }
+    return path;
+};
+//# sourceMappingURL=route.js.map

package/build/utils/route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.js","sourceRoot":"","sources":["../../src/utils/route.ts"],"names":[],"mappings":"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"}

package/build/utils/service.d.ts

@@ -0,0 +1,4 @@
+import type { ResolvedServiceRoute, CommonServiceRoute } from '../types.js';
+export declare const isServiceRoute: (obj?: Object) => obj is CommonServiceRoute;
+export declare const isServiceRouteResolved: (route: CommonServiceRoute) => route is ResolvedServiceRoute;
+//# sourceMappingURL=service.d.ts.map

package/build/utils/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/utils/service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAE3E,eAAO,MAAM,cAAc,SAAU,MAAM,KAAG,GAAG,IAAI,kBAEM,CAAA;AAE3D,eAAO,MAAM,sBAAsB,UAAW,kBAAkB,KAAG,KAAK,IAAI,oBACnD,CAAA"}

package/build/utils/service.js

@@ -0,0 +1,5 @@
+import { AppType } from '@owlmeans/context';
+export const isServiceRoute = (obj) => obj != null && ('type' in obj) && ('service' in obj)
+    && (Object.values(AppType).includes(obj.type));
+export const isServiceRouteResolved = (route) => route.resolved === true;
+//# sourceMappingURL=service.js.map

package/build/utils/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/utils/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAG3C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,GAAY,EAA6B,EAAE,CACxE,GAAG,IAAI,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC;OACjD,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAe,CAAC,CAAC,CAAA;AAE3D,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,KAAyB,EAAiC,EAAE,CACjG,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAA"}

package/build/utils/types.d.ts

@@ -0,0 +1,5 @@
+import type { RouteOptions } from '../types.js';
+export interface CreateRouteSignature<R> {
+    (alias: string, path: string, opts?: RouteOptions | string): R;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/utils/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/utils/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/C,MAAM,WAAW,oBAAoB,CAAC,CAAC;IACrC,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,MAAM,GAAG,CAAC,CAAA;CAC/D"}

package/build/utils/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/utils/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/utils/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@owlmeans/route",
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "sleep 258 && nodemon -e ts,tsx,json --watch src --exec \"tsc -p ./tsconfig.json\"",
+    "watch": "tsc -b -w --preserveWatchOutput --pretty"
+  },
+  "main": "build/index.js",
+  "module": "build/index.js",
+  "types": "build/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./build/index.js",
+      "require": "./build/index.js",
+      "default": "./build/index.js",
+      "module": "./build/index.js",
+      "types": "./build/index.d.ts"
+    },
+    "./utils": {
+      "default": "./build/utils/index.js",
+      "import": "./build/utils/index.js",
+      "require": "./build/utils/index.js",
+      "module": "./build/utils/index.js",
+      "types": "./build/utils/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "@owlmeans/context": "^0.1.0"
+  },
+  "devDependencies": {
+    "nodemon": "^3.1.7",
+    "typescript": "^5.6.3"
+  },
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/consts.ts

@@ -0,0 +1,16 @@
+
+export enum RouteMethod {
+  GET = 'get',
+  POST = 'post',
+  PATCH = 'patch',
+  PUT = 'put'
+}
+
+export const SEP = '/'
+
+export const PARAM = ':'
+
+export enum RouteProtocols {
+  WEB = 'http',
+  SOCKET = 'ws'
+}

package/src/helper.ts

@@ -0,0 +1,54 @@
+import { AppType } from '@owlmeans/context'
+import { RouteMethod, RouteProtocols, SEP } from './consts.js'
+import { createRoute, makeRouteModel } from './model.js'
+import type { CommonRouteModel, RouteOptions } from './types.js'
+import type { CreateRouteSignature } from './utils/types.js'
+
+export const route: CreateRouteSignature<CommonRouteModel> = (alias, path, opts?) =>
+  makeRouteModel(createRoute(alias, path, opts))
+
+export const normalizePath = (path: string): string => {
+  path = path.trim()
+  path = path.endsWith(SEP) ? path.slice(0, -1) : path
+  path = path.startsWith(SEP) ? path.substring(1) : path
+
+  return path
+}
+
+export const rtype = (type: AppType, opts?: RouteOptions | string): Partial<RouteOptions> => (
+  { type, ...(typeof opts === 'string' ? { parent: opts } : opts) }
+)
+
+export const backend = (opts?: RouteOptions | string | null, method?: RouteOptions | RouteMethod): Partial<RouteOptions> => {
+  if (typeof method === 'string') {
+    opts = typeof opts === 'string' ? { parent: opts, method } : { method, ...(opts ?? {}) }
+  } else if (typeof method === 'object') {
+    opts = typeof opts === 'string' ? { ...method, parent: opts } : { ...opts, ...method }
+  }
+
+  return rtype(AppType.Backend, opts as RouteOptions)
+}
+
+export const service = (service: string, opts?: Partial<RouteOptions>): Partial<RouteOptions> => {
+  opts = opts ?? {}
+  opts.service = service
+  return opts
+}
+
+export const socket = (opts?: RouteOptions | string | null, secondary?: RouteOptions): Partial<RouteOptions> => {
+  const route = backend(opts, secondary)
+
+  route.protocol = RouteProtocols.SOCKET
+
+  return route
+}
+
+export const frontend = (opts?: RouteOptions | string | null, def?: RouteOptions | boolean): Partial<RouteOptions> => {
+  if (typeof def === 'boolean') {
+    opts = typeof opts === 'string' ? { parent: opts, default: def } : { default: def, ...(opts ?? {}) }
+  } else if (typeof def === 'object') {
+    opts = typeof opts === 'object' ? { ...opts, ...def } : { parent: opts, ...def }
+  }
+
+  return rtype(AppType.Frontend, opts as RouteOptions)
+}

package/src/index.ts

@@ -0,0 +1,5 @@
+
+export * from './types.js'
+export * from './consts.js'
+export * from './helper.js'
+export * from './model.js'

package/src/model.ts

@@ -0,0 +1,25 @@
+import type { CommonRoute, CommonRouteModel } from './types.js'
+import type { CreateRouteSignature } from './utils/types.js'
+import { resolve } from './utils/route.js'
+import { AppType, BasicConfig, BasicContext } from '@owlmeans/context'
+
+export const makeRouteModel = (route: CommonRoute): CommonRouteModel => {
+  const model: CommonRouteModel = {
+    route,
+    resolve: ctx => resolve(route)(ctx as unknown as BasicContext<BasicConfig>)
+  }
+
+  return model
+}
+
+export const createRoute: CreateRouteSignature<CommonRoute> = (alias, path, opts?) => {
+  const route: CommonRoute = {
+    alias,
+    type: AppType.Backend,
+    path,
+    resolved: false,
+    ...(typeof opts === 'string' ? { parent: opts } : opts)
+  }
+
+  return route
+}

package/src/types.ts

@@ -0,0 +1,40 @@
+import type { AppType, BasicContext, BasicConfig } from '@owlmeans/context'
+import type { RouteProtocols, RouteMethod } from './consts'
+
+export interface CommonRoute extends BasicRoute {
+  alias: string
+  path: string
+  parent?: string
+  default?: boolean
+  method?: RouteMethod
+  protocol?: RouteProtocols
+  secure?: boolean
+}
+
+export interface CommonServiceRoute extends BasicRoute {
+  home?: string
+  service: string
+  default?: boolean
+}
+
+export interface BasicRoute {
+  type: AppType
+  service?: string
+  host?: string
+  port?: number
+  base?: string
+  resolved: boolean
+}
+
+export interface ResolvedServiceRoute extends CommonServiceRoute {
+  host: string
+  resolved: true
+}
+
+export interface CommonRouteModel {
+  route: CommonRoute
+  resolve: <C extends BasicConfig, T extends BasicContext<C>>(context: T) => Promise<CommonRoute>
+}
+
+export interface RouteOptions extends Partial<CommonRoute> {
+}

package/src/utils/index.ts

@@ -0,0 +1,4 @@
+
+export * from './types.js'
+export * from './service.js'
+export * from './route.js'

package/src/utils/route.ts

@@ -0,0 +1,121 @@
+import type { BasicConfig, BasicContext, Contextual } from '@owlmeans/context'
+import type { CommonRoute, CommonRouteModel, CommonServiceRoute } from '../types.js'
+import { isServiceRoute, isServiceRouteResolved } from './service.js'
+import { normalizePath } from '../helper.js'
+import { SEP } from '../consts.js'
+
+type Config = BasicConfig
+
+export const getParentRoute = async <C extends Config, T extends BasicContext<C>>(context: T, route: CommonRoute): Promise<CommonRoute | null> => {
+  if (route.parent != null) {
+    const parent = context.module<Contextual & { _module: true, route: CommonRouteModel, resolve?: () => Promise<void> }>(route.parent)
+    assertCycle<C, T>(context, route, parent.route.route)
+    if (parent.route == null) {
+      throw new SyntaxError('Parent module doesn\'t provide a route')
+    }
+    if (!parent.route.route.resolved) {
+      if (parent.resolve != null) {
+        await parent.resolve()
+      } else {
+        return await parent.route.resolve<C, T>(context)
+      }
+    }
+    return parent.route.route
+  }
+
+  return null
+}
+
+export const overrideParams = (route: CommonRoute, overrides?: Partial<CommonRoute>, filter?: string[]) => {
+  Object.entries(overrides ?? {}).forEach(([key, value]) => {
+    if (route[key as keyof CommonRoute] == null
+      && (filter == null || filter.includes(key))) {
+      (route[key as keyof CommonRoute] as CommonRoute[keyof CommonRoute]) = value
+    }
+  })
+}
+
+export const resolve = <C extends Config, T extends BasicContext<C>>(route: CommonRoute) => async (context: T) => {
+  if (route.resolved) return route
+  route.resolved = true
+
+  if (context.cfg.services == null) {
+    throw new SyntaxError('Services aren\'t configured to resolve routes')
+  }
+
+  const firstGuessService = context.cfg.services[route.service ?? context.cfg.service]
+  if (firstGuessService != null && !isServiceRoute(firstGuessService)) {
+    throw new SyntaxError('Service is not a valid service route')
+  }
+  const service = firstGuessService?.type === route.type ? firstGuessService
+    : Object.values(context.cfg.services).find<CommonServiceRoute>(
+      (service): service is CommonServiceRoute => {
+        const _service = service as CommonServiceRoute
+        return _service.default === true && _service.type === route.type
+      }
+    ) ?? Object.values(context.cfg.services).find<CommonServiceRoute>(
+      (service): service is CommonServiceRoute => {
+        const _service = service as CommonServiceRoute
+        return _service.type === route.type
+      }
+    )
+  if (!isServiceRoute(service)) {
+    throw new SyntaxError('Service is not a valid service route')
+  }
+  if (!service.resolved && service.host != null) {
+    service.resolved = true
+  }
+  if (!isServiceRouteResolved(service)) {
+    throw new SyntaxError('Service route is not resolved')
+  }
+
+  overrideParams(route, service, ['host', 'port', 'service', 'base'])
+
+  // Internal host access is non secure only
+  // it's required for server side client routes
+  if ("internalHost" in route) {
+    if (route.internalHost === route.host) {
+      route.secure = false
+    }
+  } else if ("internalHost" in service) {
+    if (service.internalHost === route.host) {
+      route.secure = false
+    }
+  }
+  
+
+  const parent = await getParentRoute<C, T>(context, route)
+  if (parent != null) {
+    route.path = (parent.path.startsWith(SEP) ? SEP : '')
+      + normalizePath(normalizePath(parent.path) + SEP + normalizePath(route.path))
+  }
+
+  // Moved base resolution to the final service
+  // if (parent == null && route.base != null && route.base.trim() !== '') {
+  //   route.path = SEP + normalizePath(route.base) + SEP + normalizePath(route.path)
+  //   // route.path = route.base.startsWith(SEP) ? SEP + route.path : route.path
+  // }
+
+  return route
+}
+
+/**
+ * @throws {SyntaxError}
+ */
+const assertCycle = <C extends BasicConfig, T extends BasicContext<C>>(context: T, route: CommonRoute, parent: CommonRoute) => {
+  while (parent.parent != null) {
+    if (parent.parent === route.alias) {
+      throw new SyntaxError(`Route parentship cycle detected. Parent: ${parent.alias} has his child as ancestor ${route.alias}`)
+    }
+    parent = context.module<Contextual & { _module: true, route: CommonRouteModel }>(parent.parent).route.route
+  }
+}
+
+export const prependBase = (route: CommonRoute) => {
+  let path = route.path
+  if (route.base != null && route.base.trim() !== '') {
+    path = SEP + normalizePath(route.base) + SEP + normalizePath(route.path)
+    // route.path = route.base.startsWith(SEP) ? SEP + route.path : route.path
+  }
+  return path
+}

package/src/utils/service.ts

@@ -0,0 +1,9 @@
+import { AppType } from '@owlmeans/context'
+import type { ResolvedServiceRoute, CommonServiceRoute } from '../types.js'
+
+export const isServiceRoute = (obj?: Object): obj is CommonServiceRoute =>
+  obj != null && ('type' in obj) && ('service' in obj)
+  && (Object.values(AppType).includes(obj.type as AppType))
+
+export const isServiceRouteResolved = (route: CommonServiceRoute): route is ResolvedServiceRoute =>
+  route.resolved === true

package/src/utils/types.ts

@@ -0,0 +1,5 @@
+import type { RouteOptions } from '../types.js'
+
+export interface CreateRouteSignature<R> {
+  (alias: string, path: string, opts?: RouteOptions | string): R
+}

package/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "extends": [
+    "../tsconfig.default.json",
+  ],
+  "compilerOptions": {
+    "rootDir": "./src/", /* Specify the root folder within your source files. */
+    "outDir": "./build/", /* Specify an output folder for all emitted files. */
+  },
+  "exclude": [
+    "./dist/**/*",
+    "./build/**/*",
+    "./*.ts"
+  ]
+}

package/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["./src/consts.ts","./src/helper.ts","./src/index.ts","./src/model.ts","./src/types.ts","./src/utils/index.ts","./src/utils/route.ts","./src/utils/service.ts","./src/utils/types.ts"],"version":"5.6.3"}