proteum 1.0.2 → 2.0.0

package/cli/compiler/index.ts

@@ -4,76 +4,78 @@
 
 // Npm
 import path from 'path';
-import webpack from 'webpack';
 import fs from 'fs-extra';
 import serialize from 'serialize-javascript';
-
-import SpeedMeasurePlugin from "speed-measure-webpack-v5-plugin";
-const smp = new SpeedMeasurePlugin({ disable: true });
+import { rspack, type Compiler as RspackCompiler } from '@rspack/core';
+import ts from 'typescript';
 
 // Core
 import app from '../app';
 import cli from '..';
 import createServerConfig from './server';
 import createClientConfig from './client';
-import { TCompileMode } from './common';
-
-type TCompilerCallback = (compiler: webpack.Compiler) => void
+import { TCompileMode, TCompileOutputTarget } from './common';
+import {
+    indexControllers,
+    generateControllerClientTree,
+    printControllerTree,
+    type TControllerServiceRoot,
+} from './common/controllers';
+import { writeClientManifest } from './common/clientManifest';
+import { getGeneratedRouteModuleFilepath, writeGeneratedRouteModule } from './common/generatedRouteModules';
+import writeIfChanged from './writeIfChanged';
+
+type TCompilerCallback = (compiler: RspackCompiler) => void;
 
 type TServiceMetas = {
-    id: string, 
-    name: string, 
-    parent: string, 
-    dependences: string, 
-    importationPath: string,
-    priority: number
-}
+    id: string;
+    name: string;
+    parent: string;
+    dependences: string;
+    importationPath: string;
+    priority: number;
+};
 
 type TRegisteredService = {
-    id?: string,
-    name: string,
-    className: string,
-    instanciation: (parentRef?: string) => string,
-    priority: number,
-}
+    id?: string;
+    name: string;
+    className: string;
+    instanciation: (parentRef?: string, appRef?: string) => string;
+    priority: number;
+};
+
+type TClientRouteLoader = { filepath: string; chunkId: string; preload: boolean };
+
+type TRecentCompilationResult = { succeeded: boolean; hash?: string; modifiedFiles?: string[] };
+
+const normalizePath = (value: string) => value.replace(/\\/g, '/');
 
 /*----------------------------------
 - FONCTION
 ----------------------------------*/
 export default class Compiler {
-
-    public compiling: { [compiler: string]: Promise<void> } = {};     
+    public compiling: { [compiler: string]: Promise<void> } = {};
+    private recentCompilationResults: { [compiler: string]: TRecentCompilationResult } = {};
+    private recentModifiedFiles: { [compiler: string]: string[] } = {};
+    private refreshingGeneratedArtifacts?: Promise<void>;
 
     public constructor(
         private mode: TCompileMode,
-        private callbacks: {
-            before?: TCompilerCallback,
-            after?: TCompilerCallback,
-        } = {},
-        private debug: boolean = false
-    ) {
-
-    }
+        private callbacks: { before?: TCompilerCallback; after?: TCompilerCallback } = {},
+        private debug: boolean = false,
+        private outputTarget: TCompileOutputTarget = mode === 'dev' ? 'dev' : 'bin',
+    ) {}
 
     public cleanup() {
+        const outputPath = app.outputPath(this.outputTarget);
+        const generatedPublicEntries = new Set(['app']);
+        const outputPublicPath = path.join(outputPath, 'public');
+        const preserveDevOutput = this.mode === 'dev' && this.outputTarget === 'dev';
 
-        fs.emptyDirSync( app.paths.bin );
-        fs.ensureDirSync( path.join(app.paths.bin, 'public') )
-        const publicFiles = fs.readdirSync(app.paths.public);
-        for (const publicFile of publicFiles) {
-            // Dev: faster to use symlink
-            if (this.mode === 'dev')
-                fs.symlinkSync( 
-                    path.join(app.paths.public, publicFile), 
-                    path.join(app.paths.bin, 'public', publicFile) 
-                );
-            // Prod: Symlink not always supported by CI / Containers solutions
-            else
-                fs.copySync( 
-                    path.join(app.paths.public, publicFile), 
-                    path.join(app.paths.bin, 'public', publicFile) 
-                );
-        }
+        if (!preserveDevOutput) fs.emptyDirSync(outputPath);
+
+        fs.ensureDirSync(outputPublicPath);
+        this.syncPublicEntries(outputPublicPath, generatedPublicEntries, this.mode === 'dev');
     }
     /* FIX issue with npm link
         When we install a module with npm link, this module's deps are not installed in the parent project scope
@@ -83,10 +85,11 @@ export default class Compiler {
     */
     public fixNpmLinkIssues() {
         const corePath = path.join(app.paths.root, '/node_modules/proteum');
-        if (!fs.lstatSync( corePath ).isSymbolicLink())
+        if (!fs.lstatSync(corePath).isSymbolicLink())
             return console.info("Not fixing npm issue because proteum wasn't installed with npm link.");
 
         this.debug && console.info(`Fix NPM link issues ...`);
+        const outputPath = app.outputPath(this.outputTarget);
 
         const appModules = path.join(app.paths.root, 'node_modules');
         const coreModules = path.join(corePath, 'node_modules');
@@ -95,191 +98,718 @@ export default class Compiler {
         // Modules are installed locally and not glbally as with with the 5htp package from NPM.
         // So we need to symbilnk the http-core node_modules in one of the parents of server.js.
         // It avoids errors like: "Error: Cannot find module 'intl'"
-        fs.symlinkSync( coreModules, path.join(app.paths.bin, 'node_modules') );
+        this.ensureSymlinkSync(coreModules, path.join(outputPath, 'node_modules'));
 
-        // Same problem: when 5htp-core is installed via npm link, 
+        // Same problem: when 5htp-core is installed via npm link,
         // Typescript doesn't detect React and shows mission JSX errors
         const preactCoreModule = path.join(coreModules, 'preact');
         const preactAppModule = path.join(appModules, 'preact');
         const reactAppModule = path.join(appModules, 'react');
 
-        if (!fs.existsSync( preactAppModule ))
-            fs.symlinkSync( preactCoreModule, preactAppModule );
-        if (!fs.existsSync( reactAppModule ))
-            fs.symlinkSync( path.join(preactCoreModule, 'compat'), reactAppModule );
+        if (!fs.existsSync(preactAppModule)) fs.symlinkSync(preactCoreModule, preactAppModule);
+        if (!fs.existsSync(reactAppModule)) fs.symlinkSync(path.join(preactCoreModule, 'compat'), reactAppModule);
     }
 
-    private findServices( dir: string ) {
+    private syncPublicEntries(outputPublicPath: string, generatedPublicEntries: Set<string>, useSymlinks: boolean) {
+        const publicFiles = new Set(
+            fs.readdirSync(app.paths.public).filter((publicFile) => !generatedPublicEntries.has(publicFile)),
+        );
+
+        for (const existingPublicFile of fs.readdirSync(outputPublicPath)) {
+            if (generatedPublicEntries.has(existingPublicFile) || publicFiles.has(existingPublicFile)) continue;
 
-        const blacklist = ['node_modules', 'proteum']
+            fs.removeSync(path.join(outputPublicPath, existingPublicFile));
+        }
+
+        for (const publicFile of publicFiles) {
+            const sourcePath = path.join(app.paths.public, publicFile);
+            const outputFilePath = path.join(outputPublicPath, publicFile);
+
+            if (useSymlinks) {
+                this.ensureSymlinkSync(sourcePath, outputFilePath);
+                continue;
+            }
+
+            if (fs.existsSync(outputFilePath)) fs.removeSync(outputFilePath);
+
+            fs.copySync(sourcePath, outputFilePath);
+        }
+    }
+
+    private ensureSymlinkSync(targetPath: string, linkPath: string) {
+        fs.ensureDirSync(path.dirname(linkPath));
+
+        try {
+            const linkStats = fs.lstatSync(linkPath);
+
+            if (linkStats.isSymbolicLink()) {
+                const currentTarget = path.resolve(path.dirname(linkPath), fs.readlinkSync(linkPath));
+                if (currentTarget === path.resolve(targetPath)) return;
+            }
+
+            fs.removeSync(linkPath);
+        } catch (error) {
+            if ((error as NodeJS.ErrnoException).code !== 'ENOENT') throw error;
+        }
+
+        fs.symlinkSync(targetPath, linkPath);
+    }
+
+    private findServices(dir: string) {
+        const blacklist = ['node_modules', 'proteum'];
         const files: string[] = [];
         const dirents = fs.readdirSync(dir, { withFileTypes: true });
 
         for (let dirent of dirents) {
-
             let fileName = dirent.name;
             let filePath = path.resolve(dir, fileName);
 
-            if (blacklist.includes( fileName ))
-                continue;
+            if (blacklist.includes(fileName)) continue;
 
             // Define is we should recursively find service in the current item
             let iterate: boolean = false;
             if (dirent.isSymbolicLink()) {
-
-                const realPath = path.resolve( dir, fs.readlinkSync(filePath) );
-                const destinationInfos = fs.lstatSync( realPath );
-                if (destinationInfos.isDirectory())
-                    iterate = true;
-
-            } else if (dirent.isDirectory())
-                iterate = true;
+                const realPath = path.resolve(dir, fs.readlinkSync(filePath));
+                const destinationInfos = fs.lstatSync(realPath);
+                if (destinationInfos.isDirectory()) iterate = true;
+            } else if (dirent.isDirectory()) iterate = true;
 
             // Update the list of found services
             if (iterate) {
-                files.push( ...this.findServices(filePath) );
+                files.push(...this.findServices(filePath));
             } else if (dirent.name === 'service.json') {
-                files.push( path.dirname(filePath) );
+                files.push(path.dirname(filePath));
             }
         }
         return files;
     }
 
-    private indexServices() {
-        
+    private findClientRouteFiles(dir: string): string[] {
+        return this.findRegisteredRouteFiles(dir, { excludeLayoutDirectories: true });
+    }
+
+    private findServerRouteFiles(dir: string): string[] {
+        return this.findRegisteredRouteFiles(dir);
+    }
+
+    private findRegisteredRouteFiles(dir: string, options: { excludeLayoutDirectories?: boolean } = {}): string[] {
+        if (!fs.existsSync(dir)) return [];
+
+        const files: string[] = [];
+
+        for (const dirent of fs.readdirSync(dir, { withFileTypes: true })) {
+            const filePath = path.join(dir, dirent.name);
+
+            if (dirent.isDirectory()) {
+                if (options.excludeLayoutDirectories && dirent.name === '_layout') continue;
+
+                files.push(...this.findRegisteredRouteFiles(filePath, options));
+                continue;
+            }
+
+            if (!dirent.isFile()) continue;
+
+            if (!/\.(ts|tsx)$/.test(dirent.name)) continue;
+
+            const content = fs.readFileSync(filePath, 'utf8');
+            if (!this.hasRegisteredRouteDefinitions(filePath, content)) continue;
+
+            files.push(filePath);
+        }
+
+        return files;
+    }
+
+    private hasRegisteredRouteDefinitions(filepath: string, content: string) {
+        const sourceFile = ts.createSourceFile(
+            filepath,
+            content,
+            ts.ScriptTarget.Latest,
+            true,
+            filepath.endsWith('.tsx') ? ts.ScriptKind.TSX : ts.ScriptKind.TS,
+        );
+
+        return sourceFile.statements.some((statement) => {
+            if (!ts.isExpressionStatement(statement)) return false;
+            if (!ts.isCallExpression(statement.expression)) return false;
+            if (!ts.isPropertyAccessExpression(statement.expression.expression)) return false;
+
+            const callee = statement.expression.expression;
+
+            return (
+                ts.isIdentifier(callee.expression) &&
+                callee.expression.text === 'Router' &&
+                ['page', 'error', 'get', 'post', 'put', 'delete', 'patch'].includes(callee.name.text)
+            );
+        });
+    }
+
+    private findLayoutFiles(dir: string): string[] {
+        if (!fs.existsSync(dir)) return [];
+
+        const files: string[] = [];
+
+        for (const dirent of fs.readdirSync(dir, { withFileTypes: true })) {
+            const filePath = path.join(dir, dirent.name);
+
+            if (dirent.isDirectory()) {
+                files.push(...this.findLayoutFiles(filePath));
+                continue;
+            }
+
+            if (!dirent.isFile()) continue;
+
+            if (dirent.name !== 'index.tsx') continue;
+
+            if (!normalizePath(filePath).includes('/_layout/')) continue;
+
+            files.push(filePath);
+        }
+
+        return files;
+    }
+
+    private getGeneratedImportPath(fromDir: string, targetFile: string) {
+        const relativeImportPath = path.relative(fromDir, targetFile).replace(/\\/g, '/');
+        const normalizedImportPath = relativeImportPath.startsWith('.') ? relativeImportPath : './' + relativeImportPath;
+
+        return normalizedImportPath.replace(/\.(ts|tsx|js|jsx)$/, '');
+    }
+
+    private cleanupObsoleteGeneratedArtifacts() {
+        fs.removeSync(path.join(app.paths.client.generated, 'index.ts'));
+    }
+
+    private readPreloadedRouteChunks() {
+        const preloadPath = path.join(app.paths.pages, 'preload.json');
+
+        if (!fs.existsSync(preloadPath)) return new Set<string>();
+
+        const content = fs.readJsonSync(preloadPath);
+
+        if (!Array.isArray(content))
+            throw new Error(`Invalid client/pages/preload.json format: expected an array of chunk ids.`);
+
+        return new Set<string>(content.filter((value): value is string => typeof value === 'string'));
+    }
+
+    private getGeneratedClientRouteModuleFilepath(filepath: string) {
+        return getGeneratedRouteModuleFilepath(app.paths.client.generated, app.paths.pages, filepath);
+    }
+
+    private getGeneratedServerRouteModuleFilepath(filepath: string) {
+        return getGeneratedRouteModuleFilepath(app.paths.server.generated, app.paths.root, filepath);
+    }
+
+    private generateClientRouteWrapperModules() {
+        const clientRouteFiles = this.findClientRouteFiles(app.paths.pages).sort((a, b) => a.localeCompare(b));
+        const routeSourceFilepaths = new Set(clientRouteFiles.map((filepath) => normalizePath(path.resolve(filepath))));
+
+        for (const filepath of clientRouteFiles) {
+            const pageChunk = cli.paths.getPageChunk(app, filepath);
+
+            writeGeneratedRouteModule({
+                outputFilepath: this.getGeneratedClientRouteModuleFilepath(filepath),
+                runtime: 'client',
+                side: 'client',
+                sourceFilepath: filepath,
+                clientRoute: { chunkId: pageChunk.chunkId, filepath: pageChunk.filepath },
+                routeSourceFilepaths,
+            });
+
+            writeGeneratedRouteModule({
+                outputFilepath: this.getGeneratedServerRouteModuleFilepath(filepath),
+                runtime: 'server',
+                side: 'client',
+                sourceFilepath: filepath,
+                clientRoute: { chunkId: pageChunk.chunkId, filepath: pageChunk.filepath },
+                routeSourceFilepaths,
+            });
+        }
+    }
+
+    private generateServerRouteWrapperModules() {
+        const serverRouteFiles = this.findServerRouteFiles(path.join(app.paths.root, 'server', 'routes')).sort((a, b) =>
+            a.localeCompare(b),
+        );
+        const routeSourceFilepaths = new Set(serverRouteFiles.map((filepath) => normalizePath(path.resolve(filepath))));
+
+        for (const filepath of serverRouteFiles) {
+            writeGeneratedRouteModule({
+                outputFilepath: this.getGeneratedServerRouteModuleFilepath(filepath),
+                runtime: 'server',
+                side: 'server',
+                sourceFilepath: filepath,
+                routeSourceFilepaths,
+            });
+        }
+    }
+
+    private generateClientRoutesModule() {
+        const routeLoadersFile = path.join(app.paths.client.generated, 'routes.ts');
+        const preloadedChunks = this.readPreloadedRouteChunks();
+
+        const routes = this.findClientRouteFiles(app.paths.pages)
+            .sort((a, b) => a.localeCompare(b))
+            .map<TClientRouteLoader>((filepath) => {
+                const { chunkId } = cli.paths.getPageChunk(app, filepath);
+
+                return { filepath, chunkId, preload: preloadedChunks.has(chunkId) };
+            });
+
+        const imports: string[] = [];
+        const routeEntries: string[] = [];
+
+        routes.forEach((route, index) => {
+            const normalizedImportPath = this.getGeneratedImportPath(
+                app.paths.client.generated,
+                this.getGeneratedClientRouteModuleFilepath(route.filepath),
+            );
+
+            if (route.preload) {
+                const localIdentifier = `preloadedRoute${index}`;
+                imports.push(
+                    `import { __register as ${localIdentifier} } from ${JSON.stringify(normalizedImportPath)};`,
+                );
+                routeEntries.push(
+                    `    ${JSON.stringify(route.chunkId)}: () => Promise.resolve({ __register: ${localIdentifier} }),`,
+                );
+                return;
+            }
+
+            routeEntries.push(
+                `    ${JSON.stringify(route.chunkId)}: () => import(/* webpackChunkName: ${JSON.stringify(route.chunkId)} */ ${JSON.stringify(normalizedImportPath)}),`,
+            );
+        });
+
+        const content = `/*----------------------------------
+- GENERATED FILE
+----------------------------------*/
+
+// This file is generated by Proteum to avoid rebuilding the page loader map in Babel.
+// Do not edit it manually.
+
+${imports.join('\n')}
+${imports.length ? '\n' : ''}const routes = {
+${routeEntries.join('\n')}
+};
+
+export default routes;
+`;
+
+        writeIfChanged(routeLoadersFile, content);
+    }
+
+    private generateClientLayoutsModule() {
+        const layoutsFile = path.join(app.paths.client.generated, 'layouts.ts');
+
+        const layouts = this.findLayoutFiles(app.paths.pages)
+            .map((filepath) => {
+                const { chunkId } = cli.paths.getLayoutChunk(app, filepath);
+                const importPath = this.getGeneratedImportPath(app.paths.client.generated, filepath);
+                const relativePath = normalizePath(path.relative(app.paths.root, filepath));
+                const depth = relativePath.split('/').filter(Boolean).length;
+
+                return { filepath: relativePath, chunkId, depth, importPath };
+            })
+            .sort((a, b) => {
+                if (b.depth !== a.depth) return b.depth - a.depth;
+                return a.filepath.localeCompare(b.filepath);
+            });
+
+        const imports = layouts
+            .map((layout, index) => `import * as layoutModule${index} from ${JSON.stringify(layout.importPath)};`)
+            .join('\n');
+
+        const layoutEntries = layouts
+            .map((layout, index) => `    ${JSON.stringify(layout.chunkId)}: layoutModule${index},`)
+            .join('\n');
+
+        const orderedLayoutIds = layouts.map((layout) => `    ${JSON.stringify(layout.chunkId)},`).join('\n');
+
+        const content = `/*----------------------------------
+- GENERATED FILE
+----------------------------------*/
+
+// This file is generated by Proteum from app layout files.
+// Do not edit it manually.
+
+${imports}
+${imports ? '\n' : ''}const layouts = {
+${layoutEntries}
+};
 
+export const layoutOrder = [
+${orderedLayoutIds}
+];
+
+export default layouts;
+`;
+
+        writeIfChanged(layoutsFile, content);
+    }
+
+    private generateServerRoutesModule() {
+        const routeModulesFile = path.join(app.paths.server.generated, 'routes.ts');
+        const serverRouteFiles = this.findServerRouteFiles(path.join(app.paths.root, 'server', 'routes'))
+            .sort((a, b) => a.localeCompare(b))
+            .map((filepath) => ({
+                filepath: normalizePath(path.relative(app.paths.root, filepath)),
+                importPath: this.getGeneratedImportPath(
+                    app.paths.server.generated,
+                    this.getGeneratedServerRouteModuleFilepath(filepath),
+                ),
+            }));
+
+        const pageRouteFiles = this.findClientRouteFiles(app.paths.pages)
+            .sort((a, b) => a.localeCompare(b))
+            .map((filepath) => ({
+                filepath: normalizePath(path.relative(app.paths.root, filepath)),
+                importPath: this.getGeneratedImportPath(
+                    app.paths.server.generated,
+                    this.getGeneratedServerRouteModuleFilepath(filepath),
+                ),
+            }));
+
+        const routeModules = [...serverRouteFiles, ...pageRouteFiles];
+
+        const imports = routeModules
+            .map(
+                (routeModule, index) =>
+                    `const routeModule${index} = require(${JSON.stringify(routeModule.importPath)});`,
+            )
+            .join('\n');
+
+        const routeEntries = routeModules
+            .map(
+                (routeModule, index) => `    {
+        filepath: ${JSON.stringify(routeModule.filepath)},
+        register: routeModule${index}.__register,
+    },`,
+            )
+            .join('\n');
+
+        const content = `/*----------------------------------
+- GENERATED FILE
+----------------------------------*/
+
+// This file is generated by Proteum from route registration files.
+// Do not edit it manually.
+
+import type { TRouteModule } from "@common/router";
+${imports ? '\n' + imports : ''}
+
+export type TGeneratedRouteModule = {
+    filepath: string,
+    register?: TRouteModule["__register"],
+}
+
+const routeModules: TGeneratedRouteModule[] = [
+${routeEntries}
+];
+
+export default routeModules;
+`;
+
+        writeIfChanged(routeModulesFile, content);
+    }
+
+    private generateRoutingModules() {
+        this.cleanupObsoleteGeneratedArtifacts();
+        this.generateClientRouteWrapperModules();
+        this.generateServerRouteWrapperModules();
+        this.generateServerRoutesModule();
+        this.generateClientRoutesModule();
+        this.generateClientLayoutsModule();
+    }
+
+    private indexControllers() {
+        const registeredServiceNamesById = new Map<string, string>(
+            Object.values(app.registered).flatMap((service: { id?: string; name?: string }) =>
+                service.id && service.name ? [[service.id, service.name]] : [],
+            ),
+        );
+
+        const appControllerServiceRoots = this.findServices(path.join(app.paths.root, 'server', 'services'))
+            .map<TControllerServiceRoot | null>((serviceDir) => {
+                const metasFile = path.join(serviceDir, 'service.json');
+                const serviceMetas = fs.readJsonSync(metasFile) as { id?: string };
+                const alias = serviceMetas.id ? registeredServiceNamesById.get(serviceMetas.id) : undefined;
+
+                if (!alias) return null;
+
+                return { alias, dir: serviceDir };
+            })
+            .filter((serviceRoot): serviceRoot is TControllerServiceRoot => !!serviceRoot)
+            .sort((a, b) => b.dir.length - a.dir.length);
+
+        return indexControllers([
+            { importPrefix: '@server/services/', root: path.join(cli.paths.core.root, 'server', 'services') },
+            {
+                importPrefix: '@/server/services/',
+                root: path.join(app.paths.root, 'server', 'services'),
+                serviceRoots: appControllerServiceRoots,
+            },
+        ]);
+    }
+
+    private generateControllerModules() {
+        const controllers = this.indexControllers();
+        const clientTree = generateControllerClientTree(controllers);
+
+        const getControllerLeafMeta = (leaf: string) => {
+            const meta = JSON.parse(leaf) as {
+                routePath: string;
+                importPath: string;
+                className: string;
+                methodName: string;
+                hasInput: boolean;
+            };
+            const controllerIndex = controllers.findIndex((controller) => controller.importPath === meta.importPath);
+
+            if (controllerIndex === -1) {
+                throw new Error(`Unable to find controller import ${meta.importPath} while generating controller types.`);
+            }
+
+            return { ...meta, controllerIndex };
+        };
+
+        const runtimeLeaf = (leaf: string) => {
+            const meta = getControllerLeafMeta(leaf);
+            const resultType = `TControllerResult<Controller${meta.controllerIndex}, ${JSON.stringify(meta.methodName)}>`;
+
+            return meta.hasInput
+                ? `(data) => api.createFetcher<${resultType}>('POST', ${JSON.stringify(meta.routePath)}, data)`
+                : `() => api.createFetcher<${resultType}>('POST', ${JSON.stringify(meta.routePath)})`;
+        };
+
+        const typeImports = controllers
+            .map((controller, index) => `import type Controller${index} from ${JSON.stringify(controller.importPath)};`)
+            .join('\n');
+
+        const typeLeaf = (leaf: string) => {
+            const meta = getControllerLeafMeta(leaf);
+            const fetcherType = `TControllerFetcher<Controller${meta.controllerIndex}, ${JSON.stringify(meta.methodName)}>`;
+
+            return meta.hasInput ? `(data: any) => ${fetcherType}` : `() => ${fetcherType}`;
+        };
+
+        const createControllersContent = `/*----------------------------------
+- GENERATED FILE
+----------------------------------*/
+
+// This file is generated by Proteum from server controller files.
+// Do not edit it manually.
+
+import type ApiClient from '@common/router/request/api';
+import type { TFetcher } from '@common/router/request/api';
+${typeImports ? '\n' + typeImports : ''}
+
+type TControllerResult<TController, TMethod extends keyof TController> =
+    TController[TMethod] extends (...args: any[]) => infer TResult ? Awaited<TResult> : never;
+
+type TControllerFetcher<TController, TMethod extends keyof TController> = TFetcher<TControllerResult<TController, TMethod>>;
+
+export type TControllers = ${printControllerTree(clientTree, typeLeaf)};
+
+export const createControllers = (
+    api: Pick<ApiClient, 'createFetcher'>
+): TControllers => (
+${printControllerTree(clientTree, runtimeLeaf)}
+);
+
+export default createControllers;
+`;
+
+        writeIfChanged(path.join(app.paths.common.generated, 'controllers.ts'), createControllersContent);
+
+        writeIfChanged(
+            path.join(app.paths.client.generated, 'controllers.ts'),
+            `export { createControllers, default } from '@/common/.generated/controllers';
+export type { TControllers } from '@/common/.generated/controllers';
+`,
+        );
+
+        const controllerImports = controllers
+            .map((controller, index) => `import Controller${index} from ${JSON.stringify(controller.importPath)};`)
+            .join('\n');
+
+        const controllerEntries = controllers.flatMap((controller, controllerIndex) =>
+            controller.methods.map(
+                (method) => `    {
+        path: ${JSON.stringify('/api/' + method.routePath)},
+        Controller: Controller${controllerIndex},
+        method: ${JSON.stringify(method.name)},
+    },`,
+            ),
+        );
+
+        writeIfChanged(
+            path.join(app.paths.server.generated, 'controllers.ts'),
+            `/*----------------------------------
+- GENERATED FILE
+----------------------------------*/
+
+// This file is generated by Proteum from server controller files.
+// Do not edit it manually.
+
+import type Controller from '@server/app/controller';
+${controllerImports ? '\n' + controllerImports : ''}
+
+export type TGeneratedControllerDefinition = {
+    path: string,
+    Controller: new (request: any) => Controller,
+    method: string,
+}
+
+const controllers: TGeneratedControllerDefinition[] = [
+${controllerEntries.join('\n')}
+];
+
+export default controllers;
+`,
+        );
+    }
+
+    private indexServices() {
         // Index services
         const searchDirs = [
             // The less priority is the first
-            {
-                path: '@server/services/',
-                priority: -1,
-                root: path.join(cli.paths.core.root, 'server', 'services')
-            },
-            {
-                path: '@/server/services/',
-                priority: 0,
-                root: path.join(app.paths.root, 'server', 'services')
-            },
+            { path: '@server/services/', priority: -1, root: path.join(cli.paths.core.root, 'server', 'services') },
+            { path: '@/server/services/', priority: 0, root: path.join(app.paths.root, 'server', 'services') },
             // Temp disabled because compile issue on vercel
             //'': path.join(app.paths.root, 'node_modules'),
-        ]
+        ];
 
         // Generate app class file
-        const servicesAvailable: {[id: string]: TServiceMetas} = {};
+        const servicesAvailable: { [id: string]: TServiceMetas } = {};
         for (const searchDir of searchDirs) {
-
             const services = this.findServices(searchDir.root);
 
             for (const serviceDir of services) {
-                const metasFile = path.join( serviceDir, 'service.json');
+                const metasFile = path.join(serviceDir, 'service.json');
 
                 // The +1 is to remove the slash
-                const importationPath = searchDir.path + serviceDir.substring( searchDir.root.length + 1 );
+                const importationPath = searchDir.path + serviceDir.substring(searchDir.root.length + 1);
 
                 const serviceMetas = require(metasFile);
 
-                servicesAvailable[ serviceMetas.id ] = {
-                    importationPath,
-                    priority: searchDir.priority,
-                    ...serviceMetas,
-                };
+                servicesAvailable[serviceMetas.id] = { importationPath, priority: searchDir.priority, ...serviceMetas };
             }
         }
 
         // Read app services
-        const imported: string[] = []
-        const referencedNames: {[serviceId: string]: string} = {} // ID to Name
+        const imported: string[] = [];
+        const referencedNames: { [serviceId: string]: string } = {}; // ID to Name
+        let serviceImportIndex = 0;
 
         const refService = (serviceName: string, serviceConfig: any, level: number = 0): TRegisteredService => {
-
             if (serviceConfig.refTo !== undefined) {
                 const refTo = serviceConfig.refTo;
                 return {
                     name: serviceName,
-                    instanciation: () => `this.${refTo}`,
-                    priority: 0
-                }
+                    className: serviceName,
+                    instanciation: (_parentRef, appRef = 'this') => `${appRef}.${refTo}`,
+                    priority: 0,
+                };
             }
 
-            const serviceMetas = servicesAvailable[ serviceConfig.id ];
+            const serviceMetas = servicesAvailable[serviceConfig.id];
             if (serviceMetas === undefined)
-                throw new Error(`Service ${serviceConfig.id} not found. Referenced services: ${Object.keys(servicesAvailable).join('\n')}`);
+                throw new Error(
+                    `Service ${serviceConfig.id} not found. Referenced services: ${Object.keys(servicesAvailable).join('\n')}`,
+                );
 
             const referencedName = referencedNames[serviceConfig.id];
             if (referencedName !== undefined)
                 throw new Error(`Service ${serviceConfig.id} is already setup as ${referencedName}`);
-            
-            // Generate index & typings
-            imported.push(`import ${serviceMetas.name} from "${serviceMetas.importationPath}";`);
 
-            if (serviceConfig.name !== undefined)
-                referencedNames[serviceConfig.id] = serviceConfig.name;
+            // Generate index & typings
+            const importIdentifier = `${serviceMetas.name}Class${serviceImportIndex++}`;
+            imported.push(`import ${importIdentifier} from "${serviceMetas.importationPath}";`);
 
-            const processConfig = (config: any, level: number = 0) => {
+            if (serviceConfig.name !== undefined) referencedNames[serviceConfig.id] = serviceConfig.name;
 
+            const processConfig = (config: any, level: number = 0, appRef: string = 'this') => {
                 let propsStr = '';
                 for (const key in config) {
                     const value = config[key];
 
                     if (!value || typeof value !== 'object')
                         propsStr += `"${key}":${serialize(value, { space: 4 })},\n`;
-
                     // Reference to a service
-                    else if (value.type === 'service.setup' || value.type === 'service.ref') // TODO: more reliable way to detect a service reference
-                        propsStr += `${key}:`+ refService(key, value, level + 1).instanciation() + ',\n'
-                    
+                    else if (value.type === 'service.setup' || value.type === 'service.ref')
+                        // TODO: more reliable way to detect a service reference
+                        propsStr += `${key}:` + refService(key, value, level + 1).instanciation(undefined, appRef) + ',\n';
                     // Recursion
                     else if (level <= 4 && !Array.isArray(value))
-                        propsStr += `"${key}":` + processConfig(value, level + 1) + ',\n';
-
-                    else
-                        propsStr += `"${key}":${serialize(value, { space: 4 })},\n`;
-
+                        propsStr += `"${key}":` + processConfig(value, level + 1, appRef) + ',\n';
+                    else propsStr += `"${key}":${serialize(value, { space: 4 })},\n`;
                 }
 
                 return `{ ${propsStr} }`;
-            }
-            const config = processConfig(serviceConfig.config || {});
+            };
 
             // Generate the service instance
-            const instanciation = (parentRef?: string) => 
-                `new ${serviceMetas.name}( 
+            const instanciation = (parentRef?: string, appRef: string = 'this') => {
+                const config = processConfig(serviceConfig.config || {}, 0, appRef);
+                const typedRouterConfig =
+                    serviceMetas.id === 'Core/Router' && parentRef
+                        ? `defineServiceConfig(${config} satisfies ConstructorParameters<typeof ${importIdentifier}>[1])`
+                        : `defineServiceConfig(${config})`;
+
+                return `new ${importIdentifier}( 
                     ${parentRef ? `${parentRef},` : ''}
-                    ${config},
-                    this 
-                )`
+                    ${typedRouterConfig},
+                    ${appRef} 
+                )`;
+            };
 
             return {
                 id: serviceConfig.id,
                 name: serviceName,
                 instanciation,
-                className: serviceMetas.name,
+                className: importIdentifier,
                 priority: serviceConfig.config?.priority || serviceMetas.priority || 0,
             };
-        }
+        };
 
-        const servicesCode = Object.values(app.registered).map( s => refService(s.name, s, 0));
+        const servicesCode = Object.values(app.registered).map((s) => refService(s.name, s, 0));
         const sortedServices = servicesCode.sort((a, b) => a.priority - b.priority);
 
         // Define the app class identifier
         const appClassIdentifier = app.identity.identifier;
-        const containerServices = app.containerServices.map( s => "'" + s + "'").join('|');
+        const containerServices = app.containerServices.map((s) => "'" + s + "'").join('|');
+        const generatedFactories = sortedServices
+            .map((service) => {
+                const factoryIdentifier = `create${service.className}`;
+                const instanceIdentifier = `${service.className}Instance`;
+
+                return `const ${factoryIdentifier} = (app: ${appClassIdentifier}) => ${service.instanciation('app', 'app')};
+
+type ${instanceIdentifier} = ReturnType<typeof ${factoryIdentifier}>;`;
+            })
+            .join('\n\n');
 
         // @/client/.generated/services.d.ts
-        fs.outputFileSync(
-            path.join( app.paths.client.generated, 'services.d.ts'),
-`declare module "@app" {
+        writeIfChanged(
+            path.join(app.paths.client.generated, 'services.d.ts'),
+            `declare type ${appClassIdentifier} = import("@/server/.generated/app").default;
+
+declare module "@app" {
 
     import { ${appClassIdentifier} as ${appClassIdentifier}Client } from "@/client";
     import ${appClassIdentifier}Server from "@/server/.generated/app";
   
     export const Router: ${appClassIdentifier}Client['Router'];
 
-    ${sortedServices.map(service => service.name !== 'Router'
-        ? `export const ${service.name}: ${appClassIdentifier}Server["${service.name}"];`
-        : ''
-    ).join('\n')}
+    ${sortedServices
+        .map((service) =>
+            service.name !== 'Router'
+                ? `export const ${service.name}: ${appClassIdentifier}Server["${service.name}"];`
+                : '',
+        )
+        .join('\n')}
 
 }
     
@@ -299,91 +829,96 @@ declare module '@common/errors' {
     export type UpgradeRequired = import('@common/errors/index').UpgradeRequired<FeatureKeys>;
 }
 
-declare module '@request' {
-    
-}
-
 declare namespace preact.JSX {
     interface HTMLAttributes {
         src?: string;
     }
 }
-`
+`,
         );
 
         // @/client/.generated/context.ts
-        fs.outputFileSync(
-            path.join( app.paths.client.generated, 'context.ts'),
-`// TODO: move it into core (but how to make sure usecontext returns ${appClassIdentifier}'s context ?)
+        writeIfChanged(
+            path.join(app.paths.client.generated, 'context.ts'),
+            `// TODO: move it into core (but how to make sure usecontext returns ${appClassIdentifier}'s context ?)
 import React from 'react';
 
-import type ${appClassIdentifier}Server from '@/server/.generated/app';
-import type { TRouterContext as TServerRouterRequestContext } from '@server/services/router/response';
-import type { TRouterContext as TClientRouterRequestContext } from '@client/services/router/response';
-import type ${appClassIdentifier}Client from '.';
+import type ${appClassIdentifier}Client from '@/client/index';
 
-// TO Fix: TClientRouterRequestContext is unable to get the right type of ${appClassIdentifier}Client["router"]
-    //    (it gets ClientApplication instead of ${appClassIdentifier}Client)
-type ClientRequestContext = TClientRouterRequestContext<${appClassIdentifier}Client["Router"], ${appClassIdentifier}Client>;
-type ServerRequestContext = TServerRouterRequestContext<${appClassIdentifier}Server["Router"]>
-type UniversalServices = ClientRequestContext | ServerRequestContext
-
-// Non-universla services are flagged as potentially undefined
-export type ClientContext = (
-    UniversalServices 
-    & 
-    Partial<Omit<ClientRequestContext, keyof UniversalServices>>
-    &
-    {
-        Router: ${appClassIdentifier}Client["Router"],
-    }
-)
+export type ClientContext = ${appClassIdentifier}Client["Router"]["context"];
 
 export const ReactClientContext = React.createContext<ClientContext>({} as ClientContext);
-export default (): ClientContext => React.useContext<ClientContext>(ReactClientContext);`);
+export default (): ClientContext => React.useContext<ClientContext>(ReactClientContext);`,
+        );
 
         // @/common/.generated/services.d.ts
-        fs.outputFileSync(
-            path.join( app.paths.common.generated, 'services.d.ts'),
-`declare module '@models/types' {
+        writeIfChanged(
+            path.join(app.paths.common.generated, 'services.d.ts'),
+            `declare type ${appClassIdentifier} = import("@/server/.generated/app").default;
+
+declare module '@models/types' {
     export * from '@/var/prisma/index';
-}`
+}`,
+        );
+
+        // @/common/generated.d.ts
+        writeIfChanged(
+            path.join(app.paths.root, 'common', 'generated.d.ts'),
+            `/// <reference path="./.generated/services.d.ts" />
+`,
         );
 
         // @/server/.generated/app.ts
-        fs.outputFileSync(
-            path.join( app.paths.server.generated, 'app.ts'),
-`
+        writeIfChanged(
+            path.join(app.paths.server.generated, 'app.ts'),
+            `
 import { Application } from '@server/app/index';
 import { ServicesContainer } from '@server/app/service/container';
 
 ${imported.join('\n')}
 
+type TLooseServiceConfig<TConfig> =
+    TConfig extends (...args: any[]) => any ? TConfig
+    : TConfig extends Array<infer TItem> ? Array<TLooseServiceConfig<TItem>>
+    : TConfig extends object ? ({ [K in keyof TConfig]?: TLooseServiceConfig<TConfig[K]> } & Record<string, unknown>)
+    : TConfig;
+
+const defineServiceConfig = <TConfig>(value: TConfig): TConfig => value;
+
+${generatedFactories}
+
 export default class ${appClassIdentifier} extends Application<ServicesContainer, CurrentUser> {
 
     // Make sure the services typigs are reflecting the config and referring to the app
-    ${sortedServices.map(service => 
-        `public ${service.name}!: ReturnType<${appClassIdentifier}["registered"]["${service.id}"]["start"]>;`
-    ).join('\n')}
-
-    protected registered = {
-        ${sortedServices.map(service => 
-            `"${service.id}": {
+    ${sortedServices
+        .map(
+            (service) =>
+                `public ${service.name}!: ${service.className}Instance;`,
+        )
+        .join('\n')}
+
+    protected registered: Record<string, { name: string; priority: number; start: () => import('@server/app/service').AnyService }> = {
+        ${sortedServices
+            .map(
+                (service) =>
+                    `"${service.id}": {
                 name: "${service.name}",
                 priority: ${service.priority},
-                start: () => ${service.instanciation('this')}
-            }`
-        ).join(',\n')}
-    } as const;
+                start: () => create${service.className}(this)
+            }`,
+            )
+            .join(',\n')}
+    };
 }
 
 
-`);
+`,
+        );
 
         // @/server/.generated/services.d.ts
-        fs.outputFileSync(
-            path.join( app.paths.server.generated, 'services.d.ts'),
-`type InstalledServices = import('./services').Services;
+        writeIfChanged(
+            path.join(app.paths.server.generated, 'services.d.ts'),
+            `type InstalledServices = Record<string, import('@server/app/service').AnyService>;
 
 declare type ${appClassIdentifier} = import("@/server/.generated/app").default;
 
@@ -392,9 +927,9 @@ declare module '@cli/app' {
     type TSetupConfig<TConfig> =
         TConfig extends (...args: any[]) => any ? TConfig
         : TConfig extends Array<infer TItem> ? Array<TSetupConfig<TItem>>
-        : TConfig extends object ? {
-            [K in keyof TConfig]: TSetupConfig<TConfig[K]> | TServiceSetup | TServiceRef
-        }
+        : TConfig extends object ? ({
+            [K in keyof TConfig]?: TSetupConfig<TConfig[K]> | TServiceSetup | TServiceRef
+        } & Record<string, unknown>)
         : TConfig;
 
     type App = {
@@ -454,26 +989,6 @@ declare module '@server/app' {
     export = foo;
 }
 
-declare module '@request' {
-    import type { TRouterContext } from '@server/services/router/response';
-    const routerContext: TRouterContext<${appClassIdentifier}["Router"]>;
-    export = routerContext;
-}
-    
-declare module '@models' {
-    import { Prisma, PrismaClient } from '@/var/prisma/index';
-  
-    type ModelNames = Prisma.ModelName;
-  
-    type ModelDelegates = {
-      [K in ModelNames]: PrismaClient[Uncapitalize<K>];
-    };
-  
-    const models: ModelDelegates;
-  
-    export = models;
-}
-
 declare module '@common/errors' {
         
     export * from '@common/errors/index';
@@ -488,42 +1003,73 @@ declare module '@common/errors' {
     
 declare module '@models/types' {
     export * from '@/var/prisma/index';
-}`
+}`,
         );
     }
 
-    public async create() {
-
+    private async warmupApp() {
         await app.warmup();
+    }
+
+    private async refreshGeneratedArtifacts() {
+        if (!this.refreshingGeneratedArtifacts) {
+            this.refreshingGeneratedArtifacts = (async () => {
+                this.indexServices();
+                this.generateControllerModules();
+                this.generateRoutingModules();
+            })().finally(() => {
+                this.refreshingGeneratedArtifacts = undefined;
+            });
+        }
+
+        await this.refreshingGeneratedArtifacts;
+    }
+
+    public async refreshGeneratedTypings() {
+        await this.warmupApp();
+        await this.refreshGeneratedArtifacts();
+    }
+
+    public consumeRecentCompilationResults() {
+        const recentCompilationResults = { ...this.recentCompilationResults };
+        this.recentCompilationResults = {};
+        return recentCompilationResults;
+    }
+
+    public async create() {
+        await this.warmupApp();
 
         this.cleanup();
 
         this.fixNpmLinkIssues();
-
-        this.indexServices();
+        await this.refreshGeneratedArtifacts();
 
         // Create compilers
-        const multiCompiler = webpack([
-            smp.wrap( createServerConfig(app, this.mode) ),
-            smp.wrap( createClientConfig(app, this.mode) )
+        const multiCompiler = rspack([
+            createServerConfig(app, this.mode, this.outputTarget),
+            createClientConfig(app, this.mode, this.outputTarget),
         ]);
 
         for (const compiler of multiCompiler.compilers) {
-
             const name = compiler.name;
-            if (name === undefined)
-                throw new Error(`A name must be specified to each compiler.`);
+            if (name === undefined) throw new Error(`A name must be specified to each compiler.`);
 
             let timeStart = new Date();
 
-            let finished: (() => void);
-            this.compiling[name] = new Promise((resolve) => finished = resolve);
+            let finished: () => void;
+            this.compiling[name] = new Promise((resolve) => (finished = resolve));
+
+            compiler.hooks.beforeRun.tapPromise(name, () => this.refreshGeneratedArtifacts());
+            compiler.hooks.watchRun.tapPromise(name, () => this.refreshGeneratedArtifacts());
 
             compiler.hooks.compile.tap(name, (compilation) => {
-                
-                this.callbacks.before && this.callbacks.before( compiler );
+                this.callbacks.before && this.callbacks.before(compiler);
 
-                this.compiling[name] = new Promise((resolve) => finished = resolve);
+                this.recentModifiedFiles[name] = [...(compiler.modifiedFiles ? [...compiler.modifiedFiles] : [])].map(
+                    (filepath) => normalizePath(path.resolve(filepath)),
+                );
+
+                this.compiling[name] = new Promise((resolve) => (finished = resolve));
 
                 timeStart = new Date();
                 console.info(`[${name}] Compiling ...`);
@@ -531,22 +1077,29 @@ declare module '@models/types' {
 
             /* TODO: Ne pas résoudre la promise tant que la recompilation des données indexées (icones, identité, ...) 
                 n'a pas été achevée */
-            compiler.hooks.done.tap(name, stats => {
+            compiler.hooks.done.tap(name, (stats) => {
+                const compilationSucceeded = !stats.hasErrors();
+                this.recentCompilationResults[name] = {
+                    succeeded: compilationSucceeded,
+                    hash: typeof stats.hash === 'string' ? stats.hash : undefined,
+                    modifiedFiles: this.recentModifiedFiles[name] || [],
+                };
 
                 // Shiow status
                 const timeEnd = new Date();
                 const time = timeEnd.getTime() - timeStart.getTime();
-                if (stats.hasErrors()) {
-
+                if (!compilationSucceeded) {
                     console.info(stats.toString(compiler.options.stats));
                     console.error(`[${name}] Failed to compile after ${time} ms`);
 
                     // Exit process with code 0, so the CI container can understand building failed
                     // Only in prod, because in dev, we want the compiler watcher continue running
-                    if (this.mode === 'prod')
-                        process.exit(0);
-
+                    if (this.mode === 'prod') process.exit(0);
                 } else {
+                    if (name === 'client') {
+                        writeClientManifest(stats, app.outputPath(this.outputTarget));
+                    }
+
                     this.debug && console.info(stats.toString(compiler.options.stats));
                     console.info(`[${name}] Finished compilation after ${time} ms`);
                 }
@@ -558,7 +1111,5 @@ declare module '@models/types' {
         }
 
         return multiCompiler;
-
     }
-
 }