murow 0.0.60 → 0.0.71

package/src/net/types.ts

@@ -1,228 +0,0 @@
-/**
- * Core networking types for transport-agnostic multiplayer game networking
- */
-
-/**
- * Generic transport adapter interface - implement this to support any transport layer
- * (WebSocket, WebRTC, UDP, Socket.io, etc.)
- *
- * IMPORTANT: Implementations MUST copy the data buffer if they need to hold a reference
- * after send() returns. The caller may reuse/mutate the buffer immediately after send()
- * completes (for buffer pooling optimization).
- */
-export interface TransportAdapter {
-	/**
-	 * Send binary data through the transport.
-	 *
-	 * CRITICAL: You MUST copy the buffer if your transport will access it after
-	 * this method returns (e.g., in async operations, queues, or callbacks).
-	 * The caller may reuse this buffer immediately after send() completes.
-	 *
-	 * WebSocket transports (Bun, browser) copy automatically and are safe.
-	 * Custom transports MUST explicitly copy: `new Uint8Array(data)`
-	 */
-	send(data: Uint8Array): void | Promise<void>;
-
-	/**
-	 * Register a callback for connection open
-	 */
-	onOpen?(handler: () => void): void;
-
-	/**
-	 * Register a callback for incoming binary data
-	 */
-	onMessage(handler: (data: Uint8Array) => void): void;
-
-	/**
-	 * Register a callback for connection close/disconnect
-	 */
-	onClose(handler: () => void): void;
-
-	/**
-	 * Register a callback for transport errors (optional)
-	 */
-	onError?(handler: (error: Error) => void): void;
-
-	/**
-	 * Close the connection
-	 */
-	close(): void | Promise<void>;
-}
-
-/**
- * Server-side transport adapter - manages multiple peer connections
- */
-export interface ServerTransportAdapter<TPeer extends TransportAdapter> {
-	/**
-	 * Register a callback for new peer connections
-	 */
-	onConnection(handler: (peer: TPeer, peerId: string) => void): void;
-
-	/**
-	 * Register a callback for peer disconnections
-	 */
-	onDisconnection(handler: (peerId: string) => void): void;
-
-	/**
-	 * Get a specific peer connection by ID
-	 */
-	getPeer(peerId: string): TPeer | undefined;
-
-	/**
-	 * Get all connected peer IDs
-	 */
-	getPeerIds(): string[];
-
-	/**
-	 * Close the server and all connections
-	 */
-	close(): void | Promise<void>;
-}
-
-/**
- * Message type identifiers for protocol discrimination
- */
-export enum MessageType {
-	/** Client -> Server: Intent/command */
-	INTENT = 0x01,
-	/** Server -> Client: State snapshot */
-	SNAPSHOT = 0x02,
-	/** Bidirectional: Heartbeat/ping */
-	HEARTBEAT = 0x03,
-	/** Bidirectional: Custom application message */
-	CUSTOM = 0xff,
-}
-
-/**
- * Message priority levels for send queue
- */
-export enum MessagePriority {
-	/** Lowest priority - can be dropped if queue is full (e.g., chat) */
-	LOW = 0,
-	/** Normal priority - most game messages (e.g., movement) */
-	NORMAL = 1,
-	/** High priority - important events (e.g., damage, scoring) */
-	HIGH = 2,
-	/** Critical priority - never drop (e.g., connection control) */
-	CRITICAL = 3,
-}
-
-/**
- * Queued message with priority
- */
-export interface QueuedMessage {
-	data: Uint8Array;
-	priority: MessagePriority;
-	timestamp: number;
-}
-
-/**
- * Lag simulation configuration for testing network conditions
- */
-export type LagSimulation = number | { min: number; max: number };
-
-/**
- * Configuration for network message handling
- */
-export interface NetworkConfig {
-	/**
-	 * Maximum message size in bytes (default: 64KB)
-	 */
-	maxMessageSize?: number;
-
-	/**
-	 * Enable debug logging
-	 */
-	debug?: boolean;
-
-	/**
-	 * Maximum messages per second per peer (server only, default: 100)
-	 * Set to 0 to disable rate limiting
-	 */
-	maxMessagesPerSecond?: number;
-
-	/**
-	 * Maximum send queue size per peer (default: 100)
-	 * When exceeded, oldest messages are dropped
-	 */
-	maxSendQueueSize?: number;
-
-	/**
-	 * Enable buffer pooling for message wrapping (default: true)
-	 *
-	 * IMPORTANT: Only enable if your transport copies buffers synchronously in send().
-	 * WebSocket transports (Bun, browser) are safe. Custom transports that queue
-	 * buffers internally MUST copy the buffer before queuing.
-	 */
-	enableBufferPooling?: boolean;
-
-	/**
-	 * Heartbeat interval in milliseconds (default: 30000 = 30s)
-	 * Set to 0 to disable heartbeats
-	 */
-	heartbeatInterval?: number;
-
-	/**
-	 * Heartbeat timeout in milliseconds (default: 60000 = 60s)
-	 * If no message received within this time, connection is considered dead
-	 */
-	heartbeatTimeout?: number;
-
-	/**
-	 * Simulate network lag for testing (client-side only)
-	 * - number: Fixed delay in milliseconds
-	 * - {min, max}: Random delay between min and max milliseconds
-	 * - undefined: No lag simulation (default)
-	 *
-	 * @example
-	 * ```ts
-	 * // Fixed 100ms lag
-	 * lagSimulation: 100
-	 *
-	 * // Random lag between 50-150ms
-	 * lagSimulation: { min: 50, max: 150 }
-	 * ```
-	 */
-	lagSimulation?: LagSimulation;
-}
-
-/**
- * Per-peer state tracking on the server
- */
-export interface PeerState {
-	/** Unique peer identifier */
-	peerId: string;
-
-	/** Transport connection for this peer */
-	transport: TransportAdapter;
-
-	/** Last tick number sent to this peer */
-	lastSentTick: number;
-
-	/** Connection timestamp */
-	connectedAt: number;
-
-	/** Custom metadata (e.g., player name, team, etc.) */
-	metadata: Record<string, unknown>;
-
-	/** Rate limiting: message count in current second */
-	messageCount: number;
-
-	/** Rate limiting: timestamp of current second window */
-	messageCountWindow: number;
-
-	/** Send queue for backpressure handling (prioritized) */
-	sendQueue: QueuedMessage[];
-
-	/** Bandwidth tracking: bytes sent in current second */
-	bytesSent: number;
-
-	/** Bandwidth tracking: timestamp of current second window */
-	bandwidthWindow: number;
-
-	/** Flag to indicate if peer is experiencing backpressure */
-	isBackpressured: boolean;
-
-	/** Last time we received any message from this peer */
-	lastMessageReceivedAt: number;
-}

package/src/net/validators.ts

@@ -1,104 +0,0 @@
-import type { Intent } from "../protocol/intent/intent";
-
-/**
- * Common intent validation helpers
- */
-
-/**
- * Validate that intent tick is not in the past (with tolerance for network lag)
- *
- * NOTE: Pass the current tick value at the time you create the validator.
- * If your tick advances, you'll need to recreate the validator or use a function
- * that captures the current tick dynamically.
- *
- * @param currentTick Current server tick
- * @param tolerance Number of ticks to allow in the past (default: 10)
- *
- * @example
- * ```ts
- * // Option 1: Recreate validator each tick (simple but allocates)
- * function onTick(currentTick: number) {
- *   const validator = validateTickNotTooOld(currentTick);
- *   // use validator...
- * }
- *
- * // Option 2: Manual validation (zero allocation)
- * if (intent.tick >= currentTick - 10) {
- *   // intent is valid
- * }
- * ```
- */
-export function validateTickNotTooOld(currentTick: number, tolerance: number = 10) {
-	return <T extends Intent>(_peerId: string, intent: T): boolean => {
-		return intent.tick >= currentTick - tolerance;
-	};
-}
-
-/**
- * Validate that intent tick is not too far in the future
- * @param currentTick Current server tick
- * @param tolerance Number of ticks to allow in the future (default: 5)
- */
-export function validateTickNotTooFuture(currentTick: number, tolerance: number = 5) {
-	return <T extends Intent>(_peerId: string, intent: T): boolean => {
-		return intent.tick <= currentTick + tolerance;
-	};
-}
-
-/**
- * Validate intent tick is within acceptable range
- * @param currentTick Current server tick
- * @param pastTolerance Ticks allowed in past (default: 10)
- * @param futureTolerance Ticks allowed in future (default: 5)
- */
-export function validateTickRange(
-	currentTick: number,
-	pastTolerance: number = 10,
-	futureTolerance: number = 5
-) {
-	return <T extends Intent>(_peerId: string, intent: T): boolean => {
-		return (
-			intent.tick >= currentTick - pastTolerance &&
-			intent.tick <= currentTick + futureTolerance
-		);
-	};
-}
-
-/**
- * Combine multiple validators with AND logic
- */
-export function combineValidators<T extends Intent>(
-	...validators: Array<(peerId: string, intent: T) => boolean>
-) {
-	return (peerId: string, intent: T): boolean => {
-		for (const validator of validators) {
-			if (!validator(peerId, intent)) {
-				return false;
-			}
-		}
-		return true;
-	};
-}
-
-/**
- * Validate that a numeric field is within a range
- */
-export function validateRange(field: string, min: number, max: number) {
-	return <T extends Intent>(_peerId: string, intent: T): boolean => {
-		const value = (intent as any)[field];
-		if (typeof value !== "number") {
-			return false;
-		}
-		return value >= min && value <= max;
-	};
-}
-
-/**
- * Validate that a field exists and is of expected type
- */
-export function validateFieldType(field: string, expectedType: string) {
-	return <T extends Intent>(_peerId: string, intent: T): boolean => {
-		const value = (intent as any)[field];
-		return typeof value === expectedType;
-	};
-}