@xacos/server 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { XServer } from "./XServer";
+export { adaptRequest, adaptResponse } from "./adapters/RequestAdapter";
+export { mountApiRoutes } from "./routing/mountApiRoutes";
+export { mountViteDev } from "./dev/mountVite";
+export { mountViewRoutes } from "./views/mountViewRoutes";
+export { serveStaticChunks } from "./static/serveStaticChunks";
+export { buildHtmlShell, type HtmlShellOptions } from "./views/buildHtmlShell";
+export { Logger, log } from "./Logger";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/E,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export { XServer } from "./XServer";
+export { adaptRequest, adaptResponse } from "./adapters/RequestAdapter";
+export { mountApiRoutes } from "./routing/mountApiRoutes";
+export { mountViteDev } from "./dev/mountVite";
+export { mountViewRoutes } from "./views/mountViewRoutes";
+export { serveStaticChunks } from "./static/serveStaticChunks";
+export { buildHtmlShell } from "./views/buildHtmlShell";
+export { Logger, log } from "./Logger";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAyB,MAAM,wBAAwB,CAAC;AAC/E,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC"}

package/dist/routing/mountApiRoutes.d.ts

@@ -0,0 +1,4 @@
+import type { FastifyInstance } from "fastify";
+import type { XApp } from "@xacos/shared";
+export declare function mountApiRoutes(fastify: FastifyInstance, apiDir: string, app: XApp): Promise<void>;
+//# sourceMappingURL=mountApiRoutes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mountApiRoutes.d.ts","sourceRoot":"","sources":["../../src/routing/mountApiRoutes.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAgB1C,wBAAsB,cAAc,CAClC,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,IAAI,GACR,OAAO,CAAC,IAAI,CAAC,CA+Hf"}

package/dist/routing/mountApiRoutes.js

@@ -0,0 +1,136 @@
+import { pathToFileURL } from "node:url";
+import { resolve } from "node:path";
+import { scanApiFiles, compose, invalidateScanCache } from "@xacos/core";
+import { adaptRequest, adaptResponse } from "../adapters/RequestAdapter";
+import { validate, ValidationError } from "@xacos/validation";
+import { log } from "../Logger";
+// WeakMap scoping route registries per Fastify instance
+const serverRoutesRegistry = new WeakMap();
+// Track if chokidar watcher is already initialized for this fastify instance
+const activeWatchers = new WeakSet();
+export async function mountApiRoutes(fastify, apiDir, app) {
+    let activeRoutesRegistry = serverRoutesRegistry.get(fastify);
+    if (!activeRoutesRegistry) {
+        activeRoutesRegistry = new Map();
+        serverRoutesRegistry.set(fastify, activeRoutesRegistry);
+    }
+    invalidateScanCache();
+    const files = scanApiFiles(apiDir);
+    for (const { filePath, urlPrefix } of files) {
+        try {
+            const mod = await import(pathToFileURL(filePath).href);
+            const router = mod?.router;
+            if (!router)
+                continue;
+            for (const route of router.routes) {
+                const routePath = route.path === "/" ? "" : route.path;
+                const fullPath = `${urlPrefix}${routePath}`.replace(/\/+/g, "/");
+                const pipeline = route.middlewares && route.middlewares.length ? compose(route.middlewares) : null;
+                const routeKey = `${route.method}:${fullPath}`;
+                if (activeRoutesRegistry.has(routeKey)) {
+                    activeRoutesRegistry.set(routeKey, { route, pipeline });
+                }
+                else {
+                    activeRoutesRegistry.set(routeKey, { route, pipeline });
+                    fastify.route({
+                        method: route.method,
+                        url: fullPath,
+                        handler: async (request, reply) => {
+                            // Ensure we retrieve from the instance-scoped registry at request time
+                            const registry = serverRoutesRegistry.get(fastify);
+                            const meta = registry?.get(routeKey);
+                            if (!meta) {
+                                void reply.code(404);
+                                return { error: "Route not found" };
+                            }
+                            const currentRoute = meta.route;
+                            const currentPipeline = meta.pipeline;
+                            const req = adaptRequest(request, app);
+                            const res = adaptResponse(reply);
+                            try {
+                                if (currentRoute.schema) {
+                                    if (currentRoute.schema.body)
+                                        validate(req.body, currentRoute.schema.body);
+                                    if (currentRoute.schema.query)
+                                        validate(req.query, currentRoute.schema.query);
+                                    if (currentRoute.schema.params)
+                                        validate(req.params, currentRoute.schema.params);
+                                }
+                                if (currentPipeline) {
+                                    await currentPipeline(req, res);
+                                }
+                                await currentRoute.handler(req, res);
+                                if (res._payload !== undefined) {
+                                    return res._payload;
+                                }
+                            }
+                            catch (e) {
+                                if (e instanceof ValidationError) {
+                                    void reply.code(e.statusCode);
+                                    return { errors: e.errors };
+                                }
+                                throw e;
+                            }
+                        },
+                    });
+                }
+            }
+        }
+        catch (err) {
+            console.error("IMPORT ERROR:", err);
+            log.error(`Failed to mount API file ${filePath}: ${err.message}`);
+        }
+    }
+    if (process.env["APP_ENV"] !== "production" && !activeWatchers.has(fastify)) {
+        activeWatchers.add(fastify);
+        try {
+            const chokidar = await import("chokidar");
+            const watcher = chokidar.watch([apiDir, resolve(apiDir, "../app")], {
+                ignoreInitial: true,
+            });
+            fastify.addHook("onClose", async () => {
+                await watcher.close();
+                activeWatchers.delete(fastify);
+            });
+            watcher.on("all", (event, path) => {
+                log.info(`[HMR] Detected change in ${path} (${event})`);
+                void (async () => {
+                    try {
+                        const registry = serverRoutesRegistry.get(fastify);
+                        if (!registry)
+                            return;
+                        invalidateScanCache();
+                        const updatedFiles = scanApiFiles(apiDir);
+                        for (const { filePath, urlPrefix } of updatedFiles) {
+                            const mod = await import(pathToFileURL(filePath).href + "?t=" + Date.now());
+                            const router = mod?.router;
+                            if (!router)
+                                continue;
+                            for (const route of router.routes) {
+                                const routePath = route.path === "/" ? "" : route.path;
+                                const fullPath = `${urlPrefix}${routePath}`.replace(/\/+/g, "/");
+                                const pipeline = route.middlewares && route.middlewares.length ? compose(route.middlewares) : null;
+                                const routeKey = `${route.method}:${fullPath}`;
+                                if (registry.has(routeKey)) {
+                                    registry.set(routeKey, { route, pipeline });
+                                    log.info(`[HMR] Hot-swapped route ${route.method} ${fullPath}`);
+                                }
+                                else {
+                                    registry.set(routeKey, { route, pipeline });
+                                    log.info(`[HMR] Registered new route ${route.method} ${fullPath}`);
+                                }
+                            }
+                        }
+                    }
+                    catch (err) {
+                        log.error(`[HMR] Failed to hot-reload routes: ${err.message}`);
+                    }
+                })();
+            });
+        }
+        catch (err) {
+            log.error(`[HMR] Failed to initialize chokidar: ${err.message}`);
+        }
+    }
+}
+//# sourceMappingURL=mountApiRoutes.js.map

package/dist/routing/mountApiRoutes.js.map

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

package/dist/static/serveStaticChunks.d.ts

@@ -0,0 +1,7 @@
+import type { FastifyInstance } from 'fastify';
+/**
+ * Serves production view bundles generated by esbuild.
+ * Chunks are served under the /__xacos/ prefix.
+ */
+export declare function serveStaticChunks(fastify: FastifyInstance, chunksDir: string): Promise<void>;
+//# sourceMappingURL=serveStaticChunks.d.ts.map

package/dist/static/serveStaticChunks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serveStaticChunks.d.ts","sourceRoot":"","sources":["../../src/static/serveStaticChunks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG/C;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CASf"}

package/dist/static/serveStaticChunks.js

@@ -0,0 +1,15 @@
+import { resolve } from 'path';
+/**
+ * Serves production view bundles generated by esbuild.
+ * Chunks are served under the /__xacos/ prefix.
+ */
+export async function serveStaticChunks(fastify, chunksDir) {
+    // @ts-ignore - Dynamic import of @fastify/static
+    const fastifyStatic = (await import('@fastify/static')).default;
+    await fastify.register(fastifyStatic, {
+        root: resolve(chunksDir),
+        prefix: '/__xacos/',
+        decorateReply: false, // Avoid collision if already registered
+    });
+}
+//# sourceMappingURL=serveStaticChunks.js.map

package/dist/static/serveStaticChunks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serveStaticChunks.js","sourceRoot":"","sources":["../../src/static/serveStaticChunks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAwB,EACxB,SAAiB;IAEjB,iDAAiD;IACjD,MAAM,aAAa,GAAG,CAAC,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAC;IAEhE,MAAM,OAAO,CAAC,QAAQ,CAAC,aAAa,EAAE;QACpC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC;QACxB,MAAM,EAAE,WAAW;QACnB,aAAa,EAAE,KAAK,EAAE,wCAAwC;KAC/D,CAAC,CAAC;AACL,CAAC"}

package/dist/views/buildHtmlShell.d.ts

@@ -0,0 +1,14 @@
+export interface HtmlShellOptions {
+    chunkUrl: string;
+    ssrHtml?: string;
+    meta?: {
+        title?: string | undefined;
+        description?: string | undefined;
+    };
+}
+/**
+ * Generate a complete HTML shell for a page.
+ * Wires the page-specific JS chunk into the <script> tag.
+ */
+export declare function buildHtmlShell(options: HtmlShellOptions): string;
+//# sourceMappingURL=buildHtmlShell.d.ts.map

package/dist/views/buildHtmlShell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildHtmlShell.d.ts","sourceRoot":"","sources":["../../src/views/buildHtmlShell.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE;QACL,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC3B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAClC,CAAC;CACH;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAoBhE"}

package/dist/views/buildHtmlShell.js

@@ -0,0 +1,24 @@
+/**
+ * Generate a complete HTML shell for a page.
+ * Wires the page-specific JS chunk into the <script> tag.
+ */
+export function buildHtmlShell(options) {
+    const { chunkUrl, ssrHtml = '', meta = {} } = options;
+    const headTags = [
+        `<title>${meta.title ?? 'XAOCS App'}</title>`,
+        meta.description ? `<meta name="description" content="${meta.description}" />` : '',
+        `<script type="module" src="${chunkUrl}"></script>`,
+    ].filter(Boolean).join('\n    ');
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  ${headTags}
+</head>
+<body>
+  <div id="root">${ssrHtml}</div>
+</body>
+</html>`;
+}
+//# sourceMappingURL=buildHtmlShell.js.map

package/dist/views/buildHtmlShell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildHtmlShell.js","sourceRoot":"","sources":["../../src/views/buildHtmlShell.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,OAAyB;IACtD,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,EAAE,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAEtD,MAAM,QAAQ,GAAG;QACf,UAAU,IAAI,CAAC,KAAK,IAAI,WAAW,UAAU;QAC7C,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,qCAAqC,IAAI,CAAC,WAAW,MAAM,CAAC,CAAC,CAAC,EAAE;QACnF,8BAA8B,QAAQ,aAAa;KACpD,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEjC,OAAO;;;;;IAKL,QAAQ;;;mBAGO,OAAO;;QAElB,CAAC;AACT,CAAC"}

package/dist/views/buildHtmlShell.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=buildHtmlShell.test.d.ts.map

package/dist/views/buildHtmlShell.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildHtmlShell.test.d.ts","sourceRoot":"","sources":["../../src/views/buildHtmlShell.test.ts"],"names":[],"mappings":""}

package/dist/views/buildHtmlShell.test.js

@@ -0,0 +1,22 @@
+import { describe, it, expect } from 'bun:test';
+import { buildHtmlShell } from './buildHtmlShell';
+describe('buildHtmlShell', () => {
+    it('injects chunk URL and meta tags', () => {
+        const html = buildHtmlShell({
+            chunkUrl: '/__xacos/home.js',
+            meta: { title: 'Home', description: 'Testing' }
+        });
+        expect(html).toContain('<title>Home</title>');
+        expect(html).toContain('description" content="Testing"');
+        expect(html).toContain('src="/__xacos/home.js"');
+        expect(html).toContain('<div id="root"></div>');
+    });
+    it('injects SSR HTML into root div', () => {
+        const html = buildHtmlShell({
+            chunkUrl: '/__xacos/home.js',
+            ssrHtml: '<h1>SSR Content</h1>'
+        });
+        expect(html).toContain('<div id="root"><h1>SSR Content</h1></div>');
+    });
+});
+//# sourceMappingURL=buildHtmlShell.test.js.map

package/dist/views/buildHtmlShell.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildHtmlShell.test.js","sourceRoot":"","sources":["../../src/views/buildHtmlShell.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,IAAI,GAAG,cAAc,CAAC;YAC1B,QAAQ,EAAE,kBAAkB;YAC5B,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE;SAChD,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAAC;QAC9C,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,gCAAgC,CAAC,CAAC;QACzD,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC;QACjD,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,IAAI,GAAG,cAAc,CAAC;YAC1B,QAAQ,EAAE,kBAAkB;YAC5B,OAAO,EAAE,sBAAsB;SAChC,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,2CAA2C,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/views/mountViewRoutes.d.ts

@@ -0,0 +1,7 @@
+import type { FastifyInstance } from 'fastify';
+/**
+ * Scans views and mounts GET routes for each page.
+ * Each route serves the production HTML shell with hydrated chunks.
+ */
+export declare function mountViewRoutes(fastify: FastifyInstance, viewsDir: string): Promise<void>;
+//# sourceMappingURL=mountViewRoutes.d.ts.map

package/dist/views/mountViewRoutes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mountViewRoutes.d.ts","sourceRoot":"","sources":["../../src/views/mountViewRoutes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAK/C;;;GAGG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAoBf"}

package/dist/views/mountViewRoutes.js

@@ -0,0 +1,25 @@
+import { scanViews, extractPageMeta } from '@xacos/compiler';
+import { buildHtmlShell } from './buildHtmlShell';
+/**
+ * Scans views and mounts GET routes for each page.
+ * Each route serves the production HTML shell with hydrated chunks.
+ */
+export async function mountViewRoutes(fastify, viewsDir) {
+    const views = scanViews(viewsDir);
+    for (const view of views) {
+        // Import view to extract meta (Bun handles TS)
+        const mod = await import(view.filePath);
+        const meta = extractPageMeta(mod);
+        fastify.get(view.urlPattern, async (_request, reply) => {
+            const html = buildHtmlShell({
+                chunkUrl: `/__xacos/${view.chunkName}.js`,
+                meta: {
+                    title: meta.title,
+                    description: meta.description,
+                },
+            });
+            return reply.type('text/html').send(html);
+        });
+    }
+}
+//# sourceMappingURL=mountViewRoutes.js.map

package/dist/views/mountViewRoutes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mountViewRoutes.js","sourceRoot":"","sources":["../../src/views/mountViewRoutes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAwB,EACxB,QAAgB;IAEhB,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,+CAA+C;QAC/C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;QAElC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE;YACrD,MAAM,IAAI,GAAG,cAAc,CAAC;gBAC1B,QAAQ,EAAE,YAAY,IAAI,CAAC,SAAS,KAAK;gBACzC,IAAI,EAAE;oBACJ,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,WAAW,EAAE,IAAI,CAAC,WAAW;iBAC9B;aACF,CAAC,CAAC;YAEH,OAAO,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@xacos/server",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@fastify/cookie": "^9.0.0",
+    "@fastify/cors": "9",
+    "@fastify/formbody": "7",
+    "@fastify/multipart": "^10.0.0",
+    "@fastify/rate-limit": "9",
+    "@xacos/compiler": "workspace:*",
+    "@xacos/config": "workspace:*",
+    "@xacos/core": "workspace:*",
+    "@xacos/orm": "workspace:*",
+    "@xacos/shared": "workspace:*",
+    "@xacos/validation": "workspace:*",
+    "chokidar": "^4.0.1",
+    "fastify": "^4.28.1",
+    "pino": "^10.3.1",
+    "pino-pretty": "^13.1.3",
+    "vite": "^5.x",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.3",
+    "bun-types": "^1.3.12"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "bun test src",
+    "type-check": "tsc --noEmit"
+  },
+  "license": "MIT",
+  "author": "XAOCS Team",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zoherr/xaocs.git",
+    "directory": "packages/server"
+  },
+  "homepage": "https://xaocs.dev",
+  "bugs": {
+    "url": "https://github.com/zoherr/xaocs/issues"
+  },
+  "keywords": [
+    "xaocs",
+    "xacos",
+    "framework",
+    "typescript",
+    "fullstack",
+    "fastify",
+    "react"
+  ],
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org",
+    "provenance": false
+  },
+  "engines": {
+    "bun": ">=1.0.0",
+    "node": ">=18.0.0"
+  }
+}

package/src/Logger.ts

@@ -0,0 +1,45 @@
+import pino from 'pino';
+
+export class Logger {
+  private logger: pino.Logger;
+
+  constructor() {
+    const isDev = process.env["APP_ENV"] !== "production";
+    this.logger = pino({
+      level: process.env["APP_DEBUG"] === "true" || isDev ? "debug" : "info",
+      transport: isDev
+        ? {
+            target: "pino-pretty",
+            options: {
+              translateTime: "HH:MM:ss Z",
+              ignore: "pid,hostname",
+            },
+          }
+        : undefined,
+    } as any);
+
+  }
+
+  info(message: string, ...args: any[]) {
+    this.logger.info(message, ...args);
+  }
+
+  error(message: string, ...args: any[]) {
+    this.logger.error(message, ...args);
+  }
+
+  warn(message: string, ...args: any[]) {
+    this.logger.warn(message, ...args);
+  }
+
+  debug(message: string, ...args: any[]) {
+    this.logger.debug(message, ...args);
+  }
+
+  fatal(message: string, ...args: any[]) {
+    this.logger.fatal(message, ...args);
+  }
+}
+
+export const log = new Logger();
+

package/src/XServer.test.ts

@@ -0,0 +1,83 @@
+import { describe, expect, it } from "bun:test";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { XServer } from "./XServer";
+
+describe("XServer", () => {
+  it("registers global middleware", () => {
+    const server = new XServer();
+
+    server.useGlobal(async (_req, _res, next) => {
+      await next();
+    });
+
+    expect(server.getGlobalMiddlewares().length).toBe(1);
+  });
+
+  it("mountApi registers scanned routes", async () => {
+    const apiDir = join(fileURLToPath(new URL(".", import.meta.url)), "..", "test-fixtures", "api");
+    const app = { make: <T>(_key: string) => ({}) as T };
+
+    const server = new XServer();
+    const port = 18_900 + Math.floor(Math.random() * 500);
+    try {
+      await server.mountApi(apiDir, app);
+      await server.listen(port);
+      const res = await fetch(`http://127.0.0.1:${String(port)}/api/echo/`);
+      expect(res.ok).toBe(true);
+      const body = (await res.json()) as { ok?: boolean };
+      expect(body.ok).toBe(true);
+    } finally {
+      await server.close();
+    }
+  });
+
+  it("returns 422 JSON for route schema validation failures", async () => {
+    const apiDir = join(fileURLToPath(new URL(".", import.meta.url)), "..", "test-fixtures", "api");
+    const app = { make: <T>(_key: string) => ({}) as T };
+
+    const server = new XServer();
+    const port = 19_050 + Math.floor(Math.random() * 500);
+    try {
+      await server.mountApi(apiDir, app);
+      await server.listen(port);
+
+      const bad = await fetch(`http://127.0.0.1:${String(port)}/api/validated/`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ name: "x" }),
+      });
+      expect(bad.status).toBe(422);
+      const payload = (await bad.json()) as { errors?: { field: string; message: string }[] };
+      expect(Array.isArray(payload.errors)).toBe(true);
+
+      const good = await fetch(`http://127.0.0.1:${String(port)}/api/validated/`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ name: "Ada" }),
+      });
+      expect(good.ok).toBe(true);
+      const okBody = (await good.json()) as { name?: string };
+      expect(okBody.name).toBe("Ada");
+    } finally {
+      await server.close();
+    }
+  });
+
+  it("provides a health check endpoint", async () => {
+    const server = new XServer();
+    const port = 19_200 + Math.floor(Math.random() * 500);
+    try {
+      await server.listen(port);
+      const res = await fetch(`http://127.0.0.1:${String(port)}/health`);
+      expect(res.ok).toBe(true);
+      const body = (await res.json()) as { status?: string; version?: string; env?: string };
+      expect(body.status).toBe("ok");
+      expect(body.version).toBeDefined();
+      expect(body.env).toBeDefined();
+    } finally {
+      await server.close();
+    }
+  });
+});
+