@emeryld/rrroutes-client 2.6.0 → 2.6.1

package/dist/sockets/socketedRoute/socket.client.helper.d.ts

@@ -2,6 +2,42 @@ import type { AnyLeafLowProfile, EventMap, InferOutput, Payload, SocketConnectio
 import type { BuiltInfinite, BuiltQuery, DataShape, InfiniteUseEndpointResultFor, QueryUseEndpointResultFor, UseEndpointArgs } from '../../routesV3.client.types';
 import type { ClientCtx, ServerEnvelope, SocketClient } from '../socket.client.index';
 type RoomsInput = string | string[] | undefined | null;
+type HookDebugReason = 'init' | 'change';
+type HookDebugValue = string | number | boolean | null | undefined;
+export type SocketedRouteDebugEvent = {
+    type: 'client';
+    phase: 'ready' | 'missing';
+    err?: string;
+} | {
+    type: 'render';
+    renderCount: number;
+    hasClient: boolean;
+    argsKey: string;
+    rooms: string[];
+    roomsKey: string;
+    joinMetaKey: string;
+    leaveMetaKey: string;
+} | {
+    type: 'hook';
+    phase: 'endpoint_on_receive_effect' | 'derive_rooms_effect' | 'join_rooms_effect' | 'apply_socket_effect';
+    reason: HookDebugReason;
+    changes: Array<{
+        dependency: string;
+        previous: HookDebugValue;
+        next: HookDebugValue;
+    }>;
+} | {
+    type: 'room';
+    phase: 'join_attempt' | 'join_skip' | 'join_error' | 'leave_attempt' | 'leave_skip' | 'leave_error';
+    rooms: string[];
+    reason?: string;
+    err?: string;
+};
+export type SocketedRouteDebugOptions = {
+    logger?: (event: SocketedRouteDebugEvent) => void;
+} & {
+    [P in SocketedRouteDebugEvent['type']]?: boolean;
+};
 type SocketedBuilt<L extends AnyLeafLowProfile> = L['cfg']['feed'] extends true ? BuiltInfinite<L> : BuiltQuery<L>;
 type SocketedRouteResult<L extends AnyLeafLowProfile> = (L['cfg']['feed'] extends true ? InfiniteUseEndpointResultFor<L> : QueryUseEndpointResultFor<L>) & {
     rooms: string[];
@@ -20,6 +56,7 @@ export type SocketedRouteOptions<L extends AnyLeafLowProfile, Events extends Eve
         }) => DataShape<L> | undefined;
     };
     useSocketClient: () => SocketClient<Events, C>;
+    debug?: SocketedRouteDebugOptions;
 };
 /**
  * Compose a GET endpoint with socket wiring:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emeryld/rrroutes-client",
-  "version": "2.6.0",
+  "version": "2.6.1",
   "private": false,
   "type": "module",
   "main": "dist/index.cjs",