raffel 0.1.2

package/dist/server/fs-routes/tcp/loader.js

@@ -0,0 +1,402 @@
+/**
+ * TCP Custom Handler Loader
+ *
+ * Loads custom TCP handlers from file system and creates servers.
+ */
+import { createServer as createNetServer } from 'node:net';
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import { join, parse as parsePath } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { createLogger } from '../../../utils/logger.js';
+import { sid } from '../../../utils/id/index.js';
+import { createContext } from '../../../types/context.js';
+const logger = createLogger('tcp-loader');
+// === Default Configuration ===
+const DEFAULT_CONFIG = {
+    port: 9000,
+    host: '0.0.0.0',
+    keepAlive: true,
+    keepAliveInitialDelay: 30000,
+    timeout: 0,
+    maxConnections: 0,
+    noDelay: true,
+    framing: null,
+};
+// === Main Loader ===
+/**
+ * Load TCP handlers from directory.
+ */
+export async function loadTcpHandlers(options) {
+    const startTime = Date.now();
+    const extensions = options.extensions ?? ['.ts', '.js'];
+    const handlers = [];
+    if (!existsSync(options.tcpDir)) {
+        logger.debug({ dir: options.tcpDir }, 'TCP directory not found');
+        return {
+            handlers: [],
+            stats: { handlers: 0, duration: Date.now() - startTime },
+        };
+    }
+    const entries = readdirSync(options.tcpDir);
+    for (const entry of entries) {
+        const fullPath = join(options.tcpDir, entry);
+        const stat = statSync(fullPath);
+        if (!stat.isFile())
+            continue;
+        const { name, ext } = parsePath(entry);
+        if (!extensions.includes(ext))
+            continue;
+        if (name.startsWith('_'))
+            continue;
+        try {
+            const exports = await importFile(fullPath);
+            // Must have at least one handler
+            if (!exports.onConnect && !exports.onData && !exports.onMessage) {
+                logger.warn({ filePath: fullPath }, 'TCP file missing handler exports');
+                continue;
+            }
+            const config = resolveConfig(exports.config, options.defaultPort);
+            handlers.push({
+                name,
+                filePath: fullPath,
+                config,
+                handlers: exports,
+            });
+            logger.info({ name, port: config.port }, 'Loaded TCP handler');
+        }
+        catch (err) {
+            logger.error({ err, filePath: fullPath }, 'Failed to load TCP handler');
+        }
+    }
+    return {
+        handlers,
+        stats: {
+            handlers: handlers.length,
+            duration: Date.now() - startTime,
+        },
+    };
+}
+// === Config Resolution ===
+function resolveConfig(config, defaultPort) {
+    const resolved = {
+        ...DEFAULT_CONFIG,
+        ...config,
+        port: config?.port === 'shared' ? 0 : (config?.port ?? defaultPort ?? DEFAULT_CONFIG.port),
+        framing: null,
+    };
+    // Resolve framing config
+    if (config?.framing && config.framing.type !== 'none') {
+        resolved.framing = {
+            type: config.framing.type,
+            lengthBytes: config.framing.lengthBytes ?? 4,
+            lengthEncoding: config.framing.lengthEncoding ?? 'BE',
+            maxMessageSize: config.framing.maxMessageSize ?? 16 * 1024 * 1024,
+            delimiter: config.framing.delimiter
+                ? Buffer.from(config.framing.delimiter)
+                : undefined,
+        };
+    }
+    return resolved;
+}
+// === Server Creation ===
+/**
+ * Create a TCP server instance from a loaded handler.
+ */
+export function createTcpServer(handler) {
+    const { name, config, handlers } = handler;
+    const connections = new Map();
+    const states = new Map();
+    const buffers = new Map(); // For framing
+    let server;
+    const serverRef = {
+        get connections() {
+            return connections;
+        },
+        broadcast(data, except) {
+            const buf = typeof data === 'string' ? Buffer.from(data) : data;
+            for (const [socketId, socket] of connections) {
+                if (socketId !== except && socket.writable) {
+                    if (config.framing) {
+                        socket.write(frameMessage(buf, config.framing));
+                    }
+                    else {
+                        socket.write(buf);
+                    }
+                }
+            }
+        },
+        getConnection(socketId) {
+            return connections.get(socketId);
+        },
+        disconnect(socketId) {
+            const socket = connections.get(socketId);
+            if (socket) {
+                socket.destroy();
+            }
+        },
+        get address() {
+            const addr = server?.address();
+            if (addr && typeof addr === 'object') {
+                return { host: addr.address, port: addr.port };
+            }
+            return null;
+        },
+    };
+    function createTcpContext(socketId, socket) {
+        const baseCtx = createContext(sid());
+        return {
+            ...baseCtx,
+            socketId,
+            state: states.get(socketId),
+            remote: {
+                address: socket.remoteAddress ?? '',
+                port: socket.remotePort ?? 0,
+                family: socket.remoteFamily ?? '',
+            },
+            server: serverRef,
+            send(data) {
+                if (socket.writable) {
+                    const buf = typeof data === 'string' ? Buffer.from(data) : data;
+                    if (config.framing) {
+                        socket.write(frameMessage(buf, config.framing));
+                    }
+                    else {
+                        socket.write(buf);
+                    }
+                }
+            },
+            close() {
+                socket.end();
+            },
+        };
+    }
+    function handleConnection(socket) {
+        const socketId = sid();
+        connections.set(socketId, socket);
+        states.set(socketId, {});
+        buffers.set(socketId, Buffer.alloc(0));
+        // Configure socket
+        if (config.keepAlive) {
+            socket.setKeepAlive(true, config.keepAliveInitialDelay);
+        }
+        if (config.noDelay) {
+            socket.setNoDelay(true);
+        }
+        if (config.timeout > 0) {
+            socket.setTimeout(config.timeout);
+        }
+        const ctx = createTcpContext(socketId, socket);
+        logger.debug({ socketId, remote: ctx.remote }, 'TCP client connected');
+        // Call onConnect handler
+        if (handlers.onConnect) {
+            Promise.resolve(handlers.onConnect(socket, ctx)).catch(err => {
+                logger.error({ err, socketId }, 'Error in onConnect handler');
+            });
+        }
+        // Data handler
+        socket.on('data', (data) => {
+            const ctx = createTcpContext(socketId, socket);
+            if (config.framing) {
+                // Framed mode: accumulate and parse messages
+                handleFramedData(socketId, data, socket, ctx, config.framing, handlers, buffers);
+            }
+            else {
+                // Raw mode: pass data directly
+                if (handlers.onData) {
+                    Promise.resolve(handlers.onData(data, socket, ctx)).catch(err => {
+                        logger.error({ err, socketId }, 'Error in onData handler');
+                    });
+                }
+            }
+        });
+        // Close handler
+        socket.on('close', (hadError) => {
+            const ctx = createTcpContext(socketId, socket);
+            if (handlers.onClose) {
+                Promise.resolve(handlers.onClose(hadError, socket, ctx)).catch(err => {
+                    logger.error({ err, socketId }, 'Error in onClose handler');
+                });
+            }
+            connections.delete(socketId);
+            states.delete(socketId);
+            buffers.delete(socketId);
+            logger.debug({ socketId, hadError }, 'TCP client disconnected');
+        });
+        // Error handler
+        socket.on('error', (error) => {
+            const ctx = createTcpContext(socketId, socket);
+            if (handlers.onError) {
+                Promise.resolve(handlers.onError(error, socket, ctx)).catch(err => {
+                    logger.error({ err, socketId }, 'Error in onError handler');
+                });
+            }
+            else {
+                logger.error({ error, socketId }, 'TCP socket error');
+            }
+        });
+        // Timeout handler
+        socket.on('timeout', () => {
+            const ctx = createTcpContext(socketId, socket);
+            if (handlers.onTimeout) {
+                Promise.resolve(handlers.onTimeout(socket, ctx)).catch(err => {
+                    logger.error({ err, socketId }, 'Error in onTimeout handler');
+                });
+            }
+            else {
+                socket.end();
+            }
+        });
+        // Drain handler
+        if (handlers.onDrain) {
+            socket.on('drain', () => {
+                const ctx = createTcpContext(socketId, socket);
+                Promise.resolve(handlers.onDrain(socket, ctx)).catch(err => {
+                    logger.error({ err, socketId }, 'Error in onDrain handler');
+                });
+            });
+        }
+    }
+    server = createNetServer(handleConnection);
+    if (config.maxConnections > 0) {
+        server.maxConnections = config.maxConnections;
+    }
+    return {
+        name,
+        server,
+        port: config.port,
+        host: config.host,
+        connections,
+        states,
+        async start() {
+            return new Promise((resolve, reject) => {
+                server.once('error', reject);
+                server.listen(config.port, config.host, () => {
+                    server.removeListener('error', reject);
+                    const addr = server.address();
+                    if (addr && typeof addr === 'object') {
+                        logger.info({ name, host: addr.address, port: addr.port }, 'TCP server started');
+                    }
+                    resolve();
+                });
+            });
+        },
+        async stop() {
+            return new Promise((resolve, reject) => {
+                // Close all connections
+                for (const socket of connections.values()) {
+                    socket.destroy();
+                }
+                connections.clear();
+                states.clear();
+                buffers.clear();
+                server.close(err => {
+                    if (err) {
+                        reject(err);
+                    }
+                    else {
+                        logger.info({ name }, 'TCP server stopped');
+                        resolve();
+                    }
+                });
+            });
+        },
+        broadcast(data, except) {
+            serverRef.broadcast(data, except);
+        },
+    };
+}
+// === Framing Helpers ===
+function handleFramedData(socketId, data, socket, ctx, framing, handlers, buffers) {
+    let buffer = Buffer.concat([buffers.get(socketId) ?? Buffer.alloc(0), data]);
+    if (framing.type === 'length-prefixed') {
+        // Length-prefixed framing
+        while (buffer.length >= framing.lengthBytes) {
+            const length = readLength(buffer, framing.lengthBytes, framing.lengthEncoding);
+            if (length > framing.maxMessageSize) {
+                logger.error({ socketId, length, max: framing.maxMessageSize }, 'Message too large');
+                socket.destroy();
+                return;
+            }
+            if (buffer.length < framing.lengthBytes + length) {
+                // Not enough data yet
+                break;
+            }
+            // Extract message
+            const message = buffer.slice(framing.lengthBytes, framing.lengthBytes + length);
+            buffer = buffer.slice(framing.lengthBytes + length);
+            // Call handler
+            if (handlers.onMessage) {
+                Promise.resolve(handlers.onMessage(message, socket, ctx)).catch(err => {
+                    logger.error({ err, socketId }, 'Error in onMessage handler');
+                });
+            }
+        }
+    }
+    else if (framing.type === 'delimiter' && framing.delimiter) {
+        // Delimiter-based framing
+        let delimIndex;
+        while ((delimIndex = buffer.indexOf(framing.delimiter)) !== -1) {
+            const message = buffer.slice(0, delimIndex);
+            buffer = buffer.slice(delimIndex + framing.delimiter.length);
+            if (message.length > framing.maxMessageSize) {
+                logger.error({ socketId, length: message.length, max: framing.maxMessageSize }, 'Message too large');
+                socket.destroy();
+                return;
+            }
+            // Call handler
+            if (handlers.onMessage) {
+                Promise.resolve(handlers.onMessage(message, socket, ctx)).catch(err => {
+                    logger.error({ err, socketId }, 'Error in onMessage handler');
+                });
+            }
+        }
+    }
+    buffers.set(socketId, buffer);
+}
+function readLength(buffer, bytes, encoding) {
+    if (bytes === 1) {
+        return buffer.readUInt8(0);
+    }
+    else if (bytes === 2) {
+        return encoding === 'BE' ? buffer.readUInt16BE(0) : buffer.readUInt16LE(0);
+    }
+    else {
+        return encoding === 'BE' ? buffer.readUInt32BE(0) : buffer.readUInt32LE(0);
+    }
+}
+function frameMessage(data, framing) {
+    if (framing.type === 'length-prefixed') {
+        const header = Buffer.alloc(framing.lengthBytes);
+        if (framing.lengthBytes === 1) {
+            header.writeUInt8(data.length, 0);
+        }
+        else if (framing.lengthBytes === 2) {
+            if (framing.lengthEncoding === 'BE') {
+                header.writeUInt16BE(data.length, 0);
+            }
+            else {
+                header.writeUInt16LE(data.length, 0);
+            }
+        }
+        else {
+            if (framing.lengthEncoding === 'BE') {
+                header.writeUInt32BE(data.length, 0);
+            }
+            else {
+                header.writeUInt32LE(data.length, 0);
+            }
+        }
+        return Buffer.concat([header, data]);
+    }
+    else if (framing.type === 'delimiter' && framing.delimiter) {
+        return Buffer.concat([data, framing.delimiter]);
+    }
+    return data;
+}
+// === File Import ===
+async function importFile(filePath) {
+    const fileUrl = pathToFileURL(filePath).href;
+    const urlWithCacheBust = `${fileUrl}?t=${Date.now()}`;
+    return import(urlWithCacheBust);
+}
+//# sourceMappingURL=loader.js.map

package/dist/server/fs-routes/tcp/loader.js.map

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

package/dist/server/fs-routes/tcp/types.d.ts

@@ -0,0 +1,215 @@
+/**
+ * TCP Custom Handler Types
+ *
+ * Type definitions for custom TCP handlers with full control.
+ */
+import type { Socket, Server as NetServer } from 'node:net';
+import type { Context } from '../../../types/index.js';
+export interface TcpConfig {
+    /** Port to listen on */
+    port: number | 'shared';
+    /** Host to bind to (default: '0.0.0.0') */
+    host?: string;
+    /** Enable keep-alive (default: true) */
+    keepAlive?: boolean;
+    /** Keep-alive initial delay in ms (default: 30000) */
+    keepAliveInitialDelay?: number;
+    /** Connection timeout in ms (default: 0 = no timeout) */
+    timeout?: number;
+    /** Max connections (default: unlimited) */
+    maxConnections?: number;
+    /** Enable TCP_NODELAY (default: true) */
+    noDelay?: boolean;
+    /** Message framing configuration */
+    framing?: TcpFramingConfig;
+}
+export interface TcpFramingConfig {
+    /**
+     * Framing type:
+     * - 'none': Raw data, onData receives chunks as-is
+     * - 'length-prefixed': Messages prefixed with length header
+     * - 'delimiter': Messages separated by delimiter
+     */
+    type: 'none' | 'length-prefixed' | 'delimiter';
+    /** Number of bytes for length header (default: 4) */
+    lengthBytes?: 1 | 2 | 4;
+    /** Length encoding (default: 'BE') */
+    lengthEncoding?: 'BE' | 'LE';
+    /** Max message size in bytes (default: 16MB) */
+    maxMessageSize?: number;
+    /** Delimiter string or buffer */
+    delimiter?: string | Buffer;
+}
+/**
+ * Context available in TCP handlers.
+ */
+export interface TcpContext<TState = unknown> extends Omit<Context, 'deadline' | 'signal'> {
+    /** Per-connection state (mutable) */
+    state: TState;
+    /** Socket ID */
+    socketId: string;
+    /** Remote address info */
+    remote: {
+        address: string;
+        port: number;
+        family: string;
+    };
+    /** Server reference */
+    server: TcpServerRef;
+    /** Send data to this socket */
+    send(data: Buffer | string): void;
+    /** Close this connection */
+    close(): void;
+}
+export interface TcpServerRef {
+    /** All connected sockets */
+    readonly connections: Map<string, Socket>;
+    /** Broadcast to all connections */
+    broadcast(data: Buffer | string, except?: string): void;
+    /** Get connection by ID */
+    getConnection(socketId: string): Socket | undefined;
+    /** Disconnect a socket */
+    disconnect(socketId: string): void;
+    /** Server address info */
+    readonly address: {
+        host: string;
+        port: number;
+    } | null;
+}
+/**
+ * TCP handler file exports.
+ *
+ * @example
+ * ```typescript
+ * // src/tcp/game-server.ts
+ * import type { Socket } from 'node:net'
+ * import type { TcpContext } from 'raffel'
+ *
+ * export const config = {
+ *   port: 9000,
+ *   framing: { type: 'length-prefixed', lengthBytes: 4 },
+ * }
+ *
+ * interface GameState {
+ *   playerId?: string
+ *   authenticated: boolean
+ * }
+ *
+ * export function onConnect(socket: Socket, ctx: TcpContext<GameState>) {
+ *   ctx.state = { authenticated: false }
+ *   ctx.send(Buffer.from('WELCOME'))
+ * }
+ *
+ * export function onMessage(data: Buffer, socket: Socket, ctx: TcpContext<GameState>) {
+ *   // Handle framed message
+ * }
+ *
+ * export function onClose(socket: Socket, ctx: TcpContext<GameState>) {
+ *   console.log('Client disconnected')
+ * }
+ * ```
+ */
+export interface TcpHandlerExports<TState = unknown> {
+    /** TCP server configuration */
+    config?: TcpConfig;
+    /**
+     * Called when a client connects.
+     * Initialize connection state here.
+     */
+    onConnect?: TcpConnectHandler<TState>;
+    /**
+     * Called when raw data is received (framing: 'none').
+     * Receives chunks as they arrive from the socket.
+     */
+    onData?: TcpDataHandler<TState>;
+    /**
+     * Called when a complete message is received (framing: 'length-prefixed' | 'delimiter').
+     * Only called when framing is enabled.
+     */
+    onMessage?: TcpMessageHandler<TState>;
+    /**
+     * Called when connection closes.
+     * Cleanup connection state here.
+     */
+    onClose?: TcpCloseHandler<TState>;
+    /**
+     * Called on socket error.
+     */
+    onError?: TcpErrorHandler<TState>;
+    /**
+     * Called when connection times out.
+     */
+    onTimeout?: TcpTimeoutHandler<TState>;
+    /**
+     * Called when socket drain event fires (write buffer empty).
+     * Useful for backpressure handling.
+     */
+    onDrain?: TcpDrainHandler<TState>;
+}
+export type TcpConnectHandler<TState = unknown> = (socket: Socket, ctx: TcpContext<TState>) => void | Promise<void>;
+export type TcpDataHandler<TState = unknown> = (data: Buffer, socket: Socket, ctx: TcpContext<TState>) => void | Promise<void>;
+export type TcpMessageHandler<TState = unknown> = (message: Buffer, socket: Socket, ctx: TcpContext<TState>) => void | Promise<void>;
+export type TcpCloseHandler<TState = unknown> = (hadError: boolean, socket: Socket, ctx: TcpContext<TState>) => void | Promise<void>;
+export type TcpErrorHandler<TState = unknown> = (error: Error, socket: Socket, ctx: TcpContext<TState>) => void | Promise<void>;
+export type TcpTimeoutHandler<TState = unknown> = (socket: Socket, ctx: TcpContext<TState>) => void | Promise<void>;
+export type TcpDrainHandler<TState = unknown> = (socket: Socket, ctx: TcpContext<TState>) => void | Promise<void>;
+export interface LoadedTcpHandler {
+    /** Handler name (from filename) */
+    name: string;
+    /** File path */
+    filePath: string;
+    /** Resolved configuration */
+    config: ResolvedTcpConfig;
+    /** Handler exports */
+    handlers: TcpHandlerExports;
+}
+export interface ResolvedTcpConfig extends Omit<Required<Omit<TcpConfig, 'framing'>>, 'port'> {
+    /** Port (always a number, 'shared' becomes 0) */
+    port: number;
+    framing: ResolvedTcpFramingConfig | null;
+}
+export interface ResolvedTcpFramingConfig {
+    type: 'length-prefixed' | 'delimiter';
+    lengthBytes: 1 | 2 | 4;
+    lengthEncoding: 'BE' | 'LE';
+    maxMessageSize: number;
+    delimiter?: Buffer;
+}
+export interface TcpLoaderOptions {
+    /** Base directory */
+    baseDir: string;
+    /** TCP directory path */
+    tcpDir: string;
+    /** File extensions to load */
+    extensions?: string[];
+    /** Default port if not specified in handler */
+    defaultPort?: number;
+}
+export interface TcpLoaderResult {
+    handlers: LoadedTcpHandler[];
+    stats: {
+        handlers: number;
+        duration: number;
+    };
+}
+export interface TcpServerInstance {
+    /** Handler name */
+    name: string;
+    /** Net server instance */
+    server: NetServer;
+    /** Port */
+    port: number;
+    /** Host */
+    host: string;
+    /** Connected sockets */
+    connections: Map<string, Socket>;
+    /** Connection states */
+    states: Map<string, unknown>;
+    /** Start the server */
+    start(): Promise<void>;
+    /** Stop the server */
+    stop(): Promise<void>;
+    /** Broadcast to all connections */
+    broadcast(data: Buffer | string, except?: string): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/server/fs-routes/tcp/types.d.ts.map

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

package/dist/server/fs-routes/tcp/types.js

@@ -0,0 +1,7 @@
+/**
+ * TCP Custom Handler Types
+ *
+ * Type definitions for custom TCP handlers with full control.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/server/fs-routes/tcp/types.js.map

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