@emeryld/rrroutes-client 2.7.9 → 2.7.11

package/dist/sockets/socket.client.context.client.d.ts

@@ -1,5 +1,5 @@
 import type { EventMap, SocketConnectionConfigOutput } from '@emeryld/rrroutes-contract';
 import * as React from 'react';
 import { SocketClient } from './socket.client.core';
-export declare const SocketCtx: React.Context<SocketClient<any, SocketConnectionConfigOutput> | null>;
+export declare const SocketCtx: React.Context<SocketClient<any, SocketConnectionConfigOutput> | null | undefined>;
 export declare function useSocketClient<T extends EventMap, C extends SocketConnectionConfigOutput>(): SocketClient<T, C> | null;

package/dist/sockets/socket.client.context.connection.d.ts

@@ -1,6 +1,33 @@
 import type { EventMap, Payload, SocketConnectionConfigOutput, SocketSchemaOutput } from '@emeryld/rrroutes-contract';
 import type { ClientCtx, ServerEnvelope } from './socket.client.core';
 type Rooms = string[] | string | undefined;
+export type UseSocketConnectionDebugEvent = {
+    type: 'lifecycle';
+    phase: 'effect_start' | 'effect_cleanup' | 'client_missing';
+    event: string;
+    rooms: string[];
+    autoJoin: boolean;
+    autoLeave: boolean;
+} | {
+    type: 'subscription';
+    phase: 'register' | 'unregister' | 'message';
+    event: string;
+} | {
+    type: 'room';
+    phase: 'join_attempt' | 'join_ok' | 'join_error' | 'leave_attempt' | 'leave_ok' | 'leave_error' | 'join_skip' | 'leave_skip';
+    rooms: string[];
+    reason?: 'no_rooms' | 'auto_disabled';
+    err?: string;
+};
+export type UseSocketConnectionDebugOptions = {
+    enabled?: boolean;
+    logger?: (event: UseSocketConnectionDebugEvent) => void;
+    lifecycle?: boolean;
+    subscription?: boolean;
+    room?: boolean;
+    warnIfClientMissing?: boolean;
+    throwIfClientMissing?: boolean;
+};
 export type UseSocketConnectionArgs<T extends EventMap, K extends keyof T & string, C extends SocketConnectionConfigOutput> = {
     event: K;
     rooms?: Rooms;
@@ -11,6 +38,7 @@ export type UseSocketConnectionArgs<T extends EventMap, K extends keyof T & stri
     onCleanup?: () => void;
     autoJoin?: boolean;
     autoLeave?: boolean;
+    debug?: UseSocketConnectionDebugOptions;
     joinMeta: SocketSchemaOutput<C['joinMetaMessage']>;
     leaveMeta: SocketSchemaOutput<C['leaveMetaMessage']>;
 };

package/dist/sockets/socket.client.context.d.ts

@@ -1,4 +1,4 @@
 export { buildSocketProvider } from './socket.client.context.provider';
 export { useSocketClient } from './socket.client.context.client';
-export { useSocketConnection, type UseSocketConnectionArgs, } from './socket.client.context.connection';
+export { useSocketConnection, type UseSocketConnectionDebugEvent, type UseSocketConnectionDebugOptions, type UseSocketConnectionArgs, } from './socket.client.context.connection';
 export type { SocketProviderDebugEvent, SocketProviderDebugOptions, } from './socket.client.context.debug';

package/package.json

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