@ereo/server 0.1.6

package/dist/middleware.d.ts

@@ -0,0 +1,98 @@
+/**
+ * @ereo/server - Middleware Chain
+ *
+ * Hono-inspired middleware system for request processing.
+ * Uses Web Standards throughout.
+ *
+ * NOTE: This module uses `MiddlewareHandler` from `@ereo/core` as the base type.
+ * The handler signature is: (request: Request, context: AppContext, next: NextFunction) => Response | Promise<Response>
+ *
+ * For typed middleware with context type safety, use `TypedMiddlewareHandler` from `@ereo/router`.
+ * TypedMiddlewareHandler is fully compatible with MiddlewareHandler.
+ */
+import type { MiddlewareHandler, AppContext } from '@ereo/core';
+/**
+ * Middleware definition with optional path matching.
+ *
+ * This interface uses `MiddlewareHandler` from `@ereo/core`, ensuring
+ * compatibility across all EreoJS packages. The handler signature is:
+ * `(request: Request, context: AppContext, next: NextFunction) => Response | Promise<Response>`
+ *
+ * Note: The `path` property here supports both single strings and arrays,
+ * similar to the `paths` property in `@ereo/core`'s `Middleware` interface.
+ */
+export interface MiddlewareDefinition {
+    /** Optional path patterns to match. Supports wildcards like '/api/*'. */
+    path?: string | string[];
+    /** The middleware handler function. Uses the core MiddlewareHandler type. */
+    handler: MiddlewareHandler;
+}
+/**
+ * Middleware chain executor.
+ */
+export declare class MiddlewareChain {
+    private middlewares;
+    /**
+     * Add middleware to the chain.
+     */
+    use(handler: MiddlewareHandler): this;
+    use(path: string, handler: MiddlewareHandler): this;
+    /**
+     * Execute middleware chain.
+     *
+     * @param request - The incoming Request object
+     * @param context - The application context (AppContext). Note: RequestContext implements AppContext.
+     * @param final - The final handler to call when the chain completes
+     * @returns The response from the middleware chain
+     */
+    execute(request: Request, context: AppContext, final: () => Promise<Response>): Promise<Response>;
+    /**
+     * Simple path matching (supports * wildcard).
+     */
+    private matchPath;
+}
+/**
+ * Create a middleware chain.
+ */
+export declare function createMiddlewareChain(): MiddlewareChain;
+/**
+ * Logging middleware.
+ */
+export declare function logger(): MiddlewareHandler;
+/**
+ * CORS middleware.
+ */
+export interface CorsOptions {
+    origin?: string | string[] | ((origin: string) => boolean);
+    methods?: string[];
+    allowedHeaders?: string[];
+    exposedHeaders?: string[];
+    credentials?: boolean;
+    maxAge?: number;
+}
+export declare function cors(options?: CorsOptions): MiddlewareHandler;
+/**
+ * Security headers middleware.
+ */
+export interface SecurityHeadersOptions {
+    contentSecurityPolicy?: string | false;
+    xFrameOptions?: 'DENY' | 'SAMEORIGIN' | false;
+    xContentTypeOptions?: boolean;
+    referrerPolicy?: string | false;
+    permissionsPolicy?: string | false;
+}
+export declare function securityHeaders(options?: SecurityHeadersOptions): MiddlewareHandler;
+/**
+ * Compression middleware (uses Bun's built-in compression).
+ */
+export declare function compress(): MiddlewareHandler;
+/**
+ * Rate limiting middleware.
+ */
+export interface RateLimitOptions {
+    windowMs?: number;
+    max?: number;
+    keyGenerator?: (request: Request) => string;
+}
+export declare function rateLimit(options?: RateLimitOptions): MiddlewareHandler;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAgB,UAAU,EAAE,MAAM,YAAY,CAAC;AAG9E;;;;;;;;;GASG;AACH,MAAM,WAAW,oBAAoB;IACnC,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,6EAA6E;IAC7E,OAAO,EAAE,iBAAiB,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,WAAW,CAA8B;IAEjD;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IACrC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAUnD;;;;;;;OAOG;IACG,OAAO,CACX,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,UAAU,EACnB,KAAK,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,GAC7B,OAAO,CAAC,QAAQ,CAAC;IAwBpB;;OAEG;IACH,OAAO,CAAC,SAAS;CAQlB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,CAEvD;AAMD;;GAEG;AACH,wBAAgB,MAAM,IAAI,iBAAiB,CAc1C;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;IAC3D,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,IAAI,CAAC,OAAO,GAAE,WAAgB,GAAG,iBAAiB,CAyDjE;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,qBAAqB,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACvC,aAAa,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,KAAK,CAAC;IAC9C,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAChC,iBAAiB,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CACpC;AAED,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,iBAAiB,CAmCvF;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,iBAAiB,CA6B5C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC;CAC7C;AAED,wBAAgB,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG,iBAAiB,CAuD3E"}

package/dist/static.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @ereo/server - Static File Serving
+ *
+ * Efficient static file serving with caching support.
+ */
+/**
+ * Get MIME type for a file extension.
+ */
+export declare function getMimeType(filepath: string): string;
+/**
+ * Static file serving options.
+ */
+export interface StaticOptions {
+    /** Root directory for static files */
+    root: string;
+    /** URL prefix (default: '/') */
+    prefix?: string;
+    /** Max age for cache-control (seconds, default: 0 in dev, 31536000 in prod) */
+    maxAge?: number;
+    /** Enable immutable caching for fingerprinted files */
+    immutable?: boolean;
+    /** Index file (default: 'index.html') */
+    index?: string;
+    /** Enable directory listing (default: false) */
+    listing?: boolean;
+    /** Fallback file for SPA routing */
+    fallback?: string;
+    /** Enable format negotiation for images based on Accept header */
+    negotiateImageFormat?: boolean;
+}
+/**
+ * Create a static file handler.
+ */
+export declare function serveStatic(options: StaticOptions): (request: Request) => Promise<Response | null>;
+/**
+ * Middleware version of static file serving.
+ */
+export declare function staticMiddleware(options: StaticOptions): (request: Request, context: any, next: () => Promise<Response>) => Promise<Response>;
+//# sourceMappingURL=static.d.ts.map

package/dist/static.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static.d.ts","sourceRoot":"","sources":["../src/static.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAuCH;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAwDD;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CA6IlG;AA6CD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,IAGvC,SAAS,OAAO,EAAE,SAAS,GAAG,EAAE,MAAM,MAAM,OAAO,CAAC,QAAQ,CAAC,uBAK5E"}

package/dist/streaming.d.ts

@@ -0,0 +1,88 @@
+/**
+ * @ereo/server - React Streaming Support
+ *
+ * Server-side rendering with streaming support for React 18+.
+ */
+import type { ReactElement } from 'react';
+import type { RouteMatch, AppContext } from '@ereo/core';
+/**
+ * Render options.
+ */
+export interface RenderOptions {
+    /** Route match */
+    match: RouteMatch;
+    /** Request context */
+    context: AppContext;
+    /** Shell template */
+    shell?: ShellTemplate;
+    /** Enable streaming */
+    streaming?: boolean;
+    /** Bootstrap scripts */
+    scripts?: string[];
+    /** Stylesheets */
+    styles?: string[];
+}
+/**
+ * Shell template for HTML document.
+ */
+export interface ShellTemplate {
+    /** Document title */
+    title?: string;
+    /** Meta tags */
+    meta?: Array<{
+        name?: string;
+        property?: string;
+        content: string;
+    }>;
+    /** Head content */
+    head?: string;
+    /** Body attributes */
+    bodyAttrs?: Record<string, string>;
+    /** HTML attributes */
+    htmlAttrs?: Record<string, string>;
+}
+/**
+ * Render result.
+ */
+export interface RenderResult {
+    /** HTML content or stream */
+    body: string | ReadableStream<Uint8Array>;
+    /** Response headers */
+    headers: Headers;
+    /** Status code */
+    status: number;
+}
+/**
+ * Create the HTML shell wrapper.
+ */
+export declare function createShell(options: {
+    shell?: ShellTemplate;
+    scripts?: string[];
+    styles?: string[];
+    loaderData?: unknown;
+}): {
+    head: string;
+    tail: string;
+};
+/**
+ * Render a route to a streaming response.
+ * Uses renderToPipeableStream for Node.js/Bun environments.
+ */
+export declare function renderToStream(element: ReactElement, options: RenderOptions): Promise<RenderResult>;
+/**
+ * Render a route to a string (non-streaming).
+ */
+export declare function renderToString(element: ReactElement, options: RenderOptions): Promise<RenderResult>;
+/**
+ * Create a Response from render result.
+ */
+export declare function createResponse(result: RenderResult): Response;
+/**
+ * Stream helper for sending chunks with delays (Suspense boundaries).
+ */
+export declare function createSuspenseStream(): {
+    stream: ReadableStream<Uint8Array>;
+    push: (chunk: string) => void;
+    close: () => void;
+};
+//# sourceMappingURL=streaming.d.ts.map

package/dist/streaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../src/streaming.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,KAAK,EAAS,UAAU,EAAE,UAAU,EAAkB,MAAM,YAAY,CAAC;AAGhF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kBAAkB;IAClB,KAAK,EAAE,UAAU,CAAC;IAClB,sBAAsB;IACtB,OAAO,EAAE,UAAU,CAAC;IACpB,qBAAqB;IACrB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,uBAAuB;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,kBAAkB;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB;IAChB,IAAI,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpE,mBAAmB;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,sBAAsB;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,6BAA6B;IAC7B,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAC1C,uBAAuB;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE;IACnC,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAkDjC;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CAmEvB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CA2BvB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,QAAQ,CAK7D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI;IACtC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IACnC,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAmBA"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@ereo/server",
+  "version": "0.1.6",
+  "license": "MIT",
+  "author": "Ereo Team",
+  "homepage": "https://ereo.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ereojs/ereo.git",
+    "directory": "packages/server"
+  },
+  "bugs": {
+    "url": "https://github.com/ereojs/ereo/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "bun build ./src/index.ts --outdir ./dist --target bun --external @ereo/core --external @ereo/router --external @ereo/data --external react --external react-dom && bun run build:types",
+    "build:types": "tsc --emitDeclarationOnly --outDir dist",
+    "dev": "bun build ./src/index.ts --outdir ./dist --target bun --watch",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@ereo/core": "workspace:*",
+    "@ereo/router": "workspace:*",
+    "@ereo/data": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.1.0",
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
+    "typescript": "^5.4.0"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0"
+  }
+}