@lithia-js/core 1.0.0-canary.0

package/dist/server/http-server.d.ts

@@ -0,0 +1,196 @@
+import { type Server } from "node:http";
+import { type Server as HttpsServer } from "node:https";
+import { Server as SocketIOServer } from "socket.io";
+import type { LithiaOptions } from "../config";
+import type { Lithia } from "../lithia";
+/**
+ * Configuration used to create the HTTP server.
+ *
+ * This interface defines the settings required to initialize and run
+ * the Lithia HTTP server, including network bindings and optional SSL.
+ */
+export interface HttpServerConfig {
+    /**
+     * Port to listen on.
+     *
+     * @default 3000
+     */
+    port: number;
+    /**
+     * Hostname or IP address to bind the server to.
+     *
+     * @default "localhost"
+     */
+    host: string;
+    /**
+     * Optional SSL/TLS configuration for HTTPS.
+     *
+     * If provided, the server will use HTTPS instead of HTTP.
+     */
+    ssl?: {
+        /** Path to the private key file or key content. */
+        key: string;
+        /** Path to the certificate file or certificate content. */
+        cert: string;
+        /** Optional passphrase for the private key. */
+        passphrase?: string;
+    };
+}
+/**
+ * Lightweight HTTP server wrapper used by Lithia.
+ *
+ * This class manages the lifecycle of a Node.js HTTP/HTTPS server and
+ * integrates it with Lithia's request processing pipeline and Socket.IO
+ * event handling. It provides a clean abstraction over the underlying
+ * server infrastructure.
+ *
+ * @remarks
+ * The server supports both HTTP and HTTPS protocols, WebSocket connections
+ * via Socket.IO, and graceful shutdown with connection tracking.
+ *
+ * @example
+ * ```typescript
+ * const config = { port: 3000, host: 'localhost' };
+ * const server = new HttpServer(config, lithia);
+ * await server.listen();
+ * ```
+ */
+export declare class HttpServer {
+    private lithia;
+    /** The underlying Node.js HTTP or HTTPS server instance. */
+    private server?;
+    /** Socket.IO server instance for real-time event handling. */
+    private io?;
+    /** Server configuration (port, host, SSL). */
+    private config;
+    /** Processor responsible for handling HTTP requests. */
+    private requestProcessor;
+    /** Processor responsible for handling Socket.IO events. */
+    private eventProcessor;
+    /** Set of active socket connections for graceful shutdown tracking. */
+    private sockets;
+    /**
+     * Creates a new HTTP server instance.
+     *
+     * @param config - Server configuration including port, host, and optional SSL
+     * @param lithia - The main Lithia application instance
+     */
+    constructor(config: HttpServerConfig, lithia: Lithia);
+    get socketIO(): SocketIOServer | undefined;
+    /**
+     * Creates the HTTP request handler function.
+     *
+     * This handler processes all incoming HTTP requests, including the internal
+     * `/_lithia` health check endpoint and regular application routes.
+     *
+     * @returns An async request handler compatible with Node.js http.Server
+     * @private
+     */
+    private createRequestHandler;
+    /**
+     * Creates the underlying HTTP or HTTPS server instance.
+     *
+     * Chooses between HTTP and HTTPS based on the SSL configuration.
+     * Sets up connection tracking for graceful shutdown.
+     *
+     * @returns The created server instance
+     * @private
+     */
+    private createBaseServer;
+    /**
+     * Initializes the Socket.IO server with CORS configuration.
+     *
+     * Creates a Socket.IO instance attached to the HTTP server and configures
+     * it with CORS settings from the Lithia options.
+     *
+     * @param server - The HTTP/HTTPS server to attach Socket.IO to
+     * @returns The configured Socket.IO server instance
+     * @private
+     */
+    private initializeSocketIO;
+    /**
+     * Sets up Socket.IO event listeners for all registered Lithia events.
+     *
+     * This method configures handlers for:
+     * - Connection events (when a client connects)
+     * - Disconnection events (when a client disconnects)
+     * - Custom application events (defined in the Lithia app)
+     *
+     * @private
+     */
+    private setupSocketIOEventListeners;
+    /**
+     * Creates (or returns) the underlying Node.js server instance.
+     *
+     * This method lazily initializes the server and all its dependencies:
+     * - HTTP/HTTPS server
+     * - Socket.IO server
+     * - Event listeners
+     *
+     * Subsequent calls return the same server instance.
+     *
+     * @returns The server instance (HTTP or HTTPS depending on configuration)
+     */
+    create(): Promise<Server | HttpsServer>;
+    /**
+     * Starts the server and begins listening for connections.
+     *
+     * This method will create the server if it hasn't been created yet,
+     * then bind it to the configured host and port. The promise resolves
+     * when the server is successfully listening.
+     *
+     * @throws {Error} If the server fails to start or if the port is already in use
+     * @returns A promise that resolves when the server is listening
+     *
+     * @example
+     * ```typescript
+     * await server.listen();
+     * // Server is now accepting connections
+     * ```
+     */
+    listen(): Promise<void>;
+    /**
+     * Gracefully shuts down the server.
+     *
+     * This method performs a clean shutdown by:
+     * 1. Closing the Socket.IO server and all WebSocket connections
+     * 2. Stopping the HTTP/HTTPS server from accepting new connections
+     * 3. Destroying all active socket connections
+     * 4. Clearing the socket tracking set
+     *
+     * @throws {Error} If an error occurs during shutdown
+     * @returns A promise that resolves when the server is fully closed
+     *
+     * @example
+     * ```typescript
+     * await server.close();
+     * // Server is now fully shut down
+     * ```
+     */
+    close(): Promise<void>;
+}
+/**
+ * Creates an HTTP server instance from Lithia configuration.
+ *
+ * This factory function is the primary way to create an HttpServer from
+ * a complete Lithia configuration object. It extracts the necessary HTTP
+ * settings and instantiates the server.
+ *
+ * @param opts - Configuration object
+ * @param opts.options - The complete Lithia options including HTTP settings
+ * @param opts.lithia - The main Lithia application instance
+ * @returns A configured HttpServer instance ready to be started
+ *
+ * @example
+ * ```typescript
+ * const server = createHttpServerFromConfig({
+ *   options: lithiaOptions,
+ *   lithia: lithiaInstance
+ * });
+ * await server.listen();
+ * ```
+ */
+export declare function createHttpServerFromConfig(opts: {
+    options: LithiaOptions;
+    lithia: Lithia;
+}): HttpServer;

package/dist/server/http-server.js

@@ -0,0 +1,295 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpServer = void 0;
+exports.createHttpServerFromConfig = createHttpServerFromConfig;
+const node_http_1 = require("node:http");
+const node_https_1 = require("node:https");
+const socket_io_1 = require("socket.io");
+const logger_1 = require("../logger");
+const event_processor_1 = require("./event-processor");
+const request_1 = require("./request");
+const request_processor_1 = require("./request-processor");
+const response_1 = require("./response");
+/**
+ * Lightweight HTTP server wrapper used by Lithia.
+ *
+ * This class manages the lifecycle of a Node.js HTTP/HTTPS server and
+ * integrates it with Lithia's request processing pipeline and Socket.IO
+ * event handling. It provides a clean abstraction over the underlying
+ * server infrastructure.
+ *
+ * @remarks
+ * The server supports both HTTP and HTTPS protocols, WebSocket connections
+ * via Socket.IO, and graceful shutdown with connection tracking.
+ *
+ * @example
+ * ```typescript
+ * const config = { port: 3000, host: 'localhost' };
+ * const server = new HttpServer(config, lithia);
+ * await server.listen();
+ * ```
+ */
+class HttpServer {
+    lithia;
+    /** The underlying Node.js HTTP or HTTPS server instance. */
+    server;
+    /** Socket.IO server instance for real-time event handling. */
+    io;
+    /** Server configuration (port, host, SSL). */
+    config;
+    /** Processor responsible for handling HTTP requests. */
+    requestProcessor;
+    /** Processor responsible for handling Socket.IO events. */
+    eventProcessor;
+    /** Set of active socket connections for graceful shutdown tracking. */
+    sockets = new Set();
+    /**
+     * Creates a new HTTP server instance.
+     *
+     * @param config - Server configuration including port, host, and optional SSL
+     * @param lithia - The main Lithia application instance
+     */
+    constructor(config, lithia) {
+        this.lithia = lithia;
+        this.config = config;
+        this.requestProcessor = new request_processor_1.RequestProcessor(lithia, this);
+        this.eventProcessor = new event_processor_1.EventProcessor(lithia);
+    }
+    get socketIO() {
+        return this.io;
+    }
+    /**
+     * Creates the HTTP request handler function.
+     *
+     * This handler processes all incoming HTTP requests, including the internal
+     * `/_lithia` health check endpoint and regular application routes.
+     *
+     * @returns An async request handler compatible with Node.js http.Server
+     * @private
+     */
+    createRequestHandler() {
+        return async (req, res) => {
+            try {
+                // Handle /_lithia internal health check endpoint
+                const url = req.url || "/";
+                if (url === "/_lithia") {
+                    res.writeHead(200, { "Content-Type": "application/json" });
+                    res.end(JSON.stringify({ ok: true, ts: Date.now() }));
+                    return;
+                }
+                // Process request through the Lithia pipeline
+                const lithiaReq = new request_1.LithiaRequest(req, this.lithia);
+                const lithiaRes = new response_1.LithiaResponse(res);
+                await this.requestProcessor.processRequest(lithiaReq, lithiaRes);
+            }
+            catch (err) {
+                logger_1.logger.error("HttpServer request handler error:", err);
+                try {
+                    res.writeHead(500, { "Content-Type": "text/plain" });
+                    res.end("Internal Server Error");
+                }
+                catch (_) {
+                    // Ignore errors when attempting to send error response
+                }
+            }
+        };
+    }
+    /**
+     * Creates the underlying HTTP or HTTPS server instance.
+     *
+     * Chooses between HTTP and HTTPS based on the SSL configuration.
+     * Sets up connection tracking for graceful shutdown.
+     *
+     * @returns The created server instance
+     * @private
+     */
+    createBaseServer() {
+        const handler = this.createRequestHandler();
+        const server = this.config.ssl
+            ? (0, node_https_1.createServer)(this.config.ssl, handler)
+            : (0, node_http_1.createServer)(handler);
+        // Track connections for graceful shutdown
+        server.on("connection", (socket) => {
+            this.sockets.add(socket);
+            socket.on("close", () => {
+                this.sockets.delete(socket);
+            });
+        });
+        return server;
+    }
+    /**
+     * Initializes the Socket.IO server with CORS configuration.
+     *
+     * Creates a Socket.IO instance attached to the HTTP server and configures
+     * it with CORS settings from the Lithia options.
+     *
+     * @param server - The HTTP/HTTPS server to attach Socket.IO to
+     * @returns The configured Socket.IO server instance
+     * @private
+     */
+    initializeSocketIO(server) {
+        return new socket_io_1.Server(server, {
+            cors: {
+                origin: this.lithia.options.http.cors?.origin || "*",
+                methods: this.lithia.options.http.cors?.methods || ["GET", "POST"],
+                credentials: this.lithia.options.http.cors?.credentials ?? true,
+            },
+        });
+    }
+    /**
+     * Sets up Socket.IO event listeners for all registered Lithia events.
+     *
+     * This method configures handlers for:
+     * - Connection events (when a client connects)
+     * - Disconnection events (when a client disconnects)
+     * - Custom application events (defined in the Lithia app)
+     *
+     * @private
+     */
+    setupSocketIOEventListeners() {
+        if (!this.io)
+            return;
+        const events = this.lithia.getEvents();
+        const connectionEvent = events.find((e) => e.name === "connection");
+        const disconnectEvent = events.find((e) => e.name === "disconnect");
+        this.io.on("connection", async (socket) => {
+            // Handle connection event
+            if (connectionEvent) {
+                await this.eventProcessor.processEvent(socket, connectionEvent);
+            }
+            // Handle disconnect event
+            socket.on("disconnect", async () => {
+                if (disconnectEvent) {
+                    await this.eventProcessor.processEvent(socket, disconnectEvent);
+                }
+            });
+            // Handle all custom events
+            socket.onAny(async (eventName, ...args) => {
+                const event = events.find((e) => e.name === eventName);
+                if (event) {
+                    await this.eventProcessor.processEvent(socket, event, ...args);
+                }
+            });
+        });
+    }
+    /**
+     * Creates (or returns) the underlying Node.js server instance.
+     *
+     * This method lazily initializes the server and all its dependencies:
+     * - HTTP/HTTPS server
+     * - Socket.IO server
+     * - Event listeners
+     *
+     * Subsequent calls return the same server instance.
+     *
+     * @returns The server instance (HTTP or HTTPS depending on configuration)
+     */
+    async create() {
+        if (this.server)
+            return this.server;
+        this.server = this.createBaseServer();
+        this.io = this.initializeSocketIO(this.server);
+        this.setupSocketIOEventListeners();
+        return this.server;
+    }
+    /**
+     * Starts the server and begins listening for connections.
+     *
+     * This method will create the server if it hasn't been created yet,
+     * then bind it to the configured host and port. The promise resolves
+     * when the server is successfully listening.
+     *
+     * @throws {Error} If the server fails to start or if the port is already in use
+     * @returns A promise that resolves when the server is listening
+     *
+     * @example
+     * ```typescript
+     * await server.listen();
+     * // Server is now accepting connections
+     * ```
+     */
+    async listen() {
+        if (!this.server)
+            await this.create();
+        return new Promise((resolve, reject) => {
+            if (!this.server)
+                return reject(new Error("Server not created"));
+            // If already listening, resolve immediately
+            if (this.server.listening)
+                return resolve();
+            this.server.listen(this.config.port, this.config.host, () => {
+                logger_1.logger.event(`Server listening on http://${this.config.host}:${this.config.port}`);
+                resolve();
+            });
+            this.server.on("error", (err) => {
+                logger_1.logger.error("Server error:", err);
+                reject(err);
+            });
+        });
+    }
+    /**
+     * Gracefully shuts down the server.
+     *
+     * This method performs a clean shutdown by:
+     * 1. Closing the Socket.IO server and all WebSocket connections
+     * 2. Stopping the HTTP/HTTPS server from accepting new connections
+     * 3. Destroying all active socket connections
+     * 4. Clearing the socket tracking set
+     *
+     * @throws {Error} If an error occurs during shutdown
+     * @returns A promise that resolves when the server is fully closed
+     *
+     * @example
+     * ```typescript
+     * await server.close();
+     * // Server is now fully shut down
+     * ```
+     */
+    async close() {
+        if (!this.server)
+            return;
+        // Close Socket.IO server
+        await this.io?.close();
+        // Close HTTP/HTTPS server
+        this.server.close((err) => {
+            if (err)
+                throw err;
+        });
+        // Destroy all active connections
+        for (const socket of this.sockets) {
+            socket.destroy();
+        }
+        this.sockets.clear();
+    }
+}
+exports.HttpServer = HttpServer;
+/**
+ * Creates an HTTP server instance from Lithia configuration.
+ *
+ * This factory function is the primary way to create an HttpServer from
+ * a complete Lithia configuration object. It extracts the necessary HTTP
+ * settings and instantiates the server.
+ *
+ * @param opts - Configuration object
+ * @param opts.options - The complete Lithia options including HTTP settings
+ * @param opts.lithia - The main Lithia application instance
+ * @returns A configured HttpServer instance ready to be started
+ *
+ * @example
+ * ```typescript
+ * const server = createHttpServerFromConfig({
+ *   options: lithiaOptions,
+ *   lithia: lithiaInstance
+ * });
+ * await server.listen();
+ * ```
+ */
+function createHttpServerFromConfig(opts) {
+    const cfg = {
+        port: opts.options.http.port,
+        host: opts.options.http.host,
+        ssl: opts.options.http.ssl,
+    };
+    return new HttpServer(cfg, opts.lithia);
+}
+//# sourceMappingURL=http-server.js.map

package/dist/server/http-server.js.map

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

package/dist/server/middlewares/validation.d.ts

@@ -0,0 +1,12 @@
+import { type ZodType } from "zod";
+import type { LithiaMiddleware } from "../request-processor";
+export interface ValidationSchemas {
+    body?: ZodType;
+    query?: ZodType;
+    params?: ZodType;
+}
+/**
+ * Creates a middleware that validates request data against Zod schemas.
+ * Validated data is assigned back to the request object.
+ */
+export declare function validate(schemas: ValidationSchemas): LithiaMiddleware;

package/dist/server/middlewares/validation.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validate = validate;
+const zod_1 = require("zod");
+const errors_1 = require("../../errors");
+/**
+ * Creates a middleware that validates request data against Zod schemas.
+ * Validated data is assigned back to the request object.
+ */
+function validate(schemas) {
+    return async (req, _res, next) => {
+        try {
+            if (schemas.params) {
+                req.params = (await schemas.params.parseAsync(req.params));
+            }
+            if (schemas.query) {
+                req.query = (await schemas.query.parseAsync(req.query));
+            }
+            if (schemas.body) {
+                const body = await req.body();
+                const validatedBody = await schemas.body.parseAsync(body);
+                req.setBody(validatedBody);
+            }
+            next();
+        }
+        catch (err) {
+            if (err instanceof zod_1.ZodError) {
+                throw new errors_1.ValidationError("Validation failed", err.issues);
+            }
+            throw err;
+        }
+    };
+}
+//# sourceMappingURL=validation.js.map

package/dist/server/middlewares/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/server/middlewares/validation.ts"],"names":[],"mappings":";;AAcA,4BA+BC;AA7CD,6BAA6C;AAC7C,yCAA+C;AAS/C;;;GAGG;AACH,SAAgB,QAAQ,CAAC,OAA0B;IAClD,OAAO,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;QAChC,IAAI,CAAC;YACJ,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACpB,GAAG,CAAC,MAAM,GAAG,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAGxD,CAAC;YACH,CAAC;YAED,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;gBACnB,GAAG,CAAC,KAAK,GAAG,CAAC,MAAM,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAGrD,CAAC;YACH,CAAC;YAED,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;gBAClB,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;gBAC9B,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;gBAC1D,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;YAC5B,CAAC;YAED,IAAI,EAAE,CAAC;QACR,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACd,IAAI,GAAG,YAAY,cAAQ,EAAE,CAAC;gBAC7B,MAAM,IAAI,wBAAe,CAAC,mBAAmB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;YAC5D,CAAC;YACD,MAAM,GAAG,CAAC;QACX,CAAC;IACF,CAAC,CAAC;AACH,CAAC"}