typeferry 0.6.0

package/dist/server/server.js

@@ -0,0 +1,243 @@
+import * as assert from 'assert';
+import { TypeFerryEvents, Methods, NO_CHANNEL, Presentation, ServerEvents, waitForAll, } from '../utils/index.js';
+import { ClientNode } from './client-node.js';
+import { createMethodProxy } from './create-method-proxy.js';
+import { DefaultMethods } from './default-methods.js';
+import { Method } from './method.js';
+import { ServerChannel } from './server-channel.js';
+import { NodeHonoTransport, RedisTransport, WebSocketTransport, } from './transports/index.js';
+/** Default request-body ceiling retained across the runtime migration. */
+export const DEFAULT_MAX_REQUEST_BODY_SIZE_BYTES = 128 * 1024 * 1024;
+export class Server extends ServerChannel {
+    uuid;
+    httpTransport;
+    webSocketTransport;
+    redisTransport;
+    host = 'localhost';
+    port;
+    requestListener;
+    allowedContextKeys;
+    isAuthEnabled = false;
+    auth;
+    debug = false;
+    rateLimit;
+    maxRequestBodySize;
+    methods = new Map();
+    allClients = new Map();
+    /** Reverse index: userId → connected client nodes for efficient user-level operations */
+    clientsByUserId = new Map();
+    channels = new Map();
+    events = new Map();
+    m;
+    acceptConnections = true;
+    ready = false;
+    shouldAllowChannelSubscribe = async () => true;
+    static ERROR_EVENT = 'error';
+    handlers = {};
+    closePromise;
+    initializeGlobalInstance(globalInstance) {
+        if (globalInstance) {
+            if (global.TypeFerry) {
+                throw new Error('There can only be one instance of TypeFerry.');
+            }
+            global.TypeFerry = this;
+        }
+    }
+    initializeTransports(origins, ws, redis) {
+        this.httpTransport = new NodeHonoTransport(this, origins, this.rateLimit, this.maxRequestBodySize);
+        this.webSocketTransport = new WebSocketTransport(this, origins, ws);
+        this.redisTransport = redis ? new RedisTransport(this, redis) : null;
+    }
+    setupHttpListening() {
+        this.httpTransport.http?.on('error', error => {
+            this.emit(Server.ERROR_EVENT, error);
+        });
+        this.httpTransport.listen(() => {
+            setTimeout(() => this.server.emit(ServerEvents.HTTP_LISTENING), 0);
+        });
+    }
+    constructor({ host = 'localhost', port = 80, debug = false, origins, ws, redis, requestListener, globalInstance = true, allowedContextKeys = [], rateLimit = false, maxRequestBodySize = DEFAULT_MAX_REQUEST_BODY_SIZE_BYTES, } = {}) {
+        super(NO_CHANNEL);
+        this.m = createMethodProxy(this);
+        this.setServer(this);
+        this.createDefaultMethods();
+        this.initializeGlobalInstance(globalInstance);
+        assert.ok(host, 'Invalid Host');
+        assert.ok(port !== undefined && port !== null, 'Invalid Port');
+        this.host = host;
+        this.port = Number(port);
+        this.requestListener = requestListener;
+        this.debug = debug;
+        this.uuid = Presentation.uuid();
+        this.rateLimit = rateLimit;
+        this.maxRequestBodySize = maxRequestBodySize;
+        this.allowedContextKeys = allowedContextKeys;
+        this.initializeTransports(origins, ws, redis);
+        this.setupHttpListening();
+        this.addEvent(TypeFerryEvents.METHOD_REFRESH);
+        this.channels.set(NO_CHANNEL, this);
+        waitForAll(this, [
+            ServerEvents.HTTP_LISTENING,
+            this.redisTransport ? ServerEvents.REDIS_CONNECT : null,
+        ].filter(Boolean))
+            .then(() => {
+            this.ready = true;
+            this.emit(ServerEvents.READY, true);
+        })
+            .catch((error) => {
+            console.error('[TypeFerry] Server readiness timeout:', error.message);
+        });
+    }
+    /**
+     * Resolves when startup transports have emitted their readiness signals.
+     *
+     * Already-ready servers must not retain `READY` listeners because callers
+     * commonly use this as a low-cost guard before request handling.
+     */
+    isReady() {
+        return new Promise(resolve => {
+            if (this.ready) {
+                resolve(true);
+                return;
+            }
+            this.once(ServerEvents.READY, resolve);
+        });
+    }
+    /**
+     * Returns the authoritative Hono application for route registration.
+     */
+    get app() {
+        return this.httpTransport.app;
+    }
+    setAuth({ auth, logIn }) {
+        this.isAuthEnabled = true;
+        this.auth = auth;
+        this.addMethod(Methods.RPC_LOGIN, logIn);
+    }
+    setChannelAuthorization(checker) {
+        this.shouldAllowChannelSubscribe = checker;
+    }
+    close() {
+        this.closePromise ??= this.closeTransports();
+        return this.closePromise;
+    }
+    async closeTransports() {
+        this.allClients.forEach(node => node.close());
+        this.allClients.clear();
+        this.clientsByUserId.clear();
+        this.methods.clear();
+        this.channels.clear();
+        await this.redisTransport?.close();
+        await this.webSocketTransport?.close();
+        await this.httpTransport?.close();
+        delete global.TypeFerry;
+        this.emit(ServerEvents.CLOSED);
+        return true;
+    }
+    static(path, catchAll) {
+        return this.httpTransport.static(path, catchAll);
+    }
+    debugger(...args) {
+        if (this.debug)
+            console.debug(...args);
+    }
+    async call(method, parameters) {
+        this.debugger(`[server] Calling ${method}`, parameters);
+        const methodInstance = this.methods.get(method);
+        const node = new ClientNode(this);
+        node.isServer = true;
+        return await methodInstance.exec(parameters, node);
+    }
+    createDefaultMethods() {
+        Object.entries(DefaultMethods).forEach(([key, value]) => this.methods.set(key, value(this, key)));
+    }
+    getMethod(method) {
+        return this.methods.get(method);
+    }
+    addClient(node) {
+        this.allClients.set(node.uuid, node);
+    }
+    deleteClient(node) {
+        this.allClients.delete(node.uuid);
+        this.removeClientFromUserIndex(node);
+        if (node.socket) {
+            this.webSocketTransport?.rooms?.leaveAll(node.socket);
+        }
+    }
+    /** Registers a client node in the userId reverse index */
+    indexClientByUserId(node) {
+        if (!node.userId)
+            return;
+        const userId = String(node.userId);
+        let nodes = this.clientsByUserId.get(userId);
+        if (!nodes) {
+            nodes = new Set();
+            this.clientsByUserId.set(userId, nodes);
+        }
+        nodes.add(node);
+    }
+    /** Removes a client node from the userId reverse index */
+    removeClientFromUserIndex(node) {
+        if (!node.userId)
+            return;
+        const userId = String(node.userId);
+        const nodes = this.clientsByUserId.get(userId);
+        if (!nodes)
+            return;
+        nodes.delete(node);
+        if (nodes.size === 0) {
+            this.clientsByUserId.delete(userId);
+        }
+    }
+    /** Returns all connected client nodes for a given userId */
+    getClientsByUserId(userId) {
+        return this.clientsByUserId.get(userId) ?? new Set();
+    }
+    /**
+     * Disconnects all WebSocket clients for a userId.
+     * Used during session revocation to enforce immediate logout.
+     * @returns Number of clients disconnected
+     */
+    disconnectUser(userId, exceptNodeUuid) {
+        const nodes = this.clientsByUserId.get(userId);
+        if (!nodes)
+            return 0;
+        /** Snapshot to avoid mutating the Set during iteration (close → deleteClient) */
+        const snapshot = [...nodes];
+        let count = 0;
+        for (const node of snapshot) {
+            if (node.uuid === exceptNodeUuid)
+                continue;
+            node.close();
+            count++;
+        }
+        this.emit(ServerEvents.USER_DISCONNECTED, { userId, count });
+        return count;
+    }
+    addMethod(method, fn, opts) {
+        this.methods.set(method, new Method(this, method, fn, opts));
+    }
+    channel(name = NO_CHANNEL) {
+        if (name != null &&
+            typeof name === 'object' &&
+            name.constructor.name === 'ObjectId' &&
+            typeof name.toString === 'function') {
+            name = name.toString();
+        }
+        if (!name || typeof name !== 'string')
+            return this;
+        if (name === NO_CHANNEL)
+            return this;
+        const channelName = name;
+        if (this.channels.has(channelName))
+            return this.channels.get(channelName);
+        const channel = new ServerChannel(channelName);
+        channel.setServer(this.server);
+        this.channels.set(channelName, channel);
+        return channel;
+    }
+}
+export function createServer(options) {
+    return new Server(options);
+}
+//# sourceMappingURL=server.js.map

package/dist/server/server.js.map

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

package/dist/server/transports/hono-rate-limit.d.ts

@@ -0,0 +1,15 @@
+import type { MiddlewareHandler } from 'hono';
+interface RateLimitOptions {
+    windowMs: number;
+    max: number;
+}
+/** Hono middleware whose cleanup timer follows its owning transport lifecycle. */
+export type DisposableRateLimiter = MiddlewareHandler & {
+    close(): void;
+};
+/**
+ * Simple sliding-window IP rate limiter for Hono.
+ * Applies per-client HTTP RPC limits within Hono.
+ */
+export declare function rateLimiter(opts: RateLimitOptions): DisposableRateLimiter;
+export {};

package/dist/server/transports/hono-rate-limit.js

@@ -0,0 +1,36 @@
+/**
+ * Simple sliding-window IP rate limiter for Hono.
+ * Applies per-client HTTP RPC limits within Hono.
+ */
+export function rateLimiter(opts) {
+    const store = new Map();
+    const cleanupTimer = setInterval(() => {
+        const now = Date.now();
+        for (const [key, entry] of store) {
+            if (entry.resetAt <= now)
+                store.delete(key);
+        }
+    }, opts.windowMs);
+    // A limiter must never keep an otherwise-closed Node process alive.
+    cleanupTimer.unref();
+    const middleware = async (c, next) => {
+        const ip = c.req.header('x-forwarded-for') ?? '127.0.0.1';
+        const now = Date.now();
+        let entry = store.get(ip);
+        if (!entry || entry.resetAt <= now) {
+            entry = { count: 0, resetAt: now + opts.windowMs };
+            store.set(ip, entry);
+        }
+        entry.count++;
+        if (entry.count > opts.max) {
+            return c.text('Too Many Requests', 429);
+        }
+        await next();
+    };
+    middleware.close = () => {
+        clearInterval(cleanupTimer);
+        store.clear();
+    };
+    return middleware;
+}
+//# sourceMappingURL=hono-rate-limit.js.map

package/dist/server/transports/hono-rate-limit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hono-rate-limit.js","sourceRoot":"","sources":["../../../src/server/transports/hono-rate-limit.ts"],"names":[],"mappings":"AAiBA;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,IAAsB;IAChD,MAAM,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAA;IAE/C,MAAM,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE;QACpC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACtB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,KAAK,EAAE,CAAC;YACjC,IAAI,KAAK,CAAC,OAAO,IAAI,GAAG;gBAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAC7C,CAAC;IACH,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAA;IACjB,oEAAoE;IACpE,YAAY,CAAC,KAAK,EAAE,CAAA;IAEpB,MAAM,UAAU,GAA0B,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE;QAC1D,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,iBAAiB,CAAC,IAAI,WAAW,CAAA;QACzD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAEtB,IAAI,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACzB,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,IAAI,GAAG,EAAE,CAAC;YACnC,KAAK,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAA;YAClD,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;QACtB,CAAC;QAED,KAAK,CAAC,KAAK,EAAE,CAAA;QAEb,IAAI,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC3B,OAAO,CAAC,CAAC,IAAI,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAA;QACzC,CAAC;QAED,MAAM,IAAI,EAAE,CAAA;IACd,CAAC,CAAA;IAED,UAAU,CAAC,KAAK,GAAG,GAAS,EAAE;QAC5B,aAAa,CAAC,YAAY,CAAC,CAAA;QAC3B,KAAK,CAAC,KAAK,EAAE,CAAA;IACf,CAAC,CAAA;IAED,OAAO,UAAU,CAAA;AACnB,CAAC"}

package/dist/server/transports/index.d.ts

@@ -0,0 +1,4 @@
+export * from './node-hono-transport.js';
+export * from './node-hono-transport-contract.js';
+export * from './redis-transport.js';
+export * from './websocket-transport.js';

package/dist/server/transports/index.js

@@ -0,0 +1,5 @@
+export * from './node-hono-transport.js';
+export * from './node-hono-transport-contract.js';
+export * from './redis-transport.js';
+export * from './websocket-transport.js';
+//# sourceMappingURL=index.js.map

package/dist/server/transports/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/transports/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA;AACrC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,mBAAmB,CAAA;AACjC,cAAc,uBAAuB,CAAA"}

package/dist/server/transports/node-hono-transport-contract.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Lifecycle events emitted by the Node/Hono HTTP transport.
+ */
+export declare enum HttpTransportEvents {
+    HTTP_LISTENING = "http:listening",
+    HTTP_SERVER_ERROR = "http:server:error",
+    HTTP_SERVER_CLOSED = "http:server:closed"
+}
+/**
+ * Retryable response returned while application traffic is gated.
+ */
+export declare const SERVER_NOT_READY_RESPONSE: {
+    readonly body: "Server Not Ready";
+    readonly retryAfterSeconds: 1;
+    readonly status: 503;
+};

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

@@ -0,0 +1,18 @@
+/**
+ * Lifecycle events emitted by the Node/Hono HTTP transport.
+ */
+export var HttpTransportEvents;
+(function (HttpTransportEvents) {
+    HttpTransportEvents["HTTP_LISTENING"] = "http:listening";
+    HttpTransportEvents["HTTP_SERVER_ERROR"] = "http:server:error";
+    HttpTransportEvents["HTTP_SERVER_CLOSED"] = "http:server:closed";
+})(HttpTransportEvents || (HttpTransportEvents = {}));
+/**
+ * Retryable response returned while application traffic is gated.
+ */
+export const SERVER_NOT_READY_RESPONSE = {
+    body: 'Server Not Ready',
+    retryAfterSeconds: 1,
+    status: 503,
+};
+//# sourceMappingURL=node-hono-transport-contract.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"node-hono-transport-contract.js","sourceRoot":"","sources":["../../../src/server/transports/node-hono-transport-contract.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAN,IAAY,mBAIX;AAJD,WAAY,mBAAmB;IAC7B,wDAAiC,CAAA;IACjC,8DAAuC,CAAA;IACvC,gEAAyC,CAAA;AAC3C,CAAC,EAJW,mBAAmB,KAAnB,mBAAmB,QAI9B;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,IAAI,EAAE,kBAAkB;IACxB,iBAAiB,EAAE,CAAC;IACpB,MAAM,EAAE,GAAG;CACH,CAAA"}

package/dist/server/transports/node-hono-transport.d.ts

@@ -0,0 +1,47 @@
+import type { MiddlewareHandler } from 'hono';
+import { Hono } from 'hono';
+import { type Server as NodeHttpServer } from 'node:http';
+import type { RateLimit, Server } from '../server.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 declare class NodeHonoTransport {
+    server: Server;
+    app: Hono;
+    http?: NodeHttpServer;
+    private httpRateLimiter?;
+    constructor(server: Server, origins: string[] | undefined, limit: RateLimit, maxRequestBodySize: number);
+    /**
+     * 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.
+     */
+    private dispatchObservedRequest;
+    /** Creates an IncomingMessage-compatible stream with immutable request metadata. */
+    private createRequestMirror;
+    private setupMiddleware;
+    private handleFetch;
+    /** Starts the listener after all protocol transports have attached. */
+    listen(onListening: () => void): void;
+    private handleRpc;
+    private dispatchRpc;
+    /** Hono middleware that requires authentication. Returns 403 on failure. */
+    authMiddleware: MiddlewareHandler;
+    /** Hono middleware that loads context without requiring auth. */
+    contextMiddleware: MiddlewareHandler;
+    private buildTypeFerryRequest;
+    private buildTypeFerryResponse;
+    private buildClientNodeFromContext;
+    private buildClientNode;
+    private getServerContext;
+    private parseTransport;
+    private rpcError;
+    private rpcSuccess;
+    private handleRpcError;
+    /** Registers a static root and optional single-page application fallback. */
+    static(path: string, catchAll: boolean): void;
+    close(): Promise<void>;
+}