@xacos/server 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 XAOCS Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,17 @@
+# @xacos/server
+
+> Part of the [XAOCS Framework](https://xaocs.dev) — full-stack TypeScript, built for AI-native development.
+
+## Install
+
+```bash
+bun add @xacos/server
+```
+
+## Docs
+
+Full documentation at [xaocs.dev/docs/server](https://xaocs.dev/docs/server).
+
+## License
+
+MIT © XAOCS Team

package/dist/Logger.d.ts

@@ -0,0 +1,11 @@
+export declare class Logger {
+    private logger;
+    constructor();
+    info(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    debug(message: string, ...args: any[]): void;
+    fatal(message: string, ...args: any[]): void;
+}
+export declare const log: Logger;
+//# sourceMappingURL=Logger.d.ts.map

package/dist/Logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../src/Logger.ts"],"names":[],"mappings":"AAEA,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAc;;IAmB5B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE;IAIpC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE;IAIrC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE;IAIpC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE;IAIrC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE;CAGtC;AAED,eAAO,MAAM,GAAG,QAAe,CAAC"}

package/dist/Logger.js

@@ -0,0 +1,36 @@
+import pino from 'pino';
+export class Logger {
+    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,
+        });
+    }
+    info(message, ...args) {
+        this.logger.info(message, ...args);
+    }
+    error(message, ...args) {
+        this.logger.error(message, ...args);
+    }
+    warn(message, ...args) {
+        this.logger.warn(message, ...args);
+    }
+    debug(message, ...args) {
+        this.logger.debug(message, ...args);
+    }
+    fatal(message, ...args) {
+        this.logger.fatal(message, ...args);
+    }
+}
+export const log = new Logger();
+//# sourceMappingURL=Logger.js.map

package/dist/Logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.js","sourceRoot":"","sources":["../src/Logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,OAAO,MAAM;IACT,MAAM,CAAc;IAE5B;QACE,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,YAAY,CAAC;QACtD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACjB,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;YACtE,SAAS,EAAE,KAAK;gBACd,CAAC,CAAC;oBACE,MAAM,EAAE,aAAa;oBACrB,OAAO,EAAE;wBACP,aAAa,EAAE,YAAY;wBAC3B,MAAM,EAAE,cAAc;qBACvB;iBACF;gBACH,CAAC,CAAC,SAAS;SACP,CAAC,CAAC;IAEZ,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAW;QAClC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAW;QACnC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAW;QAClC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAW;QACnC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAW;QACnC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACtC,CAAC;CACF;AAED,MAAM,CAAC,MAAM,GAAG,GAAG,IAAI,MAAM,EAAE,CAAC"}

package/dist/XServer.d.ts

@@ -0,0 +1,20 @@
+import { FastifyInstance } from "fastify";
+import type { XApp, XMiddleware } from "@xacos/shared";
+import type { XacosConfig } from "@xacos/config";
+export declare class XServer {
+    readonly fastify: FastifyInstance;
+    private readonly globalMiddlewares;
+    constructor();
+    private setupHealthCheck;
+    bootstrap(config: XacosConfig): Promise<void>;
+    private setupErrorHandler;
+    useGlobal(middleware: XMiddleware): void;
+    getGlobalMiddlewares(): readonly XMiddleware[];
+    /**
+     * Scan `apiDir` for `*.api.ts` modules and register routes on this Fastify instance.
+     */
+    mountApi(apiDir: string, app: XApp): Promise<void>;
+    listen(port: number): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=XServer.d.ts.map

package/dist/XServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"XServer.d.ts","sourceRoot":"","sources":["../src/XServer.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAQvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAOjD,qBAAa,OAAO;IAClB,SAAgB,OAAO,EAAE,eAAe,CAAC;IACzC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAqB;;IA8CvD,OAAO,CAAC,gBAAgB;IAYlB,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAenD,OAAO,CAAC,iBAAiB;IAsCzB,SAAS,CAAC,UAAU,EAAE,WAAW,GAAG,IAAI;IAIxC,oBAAoB,IAAI,SAAS,WAAW,EAAE;IAI9C;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/XServer.js

@@ -0,0 +1,155 @@
+import Fastify from "fastify";
+import { mountApiRoutes } from "./routing/mountApiRoutes";
+import cookie from "@fastify/cookie";
+import multipart from "@fastify/multipart";
+import formbody from "@fastify/formbody";
+import cors from "@fastify/cors";
+import rateLimit from "@fastify/rate-limit";
+import { log } from "./Logger";
+import { closeDb } from "@xacos/orm";
+import pkg from "../package.json";
+let shutdownRegistered = false;
+export class XServer {
+    fastify;
+    globalMiddlewares = [];
+    constructor() {
+        const isDev = process.env["APP_ENV"] !== "production";
+        this.fastify = Fastify({
+            bodyLimit: 10 * 1024 * 1024, // 10MB max body size
+            logger: {
+                level: process.env["APP_DEBUG"] === "true" || isDev ? "debug" : "info",
+                transport: isDev
+                    ? {
+                        target: "pino-pretty",
+                        options: {
+                            translateTime: "HH:MM:ss Z",
+                            ignore: "pid,hostname",
+                        },
+                    }
+                    : undefined,
+            },
+        });
+        this.fastify.addHook('onSend', async (_request, reply) => {
+            reply.header('X-Content-Type-Options', 'nosniff');
+            reply.header('X-Frame-Options', 'SAMEORIGIN');
+            reply.header('X-XSS-Protection', '1; mode=block');
+            reply.header('Referrer-Policy', 'strict-origin-when-cross-origin');
+            if (process.env['APP_ENV'] === 'production') {
+                reply.header('Strict-Transport-Security', 'max-age=31536000; includeSubDomains');
+            }
+        });
+        void this.fastify.register(cookie);
+        void this.fastify.register(formbody);
+        const metaSym = Symbol.for('plugin-meta');
+        if (multipart[metaSym]) {
+            multipart[metaSym].fastify = '4.x';
+        }
+        void this.fastify.register(multipart, {
+            limits: {
+                fileSize: 10 * 1024 * 1024, // 10MB default
+            },
+        });
+        this.setupErrorHandler();
+        this.setupHealthCheck();
+    }
+    setupHealthCheck() {
+        this.fastify.get("/health", async (_req, reply) => {
+            return reply.send({
+                status: "ok",
+                uptime: process.uptime(),
+                memory: process.memoryUsage(),
+                version: pkg.version,
+                env: process.env["APP_ENV"] ?? "development",
+            });
+        });
+    }
+    async bootstrap(config) {
+        // ── CORS ────────────────────────────────────────────────────────────────
+        await this.fastify.register(cors, {
+            origin: config.cors?.origin ?? true,
+            credentials: config.cors?.credentials ?? true,
+            methods: config.cors?.methods ?? ["GET", "POST", "PUT", "DELETE", "PATCH"],
+        });
+        // ── Rate Limit ──────────────────────────────────────────────────────────
+        await this.fastify.register(rateLimit, {
+            max: config.rateLimit?.max ?? 100,
+            timeWindow: config.rateLimit?.timeWindow ?? "1 minute",
+        });
+    }
+    setupErrorHandler() {
+        this.fastify.setErrorHandler((error, request, reply) => {
+            const statusCode = error.statusCode ?? 500;
+            const isDev = process.env["APP_ENV"] !== "production";
+            let code = error.code;
+            if (!code) {
+                if (statusCode === 422 || error.name === "ValidationError")
+                    code = "VALIDATION_FAILED";
+                else if (statusCode === 404)
+                    code = "NOT_FOUND";
+                else if (statusCode === 401)
+                    code = "UNAUTHORIZED";
+                else if (statusCode === 403)
+                    code = "FORBIDDEN";
+                else if (statusCode === 400)
+                    code = "BAD_REQUEST";
+                else
+                    code = "INTERNAL_ERROR";
+            }
+            // Structured logging via Pino per error
+            log.error(`[XServer Error] ${error.message}`, {
+                url: request.url,
+                method: request.method,
+                statusCode,
+                code,
+                stack: isDev ? error.stack : undefined,
+            });
+            request.log.error(error);
+            void reply.status(statusCode).send({
+                success: false,
+                error: {
+                    message: error.message || "Internal Server Error",
+                    code,
+                    details: error.details || error.errors,
+                    stack: isDev ? error.stack : undefined,
+                },
+            });
+        });
+    }
+    useGlobal(middleware) {
+        this.globalMiddlewares.push(middleware);
+    }
+    getGlobalMiddlewares() {
+        return [...this.globalMiddlewares];
+    }
+    /**
+     * Scan `apiDir` for `*.api.ts` modules and register routes on this Fastify instance.
+     */
+    async mountApi(apiDir, app) {
+        await mountApiRoutes(this.fastify, apiDir, app);
+    }
+    async listen(port) {
+        await this.fastify.listen({ port, host: "0.0.0.0" });
+        console.log(`\n  XAOCS running at http://localhost:${port}\n`);
+        if (!shutdownRegistered && process.env["APP_ENV"] !== "test") {
+            shutdownRegistered = true;
+            const gracefulShutdown = async (signal) => {
+                log.info(`Received ${signal} — shutting down gracefully...`);
+                try {
+                    await this.close();
+                    await closeDb();
+                    process.exit(0);
+                }
+                catch (err) {
+                    log.error(`Error during graceful shutdown: ${err.message}`);
+                    process.exit(1);
+                }
+            };
+            process.on("SIGTERM", () => void gracefulShutdown("SIGTERM"));
+            process.on("SIGINT", () => void gracefulShutdown("SIGINT"));
+        }
+    }
+    async close() {
+        await this.fastify.close();
+    }
+}
+//# sourceMappingURL=XServer.js.map

package/dist/XServer.js.map

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

package/dist/XServer.test.d.ts

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

package/dist/XServer.test.d.ts.map

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

package/dist/XServer.test.js

@@ -0,0 +1,76 @@
+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: (_key) => ({}) };
+        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());
+            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: (_key) => ({}) };
+        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());
+            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());
+            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());
+            expect(body.status).toBe("ok");
+            expect(body.version).toBeDefined();
+            expect(body.env).toBeDefined();
+        }
+        finally {
+            await server.close();
+        }
+    });
+});
+//# sourceMappingURL=XServer.test.js.map

package/dist/XServer.test.js.map

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

package/dist/adapters/RequestAdapter.d.ts

@@ -0,0 +1,6 @@
+import type { FastifyReply, FastifyRequest } from "fastify";
+import type { XApp, XRequest, XResponse } from "@xacos/shared";
+import "@fastify/multipart";
+export declare function adaptRequest(req: FastifyRequest, app: XApp): XRequest;
+export declare function adaptResponse(reply: FastifyReply): XResponse;
+//# sourceMappingURL=RequestAdapter.d.ts.map

package/dist/adapters/RequestAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/RequestAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,KAAK,EAAiB,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC9E,OAAO,oBAAoB,CAAC;AAG5B,wBAAgB,YAAY,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,IAAI,GAAG,QAAQ,CA6CrE;AAuBD,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,CAiC5D"}

package/dist/adapters/RequestAdapter.js

@@ -0,0 +1,95 @@
+import "@fastify/multipart";
+export function adaptRequest(req, app) {
+    const xReq = {
+        ip: req.ip,
+        params: req.params ?? {},
+        query: req.query ?? {},
+        body: req.body,
+        headers: req.headers,
+        cookies: req.cookies ?? {},
+        app,
+        validate(schema) {
+            const result = schema.safeParse(this.body);
+            if (!result.success) {
+                const error = new Error('Validation failed');
+                error.statusCode = 422;
+                error.code = 'VALIDATION_ERROR';
+                error.details = result.error.flatten().fieldErrors;
+                throw error;
+            }
+            return result.data;
+        },
+        async file(name) {
+            if (!req.isMultipart())
+                return undefined;
+            const fileIter = req.files();
+            for await (const part of fileIter) {
+                if (part.fieldname === name) {
+                    return createXFile(part, app);
+                }
+            }
+            return undefined;
+        },
+        async files(name) {
+            if (!req.isMultipart())
+                return [];
+            const results = [];
+            const fileIter = req.files();
+            for await (const part of fileIter) {
+                if (!name || part.fieldname === name) {
+                    results.push(createXFile(part, app));
+                }
+            }
+            return results;
+        }
+    };
+    return xReq;
+}
+function createXFile(part, app) {
+    return {
+        fieldname: part.fieldname,
+        filename: part.filename,
+        mimetype: part.mimetype,
+        encoding: part.encoding,
+        async getBuffer() {
+            return await part.toBuffer();
+        },
+        async store(path) {
+            const buf = await part.toBuffer();
+            const storage = app.make('storage');
+            await storage.put(path, buf);
+            return path;
+        }
+    };
+}
+export function adaptResponse(reply) {
+    const res = {
+        _payload: undefined,
+        setHeader(name, value) {
+            reply.header(name, value);
+            return res;
+        },
+        json(data) {
+            this._payload = data;
+            return res;
+        },
+        status(code) {
+            reply.code(code);
+            return res;
+        },
+        send(data) {
+            this._payload = data ?? "";
+            return res;
+        },
+        redirect(url) {
+            reply.redirect(url);
+        },
+        setCookie(name, value, opts) {
+            const cookieReply = reply;
+            cookieReply.setCookie?.(name, value, opts);
+            return res;
+        },
+    };
+    return res;
+}
+//# sourceMappingURL=RequestAdapter.js.map

package/dist/adapters/RequestAdapter.js.map

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

package/dist/adapters/RequestAdapter.test.d.ts

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

package/dist/adapters/RequestAdapter.test.d.ts.map

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

package/dist/adapters/RequestAdapter.test.js

@@ -0,0 +1,38 @@
+import { describe, expect, it } from "bun:test";
+import { adaptRequest, adaptResponse } from "./RequestAdapter";
+describe("RequestAdapter", () => {
+    it("adapts request shape", () => {
+        const req = {
+            params: { id: "42" },
+            query: { q: "ok" },
+            body: { x: 1 },
+            headers: { "x-test": "1" },
+        };
+        const app = {
+            make: (_key) => ({}),
+        };
+        const adapted = adaptRequest(req, app);
+        expect(adapted.params["id"]).toBe("42");
+        expect(adapted.query["q"]).toBe("ok");
+    });
+    it("adapts response shape", () => {
+        let statusCode = 200;
+        let payload;
+        const reply = {
+            code(code) {
+                statusCode = code;
+                return this;
+            },
+            send(data) {
+                payload = data;
+                return this;
+            },
+            redirect(_url) { },
+        };
+        const adapted = adaptResponse(reply);
+        adapted.status(201).json({ ok: true });
+        expect(statusCode).toBe(201);
+        expect(adapted._payload).toEqual({ ok: true });
+    });
+});
+//# sourceMappingURL=RequestAdapter.test.js.map

package/dist/adapters/RequestAdapter.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestAdapter.test.js","sourceRoot":"","sources":["../../src/adapters/RequestAdapter.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAE/D,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,GAAG,GAAG;YACV,MAAM,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE;YACpB,KAAK,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE;YAClB,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE;YACd,OAAO,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE;SACE,CAAC;QAE/B,MAAM,GAAG,GAAG;YACV,IAAI,EAAE,CAAI,IAAY,EAAE,EAAE,CAAC,CAAC,EAAE,CAAM;SACrC,CAAC;QAEF,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAEvC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,IAAI,UAAU,GAAG,GAAG,CAAC;QACrB,IAAI,OAAgB,CAAC;QAErB,MAAM,KAAK,GAAG;YACZ,IAAI,CAAC,IAAY;gBACf,UAAU,GAAG,IAAI,CAAC;gBAClB,OAAO,IAAI,CAAC;YACd,CAAC;YACD,IAAI,CAAC,IAAa;gBAChB,OAAO,GAAG,IAAI,CAAC;gBACf,OAAO,IAAI,CAAC;YACd,CAAC;YACD,QAAQ,CAAC,IAAY,IAAG,CAAC;SACC,CAAC;QAE7B,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QAErC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAEvC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,CAAE,OAAe,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/dev/mountVite.d.ts

@@ -0,0 +1,3 @@
+import type { FastifyInstance } from 'fastify';
+export declare function mountViteDev(fastify: FastifyInstance, viewsDir: string, root: string): Promise<void>;
+//# sourceMappingURL=mountVite.d.ts.map

package/dist/dev/mountVite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mountVite.d.ts","sourceRoot":"","sources":["../../src/dev/mountVite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAK/C,wBAAsB,YAAY,CAChC,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CA+Ef"}

package/dist/dev/mountVite.js

@@ -0,0 +1,72 @@
+import { createViteConfig, ViewScanner } from '@xacos/compiler';
+import { createServer as createViteServer } from 'vite';
+export async function mountViteDev(fastify, viewsDir, root) {
+    const scanner = new ViewScanner(viewsDir);
+    const routes = scanner.scan();
+    // Register routes in Fastify so it knows about them, 
+    // even though Vite middleware will actually serve them.
+    for (const route of routes) {
+        fastify.get(route.path, async (request, reply) => {
+            const mod = await vite.ssrLoadModule(route.filePath);
+            if (mod['ssr'] === true) {
+                const Component = mod.default;
+                if (typeof Component !== 'function') {
+                    throw new Error(`[XAOCS] Page at ${route.filePath} does not have a default export component`);
+                }
+                // In dev mode, we still let Vite handle the HTML shell usually, 
+                // but for a true SSR opt-in, we might want to render the component here.
+                // For now, following the sprint goal: render to string if ssr=true.
+                const { renderSSR } = await import('@xacos/compiler');
+                const { html, meta } = await renderSSR(route.filePath, {
+                    params: request.params,
+                    query: request.query,
+                });
+                // We need a basic HTML shell. For now, we'll return the rendered HTML.
+                // Real implementation would inject into a template.
+                reply.type('text/html').send(`
+          <!DOCTYPE html>
+          <html>
+            <head>
+              <title>${meta.title ?? 'XAOCS App'}</title>
+              ${meta.description ? `<meta name="description" content="${meta.description}">` : ''}
+            </head>
+            <body>
+              <div id="root">${html}</div>
+            </body>
+          </html>
+        `);
+                return;
+            }
+            // The onRequest hook handles the actual Vite forwarding for non-SSR.
+            return reply.callNotFound();
+        });
+    }
+    const config = createViteConfig(viewsDir, root);
+    const vite = await createViteServer(config);
+    // Forward all non-API requests to Vite in dev mode
+    fastify.addHook('onRequest', async (request, reply) => {
+        const url = request.raw.url ?? '/';
+        // Skip API routes — those are handled by XAOCS API router
+        if (url.startsWith('/api/'))
+            return;
+        // Use Vite's connect-style middleware
+        return new Promise((resolve, reject) => {
+            vite.middlewares(request.raw, reply.raw, (err) => {
+                if (err) {
+                    reject(err);
+                }
+                else {
+                    // If Vite doesn't handle it, it will call next()
+                    // We don't really have a 'next' in Fastify onRequest hook in this way,
+                    // but resolve() lets Fastify continue.
+                    resolve();
+                }
+            });
+        });
+    });
+    // Handle graceful shutdown
+    fastify.addHook('onClose', async () => {
+        await vite.close();
+    });
+}
+//# sourceMappingURL=mountVite.js.map

package/dist/dev/mountVite.js.map

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