@emeryld/rrroutes-client 2.6.2 → 2.6.4

package/README.md

@@ -347,8 +347,8 @@ const client = new SocketClient(events, {
   debug: { receive: true, emit: true, verbose: true, logger: console.log },
 })
 
-client.on('chat:message', (payload, { ctx }) => {
-  console.log('socket message', payload.text, 'latency', ctx.latencyMs)
+client.on('chat:message', (payload, meta) => {
+  console.log('socket message', payload.text, 'latency', meta?.ctx?.latencyMs)
 })
 
 void client.emit('chat:message', {
@@ -423,7 +423,7 @@ import { useSocketClient } from './socketProvider';
 
 const listRooms = client.build(registry.byKey['GET /v1/rooms'], { staleTime: 120_000 });
 
-const useSocketedRooms = buildSocketedRoute({
+const socketedRooms = buildSocketedRoute({
   built: listRooms,
   toRooms: (page) => ({
     rooms: page.items.map((r) => r.id), // derive rooms from data (feeds supported)
@@ -432,8 +432,10 @@ const useSocketedRooms = buildSocketedRoute({
   }),
   useSocketClient,
   applySocket: {
-    'chat:message': (prev, payload) => {
-      if (!prev) return prev;
+    'chat:message': (prev, payload, meta) => {
+      if (!prev) return null; // explicit no-op update
+      const [args] = meta.args;
+      console.debug('socket patch args', args);
       // Example: bump unread count in cache
       const apply = (items: any[]) =>
         items.map((room) =>
@@ -447,7 +449,7 @@ const useSocketedRooms = buildSocketedRoute({
 });
 
 function RoomList() {
-  const { data, rooms } = useSocketedRooms();
+  const { data, rooms } = socketedRooms.useEndpoint();
   return (
     <>
       <p>Subscribed rooms: {rooms.join(', ')}</p>
@@ -457,6 +459,8 @@ function RoomList() {
 }
 ```
 
+`buildSocketedRoute(...)` returns a built endpoint object with `useEndpoint()` plus the original built helpers. `applySocket` receives `{ envelope?, ctx?, args }` and can return `null` to skip cache updates.
+
 ---
 
 ## Edge cases & notes