@ereo/server 0.1.6

package/README.md

@@ -0,0 +1,76 @@
+# @ereo/server
+
+High-performance Bun HTTP server for the EreoJS framework. Includes streaming SSR, middleware, static file serving, and compression.
+
+## Installation
+
+```bash
+bun add @ereo/server
+```
+
+## Quick Start
+
+```typescript
+import { createServer, serve } from '@ereo/server';
+import { createFileRouter } from '@ereo/router';
+
+const router = createFileRouter({ routesDir: './src/routes' });
+
+const server = createServer({
+  router,
+  port: 3000,
+});
+
+serve(server);
+// Server running at http://localhost:3000
+```
+
+## Key Features
+
+- **High Performance** - Built on Bun's native HTTP server for maximum speed
+- **Streaming SSR** - Stream React components with `renderToStream` and Suspense support
+- **Middleware Stack** - Composable middleware with `createMiddlewareChain`
+- **Static Files** - Efficient static file serving with `serveStatic` and MIME type detection
+- **Built-in Middleware** - Logger, CORS, security headers, compression, and rate limiting
+- **Shell Templates** - Customizable HTML shells for SSR with `createShell`
+
+## Middleware Example
+
+```typescript
+import { createMiddlewareChain, logger, cors, securityHeaders, compress } from '@ereo/server';
+
+const middleware = createMiddlewareChain([
+  logger(),
+  cors({ origin: 'https://example.com' }),
+  securityHeaders(),
+  compress(),
+]);
+```
+
+## Streaming SSR
+
+```typescript
+import { renderToStream, createShell } from '@ereo/server';
+
+const shell = createShell({
+  head: '<title>My App</title>',
+  scripts: ['/client.js'],
+});
+
+const stream = await renderToStream(<App />, { shell });
+return new Response(stream, {
+  headers: { 'Content-Type': 'text/html' },
+});
+```
+
+## Documentation
+
+For full documentation, visit [https://ereojs.dev/docs/server](https://ereojs.dev/docs/server)
+
+## Part of EreoJS
+
+This package is part of the [EreoJS](https://github.com/ereojs/ereo) monorepo - a modern full-stack framework built for Bun.
+
+## License
+
+MIT

package/dist/bun-server.d.ts

@@ -0,0 +1,177 @@
+/**
+ * @ereo/server - Bun HTTP Server
+ *
+ * High-performance HTTP server using Bun.serve().
+ * Designed for 5-6x faster performance than Node.js.
+ */
+import type { Server } from 'bun';
+import type { MiddlewareHandler } from '@ereo/core';
+import { EreoApp } from '@ereo/core';
+import { FileRouter } from '@ereo/router';
+import { cors, securityHeaders } from './middleware';
+import { type StaticOptions } from './static';
+import { type ShellTemplate } from './streaming';
+/**
+ * Server render mode options.
+ *
+ * This type is distinct from the route-level RenderMode in @ereo/core.
+ * - ServerRenderMode: How the server renders React components ('streaming' vs 'string')
+ * - RenderMode (core): What type of rendering a route uses ('ssg', 'ssr', 'csr', etc.)
+ */
+export type ServerRenderMode = 'streaming' | 'string';
+/**
+ * Server options.
+ */
+export interface ServerOptions {
+    /** Port to listen on */
+    port?: number;
+    /** Hostname to bind to */
+    hostname?: string;
+    /** Development mode */
+    development?: boolean;
+    /** Static file options */
+    static?: StaticOptions;
+    /** Enable logging */
+    logging?: boolean;
+    /** Enable CORS */
+    cors?: boolean | Parameters<typeof cors>[0];
+    /** Enable security headers */
+    security?: boolean | Parameters<typeof securityHeaders>[0];
+    /** Custom request handler */
+    handler?: (request: Request) => Response | Promise<Response>;
+    /** WebSocket handler */
+    websocket?: Parameters<typeof Bun.serve>[0]['websocket'];
+    /** TLS options */
+    tls?: {
+        cert: string;
+        key: string;
+    };
+    /** Render mode: 'streaming' for React 18 streaming SSR, 'string' for traditional SSR */
+    renderMode?: ServerRenderMode;
+    /** Base path for client assets */
+    assetsPath?: string;
+    /** Client entry script path */
+    clientEntry?: string;
+    /** Default shell template */
+    shell?: ShellTemplate;
+}
+/**
+ * Bun server instance.
+ */
+export declare class BunServer {
+    private server;
+    private app;
+    private router;
+    private middleware;
+    private staticHandler;
+    private options;
+    constructor(options?: ServerOptions);
+    /**
+     * Setup default middleware.
+     */
+    private setupMiddleware;
+    /**
+     * Set the EreoJS app instance.
+     */
+    setApp(app: EreoApp): void;
+    /**
+     * Set the file router.
+     */
+    setRouter(router: FileRouter): void;
+    /**
+     * Add middleware.
+     */
+    use(handler: MiddlewareHandler): void;
+    use(path: string, handler: MiddlewareHandler): void;
+    /**
+     * Handle incoming request.
+     */
+    private handleRequest;
+    /**
+     * Handle a matched route.
+     */
+    private handleRoute;
+    /**
+     * Render a full HTML page with the route component and layouts.
+     */
+    private renderPage;
+    /**
+     * Render page using React 18 streaming SSR.
+     * Uses renderToReadableStream for Bun environments with native Web Streams API.
+     */
+    private renderStreamingPage;
+    /**
+     * Render page using traditional string-based SSR.
+     */
+    private renderStringPage;
+    /**
+     * Render page directly using streaming when layout provides HTML structure.
+     * The layout component is expected to render the full HTML document.
+     */
+    private renderStreamingPageDirect;
+    /**
+     * Render page directly using string when layout provides HTML structure.
+     */
+    private renderStringPageDirect;
+    /**
+     * Render a minimal HTML page when no component is available.
+     */
+    private renderMinimalPage;
+    /**
+     * Render an error page.
+     */
+    private renderErrorPage;
+    /**
+     * Build meta descriptors from route's meta function.
+     */
+    private buildMeta;
+    /**
+     * Extract title from meta descriptors.
+     */
+    private extractTitle;
+    /**
+     * Extract meta tags from meta descriptors (excluding title).
+     */
+    private extractMetaTags;
+    /**
+     * Escape HTML special characters.
+     */
+    private escapeHtml;
+    /**
+     * Handle errors.
+     */
+    private handleError;
+    /**
+     * Start the server.
+     */
+    start(): Promise<Server<unknown>>;
+    /**
+     * Stop the server.
+     */
+    stop(): void;
+    /**
+     * Reload the server (for HMR).
+     */
+    reload(): Promise<void>;
+    /**
+     * Get the server instance.
+     */
+    getServer(): Server<unknown> | null;
+    /**
+     * Get server info.
+     */
+    getInfo(): {
+        port: number;
+        hostname: string;
+        development: boolean;
+    };
+}
+/**
+ * Create a Bun server.
+ */
+export declare function createServer(options?: ServerOptions): BunServer;
+/**
+ * Quick start helper.
+ */
+export declare function serve(options?: ServerOptions): Promise<BunServer>;
+//# sourceMappingURL=bun-server.d.ts.map

package/dist/bun-server.d.ts.map

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

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @ereo/server
+ *
+ * High-performance Bun HTTP server for the EreoJS framework.
+ */
+export { BunServer, createServer, serve, } from './bun-server';
+export type { ServerOptions, ServerRenderMode } from './bun-server';
+export { MiddlewareChain, createMiddlewareChain, logger, cors, securityHeaders, compress, rateLimit, } from './middleware';
+export type { MiddlewareDefinition, CorsOptions, SecurityHeadersOptions, RateLimitOptions, } from './middleware';
+export type { MiddlewareHandler, NextFunction, Middleware, AppContext, } from '@ereo/core';
+export { serveStatic, staticMiddleware, getMimeType, } from './static';
+export type { StaticOptions } from './static';
+export { createShell, renderToStream, renderToString, createResponse, createSuspenseStream, } from './streaming';
+export type { RenderOptions, ShellTemplate, RenderResult, } from './streaming';
+//# 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;;;;GAIG;AAGH,OAAO,EACL,SAAS,EACT,YAAY,EACZ,KAAK,GACN,MAAM,cAAc,CAAC;AAEtB,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGpE,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,MAAM,EACN,IAAI,EACJ,eAAe,EACf,QAAQ,EACR,SAAS,GACV,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,oBAAoB,EACpB,WAAW,EACX,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAItB,YAAY,EACV,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,UAAU,GACX,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,WAAW,GACZ,MAAM,UAAU,CAAC;AAElB,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C,OAAO,EACL,WAAW,EACX,cAAc,EACd,cAAc,EACd,cAAc,EACd,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,aAAa,EACb,aAAa,EACb,YAAY,GACb,MAAM,aAAa,CAAC"}