@emeryld/rrroutes-client 2.7.12 → 2.8.0

package/dist/routesV3.client.types.d.ts

@@ -276,7 +276,13 @@ export type BuiltMutation<L extends AnyLeafLowProfile> = BuiltCommon<L> & {
     fetch: MutationFetcher<L>;
 };
 /** Type-safe union that resolves to the correct built helper for a leaf. */
-export type BuiltForLeaf<L extends AnyLeafLowProfile> = L['method'] extends 'get' ? L['cfg']['feed'] extends true ? BuiltInfinite<L> : BuiltQuery<L> : BuiltMutation<L>;
+type BuiltLeafMetadata<L extends AnyLeafLowProfile> = {
+    metadata: {
+        leaf: L;
+    };
+};
+/** Type-safe union that resolves to the correct built helper for a leaf. */
+export type BuiltForLeaf<L extends AnyLeafLowProfile> = (L['method'] extends 'get' ? L['cfg']['feed'] extends true ? BuiltInfinite<L> : BuiltQuery<L> : BuiltMutation<L>) & BuiltLeafMetadata<L>;
 type LeafFromBuilt<B> = B extends BuiltForLeaf<infer L> ? L : AnyLeafLowProfile;
 type SetDataUpdaterFromBuilt<B> = B extends {
     setData: (updater: infer U, ...args: any[]) => any;

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

@@ -4,19 +4,20 @@ 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;
+    event?: string;
+    rooms?: string[];
+    autoJoin?: boolean;
+    autoLeave?: boolean;
 } | {
     type: 'subscription';
-    phase: 'register' | 'unregister' | 'message';
+    phase: 'register' | 'unregister' | 'message' | 'message_dropped_duplicate';
     event: string;
+    dedupeKey?: 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';
+    reason?: 'no_rooms' | 'auto_disabled' | 'disabled';
     err?: string;
 };
 export type UseSocketConnectionDebugOptions = {
@@ -26,21 +27,40 @@ export type UseSocketConnectionDebugOptions = {
     subscription?: boolean;
     room?: boolean;
     warnIfClientMissing?: boolean;
-    throwIfClientMissing?: boolean;
 };
-export type UseSocketConnectionArgs<T extends EventMap, K extends keyof T & string, C extends SocketConnectionConfigOutput> = {
-    event: K;
+export type UseSocketRoomsArgs<C extends SocketConnectionConfigOutput> = {
     rooms?: Rooms;
+    joinMeta: SocketSchemaOutput<C['joinMetaMessage']>;
+    leaveMeta: SocketSchemaOutput<C['leaveMetaMessage']>;
+    autoJoin?: boolean;
+    autoLeave?: boolean;
+    enabled?: boolean;
+    onCleanup?: () => void;
+    debug?: UseSocketConnectionDebugOptions;
+};
+export type UseSocketEventArgs<T extends EventMap, K extends keyof T & string, C extends SocketConnectionConfigOutput> = {
+    event: K;
     onMessage: (payload: Payload<T, K>, meta?: {
         envelope: ServerEnvelope<T[K]['__out']>;
         ctx: ClientCtx;
     }) => void;
+    enabled?: boolean;
     onCleanup?: () => void;
-    autoJoin?: boolean;
-    autoLeave?: boolean;
+    messageDeduplication?: false | {
+        ttlMs?: number;
+        key?: (payload: Payload<T, K>, meta?: {
+            envelope: ServerEnvelope<T[K]['__out']>;
+            ctx: ClientCtx;
+        }) => string | undefined;
+    };
     debug?: UseSocketConnectionDebugOptions;
-    joinMeta: SocketSchemaOutput<C['joinMetaMessage']>;
-    leaveMeta: SocketSchemaOutput<C['leaveMetaMessage']>;
+    _configBrand?: C;
 };
-export declare function useSocketConnection<T extends EventMap, K extends keyof T & string, C extends SocketConnectionConfigOutput>(args: UseSocketConnectionArgs<T, K, C>): void;
+export type UseSocketConnectionArgs<T extends EventMap, K extends keyof T & string, C extends SocketConnectionConfigOutput> = [
+    rooms: UseSocketRoomsArgs<C>,
+    event: UseSocketEventArgs<T, K, C>
+];
+export declare function useSocketRooms<C extends SocketConnectionConfigOutput>(args: UseSocketRoomsArgs<C>): void;
+export declare function useSocketEvent<T extends EventMap, K extends keyof T & string, C extends SocketConnectionConfigOutput>(args: UseSocketEventArgs<T, K, C>): void;
+export declare function useSocketConnection<T extends EventMap, K extends keyof T & string, C extends SocketConnectionConfigOutput>(roomsArgs: UseSocketRoomsArgs<C>, eventArgs: UseSocketEventArgs<T, K, C>): void;
 export {};

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 UseSocketConnectionDebugEvent, type UseSocketConnectionDebugOptions, type UseSocketConnectionArgs, } from './socket.client.context.connection';
+export { type UseSocketConnectionDebugEvent, type UseSocketConnectionDebugOptions, type UseSocketConnectionArgs, type UseSocketEventArgs, type UseSocketRoomsArgs, } from './socket.client.context.connection';
 export type { SocketProviderDebugEvent, SocketProviderDebugOptions, } from './socket.client.context.debug';

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

@@ -1,7 +1,7 @@
 import type { EventMap, SocketConnectionConfigOutput, SocketSchemaOutput } from '@emeryld/rrroutes-contract';
 import * as React from 'react';
 import type { Socket } from 'socket.io-client';
-import { type UseSocketConnectionArgs } from './socket.client.context.connection';
+import { type UseSocketEventArgs, type UseSocketConnectionArgs, type UseSocketRoomsArgs } from './socket.client.context.connection';
 import { SocketProviderDebugOptions } from './socket.client.context.debug';
 import { SocketClient, type SocketClientOptions } from './socket.client.core';
 type BaseOptions<T extends EventMap, C extends SocketConnectionConfigOutput> = Omit<SocketClientOptions<T, C>, 'socket'>;
@@ -37,6 +37,8 @@ export declare function buildSocketProvider<T extends EventMap, C extends Socket
         destroyLeaveMeta: SocketSchemaOutput<C["leaveMetaMessage"]>;
     }>) => import("react/jsx-runtime").JSX.Element;
     useSocketClient: () => SocketClient<T, C> | null;
-    useSocketConnection: <K extends keyof T & string>(p: UseSocketConnectionArgs<T, K, C>) => void;
+    useSocketRooms: (p: UseSocketRoomsArgs<C>) => void;
+    useSocketEvent: <K extends keyof T & string>(p: UseSocketEventArgs<T, K, C>) => void;
+    useSocketConnection: <K extends keyof T & string>(rooms: UseSocketRoomsArgs<C>, event: UseSocketEventArgs<T, K, C>) => void;
 };
 export {};

package/package.json

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