exisjs 0.1.2

package/dist/server/response.js

@@ -0,0 +1,254 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExisResponse = void 0;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const contentDisposition = require('content-disposition');
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const mime = require('mime-types');
+function generateETag(content) {
+    let h = 0x811c9dc5;
+    for (const byte of content) {
+        h ^= byte;
+        h = (h * 0x01000193) >>> 0;
+    }
+    return `W/"${content.length.toString(16)}-${h.toString(16)}"`;
+}
+class ExisResponse {
+    constructor(raw) {
+        this.raw = raw;
+        this.etagEnabled = false;
+        this._onFinish = [];
+    }
+    get headersSent() {
+        return this.raw.headersSent;
+    }
+    get statusCode() {
+        return this.raw.statusCode;
+    }
+    set statusCode(code) {
+        this.raw.statusCode = code;
+    }
+    getHeader(name) {
+        return this.raw.getHeader(name);
+    }
+    setHeader(name, value) {
+        this.raw.setHeader(name, value);
+    }
+    hasHeader(name) {
+        return this.raw.hasHeader(name);
+    }
+    end(data) {
+        if (this._onFinish.length > 0) {
+            this.raw.end(data, () => {
+                // eslint-disable-next-line @typescript-eslint/prefer-for-of
+                for (let i = 0; i < this._onFinish.length; i++) {
+                    this._onFinish[i]();
+                }
+            });
+        }
+        else {
+            this.raw.end(data);
+        }
+    }
+    status(code) {
+        this.raw.statusCode = code;
+        return this;
+    }
+    set(header, value) {
+        this.setHeader(header, value);
+        return this;
+    }
+    header(name, value) {
+        return this.set(name, value);
+    }
+    sendStatus(code) {
+        this.statusCode = code;
+        this.send(String(code));
+    }
+    removeHeader(name) {
+        this.raw.removeHeader(name);
+        return this;
+    }
+    setStrHeaders(headers) {
+        for (const [key, value] of Object.entries(headers)) {
+            this.setHeader(key, value);
+        }
+        return this;
+    }
+    append(field, value) {
+        const prev = this.getHeader(field);
+        let finalValue = value;
+        if (prev) {
+            const prevArr = Array.isArray(prev) ? prev : [String(prev)];
+            const newArr = Array.isArray(value) ? value : [String(value)];
+            finalValue = prevArr.concat(newArr);
+        }
+        this.setHeader(field, finalValue);
+        return this;
+    }
+    send(body) {
+        if (this.raw.headersSent)
+            return;
+        if (typeof body === 'object' && body !== null && !Buffer.isBuffer(body)) {
+            this.json(body);
+            return;
+        }
+        const isBuffer = Buffer.isBuffer(body);
+        const content = isBuffer ? body : Buffer.from(body, 'utf8');
+        if (!this.raw.hasHeader('Content-Type')) {
+            this.raw.setHeader('Content-Type', isBuffer ? 'application/octet-stream' : 'text/plain; charset=utf-8');
+        }
+        if (this.etagEnabled && !this.raw.hasHeader('ETag')) {
+            this.raw.setHeader('ETag', generateETag(content));
+        }
+        if (this.req && this.req.fresh) {
+            this.statusCode = 304;
+            this.end();
+            return;
+        }
+        this.raw.setHeader('Content-Length', content.length);
+        this.end(content);
+    }
+    json(data) {
+        if (this.raw.headersSent)
+            return;
+        let str;
+        try {
+            const useSerializer = this._serializer && this.statusCode < 400;
+            str = useSerializer ? this._serializer(data) : JSON.stringify(data);
+        }
+        catch {
+            this.statusCode = 500;
+            this.raw.setHeader('Content-Type', 'application/json; charset=utf-8');
+            this.end('{"error":"Failed to serialize response"}');
+            return;
+        }
+        if (this.req?.fresh) {
+            this.statusCode = 304;
+            this.end();
+            return;
+        }
+        if (!this.raw.hasHeader('Content-Type')) {
+            this.raw.setHeader('Content-Type', 'application/json; charset=utf-8');
+        }
+        const byteLen = Buffer.byteLength(str, 'utf8');
+        if (this.etagEnabled && !this.raw.hasHeader('ETag')) {
+            this.raw.setHeader('ETag', generateETag(Buffer.from(str, 'utf8')));
+        }
+        this.raw.setHeader('Content-Length', byteLen);
+        this.end(str);
+    }
+    html(content) {
+        if (this.headersSent)
+            return;
+        if (!this.hasHeader('Content-Type')) {
+            this.setHeader('Content-Type', 'text/html; charset=utf-8');
+        }
+        const buf = Buffer.from(content, 'utf8');
+        this.setHeader('Content-Length', buf.length);
+        this.end(buf);
+    }
+    redirect(url, code = 302) {
+        if (this.headersSent)
+            return;
+        this.statusCode = code;
+        this.setHeader('Location', url);
+        this.end();
+    }
+    sendStream(readable) {
+        if (this.headersSent)
+            return;
+        if (!this.hasHeader('Content-Type')) {
+            this.setHeader('Content-Type', 'application/octet-stream');
+        }
+        readable.pipe(this.raw);
+    }
+    download(filePath, filename, options) {
+        if (this.headersSent)
+            return;
+        const name = filename || node_path_1.default.basename(filePath);
+        this.setHeader('Content-Disposition', contentDisposition(name));
+        if (!this.hasHeader('Content-Type')) {
+            const type = mime.lookup(name) || 'application/octet-stream';
+            this.setHeader('Content-Type', type);
+        }
+        const stream = node_fs_1.default.createReadStream(filePath, options);
+        stream.on('error', (err) => {
+            if (err.code === 'ENOENT') {
+                this.statusCode = 404;
+                this.end('File not found');
+            }
+            else {
+                this.statusCode = 500;
+                this.end('Error reading file');
+            }
+        });
+        stream.pipe(this.raw);
+    }
+    type(type) {
+        const mimeType = mime.contentType(type) || type;
+        this.setHeader('Content-Type', mimeType);
+        return this;
+    }
+    links(links) {
+        let linkHeader = this.getHeader('Link') || '';
+        if (Array.isArray(linkHeader))
+            linkHeader = linkHeader.join(', ');
+        const parts = Object.keys(links).map((rel) => `<${links[rel]}>; rel="${rel}"`);
+        const newLinks = parts.join(', ');
+        this.setHeader('Link', linkHeader ? `${linkHeader}, ${newLinks}` : newLinks);
+        return this;
+    }
+    vary(field) {
+        if (!field)
+            return this;
+        let varyHeader = this.getHeader('Vary') || '';
+        if (Array.isArray(varyHeader))
+            varyHeader = varyHeader.join(', ');
+        if (!varyHeader) {
+            this.setHeader('Vary', field);
+            return this;
+        }
+        const fields = varyHeader
+            .split(',')
+            .map((f) => f.trim().toLowerCase());
+        if (!fields.includes(field.toLowerCase()) && !fields.includes('*')) {
+            this.setHeader('Vary', `${varyHeader}, ${field}`);
+        }
+        return this;
+    }
+    cookie(name, value, options = {}) {
+        const parts = [
+            `${encodeURIComponent(name)}=${encodeURIComponent(value)}`,
+        ];
+        if (options.maxAge !== undefined)
+            parts.push(`Max-Age=${options.maxAge}`);
+        if (options.expires)
+            parts.push(`Expires=${options.expires.toUTCString()}`);
+        if (options.path ?? true)
+            parts.push(`Path=${options.path ?? '/'}`);
+        if (options.domain)
+            parts.push(`Domain=${options.domain}`);
+        if (options.httpOnly)
+            parts.push('HttpOnly');
+        if (options.secure)
+            parts.push('Secure');
+        if (options.sameSite)
+            parts.push(`SameSite=${options.sameSite}`);
+        this.append('Set-Cookie', parts.join('; '));
+        if (process.env.NODE_ENV === 'development') {
+            this.append('X-Set-Cookie', parts.join('; '));
+        }
+        return this;
+    }
+    clearCookie(name) {
+        return this.cookie(name, '', { expires: new Date(0), httpOnly: true });
+    }
+}
+exports.ExisResponse = ExisResponse;
+//# sourceMappingURL=response.js.map

package/dist/server/response.js.map

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

package/dist/server/route.d.ts

@@ -0,0 +1,148 @@
+import type { Handler, Request, Response, HookError, HookResponse } from '../types';
+import { App } from './app';
+import type { ExisWebSocket } from '../websocket/socket';
+import type { ExisSSE } from './sse';
+/**
+ * The execution context passed to every route handler.
+ * It provides fully-typed, structured access to the request's properties and the ExisJS app.
+ *
+ * @example
+ * async handle(ctx) {
+ *   const { body, query, req, res, app } = ctx
+ *   return { message: 'Hello World' }
+ * }
+ */
+export interface SuperContext<B = any, Q = any, P = any> {
+    body: B;
+    query: Q;
+    params: P;
+    headers: Record<string, string | string[] | undefined>;
+    req: Request;
+    res: Response;
+    app: App;
+    [key: string]: any;
+}
+/**
+ * Configuration options for an individual route.
+ * You can define expected schemas (body, query, params, response),
+ * apply route-specific middleware, and write your business logic in `handle`.
+ *
+ * @example
+ * export default controller({
+ *   login: route.post('/login', {
+ *     body: { email: v.string(), password: v.string() },
+ *     middleware: [rateLimiter],
+ *     async handle({ body }) {
+ *       return { token: '...' }
+ *     }
+ *   })
+ * })
+ */
+export interface RouteConfig<B = any, Q = any, P = any> {
+    body?: any;
+    query?: any;
+    params?: any;
+    response?: any;
+    cors?: any;
+    middleware?: Handler[];
+    filters?: any | any[];
+    host?: string | string[];
+    handle: (ctx: SuperContext<B, Q, P>) => any | Promise<any>;
+}
+/**
+ * The execution context for a WebSocket route.
+ * Injects a fully-typed native `ExisWebSocket` instance.
+ */
+export interface WsSuperContext<B = any, Q = any, P = any> extends SuperContext<B, Q, P> {
+    socket: ExisWebSocket;
+}
+export interface WsRouteConfig<B = any, Q = any, P = any> extends Omit<RouteConfig<B, Q, P>, 'handle'> {
+    handle: (ctx: WsSuperContext<B, Q, P>) => any | Promise<any>;
+}
+/**
+ * The execution context for a Server-Sent Events (SSE) route.
+ * Injects a fully-typed native `ExisSSE` stream instance.
+ */
+export interface SseSuperContext<B = any, Q = any, P = any> extends SuperContext<B, Q, P> {
+    stream: ExisSSE;
+}
+export interface SseRouteConfig<B = any, Q = any, P = any> extends Omit<RouteConfig<B, Q, P>, 'handle'> {
+    handle: (ctx: SseSuperContext<B, Q, P>) => any | Promise<any>;
+}
+/**
+ * The final built route configuration object.
+ */
+export type RouteDefinition<B = any, Q = any, P = any> = RouteConfig<B, Q, P> & {
+    method: string;
+    path: string;
+};
+/**
+ * Defines a new HTTP route with schema validation and a supercharged execution context.
+ */
+export declare const route: {
+    /** Defines a GET route. */
+    get: <B = any, Q = any, P = any>(path: string, config: RouteConfig<B, Q, P>) => RouteDefinition<B, Q, P>;
+    /** Defines a POST route. */
+    post: <B = any, Q = any, P = any>(path: string, config: RouteConfig<B, Q, P>) => RouteDefinition<B, Q, P>;
+    /** Defines a PUT route. */
+    put: <B = any, Q = any, P = any>(path: string, config: RouteConfig<B, Q, P>) => RouteDefinition<B, Q, P>;
+    /** Defines a DELETE route. */
+    delete: <B = any, Q = any, P = any>(path: string, config: RouteConfig<B, Q, P>) => RouteDefinition<B, Q, P>;
+    /** Defines a PATCH route. */
+    patch: <B = any, Q = any, P = any>(path: string, config: RouteConfig<B, Q, P>) => RouteDefinition<B, Q, P>;
+    /** Defines an OPTIONS route. */
+    options: <B = any, Q = any, P = any>(path: string, config: RouteConfig<B, Q, P>) => RouteDefinition<B, Q, P>;
+    /** Defines a HEAD route. */
+    head: <B = any, Q = any, P = any>(path: string, config: RouteConfig<B, Q, P>) => RouteDefinition<B, Q, P>;
+    /** Defines a CONNECT route. */
+    connect: <B = any, Q = any, P = any>(path: string, config: RouteConfig<B, Q, P>) => RouteDefinition<B, Q, P>;
+    /** Defines a TRACE route. */
+    trace: <B = any, Q = any, P = any>(path: string, config: RouteConfig<B, Q, P>) => RouteDefinition<B, Q, P>;
+    /** Defines a custom QUERY route (e.g., for GraphQL-style operations). */
+    query: <B = any, Q = any, P = any>(path: string, config: RouteConfig<B, Q, P>) => RouteDefinition<B, Q, P>;
+    /** Defines a route that matches ALL HTTP methods. */
+    all: <B = any, Q = any, P = any>(path: string, config: RouteConfig<B, Q, P>) => RouteDefinition<B, Q, P>;
+    /** Defines a WebSocket route. */
+    ws: <B = any, Q = any, P = any>(path: string, config: WsRouteConfig<B, Q, P>) => RouteDefinition<B, Q, P>;
+    /** Defines a Server-Sent Events (SSE) route. */
+    sse: <B = any, Q = any, P = any>(path: string, config: SseRouteConfig<B, Q, P>) => RouteDefinition<B, Q, P>;
+};
+/**
+ * Global configuration options applied to a file-level controller.
+ * Any middleware or CORS settings defined here will automatically wrap all routes in the file.
+ *
+ * @example
+ * export default controller({
+ *   cors: true,
+ *   middleware: [authGuard],
+ *   onError: (err, req, res) => { console.log(err) },
+ *
+ *   myRoute: route.get('/secret', { ... })
+ * })
+ */
+export interface ControllerConfig {
+    cors?: any;
+    middleware?: Handler[];
+    filters?: any | any[];
+    onError?: HookError;
+    onResponse?: HookResponse;
+    [key: string]: any;
+}
+/**
+ * Creates a route controller. This elegantly binds multiple routes together,
+ * sharing middleware and error handling, while drastically reducing boilerplate.
+ *
+ * @example
+ * export default controller({
+ *   cors: true,
+ *   getUsers: route.get('/', {
+ *     handle({ req, res }) {
+ *       return { users: [] }
+ *     }
+ *   })
+ * })
+ */
+export declare function controller<T extends ControllerConfig>(config: T): T & {
+    __isController: true;
+};
+//# sourceMappingURL=route.d.ts.map

package/dist/server/route.d.ts.map

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

package/dist/server/route.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.route = void 0;
+exports.controller = controller;
+/**
+ * Defines a new HTTP route with schema validation and a supercharged execution context.
+ */
+exports.route = {
+    /** Defines a GET route. */
+    get: (path, config) => ({ method: 'get', path, ...config }),
+    /** Defines a POST route. */
+    post: (path, config) => ({ method: 'post', path, ...config }),
+    /** Defines a PUT route. */
+    put: (path, config) => ({ method: 'put', path, ...config }),
+    /** Defines a DELETE route. */
+    delete: (path, config) => ({ method: 'delete', path, ...config }),
+    /** Defines a PATCH route. */
+    patch: (path, config) => ({ method: 'patch', path, ...config }),
+    /** Defines an OPTIONS route. */
+    options: (path, config) => ({ method: 'options', path, ...config }),
+    /** Defines a HEAD route. */
+    head: (path, config) => ({ method: 'head', path, ...config }),
+    /** Defines a CONNECT route. */
+    connect: (path, config) => ({ method: 'connect', path, ...config }),
+    /** Defines a TRACE route. */
+    trace: (path, config) => ({ method: 'trace', path, ...config }),
+    /** Defines a custom QUERY route (e.g., for GraphQL-style operations). */
+    query: (path, config) => ({ method: 'query', path, ...config }),
+    /** Defines a route that matches ALL HTTP methods. */
+    all: (path, config) => ({ method: 'all', path, ...config }),
+    /** Defines a WebSocket route. */
+    ws: (path, config) => ({ method: 'ws', path, ...config }),
+    /** Defines a Server-Sent Events (SSE) route. */
+    sse: (path, config) => ({ method: 'sse', path, ...config }),
+};
+/**
+ * Creates a route controller. This elegantly binds multiple routes together,
+ * sharing middleware and error handling, while drastically reducing boilerplate.
+ *
+ * @example
+ * export default controller({
+ *   cors: true,
+ *   getUsers: route.get('/', {
+ *     handle({ req, res }) {
+ *       return { users: [] }
+ *     }
+ *   })
+ * })
+ */
+function controller(config) {
+    return Object.defineProperty(config, '__isController', {
+        value: true,
+        enumerable: false, // Hide from iteration
+    });
+}
+//# sourceMappingURL=route.js.map

package/dist/server/route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.js","sourceRoot":"","sources":["../../src/server/route.ts"],"names":[],"mappings":";;;AAyNA,gCAOC;AAlHD;;GAEG;AACU,QAAA,KAAK,GAAG;IACnB,2BAA2B;IAC3B,GAAG,EAAE,CACH,IAAY,EACZ,MAA4B,EACF,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;IACnE,4BAA4B;IAC5B,IAAI,EAAE,CACJ,IAAY,EACZ,MAA4B,EACF,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;IACpE,2BAA2B;IAC3B,GAAG,EAAE,CACH,IAAY,EACZ,MAA4B,EACF,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;IACnE,8BAA8B;IAC9B,MAAM,EAAE,CACN,IAAY,EACZ,MAA4B,EACF,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;IACtE,6BAA6B;IAC7B,KAAK,EAAE,CACL,IAAY,EACZ,MAA4B,EACF,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;IACrE,gCAAgC;IAChC,OAAO,EAAE,CACP,IAAY,EACZ,MAA4B,EACF,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;IACvE,4BAA4B;IAC5B,IAAI,EAAE,CACJ,IAAY,EACZ,MAA4B,EACF,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;IACpE,+BAA+B;IAC/B,OAAO,EAAE,CACP,IAAY,EACZ,MAA4B,EACF,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;IACvE,6BAA6B;IAC7B,KAAK,EAAE,CACL,IAAY,EACZ,MAA4B,EACF,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;IACrE,yEAAyE;IACzE,KAAK,EAAE,CACL,IAAY,EACZ,MAA4B,EACF,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;IACrE,qDAAqD;IACrD,GAAG,EAAE,CACH,IAAY,EACZ,MAA4B,EACF,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;IACnE,iCAAiC;IACjC,EAAE,EAAE,CACF,IAAY,EACZ,MAA8B,EACJ,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAI,MAAc,EAAE,CAAC;IAC3E,gDAAgD;IAChD,GAAG,EAAE,CACH,IAAY,EACZ,MAA+B,EACL,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAI,MAAc,EAAE,CAAC;CAC7E,CAAA;AAwBD;;;;;;;;;;;;;GAaG;AACH,SAAgB,UAAU,CACxB,MAAS;IAET,OAAO,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,gBAAgB,EAAE;QACrD,KAAK,EAAE,IAAI;QACX,UAAU,EAAE,KAAK,EAAE,sBAAsB;KAC1C,CAAiC,CAAA;AACpC,CAAC"}

package/dist/server/sse.d.ts

@@ -0,0 +1,16 @@
+import type { ExisResponse } from './response';
+export declare class ExisSSE {
+    private res;
+    private isOpen;
+    constructor(res: ExisResponse);
+    /**
+     * Send a streaming event to the client
+     */
+    send(data: string | Record<string, any>, eventName?: string): void;
+    /**
+     * Close the SSE connection from the server side
+     */
+    close(): void;
+    get connected(): boolean;
+}
+//# sourceMappingURL=sse.d.ts.map

package/dist/server/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/server/sse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,qBAAa,OAAO;IAClB,OAAO,CAAC,GAAG,CAAc;IACzB,OAAO,CAAC,MAAM,CAAO;gBAET,GAAG,EAAE,YAAY;IAiB7B;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM;IAkB3D;;OAEG;IACH,KAAK;IAML,IAAI,SAAS,YAEZ;CACF"}

package/dist/server/sse.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExisSSE = void 0;
+class ExisSSE {
+    constructor(res) {
+        this.isOpen = true;
+        this.res = res;
+        // 1. Set SSE standard headers
+        res.setHeader('Content-Type', 'text/event-stream');
+        res.setHeader('Cache-Control', 'no-cache');
+        res.setHeader('Connection', 'keep-alive');
+        // Optional CORS/X-Accel-Buffering for nginx
+        res.setHeader('X-Accel-Buffering', 'no');
+        // 2. Handle client disconnects gracefully
+        res.raw.on('close', () => {
+            this.isOpen = false;
+        });
+    }
+    /**
+     * Send a streaming event to the client
+     */
+    send(data, eventName) {
+        if (!this.isOpen)
+            return;
+        let payload = '';
+        if (eventName) {
+            payload += `event: ${eventName}\n`;
+        }
+        if (typeof data === 'object') {
+            payload += `data: ${JSON.stringify(data)}\n\n`;
+        }
+        else {
+            payload += `data: ${data}\n\n`;
+        }
+        this.res.raw.write(payload);
+    }
+    /**
+     * Close the SSE connection from the server side
+     */
+    close() {
+        if (!this.isOpen)
+            return;
+        this.isOpen = false;
+        this.res.raw.end();
+    }
+    get connected() {
+        return this.isOpen;
+    }
+}
+exports.ExisSSE = ExisSSE;
+//# sourceMappingURL=sse.js.map

package/dist/server/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../src/server/sse.ts"],"names":[],"mappings":";;;AAEA,MAAa,OAAO;IAIlB,YAAY,GAAiB;QAFrB,WAAM,GAAG,IAAI,CAAA;QAGnB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAA;QAEd,8BAA8B;QAC9B,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,mBAAmB,CAAC,CAAA;QAClD,GAAG,CAAC,SAAS,CAAC,eAAe,EAAE,UAAU,CAAC,CAAA;QAC1C,GAAG,CAAC,SAAS,CAAC,YAAY,EAAE,YAAY,CAAC,CAAA;QAEzC,4CAA4C;QAC5C,GAAG,CAAC,SAAS,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAA;QAExC,0CAA0C;QAC1C,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACvB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAA;QACrB,CAAC,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,IAAkC,EAAE,SAAkB;QACzD,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAM;QAExB,IAAI,OAAO,GAAG,EAAE,CAAA;QAEhB,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,IAAI,UAAU,SAAS,IAAI,CAAA;QACpC,CAAC;QAED,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,IAAI,SAAS,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAA;QAChD,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,SAAS,IAAI,MAAM,CAAA;QAChC,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAC7B,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAM;QACxB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAA;QACnB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAA;IACpB,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;CACF;AAtDD,0BAsDC"}

package/dist/server/uws-adapter.d.ts

@@ -0,0 +1,101 @@
+/**
+ * uWebSockets.js Server Adapter for Exis
+ *
+ * This module provides a high-performance server backend using uWebSockets.js
+ * as a drop-in replacement for Node's native HTTP module. When uWebSockets.js
+ * is installed, Exis will auto-detect and use it for dramatically higher throughput.
+ *
+ * uWebSockets.js bypasses Node's network layer entirely, using optimized C++
+ * for socket handling, I/O batching, and direct V8 memory access.
+ */
+/**
+ * Returns true if uWebSockets.js is available on this platform.
+ */
+export declare function isUwsAvailable(): boolean;
+/**
+ * Returns the uWS module if available.
+ */
+export declare function getUws(): any;
+/**
+ * A lightweight shim that wraps a uWS.HttpRequest to provide the same interface
+ * that ExisRequest expects from Node's IncomingMessage.
+ *
+ * IMPORTANT: uWS HttpRequest is only valid during the initial synchronous callback.
+ * All headers, URL, and method MUST be copied synchronously before any async work.
+ */
+export declare class UwsIncomingMessage {
+    method: string;
+    url: string;
+    headers: Record<string, string | undefined>;
+    socket: {
+        remoteAddress: string;
+        encrypted?: boolean;
+    };
+    complete: boolean;
+    private _listeners;
+    constructor(req: any, res: any);
+    on(event: string, listener: (...args: any[]) => void): this;
+    once(event: string, listener: (...args: any[]) => void): this;
+    off(event: string, listener: (...args: any[]) => void): this;
+    removeAllListeners(event?: string): this;
+    emit(event: string, ...args: any[]): boolean;
+    destroy(): void;
+}
+/**
+ * A lightweight shim that wraps a uWS.HttpResponse to provide the same interface
+ * that ExisResponse expects from Node's ServerResponse.
+ *
+ * Uses uWS cork() for I/O batching — all header and body writes happen in a
+ * single syscall for maximum throughput.
+ */
+export declare class UwsServerResponse {
+    readonly _uwsRes: any;
+    statusCode: number;
+    headersSent: boolean;
+    private _headers;
+    private _aborted;
+    private _listeners;
+    constructor(_uwsRes: any);
+    setHeader(name: string, value: string | number | readonly string[]): void;
+    getHeader(name: string): string | undefined;
+    hasHeader(name: string): boolean;
+    removeHeader(name: string): void;
+    end(data?: any): void;
+    on(event: string, listener: (...args: any[]) => void): this;
+    emit(event: string, ...args: any[]): boolean;
+    assignSocket(): void;
+}
+export declare class UwsWebSocketShim {
+    readonly _uwsWs: any;
+    readyState: number;
+    private _listeners;
+    constructor(_uwsWs: any);
+    send(data: any): void;
+    close(code?: number, data?: string | Buffer): void;
+    terminate(): void;
+    on(event: string, listener: (...args: any[]) => void): this;
+    once(event: string, listener: (...args: any[]) => void): this;
+    off(event: string, listener: (...args: any[]) => void): this;
+    emit(event: string, ...args: any[]): boolean;
+}
+export interface UwsListenToken {
+    token: any;
+    port: number;
+}
+/**
+ * Creates a uWebSockets.js HTTP server that delegates request handling to Exis.
+ *
+ * @param handler - The request handler function (typically App.handleUws)
+ * @param wsHandler - The websocket upgrade handler function (typically App.handleUwsUpgrade)
+ * @param ssl - Optional SSL configuration
+ * @returns The uWS App instance and helper methods
+ */
+export declare function createUwsApp(handler: (req: UwsIncomingMessage, res: UwsServerResponse) => void, wsHandler: (req: UwsIncomingMessage, res: any, context: any) => void, ssl?: {
+    key: string | Buffer;
+    cert: string | Buffer;
+}): {
+    app: any;
+    listen(port: number, host: string, cb: (token: UwsListenToken | null) => void): void;
+    close(token: unknown): void;
+};
+//# sourceMappingURL=uws-adapter.d.ts.map