@emeryld/rrroutes-client 2.1.12 → 2.2.1

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

@@ -0,0 +1,49 @@
+import type { AnyLeaf, InferOutput, EventMap as ContractEventMap, SocketConnectionConfig, SocketSchemaOutput, Payload } from '@emeryld/rrroutes-contract';
+import type { BuildMeta, BuildOptionsFor, ArgsFor, DataShape, InfiniteUseEndpointOptionsFor, QueryUseEndpointOptionsFor, RouterBuilder } from '../../routesV3.client.types';
+import type { ClientCtx, ServerEnvelope, SocketClient } from '../socket.client.index';
+/** Narrow to GET leaves. */
+type GetLeaf = AnyLeaf & {
+    method: 'get';
+};
+type PageOf<L extends GetLeaf> = InferOutput<L>;
+type SocketedHandlers<L extends GetLeaf, E extends ContractEventMap, K extends keyof E & string, C extends SocketConnectionConfig> = {
+    /**
+     * Derive the full set of rooms to join based on a newly received payload plus
+     * the current active room list. Return the complete desired list (not a delta).
+     */
+    onReceiveRooms?: (page: PageOf<L>, activeRooms: string[]) => string[];
+    /**
+     * Update the cached route data when a socket message arrives.
+     * Return the next cache value (or undefined to keep it unchanged).
+     */
+    handleMessage: (prev: DataShape<L> | undefined, payload: Payload<E, K>, meta: {
+        envelope: ServerEnvelope<E, K>;
+        ctx: ClientCtx;
+    }) => DataShape<L> | undefined;
+    /** Meta payloads for join/leave messages. */
+    joinMeta: SocketSchemaOutput<C['joinMetaMessage']>;
+    leaveMeta: SocketSchemaOutput<C['leaveMetaMessage']>;
+};
+/**
+  * Build a hook that wires a GET route (feed or standard) to a socket event:
+  * - Keeps React Query cache in sync when socket messages arrive.
+  * - Derives and joins rooms from the route’s responses.
+  */
+export declare function createSocketedRouteHook<Routes extends Record<PropertyKey, AnyLeaf>, Names extends string, Events extends ContractEventMap, C extends SocketConnectionConfig>(args: {
+    buildRoute: RouterBuilder<Routes, Names>;
+    useClient?: () => SocketClient<Events, C>;
+}): <K extends keyof { [K_1 in keyof Routes as Routes[K_1] extends GetLeaf ? K_1 : never]: Routes[K_1] extends GetLeaf ? Routes[K_1] : never; } & string, Ev extends keyof Events & string>(params: {
+    routeKey: K;
+    socketEvent: Ev;
+    handlers: SocketedHandlers<{ [K_1 in keyof Routes as Routes[K_1] extends GetLeaf ? K_1 : never]: Routes[K_1] extends GetLeaf ? Routes[K_1] : never; }[K], Events, Ev, C>;
+    buildOptions?: BuildOptionsFor<{ [K_1 in keyof Routes as Routes[K_1] extends GetLeaf ? K_1 : never]: Routes[K_1] extends GetLeaf ? Routes[K_1] : never; }[K]>;
+    buildMeta?: BuildMeta<Names>;
+    useOptions?: {
+        args?: ArgsFor<{ [K_1 in keyof Routes as Routes[K_1] extends GetLeaf ? K_1 : never]: Routes[K_1] extends GetLeaf ? Routes[K_1] : never; }[K]>;
+        options?: { [K_1 in keyof Routes as Routes[K_1] extends GetLeaf ? K_1 : never]: Routes[K_1] extends GetLeaf ? Routes[K_1] : never; }[K]["cfg"]["feed"] extends true ? InfiniteUseEndpointOptionsFor<{ [K_1 in keyof Routes as Routes[K_1] extends GetLeaf ? K_1 : never]: Routes[K_1] extends GetLeaf ? Routes[K_1] : never; }[K]> : QueryUseEndpointOptionsFor<{ [K_1 in keyof Routes as Routes[K_1] extends GetLeaf ? K_1 : never]: Routes[K_1] extends GetLeaf ? Routes[K_1] : never; }[K]>;
+    };
+}) => {
+    data: InferOutput<{ [K_1 in keyof Routes as Routes[K_1] extends GetLeaf ? K_1 : never]: Routes[K_1] extends GetLeaf ? Routes[K_1] : never; }[K]> | import("@tanstack/react-query").InfiniteData<InferOutput<{ [K_1 in keyof Routes as Routes[K_1] extends GetLeaf ? K_1 : never]: Routes[K_1] extends GetLeaf ? Routes[K_1] : never; }[K]>, unknown> | undefined;
+    rooms: string[];
+};
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emeryld/rrroutes-client",
-  "version": "2.1.12",
+  "version": "2.2.1",
   "private": false,
   "type": "module",
   "main": "dist/index.cjs",
@@ -19,7 +19,7 @@
     "dist"
   ],
   "dependencies": {
-    "@emeryld/rrroutes-contract": "^2.1.2",
+    "@emeryld/rrroutes-contract": "^2.1.5",
     "zod": "^4.1.12"
   },
   "peerDependencies": {