typeferry 0.6.0

package/dist/server/transports/node-hono-transport.js

@@ -0,0 +1,327 @@
+import { getConnInfo } from '@hono/node-server/conninfo';
+import { getRequestListener } from '@hono/node-server';
+import { serveStatic } from '@hono/node-server/serve-static';
+import { Hono } from 'hono';
+import { bodyLimit } from 'hono/body-limit';
+import { cors } from 'hono/cors';
+import { createServer, } from 'node:http';
+import { PassThrough } from 'node:stream';
+import { EJSON } from '../../ejson/index.js';
+import { CLIENT_ID_HEADER_KEY, Errors, PayloadType, Presentation, PublicError, SchemaValidationError, ServerEvents, TOKEN_HEADER_KEY, } from '../../utils/index.js';
+import { ClientNode } from '../client-node.js';
+import { redactMethodTelemetry } from '../method.js';
+import { rateLimiter } from './hono-rate-limit.js';
+import { HttpTransportEvents, SERVER_NOT_READY_RESPONSE, } from './node-hono-transport-contract.js';
+/**
+ * Node.js HTTP transport backed by a Hono application.
+ *
+ * The adapter server is created without listening so the WebSocket transport
+ * can attach its upgrade handler before the listener accepts traffic.
+ */
+export class NodeHonoTransport {
+    server;
+    app;
+    http;
+    httpRateLimiter;
+    constructor(server, origins, limit, maxRequestBodySize) {
+        this.server = server;
+        this.app = new Hono();
+        this.setupMiddleware(origins, limit, maxRequestBodySize);
+        const honoListener = getRequestListener((request, env) => this.handleFetch(request, env));
+        this.http = createServer((request, response) => {
+            if (!this.server.requestListener) {
+                void honoListener(request, response);
+                return;
+            }
+            this.dispatchObservedRequest(request, response, honoListener);
+        });
+    }
+    /**
+     * Tees a request without allowing an optional observer to control Hono's
+     * backpressure. Header-only observers receive metadata and completion without
+     * buffering the body; body observers receive the same chunks synchronously.
+     */
+    dispatchObservedRequest(request, response, honoListener) {
+        const honoRequest = this.createRequestMirror(request);
+        const observerRequest = this.createRequestMirror(request);
+        void honoListener(honoRequest, response);
+        this.server.requestListener(observerRequest, response);
+        request.on('data', (chunk) => {
+            if (!honoRequest.write(chunk))
+                request.pause();
+            if (observerRequest.listenerCount('data') > 0 &&
+                !observerRequest.destroyed) {
+                // Emit observational chunks synchronously without writing them into the
+                // mirror's internal buffer. Pausing an observer therefore cannot retain
+                // or backpressure the authoritative Hono body stream.
+                observerRequest.emit('data', chunk);
+            }
+        });
+        honoRequest.on('drain', () => request.resume());
+        request.once('end', () => {
+            honoRequest.end();
+            observerRequest.end();
+        });
+        request.once('error', error => {
+            honoRequest.destroy(error);
+            observerRequest.destroy(error);
+        });
+    }
+    /** Creates an IncomingMessage-compatible stream with immutable request metadata. */
+    createRequestMirror(request) {
+        const mirror = new PassThrough();
+        Object.assign(mirror, {
+            headers: request.headers,
+            httpVersion: request.httpVersion,
+            method: request.method,
+            rawHeaders: request.rawHeaders,
+            socket: request.socket,
+            trailers: request.trailers,
+            url: request.url,
+        });
+        return mirror;
+    }
+    // ---------------------------------------------------------------------------
+    // Middleware setup
+    // ---------------------------------------------------------------------------
+    setupMiddleware(origins, limit, maxRequestBodySize) {
+        this.app.use('*', bodyLimit({
+            maxSize: maxRequestBodySize,
+            onError: c => c.text('Request Entity Too Large', 413),
+        }));
+        if (origins?.length) {
+            this.app.use('*', cors({
+                origin: (origin) => origins.includes(origin) ? origin : null,
+                credentials: true,
+            }));
+        }
+        if (limit) {
+            const opts = limit === true
+                ? { windowMs: 60_000, max: 120 }
+                : { windowMs: limit.interval, max: limit.max };
+            this.httpRateLimiter = rateLimiter(opts);
+            this.app.use('/__h', this.httpRateLimiter);
+        }
+        this.app.post('/__h', c => this.handleRpc(c));
+    }
+    // ---------------------------------------------------------------------------
+    // Fetch handler
+    // ---------------------------------------------------------------------------
+    handleFetch(req, env) {
+        if (!this.server.acceptConnections) {
+            return new Response(SERVER_NOT_READY_RESPONSE.body, {
+                status: SERVER_NOT_READY_RESPONSE.status,
+                headers: {
+                    'Retry-After': String(SERVER_NOT_READY_RESPONSE.retryAfterSeconds),
+                },
+            });
+        }
+        return this.app.fetch(req, env);
+    }
+    /** Starts the listener after all protocol transports have attached. */
+    listen(onListening) {
+        this.http?.listen(this.server.port, this.server.host, () => {
+            const address = this.http?.address();
+            if (address)
+                this.server.port = address.port;
+            onListening();
+        });
+    }
+    // ---------------------------------------------------------------------------
+    // TypeFerry RPC handler
+    // ---------------------------------------------------------------------------
+    async handleRpc(c) {
+        const body = await c.req.text();
+        const transport = this.parseTransport(body);
+        if (!transport.payload) {
+            return c.text(Presentation.encode({
+                type: PayloadType.ERROR,
+                message: Errors.INVALID_REQUEST,
+            }));
+        }
+        return this.dispatchRpc(c, {
+            payload: transport.payload,
+            context: transport.context,
+        });
+    }
+    async dispatchRpc(c, transport) {
+        const { payload } = transport;
+        const method = this.server.getMethod(payload.method);
+        if (!method) {
+            return this.rpcError(c, Errors.METHOD_NOT_FOUND, {
+                method: payload.method,
+            });
+        }
+        const clientNode = await this.buildClientNode(c, transport.context);
+        if (method.isProtected && !clientNode.authenticated) {
+            return this.rpcError(c, Errors.METHOD_FORBIDDEN, {
+                method: payload.method,
+            });
+        }
+        try {
+            const result = await method.exec(payload.params, clientNode);
+            return this.rpcSuccess(c, result, payload);
+        }
+        catch (error) {
+            return this.handleRpcError(c, error, payload, clientNode, method);
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Auth middleware (exposed for route files)
+    // ---------------------------------------------------------------------------
+    /** Hono middleware that requires authentication. Returns 403 on failure. */
+    authMiddleware = async (c, next) => {
+        const clientNode = this.buildClientNodeFromContext(c);
+        const ctx = await this.getServerContext(clientNode);
+        if (ctx === false) {
+            return c.text('403 Forbidden', 403);
+        }
+        c.set('context', ctx);
+        await next();
+    };
+    /** Hono middleware that loads context without requiring auth. */
+    contextMiddleware = async (c, next) => {
+        const clientNode = this.buildClientNodeFromContext(c);
+        c.set('context', await this.getServerContext(clientNode));
+        await next();
+    };
+    // ---------------------------------------------------------------------------
+    // Helpers
+    // ---------------------------------------------------------------------------
+    buildTypeFerryRequest(c) {
+        return {
+            headers: Object.fromEntries(c.req.raw.headers.entries()),
+            ip: c.req.header('x-forwarded-for') ?? getConnInfo(c).remote.address,
+            path: c.req.path,
+            get: (name) => c.req.header(name),
+        };
+    }
+    buildTypeFerryResponse(c) {
+        return {
+            setHeader: (name, value) => {
+                c.header(name, value, {
+                    append: name.toLowerCase() === 'set-cookie',
+                });
+            },
+        };
+    }
+    buildClientNodeFromContext(c) {
+        const req = this.buildTypeFerryRequest(c);
+        const res = this.buildTypeFerryResponse(c);
+        const node = new ClientNode(this.server, null, req, res);
+        node.setTrackingProperties(req);
+        return node;
+    }
+    async buildClientNode(c, context) {
+        const node = this.buildClientNodeFromContext(c);
+        node.uuid = c.req.header(CLIENT_ID_HEADER_KEY) ?? '';
+        const serverContext = await this.getServerContext(node, (context ?? {}));
+        node.authenticated = Boolean(serverContext);
+        node.setContext(serverContext);
+        return node;
+    }
+    async getServerContext(clientNode, context = {}) {
+        const token = clientNode.req?.headers?.[TOKEN_HEADER_KEY];
+        if (typeof token === 'string' && token.length && token !== 'undefined') {
+            context.token = token.replace('Bearer ', '');
+        }
+        if (this.server.auth instanceof Function) {
+            let result = this.server.auth.call(clientNode, context ?? {});
+            result = result instanceof Promise ? await result : result;
+            return result;
+        }
+        return false;
+    }
+    parseTransport(body) {
+        if (!body)
+            return { context: null };
+        try {
+            return EJSON.parse(body);
+        }
+        catch {
+            return { context: null };
+        }
+    }
+    rpcError(c, message, extra) {
+        const payload = {
+            type: PayloadType.ERROR,
+            message,
+            ...extra,
+        };
+        return c.text(Presentation.encode(payload));
+    }
+    rpcSuccess(c, result, payload) {
+        return c.text(Presentation.encode({
+            type: PayloadType.RESULT,
+            uuid: payload.uuid,
+            method: payload.method,
+            result,
+        }));
+    }
+    handleRpcError(c, error, payload, clientNode, method) {
+        if (error instanceof PublicError) {
+            if (payload.void)
+                return c.text('', 200);
+            return this.rpcError(c, error.message, payload.uuid ? { uuid: payload.uuid } : undefined);
+        }
+        if (method.isSensitive) {
+            console.error(`[TypeFerry] Sensitive method "${String(payload.method)}" failed`);
+        }
+        else {
+            console.error(error);
+        }
+        this.server.emit(ServerEvents.METHOD_ERROR, {
+            error: redactMethodTelemetry(method, error),
+            method: payload.method,
+            params: redactMethodTelemetry(method, payload.params),
+            userId: clientNode.userId,
+            userEmail: clientNode.context?.user?.email,
+            remoteAddress: clientNode.remoteAddress,
+            userAgent: clientNode.userAgent,
+        });
+        if (payload.void)
+            return c.text('', 200);
+        if (error instanceof SchemaValidationError) {
+            const p = {
+                type: PayloadType.ERROR,
+                message: error.message,
+                errors: error.errors,
+            };
+            if (payload.uuid)
+                p.uuid = payload.uuid;
+            return c.text(Presentation.encode(p));
+        }
+        return this.rpcError(c, Errors.INTERNAL_ERROR, payload.uuid ? { uuid: payload.uuid } : undefined);
+    }
+    /** Registers a static root and optional single-page application fallback. */
+    static(path, catchAll) {
+        this.app.use('*', serveStatic({ root: path }));
+        if (catchAll) {
+            this.app.get('*', serveStatic({ path: `${path}/index.html` }));
+        }
+    }
+    async close() {
+        this.httpRateLimiter?.close();
+        this.httpRateLimiter = undefined;
+        const http = this.http;
+        this.http = undefined;
+        if (!http) {
+            this.server.emit(HttpTransportEvents.HTTP_SERVER_CLOSED);
+            return;
+        }
+        http.closeAllConnections();
+        await new Promise((resolve, reject) => {
+            http.close(error => {
+                if (error &&
+                    error.code !== 'ERR_SERVER_NOT_RUNNING') {
+                    reject(error);
+                    return;
+                }
+                http.unref();
+                resolve();
+            });
+        });
+        this.server.emit(HttpTransportEvents.HTTP_SERVER_CLOSED);
+    }
+}
+//# sourceMappingURL=node-hono-transport.js.map

package/dist/server/transports/node-hono-transport.js.map

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

package/dist/server/transports/redis-transport.d.ts

@@ -0,0 +1,34 @@
+import type { RedisClientOptions } from 'redis';
+import type { Server } from '../server.js';
+export type RedisMessage = {
+    event: string;
+    channel: string;
+    message: string;
+    excludeUuid?: string;
+};
+export declare const RedisKey: {
+    CLIENTS: string;
+};
+/**
+ * This is mainly used to propagate events to other instances when running node in a cluster.
+ */
+export declare class RedisTransport {
+    opts: RedisClientOptions;
+    pub: any;
+    sub: any;
+    server: Server;
+    static defaultRedisOpts: RedisClientOptions;
+    constructor(server: Server, opts: RedisClientOptions | boolean);
+    private connect;
+    /**
+     * Publishes an event to the Redis channel for cluster-wide propagation.
+     * @param excludeUuid - Optional client uuid to exclude from receiving the event
+     */
+    publish(event: string, channel: string, message: string, excludeUuid?: string): Promise<any>;
+    close(): Promise<void>;
+    getStats(): Promise<{
+        clientCount: number;
+        userCount: number;
+        users: unknown[];
+    }>;
+}

package/dist/server/transports/redis-transport.js

@@ -0,0 +1,84 @@
+import { createClient } from 'redis';
+import { NO_CHANNEL, Presentation, RedisListeners, ServerEvents, } from '../../utils/index.js';
+export const RedisKey = {
+    CLIENTS: 'typeferry:clients',
+};
+/**
+ * This is mainly used to propagate events to other instances when running node in a cluster.
+ */
+export class RedisTransport {
+    opts;
+    pub;
+    sub;
+    server;
+    static defaultRedisOpts = {
+        url: process.env.REDIS_URL ?? 'redis://localhost:6379',
+    };
+    constructor(server, opts) {
+        this.server = server;
+        this.opts = Object.assign({}, RedisTransport.defaultRedisOpts, opts);
+        this.connect().catch(console.error);
+    }
+    async connect() {
+        this.pub = createClient({
+            ...RedisTransport.defaultRedisOpts,
+            ...this.opts,
+        });
+        this.sub = this.pub.duplicate();
+        await this.pub.connect();
+        await this.sub.connect();
+        await this.sub.pSubscribe(RedisListeners.EVENTS, redisMessage => {
+            const { event, channel, message, excludeUuid } = Presentation.decode(redisMessage);
+            // Do not add a debugger here, it will cause an infinite loop since it
+            // triggers an event this also goes through the transport.
+            this.server.channel(channel).propagate(event, message, excludeUuid);
+        });
+        this.server.emit(ServerEvents.REDIS_CONNECT);
+    }
+    /**
+     * Publishes an event to the Redis channel for cluster-wide propagation.
+     * @param excludeUuid - Optional client uuid to exclude from receiving the event
+     */
+    async publish(event, channel = NO_CHANNEL, message, excludeUuid) {
+        if (!this.pub)
+            return;
+        // Do not add a debugger here, it will cause an infinite loop since it
+        // triggers an event this also goes through the transport.
+        return this.pub.publish(RedisListeners.EVENTS, Presentation.encode({
+            event,
+            channel,
+            message,
+            excludeUuid,
+        }));
+    }
+    async close() {
+        if (this.pub) {
+            await this.pub.del(`typeferry:clients:${this.server.uuid}`);
+            await this.pub.sRem(`typeferry:servers`, this.server.uuid);
+        }
+        if (this.pub?.isOpen)
+            await this.pub.quit();
+        if (this.sub?.isOpen)
+            await this.sub.quit();
+        this.pub = undefined;
+        this.sub = undefined;
+    }
+    async getStats() {
+        let clientCount = 0;
+        let userCount = 0;
+        const users = new Set();
+        const servers = await this.pub.sMembers(`typeferry:servers`);
+        for (const server of servers) {
+            clientCount += await this.pub.sCard(`typeferry:clients:${server}`);
+            userCount += await this.pub.sCard(`typeferry:users:${server}`);
+            const serverUsers = await this.pub.sMembers(`typeferry:users:${server}`);
+            serverUsers.forEach(user => users.add(user));
+        }
+        return {
+            clientCount,
+            userCount,
+            users: Array.from(users),
+        };
+    }
+}
+//# sourceMappingURL=redis-transport.js.map

package/dist/server/transports/redis-transport.js.map

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

package/dist/server/transports/websocket-transport.d.ts

@@ -0,0 +1,42 @@
+import { WebSocketServer } from 'ws';
+import { RoomRegistry } from '../room-registry.js';
+import type { Server } from '../server.js';
+import { type WebSocketHandshakeAuthenticator } from './ws-shared.js';
+export type { WebSocketHandshake, WebSocketHandshakeAuthenticator, } from './ws-shared.js';
+export declare enum WebSocketTransportEvents {
+    WEBSOCKET_SERVER_ERROR = "websocket:server:error"
+}
+export interface WebSocketTransportOptions {
+    path?: string;
+    /**
+     * Application-owned handshake auth; rejection never falls back to token auth.
+     */
+    handshakeAuthenticator?: WebSocketHandshakeAuthenticator;
+    cors?: {
+        credentials?: boolean;
+        origin?: string | string[];
+    };
+}
+/**
+ * Node.js WebSocket transport using the `ws` package.
+ */
+export declare class WebSocketTransport {
+    server: Server;
+    wss: WebSocketServer;
+    rooms: RoomRegistry;
+    private path;
+    private origins;
+    private handshakeAuthenticator?;
+    private pingTimers;
+    private pongReceived;
+    constructor(server: Server, origins: string[] | undefined, opts?: WebSocketTransportOptions);
+    private attachUpgradeHandler;
+    /** Flushes the HTTP rejection and then closes both halves of the raw socket. */
+    private rejectUpgrade;
+    private validateOrigin;
+    private handleConnection;
+    private handleMessage;
+    private startPing;
+    private stopPing;
+    close(): Promise<void>;
+}