@emeryld/rrroutes-client 2.6.2 → 2.6.3

package/dist/index.cjs

@@ -1652,6 +1652,16 @@ function arrayShallowEqual(a, b) {
 function roomStateEqual(prev, next) {
   return arrayShallowEqual(prev.rooms, next.rooms) && safeJsonKey(prev.joinMeta) === safeJsonKey(next.joinMeta) && safeJsonKey(prev.leaveMeta) === safeJsonKey(next.leaveMeta);
 }
+function isSameObjectReference(prev, next) {
+  if (prev !== next) return false;
+  if (next == null) return false;
+  const valueType = typeof next;
+  return valueType === "object" || valueType === "function";
+}
+function shouldWarnSocketMutationGuard() {
+  const nodeEnv = globalThis.process?.env?.NODE_ENV;
+  return nodeEnv !== "production";
+}
 function safeDescribeHookValue2(value) {
   if (value == null) return value;
   const valueType = typeof value;
@@ -1933,6 +1943,7 @@ function buildSocketedRoute(options) {
       });
       if (!client) return;
       const queue = [];
+      const sameRefWarnedEvents = /* @__PURE__ */ new Set();
       let draining = false;
       let active = true;
       const drainQueue = () => {
@@ -1949,6 +1960,13 @@ function buildSocketedRoute(options) {
                   nextUpdate.payload,
                   nextUpdate.meta ? { ...nextUpdate.meta, args: useArgs } : { args: useArgs }
                 );
+                if (next === null) return prev;
+                if (shouldWarnSocketMutationGuard() && isSameObjectReference(prev, next) && !sameRefWarnedEvents.has(nextUpdate.event)) {
+                  sameRefWarnedEvents.add(nextUpdate.event);
+                  console.warn(
+                    `[socketedRoute] applySocket("${nextUpdate.event}") returned the previous reference. Return a new object/array for updates, or return null for no change.`
+                  );
+                }
                 const nextRoomState = roomsFromData(
                   next,
                   toRooms
@@ -1972,6 +1990,7 @@ function buildSocketedRoute(options) {
       const unsubscribes = entries.map(
         ([ev, fn]) => client.on(ev, (payload, meta) => {
           queue.push({
+            event: ev,
             fn,
             payload,
             ...meta ? { meta } : {}