@emeryld/rrroutes-server 2.0.2 → 2.0.4

package/dist/sockets/socket.server.index.d.ts

@@ -18,6 +18,8 @@ export interface SocketConnection<T extends EventMap> {
     on<K extends keyof T & string>(eventName: K, handler: (payload: Payload<T, K>, ctx: HandlerCtx) => void | Promise<void>): () => void;
     off<K extends keyof T & string>(eventName: K): void;
     emit<K extends keyof T & string>(eventName: K, payload: Payload<T, K>, toRooms?: string[] | string, metadata?: Record<string, unknown>, onAck?: (ack: unknown) => void): void;
+    /** Dispose all listeners, timers, and room memberships created by this instance. */
+    destroy(): void;
 }
 /**
  * Grouped debug types:
@@ -99,9 +101,66 @@ export type HeartbeatServerOptions<Ping extends ZodType, Pong extends ZodType> =
     /** Optionally validate the outgoing pong object before emit. */
     pongSchema?: Pong;
 };
+/** === Server sys-event types (inspired by client) === */
+type BaseSysServerArgs = {
+    socket: Socket;
+    next: () => void;
+};
+export type SysServerConnectHandlerArgs = BaseSysServerArgs & {
+    name: 'sys:connect';
+};
+export type SysServerDisconnectHandlerArgs = BaseSysServerArgs & {
+    name: 'sys:disconnect';
+    reason: string;
+};
+export type SysServerPingHandlerArgs<Ping extends ZodType = ZodType, Pong extends ZodType = ZodType> = {
+    name: 'sys:ping';
+    socket: Socket;
+    raw: {
+        payload?: unknown;
+    } | undefined;
+    ack?: (x: {
+        serverNow: string;
+    }) => void;
+    next: () => void;
+};
+export type SysServerPongHandlerArgs<Pong extends ZodType = ZodType> = {
+    name: 'sys:pong';
+    socket: Socket;
+    payload: NoInfer<z.infer<Pong>> | unknown;
+    next: () => void;
+};
+export type SysServerRoomHandlerArgs = {
+    name: 'sys:room_join' | 'sys:room_leave';
+    socket: Socket;
+    rooms: string[];
+    next: () => void;
+};
+export type SysServerEventMap<Ping extends ZodType = ZodType, Pong extends ZodType = ZodType> = {
+    'sys:connect'?: {
+        sysHandler: (args: SysServerConnectHandlerArgs) => void | Promise<void>;
+    };
+    'sys:disconnect'?: {
+        sysHandler: (args: SysServerDisconnectHandlerArgs) => void | Promise<void>;
+    };
+    'sys:ping'?: {
+        sysHandler: (args: SysServerPingHandlerArgs<Ping, Pong>) => void | Promise<void>;
+    };
+    'sys:pong'?: {
+        sysHandler: (args: SysServerPongHandlerArgs<Pong>) => void | Promise<void>;
+    };
+    'sys:room_join'?: {
+        sysHandler: (args: SysServerRoomHandlerArgs) => void | Promise<void>;
+    };
+    'sys:room_leave'?: {
+        sysHandler: (args: SysServerRoomHandlerArgs) => void | Promise<void>;
+    };
+};
 export declare function createSocketConnections<Ping extends ZodType, Pong extends ZodType, T extends EventMap>(io: Server, events: T, opts?: {
     debug?: SocketDebugOptions<Ping, Pong>;
     rooms?: BuiltInRoomHooks;
     heartbeat: HeartbeatServerOptions<Ping, Pong>;
+    /** NEW: system event customization (connect / disconnect / ping / pong / room join/leave) */
+    sys?: SysServerEventMap<Ping, Pong>;
 }): SocketConnection<T>;
 export type { EventMap, Payload };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emeryld/rrroutes-server",
-  "version": "2.0.2",
+  "version": "2.0.4",
   "private": false,
   "type": "module",
   "main": "dist/index.cjs",
@@ -17,7 +17,7 @@
     "dist"
   ],
   "dependencies": {
-    "@emeryld/rrroutes-contract": "^1.6.6",
+    "@emeryld/rrroutes-contract": "^2.0.3",
     "jose": "^6.1.1",
     "socket.io": "^4.8.1",
     "zod": "^4.1.12"