@float.js/core 2.0.1

package/dist/realtime/index.js

@@ -0,0 +1,555 @@
+// src/realtime/index.ts
+import { WebSocketServer, WebSocket } from "ws";
+import { createServer } from "http";
+import { EventEmitter } from "events";
+var FloatRealtime = class extends EventEmitter {
+  wss = null;
+  httpServer = null;
+  clients = /* @__PURE__ */ new Map();
+  rooms = /* @__PURE__ */ new Map();
+  eventHandlers = /* @__PURE__ */ new Map();
+  connectionHandlers = [];
+  disconnectHandlers = [];
+  pingInterval = null;
+  options;
+  constructor(options = {}) {
+    super();
+    this.options = {
+      port: options.port ?? 3001,
+      path: options.path ?? "/ws",
+      pingInterval: options.pingInterval ?? 3e4,
+      maxPayload: options.maxPayload ?? 1024 * 1024,
+      // 1MB
+      presence: options.presence ?? true,
+      authenticate: options.authenticate ?? (async () => ({ id: this.generateId() }))
+    };
+  }
+  /**
+   * Start the WebSocket server
+   */
+  async start() {
+    return new Promise((resolve) => {
+      this.httpServer = createServer();
+      this.wss = new WebSocketServer({
+        server: this.httpServer,
+        path: this.options.path,
+        maxPayload: this.options.maxPayload
+      });
+      this.wss.on("connection", (socket, request) => {
+        this.handleConnection(socket, request);
+      });
+      this.pingInterval = setInterval(() => {
+        this.pingClients();
+      }, this.options.pingInterval);
+      this.httpServer.listen(this.options.port, () => {
+        console.log(`\u{1F50C} Float.js Realtime running on ws://localhost:${this.options.port}${this.options.path}`);
+        resolve();
+      });
+    });
+  }
+  /**
+   * Stop the WebSocket server
+   */
+  async stop() {
+    if (this.pingInterval) {
+      clearInterval(this.pingInterval);
+    }
+    for (const client of this.clients.values()) {
+      client.socket.close(1e3, "Server shutting down");
+    }
+    return new Promise((resolve) => {
+      if (this.wss) {
+        this.wss.close(() => {
+          if (this.httpServer) {
+            this.httpServer.close(() => {
+              resolve();
+            });
+          } else {
+            resolve();
+          }
+        });
+      } else {
+        resolve();
+      }
+    });
+  }
+  /**
+   * Handle new WebSocket connection
+   */
+  async handleConnection(socket, request) {
+    try {
+      const authResult = await this.options.authenticate(request);
+      if (!authResult) {
+        socket.close(4001, "Unauthorized");
+        return;
+      }
+      const client = {
+        id: authResult.id,
+        socket,
+        rooms: /* @__PURE__ */ new Set(),
+        data: authResult.data || {},
+        isAlive: true,
+        connectedAt: /* @__PURE__ */ new Date()
+      };
+      this.clients.set(client.id, client);
+      this.sendToClient(client, {
+        type: "_connected",
+        payload: {
+          id: client.id,
+          connectedAt: client.connectedAt
+        },
+        timestamp: Date.now()
+      });
+      socket.on("pong", () => {
+        client.isAlive = true;
+      });
+      socket.on("message", (data) => {
+        this.handleMessage(client, data);
+      });
+      socket.on("close", (code, reason) => {
+        this.handleDisconnect(client, code, reason.toString());
+      });
+      socket.on("error", (error) => {
+        console.error(`WebSocket error for client ${client.id}:`, error);
+      });
+      for (const handler of this.connectionHandlers) {
+        await handler(client);
+      }
+      this.emit("connection", client);
+    } catch (error) {
+      console.error("Connection error:", error);
+      socket.close(4e3, "Connection error");
+    }
+  }
+  /**
+   * Handle incoming message
+   */
+  async handleMessage(client, rawData) {
+    try {
+      const message = JSON.parse(rawData.toString());
+      message.from = client.id;
+      message.timestamp = Date.now();
+      switch (message.type) {
+        case "_join":
+          await this.handleJoin(client, message.payload);
+          return;
+        case "_leave":
+          await this.handleLeave(client, message.payload);
+          return;
+        case "_broadcast":
+          await this.handleBroadcast(client, message);
+          return;
+        case "_presence":
+          await this.handlePresenceUpdate(client, message.payload);
+          return;
+      }
+      const handlers = this.eventHandlers.get(message.type) || [];
+      for (const handler of handlers) {
+        await handler(message, client);
+      }
+      this.emit("message", message, client);
+    } catch (error) {
+      console.error("Message handling error:", error);
+    }
+  }
+  /**
+   * Handle client disconnect
+   */
+  async handleDisconnect(client, code, reason) {
+    for (const roomName of client.rooms) {
+      const room = this.rooms.get(roomName);
+      if (room) {
+        room.clients.delete(client.id);
+        this.broadcastToRoom(roomName, {
+          type: "_presence_leave",
+          payload: { clientId: client.id },
+          timestamp: Date.now()
+        }, client.id);
+        if (room.clients.size === 0) {
+          this.rooms.delete(roomName);
+        }
+      }
+    }
+    this.clients.delete(client.id);
+    for (const handler of this.disconnectHandlers) {
+      await handler(client, code, reason);
+    }
+    this.emit("disconnect", client, code, reason);
+  }
+  /**
+   * Handle room join
+   */
+  async handleJoin(client, payload) {
+    const { room: roomName, data } = payload;
+    let room = this.rooms.get(roomName);
+    if (!room) {
+      room = {
+        name: roomName,
+        clients: /* @__PURE__ */ new Set(),
+        metadata: {},
+        createdAt: /* @__PURE__ */ new Date()
+      };
+      this.rooms.set(roomName, room);
+    }
+    room.clients.add(client.id);
+    client.rooms.add(roomName);
+    if (data) {
+      client.data = { ...client.data, ...data };
+    }
+    this.sendToClient(client, {
+      type: "_joined",
+      payload: {
+        room: roomName,
+        members: this.getRoomPresence(roomName)
+      },
+      timestamp: Date.now()
+    });
+    if (this.options.presence) {
+      this.broadcastToRoom(roomName, {
+        type: "_presence_join",
+        payload: {
+          clientId: client.id,
+          data: client.data,
+          joinedAt: /* @__PURE__ */ new Date()
+        },
+        timestamp: Date.now()
+      }, client.id);
+    }
+    this.emit("join", client, roomName);
+  }
+  /**
+   * Handle room leave
+   */
+  async handleLeave(client, payload) {
+    const { room: roomName } = payload;
+    const room = this.rooms.get(roomName);
+    if (room) {
+      room.clients.delete(client.id);
+      client.rooms.delete(roomName);
+      if (this.options.presence) {
+        this.broadcastToRoom(roomName, {
+          type: "_presence_leave",
+          payload: { clientId: client.id },
+          timestamp: Date.now()
+        });
+      }
+      if (room.clients.size === 0) {
+        this.rooms.delete(roomName);
+      }
+    }
+    this.sendToClient(client, {
+      type: "_left",
+      payload: { room: roomName },
+      timestamp: Date.now()
+    });
+    this.emit("leave", client, roomName);
+  }
+  /**
+   * Handle broadcast message
+   */
+  async handleBroadcast(client, message) {
+    const { room } = message.payload;
+    const broadcastMessage = {
+      ...message,
+      type: message.payload.type || "broadcast",
+      payload: message.payload.data
+    };
+    if (room) {
+      this.broadcastToRoom(room, broadcastMessage, client.id);
+    } else {
+      this.broadcastToAll(broadcastMessage, client.id);
+    }
+  }
+  /**
+   * Handle presence update
+   */
+  async handlePresenceUpdate(client, data) {
+    client.data = { ...client.data, ...data };
+    for (const roomName of client.rooms) {
+      this.broadcastToRoom(roomName, {
+        type: "_presence_update",
+        payload: {
+          clientId: client.id,
+          data: client.data
+        },
+        timestamp: Date.now()
+      }, client.id);
+    }
+  }
+  /**
+   * Ping all clients to check if they're alive
+   */
+  pingClients() {
+    for (const client of this.clients.values()) {
+      if (!client.isAlive) {
+        client.socket.terminate();
+        this.handleDisconnect(client, 4002, "Ping timeout");
+        continue;
+      }
+      client.isAlive = false;
+      client.socket.ping();
+    }
+  }
+  // ============================================================================
+  // PUBLIC API
+  // ============================================================================
+  /**
+   * Register a handler for connection events
+   */
+  onConnection(handler) {
+    this.connectionHandlers.push(handler);
+    return this;
+  }
+  /**
+   * Register a handler for disconnect events
+   */
+  onDisconnect(handler) {
+    this.disconnectHandlers.push(handler);
+    return this;
+  }
+  /**
+   * Register a handler for a specific event type
+   */
+  onEvent(eventType, handler) {
+    const handlers = this.eventHandlers.get(eventType) || [];
+    handlers.push(handler);
+    this.eventHandlers.set(eventType, handlers);
+    return this;
+  }
+  /**
+   * Send a message to a specific client
+   */
+  sendToClient(client, message) {
+    if (client.socket.readyState === WebSocket.OPEN) {
+      client.socket.send(JSON.stringify(message));
+      return true;
+    }
+    return false;
+  }
+  /**
+   * Send a message to a client by ID
+   */
+  sendToId(clientId, message) {
+    const client = this.clients.get(clientId);
+    if (client) {
+      return this.sendToClient(client, message);
+    }
+    return false;
+  }
+  /**
+   * Broadcast to all clients in a room
+   */
+  broadcastToRoom(roomName, message, excludeId) {
+    const room = this.rooms.get(roomName);
+    if (!room) return;
+    message.room = roomName;
+    for (const clientId of room.clients) {
+      if (clientId !== excludeId) {
+        const client = this.clients.get(clientId);
+        if (client) {
+          this.sendToClient(client, message);
+        }
+      }
+    }
+  }
+  /**
+   * Broadcast to all connected clients
+   */
+  broadcastToAll(message, excludeId) {
+    for (const [clientId, client] of this.clients) {
+      if (clientId !== excludeId) {
+        this.sendToClient(client, message);
+      }
+    }
+  }
+  /**
+   * Get all clients in a room
+   */
+  getRoom(roomName) {
+    return this.rooms.get(roomName);
+  }
+  /**
+   * Get client by ID
+   */
+  getClient(clientId) {
+    return this.clients.get(clientId);
+  }
+  /**
+   * Get presence data for a room
+   */
+  getRoomPresence(roomName) {
+    const room = this.rooms.get(roomName);
+    if (!room) return [];
+    return Array.from(room.clients).map((clientId) => {
+      const client = this.clients.get(clientId);
+      return {
+        clientId,
+        data: client?.data || {},
+        joinedAt: client?.connectedAt || /* @__PURE__ */ new Date(),
+        lastSeen: /* @__PURE__ */ new Date()
+      };
+    });
+  }
+  /**
+   * Get all connected clients count
+   */
+  get clientCount() {
+    return this.clients.size;
+  }
+  /**
+   * Get all rooms count
+   */
+  get roomCount() {
+    return this.rooms.size;
+  }
+  /**
+   * Generate a unique client ID
+   */
+  generateId() {
+    return `client_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
+  }
+};
+function createRealtimeClient(options) {
+  const {
+    url,
+    autoReconnect = true,
+    reconnectInterval = 3e3,
+    maxReconnectAttempts = 10
+  } = options;
+  let ws = null;
+  let reconnectAttempts = 0;
+  let clientId = null;
+  const eventHandlers = /* @__PURE__ */ new Map();
+  const rooms = /* @__PURE__ */ new Set();
+  const connect = () => {
+    return new Promise((resolve, reject) => {
+      try {
+        ws = new WebSocket(url);
+        ws.onopen = () => {
+          reconnectAttempts = 0;
+          console.log("\u{1F50C} Connected to Float.js Realtime");
+        };
+        ws.onmessage = (event) => {
+          try {
+            const data = typeof event.data === "string" ? event.data : String(event.data);
+            const message = JSON.parse(data);
+            if (message.type === "_connected") {
+              clientId = message.payload.id;
+              resolve();
+              return;
+            }
+            const handlers = eventHandlers.get(message.type);
+            if (handlers) {
+              handlers.forEach((handler) => handler(message.payload));
+            }
+            const allHandlers = eventHandlers.get("*");
+            if (allHandlers) {
+              allHandlers.forEach((handler) => handler(message));
+            }
+          } catch (error) {
+            console.error("Failed to parse message:", error);
+          }
+        };
+        ws.onclose = () => {
+          console.log("\u{1F50C} Disconnected from Float.js Realtime");
+          clientId = null;
+          if (autoReconnect && reconnectAttempts < maxReconnectAttempts) {
+            reconnectAttempts++;
+            console.log(`Reconnecting in ${reconnectInterval}ms (attempt ${reconnectAttempts}/${maxReconnectAttempts})`);
+            setTimeout(() => {
+              connect().then(() => {
+                rooms.forEach((room) => {
+                  send({ type: "_join", payload: { room } });
+                });
+              });
+            }, reconnectInterval);
+          }
+        };
+        ws.onerror = (error) => {
+          console.error("WebSocket error:", error);
+          reject(error);
+        };
+      } catch (error) {
+        reject(error);
+      }
+    });
+  };
+  const disconnect = () => {
+    if (ws) {
+      ws.close(1e3, "Client disconnect");
+      ws = null;
+    }
+  };
+  const send = (message) => {
+    if (ws && ws.readyState === WebSocket.OPEN) {
+      ws.send(JSON.stringify({
+        ...message,
+        timestamp: Date.now()
+      }));
+    }
+  };
+  const join = (room, data) => {
+    rooms.add(room);
+    send({ type: "_join", payload: { room, data } });
+  };
+  const leave = (room) => {
+    rooms.delete(room);
+    send({ type: "_leave", payload: { room } });
+  };
+  const broadcast = (room, type, data) => {
+    send({
+      type: "_broadcast",
+      payload: { room, type, data }
+    });
+  };
+  const emit = (type, data) => {
+    send({ type, payload: data });
+  };
+  const on = (eventType, handler) => {
+    if (!eventHandlers.has(eventType)) {
+      eventHandlers.set(eventType, /* @__PURE__ */ new Set());
+    }
+    eventHandlers.get(eventType).add(handler);
+    return () => {
+      eventHandlers.get(eventType)?.delete(handler);
+    };
+  };
+  const updatePresence = (data) => {
+    send({ type: "_presence", payload: data });
+  };
+  return {
+    connect,
+    disconnect,
+    join,
+    leave,
+    broadcast,
+    emit,
+    on,
+    updatePresence,
+    get id() {
+      return clientId;
+    },
+    get connected() {
+      return ws?.readyState === WebSocket.OPEN;
+    }
+  };
+}
+var realtimeInstance = null;
+function getRealtimeServer(options) {
+  if (!realtimeInstance) {
+    realtimeInstance = new FloatRealtime(options);
+  }
+  return realtimeInstance;
+}
+var realtime = {
+  create: (options) => new FloatRealtime(options),
+  server: getRealtimeServer,
+  client: createRealtimeClient
+};
+export {
+  FloatRealtime,
+  createRealtimeClient,
+  getRealtimeServer,
+  realtime
+};
+//# sourceMappingURL=index.js.map

package/dist/realtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/realtime/index.ts"],"sourcesContent":["/**\n * Float.js Real-time Module\n * Built-in WebSocket support with rooms, presence, and broadcasting\n * \n * NO plugins needed - real-time is native to Float.js!\n */\n\nimport { WebSocketServer, WebSocket } from 'ws';\nimport { createServer, IncomingMessage } from 'http';\nimport type { Server as HTTPServer } from 'http';\nimport { EventEmitter } from 'events';\n\n// ============================================================================\n// TYPES\n// ============================================================================\n\nexport interface RealtimeClient {\n  id: string;\n  socket: WebSocket;\n  rooms: Set<string>;\n  data: Record<string, unknown>;\n  isAlive: boolean;\n  connectedAt: Date;\n}\n\nexport interface RealtimeMessage<T = unknown> {\n  type: string;\n  payload: T;\n  from?: string;\n  room?: string;\n  timestamp: number;\n}\n\nexport interface RealtimeRoom {\n  name: string;\n  clients: Set<string>;\n  metadata: Record<string, unknown>;\n  createdAt: Date;\n}\n\nexport interface PresenceState {\n  clientId: string;\n  data: Record<string, unknown>;\n  joinedAt: Date;\n  lastSeen: Date;\n}\n\nexport interface RealtimeOptions {\n  /** Port for WebSocket server (default: 3001) */\n  port?: number;\n  /** Path for WebSocket endpoint (default: '/ws') */\n  path?: string;\n  /** Ping interval in ms (default: 30000) */\n  pingInterval?: number;\n  /** Max message size in bytes (default: 1MB) */\n  maxPayload?: number;\n  /** Enable presence tracking (default: true) */\n  presence?: boolean;\n  /** Custom authentication handler */\n  authenticate?: (request: IncomingMessage) => Promise<{ id: string; data?: Record<string, unknown> } | null>;\n}\n\ntype EventHandler<T = unknown> = (message: RealtimeMessage<T>, client: RealtimeClient) => void | Promise<void>;\ntype ConnectionHandler = (client: RealtimeClient) => void | Promise<void>;\ntype DisconnectHandler = (client: RealtimeClient, code: number, reason: string) => void | Promise<void>;\n\n// ============================================================================\n// REALTIME SERVER\n// ============================================================================\n\nexport class FloatRealtime extends EventEmitter {\n  private wss: WebSocketServer | null = null;\n  private httpServer: HTTPServer | null = null;\n  private clients: Map<string, RealtimeClient> = new Map();\n  private rooms: Map<string, RealtimeRoom> = new Map();\n  private eventHandlers: Map<string, EventHandler[]> = new Map();\n  private connectionHandlers: ConnectionHandler[] = [];\n  private disconnectHandlers: DisconnectHandler[] = [];\n  private pingInterval: NodeJS.Timeout | null = null;\n  private options: Required<RealtimeOptions>;\n\n  constructor(options: RealtimeOptions = {}) {\n    super();\n    this.options = {\n      port: options.port ?? 3001,\n      path: options.path ?? '/ws',\n      pingInterval: options.pingInterval ?? 30000,\n      maxPayload: options.maxPayload ?? 1024 * 1024, // 1MB\n      presence: options.presence ?? true,\n      authenticate: options.authenticate ?? (async () => ({ id: this.generateId() })),\n    };\n  }\n\n  /**\n   * Start the WebSocket server\n   */\n  async start(): Promise<void> {\n    return new Promise((resolve) => {\n      this.httpServer = createServer();\n      \n      this.wss = new WebSocketServer({\n        server: this.httpServer,\n        path: this.options.path,\n        maxPayload: this.options.maxPayload,\n      });\n\n      this.wss.on('connection', (socket, request) => {\n        this.handleConnection(socket, request);\n      });\n\n      // Start ping interval\n      this.pingInterval = setInterval(() => {\n        this.pingClients();\n      }, this.options.pingInterval);\n\n      this.httpServer.listen(this.options.port, () => {\n        console.log(`🔌 Float.js Realtime running on ws://localhost:${this.options.port}${this.options.path}`);\n        resolve();\n      });\n    });\n  }\n\n  /**\n   * Stop the WebSocket server\n   */\n  async stop(): Promise<void> {\n    if (this.pingInterval) {\n      clearInterval(this.pingInterval);\n    }\n\n    // Close all client connections\n    for (const client of this.clients.values()) {\n      client.socket.close(1000, 'Server shutting down');\n    }\n\n    return new Promise((resolve) => {\n      if (this.wss) {\n        this.wss.close(() => {\n          if (this.httpServer) {\n            this.httpServer.close(() => {\n              resolve();\n            });\n          } else {\n            resolve();\n          }\n        });\n      } else {\n        resolve();\n      }\n    });\n  }\n\n  /**\n   * Handle new WebSocket connection\n   */\n  private async handleConnection(socket: WebSocket, request: IncomingMessage): Promise<void> {\n    try {\n      // Authenticate\n      const authResult = await this.options.authenticate(request);\n      if (!authResult) {\n        socket.close(4001, 'Unauthorized');\n        return;\n      }\n\n      // Create client\n      const client: RealtimeClient = {\n        id: authResult.id,\n        socket,\n        rooms: new Set(),\n        data: authResult.data || {},\n        isAlive: true,\n        connectedAt: new Date(),\n      };\n\n      this.clients.set(client.id, client);\n\n      // Send welcome message\n      this.sendToClient(client, {\n        type: '_connected',\n        payload: {\n          id: client.id,\n          connectedAt: client.connectedAt,\n        },\n        timestamp: Date.now(),\n      });\n\n      // Handle pong\n      socket.on('pong', () => {\n        client.isAlive = true;\n      });\n\n      // Handle messages\n      socket.on('message', (data) => {\n        this.handleMessage(client, data);\n      });\n\n      // Handle close\n      socket.on('close', (code, reason) => {\n        this.handleDisconnect(client, code, reason.toString());\n      });\n\n      // Handle error\n      socket.on('error', (error) => {\n        console.error(`WebSocket error for client ${client.id}:`, error);\n      });\n\n      // Notify connection handlers\n      for (const handler of this.connectionHandlers) {\n        await handler(client);\n      }\n\n      this.emit('connection', client);\n    } catch (error) {\n      console.error('Connection error:', error);\n      socket.close(4000, 'Connection error');\n    }\n  }\n\n  /**\n   * Handle incoming message\n   */\n  private async handleMessage(client: RealtimeClient, rawData: WebSocket.Data): Promise<void> {\n    try {\n      const message = JSON.parse(rawData.toString()) as RealtimeMessage;\n      message.from = client.id;\n      message.timestamp = Date.now();\n\n      // Handle built-in message types\n      switch (message.type) {\n        case '_join':\n          await this.handleJoin(client, message.payload as { room: string; data?: Record<string, unknown> });\n          return;\n        case '_leave':\n          await this.handleLeave(client, message.payload as { room: string });\n          return;\n        case '_broadcast':\n          await this.handleBroadcast(client, message);\n          return;\n        case '_presence':\n          await this.handlePresenceUpdate(client, message.payload as Record<string, unknown>);\n          return;\n      }\n\n      // Handle custom events\n      const handlers = this.eventHandlers.get(message.type) || [];\n      for (const handler of handlers) {\n        await handler(message, client);\n      }\n\n      this.emit('message', message, client);\n    } catch (error) {\n      console.error('Message handling error:', error);\n    }\n  }\n\n  /**\n   * Handle client disconnect\n   */\n  private async handleDisconnect(client: RealtimeClient, code: number, reason: string): Promise<void> {\n    // Leave all rooms\n    for (const roomName of client.rooms) {\n      const room = this.rooms.get(roomName);\n      if (room) {\n        room.clients.delete(client.id);\n        \n        // Notify room members\n        this.broadcastToRoom(roomName, {\n          type: '_presence_leave',\n          payload: { clientId: client.id },\n          timestamp: Date.now(),\n        }, client.id);\n\n        // Delete empty rooms\n        if (room.clients.size === 0) {\n          this.rooms.delete(roomName);\n        }\n      }\n    }\n\n    // Remove client\n    this.clients.delete(client.id);\n\n    // Notify disconnect handlers\n    for (const handler of this.disconnectHandlers) {\n      await handler(client, code, reason);\n    }\n\n    this.emit('disconnect', client, code, reason);\n  }\n\n  /**\n   * Handle room join\n   */\n  private async handleJoin(client: RealtimeClient, payload: { room: string; data?: Record<string, unknown> }): Promise<void> {\n    const { room: roomName, data } = payload;\n\n    // Create room if doesn't exist\n    let room = this.rooms.get(roomName);\n    if (!room) {\n      room = {\n        name: roomName,\n        clients: new Set(),\n        metadata: {},\n        createdAt: new Date(),\n      };\n      this.rooms.set(roomName, room);\n    }\n\n    // Add client to room\n    room.clients.add(client.id);\n    client.rooms.add(roomName);\n\n    // Update client data\n    if (data) {\n      client.data = { ...client.data, ...data };\n    }\n\n    // Send confirmation\n    this.sendToClient(client, {\n      type: '_joined',\n      payload: {\n        room: roomName,\n        members: this.getRoomPresence(roomName),\n      },\n      timestamp: Date.now(),\n    });\n\n    // Notify other members\n    if (this.options.presence) {\n      this.broadcastToRoom(roomName, {\n        type: '_presence_join',\n        payload: {\n          clientId: client.id,\n          data: client.data,\n          joinedAt: new Date(),\n        },\n        timestamp: Date.now(),\n      }, client.id);\n    }\n\n    this.emit('join', client, roomName);\n  }\n\n  /**\n   * Handle room leave\n   */\n  private async handleLeave(client: RealtimeClient, payload: { room: string }): Promise<void> {\n    const { room: roomName } = payload;\n    const room = this.rooms.get(roomName);\n\n    if (room) {\n      room.clients.delete(client.id);\n      client.rooms.delete(roomName);\n\n      // Notify other members\n      if (this.options.presence) {\n        this.broadcastToRoom(roomName, {\n          type: '_presence_leave',\n          payload: { clientId: client.id },\n          timestamp: Date.now(),\n        });\n      }\n\n      // Delete empty rooms\n      if (room.clients.size === 0) {\n        this.rooms.delete(roomName);\n      }\n    }\n\n    // Send confirmation\n    this.sendToClient(client, {\n      type: '_left',\n      payload: { room: roomName },\n      timestamp: Date.now(),\n    });\n\n    this.emit('leave', client, roomName);\n  }\n\n  /**\n   * Handle broadcast message\n   */\n  private async handleBroadcast(client: RealtimeClient, message: RealtimeMessage): Promise<void> {\n    const { room } = message.payload as { room?: string; data: unknown };\n    const broadcastMessage = {\n      ...message,\n      type: (message.payload as { type?: string }).type || 'broadcast',\n      payload: (message.payload as { data?: unknown }).data,\n    };\n\n    if (room) {\n      this.broadcastToRoom(room, broadcastMessage, client.id);\n    } else {\n      this.broadcastToAll(broadcastMessage, client.id);\n    }\n  }\n\n  /**\n   * Handle presence update\n   */\n  private async handlePresenceUpdate(client: RealtimeClient, data: Record<string, unknown>): Promise<void> {\n    client.data = { ...client.data, ...data };\n\n    // Broadcast to all rooms the client is in\n    for (const roomName of client.rooms) {\n      this.broadcastToRoom(roomName, {\n        type: '_presence_update',\n        payload: {\n          clientId: client.id,\n          data: client.data,\n        },\n        timestamp: Date.now(),\n      }, client.id);\n    }\n  }\n\n  /**\n   * Ping all clients to check if they're alive\n   */\n  private pingClients(): void {\n    for (const client of this.clients.values()) {\n      if (!client.isAlive) {\n        client.socket.terminate();\n        this.handleDisconnect(client, 4002, 'Ping timeout');\n        continue;\n      }\n\n      client.isAlive = false;\n      client.socket.ping();\n    }\n  }\n\n  // ============================================================================\n  // PUBLIC API\n  // ============================================================================\n\n  /**\n   * Register a handler for connection events\n   */\n  onConnection(handler: ConnectionHandler): this {\n    this.connectionHandlers.push(handler);\n    return this;\n  }\n\n  /**\n   * Register a handler for disconnect events\n   */\n  onDisconnect(handler: DisconnectHandler): this {\n    this.disconnectHandlers.push(handler);\n    return this;\n  }\n\n  /**\n   * Register a handler for a specific event type\n   */\n  onEvent<T = unknown>(eventType: string, handler: EventHandler<T>): this {\n    const handlers = this.eventHandlers.get(eventType) || [];\n    handlers.push(handler as EventHandler);\n    this.eventHandlers.set(eventType, handlers);\n    return this;\n  }\n\n  /**\n   * Send a message to a specific client\n   */\n  sendToClient(client: RealtimeClient, message: RealtimeMessage): boolean {\n    if (client.socket.readyState === WebSocket.OPEN) {\n      client.socket.send(JSON.stringify(message));\n      return true;\n    }\n    return false;\n  }\n\n  /**\n   * Send a message to a client by ID\n   */\n  sendToId(clientId: string, message: RealtimeMessage): boolean {\n    const client = this.clients.get(clientId);\n    if (client) {\n      return this.sendToClient(client, message);\n    }\n    return false;\n  }\n\n  /**\n   * Broadcast to all clients in a room\n   */\n  broadcastToRoom(roomName: string, message: RealtimeMessage, excludeId?: string): void {\n    const room = this.rooms.get(roomName);\n    if (!room) return;\n\n    message.room = roomName;\n\n    for (const clientId of room.clients) {\n      if (clientId !== excludeId) {\n        const client = this.clients.get(clientId);\n        if (client) {\n          this.sendToClient(client, message);\n        }\n      }\n    }\n  }\n\n  /**\n   * Broadcast to all connected clients\n   */\n  broadcastToAll(message: RealtimeMessage, excludeId?: string): void {\n    for (const [clientId, client] of this.clients) {\n      if (clientId !== excludeId) {\n        this.sendToClient(client, message);\n      }\n    }\n  }\n\n  /**\n   * Get all clients in a room\n   */\n  getRoom(roomName: string): RealtimeRoom | undefined {\n    return this.rooms.get(roomName);\n  }\n\n  /**\n   * Get client by ID\n   */\n  getClient(clientId: string): RealtimeClient | undefined {\n    return this.clients.get(clientId);\n  }\n\n  /**\n   * Get presence data for a room\n   */\n  getRoomPresence(roomName: string): PresenceState[] {\n    const room = this.rooms.get(roomName);\n    if (!room) return [];\n\n    return Array.from(room.clients).map((clientId) => {\n      const client = this.clients.get(clientId);\n      return {\n        clientId,\n        data: client?.data || {},\n        joinedAt: client?.connectedAt || new Date(),\n        lastSeen: new Date(),\n      };\n    });\n  }\n\n  /**\n   * Get all connected clients count\n   */\n  get clientCount(): number {\n    return this.clients.size;\n  }\n\n  /**\n   * Get all rooms count\n   */\n  get roomCount(): number {\n    return this.rooms.size;\n  }\n\n  /**\n   * Generate a unique client ID\n   */\n  private generateId(): string {\n    return `client_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;\n  }\n}\n\n// ============================================================================\n// CLIENT-SIDE REALTIME (for browser)\n// ============================================================================\n\nexport interface RealtimeClientOptions {\n  url: string;\n  autoReconnect?: boolean;\n  reconnectInterval?: number;\n  maxReconnectAttempts?: number;\n}\n\n/**\n * Create a client-side realtime connection\n * This code is isomorphic and can run in the browser\n */\nexport function createRealtimeClient(options: RealtimeClientOptions) {\n  const {\n    url,\n    autoReconnect = true,\n    reconnectInterval = 3000,\n    maxReconnectAttempts = 10,\n  } = options;\n\n  let ws: WebSocket | null = null;\n  let reconnectAttempts = 0;\n  let clientId: string | null = null;\n  const eventHandlers = new Map<string, Set<(payload: unknown) => void>>();\n  const rooms = new Set<string>();\n\n  const connect = (): Promise<void> => {\n    return new Promise((resolve, reject) => {\n      try {\n        ws = new WebSocket(url);\n\n        ws.onopen = () => {\n          reconnectAttempts = 0;\n          console.log('🔌 Connected to Float.js Realtime');\n        };\n\n        ws.onmessage = (event) => {\n          try {\n            const data = typeof event.data === 'string' ? event.data : String(event.data);\n            const message = JSON.parse(data) as RealtimeMessage;\n            \n            // Handle system messages\n            if (message.type === '_connected') {\n              clientId = (message.payload as { id: string }).id;\n              resolve();\n              return;\n            }\n\n            // Emit to handlers\n            const handlers = eventHandlers.get(message.type);\n            if (handlers) {\n              handlers.forEach(handler => handler(message.payload));\n            }\n\n            // Also emit to 'message' handlers for all messages\n            const allHandlers = eventHandlers.get('*');\n            if (allHandlers) {\n              allHandlers.forEach(handler => handler(message));\n            }\n          } catch (error) {\n            console.error('Failed to parse message:', error);\n          }\n        };\n\n        ws.onclose = () => {\n          console.log('🔌 Disconnected from Float.js Realtime');\n          clientId = null;\n\n          if (autoReconnect && reconnectAttempts < maxReconnectAttempts) {\n            reconnectAttempts++;\n            console.log(`Reconnecting in ${reconnectInterval}ms (attempt ${reconnectAttempts}/${maxReconnectAttempts})`);\n            setTimeout(() => {\n              connect().then(() => {\n                // Rejoin rooms after reconnect\n                rooms.forEach(room => {\n                  send({ type: '_join', payload: { room } });\n                });\n              });\n            }, reconnectInterval);\n          }\n        };\n\n        ws.onerror = (error) => {\n          console.error('WebSocket error:', error);\n          reject(error);\n        };\n      } catch (error) {\n        reject(error);\n      }\n    });\n  };\n\n  const disconnect = () => {\n    if (ws) {\n      ws.close(1000, 'Client disconnect');\n      ws = null;\n    }\n  };\n\n  const send = (message: Partial<RealtimeMessage>) => {\n    if (ws && ws.readyState === WebSocket.OPEN) {\n      ws.send(JSON.stringify({\n        ...message,\n        timestamp: Date.now(),\n      }));\n    }\n  };\n\n  const join = (room: string, data?: Record<string, unknown>) => {\n    rooms.add(room);\n    send({ type: '_join', payload: { room, data } });\n  };\n\n  const leave = (room: string) => {\n    rooms.delete(room);\n    send({ type: '_leave', payload: { room } });\n  };\n\n  const broadcast = (room: string, type: string, data: unknown) => {\n    send({\n      type: '_broadcast',\n      payload: { room, type, data },\n    });\n  };\n\n  const emit = (type: string, data: unknown) => {\n    send({ type, payload: data });\n  };\n\n  const on = <T = unknown>(eventType: string, handler: (payload: T) => void) => {\n    if (!eventHandlers.has(eventType)) {\n      eventHandlers.set(eventType, new Set());\n    }\n    eventHandlers.get(eventType)!.add(handler as (payload: unknown) => void);\n\n    // Return unsubscribe function\n    return () => {\n      eventHandlers.get(eventType)?.delete(handler as (payload: unknown) => void);\n    };\n  };\n\n  const updatePresence = (data: Record<string, unknown>) => {\n    send({ type: '_presence', payload: data });\n  };\n\n  return {\n    connect,\n    disconnect,\n    join,\n    leave,\n    broadcast,\n    emit,\n    on,\n    updatePresence,\n    get id() { return clientId; },\n    get connected() { return ws?.readyState === WebSocket.OPEN; },\n  };\n}\n\n// ============================================================================\n// SINGLETON INSTANCE\n// ============================================================================\n\nlet realtimeInstance: FloatRealtime | null = null;\n\n/**\n * Get or create the realtime server instance\n */\nexport function getRealtimeServer(options?: RealtimeOptions): FloatRealtime {\n  if (!realtimeInstance) {\n    realtimeInstance = new FloatRealtime(options);\n  }\n  return realtimeInstance;\n}\n\n/**\n * Shorthand export for easy usage\n */\nexport const realtime = {\n  create: (options?: RealtimeOptions) => new FloatRealtime(options),\n  server: getRealtimeServer,\n  client: createRealtimeClient,\n};\n"],"mappings":"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","names":[]}

package/dist/router/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Float.js Router
+ * File-based routing system
+ */
+interface Route {
+    /** URL path pattern (e.g., /users/:id) */
+    path: string;
+    /** File path relative to app directory */
+    filePath: string;
+    /** Absolute file path */
+    absolutePath: string;
+    /** Route type */
+    type: 'page' | 'layout' | 'api' | 'error' | 'loading';
+    /** Dynamic segments */
+    params: string[];
+    /** Is catch-all route */
+    isCatchAll: boolean;
+    /** Is optional catch-all */
+    isOptionalCatchAll: boolean;
+    /** Nested layouts */
+    layouts: string[];
+}
+interface RouterOptions {
+    /** Root directory of the app (default: 'app') */
+    appDir?: string;
+    /** Base path for all routes */
+    basePath?: string;
+    /** File extensions to consider */
+    extensions?: string[];
+}
+/**
+ * Scan app directory and build routes
+ */
+declare function scanRoutes(rootDir: string, options?: RouterOptions): Promise<Route[]>;
+/**
+ * Match a URL path to a route
+ */
+declare function matchRoute(url: string, routes: Route[]): {
+    route: Route | null;
+    params: Record<string, string>;
+};
+
+export { type Route as FloatRoute, type RouterOptions as FloatRouterOptions, type Route, type RouterOptions, matchRoute, scanRoutes };