typeferry 0.6.0

package/dist/server/method.js

@@ -0,0 +1,113 @@
+import perf_hooks from 'perf_hooks';
+import { isEmpty } from '../utils/lodash.js';
+import { EJSON } from '../ejson/index.js';
+import { Errors, intercept, Presentation, SchemaValidationError, ServerEvents, } from '../utils/index.js';
+import { TypeFerryAsyncLocalStorage } from './typeferry-async-local-storage.js';
+/** Stable marker used when sensitive method telemetry is intentionally hidden. */
+export const REDACTED_METHOD_TELEMETRY = '[REDACTED]';
+/** Returns a method telemetry field with the configured sensitivity applied. */
+export function redactMethodTelemetry(method, value) {
+    return method.isSensitive ? REDACTED_METHOD_TELEMETRY : value;
+}
+function customMemoize(fn, options = {}) {
+    const cache = new Map();
+    const { maxAge = 60000 } = options;
+    return function (...args) {
+        const key = EJSON.stringify(args[0]); // Normalize first argument (params)
+        const now = Date.now();
+        const cached = cache.get(key);
+        if (cached && now - cached.timestamp < maxAge) {
+            return cached.value;
+        }
+        const result = fn.apply(this, args);
+        cache.set(key, { value: result, timestamp: now });
+        return result;
+    };
+}
+/**
+ * Represents a registered TypeFerry RPC method with validation and middleware support.
+ *
+ * Methods are the core RPC primitives in TypeFerry. Each method can have:
+ * - Input validation via Zod schemas
+ * - Middleware chain for authentication/authorization
+ * - Result caching with configurable TTL
+ * - Execution time tracking
+ *
+ * @typeParam Schema - The Zod schema type for input validation
+ * @typeParam Result - The return type of the method
+ */
+export class Method {
+    uuid;
+    fn;
+    isProtected;
+    isSensitive;
+    middleware;
+    schema = null;
+    name;
+    server;
+    constructor(server, name, fn, opts) {
+        const { cache, maxAge = 60000, schema } = opts ?? {};
+        this.server = server;
+        this.name = name;
+        this.uuid = Presentation.uuid();
+        this.isProtected = opts?.protected;
+        this.isSensitive = opts?.sensitive ?? false;
+        this.middleware = opts?.middleware;
+        this.fn = cache ? customMemoize(fn, { maxAge }) : fn;
+        this.schema = schema;
+    }
+    /**
+     * Executes the middleware chain, passing params through each middleware.
+     * Each middleware can transform or augment the params before passing to the next.
+     */
+    async runMiddleware(parameters, node) {
+        if (isEmpty(this.middleware))
+            return parameters;
+        const wrapped = this.middleware.map((m) => intercept(m));
+        let buffer = parameters;
+        for (const step of wrapped) {
+            buffer = await step.call(node, buffer);
+        }
+        return buffer;
+    }
+    /**
+     * Executes the method with validation, middleware, and timing.
+     *
+     * Execution flow:
+     * 1. Validate params against Zod schema (if provided)
+     * 2. Run middleware chain
+     * 3. Execute method handler
+     * 4. Emit execution event with timing data
+     *
+     * @throws {SchemaValidationError} When params fail Zod validation
+     */
+    async exec(parameters, node) {
+        const start = perf_hooks.performance.now();
+        let cleanParameters = parameters;
+        if (this.schema) {
+            // Normalize undefined/null params to empty object for schema validation.
+            // This allows methods with all-optional fields to be called without params.
+            const parametersToValidate = parameters ?? {};
+            const result = this.schema.safeParse(parametersToValidate);
+            if (!result.success) {
+                const errorMessages = result.error.issues.map((issue) => `${issue.path.join('.')}: ${issue.message}`);
+                console.error(`Schema validation failed for ${this.name}:`, errorMessages);
+                throw new SchemaValidationError(`${Errors.INVALID_PARAMS}: ${errorMessages.join(', ')}`, errorMessages);
+            }
+            cleanParameters = result.data;
+        }
+        const result = await TypeFerryAsyncLocalStorage.run({ executionId: Presentation.uuid(), context: node.context }, async () => {
+            const middlewareResult = await this.runMiddleware(cleanParameters, node);
+            return this.fn.call(node, middlewareResult);
+        });
+        const end = perf_hooks.performance.now();
+        this.server.emit(ServerEvents.METHOD_EXECUTION, {
+            method: this.name,
+            time: end - start,
+            params: redactMethodTelemetry(this, cleanParameters),
+            result: redactMethodTelemetry(this, result),
+        });
+        return result;
+    }
+}
+//# sourceMappingURL=method.js.map

package/dist/server/method.js.map

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

package/dist/server/methods.d.ts

@@ -0,0 +1,11 @@
+import type { z } from 'zod';
+import { Method } from './method.js';
+import { Server } from './server.js';
+/**
+ * Generates a room name for a channel/event subscription.
+ * Format: `typeferry:${channel}:${event}`
+ */
+export declare function getRoomName(channel: string, eventName: string): string;
+export declare const rpcOff: (server: Server, method: string) => Method<z.ZodType, unknown>;
+export declare const rpcOn: (server: Server, method: string) => Method<z.ZodType, unknown>;
+export declare const rpcLogout: (server: Server, method: string) => Method<z.ZodType, unknown>;

package/dist/server/methods.js

@@ -0,0 +1,74 @@
+import { isEmpty } from '../utils/lodash.js';
+import { NO_CHANNEL, ServerEvents } from '../utils/index.js';
+import { Method } from './method.js';
+import { Server } from './server.js';
+/**
+ * Generates a room name for a channel/event subscription.
+ * Format: `typeferry:${channel}:${event}`
+ */
+export function getRoomName(channel, eventName) {
+    return `typeferry:${channel}:${eventName}`;
+}
+export const rpcOff = (server, method) => new Method(server, method, function ({ events, channel = NO_CHANNEL }) {
+    if (!this.socket)
+        return {};
+    const rooms = server.webSocketTransport?.rooms;
+    if (!rooms)
+        return {};
+    return events.reduce((acc, eventName) => {
+        const event = server.events.get(eventName);
+        if (!event) {
+            console.log('[TypeFerry] Event Not Found:', eventName);
+            return { ...acc, [eventName]: false };
+        }
+        const roomName = getRoomName(channel, eventName);
+        rooms.leave(this.socket, roomName);
+        return { ...acc, [eventName]: true };
+    }, {});
+}, { protected: false });
+/**
+ * Checks if a client can subscribe to an event and joins the room.
+ */
+async function canSubscribeToEvent(server, client, eventName, channel) {
+    const event = server.events.get(eventName);
+    if (!event) {
+        console.log('[TypeFerry] Event Not Found:', eventName);
+        return false;
+    }
+    const eventAllowed = !event.isProtected || client.authenticated;
+    if (!eventAllowed)
+        return false;
+    const subscribeAllowed = await event.shouldSubscribe(client, eventName, channel);
+    if (!subscribeAllowed)
+        return false;
+    if (!client.socket)
+        return false;
+    const rooms = server.webSocketTransport?.rooms;
+    if (!rooms)
+        return false;
+    const roomName = getRoomName(channel, eventName);
+    rooms.join(client.socket, roomName);
+    return true;
+}
+export const rpcOn = (server, method) => new Method(server, method, async function ({ events, channel = NO_CHANNEL }) {
+    if (isEmpty(events))
+        return {};
+    const channelAllowed = await server.shouldAllowChannelSubscribe(this, channel);
+    const acc = {};
+    for (const eventName of events) {
+        if (!channelAllowed) {
+            acc[eventName] = false;
+            continue;
+        }
+        acc[eventName] = await canSubscribeToEvent(server, this, eventName, channel);
+    }
+    return acc;
+}, { protected: false });
+export const rpcLogout = (server, method) => new Method(server, method, async function () {
+    this.context = null;
+    this.authenticated = false;
+    this.userId = null;
+    server.emit(ServerEvents.LOGOUT, this);
+    return true;
+}, { protected: true });
+//# sourceMappingURL=methods.js.map

package/dist/server/methods.js.map

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

package/dist/server/request-types.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Framework-agnostic request/response interfaces for TypeFerry.
+ *
+ * Hono request adapters satisfy these contracts, keeping `ClientNode` and
+ * authentication logic independent from the HTTP adapter internals.
+ */
+/** Minimal request interface for auth and tracking. */
+export interface TypeFerryRequest {
+    headers: Record<string, string | string[] | undefined>;
+    ip?: string;
+    path?: string;
+    get?: (name: string) => string | undefined;
+    socket?: {
+        remoteAddress?: string;
+    };
+}
+/** Minimal response interface for cookie/header setting. */
+export interface TypeFerryResponse {
+    setHeader(name: string, value: string): void;
+}

package/dist/server/request-types.js

@@ -0,0 +1,8 @@
+/**
+ * Framework-agnostic request/response interfaces for TypeFerry.
+ *
+ * Hono request adapters satisfy these contracts, keeping `ClientNode` and
+ * authentication logic independent from the HTTP adapter internals.
+ */
+export {};
+//# sourceMappingURL=request-types.js.map

package/dist/server/request-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-types.js","sourceRoot":"","sources":["../../src/server/request-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/server/room-registry.d.ts

@@ -0,0 +1,28 @@
+import type { TypeFerrySocket } from './types.js';
+/**
+ * In-memory room/subscription registry replacing Socket.IO's room system.
+ *
+ * Maintains a bidirectional index for O(1) join/leave/broadcast and O(1)
+ * cleanup when a socket disconnects (via the reverse index).
+ */
+export declare class RoomRegistry {
+    /** room name → set of sockets subscribed to that room */
+    private rooms;
+    /** socket → set of rooms it has joined (reverse index for fast cleanup) */
+    private socketRooms;
+    /** Adds a socket to a room. Idempotent. */
+    join(ws: TypeFerrySocket, room: string): void;
+    /** Removes a socket from a room. Cleans up empty rooms. */
+    leave(ws: TypeFerrySocket, room: string): void;
+    /** Removes a socket from all rooms. Called on disconnect. */
+    leaveAll(ws: TypeFerrySocket): void;
+    /**
+     * Sends `data` to every socket in `room`.
+     * Optionally excludes a single socket (e.g. the originator).
+     */
+    broadcast(room: string, data: string, exclude?: TypeFerrySocket): void;
+    /** Returns true if `ws` is a member of `room`. */
+    has(ws: TypeFerrySocket, room: string): boolean;
+    /** Returns the number of sockets in a room. */
+    getRoomSize(room: string): number;
+}

package/dist/server/room-registry.js

@@ -0,0 +1,83 @@
+import { SocketState } from './types.js';
+/**
+ * In-memory room/subscription registry replacing Socket.IO's room system.
+ *
+ * Maintains a bidirectional index for O(1) join/leave/broadcast and O(1)
+ * cleanup when a socket disconnects (via the reverse index).
+ */
+export class RoomRegistry {
+    /** room name → set of sockets subscribed to that room */
+    rooms = new Map();
+    /** socket → set of rooms it has joined (reverse index for fast cleanup) */
+    socketRooms = new Map();
+    /** Adds a socket to a room. Idempotent. */
+    join(ws, room) {
+        let members = this.rooms.get(room);
+        if (!members) {
+            members = new Set();
+            this.rooms.set(room, members);
+        }
+        members.add(ws);
+        let joined = this.socketRooms.get(ws);
+        if (!joined) {
+            joined = new Set();
+            this.socketRooms.set(ws, joined);
+        }
+        joined.add(room);
+    }
+    /** Removes a socket from a room. Cleans up empty rooms. */
+    leave(ws, room) {
+        const members = this.rooms.get(room);
+        if (members) {
+            members.delete(ws);
+            if (members.size === 0)
+                this.rooms.delete(room);
+        }
+        const joined = this.socketRooms.get(ws);
+        if (joined) {
+            joined.delete(room);
+            if (joined.size === 0)
+                this.socketRooms.delete(ws);
+        }
+    }
+    /** Removes a socket from all rooms. Called on disconnect. */
+    leaveAll(ws) {
+        const joined = this.socketRooms.get(ws);
+        if (!joined)
+            return;
+        for (const room of joined) {
+            const members = this.rooms.get(room);
+            if (members) {
+                members.delete(ws);
+                if (members.size === 0)
+                    this.rooms.delete(room);
+            }
+        }
+        this.socketRooms.delete(ws);
+    }
+    /**
+     * Sends `data` to every socket in `room`.
+     * Optionally excludes a single socket (e.g. the originator).
+     */
+    broadcast(room, data, exclude) {
+        const members = this.rooms.get(room);
+        if (!members)
+            return;
+        for (const ws of members) {
+            if (ws === exclude)
+                continue;
+            if (ws.readyState === SocketState.OPEN) {
+                ws.send(data);
+            }
+        }
+    }
+    /** Returns true if `ws` is a member of `room`. */
+    has(ws, room) {
+        return this.rooms.get(room)?.has(ws) ?? false;
+    }
+    /** Returns the number of sockets in a room. */
+    getRoomSize(room) {
+        return this.rooms.get(room)?.size ?? 0;
+    }
+}
+//# sourceMappingURL=room-registry.js.map

package/dist/server/room-registry.js.map

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

package/dist/server/server-channel.d.ts

@@ -0,0 +1,32 @@
+import EventEmitter2 from '../utils/event-emitter.js';
+import type { ClientNode } from './client-node.js';
+import type { EventOptions } from './event.js';
+import { Event } from './event.js';
+import type { Server } from './server.js';
+export declare class ServerChannel extends EventEmitter2 {
+    channelName: string;
+    server: Server;
+    constructor(channelName: string);
+    setServer(server: Server): void;
+    /**
+     * Broadcasts a pre-encoded event payload to all subscribed clients.
+     * The payload already contains the wire protocol `t` field (set by
+     * Event.handler), so no re-encoding is needed.
+     * @param excludeUuid - Optional client uuid to exclude from receiving the event
+     */
+    propagate(event: string, payload: string, excludeUuid?: string): void;
+    defer<T = any>(event: string, params?: T): void;
+    /** Refreshes a method by its identifier. */
+    refresh(method: string): void;
+    /** Declares a new event. */
+    addEvent(name: string, opts?: EventOptions): void;
+    get list(): string[];
+    get length(): number;
+    get(event: string): Event;
+    has(event: string): boolean;
+    delete(event: string): boolean;
+    /**
+     * Checks if a client is subscribed to an event via the RoomRegistry.
+     */
+    isSubscribed(client: ClientNode, event: Event): boolean;
+}

package/dist/server/server-channel.js

@@ -0,0 +1,104 @@
+import { TypeFerryEvents, ServerEvents } from '../utils/index.js';
+import EventEmitter2 from '../utils/event-emitter.js';
+import { Event } from './event.js';
+import { getRoomName } from './methods.js';
+import { HttpTransportEvents, WebSocketTransportEvents } from './transports/index.js';
+const SystemEvents = [
+    ...Object.values(HttpTransportEvents),
+    ...Object.values(ServerEvents),
+    ...Object.values(WebSocketTransportEvents),
+];
+export class ServerChannel extends EventEmitter2 {
+    channelName;
+    server;
+    constructor(channelName) {
+        super({
+            maxListeners: 1024,
+        });
+        this.channelName = channelName;
+        this.onAny((event, value) => {
+            if (!this.server.events.has(event) &&
+                !SystemEvents.includes(event)) {
+                console.warn('Event Not Registered:', event);
+            }
+            if (this.server.events.has(event)) {
+                const eventObject = this.server.events.get(event);
+                eventObject.handler(this, value);
+            }
+        });
+    }
+    setServer(server) {
+        this.server = server;
+    }
+    /**
+     * Broadcasts a pre-encoded event payload to all subscribed clients.
+     * The payload already contains the wire protocol `t` field (set by
+     * Event.handler), so no re-encoding is needed.
+     * @param excludeUuid - Optional client uuid to exclude from receiving the event
+     */
+    propagate(event, payload, excludeUuid) {
+        const eventObject = this.server.events.get(event);
+        if (!eventObject) {
+            console.log('Event Not Registered:', event);
+            return;
+        }
+        const transport = this.server.webSocketTransport;
+        if (!transport) {
+            console.warn('[TypeFerry] WebSocket transport not available for propagate');
+            return;
+        }
+        const roomName = getRoomName(this.channelName, event);
+        if (excludeUuid) {
+            const excludeClient = this.server.allClients.get(excludeUuid);
+            transport.rooms.broadcast(roomName, payload, excludeClient?.socket);
+        }
+        else {
+            transport.rooms.broadcast(roomName, payload);
+        }
+    }
+    defer(event, params) {
+        process.nextTick(() => {
+            this.emit(event, params);
+        });
+    }
+    /** Refreshes a method by its identifier. */
+    refresh(method) {
+        this.emit(TypeFerryEvents.METHOD_REFRESH, method);
+    }
+    /** Declares a new event. */
+    addEvent(name, opts) {
+        if (this.server.events.has(name)) {
+            this.server.events.delete(name);
+        }
+        const event = new Event(name, this.server, this, opts);
+        this.server.events.set(name, event);
+    }
+    get list() {
+        return Array.from(this.server.events.keys());
+    }
+    get length() {
+        return this.server.events.size;
+    }
+    get(event) {
+        return this.server.events.get(event);
+    }
+    has(event) {
+        return this.server.events.has(event);
+    }
+    delete(event) {
+        return this.server.events.delete(event);
+    }
+    /**
+     * Checks if a client is subscribed to an event via the RoomRegistry.
+     */
+    isSubscribed(client, event) {
+        if (!client.socket)
+            return false;
+        const rooms = this.server.webSocketTransport?.rooms;
+        if (!rooms)
+            return false;
+        const roomName = getRoomName(this.channelName, event.name);
+        return rooms.has(client.socket, roomName);
+    }
+}
+//# sourceMappingURL=server-channel.js.map

package/dist/server/server-channel.js.map

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

package/dist/server/server.d.ts

@@ -0,0 +1,124 @@
+import type { RequestListener } from 'node:http';
+import type { Hono } from 'hono';
+import type { RedisClientOptions } from 'redis';
+import type { z } from 'zod';
+import type { MethodParams as MethodParameters, ServerMethods } from '../utils/index.js';
+import { ClientNode } from './client-node.js';
+import type { Event } from './event.js';
+import type { MethodFunction, MethodOptions } from './method.js';
+import { Method } from './method.js';
+import { ServerChannel } from './server-channel.js';
+import { NodeHonoTransport, RedisTransport, WebSocketTransport } from './transports/index.js';
+declare global {
+    var TypeFerry: Server;
+}
+export type ChannelChecker = (node: ClientNode, channel: string) => Promise<boolean>;
+export type AuthFunction = (this: ClientNode, context: any) => any;
+/**
+ * Configuration for server authentication.
+ */
+export type AuthSetup = {
+    /** Authentication function called to validate tokens */
+    auth: AuthFunction;
+    /** Login method handler */
+    logIn: MethodFunction;
+};
+export type RateLimit = boolean | {
+    max: number;
+    interval: number;
+};
+/** Default request-body ceiling retained across the runtime migration. */
+export declare const DEFAULT_MAX_REQUEST_BODY_SIZE_BYTES: number;
+export type ServerOptions = {
+    host?: string;
+    port?: number;
+    auth?: AuthFunction;
+    origins?: string[];
+    debug?: boolean;
+    ws?: Record<string, unknown>;
+    redis?: RedisClientOptions | boolean;
+    /**
+     * Observes Node request metadata and synchronous `data` events without owning
+     * transport backpressure. Pausing or reading the observer does not pause Hono.
+     */
+    requestListener?: RequestListener;
+    globalInstance?: boolean;
+    allowedContextKeys?: string[];
+    rateLimit?: RateLimit;
+    /** Maximum request body accepted by the HTTP listener. */
+    maxRequestBodySize?: number;
+    shouldAllowChannelSubscribe?: ChannelChecker;
+};
+export type ProxyMethodCreation = {
+    [key: string]: ProxyMethodCreation;
+} & any;
+export declare class Server<Methods extends ServerMethods = ServerMethods> extends ServerChannel {
+    uuid: string;
+    httpTransport: NodeHonoTransport;
+    webSocketTransport: WebSocketTransport;
+    redisTransport: RedisTransport;
+    host: string;
+    port: number;
+    requestListener: RequestListener;
+    allowedContextKeys: string[];
+    isAuthEnabled: boolean;
+    auth: AuthFunction;
+    debug: boolean;
+    rateLimit: RateLimit;
+    maxRequestBodySize: number;
+    methods: Map<string, Method<any, any>>;
+    allClients: Map<string, ClientNode>;
+    /** Reverse index: userId → connected client nodes for efficient user-level operations */
+    private clientsByUserId;
+    channels: Map<string, ServerChannel>;
+    events: Map<string, Event>;
+    m: ProxyMethodCreation;
+    acceptConnections: boolean;
+    ready: boolean;
+    shouldAllowChannelSubscribe: ChannelChecker;
+    static ERROR_EVENT: string;
+    handlers: Methods;
+    private closePromise?;
+    private initializeGlobalInstance;
+    private initializeTransports;
+    private setupHttpListening;
+    constructor({ host, port, debug, origins, ws, redis, requestListener, globalInstance, allowedContextKeys, rateLimit, maxRequestBodySize, }?: ServerOptions);
+    /**
+     * 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(): Promise<boolean>;
+    /**
+     * Returns the authoritative Hono application for route registration.
+     */
+    get app(): Hono;
+    setAuth({ auth, logIn }: AuthSetup): void;
+    setChannelAuthorization(checker: ChannelChecker): void;
+    close(): Promise<boolean>;
+    private closeTransports;
+    static(path: string, catchAll: boolean): void;
+    debugger(...args: any[]): void;
+    call<T = Record<string, unknown>>(method: string, parameters?: MethodParameters<T>): Promise<unknown>;
+    createDefaultMethods(): void;
+    getMethod(method: string): Method<any, any>;
+    addClient(node: ClientNode): void;
+    deleteClient(node: ClientNode): void;
+    /** Registers a client node in the userId reverse index */
+    indexClientByUserId(node: ClientNode): void;
+    /** Removes a client node from the userId reverse index */
+    removeClientFromUserIndex(node: ClientNode): void;
+    /** Returns all connected client nodes for a given userId */
+    getClientsByUserId(userId: string): ReadonlySet<ClientNode>;
+    /**
+     * Disconnects all WebSocket clients for a userId.
+     * Used during session revocation to enforce immediate logout.
+     * @returns Number of clients disconnected
+     */
+    disconnectUser(userId: string, exceptNodeUuid?: string): number;
+    addMethod<T = any, R = any, Schema extends z.ZodType = z.ZodType>(method: string, fn: MethodFunction<T, R>, opts?: MethodOptions<Schema>): void;
+    channel(name?: string | object): ServerChannel;
+}
+export type InferServerMethods<T extends Server<any>> = T['handlers'];
+export declare function createServer(options?: ServerOptions): Server<ServerMethods>;