@moriajs/core 0.1.1 → 0.3.0

package/dist/router.js

@@ -0,0 +1,220 @@
+/**
+ * File-based routing for MoriaJS.
+ *
+ * Scans `src/routes/` for route files and auto-registers them with Fastify.
+ *
+ * Convention:
+ *   src/routes/api/hello.ts       → GET /api/hello       (API handler)
+ *   src/routes/api/users/[id].ts  → GET /api/users/:id   (API handler)
+ *   src/routes/pages/index.ts     → GET /                (SSR page)
+ *   src/routes/pages/about.ts     → GET /about           (SSR page)
+ *
+ * API routes export named HTTP method functions:
+ *   export function GET(request, reply) { ... }
+ *
+ * Page routes export a Mithril component + optional data loader:
+ *   export default { view() { return m('h1', 'Hello') } }
+ *   export async function getServerData(request) { return { user: ... } }
+ */
+import { glob } from 'glob';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { scanMiddleware, getMiddlewareChain } from './middleware.js';
+/** Supported HTTP methods in route files. */
+const HTTP_METHODS = ['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'HEAD', 'OPTIONS'];
+/**
+ * Convert a file path to a URL path.
+ *
+ * - Strips file extension
+ * - Converts `[param]` → `:param`
+ * - Converts `[...slug]` → `*`
+ * - Converts `index` → `/`
+ *
+ * @example
+ * filePathToUrlPath('api/users/[id].ts') → '/api/users/:id'
+ * filePathToUrlPath('pages/index.ts')    → '/'
+ * filePathToUrlPath('pages/about.ts')    → '/about'
+ */
+export function filePathToUrlPath(filePath) {
+    // Remove extension
+    let route = filePath.replace(/\.(ts|js|mts|mjs)$/, '');
+    // Normalize separators
+    route = route.replace(/\\/g, '/');
+    // Convert [param] → :param
+    route = route.replace(/\[([^\].]+)\]/g, ':$1');
+    // Convert [...slug] → *
+    route = route.replace(/\[\.\.\.([^\]]+)\]/g, '*');
+    // Handle pages prefix — strip "pages" and make root-relative
+    if (route.startsWith('pages/')) {
+        route = route.slice(5); // remove "pages"
+    }
+    // Handle api prefix — keep "api"
+    // (no transformation needed)
+    // Handle index files → parent path
+    route = route.replace(/\/index$/, '');
+    // Ensure leading slash
+    if (!route.startsWith('/')) {
+        route = '/' + route;
+    }
+    // Root case
+    if (route === '') {
+        route = '/';
+    }
+    return route;
+}
+/**
+ * Scan a directory for route files and return discovered routes.
+ *
+ * @param routesDir - Absolute path to the routes directory (e.g., `<project>/src/routes`)
+ */
+export async function scanRoutes(routesDir) {
+    const pattern = '**/*.{ts,js,mts,mjs}';
+    const files = await glob(pattern, {
+        cwd: routesDir,
+        posix: true,
+        ignore: ['**/_*', '**/*.d.ts', '**/*.test.*', '**/*.spec.*'],
+    });
+    const routes = [];
+    for (const file of files) {
+        const urlPath = filePathToUrlPath(file);
+        const type = file.startsWith('api/') ? 'api' : 'page';
+        const absolutePath = path.resolve(routesDir, file);
+        const fileUrl = pathToFileURL(absolutePath).href;
+        // Dynamically import the route module
+        let mod;
+        try {
+            mod = await import(fileUrl);
+        }
+        catch (err) {
+            console.warn(`[moria] Failed to load route: ${file}`, err);
+            continue;
+        }
+        if (type === 'page') {
+            // ─── Page route: expects default Mithril component ───────
+            const component = mod.default;
+            const getServerData = typeof mod.getServerData === 'function'
+                ? mod.getServerData
+                : undefined;
+            // Page routes can also export raw HTTP handlers (backward compat)
+            if (component && typeof component === 'object' && 'view' in component) {
+                routes.push({
+                    filePath: file,
+                    urlPath,
+                    type: 'page',
+                    methods: {},
+                    component,
+                    getServerData,
+                });
+                continue;
+            }
+            // Fallback: if default export is a function, treat as API-style handler
+            if (typeof component === 'function') {
+                routes.push({
+                    filePath: file,
+                    urlPath,
+                    type: 'page',
+                    methods: { get: component },
+                });
+                continue;
+            }
+            // Also check for named HTTP method exports
+            const methods = {};
+            for (const method of HTTP_METHODS) {
+                const handler = mod[method] ?? mod[method.toLowerCase()];
+                if (typeof handler === 'function') {
+                    methods[method.toLowerCase()] = handler;
+                }
+            }
+            if (Object.keys(methods).length > 0) {
+                routes.push({ filePath: file, urlPath, type: 'page', methods });
+                continue;
+            }
+            console.warn(`[moria] Page route has no component or handlers: ${file}`);
+        }
+        else {
+            // ─── API route: expects named HTTP method exports ────────
+            const methods = {};
+            for (const method of HTTP_METHODS) {
+                const handler = mod[method] ?? mod[method.toLowerCase()];
+                if (typeof handler === 'function') {
+                    methods[method.toLowerCase()] = handler;
+                }
+            }
+            // Also support default export as GET handler
+            if (typeof mod.default === 'function' && !methods.get) {
+                methods.get = mod.default;
+            }
+            if (Object.keys(methods).length === 0) {
+                console.warn(`[moria] Route file has no handlers: ${file}`);
+                continue;
+            }
+            routes.push({ filePath: file, urlPath, type: 'api', methods });
+        }
+    }
+    return routes;
+}
+/**
+ * Register discovered routes with a Fastify server.
+ *
+ * Page routes with Mithril components are auto-wrapped with SSR rendering.
+ * API routes are registered directly as Fastify handlers.
+ * Middleware from `_middleware.ts` files is attached as `preHandler` hooks.
+ */
+export async function registerRoutes(server, routesDir, options = {}) {
+    const routes = await scanRoutes(routesDir);
+    const mode = options.mode ?? 'development';
+    const config = options.config ?? {};
+    // ─── Scan file-based middleware ──────────────────────────
+    const middlewareEntries = await scanMiddleware(routesDir);
+    if (middlewareEntries.length > 0) {
+        server.log.info(`Found ${middlewareEntries.length} middleware file(s): ${middlewareEntries.map((m) => m.scope || '/').join(', ')}`);
+    }
+    for (const route of routes) {
+        // Resolve middleware chain for this route
+        const chain = getMiddlewareChain(route.filePath, middlewareEntries);
+        const preHandler = chain.length > 0 ? chain : undefined;
+        // ─── Page route with Mithril component → SSR handler ─────
+        if (route.component) {
+            const component = route.component;
+            const getServerData = route.getServerData;
+            const clientEntry = config.vite?.clientEntry ?? '/src/entry-client.ts';
+            server.route({
+                method: 'GET',
+                url: route.urlPath,
+                preHandler,
+                handler: async (request, reply) => {
+                    // Load server data if available
+                    let initialData;
+                    if (getServerData) {
+                        initialData = (await getServerData(request));
+                    }
+                    // Dynamic import of renderer (avoids circular deps)
+                    const { renderToString } = await import('@moriajs/renderer');
+                    const html = await renderToString(component, {
+                        title: component.title ?? 'MoriaJS App',
+                        initialData,
+                        mode,
+                        clientEntry,
+                    });
+                    reply.type('text/html');
+                    return html;
+                },
+            });
+            server.log.info(`Page:  GET ${route.urlPath} → ${route.filePath} (SSR)`);
+            continue;
+        }
+        // ─── API / raw handler routes ────────────────────────────
+        for (const [method, handler] of Object.entries(route.methods)) {
+            server.route({
+                method: method.toUpperCase(),
+                url: route.urlPath,
+                preHandler,
+                handler: handler,
+            });
+            server.log.info(`Route: ${method.toUpperCase()} ${route.urlPath} → ${route.filePath}`);
+        }
+    }
+    server.log.info(`Registered ${routes.length} file-based route(s)`);
+    return routes;
+}
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAwB,MAAM,iBAAiB,CAAC;AAE3F,6CAA6C;AAC7C,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAU,CAAC;AAmC3F;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAC9C,mBAAmB;IACnB,IAAI,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;IAEvD,uBAAuB;IACvB,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAElC,2BAA2B;IAC3B,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;IAE/C,wBAAwB;IACxB,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,GAAG,CAAC,CAAC;IAElD,6DAA6D;IAC7D,IAAI,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,iBAAiB;IAC7C,CAAC;IACD,iCAAiC;IACjC,6BAA6B;IAE7B,mCAAmC;IACnC,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAEtC,uBAAuB;IACvB,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,KAAK,GAAG,GAAG,GAAG,KAAK,CAAC;IACxB,CAAC;IAED,YAAY;IACZ,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QACf,KAAK,GAAG,GAAG,CAAC;IAChB,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,SAAiB;IAC9C,MAAM,OAAO,GAAG,sBAAsB,CAAC;IACvC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE;QAC9B,GAAG,EAAE,SAAS;QACd,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,CAAC;KAC/D,CAAC,CAAC;IAEH,MAAM,MAAM,GAAiB,EAAE,CAAC;IAEhC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,IAAI,GAAmB,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QAEtE,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACnD,MAAM,OAAO,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC;QAEjD,sCAAsC;QACtC,IAAI,GAA4B,CAAC;QACjC,IAAI,CAAC;YACD,GAAG,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,iCAAiC,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;YAC3D,SAAS;QACb,CAAC;QAED,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YAClB,4DAA4D;YAC5D,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC;YAC9B,MAAM,aAAa,GAAG,OAAO,GAAG,CAAC,aAAa,KAAK,UAAU;gBACzD,CAAC,CAAC,GAAG,CAAC,aAA8B;gBACpC,CAAC,CAAC,SAAS,CAAC;YAEhB,kEAAkE;YAClE,IAAI,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,MAAM,IAAI,SAAS,EAAE,CAAC;gBACpE,MAAM,CAAC,IAAI,CAAC;oBACR,QAAQ,EAAE,IAAI;oBACd,OAAO;oBACP,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,EAAE;oBACX,SAAS;oBACT,aAAa;iBAChB,CAAC,CAAC;gBACH,SAAS;YACb,CAAC;YAED,wEAAwE;YACxE,IAAI,OAAO,SAAS,KAAK,UAAU,EAAE,CAAC;gBAClC,MAAM,CAAC,IAAI,CAAC;oBACR,QAAQ,EAAE,IAAI;oBACd,OAAO;oBACP,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,EAAE,GAAG,EAAE,SAAyB,EAAE;iBAC9C,CAAC,CAAC;gBACH,SAAS;YACb,CAAC;YAED,2CAA2C;YAC3C,MAAM,OAAO,GAAyD,EAAE,CAAC;YACzE,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;gBAChC,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;gBACzD,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;oBAChC,OAAO,CAAC,MAAM,CAAC,WAAW,EAA2B,CAAC,GAAG,OAAuB,CAAC;gBACrF,CAAC;YACL,CAAC;YACD,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClC,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;gBAChE,SAAS;YACb,CAAC;YAED,OAAO,CAAC,IAAI,CAAC,oDAAoD,IAAI,EAAE,CAAC,CAAC;QAC7E,CAAC;aAAM,CAAC;YACJ,4DAA4D;YAC5D,MAAM,OAAO,GAAyD,EAAE,CAAC;YACzE,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;gBAChC,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;gBACzD,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;oBAChC,OAAO,CAAC,MAAM,CAAC,WAAW,EAA2B,CAAC,GAAG,OAAuB,CAAC;gBACrF,CAAC;YACL,CAAC;YAED,6CAA6C;YAC7C,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,UAAU,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;gBACpD,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC,OAAuB,CAAC;YAC9C,CAAC;YAED,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACpC,OAAO,CAAC,IAAI,CAAC,uCAAuC,IAAI,EAAE,CAAC,CAAC;gBAC5D,SAAS;YACb,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QACnE,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAChC,MAAuB,EACvB,SAAiB,EACjB,UAAiC,EAAE;IAEnC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,SAAS,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,aAAa,CAAC;IAC3C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;IAEpC,4DAA4D;IAC5D,MAAM,iBAAiB,GAAG,MAAM,cAAc,CAAC,SAAS,CAAC,CAAC;IAC1D,IAAI,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,MAAM,CAAC,GAAG,CAAC,IAAI,CACX,SAAS,iBAAiB,CAAC,MAAM,wBAAwB,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACrH,CAAC;IACN,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACzB,0CAA0C;QAC1C,MAAM,KAAK,GAAsB,kBAAkB,CAAC,KAAK,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;QACvF,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QAExD,4DAA4D;QAC5D,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YAClB,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;YAClC,MAAM,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC;YAC1C,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,EAAE,WAAW,IAAI,sBAAsB,CAAC;YAEvE,MAAM,CAAC,KAAK,CAAC;gBACT,MAAM,EAAE,KAAK;gBACb,GAAG,EAAE,KAAK,CAAC,OAAO;gBAClB,UAAU;gBACV,OAAO,EAAE,KAAK,EAAE,OAAuB,EAAE,KAAmB,EAAE,EAAE;oBAC5D,gCAAgC;oBAChC,IAAI,WAAgD,CAAC;oBACrD,IAAI,aAAa,EAAE,CAAC;wBAChB,WAAW,GAAG,CAAC,MAAM,aAAa,CAAC,OAAO,CAAC,CAA4B,CAAC;oBAC5E,CAAC;oBAED,oDAAoD;oBACpD,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;oBAE7D,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,SAAS,EAAE;wBACzC,KAAK,EAAG,SAAgC,CAAC,KAAK,IAAI,aAAa;wBAC/D,WAAW;wBACX,IAAI;wBACJ,WAAW;qBACd,CAAC,CAAC;oBAEH,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;oBACxB,OAAO,IAAI,CAAC;gBAChB,CAAC;aACJ,CAAC,CAAC;YAEH,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,KAAK,CAAC,OAAO,MAAM,KAAK,CAAC,QAAQ,QAAQ,CAAC,CAAC;YACzE,SAAS;QACb,CAAC;QAED,4DAA4D;QAC5D,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5D,MAAM,CAAC,KAAK,CAAC;gBACT,MAAM,EAAE,MAAM,CAAC,WAAW,EAAuB;gBACjD,GAAG,EAAE,KAAK,CAAC,OAAO;gBAClB,UAAU;gBACV,OAAO,EAAE,OAAuB;aACnC,CAAC,CAAC;YACH,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,OAAO,MAAM,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC3F,CAAC;IACL,CAAC;IAED,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,MAAM,sBAAsB,CAAC,CAAC;IACnE,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/vite.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Vite integration for MoriaJS.
+ *
+ * Provides Vite dev server in middleware mode (development)
+ * and static file serving for production builds.
+ */
+import type { FastifyInstance } from 'fastify';
+import type { ViteDevServer } from 'vite';
+import { type MoriaConfig } from './config.js';
+/**
+ * Attach Vite dev server to Fastify in middleware mode.
+ * This enables HMR and on-the-fly module transformation.
+ */
+export declare function createViteDevMiddleware(server: FastifyInstance, config?: Partial<MoriaConfig>): Promise<ViteDevServer>;
+/**
+ * Serve production-built client assets via @fastify/static.
+ */
+export declare function serveProductionAssets(server: FastifyInstance, config?: Partial<MoriaConfig>): Promise<void>;
+/**
+ * Generate the HTML shell for a page, with appropriate script tags
+ * depending on dev vs production mode.
+ */
+export declare function getHtmlScripts(mode: 'development' | 'production', config?: Partial<MoriaConfig>): string;
+//# sourceMappingURL=vite.d.ts.map

package/dist/vite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;GAGG;AACH,wBAAsB,uBAAuB,CACzC,MAAM,EAAE,eAAe,EACvB,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAClC,OAAO,CAAC,aAAa,CAAC,CA4BxB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACvC,MAAM,EAAE,eAAe,EACvB,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAClC,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,YAAY,EAAE,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,MAAM,CAW5G"}

package/dist/vite.js

@@ -0,0 +1,63 @@
+/**
+ * Vite integration for MoriaJS.
+ *
+ * Provides Vite dev server in middleware mode (development)
+ * and static file serving for production builds.
+ */
+/**
+ * Attach Vite dev server to Fastify in middleware mode.
+ * This enables HMR and on-the-fly module transformation.
+ */
+export async function createViteDevMiddleware(server, config = {}) {
+    const { createServer: createViteServer } = await import('vite');
+    const middie = (await import('@fastify/middie')).default;
+    // Register Express-style middleware support
+    await server.register(middie);
+    const vite = await createViteServer({
+        root: config.rootDir ?? process.cwd(),
+        configFile: config.vite?.configFile,
+        server: {
+            middlewareMode: true,
+            hmr: true,
+        },
+        appType: 'custom',
+    });
+    // Use Vite's connect middleware stack
+    server.use(vite.middlewares);
+    server.log.info('Vite dev server attached (HMR enabled)');
+    // Ensure Vite is closed when Fastify shuts down
+    server.addHook('onClose', async () => {
+        await vite.close();
+    });
+    return vite;
+}
+/**
+ * Serve production-built client assets via @fastify/static.
+ */
+export async function serveProductionAssets(server, config = {}) {
+    const path = await import('node:path');
+    const fastifyStatic = (await import('@fastify/static')).default;
+    const distDir = path.resolve(config.rootDir ?? process.cwd(), 'dist', 'client');
+    await server.register(fastifyStatic, {
+        root: distDir,
+        prefix: '/assets/',
+        decorateReply: false,
+    });
+    server.log.info(`Serving static assets from ${distDir}`);
+}
+/**
+ * Generate the HTML shell for a page, with appropriate script tags
+ * depending on dev vs production mode.
+ */
+export function getHtmlScripts(mode, config = {}) {
+    if (mode === 'development') {
+        const clientEntry = config.vite?.clientEntry ?? '/src/entry-client.ts';
+        return [
+            `<script type="module" src="/@vite/client"></script>`,
+            `<script type="module" src="${clientEntry}"></script>`,
+        ].join('\n    ');
+    }
+    // Production: reference the built bundle
+    return `<script type="module" src="/assets/entry-client.js"></script>`;
+}
+//# sourceMappingURL=vite.js.map

package/dist/vite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.js","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CACzC,MAAuB,EACvB,SAA+B,EAAE;IAEjC,MAAM,EAAE,YAAY,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;IAChE,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAC;IAEzD,4CAA4C;IAC5C,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAE9B,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC;QAChC,IAAI,EAAE,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE;QACrC,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,UAAU;QACnC,MAAM,EAAE;YACJ,cAAc,EAAE,IAAI;YACpB,GAAG,EAAE,IAAI;SACZ;QACD,OAAO,EAAE,QAAQ;KACpB,CAAC,CAAC;IAEH,sCAAsC;IACtC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAE7B,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;IAE1D,gDAAgD;IAChD,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;QACjC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACvC,MAAuB,EACvB,SAA+B,EAAE;IAEjC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;IACvC,MAAM,aAAa,GAAG,CAAC,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAC;IAEhE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAEhF,MAAM,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE;QACjC,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,UAAU;QAClB,aAAa,EAAE,KAAK;KACvB,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,8BAA8B,OAAO,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAkC,EAAE,SAA+B,EAAE;IAChG,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;QACzB,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,EAAE,WAAW,IAAI,sBAAsB,CAAC;QACvE,OAAO;YACH,qDAAqD;YACrD,8BAA8B,WAAW,aAAa;SACzD,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrB,CAAC;IAED,yCAAyC;IACzC,OAAO,+DAA+D,CAAC;AAC3E,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moriajs/core",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "type": "module",
   "description": "MoriaJS framework core — Fastify server, Vite integration, and routing",
   "main": "./dist/index.js",
@@ -18,13 +18,19 @@
     "@fastify/compress": "^8.0.0",
     "@fastify/static": "^9.0.0",
     "@fastify/helmet": "^13.0.0",
-    "pino-pretty": "^13.0.0"
+    "@fastify/middie": "^9.0.0",
+    "pino-pretty": "^13.0.0",
+    "vite": "^6.0.0",
+    "glob": "^11.0.0"
   },
   "devDependencies": {
     "typescript": "^5.7.0",
     "rimraf": "^6.0.0",
     "@types/node": "^22.0.0"
   },
+  "peerDependencies": {
+    "@moriajs/renderer": "0.3.0"
+  },
   "license": "MIT",
   "author": "Guntur-D <guntur.d.npm@gmail.com>",
   "repository": {

package/src/app.ts

@@ -3,8 +3,13 @@ import cors from '@fastify/cors';
 import cookie from '@fastify/cookie';
 import compress from '@fastify/compress';
 import helmet from '@fastify/helmet';
+import path from 'node:path';
+import fs from 'node:fs';
 import { type MoriaConfig } from './config.js';
 import { type MoriaPlugin } from './plugins.js';
+import { createViteDevMiddleware, serveProductionAssets } from './vite.js';
+import { registerRoutes } from './router.js';
+import type { ViteDevServer } from 'vite';
 
 /**
  * Options for creating a MoriaJS application.
@@ -23,6 +28,8 @@ export interface MoriaAppOptions {
 export interface MoriaApp {
     /** The underlying Fastify instance */
     server: FastifyInstance;
+    /** The Vite dev server (only in development mode) */
+    vite?: ViteDevServer;
     /** Register a MoriaJS plugin */
     use: (plugin: MoriaPlugin) => Promise<void>;
     /** Start the server */
@@ -38,12 +45,14 @@ export interface MoriaApp {
  * ```ts
  * import { createApp } from '@moriajs/core';
  *
- * const app = await createApp();
+ * const app = await createApp({ config: { mode: 'development' } });
  * await app.listen({ port: 3000 });
  * ```
  */
 export async function createApp(options: MoriaAppOptions = {}): Promise<MoriaApp> {
     const config = options.config ?? {};
+    const mode = config.mode ?? (process.env.NODE_ENV === 'production' ? 'production' : 'development');
+    const rootDir = config.rootDir ?? process.cwd();
     const port = config.server?.port ?? 3000;
     const host = config.server?.host ?? '0.0.0.0';
 
@@ -52,7 +61,7 @@ export async function createApp(options: MoriaAppOptions = {}): Promise<MoriaApp
         logger: {
             level: config.server?.logLevel ?? 'info',
             transport:
-                process.env.NODE_ENV !== 'production'
+                mode !== 'production'
                     ? { target: 'pino-pretty', options: { colorize: true } }
                     : undefined,
         },
@@ -69,17 +78,41 @@ export async function createApp(options: MoriaAppOptions = {}): Promise<MoriaApp
     await server.register(compress);
     await server.register(helmet, {
         // Relax CSP in development for Vite HMR
-        contentSecurityPolicy: process.env.NODE_ENV === 'production',
+        contentSecurityPolicy: mode === 'production',
     });
 
+    // ─── Global Middleware ─────────────────────────────────────
+    if (config.middleware && config.middleware.length > 0) {
+        for (const mw of config.middleware) {
+            server.addHook('onRequest', mw);
+        }
+        server.log.info(`Registered ${config.middleware.length} global middleware(s)`);
+    }
+
     // Health check route
     server.get('/health', async () => ({ status: 'ok', timestamp: new Date().toISOString() }));
 
+    // ─── Vite Integration ────────────────────────────────────
+    let vite: ViteDevServer | undefined;
+
+    if (mode === 'development') {
+        vite = await createViteDevMiddleware(server, { ...config, rootDir });
+    } else {
+        await serveProductionAssets(server, { ...config, rootDir });
+    }
+
+    // ─── File-Based Routing ──────────────────────────────────
+    const routesDir = path.resolve(rootDir, config.routes?.dir ?? 'src/routes');
+    if (fs.existsSync(routesDir)) {
+        await registerRoutes(server, routesDir, { mode, config });
+    }
+
     // Plugin registry
     const plugins: MoriaPlugin[] = [];
 
     const app: MoriaApp = {
         server,
+        vite,
 
         async use(plugin: MoriaPlugin) {
             plugins.push(plugin);

package/src/config.ts

@@ -3,6 +3,12 @@
  * Used in `moria.config.ts` files in user projects.
  */
 export interface MoriaConfig {
+    /** Application mode */
+    mode?: 'development' | 'production';
+
+    /** Project root directory (auto-detected if not set) */
+    rootDir?: string;
+
     /** Server configuration */
     server?: {
         /** Port to listen on (default: 3000) */
@@ -44,7 +50,18 @@ export interface MoriaConfig {
     vite?: {
         /** Path to Vite config file */
         configFile?: string;
+        /** Client entry point (default: '/src/entry-client.ts') */
+        clientEntry?: string;
     };
+
+    /** File-based routing configuration */
+    routes?: {
+        /** Routes directory relative to rootDir (default: 'src/routes') */
+        dir?: string;
+    };
+
+    /** Global middleware (runs on every request) */
+    middleware?: Array<import('./middleware.js').MoriaMiddleware>;
 }
 
 /**

package/src/index.ts

@@ -2,13 +2,19 @@
  * @moriajs/core
  *
  * Framework core: Fastify server factory with sensible defaults,
- * plugin registration, and configuration system.
+ * plugin registration, Vite integration, file-based routing,
+ * and middleware system.
  */
 
 export { createApp } from './app.js';
 export { defineConfig } from './config.js';
 export { defineMoriaPlugin } from './plugins.js';
+export { defineMiddleware } from './middleware.js';
+export { createViteDevMiddleware, serveProductionAssets, getHtmlScripts } from './vite.js';
+export { scanRoutes, registerRoutes, filePathToUrlPath } from './router.js';
 
 export type { MoriaApp, MoriaAppOptions } from './app.js';
 export type { MoriaConfig } from './config.js';
 export type { MoriaPlugin, MoriaPluginContext } from './plugins.js';
+export type { MoriaMiddleware, MiddlewareEntry } from './middleware.js';
+export type { RouteEntry, RouteHandler } from './router.js';

package/src/middleware.ts

@@ -0,0 +1,159 @@
+/**
+ * MoriaJS Middleware System
+ *
+ * Provides file-based middleware via `_middleware.ts` files and
+ * a `defineMiddleware` helper for type-safe middleware definition.
+ *
+ * Middleware files are scoped to sibling and child routes:
+ *   src/routes/_middleware.ts         → applies to ALL routes
+ *   src/routes/api/_middleware.ts     → applies to /api/* routes
+ *   src/routes/pages/_middleware.ts   → applies to page routes
+ *
+ * Middleware functions run as Fastify preHandler hooks in order:
+ *   root → parent → child (outermost first)
+ */
+
+import type { FastifyRequest, FastifyReply } from 'fastify';
+import { glob } from 'glob';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+
+/**
+ * A MoriaJS middleware function.
+ *
+ * - Return nothing to continue to the next middleware / handler
+ * - Call `reply.send()` or return a value to short-circuit
+ */
+export type MoriaMiddleware = (
+    request: FastifyRequest,
+    reply: FastifyReply
+) => void | Promise<void>;
+
+/**
+ * A resolved middleware entry from a `_middleware.ts` file.
+ */
+export interface MiddlewareEntry {
+    /** Directory path relative to routes dir (e.g., '', 'api', 'api/admin') */
+    scope: string;
+    /** URL prefix this middleware applies to */
+    urlPrefix: string;
+    /** Ordered array of middleware functions */
+    handlers: MoriaMiddleware[];
+}
+
+/**
+ * Define a type-safe middleware function.
+ *
+ * @example
+ * ```ts
+ * import { defineMiddleware } from '@moriajs/core';
+ *
+ * export default defineMiddleware(async (request, reply) => {
+ *     request.log.info('request received');
+ * });
+ * ```
+ */
+export function defineMiddleware(fn: MoriaMiddleware): MoriaMiddleware {
+    return fn;
+}
+
+/**
+ * Scan a routes directory for `_middleware.ts` files and return
+ * resolved middleware entries, sorted from root → deepest.
+ */
+export async function scanMiddleware(routesDir: string): Promise<MiddlewareEntry[]> {
+    const pattern = '**/_middleware.{ts,js,mts,mjs}';
+    const files = await glob(pattern, {
+        cwd: routesDir,
+        posix: true,
+    });
+
+    const entries: MiddlewareEntry[] = [];
+
+    for (const file of files) {
+        const dir = path.posix.dirname(file); // e.g., '.', 'api', 'pages/admin'
+        const scope = dir === '.' ? '' : dir;
+
+        // Build URL prefix from scope
+        let urlPrefix = '/';
+        if (scope) {
+            // pages/ prefix is stripped in route URLs
+            let adjustedScope = scope;
+            if (adjustedScope.startsWith('pages')) {
+                adjustedScope = adjustedScope.slice(5); // remove 'pages'
+            }
+            if (adjustedScope && !adjustedScope.startsWith('/')) {
+                adjustedScope = '/' + adjustedScope;
+            }
+            urlPrefix = adjustedScope || '/';
+        }
+
+        const absolutePath = path.resolve(routesDir, file);
+        const fileUrl = pathToFileURL(absolutePath).href;
+
+        let mod: Record<string, unknown>;
+        try {
+            mod = await import(fileUrl);
+        } catch (err) {
+            console.warn(`[moria] Failed to load middleware: ${file}`, err);
+            continue;
+        }
+
+        // Resolve handlers from default export
+        const exported = mod.default;
+        let handlers: MoriaMiddleware[] = [];
+
+        if (Array.isArray(exported)) {
+            handlers = exported.filter((fn) => typeof fn === 'function') as MoriaMiddleware[];
+        } else if (typeof exported === 'function') {
+            handlers = [exported as MoriaMiddleware];
+        }
+
+        if (handlers.length === 0) {
+            console.warn(`[moria] Middleware file has no handlers: ${file}`);
+            continue;
+        }
+
+        entries.push({ scope, urlPrefix, handlers });
+    }
+
+    // Sort by scope depth (root first, deeper scopes later)
+    entries.sort((a, b) => {
+        const depthA = a.scope === '' ? 0 : a.scope.split('/').length;
+        const depthB = b.scope === '' ? 0 : b.scope.split('/').length;
+        return depthA - depthB;
+    });
+
+    return entries;
+}
+
+/**
+ * Get the ordered middleware chain for a given route URL path.
+ *
+ * Returns middleware from outermost (root) to innermost (closest parent).
+ *
+ * @param routeFilePath - File path relative to routes dir (e.g., 'api/hello.ts')
+ * @param entries       - Scanned middleware entries
+ */
+export function getMiddlewareChain(
+    routeFilePath: string,
+    entries: MiddlewareEntry[]
+): MoriaMiddleware[] {
+    const routeDir = path.posix.dirname(routeFilePath);
+    const chain: MoriaMiddleware[] = [];
+
+    for (const entry of entries) {
+        // Root middleware (scope '') applies to everything
+        if (entry.scope === '') {
+            chain.push(...entry.handlers);
+            continue;
+        }
+
+        // Check if the route file is within this middleware's scope
+        if (routeDir === entry.scope || routeDir.startsWith(entry.scope + '/')) {
+            chain.push(...entry.handlers);
+        }
+    }
+
+    return chain;
+}