@emeryld/rrroutes-client 1.5.1 → 1.5.2

package/dist/index.cjs

@@ -451,11 +451,10 @@ function toFormData(body) {
 // src/sockets/socket.client.index.ts
 var import_socket = require("socket.io-client");
 var SocketClient = class {
-  // event -> handlers
   constructor(events, opts) {
-    // [6] stats
+    this.hbTimer = null;
+    // stats
     this.roomCounts = /* @__PURE__ */ new Map();
-    // room -> refcount
     this.handlerMap = /* @__PURE__ */ new Map();
     this.events = events;
     this.socket = (0, import_socket.io)(opts.url, { autoConnect: true, ...opts.ioOptions });
@@ -463,17 +462,54 @@ var SocketClient = class {
     this.roomLeaveEvent = opts.roomLeaveEvent ?? "room:leave";
     this.environment = opts.environment ?? "development";
     this.debug = opts.debug ?? {};
-    const dlog = (e) => (this.debug.logger ?? console.debug)(["[socket-client]"], e);
-    if (this.debug.enabled && this.debug.flags?.connect) {
-      this.socket.on("connect", () => dlog({ type: "connect", id: this.socket.id }));
-      this.socket.on("reconnect", (attempt) => dlog({ type: "reconnect", attempt }));
-    }
-    if (this.debug.enabled && this.debug.flags?.disconnect) {
-      this.socket.on("disconnect", (reason) => dlog({ type: "disconnect", reason }));
-      this.socket.on("connect_error", (err) => dlog({ type: "connect_error", err: String(err) }));
-    }
+    const hb = opts.heartbeat;
+    this.hb = {
+      pingEvent: hb.pingEvent ?? "sys:ping",
+      pongEvent: hb.pongEvent ?? "sys:pong",
+      intervalMs: hb.intervalMs ?? 15e3,
+      timeoutMs: hb.timeoutMs ?? 7500,
+      pingSchema: hb.pingSchema,
+      makePingPayload: hb.makePingPayload,
+      pongSchema: hb.pongSchema,
+      onPong: hb.onPong
+    };
+    const dbg = (key, e) => {
+      const d = this.debug;
+      if (!d.logger) return;
+      if (!d[e.type]) return;
+      if (d.only && "event" in e && typeof e.event === "string" && !d.only.includes(e.event)) return;
+      d.logger(e);
+    };
+    this.socket.on("connect", () => {
+      dbg("connect", { type: "connect", id: this.socket.id ?? "" });
+      this.startHeartbeat(dbg);
+    });
+    this.socket.on("reconnect", (attempt) => dbg("reconnect", { type: "reconnect", attempt }));
+    this.socket.on("disconnect", (reason) => {
+      dbg("disconnect", { type: "disconnect", reason: String(reason) });
+      this.stopHeartbeat();
+    });
+    this.socket.on("connect_error", (err) => dbg("connect_error", { type: "connect_error", err: String(err) }));
+    this.socket.on(this.hb.pongEvent, (raw) => {
+      const receivedAt = Date.now();
+      const serverNowIso = raw?.serverNow;
+      const clientSentIso = raw?.clientEcho?.__clientSentAt;
+      let latencyMs;
+      if (clientSentIso) {
+        const sent = Date.parse(clientSentIso);
+        if (!Number.isNaN(sent)) latencyMs = Math.max(0, receivedAt - sent);
+      }
+      if (this.hb.pongSchema) {
+        const ok = this.hb.pongSchema.safeParse(raw);
+        if (!ok.success) return;
+      }
+      if (this.debug.logger && this.debug.pong_recv) {
+        this.debug.logger({ type: "pong_recv", latencyMs: latencyMs ?? raw?.sinceMs ?? 0, payload: raw });
+      }
+      this.hb.onPong?.({ latencyMs: latencyMs ?? raw?.sinceMs ?? 0, payload: raw, socket: this.socket });
+    });
   }
-  /** [6] internal stats snapshot */
+  /** internal stats snapshot */
   stats() {
     const rooms = Array.from(this.roomCounts.entries()).map(([room, count]) => ({ room, count }));
     const handlers = Array.from(this.handlerMap.entries()).map(([event, set]) => ({
@@ -487,23 +523,58 @@ var SocketClient = class {
       handlers
     };
   }
-  maybeLog(flag, obj) {
-    if (!this.debug.enabled) return;
-    if (!this.debug.flags?.[flag]) return;
-    (this.debug.logger ?? console.debug)(["[socket-client]"], obj);
+  toArray(rooms) {
+    return rooms == null ? [] : Array.isArray(rooms) ? rooms : [rooms];
+  }
+  /** === NEW: heartbeat control === */
+  startHeartbeat(dbg) {
+    this.stopHeartbeat();
+    const tick = () => {
+      const basePayload = this.hb.makePingPayload({ socket: this.socket }) ?? {};
+      const candidate = { ...basePayload, __clientSentAt: (/* @__PURE__ */ new Date()).toISOString() };
+      const check = this.hb.pingSchema.safeParse(candidate);
+      if (!check.success) {
+        if (this.environment === "development") console.warn("[socket] ping schema validation failed", check.error.issues);
+        return;
+      }
+      const timer = setTimeout(() => {
+      }, this.hb.timeoutMs);
+      this.socket.timeout(this.hb.timeoutMs).emit(this.hb.pingEvent, { payload: check.data }, () => {
+        clearTimeout(timer);
+      });
+      if (this.debug.logger && this.debug.ping_emit) {
+        dbg("ping_emit", { type: "ping_emit", payload: check.data });
+      }
+    };
+    this.hbTimer = setInterval(tick, this.hb.intervalMs);
+    tick();
+  }
+  stopHeartbeat() {
+    if (this.hbTimer) {
+      clearInterval(this.hbTimer);
+      this.hbTimer = null;
+    }
   }
-  emit(event, payload, metadata) {
+  emit(event, payload, metadata, onAck, timeoutMs) {
     const schema = this.events[event].message;
     const parsed = schema.safeParse(payload);
-    if (!parsed.success) {
-      throw new Error(`Invalid payload for "${event}": ${parsed.error.message}`);
+    if (!parsed.success) throw new Error(`Invalid payload for "${event}": ${parsed.error.message}`);
+    if (onAck) {
+      this.socket.timeout(timeoutMs ?? this.hb.timeoutMs).emit(String(event), parsed.data, (ack) => {
+        try {
+          onAck(ack);
+        } catch {
+        }
+      });
+    } else {
+      this.socket.emit(String(event), parsed.data);
+    }
+    if (this.debug.logger && this.debug.emit) {
+      this.debug.logger({ type: "emit", event, metadata: this.debug.verbose ? metadata : void 0 });
     }
-    this.socket.emit(String(event), parsed.data);
-    this.maybeLog("emit", { type: "emit", event, metadata: this.debug.verbose ? metadata : void 0 });
   }
-  /** [6] refcount join. Only emits when transitioning 0->1 */
   joinRooms(rooms) {
-    const list = rooms == null ? [] : Array.isArray(rooms) ? rooms : [rooms];
+    const list = this.toArray(rooms);
     const toJoin = [];
     for (const r of list) {
       const next = (this.roomCounts.get(r) ?? 0) + 1;
@@ -512,13 +583,13 @@ var SocketClient = class {
     }
     if (toJoin.length > 0) {
       this.socket.emit(this.roomJoinEvent, { rooms: toJoin });
-      this.maybeLog("join", { type: "join", rooms: toJoin, stats: this.debug.verbose ? this.stats() : void 0 });
-      this.maybeLog("stats", { type: "stats", ...this.stats() });
+      if (this.debug.logger && this.debug.join) {
+        this.debug.logger({ type: "join", rooms: toJoin, stats: this.debug.stats || this.debug.verbose ? this.stats() : void 0 });
+      }
     }
   }
-  /** [6] refcount leave. Only emits when transitioning 1->0 */
   leaveRooms(rooms) {
-    const list = rooms == null ? [] : Array.isArray(rooms) ? rooms : [rooms];
+    const list = this.toArray(rooms);
     const toLeave = [];
     for (const r of list) {
       const curr = this.roomCounts.get(r) ?? 0;
@@ -529,13 +600,17 @@ var SocketClient = class {
     }
     if (toLeave.length > 0) {
       this.socket.emit(this.roomLeaveEvent, { rooms: toLeave });
-      this.maybeLog("leave", { type: "leave", rooms: toLeave, stats: this.debug.verbose ? this.stats() : void 0 });
-      this.maybeLog("stats", { type: "stats", ...this.stats() });
+      if (this.debug.logger && this.debug.leave) {
+        this.debug.logger({ type: "leave", rooms: toLeave, stats: this.debug.stats || this.debug.verbose ? this.stats() : void 0 });
+      }
     }
   }
   on(event, handler) {
     const schema = this.events[event].message;
-    const wrapped = (envelopeOrRaw) => {
+    if (this.debug.logger && this.debug.register) {
+      this.debug.logger({ type: "register", event });
+    }
+    const wrapped = (envelopeOrRaw, maybeAck) => {
       const maybeEnvelope = envelopeOrRaw;
       const rawData = maybeEnvelope?.data ?? maybeEnvelope;
       const parsed = schema.safeParse(rawData);
@@ -548,23 +623,28 @@ var SocketClient = class {
           sentAt: maybeEnvelope?.sentAt ?? receivedAt.toISOString(),
           sentTo: maybeEnvelope?.sentTo ?? [],
           data: void 0,
-          // avoid echoing body to handler meta
           metadata: maybeEnvelope?.metadata
-          // [3]
         },
         ctx: {
           receivedAt,
           latencyMs: sentAt ? Math.max(0, receivedAt.getTime() - sentAt.getTime()) : void 0,
           nsp: this.socket.nsp,
           socketId: this.socket.id,
-          socket: this.socket
+          socket: this.socket,
+          reply: typeof maybeAck === "function" ? (d) => {
+            try {
+              maybeAck(d);
+            } catch {
+            }
+          } : void 0
+          // NEW
         }
       };
-      if (this.debug.enabled && this.debug.flags?.receive) {
-        (this.debug.logger ?? console.debug)(["[socket-client]"], {
+      if (this.debug.logger && this.debug.receive) {
+        this.debug.logger({
           type: "receive",
           event,
-          verbose: this.debug.verbose ? { envelope: meta.envelope } : void 0
+          envelope: this.debug.verbose ? { eventName: meta.envelope.eventName, sentAt: meta.envelope.sentAt, sentTo: meta.envelope.sentTo, metadata: meta.envelope.metadata } : void 0
         });
       }
       handler(parsed.data, meta);
@@ -583,7 +663,6 @@ var SocketClient = class {
     }
     const entry = { orig: handler, wrapped, errorWrapped };
     set.add(entry);
-    this.maybeLog("stats", { type: "stats", ...this.stats() });
     return () => {
       this.socket.off(String(event), wrapped);
       this.socket.off(`${String(event)}:error`, errorWrapped);
@@ -592,34 +671,18 @@ var SocketClient = class {
         s.delete(entry);
         if (s.size === 0) this.handlerMap.delete(String(event));
       }
-      this.maybeLog("stats", { type: "stats", ...this.stats() });
-    };
-  }
-  /** [4] precise off: remove specific handler if provided, else all for event */
-  off(event, handler) {
-    const set = this.handlerMap.get(String(event));
-    if (!set || set.size === 0) return;
-    if (!handler) {
-      for (const entry of set) {
-        this.socket.off(String(event), entry.wrapped);
-        this.socket.off(`${String(event)}:error`, entry.errorWrapped);
-      }
-      this.handlerMap.delete(String(event));
-    } else {
-      for (const entry of Array.from(set)) {
-        if (entry.orig === handler) {
-          this.socket.off(String(event), entry.wrapped);
-          this.socket.off(`${String(event)}:error`, entry.errorWrapped);
-          set.delete(entry);
-        }
+      if (this.debug.logger && this.debug.unregister) {
+        this.debug.logger({ type: "unregister", event });
       }
-      if (set.size === 0) this.handlerMap.delete(String(event));
-    }
-    this.maybeLog("stats", { type: "stats", ...this.stats() });
+    };
   }
   disconnect() {
+    this.stopHeartbeat();
     this.socket.disconnect();
   }
+  connect() {
+    this.socket.connect();
+  }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/routesV3.client.fetch.ts","../src/routesV3.client.index.ts","../src/sockets/socket.client.index.ts"],"sourcesContent":["/**\n * This package exports React Query hooks, so we mark it as client-only to keep Next.js happy.\n */\n'use client';\n\nexport * from './routesV3.client.types';\nexport * from './routesV3.client.fetch';\nexport * from './routesV3.client.index';\nexport * from './sockets/socket.client.index';","// routesV3.client.fetch.ts\n\nimport { Fetcher, FetchInput } from './routesV3.client.types';\n\n/**\n * Default fetch implementation used by the route client helper.\n * @param req Normalized request information (URL, method, body, headers).\n * @returns Parsed JSON (or text fallback) from the server response.\n */\nexport const defaultFetcher: Fetcher = async <T>(req: FetchInput): Promise<T> => {\n  const headers: Record<string, string> = { ...(req.headers ?? {}) };\n  const isFormData = typeof FormData !== 'undefined' && req.body instanceof FormData;\n  if (!isFormData) {\n    headers['Content-Type'] ||= 'application/json';\n    headers['Accept'] ||= 'application/json';\n  }\n\n  const res = await fetch(req.url, {\n    method: req.method,\n    headers,\n    body: isFormData ? (req.body as any) : req.body == null ? undefined : JSON.stringify(req.body),\n  });\n\n  const text = await res.text();\n  if (!res.ok) {\n    const snippet = text.slice(0, 400);\n    throw new Error(`[${res.status}] ${res.statusText} — ${snippet}`);\n  }\n\n  try {\n    return JSON.parse(text) as T;\n  } catch {\n    return text as unknown as T;\n  }\n};\n","// routesV3.client.ts\nimport {\n  keepPreviousData,\n  useInfiniteQuery,\n  useMutation,\n  useQuery,\n  type InfiniteData,\n  type QueryKey,\n} from '@tanstack/react-query';\nimport type { ZodType } from 'zod';\nimport {\n  HttpMethod,\n  buildCacheKey,\n  compilePath,\n} from '@emeryld/rrroutes-contract';\nimport type {\n  AnyLeaf,\n  InferBody,\n  InferOutput,\n  InferParams,\n  InferQuery,\n} from '@emeryld/rrroutes-contract';\nimport { defaultFetcher } from './routesV3.client.fetch';\nimport type {\n  ArgsFor,\n  ArgsTuple,\n  BuildMeta,\n  BuiltForLeaf,\n  BuiltInfinite,\n  BuiltMutation,\n  BuiltQuery,\n  Cursor,\n  DataShape,\n  InfiniteBuildOptionsFor,\n  MutationBuildOptionsFor,\n  QueryBuildOptionsFor,\n  RouteClient,\n  RouteClientOptions,\n  RouteClientDebugEvent,\n  RouteClientDebugLogger,\n  RouteClientDebugMode,\n  RouteClientDebugOptions,\n  RouteClientDebugToggleOptions,\n  Updater,\n} from './routesV3.client.types';\n\n// -------------------------------------------------------------------------------------\n// Tiny helpers\n// -------------------------------------------------------------------------------------\n/**\n * Convert an HTTP method to uppercase (as expected by fetch).\n * @param m Lowercase HTTP method.\n * @returns Uppercase method string.\n */\nconst toUpper = (m: HttpMethod): Uppercase<HttpMethod> => m.toUpperCase() as Uppercase<HttpMethod>;\n\n/**\n * Parse the given value with the supplied schema (if present).\n * @param value Raw value to validate.\n * @param schema Optional Zod schema used for validation/coercion.\n * @returns The validated or original value.\n */\nfunction zParse<T>(value: unknown, schema?: ZodType): T {\n  return schema ? (schema.parse(value) as T) : (value as T);\n}\n\n/**\n * Serialize a query object into a search string.\n * @param query Query params object (possibly undefined).\n * @returns Query string prefixed with `?`, or empty string.\n */\nfunction toSearchString(query: Record<string, unknown> | undefined) {\n  if (!query) return '';\n  const params = new URLSearchParams();\n  for (const [k, v] of Object.entries(query)) {\n    if (v == null) continue;\n    if (Array.isArray(v)) {\n      v.forEach((x) => {\n        if (x == null) return;\n        if (typeof x === 'object') {\n          params.append(k, JSON.stringify(x));\n        } else {\n          params.append(k, String(x));\n        }\n      });\n      continue;\n    }\n    if (typeof v === 'object') {\n      params.set(k, JSON.stringify(v));\n      continue;\n    }\n    params.set(k, String(v));\n  }\n  const s = params.toString();\n  return s ? `?${s}` : '';\n}\n\n/**\n * Remove the given key from an object (used to drop cursors from cache keys).\n * @param obj Source object.\n * @param key Property name to omit.\n * @returns Copy of the object without the specified key.\n */\nfunction stripKey<Q extends Record<string, unknown> | undefined>(obj: Q, key: string): Q {\n  if (!obj) return obj;\n  const { [key]: _omit, ...rest } = obj as any;\n  return rest as Q;\n}\n\n/**\n * Default cursor extractor used by infinite queries.\n * @param p Page result returned from the server.\n * @returns Next cursor string, if present.\n */\nconst defaultGetNextCursor = (p: unknown): Cursor =>\n  p && typeof p === 'object' && 'nextCursor' in p ? (p as any).nextCursor : undefined;\n\n// Debug logging --------------------------------------------------------------\nconst noopDebugLogger: RouteClientDebugLogger = () => {};\n\nconst defaultDebugLogger: RouteClientDebugLogger = (event: RouteClientDebugEvent) => {\n  if (typeof console === 'undefined') return;\n  const fn = console.debug ?? console.log;\n  fn?.call(console, '[rrroutes-client]', event);\n};\n\nconst debugEventTypes: RouteClientDebugEvent['type'][] = [\n  'fetch',\n  'invalidate',\n  'setData',\n  'build',\n  'useEndpoint',\n];\n\ntype DebugEmitter<Names extends string> = {\n  emit: (event: RouteClientDebugEvent, name?: Names) => void;\n  mode: RouteClientDebugMode;\n};\n\nconst noopEmit = () => {};\n\nfunction createDebugEmitter<Names extends string>(\n  option?: RouteClientDebugOptions<Names>,\n  environment?: string,\n): DebugEmitter<Names> {\n  const disabled: DebugEmitter<Names> = { emit: noopEmit, mode: 'minimal' };\n\n  if (environment && environment.toLowerCase() === 'production') {\n    return disabled;\n  }\n\n  if (!option) {\n    return disabled;\n  }\n  if (option === true || option === 'minimal') {\n    return {\n      emit: (event, name) => defaultDebugLogger(name ? { ...event, name } : event),\n      mode: 'minimal',\n    };\n  }\n  if (option === 'complete') {\n    return {\n      emit: (event, name) => defaultDebugLogger(name ? { ...event, name } : event),\n      mode: 'complete',\n    };\n  }\n  if (typeof option === 'function') {\n    return {\n      emit: (event, name) => option(name ? { ...event, name } : event),\n      mode: 'minimal',\n    };\n  }\n  if (typeof option === 'object') {\n    const toggles = option as RouteClientDebugToggleOptions<Names>;\n    const verbose = Boolean(toggles.verbose);\n    const enabledTypes = debugEventTypes.filter((type) => toggles[type]);\n    if (enabledTypes.length === 0) {\n      return { emit: noopEmit, mode: verbose ? 'complete' : 'minimal' };\n    }\n    const whitelist = new Set<RouteClientDebugEvent['type']>(enabledTypes);\n    const onlySet =\n      toggles.only && toggles.only.length > 0 ? new Set<Names>(toggles.only) : undefined;\n    const logger = toggles.logger ?? defaultDebugLogger;\n    const emit: DebugEmitter<Names>['emit'] = (event, name) => {\n      if (!whitelist.has(event.type)) return;\n      if (onlySet) {\n        if (!name || !onlySet.has(name)) return;\n      }\n      logger(name ? { ...event, name } : event);\n    };\n    return { emit, mode: verbose ? 'complete' : 'minimal' };\n  }\n\n  return disabled;\n}\n\n// Split the variadic tuple at runtime\n/**\n * Extract the optional argument object from a variadic tuple.\n * @param args Tuple passed to a built endpoint helper.\n * @returns The argument object if present.\n */\nfunction extractArgs<L extends AnyLeaf>(args: ArgsTuple<L>): ArgsFor<L> | undefined {\n  // At runtime ArgsTuple<L> is either [] or [obj]; we just pick the first if present.\n  return (args as unknown as any[])[0] as any;\n}\n\n/**\n * Normalize params and query values, then construct a request URL for the given leaf.\n * @param leaf Leaf describing the endpoint.\n * @param baseUrl Optional base URL prepended to the path.\n * @param params Route parameters supplied by the caller.\n * @param query Query parameters supplied by the caller.\n * @returns Object containing the composed URL plus normalized params/query payloads.\n */\nfunction buildUrl<L extends AnyLeaf>(\n  leaf: L,\n  baseUrl: string,\n  params: InferParams<L> | undefined,\n  query: InferQuery<L> | undefined,\n) {\n  const normalizedParams = zParse<InferParams<L>>(params, leaf.cfg.paramsSchema);\n  const normalizedQuery = zParse<InferQuery<L>>(query, leaf.cfg.querySchema);\n  const path = compilePath<L['path']>(leaf.path, (normalizedParams ?? {}) as any);\n  const url = `${baseUrl ?? ''}${path}${toSearchString(normalizedQuery as any)}`;\n  return { url, normalizedQuery, normalizedParams };\n}\n\n// -------------------------------------------------------------------------------------\n// Client factory\n// -------------------------------------------------------------------------------------\n/**\n * Construct typed React Query helpers backed by a routes-v3 registry leaf.\n * @param opts Route client configuration (query client, fetcher overrides, etc).\n * @returns Object that can build endpoint hooks/mutations from leaves.\n */\nexport function createRouteClient<Names extends string = string>(\n  opts: RouteClientOptions<Names>,\n): RouteClient<Names> {\n  const queryClient = opts.queryClient;\n  const fetcher = opts.fetcher ?? defaultFetcher;\n  const baseUrl = opts.baseUrl;\n  const cursorParam = opts.cursorParam ?? 'cursor';\n  const getNextCursor = opts.getNextCursor ?? defaultGetNextCursor;\n  const environment =\n    opts.environment ?? undefined;\n  const { emit: emitDebug, mode: debugMode } = createDebugEmitter<Names>(opts.debug, environment);\n  const isVerboseDebug = debugMode === 'complete';\n  const decorateDebugEvent = <T extends RouteClientDebugEvent>(\n    event: T,\n    details?: Partial<RouteClientDebugEvent>,\n  ): RouteClientDebugEvent => {\n    if (!isVerboseDebug || !details) return event;\n    return { ...event, ...details } as RouteClientDebugEvent;\n  };\n\n  /**\n   * Invalidate a set of queries sharing the given prefix.\n   * @param prefix Key parts shared by matching endpoints.\n   * @param exact When true, invalidate only exact key matches.\n   */\n  async function invalidate(prefix: string[], exact = false) {\n    const queryKey = prefix as unknown as QueryKey;\n    await queryClient.invalidateQueries({ queryKey, exact });\n    emitDebug({ type: 'invalidate', key: queryKey, exact });\n  }\n\n  /**\n   * Build the client surface for a single leaf (query/mutation/infinite query).\n   * @param leaf Leaf describing the endpoint.\n   * @param rqOpts Optional React Query configuration.\n   * @returns Helper object exposing key/invalidate/setData/useEndpoint.\n   */\n  function buildInternal<L extends AnyLeaf>(\n    leaf: L,\n    rqOpts?: QueryBuildOptionsFor<L> | InfiniteBuildOptionsFor<L> | MutationBuildOptionsFor<L>,\n    meta?: BuildMeta<Names>,\n  ): BuiltForLeaf<L> {\n    const isGet = leaf.method === 'get';\n    const isFeed = !!leaf.cfg.feed;\n    const method = toUpper(leaf.method);\n    const leafLabel = `${leaf.method.toUpperCase()} ${String(leaf.path)}`;\n    const debugName = meta?.name;\n    const emit = (event: RouteClientDebugEvent) => emitDebug(event, debugName);\n    emit({ type: 'build', leaf: leafLabel });\n\n    // --- key/invalidate/setData shared helpers ---\n    const key = (...tuple: ArgsTuple<L>): QueryKey => {\n      const a = extractArgs<L>(tuple);\n      const params = (a as any)?.params as InferParams<L> | undefined;\n      const query = (a as any)?.query as InferQuery<L> | undefined;\n      const qForKey = isGet && isFeed ? stripKey(query as any, cursorParam) : (query as any);\n      return buildCacheKey({ leaf, params: params as any, query: qForKey }) as unknown as QueryKey;\n    };\n\n    /**\n     * Invalidate the React Query cache for this exact leaf invocation.\n     * @param tuple Optional params/query tuple.\n     */\n    const invalidateExact = async (...tuple: ArgsTuple<L>) => {\n      const queryKey = key(...tuple);\n      await queryClient.invalidateQueries({ queryKey, exact: true });\n      emit({ type: 'invalidate', key: queryKey, exact: true });\n    };\n\n    /**\n     * Update the cache entries for this leaf.\n     * @param args Tuple whose first entry is the updater and optional params/query follow.\n     */\n    const setData = (...args: [Updater<DataShape<L>>, ...rest: ArgsTuple<L>]) => {\n      const [updater, ...rest] = args;\n      const k = key(...(rest as ArgsTuple<L>));\n      if (isGet && isFeed) {\n        queryClient.setQueryData<InfiniteData<InferOutput<L>> | undefined>(k, (prev) =>\n          typeof updater === 'function' ? (updater as any)(prev) : (updater as any),\n        );\n      } else {\n        queryClient.setQueryData<InferOutput<L> | undefined>(k, (prev) =>\n          typeof updater === 'function' ? (updater as any)(prev) : (updater as any),\n        );\n      }\n      emit({ type: 'setData', key: k });\n    };\n\n    // --- Infinite GET ---\n    if (isGet && isFeed) {\n      const useEndpoint: BuiltInfinite<L>['useEndpoint'] = (...tuple) => {\n        emit({ type: 'useEndpoint', leaf: leafLabel, variant: 'infiniteGet' });\n        const a = extractArgs<L>(tuple);\n        const params = (a as any)?.params as InferParams<L> | undefined;\n        const query = (a as any)?.query as InferQuery<L> | undefined;\n\n        // Normalize once; we’ll inject the cursor per page below.\n        const { normalizedQuery, normalizedParams } = buildUrl(leaf, baseUrl, params, query);\n        return useInfiniteQuery<\n          InferOutput<L>, // TQueryFnData (per page)\n          unknown, // TError\n          InfiniteData<InferOutput<L>>, // TData (returned by the hook)\n          QueryKey,\n          Cursor\n        >({\n          ...(rqOpts as InfiniteBuildOptionsFor<L>),\n          queryKey: key(...tuple),\n          initialPageParam: undefined,\n          getNextPageParam: (lastPage) => getNextCursor(lastPage),\n          placeholderData: keepPreviousData,\n          queryFn: async ({ pageParam }) => {\n            const pageQuery = {\n              ...(normalizedQuery as any),\n              ...(pageParam ? { [cursorParam]: pageParam } : {}),\n            };\n            const { url } = buildUrl(leaf, baseUrl, params, pageQuery);\n            const startedAt = Date.now();\n            const detail = isVerboseDebug ? { params: normalizedParams, query: pageQuery } : undefined;\n            emit(\n              decorateDebugEvent(\n                { type: 'fetch', stage: 'start', method, url, leaf: leafLabel },\n                detail,\n              ),\n            );\n            try {\n              const out = await fetcher<unknown>({ url, method });\n              const parsed = zParse<InferOutput<L>>(out, leaf.cfg.outputSchema);\n              emit(\n                decorateDebugEvent(\n                  {\n                    type: 'fetch',\n                    stage: 'success',\n                    method,\n                    url,\n                    leaf: leafLabel,\n                    durationMs: Date.now() - startedAt,\n                  },\n                  isVerboseDebug ? { params: normalizedParams, query: pageQuery, output: parsed } : undefined,\n                ),\n              );\n              return parsed;\n            } catch (error) {\n              emit(\n                decorateDebugEvent(\n                  {\n                    type: 'fetch',\n                    stage: 'error',\n                    method,\n                    url,\n                    leaf: leafLabel,\n                    durationMs: Date.now() - startedAt,\n                    error,\n                  },\n                  detail,\n                ),\n              );\n              throw error;\n            }\n          },\n          // NOTE: TData is InfiniteData<T>, so we don't need a select here.\n        }, queryClient);\n      };\n\n      return {\n        key,\n        invalidate: invalidateExact,\n        setData: setData as any,\n        useEndpoint,\n      } as BuiltForLeaf<L>;\n    }\n    // --- Plain GET ---\n    if (isGet) {\n      const useEndpoint: BuiltQuery<L>['useEndpoint'] = (...tuple) => {\n        emit({ type: 'useEndpoint', leaf: leafLabel, variant: 'get' });\n        const a = extractArgs<L>(tuple);\n        const params = (a as any)?.params as InferParams<L> | undefined;\n        const query = (a as any)?.query as InferQuery<L> | undefined;\n\n        const { url, normalizedQuery, normalizedParams } = buildUrl(leaf, baseUrl, params, query);\n        return useQuery<InferOutput<L>, unknown, InferOutput<L>, QueryKey>({\n          ...(rqOpts as QueryBuildOptionsFor<L>),\n          queryKey: key(...tuple),\n          placeholderData: keepPreviousData,\n          queryFn: async () => {\n            const startedAt = Date.now();\n            const detail = isVerboseDebug\n              ? { params: normalizedParams, query: normalizedQuery }\n              : undefined;\n            emit(\n              decorateDebugEvent(\n                { type: 'fetch', stage: 'start', method, url, leaf: leafLabel },\n                detail,\n              ),\n            );\n            try {\n              const out = await fetcher<unknown>({ url, method });\n              const parsed = zParse<InferOutput<L>>(out, leaf.cfg.outputSchema);\n              emit(\n                decorateDebugEvent(\n                  {\n                    type: 'fetch',\n                    stage: 'success',\n                    method,\n                    url,\n                    leaf: leafLabel,\n                    durationMs: Date.now() - startedAt,\n                  },\n                  isVerboseDebug\n                    ? { params: normalizedParams, query: normalizedQuery, output: parsed }\n                    : undefined,\n                ),\n              );\n              return parsed;\n            } catch (error) {\n              emit(\n                decorateDebugEvent(\n                  {\n                    type: 'fetch',\n                    stage: 'error',\n                    method,\n                    url,\n                    leaf: leafLabel,\n                    durationMs: Date.now() - startedAt,\n                    error,\n                  },\n                  detail,\n                ),\n              );\n              throw error;\n            }\n          },\n        }, queryClient);\n      };\n\n      return {\n        key,\n        invalidate: invalidateExact,\n        setData: setData as any,\n        useEndpoint,\n      } as BuiltForLeaf<L>;\n    }\n\n    // --- Mutation (POST/PUT/PATCH/DELETE) ---\n    const fetchEndpoint: BuiltMutation<L>['fetch'] = async (\n      ...tupleWithBody: [...ArgsTuple<L>, InferBody<L>]\n    ) => {\n      if (tupleWithBody.length === 0) {\n        throw new Error('Body is required when invoking a mutation fetch.');\n      }\n      const bodyIndex = tupleWithBody.length - 1;\n      const tuple = tupleWithBody.slice(0, bodyIndex) as ArgsTuple<L>;\n      const body = tupleWithBody[bodyIndex] as InferBody<L>;\n      const args = extractArgs<L>(tuple);\n      const params = (args as any)?.params as InferParams<L> | undefined;\n      const query = (args as any)?.query as InferQuery<L> | undefined;\n\n      const { url, normalizedQuery, normalizedParams } = buildUrl(leaf, baseUrl, params, query);\n      const normalizedBody = zParse<InferBody<L>>(body, leaf.cfg.bodySchema);\n\n      // Optional: switch to FormData if your method declares bodyFiles\n      const isMultipart = Array.isArray(leaf.cfg.bodyFiles) && leaf.cfg.bodyFiles.length > 0;\n      const payload = isMultipart ? toFormData(normalizedBody as any) : normalizedBody;\n\n      const startedAt = Date.now();\n      const detail = isVerboseDebug\n        ? { params: normalizedParams, query: normalizedQuery }\n        : undefined;\n      emit(\n        decorateDebugEvent(\n          {\n            type: 'fetch',\n            stage: 'start',\n            method,\n            url,\n            leaf: leafLabel,\n            body: payload,\n          },\n          detail,\n        ),\n      );\n      try {\n        const out = await fetcher<unknown>({ url, method, body: payload });\n        const parsed = zParse<InferOutput<L>>(out, leaf.cfg.outputSchema);\n        emit(\n          decorateDebugEvent(\n            {\n              type: 'fetch',\n              stage: 'success',\n              method,\n              url,\n              leaf: leafLabel,\n              durationMs: Date.now() - startedAt,\n            },\n            isVerboseDebug\n              ? { params: normalizedParams, query: normalizedQuery, output: parsed }\n              : undefined,\n          ),\n        );\n        return parsed;\n      } catch (error) {\n        emit(\n          decorateDebugEvent(\n            {\n              type: 'fetch',\n              stage: 'error',\n              method,\n              url,\n              leaf: leafLabel,\n              durationMs: Date.now() - startedAt,\n              body: payload,\n              error,\n            },\n            detail,\n          ),\n        );\n        throw error;\n      }\n    };\n\n    const useEndpoint: BuiltMutation<L>['useEndpoint'] = (...tuple) => {\n      emit({ type: 'useEndpoint', leaf: leafLabel, variant: 'mutation' });\n      return useMutation<InferOutput<L>, unknown, InferBody<L>, unknown>({\n        ...(rqOpts as MutationBuildOptionsFor<L>),\n        mutationKey: key(...tuple),\n        mutationFn: (body: InferBody<L>) =>\n          fetchEndpoint(...([...tuple, body] as [...ArgsTuple<L>, InferBody<L>])),\n      }, queryClient);\n    };\n\n    return {\n      key,\n      invalidate: invalidateExact,\n      setData: setData as any,\n      useEndpoint,\n      fetch: fetchEndpoint,\n    } as BuiltForLeaf<L>;\n  }\n\n  return {\n    queryClient,\n    invalidate,\n    build: buildInternal as RouteClient<Names>['build'],\n  };\n}\n\n// -------------------------------------------------------------------------------------\n// Multipart helper\n// -------------------------------------------------------------------------------------\nfunction toFormData(body: Record<string, any>): FormData {\n  const fd = new FormData();\n  for (const [k, v] of Object.entries(body ?? {})) {\n    if (v == null) continue;\n    if (Array.isArray(v)) v.forEach((item, i) => fd.append(`${k}[${i}]`, item as any));\n    else fd.append(k, v as any);\n  }\n  return fd;\n}\n","import { io, Socket } from 'socket.io-client';\nimport { z } from 'zod';\nimport type { SocketEvent } from '@emeryld/rrroutes-contract';\n\nexport type EventMap = Record<string, SocketEvent>;\nexport type Payload<T extends EventMap, K extends keyof T> = z.infer<T[K]['message']>;\n\nexport type ServerEnvelope<T extends EventMap, K extends keyof T & string> = {\n  eventName: K;\n  sentAt: string | Date;\n  sentTo: string[];\n  data?: Payload<T, K>;\n  metadata?: Record<string, unknown>; // [3]\n};\n\nexport type ClientCtx = {\n  receivedAt: Date;\n  latencyMs?: number;\n  nsp?: string;\n  socketId?: string;\n  rooms?: string[];\n  socket?: Socket; // optional exposure if needed by consumers\n};\n\nexport type ClientDebugFlags = {\n  connect?: boolean;\n  disconnect?: boolean;\n  join?: boolean;\n  leave?: boolean;\n  receive?: boolean;\n  emit?: boolean;\n  stats?: boolean;\n};\n\nexport type SocketClientDebug = {\n  enabled?: boolean;\n  verbose?: boolean;\n  logger?: (e: any) => void;\n  flags?: ClientDebugFlags;\n};\n\nexport type SocketClientOptions = {\n  url: string;\n  ioOptions?: Parameters<typeof io>[1];\n  roomJoinEvent?: string;\n  roomLeaveEvent?: string;\n  environment?: 'development' | 'production';\n  /** [5] client-side debug logger */\n  debug?: SocketClientDebug;\n};\n\ntype HandlerEntry<T extends EventMap, K extends keyof T & string> = {\n  orig: (payload: Payload<T, K>, meta: { envelope: ServerEnvelope<T, K>; ctx: ClientCtx }) => void;\n  wrapped: (envelopeOrRaw: ServerEnvelope<T, K> | Payload<T, K>) => void;\n  errorWrapped: (e: unknown) => void;\n};\n\nexport class SocketClient<T extends EventMap> {\n  readonly socket: Socket;\n  private readonly events: T;\n  private readonly roomJoinEvent: string;\n  private readonly roomLeaveEvent: string;\n  private readonly environment: 'development' | 'production';\n  private readonly debug: SocketClientDebug;\n\n  // [6] stats\n  private readonly roomCounts = new Map<string, number>(); // room -> refcount\n  private readonly handlerMap = new Map<string, Set<HandlerEntry<T, any>>>(); // event -> handlers\n\n  constructor(events: T, opts: SocketClientOptions) {\n    this.events = events;\n    this.socket = io(opts.url, { autoConnect: true, ...opts.ioOptions });\n    this.roomJoinEvent = opts.roomJoinEvent ?? 'room:join';\n    this.roomLeaveEvent = opts.roomLeaveEvent ?? 'room:leave';\n    this.environment = opts.environment ?? 'development';\n    this.debug = opts.debug ?? {};\n\n    const dlog = (e: any) => (this.debug.logger ?? console.debug)(['[socket-client]'], e);\n    if (this.debug.enabled && this.debug.flags?.connect) {\n      this.socket.on('connect', () => dlog({ type: 'connect', id: this.socket.id }));\n      this.socket.on('reconnect', (attempt) => dlog({ type: 'reconnect', attempt }));\n    }\n    if (this.debug.enabled && this.debug.flags?.disconnect) {\n      this.socket.on('disconnect', (reason) => dlog({ type: 'disconnect', reason }));\n      this.socket.on('connect_error', (err) => dlog({ type: 'connect_error', err: String(err) }));\n    }\n  }\n\n  /** [6] internal stats snapshot */\n  stats() {\n    const rooms = Array.from(this.roomCounts.entries()).map(([room, count]) => ({ room, count }));\n    const handlers = Array.from(this.handlerMap.entries()).map(([event, set]) => ({\n      event,\n      handlers: set.size,\n    }));\n    return {\n      roomsCount: rooms.length,\n      totalHandlers: handlers.reduce((a, b) => a + b.handlers, 0),\n      rooms,\n      handlers,\n    };\n  }\n\n  private maybeLog(flag: keyof ClientDebugFlags, obj: any) {\n    if (!this.debug.enabled) return;\n    if (!this.debug.flags?.[flag]) return;\n    (this.debug.logger ?? console.debug)(['[socket-client]'], obj);\n  }\n\n  emit<K extends keyof T & string>(\n    event: K,\n    payload: Payload<T, K>,\n    /** [3] optional metadata forwarded to server and logger */\n    metadata?: Record<string, unknown>\n  ): void {\n    const schema = this.events[event].message;\n    const parsed = schema.safeParse(payload);\n    if (!parsed.success) {\n      throw new Error(`Invalid payload for \"${event}\": ${parsed.error.message}`);\n    }\n    // client emits raw payload for app events, plus optional metadata envelope if server expects it\n    // Keep wire format compatible with current server: server wraps on its side.\n    this.socket.emit(String(event), parsed.data);\n    this.maybeLog('emit', { type: 'emit', event, metadata: this.debug.verbose ? metadata : undefined });\n  }\n\n  /** [6] refcount join. Only emits when transitioning 0->1 */\n  joinRooms(rooms?: string[] | string): void {\n    const list = rooms == null ? [] : Array.isArray(rooms) ? rooms : [rooms];\n    const toJoin: string[] = [];\n    for (const r of list) {\n      const next = (this.roomCounts.get(r) ?? 0) + 1;\n      this.roomCounts.set(r, next);\n      if (next === 1) toJoin.push(r);\n    }\n    if (toJoin.length > 0) {\n      this.socket.emit(this.roomJoinEvent, { rooms: toJoin });\n      this.maybeLog('join', { type: 'join', rooms: toJoin, stats: this.debug.verbose ? this.stats() : undefined });\n      this.maybeLog('stats', { type: 'stats', ...this.stats() });\n    }\n  }\n\n  /** [6] refcount leave. Only emits when transitioning 1->0 */\n  leaveRooms(rooms?: string[] | string): void {\n    const list = rooms == null ? [] : Array.isArray(rooms) ? rooms : [rooms];\n    const toLeave: string[] = [];\n    for (const r of list) {\n      const curr = this.roomCounts.get(r) ?? 0;\n      const next = Math.max(0, curr - 1);\n      if (next === 0 && curr > 0) toLeave.push(r);\n      if (next === 0) this.roomCounts.delete(r);\n      else this.roomCounts.set(r, next);\n    }\n    if (toLeave.length > 0) {\n      this.socket.emit(this.roomLeaveEvent, { rooms: toLeave });\n      this.maybeLog('leave', { type: 'leave', rooms: toLeave, stats: this.debug.verbose ? this.stats() : undefined });\n      this.maybeLog('stats', { type: 'stats', ...this.stats() });\n    }\n  }\n\n  on<K extends keyof T & string>(\n    event: K,\n    handler: (payload: Payload<T, K>, meta: { envelope: ServerEnvelope<T, K>; ctx: ClientCtx }) => void,\n  ): () => void {\n    const schema = this.events[event].message;\n\n    const wrapped = (envelopeOrRaw: ServerEnvelope<T, K> | Payload<T, K>) => {\n      const maybeEnvelope = envelopeOrRaw as any;\n      const rawData = maybeEnvelope?.data ?? maybeEnvelope;\n\n      const parsed = schema.safeParse(rawData);\n      if (!parsed.success) return;\n\n      const receivedAt = new Date();\n      const sentAt = maybeEnvelope?.sentAt ? new Date(maybeEnvelope.sentAt) : undefined;\n      const meta = {\n        envelope: {\n          eventName: (maybeEnvelope?.eventName ?? event) as K,\n          sentAt: maybeEnvelope?.sentAt ?? receivedAt.toISOString(),\n          sentTo: maybeEnvelope?.sentTo ?? [],\n          data: undefined, // avoid echoing body to handler meta\n          metadata: maybeEnvelope?.metadata,     // [3]\n        },\n        ctx: {\n          receivedAt,\n          latencyMs: sentAt ? Math.max(0, receivedAt.getTime() - sentAt.getTime()) : undefined,\n          nsp: (this.socket as any).nsp,\n          socketId: this.socket.id,\n          socket: this.socket,\n        },\n      } as const;\n\n      if (this.debug.enabled && this.debug.flags?.receive) {\n        (this.debug.logger ?? console.debug)(['[socket-client]'], {\n          type: 'receive',\n          event,\n          verbose: this.debug.verbose ? { envelope: meta.envelope } : undefined,\n        });\n      }\n\n      handler(parsed.data as any, meta as any);\n    };\n\n    const errorWrapped = (e: unknown) => {\n      if (this.environment === 'development') {\n        // eslint-disable-next-line no-console\n        console.warn(`[socket] ${String(event)}:error`, e);\n      }\n    };\n\n    this.socket.on(String(event), wrapped);\n    this.socket.on(`${String(event)}:error`, errorWrapped);\n\n    // [6] track handlers for precise off\n    let set = this.handlerMap.get(String(event));\n    if (!set) {\n      set = new Set();\n      this.handlerMap.set(String(event), set);\n    }\n    const entry: HandlerEntry<T, K> = { orig: handler, wrapped, errorWrapped };\n    set.add(entry);\n    this.maybeLog('stats', { type: 'stats', ...this.stats() });\n\n    return () => {\n      this.socket.off(String(event), wrapped);\n      this.socket.off(`${String(event)}:error`, errorWrapped);\n      const s = this.handlerMap.get(String(event));\n      if (s) {\n        s.delete(entry);\n        if (s.size === 0) this.handlerMap.delete(String(event));\n      }\n      this.maybeLog('stats', { type: 'stats', ...this.stats() });\n    };\n  }\n\n  /** [4] precise off: remove specific handler if provided, else all for event */\n  off<K extends keyof T & string>(\n    event: K,\n    handler?: (payload: Payload<T, K>, meta: { envelope: ServerEnvelope<T, K>; ctx: ClientCtx }) => void\n  ): void {\n    const set = this.handlerMap.get(String(event));\n    if (!set || set.size === 0) return;\n\n    if (!handler) {\n      // remove all\n      for (const entry of set) {\n        this.socket.off(String(event), entry.wrapped);\n        this.socket.off(`${String(event)}:error`, entry.errorWrapped);\n      }\n      this.handlerMap.delete(String(event));\n    } else {\n      for (const entry of Array.from(set)) {\n        if (entry.orig === handler) {\n          this.socket.off(String(event), entry.wrapped);\n          this.socket.off(`${String(event)}:error`, entry.errorWrapped);\n          set.delete(entry);\n        }\n      }\n      if (set.size === 0) this.handlerMap.delete(String(event));\n    }\n    this.maybeLog('stats', { type: 'stats', ...this.stats() });\n  }\n\n  disconnect(): void {\n    this.socket.disconnect();\n  }\n}\n"],"mappings":"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","names":["useEndpoint"]}
+{"version":3,"sources":["../src/index.ts","../src/routesV3.client.fetch.ts","../src/routesV3.client.index.ts","../src/sockets/socket.client.index.ts"],"sourcesContent":["/**\n * This package exports React Query hooks, so we mark it as client-only to keep Next.js happy.\n */\n'use client';\n\nexport * from './routesV3.client.types';\nexport * from './routesV3.client.fetch';\nexport * from './routesV3.client.index';\nexport * from './sockets/socket.client.index';","// routesV3.client.fetch.ts\n\nimport { Fetcher, FetchInput } from './routesV3.client.types';\n\n/**\n * Default fetch implementation used by the route client helper.\n * @param req Normalized request information (URL, method, body, headers).\n * @returns Parsed JSON (or text fallback) from the server response.\n */\nexport const defaultFetcher: Fetcher = async <T>(req: FetchInput): Promise<T> => {\n  const headers: Record<string, string> = { ...(req.headers ?? {}) };\n  const isFormData = typeof FormData !== 'undefined' && req.body instanceof FormData;\n  if (!isFormData) {\n    headers['Content-Type'] ||= 'application/json';\n    headers['Accept'] ||= 'application/json';\n  }\n\n  const res = await fetch(req.url, {\n    method: req.method,\n    headers,\n    body: isFormData ? (req.body as any) : req.body == null ? undefined : JSON.stringify(req.body),\n  });\n\n  const text = await res.text();\n  if (!res.ok) {\n    const snippet = text.slice(0, 400);\n    throw new Error(`[${res.status}] ${res.statusText} — ${snippet}`);\n  }\n\n  try {\n    return JSON.parse(text) as T;\n  } catch {\n    return text as unknown as T;\n  }\n};\n","// routesV3.client.ts\nimport {\n  keepPreviousData,\n  useInfiniteQuery,\n  useMutation,\n  useQuery,\n  type InfiniteData,\n  type QueryKey,\n} from '@tanstack/react-query';\nimport type { ZodType } from 'zod';\nimport {\n  HttpMethod,\n  buildCacheKey,\n  compilePath,\n} from '@emeryld/rrroutes-contract';\nimport type {\n  AnyLeaf,\n  InferBody,\n  InferOutput,\n  InferParams,\n  InferQuery,\n} from '@emeryld/rrroutes-contract';\nimport { defaultFetcher } from './routesV3.client.fetch';\nimport type {\n  ArgsFor,\n  ArgsTuple,\n  BuildMeta,\n  BuiltForLeaf,\n  BuiltInfinite,\n  BuiltMutation,\n  BuiltQuery,\n  Cursor,\n  DataShape,\n  InfiniteBuildOptionsFor,\n  MutationBuildOptionsFor,\n  QueryBuildOptionsFor,\n  RouteClient,\n  RouteClientOptions,\n  RouteClientDebugEvent,\n  RouteClientDebugLogger,\n  RouteClientDebugMode,\n  RouteClientDebugOptions,\n  RouteClientDebugToggleOptions,\n  Updater,\n} from './routesV3.client.types';\n\n// -------------------------------------------------------------------------------------\n// Tiny helpers\n// -------------------------------------------------------------------------------------\n/**\n * Convert an HTTP method to uppercase (as expected by fetch).\n * @param m Lowercase HTTP method.\n * @returns Uppercase method string.\n */\nconst toUpper = (m: HttpMethod): Uppercase<HttpMethod> => m.toUpperCase() as Uppercase<HttpMethod>;\n\n/**\n * Parse the given value with the supplied schema (if present).\n * @param value Raw value to validate.\n * @param schema Optional Zod schema used for validation/coercion.\n * @returns The validated or original value.\n */\nfunction zParse<T>(value: unknown, schema?: ZodType): T {\n  return schema ? (schema.parse(value) as T) : (value as T);\n}\n\n/**\n * Serialize a query object into a search string.\n * @param query Query params object (possibly undefined).\n * @returns Query string prefixed with `?`, or empty string.\n */\nfunction toSearchString(query: Record<string, unknown> | undefined) {\n  if (!query) return '';\n  const params = new URLSearchParams();\n  for (const [k, v] of Object.entries(query)) {\n    if (v == null) continue;\n    if (Array.isArray(v)) {\n      v.forEach((x) => {\n        if (x == null) return;\n        if (typeof x === 'object') {\n          params.append(k, JSON.stringify(x));\n        } else {\n          params.append(k, String(x));\n        }\n      });\n      continue;\n    }\n    if (typeof v === 'object') {\n      params.set(k, JSON.stringify(v));\n      continue;\n    }\n    params.set(k, String(v));\n  }\n  const s = params.toString();\n  return s ? `?${s}` : '';\n}\n\n/**\n * Remove the given key from an object (used to drop cursors from cache keys).\n * @param obj Source object.\n * @param key Property name to omit.\n * @returns Copy of the object without the specified key.\n */\nfunction stripKey<Q extends Record<string, unknown> | undefined>(obj: Q, key: string): Q {\n  if (!obj) return obj;\n  const { [key]: _omit, ...rest } = obj as any;\n  return rest as Q;\n}\n\n/**\n * Default cursor extractor used by infinite queries.\n * @param p Page result returned from the server.\n * @returns Next cursor string, if present.\n */\nconst defaultGetNextCursor = (p: unknown): Cursor =>\n  p && typeof p === 'object' && 'nextCursor' in p ? (p as any).nextCursor : undefined;\n\n// Debug logging --------------------------------------------------------------\nconst noopDebugLogger: RouteClientDebugLogger = () => {};\n\nconst defaultDebugLogger: RouteClientDebugLogger = (event: RouteClientDebugEvent) => {\n  if (typeof console === 'undefined') return;\n  const fn = console.debug ?? console.log;\n  fn?.call(console, '[rrroutes-client]', event);\n};\n\nconst debugEventTypes: RouteClientDebugEvent['type'][] = [\n  'fetch',\n  'invalidate',\n  'setData',\n  'build',\n  'useEndpoint',\n];\n\ntype DebugEmitter<Names extends string> = {\n  emit: (event: RouteClientDebugEvent, name?: Names) => void;\n  mode: RouteClientDebugMode;\n};\n\nconst noopEmit = () => {};\n\nfunction createDebugEmitter<Names extends string>(\n  option?: RouteClientDebugOptions<Names>,\n  environment?: string,\n): DebugEmitter<Names> {\n  const disabled: DebugEmitter<Names> = { emit: noopEmit, mode: 'minimal' };\n\n  if (environment && environment.toLowerCase() === 'production') {\n    return disabled;\n  }\n\n  if (!option) {\n    return disabled;\n  }\n  if (option === true || option === 'minimal') {\n    return {\n      emit: (event, name) => defaultDebugLogger(name ? { ...event, name } : event),\n      mode: 'minimal',\n    };\n  }\n  if (option === 'complete') {\n    return {\n      emit: (event, name) => defaultDebugLogger(name ? { ...event, name } : event),\n      mode: 'complete',\n    };\n  }\n  if (typeof option === 'function') {\n    return {\n      emit: (event, name) => option(name ? { ...event, name } : event),\n      mode: 'minimal',\n    };\n  }\n  if (typeof option === 'object') {\n    const toggles = option as RouteClientDebugToggleOptions<Names>;\n    const verbose = Boolean(toggles.verbose);\n    const enabledTypes = debugEventTypes.filter((type) => toggles[type]);\n    if (enabledTypes.length === 0) {\n      return { emit: noopEmit, mode: verbose ? 'complete' : 'minimal' };\n    }\n    const whitelist = new Set<RouteClientDebugEvent['type']>(enabledTypes);\n    const onlySet =\n      toggles.only && toggles.only.length > 0 ? new Set<Names>(toggles.only) : undefined;\n    const logger = toggles.logger ?? defaultDebugLogger;\n    const emit: DebugEmitter<Names>['emit'] = (event, name) => {\n      if (!whitelist.has(event.type)) return;\n      if (onlySet) {\n        if (!name || !onlySet.has(name)) return;\n      }\n      logger(name ? { ...event, name } : event);\n    };\n    return { emit, mode: verbose ? 'complete' : 'minimal' };\n  }\n\n  return disabled;\n}\n\n// Split the variadic tuple at runtime\n/**\n * Extract the optional argument object from a variadic tuple.\n * @param args Tuple passed to a built endpoint helper.\n * @returns The argument object if present.\n */\nfunction extractArgs<L extends AnyLeaf>(args: ArgsTuple<L>): ArgsFor<L> | undefined {\n  // At runtime ArgsTuple<L> is either [] or [obj]; we just pick the first if present.\n  return (args as unknown as any[])[0] as any;\n}\n\n/**\n * Normalize params and query values, then construct a request URL for the given leaf.\n * @param leaf Leaf describing the endpoint.\n * @param baseUrl Optional base URL prepended to the path.\n * @param params Route parameters supplied by the caller.\n * @param query Query parameters supplied by the caller.\n * @returns Object containing the composed URL plus normalized params/query payloads.\n */\nfunction buildUrl<L extends AnyLeaf>(\n  leaf: L,\n  baseUrl: string,\n  params: InferParams<L> | undefined,\n  query: InferQuery<L> | undefined,\n) {\n  const normalizedParams = zParse<InferParams<L>>(params, leaf.cfg.paramsSchema);\n  const normalizedQuery = zParse<InferQuery<L>>(query, leaf.cfg.querySchema);\n  const path = compilePath<L['path']>(leaf.path, (normalizedParams ?? {}) as any);\n  const url = `${baseUrl ?? ''}${path}${toSearchString(normalizedQuery as any)}`;\n  return { url, normalizedQuery, normalizedParams };\n}\n\n// -------------------------------------------------------------------------------------\n// Client factory\n// -------------------------------------------------------------------------------------\n/**\n * Construct typed React Query helpers backed by a routes-v3 registry leaf.\n * @param opts Route client configuration (query client, fetcher overrides, etc).\n * @returns Object that can build endpoint hooks/mutations from leaves.\n */\nexport function createRouteClient<Names extends string = string>(\n  opts: RouteClientOptions<Names>,\n): RouteClient<Names> {\n  const queryClient = opts.queryClient;\n  const fetcher = opts.fetcher ?? defaultFetcher;\n  const baseUrl = opts.baseUrl;\n  const cursorParam = opts.cursorParam ?? 'cursor';\n  const getNextCursor = opts.getNextCursor ?? defaultGetNextCursor;\n  const environment =\n    opts.environment ?? undefined;\n  const { emit: emitDebug, mode: debugMode } = createDebugEmitter<Names>(opts.debug, environment);\n  const isVerboseDebug = debugMode === 'complete';\n  const decorateDebugEvent = <T extends RouteClientDebugEvent>(\n    event: T,\n    details?: Partial<RouteClientDebugEvent>,\n  ): RouteClientDebugEvent => {\n    if (!isVerboseDebug || !details) return event;\n    return { ...event, ...details } as RouteClientDebugEvent;\n  };\n\n  /**\n   * Invalidate a set of queries sharing the given prefix.\n   * @param prefix Key parts shared by matching endpoints.\n   * @param exact When true, invalidate only exact key matches.\n   */\n  async function invalidate(prefix: string[], exact = false) {\n    const queryKey = prefix as unknown as QueryKey;\n    await queryClient.invalidateQueries({ queryKey, exact });\n    emitDebug({ type: 'invalidate', key: queryKey, exact });\n  }\n\n  /**\n   * Build the client surface for a single leaf (query/mutation/infinite query).\n   * @param leaf Leaf describing the endpoint.\n   * @param rqOpts Optional React Query configuration.\n   * @returns Helper object exposing key/invalidate/setData/useEndpoint.\n   */\n  function buildInternal<L extends AnyLeaf>(\n    leaf: L,\n    rqOpts?: QueryBuildOptionsFor<L> | InfiniteBuildOptionsFor<L> | MutationBuildOptionsFor<L>,\n    meta?: BuildMeta<Names>,\n  ): BuiltForLeaf<L> {\n    const isGet = leaf.method === 'get';\n    const isFeed = !!leaf.cfg.feed;\n    const method = toUpper(leaf.method);\n    const leafLabel = `${leaf.method.toUpperCase()} ${String(leaf.path)}`;\n    const debugName = meta?.name;\n    const emit = (event: RouteClientDebugEvent) => emitDebug(event, debugName);\n    emit({ type: 'build', leaf: leafLabel });\n\n    // --- key/invalidate/setData shared helpers ---\n    const key = (...tuple: ArgsTuple<L>): QueryKey => {\n      const a = extractArgs<L>(tuple);\n      const params = (a as any)?.params as InferParams<L> | undefined;\n      const query = (a as any)?.query as InferQuery<L> | undefined;\n      const qForKey = isGet && isFeed ? stripKey(query as any, cursorParam) : (query as any);\n      return buildCacheKey({ leaf, params: params as any, query: qForKey }) as unknown as QueryKey;\n    };\n\n    /**\n     * Invalidate the React Query cache for this exact leaf invocation.\n     * @param tuple Optional params/query tuple.\n     */\n    const invalidateExact = async (...tuple: ArgsTuple<L>) => {\n      const queryKey = key(...tuple);\n      await queryClient.invalidateQueries({ queryKey, exact: true });\n      emit({ type: 'invalidate', key: queryKey, exact: true });\n    };\n\n    /**\n     * Update the cache entries for this leaf.\n     * @param args Tuple whose first entry is the updater and optional params/query follow.\n     */\n    const setData = (...args: [Updater<DataShape<L>>, ...rest: ArgsTuple<L>]) => {\n      const [updater, ...rest] = args;\n      const k = key(...(rest as ArgsTuple<L>));\n      if (isGet && isFeed) {\n        queryClient.setQueryData<InfiniteData<InferOutput<L>> | undefined>(k, (prev) =>\n          typeof updater === 'function' ? (updater as any)(prev) : (updater as any),\n        );\n      } else {\n        queryClient.setQueryData<InferOutput<L> | undefined>(k, (prev) =>\n          typeof updater === 'function' ? (updater as any)(prev) : (updater as any),\n        );\n      }\n      emit({ type: 'setData', key: k });\n    };\n\n    // --- Infinite GET ---\n    if (isGet && isFeed) {\n      const useEndpoint: BuiltInfinite<L>['useEndpoint'] = (...tuple) => {\n        emit({ type: 'useEndpoint', leaf: leafLabel, variant: 'infiniteGet' });\n        const a = extractArgs<L>(tuple);\n        const params = (a as any)?.params as InferParams<L> | undefined;\n        const query = (a as any)?.query as InferQuery<L> | undefined;\n\n        // Normalize once; we’ll inject the cursor per page below.\n        const { normalizedQuery, normalizedParams } = buildUrl(leaf, baseUrl, params, query);\n        return useInfiniteQuery<\n          InferOutput<L>, // TQueryFnData (per page)\n          unknown, // TError\n          InfiniteData<InferOutput<L>>, // TData (returned by the hook)\n          QueryKey,\n          Cursor\n        >({\n          ...(rqOpts as InfiniteBuildOptionsFor<L>),\n          queryKey: key(...tuple),\n          initialPageParam: undefined,\n          getNextPageParam: (lastPage) => getNextCursor(lastPage),\n          placeholderData: keepPreviousData,\n          queryFn: async ({ pageParam }) => {\n            const pageQuery = {\n              ...(normalizedQuery as any),\n              ...(pageParam ? { [cursorParam]: pageParam } : {}),\n            };\n            const { url } = buildUrl(leaf, baseUrl, params, pageQuery);\n            const startedAt = Date.now();\n            const detail = isVerboseDebug ? { params: normalizedParams, query: pageQuery } : undefined;\n            emit(\n              decorateDebugEvent(\n                { type: 'fetch', stage: 'start', method, url, leaf: leafLabel },\n                detail,\n              ),\n            );\n            try {\n              const out = await fetcher<unknown>({ url, method });\n              const parsed = zParse<InferOutput<L>>(out, leaf.cfg.outputSchema);\n              emit(\n                decorateDebugEvent(\n                  {\n                    type: 'fetch',\n                    stage: 'success',\n                    method,\n                    url,\n                    leaf: leafLabel,\n                    durationMs: Date.now() - startedAt,\n                  },\n                  isVerboseDebug ? { params: normalizedParams, query: pageQuery, output: parsed } : undefined,\n                ),\n              );\n              return parsed;\n            } catch (error) {\n              emit(\n                decorateDebugEvent(\n                  {\n                    type: 'fetch',\n                    stage: 'error',\n                    method,\n                    url,\n                    leaf: leafLabel,\n                    durationMs: Date.now() - startedAt,\n                    error,\n                  },\n                  detail,\n                ),\n              );\n              throw error;\n            }\n          },\n          // NOTE: TData is InfiniteData<T>, so we don't need a select here.\n        }, queryClient);\n      };\n\n      return {\n        key,\n        invalidate: invalidateExact,\n        setData: setData as any,\n        useEndpoint,\n      } as BuiltForLeaf<L>;\n    }\n    // --- Plain GET ---\n    if (isGet) {\n      const useEndpoint: BuiltQuery<L>['useEndpoint'] = (...tuple) => {\n        emit({ type: 'useEndpoint', leaf: leafLabel, variant: 'get' });\n        const a = extractArgs<L>(tuple);\n        const params = (a as any)?.params as InferParams<L> | undefined;\n        const query = (a as any)?.query as InferQuery<L> | undefined;\n\n        const { url, normalizedQuery, normalizedParams } = buildUrl(leaf, baseUrl, params, query);\n        return useQuery<InferOutput<L>, unknown, InferOutput<L>, QueryKey>({\n          ...(rqOpts as QueryBuildOptionsFor<L>),\n          queryKey: key(...tuple),\n          placeholderData: keepPreviousData,\n          queryFn: async () => {\n            const startedAt = Date.now();\n            const detail = isVerboseDebug\n              ? { params: normalizedParams, query: normalizedQuery }\n              : undefined;\n            emit(\n              decorateDebugEvent(\n                { type: 'fetch', stage: 'start', method, url, leaf: leafLabel },\n                detail,\n              ),\n            );\n            try {\n              const out = await fetcher<unknown>({ url, method });\n              const parsed = zParse<InferOutput<L>>(out, leaf.cfg.outputSchema);\n              emit(\n                decorateDebugEvent(\n                  {\n                    type: 'fetch',\n                    stage: 'success',\n                    method,\n                    url,\n                    leaf: leafLabel,\n                    durationMs: Date.now() - startedAt,\n                  },\n                  isVerboseDebug\n                    ? { params: normalizedParams, query: normalizedQuery, output: parsed }\n                    : undefined,\n                ),\n              );\n              return parsed;\n            } catch (error) {\n              emit(\n                decorateDebugEvent(\n                  {\n                    type: 'fetch',\n                    stage: 'error',\n                    method,\n                    url,\n                    leaf: leafLabel,\n                    durationMs: Date.now() - startedAt,\n                    error,\n                  },\n                  detail,\n                ),\n              );\n              throw error;\n            }\n          },\n        }, queryClient);\n      };\n\n      return {\n        key,\n        invalidate: invalidateExact,\n        setData: setData as any,\n        useEndpoint,\n      } as BuiltForLeaf<L>;\n    }\n\n    // --- Mutation (POST/PUT/PATCH/DELETE) ---\n    const fetchEndpoint: BuiltMutation<L>['fetch'] = async (\n      ...tupleWithBody: [...ArgsTuple<L>, InferBody<L>]\n    ) => {\n      if (tupleWithBody.length === 0) {\n        throw new Error('Body is required when invoking a mutation fetch.');\n      }\n      const bodyIndex = tupleWithBody.length - 1;\n      const tuple = tupleWithBody.slice(0, bodyIndex) as ArgsTuple<L>;\n      const body = tupleWithBody[bodyIndex] as InferBody<L>;\n      const args = extractArgs<L>(tuple);\n      const params = (args as any)?.params as InferParams<L> | undefined;\n      const query = (args as any)?.query as InferQuery<L> | undefined;\n\n      const { url, normalizedQuery, normalizedParams } = buildUrl(leaf, baseUrl, params, query);\n      const normalizedBody = zParse<InferBody<L>>(body, leaf.cfg.bodySchema);\n\n      // Optional: switch to FormData if your method declares bodyFiles\n      const isMultipart = Array.isArray(leaf.cfg.bodyFiles) && leaf.cfg.bodyFiles.length > 0;\n      const payload = isMultipart ? toFormData(normalizedBody as any) : normalizedBody;\n\n      const startedAt = Date.now();\n      const detail = isVerboseDebug\n        ? { params: normalizedParams, query: normalizedQuery }\n        : undefined;\n      emit(\n        decorateDebugEvent(\n          {\n            type: 'fetch',\n            stage: 'start',\n            method,\n            url,\n            leaf: leafLabel,\n            body: payload,\n          },\n          detail,\n        ),\n      );\n      try {\n        const out = await fetcher<unknown>({ url, method, body: payload });\n        const parsed = zParse<InferOutput<L>>(out, leaf.cfg.outputSchema);\n        emit(\n          decorateDebugEvent(\n            {\n              type: 'fetch',\n              stage: 'success',\n              method,\n              url,\n              leaf: leafLabel,\n              durationMs: Date.now() - startedAt,\n            },\n            isVerboseDebug\n              ? { params: normalizedParams, query: normalizedQuery, output: parsed }\n              : undefined,\n          ),\n        );\n        return parsed;\n      } catch (error) {\n        emit(\n          decorateDebugEvent(\n            {\n              type: 'fetch',\n              stage: 'error',\n              method,\n              url,\n              leaf: leafLabel,\n              durationMs: Date.now() - startedAt,\n              body: payload,\n              error,\n            },\n            detail,\n          ),\n        );\n        throw error;\n      }\n    };\n\n    const useEndpoint: BuiltMutation<L>['useEndpoint'] = (...tuple) => {\n      emit({ type: 'useEndpoint', leaf: leafLabel, variant: 'mutation' });\n      return useMutation<InferOutput<L>, unknown, InferBody<L>, unknown>({\n        ...(rqOpts as MutationBuildOptionsFor<L>),\n        mutationKey: key(...tuple),\n        mutationFn: (body: InferBody<L>) =>\n          fetchEndpoint(...([...tuple, body] as [...ArgsTuple<L>, InferBody<L>])),\n      }, queryClient);\n    };\n\n    return {\n      key,\n      invalidate: invalidateExact,\n      setData: setData as any,\n      useEndpoint,\n      fetch: fetchEndpoint,\n    } as BuiltForLeaf<L>;\n  }\n\n  return {\n    queryClient,\n    invalidate,\n    build: buildInternal as RouteClient<Names>['build'],\n  };\n}\n\n// -------------------------------------------------------------------------------------\n// Multipart helper\n// -------------------------------------------------------------------------------------\nfunction toFormData(body: Record<string, any>): FormData {\n  const fd = new FormData();\n  for (const [k, v] of Object.entries(body ?? {})) {\n    if (v == null) continue;\n    if (Array.isArray(v)) v.forEach((item, i) => fd.append(`${k}[${i}]`, item as any));\n    else fd.append(k, v as any);\n  }\n  return fd;\n}\n","// socket.client.index.ts\n\nimport { io, Socket } from 'socket.io-client';\nimport { z } from 'zod';\nimport type { SocketEvent } from '@emeryld/rrroutes-contract';\n\nexport type EventMap = Record<string, SocketEvent>;\nexport type Payload<T extends EventMap, K extends keyof T> = z.infer<T[K]['message']>;\n\nexport type ServerEnvelope<T extends EventMap, K extends keyof T & string> = {\n  eventName: K;\n  sentAt: string | Date;\n  sentTo: string[];\n  data?: Payload<T, K>;\n  metadata?: Record<string, unknown>;\n};\n\nexport type ClientCtx = {\n  receivedAt: Date;\n  latencyMs?: number;\n  nsp?: string;\n  socketId?: string;\n  rooms?: string[];\n  socket?: Socket;\n  reply?: (data?: unknown) => void;\n};\n\n/** === NEW: typed client debug === */\nexport type ClientStatsSnapshot = {\n  roomsCount: number;\n  totalHandlers: number;\n  rooms: { room: string; count: number }[];\n  handlers: { event: string; handlers: number }[];\n};\n\nexport type SocketClientDebugEvent<K extends string = string> =\n  | { type: 'connect'; id: string }\n  | { type: 'reconnect'; attempt: number }\n  | { type: 'disconnect'; reason: string }\n  | { type: 'connect_error'; err: string }\n  | { type: 'register'; event: K }\n  | { type: 'unregister'; event: K }\n  | { type: 'emit'; event: K; metadata?: Record<string, unknown> }\n  | { type: 'receive'; event: K; envelope?: { eventName: K; sentAt: string | Date; sentTo: string[]; metadata?: Record<string, unknown> } }\n  | { type: 'join'; rooms: string[]; stats?: ClientStatsSnapshot }\n  | { type: 'leave'; rooms: string[]; stats?: ClientStatsSnapshot }\n  | { type: 'stats'; value: ClientStatsSnapshot }\n  // NEW: heartbeat\n  | { type: 'ping_emit'; payload: unknown }\n  | { type: 'pong_recv'; latencyMs: number; payload?: unknown };\n\nexport type SocketClientDebugOptions<K extends string = string> = {\n  verbose?: boolean;\n  only?: K[];\n  logger?: (e: SocketClientDebugEvent<K>) => void;\n} & {\n  [P in SocketClientDebugEvent['type']]?: boolean;\n};\n\n/** === NEW: Heartbeat config (enforced) === */\nexport type HeartbeatClientOptions = {\n  /** Event names. Defaults are 'sys:ping' and 'sys:pong'. */\n  pingEvent?: string;\n  pongEvent?: string;\n  /** Interval between pings. Default 15_000. */\n  intervalMs?: number;\n  /** Give up waiting for pong after this many ms. Default 7_500. */\n  timeoutMs?: number;\n\n  /** Schema of the ping payload you will emit. */\n  pingSchema: z.ZodTypeAny;\n  /** Produce the ping payload on each tick. */\n  makePingPayload: (ctx: { socket: Socket }) => unknown;\n\n  /** Optional validation of the pong payload you receive. */\n  pongSchema?: z.ZodTypeAny;\n  /** Optional hook called on each pong. */\n  onPong?: (args: { latencyMs: number; payload?: unknown; socket: Socket }) => void;\n};\n\nexport type SocketClientOptions<T extends EventMap = EventMap> = {\n  url: string;\n  ioOptions?: Parameters<typeof io>[1];\n  roomJoinEvent?: string;\n  roomLeaveEvent?: string;\n  environment?: 'development' | 'production';\n  debug?: SocketClientDebugOptions<keyof T & string>;\n\n  /** NEW: required heartbeat config */\n  heartbeat: HeartbeatClientOptions;\n};\n\ntype HandlerEntry<T extends EventMap, K extends keyof T & string> = {\n  orig: (payload: Payload<T, K>, meta: { envelope: ServerEnvelope<T, K>; ctx: ClientCtx }) => void;\n  wrapped: (envelopeOrRaw: ServerEnvelope<T, K> | Payload<T, K>) => void;\n  errorWrapped: (e: unknown) => void;\n};\n\nexport class SocketClient<T extends EventMap> {\n  readonly socket: Socket;\n  private readonly events: T;\n  private readonly roomJoinEvent: string;\n  private readonly roomLeaveEvent: string;\n  private readonly environment: 'development' | 'production';\n  private readonly debug: SocketClientDebugOptions<keyof T & string>;\n\n  // NEW\n  private readonly hb: Required<Omit<HeartbeatClientOptions, 'pongSchema' | 'onPong'>> & {\n    pongSchema?: z.ZodTypeAny;\n    onPong?: HeartbeatClientOptions['onPong'];\n  };\n  private hbTimer: ReturnType<typeof setInterval> | null = null;\n\n  // stats\n  private readonly roomCounts = new Map<string, number>();\n  private readonly handlerMap = new Map<string, Set<HandlerEntry<T, any>>>();\n\n  constructor(events: T, opts: SocketClientOptions<T>) {\n    this.events = events;\n    this.socket = io(opts.url, { autoConnect: true, ...opts.ioOptions });\n    this.roomJoinEvent = opts.roomJoinEvent ?? 'room:join';\n    this.roomLeaveEvent = opts.roomLeaveEvent ?? 'room:leave';\n    this.environment = opts.environment ?? 'development';\n    this.debug = opts.debug ?? {};\n    // heartbeat\n    const hb = opts.heartbeat;\n    this.hb = {\n      pingEvent: hb.pingEvent ?? 'sys:ping',\n      pongEvent: hb.pongEvent ?? 'sys:pong',\n      intervalMs: hb.intervalMs ?? 15_000,\n      timeoutMs: hb.timeoutMs ?? 7_500,\n      pingSchema: hb.pingSchema,\n      makePingPayload: hb.makePingPayload,\n      pongSchema: hb.pongSchema,\n      onPong: hb.onPong,\n    };\n\n    const dbg = <K extends keyof T & string | 'connect' | 'disconnect' | 'reconnect' | 'connect_error' | 'join' | 'leave' | 'stats' | 'ping_emit' | 'pong_recv'>(\n      key: K,\n      e: SocketClientDebugEvent<any>\n    ) => {\n      const d = this.debug;\n      if (!d.logger) return;\n      if (!d[e.type]) return;\n      if (d.only && 'event' in e && typeof (e as any).event === 'string' && !d.only.includes((e as any).event)) return;\n      d.logger(e);\n    };\n\n    // socket lifecycle\n    this.socket.on('connect', () => {\n      dbg('connect', { type: 'connect', id: this.socket.id ?? '' });\n      this.startHeartbeat(dbg);\n    });\n    this.socket.on('reconnect', (attempt) => dbg('reconnect', { type: 'reconnect', attempt }));\n    this.socket.on('disconnect', (reason) => {\n      dbg('disconnect', { type: 'disconnect', reason: String(reason) });\n      this.stopHeartbeat();\n    });\n    this.socket.on('connect_error', (err) => dbg('connect_error', { type: 'connect_error', err: String(err) }));\n\n    // wire pong listener\n    this.socket.on(this.hb.pongEvent, (raw: any) => {\n      const receivedAt = Date.now();\n      const serverNowIso: string | undefined = raw?.serverNow;\n      const clientSentIso: string | undefined = raw?.clientEcho?.__clientSentAt;\n      let latencyMs: number | undefined;\n\n      if (clientSentIso) {\n        const sent = Date.parse(clientSentIso);\n        if (!Number.isNaN(sent)) latencyMs = Math.max(0, receivedAt - sent);\n      }\n\n      if (this.hb.pongSchema) {\n        const ok = this.hb.pongSchema.safeParse(raw);\n        if (!ok.success) return; // drop invalid\n      }\n\n      if (this.debug.logger && this.debug.pong_recv) {\n        this.debug.logger({ type: 'pong_recv', latencyMs: latencyMs ?? raw?.sinceMs ?? 0, payload: raw });\n      }\n      this.hb.onPong?.({ latencyMs: latencyMs ?? raw?.sinceMs ?? 0, payload: raw, socket: this.socket });\n    });\n  }\n\n  /** internal stats snapshot */\n  stats(): ClientStatsSnapshot {\n    const rooms = Array.from(this.roomCounts.entries()).map(([room, count]) => ({ room, count }));\n    const handlers = Array.from(this.handlerMap.entries()).map(([event, set]) => ({\n      event,\n      handlers: set.size,\n    }));\n    return {\n      roomsCount: rooms.length,\n      totalHandlers: handlers.reduce((a, b) => a + b.handlers, 0),\n      rooms,\n      handlers,\n    };\n  }\n\n  private toArray(rooms?: string[] | string): string[] {\n    return rooms == null ? [] : Array.isArray(rooms) ? rooms : [rooms];\n  }\n\n  /** === NEW: heartbeat control === */\n  private startHeartbeat(dbg: (k: any, e: SocketClientDebugEvent) => void) {\n    this.stopHeartbeat();\n    const tick = () => {\n      const basePayload = this.hb.makePingPayload({ socket: this.socket }) ?? {};\n      const candidate = { ...basePayload, __clientSentAt: new Date().toISOString() };\n\n      const check = this.hb.pingSchema.safeParse(candidate);\n      if (!check.success) {\n        if (this.environment === 'development') console.warn('[socket] ping schema validation failed', check.error.issues);\n        return;\n      }\n\n      // emit with ack timeout support\n      const timer = setTimeout(() => {\n        /* timeout, no-op here. consumer can observe missing pong if desired */\n      }, this.hb.timeoutMs);\n\n      this.socket.timeout(this.hb.timeoutMs).emit(this.hb.pingEvent, { payload: check.data }, () => {\n        clearTimeout(timer);\n      });\n      if (this.debug.logger && this.debug.ping_emit) {\n        dbg('ping_emit', { type: 'ping_emit', payload: check.data });\n      }\n    };\n\n    this.hbTimer = setInterval(tick, this.hb.intervalMs);\n    // fire first ping immediately\n    tick();\n  }\n\n  private stopHeartbeat() {\n    if (this.hbTimer) {\n      clearInterval(this.hbTimer);\n      this.hbTimer = null;\n    }\n  }\n\nemit<K extends keyof T & string>(\n  event: K,\n  payload: Payload<T, K>,\n  metadata?: Record<string, unknown>,\n  onAck?: (ack: unknown) => void,      \n  timeoutMs?: number                      \n): void {\n  const schema = this.events[event].message;\n  const parsed = schema.safeParse(payload);\n  if (!parsed.success) throw new Error(`Invalid payload for \"${event}\": ${parsed.error.message}`);\n\n  if (onAck) {\n    this.socket.timeout(timeoutMs ?? this.hb.timeoutMs).emit(String(event), parsed.data, (ack: unknown) => {\n      try { onAck(ack); } catch { /* noop */ }\n    });\n  } else {\n    this.socket.emit(String(event), parsed.data);\n  }\n\n  if (this.debug.logger && this.debug.emit) {\n    this.debug.logger({ type: 'emit', event, metadata: this.debug.verbose ? metadata : undefined } as any);\n  }\n}\n\n\n  joinRooms(rooms?: string[] | string): void {\n    const list = this.toArray(rooms);\n    const toJoin: string[] = [];\n    for (const r of list) {\n      const next = (this.roomCounts.get(r) ?? 0) + 1;\n      this.roomCounts.set(r, next);\n      if (next === 1) toJoin.push(r);\n    }\n    if (toJoin.length > 0) {\n      this.socket.emit(this.roomJoinEvent, { rooms: toJoin });\n      if (this.debug.logger && this.debug.join) {\n        this.debug.logger({ type: 'join', rooms: toJoin, stats: this.debug.stats || this.debug.verbose ? this.stats() : undefined });\n      }\n    }\n  }\n\n  leaveRooms(rooms?: string[] | string): void {\n    const list = this.toArray(rooms);\n    const toLeave: string[] = [];\n    for (const r of list) {\n      const curr = this.roomCounts.get(r) ?? 0;\n      const next = Math.max(0, curr - 1);\n      if (next === 0 && curr > 0) toLeave.push(r);\n      if (next === 0) this.roomCounts.delete(r);\n      else this.roomCounts.set(r, next);\n    }\n    if (toLeave.length > 0) {\n      this.socket.emit(this.roomLeaveEvent, { rooms: toLeave });\n      if (this.debug.logger && this.debug.leave) {\n        this.debug.logger({ type: 'leave', rooms: toLeave, stats: this.debug.stats || this.debug.verbose ? this.stats() : undefined });\n      }\n    }\n  }\n\n  on<K extends keyof T & string>(\n    event: K,\n    handler: (payload: Payload<T, K>, meta: { envelope: ServerEnvelope<T, K>; ctx: ClientCtx }) => void,\n  ): () => void {\n    const schema = this.events[event].message;\n\n    if (this.debug.logger && this.debug.register) {\n      this.debug.logger({ type: 'register', event } as any);\n    }\n\nconst wrapped = (envelopeOrRaw: ServerEnvelope<T, K> | Payload<T, K>, maybeAck?: (data?: unknown) => void) => {\n  const maybeEnvelope = envelopeOrRaw as any;\n  const rawData = maybeEnvelope?.data ?? maybeEnvelope;\n\n  const parsed = schema.safeParse(rawData);\n  if (!parsed.success) return;\n\n  const receivedAt = new Date();\n  const sentAt = maybeEnvelope?.sentAt ? new Date(maybeEnvelope.sentAt) : undefined;\n\n  const meta = {\n    envelope: {\n      eventName: (maybeEnvelope?.eventName ?? event) as K,\n      sentAt: maybeEnvelope?.sentAt ?? receivedAt.toISOString(),\n      sentTo: maybeEnvelope?.sentTo ?? [],\n      data: undefined,\n      metadata: maybeEnvelope?.metadata,\n    },\n    ctx: {\n      receivedAt,\n      latencyMs: sentAt ? Math.max(0, receivedAt.getTime() - sentAt.getTime()) : undefined,\n      nsp: (this.socket as any).nsp,\n      socketId: this.socket.id,\n      socket: this.socket,\n      reply: typeof maybeAck === 'function' ? (d?: unknown) => { try { maybeAck(d); } catch { /* noop */ } } : undefined, // NEW\n    },\n  } as const;\n\n  if (this.debug.logger && this.debug.receive) {\n    this.debug.logger({\n      type: 'receive',\n      event,\n      envelope: this.debug.verbose\n        ? { eventName: meta.envelope.eventName, sentAt: meta.envelope.sentAt, sentTo: meta.envelope.sentTo, metadata: meta.envelope.metadata }\n        : undefined,\n    } as any);\n  }\n\n  handler(parsed.data as any, meta as any);\n};\n\n\n    const errorWrapped = (e: unknown) => {\n      if (this.environment === 'development') {\n        // eslint-disable-next-line no-console\n        console.warn(`[socket] ${String(event)}:error`, e);\n      }\n    };\n\n    this.socket.on(String(event), wrapped);\n    this.socket.on(`${String(event)}:error`, errorWrapped);\n\n    let set = this.handlerMap.get(String(event));\n    if (!set) {\n      set = new Set();\n      this.handlerMap.set(String(event), set);\n    }\n    const entry: HandlerEntry<T, K> = { orig: handler, wrapped, errorWrapped };\n    set.add(entry);\n\n    return () => {\n      this.socket.off(String(event), wrapped);\n      this.socket.off(`${String(event)}:error`, errorWrapped);\n      const s = this.handlerMap.get(String(event));\n      if (s) {\n        s.delete(entry);\n        if (s.size === 0) this.handlerMap.delete(String(event));\n      }\n      if (this.debug.logger && this.debug.unregister) {\n        this.debug.logger({ type: 'unregister', event } as any);\n      }\n    };\n  }\n\n  disconnect(): void {\n    this.stopHeartbeat();\n    this.socket.disconnect();\n  }\n\n  connect(): void {\n    this.socket.connect();\n  }\n}\n"],"mappings":"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","names":["useEndpoint"]}

package/dist/index.mjs

@@ -432,11 +432,10 @@ function toFormData(body) {
 // src/sockets/socket.client.index.ts
 import { io } from "socket.io-client";
 var SocketClient = class {
-  // event -> handlers
   constructor(events, opts) {
-    // [6] stats
+    this.hbTimer = null;
+    // stats
     this.roomCounts = /* @__PURE__ */ new Map();
-    // room -> refcount
     this.handlerMap = /* @__PURE__ */ new Map();
     this.events = events;
     this.socket = io(opts.url, { autoConnect: true, ...opts.ioOptions });
@@ -444,17 +443,54 @@ var SocketClient = class {
     this.roomLeaveEvent = opts.roomLeaveEvent ?? "room:leave";
     this.environment = opts.environment ?? "development";
     this.debug = opts.debug ?? {};
-    const dlog = (e) => (this.debug.logger ?? console.debug)(["[socket-client]"], e);
-    if (this.debug.enabled && this.debug.flags?.connect) {
-      this.socket.on("connect", () => dlog({ type: "connect", id: this.socket.id }));
-      this.socket.on("reconnect", (attempt) => dlog({ type: "reconnect", attempt }));
-    }
-    if (this.debug.enabled && this.debug.flags?.disconnect) {
-      this.socket.on("disconnect", (reason) => dlog({ type: "disconnect", reason }));
-      this.socket.on("connect_error", (err) => dlog({ type: "connect_error", err: String(err) }));
-    }
+    const hb = opts.heartbeat;
+    this.hb = {
+      pingEvent: hb.pingEvent ?? "sys:ping",
+      pongEvent: hb.pongEvent ?? "sys:pong",
+      intervalMs: hb.intervalMs ?? 15e3,
+      timeoutMs: hb.timeoutMs ?? 7500,
+      pingSchema: hb.pingSchema,
+      makePingPayload: hb.makePingPayload,
+      pongSchema: hb.pongSchema,
+      onPong: hb.onPong
+    };
+    const dbg = (key, e) => {
+      const d = this.debug;
+      if (!d.logger) return;
+      if (!d[e.type]) return;
+      if (d.only && "event" in e && typeof e.event === "string" && !d.only.includes(e.event)) return;
+      d.logger(e);
+    };
+    this.socket.on("connect", () => {
+      dbg("connect", { type: "connect", id: this.socket.id ?? "" });
+      this.startHeartbeat(dbg);
+    });
+    this.socket.on("reconnect", (attempt) => dbg("reconnect", { type: "reconnect", attempt }));
+    this.socket.on("disconnect", (reason) => {
+      dbg("disconnect", { type: "disconnect", reason: String(reason) });
+      this.stopHeartbeat();
+    });
+    this.socket.on("connect_error", (err) => dbg("connect_error", { type: "connect_error", err: String(err) }));
+    this.socket.on(this.hb.pongEvent, (raw) => {
+      const receivedAt = Date.now();
+      const serverNowIso = raw?.serverNow;
+      const clientSentIso = raw?.clientEcho?.__clientSentAt;
+      let latencyMs;
+      if (clientSentIso) {
+        const sent = Date.parse(clientSentIso);
+        if (!Number.isNaN(sent)) latencyMs = Math.max(0, receivedAt - sent);
+      }
+      if (this.hb.pongSchema) {
+        const ok = this.hb.pongSchema.safeParse(raw);
+        if (!ok.success) return;
+      }
+      if (this.debug.logger && this.debug.pong_recv) {
+        this.debug.logger({ type: "pong_recv", latencyMs: latencyMs ?? raw?.sinceMs ?? 0, payload: raw });
+      }
+      this.hb.onPong?.({ latencyMs: latencyMs ?? raw?.sinceMs ?? 0, payload: raw, socket: this.socket });
+    });
   }
-  /** [6] internal stats snapshot */
+  /** internal stats snapshot */
   stats() {
     const rooms = Array.from(this.roomCounts.entries()).map(([room, count]) => ({ room, count }));
     const handlers = Array.from(this.handlerMap.entries()).map(([event, set]) => ({
@@ -468,23 +504,58 @@ var SocketClient = class {
       handlers
     };
   }
-  maybeLog(flag, obj) {
-    if (!this.debug.enabled) return;
-    if (!this.debug.flags?.[flag]) return;
-    (this.debug.logger ?? console.debug)(["[socket-client]"], obj);
+  toArray(rooms) {
+    return rooms == null ? [] : Array.isArray(rooms) ? rooms : [rooms];
+  }
+  /** === NEW: heartbeat control === */
+  startHeartbeat(dbg) {
+    this.stopHeartbeat();
+    const tick = () => {
+      const basePayload = this.hb.makePingPayload({ socket: this.socket }) ?? {};
+      const candidate = { ...basePayload, __clientSentAt: (/* @__PURE__ */ new Date()).toISOString() };
+      const check = this.hb.pingSchema.safeParse(candidate);
+      if (!check.success) {
+        if (this.environment === "development") console.warn("[socket] ping schema validation failed", check.error.issues);
+        return;
+      }
+      const timer = setTimeout(() => {
+      }, this.hb.timeoutMs);
+      this.socket.timeout(this.hb.timeoutMs).emit(this.hb.pingEvent, { payload: check.data }, () => {
+        clearTimeout(timer);
+      });
+      if (this.debug.logger && this.debug.ping_emit) {
+        dbg("ping_emit", { type: "ping_emit", payload: check.data });
+      }
+    };
+    this.hbTimer = setInterval(tick, this.hb.intervalMs);
+    tick();
+  }
+  stopHeartbeat() {
+    if (this.hbTimer) {
+      clearInterval(this.hbTimer);
+      this.hbTimer = null;
+    }
   }
-  emit(event, payload, metadata) {
+  emit(event, payload, metadata, onAck, timeoutMs) {
     const schema = this.events[event].message;
     const parsed = schema.safeParse(payload);
-    if (!parsed.success) {
-      throw new Error(`Invalid payload for "${event}": ${parsed.error.message}`);
+    if (!parsed.success) throw new Error(`Invalid payload for "${event}": ${parsed.error.message}`);
+    if (onAck) {
+      this.socket.timeout(timeoutMs ?? this.hb.timeoutMs).emit(String(event), parsed.data, (ack) => {
+        try {
+          onAck(ack);
+        } catch {
+        }
+      });
+    } else {
+      this.socket.emit(String(event), parsed.data);
+    }
+    if (this.debug.logger && this.debug.emit) {
+      this.debug.logger({ type: "emit", event, metadata: this.debug.verbose ? metadata : void 0 });
     }
-    this.socket.emit(String(event), parsed.data);
-    this.maybeLog("emit", { type: "emit", event, metadata: this.debug.verbose ? metadata : void 0 });
   }
-  /** [6] refcount join. Only emits when transitioning 0->1 */
   joinRooms(rooms) {
-    const list = rooms == null ? [] : Array.isArray(rooms) ? rooms : [rooms];
+    const list = this.toArray(rooms);
     const toJoin = [];
     for (const r of list) {
       const next = (this.roomCounts.get(r) ?? 0) + 1;
@@ -493,13 +564,13 @@ var SocketClient = class {
     }
     if (toJoin.length > 0) {
       this.socket.emit(this.roomJoinEvent, { rooms: toJoin });
-      this.maybeLog("join", { type: "join", rooms: toJoin, stats: this.debug.verbose ? this.stats() : void 0 });
-      this.maybeLog("stats", { type: "stats", ...this.stats() });
+      if (this.debug.logger && this.debug.join) {
+        this.debug.logger({ type: "join", rooms: toJoin, stats: this.debug.stats || this.debug.verbose ? this.stats() : void 0 });
+      }
     }
   }
-  /** [6] refcount leave. Only emits when transitioning 1->0 */
   leaveRooms(rooms) {
-    const list = rooms == null ? [] : Array.isArray(rooms) ? rooms : [rooms];
+    const list = this.toArray(rooms);
     const toLeave = [];
     for (const r of list) {
       const curr = this.roomCounts.get(r) ?? 0;
@@ -510,13 +581,17 @@ var SocketClient = class {
     }
     if (toLeave.length > 0) {
       this.socket.emit(this.roomLeaveEvent, { rooms: toLeave });
-      this.maybeLog("leave", { type: "leave", rooms: toLeave, stats: this.debug.verbose ? this.stats() : void 0 });
-      this.maybeLog("stats", { type: "stats", ...this.stats() });
+      if (this.debug.logger && this.debug.leave) {
+        this.debug.logger({ type: "leave", rooms: toLeave, stats: this.debug.stats || this.debug.verbose ? this.stats() : void 0 });
+      }
     }
   }
   on(event, handler) {
     const schema = this.events[event].message;
-    const wrapped = (envelopeOrRaw) => {
+    if (this.debug.logger && this.debug.register) {
+      this.debug.logger({ type: "register", event });
+    }
+    const wrapped = (envelopeOrRaw, maybeAck) => {
       const maybeEnvelope = envelopeOrRaw;
       const rawData = maybeEnvelope?.data ?? maybeEnvelope;
       const parsed = schema.safeParse(rawData);
@@ -529,23 +604,28 @@ var SocketClient = class {
           sentAt: maybeEnvelope?.sentAt ?? receivedAt.toISOString(),
           sentTo: maybeEnvelope?.sentTo ?? [],
           data: void 0,
-          // avoid echoing body to handler meta
           metadata: maybeEnvelope?.metadata
-          // [3]
         },
         ctx: {
           receivedAt,
           latencyMs: sentAt ? Math.max(0, receivedAt.getTime() - sentAt.getTime()) : void 0,
           nsp: this.socket.nsp,
           socketId: this.socket.id,
-          socket: this.socket
+          socket: this.socket,
+          reply: typeof maybeAck === "function" ? (d) => {
+            try {
+              maybeAck(d);
+            } catch {
+            }
+          } : void 0
+          // NEW
         }
       };
-      if (this.debug.enabled && this.debug.flags?.receive) {
-        (this.debug.logger ?? console.debug)(["[socket-client]"], {
+      if (this.debug.logger && this.debug.receive) {
+        this.debug.logger({
           type: "receive",
           event,
-          verbose: this.debug.verbose ? { envelope: meta.envelope } : void 0
+          envelope: this.debug.verbose ? { eventName: meta.envelope.eventName, sentAt: meta.envelope.sentAt, sentTo: meta.envelope.sentTo, metadata: meta.envelope.metadata } : void 0
         });
       }
       handler(parsed.data, meta);
@@ -564,7 +644,6 @@ var SocketClient = class {
     }
     const entry = { orig: handler, wrapped, errorWrapped };
     set.add(entry);
-    this.maybeLog("stats", { type: "stats", ...this.stats() });
     return () => {
       this.socket.off(String(event), wrapped);
       this.socket.off(`${String(event)}:error`, errorWrapped);
@@ -573,34 +652,18 @@ var SocketClient = class {
         s.delete(entry);
         if (s.size === 0) this.handlerMap.delete(String(event));
       }
-      this.maybeLog("stats", { type: "stats", ...this.stats() });
-    };
-  }
-  /** [4] precise off: remove specific handler if provided, else all for event */
-  off(event, handler) {
-    const set = this.handlerMap.get(String(event));
-    if (!set || set.size === 0) return;
-    if (!handler) {
-      for (const entry of set) {
-        this.socket.off(String(event), entry.wrapped);
-        this.socket.off(`${String(event)}:error`, entry.errorWrapped);
-      }
-      this.handlerMap.delete(String(event));
-    } else {
-      for (const entry of Array.from(set)) {
-        if (entry.orig === handler) {
-          this.socket.off(String(event), entry.wrapped);
-          this.socket.off(`${String(event)}:error`, entry.errorWrapped);
-          set.delete(entry);
-        }
+      if (this.debug.logger && this.debug.unregister) {
+        this.debug.logger({ type: "unregister", event });
       }
-      if (set.size === 0) this.handlerMap.delete(String(event));
-    }
-    this.maybeLog("stats", { type: "stats", ...this.stats() });
+    };
   }
   disconnect() {
+    this.stopHeartbeat();
     this.socket.disconnect();
   }
+  connect() {
+    this.socket.connect();
+  }
 };
 export {
   SocketClient,

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/routesV3.client.fetch.ts","../src/routesV3.client.index.ts","../src/sockets/socket.client.index.ts"],"sourcesContent":["// routesV3.client.fetch.ts\n\nimport { Fetcher, FetchInput } from './routesV3.client.types';\n\n/**\n * Default fetch implementation used by the route client helper.\n * @param req Normalized request information (URL, method, body, headers).\n * @returns Parsed JSON (or text fallback) from the server response.\n */\nexport const defaultFetcher: Fetcher = async <T>(req: FetchInput): Promise<T> => {\n  const headers: Record<string, string> = { ...(req.headers ?? {}) };\n  const isFormData = typeof FormData !== 'undefined' && req.body instanceof FormData;\n  if (!isFormData) {\n    headers['Content-Type'] ||= 'application/json';\n    headers['Accept'] ||= 'application/json';\n  }\n\n  const res = await fetch(req.url, {\n    method: req.method,\n    headers,\n    body: isFormData ? (req.body as any) : req.body == null ? undefined : JSON.stringify(req.body),\n  });\n\n  const text = await res.text();\n  if (!res.ok) {\n    const snippet = text.slice(0, 400);\n    throw new Error(`[${res.status}] ${res.statusText} — ${snippet}`);\n  }\n\n  try {\n    return JSON.parse(text) as T;\n  } catch {\n    return text as unknown as T;\n  }\n};\n","// routesV3.client.ts\nimport {\n  keepPreviousData,\n  useInfiniteQuery,\n  useMutation,\n  useQuery,\n  type InfiniteData,\n  type QueryKey,\n} from '@tanstack/react-query';\nimport type { ZodType } from 'zod';\nimport {\n  HttpMethod,\n  buildCacheKey,\n  compilePath,\n} from '@emeryld/rrroutes-contract';\nimport type {\n  AnyLeaf,\n  InferBody,\n  InferOutput,\n  InferParams,\n  InferQuery,\n} from '@emeryld/rrroutes-contract';\nimport { defaultFetcher } from './routesV3.client.fetch';\nimport type {\n  ArgsFor,\n  ArgsTuple,\n  BuildMeta,\n  BuiltForLeaf,\n  BuiltInfinite,\n  BuiltMutation,\n  BuiltQuery,\n  Cursor,\n  DataShape,\n  InfiniteBuildOptionsFor,\n  MutationBuildOptionsFor,\n  QueryBuildOptionsFor,\n  RouteClient,\n  RouteClientOptions,\n  RouteClientDebugEvent,\n  RouteClientDebugLogger,\n  RouteClientDebugMode,\n  RouteClientDebugOptions,\n  RouteClientDebugToggleOptions,\n  Updater,\n} from './routesV3.client.types';\n\n// -------------------------------------------------------------------------------------\n// Tiny helpers\n// -------------------------------------------------------------------------------------\n/**\n * Convert an HTTP method to uppercase (as expected by fetch).\n * @param m Lowercase HTTP method.\n * @returns Uppercase method string.\n */\nconst toUpper = (m: HttpMethod): Uppercase<HttpMethod> => m.toUpperCase() as Uppercase<HttpMethod>;\n\n/**\n * Parse the given value with the supplied schema (if present).\n * @param value Raw value to validate.\n * @param schema Optional Zod schema used for validation/coercion.\n * @returns The validated or original value.\n */\nfunction zParse<T>(value: unknown, schema?: ZodType): T {\n  return schema ? (schema.parse(value) as T) : (value as T);\n}\n\n/**\n * Serialize a query object into a search string.\n * @param query Query params object (possibly undefined).\n * @returns Query string prefixed with `?`, or empty string.\n */\nfunction toSearchString(query: Record<string, unknown> | undefined) {\n  if (!query) return '';\n  const params = new URLSearchParams();\n  for (const [k, v] of Object.entries(query)) {\n    if (v == null) continue;\n    if (Array.isArray(v)) {\n      v.forEach((x) => {\n        if (x == null) return;\n        if (typeof x === 'object') {\n          params.append(k, JSON.stringify(x));\n        } else {\n          params.append(k, String(x));\n        }\n      });\n      continue;\n    }\n    if (typeof v === 'object') {\n      params.set(k, JSON.stringify(v));\n      continue;\n    }\n    params.set(k, String(v));\n  }\n  const s = params.toString();\n  return s ? `?${s}` : '';\n}\n\n/**\n * Remove the given key from an object (used to drop cursors from cache keys).\n * @param obj Source object.\n * @param key Property name to omit.\n * @returns Copy of the object without the specified key.\n */\nfunction stripKey<Q extends Record<string, unknown> | undefined>(obj: Q, key: string): Q {\n  if (!obj) return obj;\n  const { [key]: _omit, ...rest } = obj as any;\n  return rest as Q;\n}\n\n/**\n * Default cursor extractor used by infinite queries.\n * @param p Page result returned from the server.\n * @returns Next cursor string, if present.\n */\nconst defaultGetNextCursor = (p: unknown): Cursor =>\n  p && typeof p === 'object' && 'nextCursor' in p ? (p as any).nextCursor : undefined;\n\n// Debug logging --------------------------------------------------------------\nconst noopDebugLogger: RouteClientDebugLogger = () => {};\n\nconst defaultDebugLogger: RouteClientDebugLogger = (event: RouteClientDebugEvent) => {\n  if (typeof console === 'undefined') return;\n  const fn = console.debug ?? console.log;\n  fn?.call(console, '[rrroutes-client]', event);\n};\n\nconst debugEventTypes: RouteClientDebugEvent['type'][] = [\n  'fetch',\n  'invalidate',\n  'setData',\n  'build',\n  'useEndpoint',\n];\n\ntype DebugEmitter<Names extends string> = {\n  emit: (event: RouteClientDebugEvent, name?: Names) => void;\n  mode: RouteClientDebugMode;\n};\n\nconst noopEmit = () => {};\n\nfunction createDebugEmitter<Names extends string>(\n  option?: RouteClientDebugOptions<Names>,\n  environment?: string,\n): DebugEmitter<Names> {\n  const disabled: DebugEmitter<Names> = { emit: noopEmit, mode: 'minimal' };\n\n  if (environment && environment.toLowerCase() === 'production') {\n    return disabled;\n  }\n\n  if (!option) {\n    return disabled;\n  }\n  if (option === true || option === 'minimal') {\n    return {\n      emit: (event, name) => defaultDebugLogger(name ? { ...event, name } : event),\n      mode: 'minimal',\n    };\n  }\n  if (option === 'complete') {\n    return {\n      emit: (event, name) => defaultDebugLogger(name ? { ...event, name } : event),\n      mode: 'complete',\n    };\n  }\n  if (typeof option === 'function') {\n    return {\n      emit: (event, name) => option(name ? { ...event, name } : event),\n      mode: 'minimal',\n    };\n  }\n  if (typeof option === 'object') {\n    const toggles = option as RouteClientDebugToggleOptions<Names>;\n    const verbose = Boolean(toggles.verbose);\n    const enabledTypes = debugEventTypes.filter((type) => toggles[type]);\n    if (enabledTypes.length === 0) {\n      return { emit: noopEmit, mode: verbose ? 'complete' : 'minimal' };\n    }\n    const whitelist = new Set<RouteClientDebugEvent['type']>(enabledTypes);\n    const onlySet =\n      toggles.only && toggles.only.length > 0 ? new Set<Names>(toggles.only) : undefined;\n    const logger = toggles.logger ?? defaultDebugLogger;\n    const emit: DebugEmitter<Names>['emit'] = (event, name) => {\n      if (!whitelist.has(event.type)) return;\n      if (onlySet) {\n        if (!name || !onlySet.has(name)) return;\n      }\n      logger(name ? { ...event, name } : event);\n    };\n    return { emit, mode: verbose ? 'complete' : 'minimal' };\n  }\n\n  return disabled;\n}\n\n// Split the variadic tuple at runtime\n/**\n * Extract the optional argument object from a variadic tuple.\n * @param args Tuple passed to a built endpoint helper.\n * @returns The argument object if present.\n */\nfunction extractArgs<L extends AnyLeaf>(args: ArgsTuple<L>): ArgsFor<L> | undefined {\n  // At runtime ArgsTuple<L> is either [] or [obj]; we just pick the first if present.\n  return (args as unknown as any[])[0] as any;\n}\n\n/**\n * Normalize params and query values, then construct a request URL for the given leaf.\n * @param leaf Leaf describing the endpoint.\n * @param baseUrl Optional base URL prepended to the path.\n * @param params Route parameters supplied by the caller.\n * @param query Query parameters supplied by the caller.\n * @returns Object containing the composed URL plus normalized params/query payloads.\n */\nfunction buildUrl<L extends AnyLeaf>(\n  leaf: L,\n  baseUrl: string,\n  params: InferParams<L> | undefined,\n  query: InferQuery<L> | undefined,\n) {\n  const normalizedParams = zParse<InferParams<L>>(params, leaf.cfg.paramsSchema);\n  const normalizedQuery = zParse<InferQuery<L>>(query, leaf.cfg.querySchema);\n  const path = compilePath<L['path']>(leaf.path, (normalizedParams ?? {}) as any);\n  const url = `${baseUrl ?? ''}${path}${toSearchString(normalizedQuery as any)}`;\n  return { url, normalizedQuery, normalizedParams };\n}\n\n// -------------------------------------------------------------------------------------\n// Client factory\n// -------------------------------------------------------------------------------------\n/**\n * Construct typed React Query helpers backed by a routes-v3 registry leaf.\n * @param opts Route client configuration (query client, fetcher overrides, etc).\n * @returns Object that can build endpoint hooks/mutations from leaves.\n */\nexport function createRouteClient<Names extends string = string>(\n  opts: RouteClientOptions<Names>,\n): RouteClient<Names> {\n  const queryClient = opts.queryClient;\n  const fetcher = opts.fetcher ?? defaultFetcher;\n  const baseUrl = opts.baseUrl;\n  const cursorParam = opts.cursorParam ?? 'cursor';\n  const getNextCursor = opts.getNextCursor ?? defaultGetNextCursor;\n  const environment =\n    opts.environment ?? undefined;\n  const { emit: emitDebug, mode: debugMode } = createDebugEmitter<Names>(opts.debug, environment);\n  const isVerboseDebug = debugMode === 'complete';\n  const decorateDebugEvent = <T extends RouteClientDebugEvent>(\n    event: T,\n    details?: Partial<RouteClientDebugEvent>,\n  ): RouteClientDebugEvent => {\n    if (!isVerboseDebug || !details) return event;\n    return { ...event, ...details } as RouteClientDebugEvent;\n  };\n\n  /**\n   * Invalidate a set of queries sharing the given prefix.\n   * @param prefix Key parts shared by matching endpoints.\n   * @param exact When true, invalidate only exact key matches.\n   */\n  async function invalidate(prefix: string[], exact = false) {\n    const queryKey = prefix as unknown as QueryKey;\n    await queryClient.invalidateQueries({ queryKey, exact });\n    emitDebug({ type: 'invalidate', key: queryKey, exact });\n  }\n\n  /**\n   * Build the client surface for a single leaf (query/mutation/infinite query).\n   * @param leaf Leaf describing the endpoint.\n   * @param rqOpts Optional React Query configuration.\n   * @returns Helper object exposing key/invalidate/setData/useEndpoint.\n   */\n  function buildInternal<L extends AnyLeaf>(\n    leaf: L,\n    rqOpts?: QueryBuildOptionsFor<L> | InfiniteBuildOptionsFor<L> | MutationBuildOptionsFor<L>,\n    meta?: BuildMeta<Names>,\n  ): BuiltForLeaf<L> {\n    const isGet = leaf.method === 'get';\n    const isFeed = !!leaf.cfg.feed;\n    const method = toUpper(leaf.method);\n    const leafLabel = `${leaf.method.toUpperCase()} ${String(leaf.path)}`;\n    const debugName = meta?.name;\n    const emit = (event: RouteClientDebugEvent) => emitDebug(event, debugName);\n    emit({ type: 'build', leaf: leafLabel });\n\n    // --- key/invalidate/setData shared helpers ---\n    const key = (...tuple: ArgsTuple<L>): QueryKey => {\n      const a = extractArgs<L>(tuple);\n      const params = (a as any)?.params as InferParams<L> | undefined;\n      const query = (a as any)?.query as InferQuery<L> | undefined;\n      const qForKey = isGet && isFeed ? stripKey(query as any, cursorParam) : (query as any);\n      return buildCacheKey({ leaf, params: params as any, query: qForKey }) as unknown as QueryKey;\n    };\n\n    /**\n     * Invalidate the React Query cache for this exact leaf invocation.\n     * @param tuple Optional params/query tuple.\n     */\n    const invalidateExact = async (...tuple: ArgsTuple<L>) => {\n      const queryKey = key(...tuple);\n      await queryClient.invalidateQueries({ queryKey, exact: true });\n      emit({ type: 'invalidate', key: queryKey, exact: true });\n    };\n\n    /**\n     * Update the cache entries for this leaf.\n     * @param args Tuple whose first entry is the updater and optional params/query follow.\n     */\n    const setData = (...args: [Updater<DataShape<L>>, ...rest: ArgsTuple<L>]) => {\n      const [updater, ...rest] = args;\n      const k = key(...(rest as ArgsTuple<L>));\n      if (isGet && isFeed) {\n        queryClient.setQueryData<InfiniteData<InferOutput<L>> | undefined>(k, (prev) =>\n          typeof updater === 'function' ? (updater as any)(prev) : (updater as any),\n        );\n      } else {\n        queryClient.setQueryData<InferOutput<L> | undefined>(k, (prev) =>\n          typeof updater === 'function' ? (updater as any)(prev) : (updater as any),\n        );\n      }\n      emit({ type: 'setData', key: k });\n    };\n\n    // --- Infinite GET ---\n    if (isGet && isFeed) {\n      const useEndpoint: BuiltInfinite<L>['useEndpoint'] = (...tuple) => {\n        emit({ type: 'useEndpoint', leaf: leafLabel, variant: 'infiniteGet' });\n        const a = extractArgs<L>(tuple);\n        const params = (a as any)?.params as InferParams<L> | undefined;\n        const query = (a as any)?.query as InferQuery<L> | undefined;\n\n        // Normalize once; we’ll inject the cursor per page below.\n        const { normalizedQuery, normalizedParams } = buildUrl(leaf, baseUrl, params, query);\n        return useInfiniteQuery<\n          InferOutput<L>, // TQueryFnData (per page)\n          unknown, // TError\n          InfiniteData<InferOutput<L>>, // TData (returned by the hook)\n          QueryKey,\n          Cursor\n        >({\n          ...(rqOpts as InfiniteBuildOptionsFor<L>),\n          queryKey: key(...tuple),\n          initialPageParam: undefined,\n          getNextPageParam: (lastPage) => getNextCursor(lastPage),\n          placeholderData: keepPreviousData,\n          queryFn: async ({ pageParam }) => {\n            const pageQuery = {\n              ...(normalizedQuery as any),\n              ...(pageParam ? { [cursorParam]: pageParam } : {}),\n            };\n            const { url } = buildUrl(leaf, baseUrl, params, pageQuery);\n            const startedAt = Date.now();\n            const detail = isVerboseDebug ? { params: normalizedParams, query: pageQuery } : undefined;\n            emit(\n              decorateDebugEvent(\n                { type: 'fetch', stage: 'start', method, url, leaf: leafLabel },\n                detail,\n              ),\n            );\n            try {\n              const out = await fetcher<unknown>({ url, method });\n              const parsed = zParse<InferOutput<L>>(out, leaf.cfg.outputSchema);\n              emit(\n                decorateDebugEvent(\n                  {\n                    type: 'fetch',\n                    stage: 'success',\n                    method,\n                    url,\n                    leaf: leafLabel,\n                    durationMs: Date.now() - startedAt,\n                  },\n                  isVerboseDebug ? { params: normalizedParams, query: pageQuery, output: parsed } : undefined,\n                ),\n              );\n              return parsed;\n            } catch (error) {\n              emit(\n                decorateDebugEvent(\n                  {\n                    type: 'fetch',\n                    stage: 'error',\n                    method,\n                    url,\n                    leaf: leafLabel,\n                    durationMs: Date.now() - startedAt,\n                    error,\n                  },\n                  detail,\n                ),\n              );\n              throw error;\n            }\n          },\n          // NOTE: TData is InfiniteData<T>, so we don't need a select here.\n        }, queryClient);\n      };\n\n      return {\n        key,\n        invalidate: invalidateExact,\n        setData: setData as any,\n        useEndpoint,\n      } as BuiltForLeaf<L>;\n    }\n    // --- Plain GET ---\n    if (isGet) {\n      const useEndpoint: BuiltQuery<L>['useEndpoint'] = (...tuple) => {\n        emit({ type: 'useEndpoint', leaf: leafLabel, variant: 'get' });\n        const a = extractArgs<L>(tuple);\n        const params = (a as any)?.params as InferParams<L> | undefined;\n        const query = (a as any)?.query as InferQuery<L> | undefined;\n\n        const { url, normalizedQuery, normalizedParams } = buildUrl(leaf, baseUrl, params, query);\n        return useQuery<InferOutput<L>, unknown, InferOutput<L>, QueryKey>({\n          ...(rqOpts as QueryBuildOptionsFor<L>),\n          queryKey: key(...tuple),\n          placeholderData: keepPreviousData,\n          queryFn: async () => {\n            const startedAt = Date.now();\n            const detail = isVerboseDebug\n              ? { params: normalizedParams, query: normalizedQuery }\n              : undefined;\n            emit(\n              decorateDebugEvent(\n                { type: 'fetch', stage: 'start', method, url, leaf: leafLabel },\n                detail,\n              ),\n            );\n            try {\n              const out = await fetcher<unknown>({ url, method });\n              const parsed = zParse<InferOutput<L>>(out, leaf.cfg.outputSchema);\n              emit(\n                decorateDebugEvent(\n                  {\n                    type: 'fetch',\n                    stage: 'success',\n                    method,\n                    url,\n                    leaf: leafLabel,\n                    durationMs: Date.now() - startedAt,\n                  },\n                  isVerboseDebug\n                    ? { params: normalizedParams, query: normalizedQuery, output: parsed }\n                    : undefined,\n                ),\n              );\n              return parsed;\n            } catch (error) {\n              emit(\n                decorateDebugEvent(\n                  {\n                    type: 'fetch',\n                    stage: 'error',\n                    method,\n                    url,\n                    leaf: leafLabel,\n                    durationMs: Date.now() - startedAt,\n                    error,\n                  },\n                  detail,\n                ),\n              );\n              throw error;\n            }\n          },\n        }, queryClient);\n      };\n\n      return {\n        key,\n        invalidate: invalidateExact,\n        setData: setData as any,\n        useEndpoint,\n      } as BuiltForLeaf<L>;\n    }\n\n    // --- Mutation (POST/PUT/PATCH/DELETE) ---\n    const fetchEndpoint: BuiltMutation<L>['fetch'] = async (\n      ...tupleWithBody: [...ArgsTuple<L>, InferBody<L>]\n    ) => {\n      if (tupleWithBody.length === 0) {\n        throw new Error('Body is required when invoking a mutation fetch.');\n      }\n      const bodyIndex = tupleWithBody.length - 1;\n      const tuple = tupleWithBody.slice(0, bodyIndex) as ArgsTuple<L>;\n      const body = tupleWithBody[bodyIndex] as InferBody<L>;\n      const args = extractArgs<L>(tuple);\n      const params = (args as any)?.params as InferParams<L> | undefined;\n      const query = (args as any)?.query as InferQuery<L> | undefined;\n\n      const { url, normalizedQuery, normalizedParams } = buildUrl(leaf, baseUrl, params, query);\n      const normalizedBody = zParse<InferBody<L>>(body, leaf.cfg.bodySchema);\n\n      // Optional: switch to FormData if your method declares bodyFiles\n      const isMultipart = Array.isArray(leaf.cfg.bodyFiles) && leaf.cfg.bodyFiles.length > 0;\n      const payload = isMultipart ? toFormData(normalizedBody as any) : normalizedBody;\n\n      const startedAt = Date.now();\n      const detail = isVerboseDebug\n        ? { params: normalizedParams, query: normalizedQuery }\n        : undefined;\n      emit(\n        decorateDebugEvent(\n          {\n            type: 'fetch',\n            stage: 'start',\n            method,\n            url,\n            leaf: leafLabel,\n            body: payload,\n          },\n          detail,\n        ),\n      );\n      try {\n        const out = await fetcher<unknown>({ url, method, body: payload });\n        const parsed = zParse<InferOutput<L>>(out, leaf.cfg.outputSchema);\n        emit(\n          decorateDebugEvent(\n            {\n              type: 'fetch',\n              stage: 'success',\n              method,\n              url,\n              leaf: leafLabel,\n              durationMs: Date.now() - startedAt,\n            },\n            isVerboseDebug\n              ? { params: normalizedParams, query: normalizedQuery, output: parsed }\n              : undefined,\n          ),\n        );\n        return parsed;\n      } catch (error) {\n        emit(\n          decorateDebugEvent(\n            {\n              type: 'fetch',\n              stage: 'error',\n              method,\n              url,\n              leaf: leafLabel,\n              durationMs: Date.now() - startedAt,\n              body: payload,\n              error,\n            },\n            detail,\n          ),\n        );\n        throw error;\n      }\n    };\n\n    const useEndpoint: BuiltMutation<L>['useEndpoint'] = (...tuple) => {\n      emit({ type: 'useEndpoint', leaf: leafLabel, variant: 'mutation' });\n      return useMutation<InferOutput<L>, unknown, InferBody<L>, unknown>({\n        ...(rqOpts as MutationBuildOptionsFor<L>),\n        mutationKey: key(...tuple),\n        mutationFn: (body: InferBody<L>) =>\n          fetchEndpoint(...([...tuple, body] as [...ArgsTuple<L>, InferBody<L>])),\n      }, queryClient);\n    };\n\n    return {\n      key,\n      invalidate: invalidateExact,\n      setData: setData as any,\n      useEndpoint,\n      fetch: fetchEndpoint,\n    } as BuiltForLeaf<L>;\n  }\n\n  return {\n    queryClient,\n    invalidate,\n    build: buildInternal as RouteClient<Names>['build'],\n  };\n}\n\n// -------------------------------------------------------------------------------------\n// Multipart helper\n// -------------------------------------------------------------------------------------\nfunction toFormData(body: Record<string, any>): FormData {\n  const fd = new FormData();\n  for (const [k, v] of Object.entries(body ?? {})) {\n    if (v == null) continue;\n    if (Array.isArray(v)) v.forEach((item, i) => fd.append(`${k}[${i}]`, item as any));\n    else fd.append(k, v as any);\n  }\n  return fd;\n}\n","import { io, Socket } from 'socket.io-client';\nimport { z } from 'zod';\nimport type { SocketEvent } from '@emeryld/rrroutes-contract';\n\nexport type EventMap = Record<string, SocketEvent>;\nexport type Payload<T extends EventMap, K extends keyof T> = z.infer<T[K]['message']>;\n\nexport type ServerEnvelope<T extends EventMap, K extends keyof T & string> = {\n  eventName: K;\n  sentAt: string | Date;\n  sentTo: string[];\n  data?: Payload<T, K>;\n  metadata?: Record<string, unknown>; // [3]\n};\n\nexport type ClientCtx = {\n  receivedAt: Date;\n  latencyMs?: number;\n  nsp?: string;\n  socketId?: string;\n  rooms?: string[];\n  socket?: Socket; // optional exposure if needed by consumers\n};\n\nexport type ClientDebugFlags = {\n  connect?: boolean;\n  disconnect?: boolean;\n  join?: boolean;\n  leave?: boolean;\n  receive?: boolean;\n  emit?: boolean;\n  stats?: boolean;\n};\n\nexport type SocketClientDebug = {\n  enabled?: boolean;\n  verbose?: boolean;\n  logger?: (e: any) => void;\n  flags?: ClientDebugFlags;\n};\n\nexport type SocketClientOptions = {\n  url: string;\n  ioOptions?: Parameters<typeof io>[1];\n  roomJoinEvent?: string;\n  roomLeaveEvent?: string;\n  environment?: 'development' | 'production';\n  /** [5] client-side debug logger */\n  debug?: SocketClientDebug;\n};\n\ntype HandlerEntry<T extends EventMap, K extends keyof T & string> = {\n  orig: (payload: Payload<T, K>, meta: { envelope: ServerEnvelope<T, K>; ctx: ClientCtx }) => void;\n  wrapped: (envelopeOrRaw: ServerEnvelope<T, K> | Payload<T, K>) => void;\n  errorWrapped: (e: unknown) => void;\n};\n\nexport class SocketClient<T extends EventMap> {\n  readonly socket: Socket;\n  private readonly events: T;\n  private readonly roomJoinEvent: string;\n  private readonly roomLeaveEvent: string;\n  private readonly environment: 'development' | 'production';\n  private readonly debug: SocketClientDebug;\n\n  // [6] stats\n  private readonly roomCounts = new Map<string, number>(); // room -> refcount\n  private readonly handlerMap = new Map<string, Set<HandlerEntry<T, any>>>(); // event -> handlers\n\n  constructor(events: T, opts: SocketClientOptions) {\n    this.events = events;\n    this.socket = io(opts.url, { autoConnect: true, ...opts.ioOptions });\n    this.roomJoinEvent = opts.roomJoinEvent ?? 'room:join';\n    this.roomLeaveEvent = opts.roomLeaveEvent ?? 'room:leave';\n    this.environment = opts.environment ?? 'development';\n    this.debug = opts.debug ?? {};\n\n    const dlog = (e: any) => (this.debug.logger ?? console.debug)(['[socket-client]'], e);\n    if (this.debug.enabled && this.debug.flags?.connect) {\n      this.socket.on('connect', () => dlog({ type: 'connect', id: this.socket.id }));\n      this.socket.on('reconnect', (attempt) => dlog({ type: 'reconnect', attempt }));\n    }\n    if (this.debug.enabled && this.debug.flags?.disconnect) {\n      this.socket.on('disconnect', (reason) => dlog({ type: 'disconnect', reason }));\n      this.socket.on('connect_error', (err) => dlog({ type: 'connect_error', err: String(err) }));\n    }\n  }\n\n  /** [6] internal stats snapshot */\n  stats() {\n    const rooms = Array.from(this.roomCounts.entries()).map(([room, count]) => ({ room, count }));\n    const handlers = Array.from(this.handlerMap.entries()).map(([event, set]) => ({\n      event,\n      handlers: set.size,\n    }));\n    return {\n      roomsCount: rooms.length,\n      totalHandlers: handlers.reduce((a, b) => a + b.handlers, 0),\n      rooms,\n      handlers,\n    };\n  }\n\n  private maybeLog(flag: keyof ClientDebugFlags, obj: any) {\n    if (!this.debug.enabled) return;\n    if (!this.debug.flags?.[flag]) return;\n    (this.debug.logger ?? console.debug)(['[socket-client]'], obj);\n  }\n\n  emit<K extends keyof T & string>(\n    event: K,\n    payload: Payload<T, K>,\n    /** [3] optional metadata forwarded to server and logger */\n    metadata?: Record<string, unknown>\n  ): void {\n    const schema = this.events[event].message;\n    const parsed = schema.safeParse(payload);\n    if (!parsed.success) {\n      throw new Error(`Invalid payload for \"${event}\": ${parsed.error.message}`);\n    }\n    // client emits raw payload for app events, plus optional metadata envelope if server expects it\n    // Keep wire format compatible with current server: server wraps on its side.\n    this.socket.emit(String(event), parsed.data);\n    this.maybeLog('emit', { type: 'emit', event, metadata: this.debug.verbose ? metadata : undefined });\n  }\n\n  /** [6] refcount join. Only emits when transitioning 0->1 */\n  joinRooms(rooms?: string[] | string): void {\n    const list = rooms == null ? [] : Array.isArray(rooms) ? rooms : [rooms];\n    const toJoin: string[] = [];\n    for (const r of list) {\n      const next = (this.roomCounts.get(r) ?? 0) + 1;\n      this.roomCounts.set(r, next);\n      if (next === 1) toJoin.push(r);\n    }\n    if (toJoin.length > 0) {\n      this.socket.emit(this.roomJoinEvent, { rooms: toJoin });\n      this.maybeLog('join', { type: 'join', rooms: toJoin, stats: this.debug.verbose ? this.stats() : undefined });\n      this.maybeLog('stats', { type: 'stats', ...this.stats() });\n    }\n  }\n\n  /** [6] refcount leave. Only emits when transitioning 1->0 */\n  leaveRooms(rooms?: string[] | string): void {\n    const list = rooms == null ? [] : Array.isArray(rooms) ? rooms : [rooms];\n    const toLeave: string[] = [];\n    for (const r of list) {\n      const curr = this.roomCounts.get(r) ?? 0;\n      const next = Math.max(0, curr - 1);\n      if (next === 0 && curr > 0) toLeave.push(r);\n      if (next === 0) this.roomCounts.delete(r);\n      else this.roomCounts.set(r, next);\n    }\n    if (toLeave.length > 0) {\n      this.socket.emit(this.roomLeaveEvent, { rooms: toLeave });\n      this.maybeLog('leave', { type: 'leave', rooms: toLeave, stats: this.debug.verbose ? this.stats() : undefined });\n      this.maybeLog('stats', { type: 'stats', ...this.stats() });\n    }\n  }\n\n  on<K extends keyof T & string>(\n    event: K,\n    handler: (payload: Payload<T, K>, meta: { envelope: ServerEnvelope<T, K>; ctx: ClientCtx }) => void,\n  ): () => void {\n    const schema = this.events[event].message;\n\n    const wrapped = (envelopeOrRaw: ServerEnvelope<T, K> | Payload<T, K>) => {\n      const maybeEnvelope = envelopeOrRaw as any;\n      const rawData = maybeEnvelope?.data ?? maybeEnvelope;\n\n      const parsed = schema.safeParse(rawData);\n      if (!parsed.success) return;\n\n      const receivedAt = new Date();\n      const sentAt = maybeEnvelope?.sentAt ? new Date(maybeEnvelope.sentAt) : undefined;\n      const meta = {\n        envelope: {\n          eventName: (maybeEnvelope?.eventName ?? event) as K,\n          sentAt: maybeEnvelope?.sentAt ?? receivedAt.toISOString(),\n          sentTo: maybeEnvelope?.sentTo ?? [],\n          data: undefined, // avoid echoing body to handler meta\n          metadata: maybeEnvelope?.metadata,     // [3]\n        },\n        ctx: {\n          receivedAt,\n          latencyMs: sentAt ? Math.max(0, receivedAt.getTime() - sentAt.getTime()) : undefined,\n          nsp: (this.socket as any).nsp,\n          socketId: this.socket.id,\n          socket: this.socket,\n        },\n      } as const;\n\n      if (this.debug.enabled && this.debug.flags?.receive) {\n        (this.debug.logger ?? console.debug)(['[socket-client]'], {\n          type: 'receive',\n          event,\n          verbose: this.debug.verbose ? { envelope: meta.envelope } : undefined,\n        });\n      }\n\n      handler(parsed.data as any, meta as any);\n    };\n\n    const errorWrapped = (e: unknown) => {\n      if (this.environment === 'development') {\n        // eslint-disable-next-line no-console\n        console.warn(`[socket] ${String(event)}:error`, e);\n      }\n    };\n\n    this.socket.on(String(event), wrapped);\n    this.socket.on(`${String(event)}:error`, errorWrapped);\n\n    // [6] track handlers for precise off\n    let set = this.handlerMap.get(String(event));\n    if (!set) {\n      set = new Set();\n      this.handlerMap.set(String(event), set);\n    }\n    const entry: HandlerEntry<T, K> = { orig: handler, wrapped, errorWrapped };\n    set.add(entry);\n    this.maybeLog('stats', { type: 'stats', ...this.stats() });\n\n    return () => {\n      this.socket.off(String(event), wrapped);\n      this.socket.off(`${String(event)}:error`, errorWrapped);\n      const s = this.handlerMap.get(String(event));\n      if (s) {\n        s.delete(entry);\n        if (s.size === 0) this.handlerMap.delete(String(event));\n      }\n      this.maybeLog('stats', { type: 'stats', ...this.stats() });\n    };\n  }\n\n  /** [4] precise off: remove specific handler if provided, else all for event */\n  off<K extends keyof T & string>(\n    event: K,\n    handler?: (payload: Payload<T, K>, meta: { envelope: ServerEnvelope<T, K>; ctx: ClientCtx }) => void\n  ): void {\n    const set = this.handlerMap.get(String(event));\n    if (!set || set.size === 0) return;\n\n    if (!handler) {\n      // remove all\n      for (const entry of set) {\n        this.socket.off(String(event), entry.wrapped);\n        this.socket.off(`${String(event)}:error`, entry.errorWrapped);\n      }\n      this.handlerMap.delete(String(event));\n    } else {\n      for (const entry of Array.from(set)) {\n        if (entry.orig === handler) {\n          this.socket.off(String(event), entry.wrapped);\n          this.socket.off(`${String(event)}:error`, entry.errorWrapped);\n          set.delete(entry);\n        }\n      }\n      if (set.size === 0) this.handlerMap.delete(String(event));\n    }\n    this.maybeLog('stats', { type: 'stats', ...this.stats() });\n  }\n\n  disconnect(): void {\n    this.socket.disconnect();\n  }\n}\n"],"mappings":"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","names":["useEndpoint"]}
+{"version":3,"sources":["../src/routesV3.client.fetch.ts","../src/routesV3.client.index.ts","../src/sockets/socket.client.index.ts"],"sourcesContent":["// routesV3.client.fetch.ts\n\nimport { Fetcher, FetchInput } from './routesV3.client.types';\n\n/**\n * Default fetch implementation used by the route client helper.\n * @param req Normalized request information (URL, method, body, headers).\n * @returns Parsed JSON (or text fallback) from the server response.\n */\nexport const defaultFetcher: Fetcher = async <T>(req: FetchInput): Promise<T> => {\n  const headers: Record<string, string> = { ...(req.headers ?? {}) };\n  const isFormData = typeof FormData !== 'undefined' && req.body instanceof FormData;\n  if (!isFormData) {\n    headers['Content-Type'] ||= 'application/json';\n    headers['Accept'] ||= 'application/json';\n  }\n\n  const res = await fetch(req.url, {\n    method: req.method,\n    headers,\n    body: isFormData ? (req.body as any) : req.body == null ? undefined : JSON.stringify(req.body),\n  });\n\n  const text = await res.text();\n  if (!res.ok) {\n    const snippet = text.slice(0, 400);\n    throw new Error(`[${res.status}] ${res.statusText} — ${snippet}`);\n  }\n\n  try {\n    return JSON.parse(text) as T;\n  } catch {\n    return text as unknown as T;\n  }\n};\n","// routesV3.client.ts\nimport {\n  keepPreviousData,\n  useInfiniteQuery,\n  useMutation,\n  useQuery,\n  type InfiniteData,\n  type QueryKey,\n} from '@tanstack/react-query';\nimport type { ZodType } from 'zod';\nimport {\n  HttpMethod,\n  buildCacheKey,\n  compilePath,\n} from '@emeryld/rrroutes-contract';\nimport type {\n  AnyLeaf,\n  InferBody,\n  InferOutput,\n  InferParams,\n  InferQuery,\n} from '@emeryld/rrroutes-contract';\nimport { defaultFetcher } from './routesV3.client.fetch';\nimport type {\n  ArgsFor,\n  ArgsTuple,\n  BuildMeta,\n  BuiltForLeaf,\n  BuiltInfinite,\n  BuiltMutation,\n  BuiltQuery,\n  Cursor,\n  DataShape,\n  InfiniteBuildOptionsFor,\n  MutationBuildOptionsFor,\n  QueryBuildOptionsFor,\n  RouteClient,\n  RouteClientOptions,\n  RouteClientDebugEvent,\n  RouteClientDebugLogger,\n  RouteClientDebugMode,\n  RouteClientDebugOptions,\n  RouteClientDebugToggleOptions,\n  Updater,\n} from './routesV3.client.types';\n\n// -------------------------------------------------------------------------------------\n// Tiny helpers\n// -------------------------------------------------------------------------------------\n/**\n * Convert an HTTP method to uppercase (as expected by fetch).\n * @param m Lowercase HTTP method.\n * @returns Uppercase method string.\n */\nconst toUpper = (m: HttpMethod): Uppercase<HttpMethod> => m.toUpperCase() as Uppercase<HttpMethod>;\n\n/**\n * Parse the given value with the supplied schema (if present).\n * @param value Raw value to validate.\n * @param schema Optional Zod schema used for validation/coercion.\n * @returns The validated or original value.\n */\nfunction zParse<T>(value: unknown, schema?: ZodType): T {\n  return schema ? (schema.parse(value) as T) : (value as T);\n}\n\n/**\n * Serialize a query object into a search string.\n * @param query Query params object (possibly undefined).\n * @returns Query string prefixed with `?`, or empty string.\n */\nfunction toSearchString(query: Record<string, unknown> | undefined) {\n  if (!query) return '';\n  const params = new URLSearchParams();\n  for (const [k, v] of Object.entries(query)) {\n    if (v == null) continue;\n    if (Array.isArray(v)) {\n      v.forEach((x) => {\n        if (x == null) return;\n        if (typeof x === 'object') {\n          params.append(k, JSON.stringify(x));\n        } else {\n          params.append(k, String(x));\n        }\n      });\n      continue;\n    }\n    if (typeof v === 'object') {\n      params.set(k, JSON.stringify(v));\n      continue;\n    }\n    params.set(k, String(v));\n  }\n  const s = params.toString();\n  return s ? `?${s}` : '';\n}\n\n/**\n * Remove the given key from an object (used to drop cursors from cache keys).\n * @param obj Source object.\n * @param key Property name to omit.\n * @returns Copy of the object without the specified key.\n */\nfunction stripKey<Q extends Record<string, unknown> | undefined>(obj: Q, key: string): Q {\n  if (!obj) return obj;\n  const { [key]: _omit, ...rest } = obj as any;\n  return rest as Q;\n}\n\n/**\n * Default cursor extractor used by infinite queries.\n * @param p Page result returned from the server.\n * @returns Next cursor string, if present.\n */\nconst defaultGetNextCursor = (p: unknown): Cursor =>\n  p && typeof p === 'object' && 'nextCursor' in p ? (p as any).nextCursor : undefined;\n\n// Debug logging --------------------------------------------------------------\nconst noopDebugLogger: RouteClientDebugLogger = () => {};\n\nconst defaultDebugLogger: RouteClientDebugLogger = (event: RouteClientDebugEvent) => {\n  if (typeof console === 'undefined') return;\n  const fn = console.debug ?? console.log;\n  fn?.call(console, '[rrroutes-client]', event);\n};\n\nconst debugEventTypes: RouteClientDebugEvent['type'][] = [\n  'fetch',\n  'invalidate',\n  'setData',\n  'build',\n  'useEndpoint',\n];\n\ntype DebugEmitter<Names extends string> = {\n  emit: (event: RouteClientDebugEvent, name?: Names) => void;\n  mode: RouteClientDebugMode;\n};\n\nconst noopEmit = () => {};\n\nfunction createDebugEmitter<Names extends string>(\n  option?: RouteClientDebugOptions<Names>,\n  environment?: string,\n): DebugEmitter<Names> {\n  const disabled: DebugEmitter<Names> = { emit: noopEmit, mode: 'minimal' };\n\n  if (environment && environment.toLowerCase() === 'production') {\n    return disabled;\n  }\n\n  if (!option) {\n    return disabled;\n  }\n  if (option === true || option === 'minimal') {\n    return {\n      emit: (event, name) => defaultDebugLogger(name ? { ...event, name } : event),\n      mode: 'minimal',\n    };\n  }\n  if (option === 'complete') {\n    return {\n      emit: (event, name) => defaultDebugLogger(name ? { ...event, name } : event),\n      mode: 'complete',\n    };\n  }\n  if (typeof option === 'function') {\n    return {\n      emit: (event, name) => option(name ? { ...event, name } : event),\n      mode: 'minimal',\n    };\n  }\n  if (typeof option === 'object') {\n    const toggles = option as RouteClientDebugToggleOptions<Names>;\n    const verbose = Boolean(toggles.verbose);\n    const enabledTypes = debugEventTypes.filter((type) => toggles[type]);\n    if (enabledTypes.length === 0) {\n      return { emit: noopEmit, mode: verbose ? 'complete' : 'minimal' };\n    }\n    const whitelist = new Set<RouteClientDebugEvent['type']>(enabledTypes);\n    const onlySet =\n      toggles.only && toggles.only.length > 0 ? new Set<Names>(toggles.only) : undefined;\n    const logger = toggles.logger ?? defaultDebugLogger;\n    const emit: DebugEmitter<Names>['emit'] = (event, name) => {\n      if (!whitelist.has(event.type)) return;\n      if (onlySet) {\n        if (!name || !onlySet.has(name)) return;\n      }\n      logger(name ? { ...event, name } : event);\n    };\n    return { emit, mode: verbose ? 'complete' : 'minimal' };\n  }\n\n  return disabled;\n}\n\n// Split the variadic tuple at runtime\n/**\n * Extract the optional argument object from a variadic tuple.\n * @param args Tuple passed to a built endpoint helper.\n * @returns The argument object if present.\n */\nfunction extractArgs<L extends AnyLeaf>(args: ArgsTuple<L>): ArgsFor<L> | undefined {\n  // At runtime ArgsTuple<L> is either [] or [obj]; we just pick the first if present.\n  return (args as unknown as any[])[0] as any;\n}\n\n/**\n * Normalize params and query values, then construct a request URL for the given leaf.\n * @param leaf Leaf describing the endpoint.\n * @param baseUrl Optional base URL prepended to the path.\n * @param params Route parameters supplied by the caller.\n * @param query Query parameters supplied by the caller.\n * @returns Object containing the composed URL plus normalized params/query payloads.\n */\nfunction buildUrl<L extends AnyLeaf>(\n  leaf: L,\n  baseUrl: string,\n  params: InferParams<L> | undefined,\n  query: InferQuery<L> | undefined,\n) {\n  const normalizedParams = zParse<InferParams<L>>(params, leaf.cfg.paramsSchema);\n  const normalizedQuery = zParse<InferQuery<L>>(query, leaf.cfg.querySchema);\n  const path = compilePath<L['path']>(leaf.path, (normalizedParams ?? {}) as any);\n  const url = `${baseUrl ?? ''}${path}${toSearchString(normalizedQuery as any)}`;\n  return { url, normalizedQuery, normalizedParams };\n}\n\n// -------------------------------------------------------------------------------------\n// Client factory\n// -------------------------------------------------------------------------------------\n/**\n * Construct typed React Query helpers backed by a routes-v3 registry leaf.\n * @param opts Route client configuration (query client, fetcher overrides, etc).\n * @returns Object that can build endpoint hooks/mutations from leaves.\n */\nexport function createRouteClient<Names extends string = string>(\n  opts: RouteClientOptions<Names>,\n): RouteClient<Names> {\n  const queryClient = opts.queryClient;\n  const fetcher = opts.fetcher ?? defaultFetcher;\n  const baseUrl = opts.baseUrl;\n  const cursorParam = opts.cursorParam ?? 'cursor';\n  const getNextCursor = opts.getNextCursor ?? defaultGetNextCursor;\n  const environment =\n    opts.environment ?? undefined;\n  const { emit: emitDebug, mode: debugMode } = createDebugEmitter<Names>(opts.debug, environment);\n  const isVerboseDebug = debugMode === 'complete';\n  const decorateDebugEvent = <T extends RouteClientDebugEvent>(\n    event: T,\n    details?: Partial<RouteClientDebugEvent>,\n  ): RouteClientDebugEvent => {\n    if (!isVerboseDebug || !details) return event;\n    return { ...event, ...details } as RouteClientDebugEvent;\n  };\n\n  /**\n   * Invalidate a set of queries sharing the given prefix.\n   * @param prefix Key parts shared by matching endpoints.\n   * @param exact When true, invalidate only exact key matches.\n   */\n  async function invalidate(prefix: string[], exact = false) {\n    const queryKey = prefix as unknown as QueryKey;\n    await queryClient.invalidateQueries({ queryKey, exact });\n    emitDebug({ type: 'invalidate', key: queryKey, exact });\n  }\n\n  /**\n   * Build the client surface for a single leaf (query/mutation/infinite query).\n   * @param leaf Leaf describing the endpoint.\n   * @param rqOpts Optional React Query configuration.\n   * @returns Helper object exposing key/invalidate/setData/useEndpoint.\n   */\n  function buildInternal<L extends AnyLeaf>(\n    leaf: L,\n    rqOpts?: QueryBuildOptionsFor<L> | InfiniteBuildOptionsFor<L> | MutationBuildOptionsFor<L>,\n    meta?: BuildMeta<Names>,\n  ): BuiltForLeaf<L> {\n    const isGet = leaf.method === 'get';\n    const isFeed = !!leaf.cfg.feed;\n    const method = toUpper(leaf.method);\n    const leafLabel = `${leaf.method.toUpperCase()} ${String(leaf.path)}`;\n    const debugName = meta?.name;\n    const emit = (event: RouteClientDebugEvent) => emitDebug(event, debugName);\n    emit({ type: 'build', leaf: leafLabel });\n\n    // --- key/invalidate/setData shared helpers ---\n    const key = (...tuple: ArgsTuple<L>): QueryKey => {\n      const a = extractArgs<L>(tuple);\n      const params = (a as any)?.params as InferParams<L> | undefined;\n      const query = (a as any)?.query as InferQuery<L> | undefined;\n      const qForKey = isGet && isFeed ? stripKey(query as any, cursorParam) : (query as any);\n      return buildCacheKey({ leaf, params: params as any, query: qForKey }) as unknown as QueryKey;\n    };\n\n    /**\n     * Invalidate the React Query cache for this exact leaf invocation.\n     * @param tuple Optional params/query tuple.\n     */\n    const invalidateExact = async (...tuple: ArgsTuple<L>) => {\n      const queryKey = key(...tuple);\n      await queryClient.invalidateQueries({ queryKey, exact: true });\n      emit({ type: 'invalidate', key: queryKey, exact: true });\n    };\n\n    /**\n     * Update the cache entries for this leaf.\n     * @param args Tuple whose first entry is the updater and optional params/query follow.\n     */\n    const setData = (...args: [Updater<DataShape<L>>, ...rest: ArgsTuple<L>]) => {\n      const [updater, ...rest] = args;\n      const k = key(...(rest as ArgsTuple<L>));\n      if (isGet && isFeed) {\n        queryClient.setQueryData<InfiniteData<InferOutput<L>> | undefined>(k, (prev) =>\n          typeof updater === 'function' ? (updater as any)(prev) : (updater as any),\n        );\n      } else {\n        queryClient.setQueryData<InferOutput<L> | undefined>(k, (prev) =>\n          typeof updater === 'function' ? (updater as any)(prev) : (updater as any),\n        );\n      }\n      emit({ type: 'setData', key: k });\n    };\n\n    // --- Infinite GET ---\n    if (isGet && isFeed) {\n      const useEndpoint: BuiltInfinite<L>['useEndpoint'] = (...tuple) => {\n        emit({ type: 'useEndpoint', leaf: leafLabel, variant: 'infiniteGet' });\n        const a = extractArgs<L>(tuple);\n        const params = (a as any)?.params as InferParams<L> | undefined;\n        const query = (a as any)?.query as InferQuery<L> | undefined;\n\n        // Normalize once; we’ll inject the cursor per page below.\n        const { normalizedQuery, normalizedParams } = buildUrl(leaf, baseUrl, params, query);\n        return useInfiniteQuery<\n          InferOutput<L>, // TQueryFnData (per page)\n          unknown, // TError\n          InfiniteData<InferOutput<L>>, // TData (returned by the hook)\n          QueryKey,\n          Cursor\n        >({\n          ...(rqOpts as InfiniteBuildOptionsFor<L>),\n          queryKey: key(...tuple),\n          initialPageParam: undefined,\n          getNextPageParam: (lastPage) => getNextCursor(lastPage),\n          placeholderData: keepPreviousData,\n          queryFn: async ({ pageParam }) => {\n            const pageQuery = {\n              ...(normalizedQuery as any),\n              ...(pageParam ? { [cursorParam]: pageParam } : {}),\n            };\n            const { url } = buildUrl(leaf, baseUrl, params, pageQuery);\n            const startedAt = Date.now();\n            const detail = isVerboseDebug ? { params: normalizedParams, query: pageQuery } : undefined;\n            emit(\n              decorateDebugEvent(\n                { type: 'fetch', stage: 'start', method, url, leaf: leafLabel },\n                detail,\n              ),\n            );\n            try {\n              const out = await fetcher<unknown>({ url, method });\n              const parsed = zParse<InferOutput<L>>(out, leaf.cfg.outputSchema);\n              emit(\n                decorateDebugEvent(\n                  {\n                    type: 'fetch',\n                    stage: 'success',\n                    method,\n                    url,\n                    leaf: leafLabel,\n                    durationMs: Date.now() - startedAt,\n                  },\n                  isVerboseDebug ? { params: normalizedParams, query: pageQuery, output: parsed } : undefined,\n                ),\n              );\n              return parsed;\n            } catch (error) {\n              emit(\n                decorateDebugEvent(\n                  {\n                    type: 'fetch',\n                    stage: 'error',\n                    method,\n                    url,\n                    leaf: leafLabel,\n                    durationMs: Date.now() - startedAt,\n                    error,\n                  },\n                  detail,\n                ),\n              );\n              throw error;\n            }\n          },\n          // NOTE: TData is InfiniteData<T>, so we don't need a select here.\n        }, queryClient);\n      };\n\n      return {\n        key,\n        invalidate: invalidateExact,\n        setData: setData as any,\n        useEndpoint,\n      } as BuiltForLeaf<L>;\n    }\n    // --- Plain GET ---\n    if (isGet) {\n      const useEndpoint: BuiltQuery<L>['useEndpoint'] = (...tuple) => {\n        emit({ type: 'useEndpoint', leaf: leafLabel, variant: 'get' });\n        const a = extractArgs<L>(tuple);\n        const params = (a as any)?.params as InferParams<L> | undefined;\n        const query = (a as any)?.query as InferQuery<L> | undefined;\n\n        const { url, normalizedQuery, normalizedParams } = buildUrl(leaf, baseUrl, params, query);\n        return useQuery<InferOutput<L>, unknown, InferOutput<L>, QueryKey>({\n          ...(rqOpts as QueryBuildOptionsFor<L>),\n          queryKey: key(...tuple),\n          placeholderData: keepPreviousData,\n          queryFn: async () => {\n            const startedAt = Date.now();\n            const detail = isVerboseDebug\n              ? { params: normalizedParams, query: normalizedQuery }\n              : undefined;\n            emit(\n              decorateDebugEvent(\n                { type: 'fetch', stage: 'start', method, url, leaf: leafLabel },\n                detail,\n              ),\n            );\n            try {\n              const out = await fetcher<unknown>({ url, method });\n              const parsed = zParse<InferOutput<L>>(out, leaf.cfg.outputSchema);\n              emit(\n                decorateDebugEvent(\n                  {\n                    type: 'fetch',\n                    stage: 'success',\n                    method,\n                    url,\n                    leaf: leafLabel,\n                    durationMs: Date.now() - startedAt,\n                  },\n                  isVerboseDebug\n                    ? { params: normalizedParams, query: normalizedQuery, output: parsed }\n                    : undefined,\n                ),\n              );\n              return parsed;\n            } catch (error) {\n              emit(\n                decorateDebugEvent(\n                  {\n                    type: 'fetch',\n                    stage: 'error',\n                    method,\n                    url,\n                    leaf: leafLabel,\n                    durationMs: Date.now() - startedAt,\n                    error,\n                  },\n                  detail,\n                ),\n              );\n              throw error;\n            }\n          },\n        }, queryClient);\n      };\n\n      return {\n        key,\n        invalidate: invalidateExact,\n        setData: setData as any,\n        useEndpoint,\n      } as BuiltForLeaf<L>;\n    }\n\n    // --- Mutation (POST/PUT/PATCH/DELETE) ---\n    const fetchEndpoint: BuiltMutation<L>['fetch'] = async (\n      ...tupleWithBody: [...ArgsTuple<L>, InferBody<L>]\n    ) => {\n      if (tupleWithBody.length === 0) {\n        throw new Error('Body is required when invoking a mutation fetch.');\n      }\n      const bodyIndex = tupleWithBody.length - 1;\n      const tuple = tupleWithBody.slice(0, bodyIndex) as ArgsTuple<L>;\n      const body = tupleWithBody[bodyIndex] as InferBody<L>;\n      const args = extractArgs<L>(tuple);\n      const params = (args as any)?.params as InferParams<L> | undefined;\n      const query = (args as any)?.query as InferQuery<L> | undefined;\n\n      const { url, normalizedQuery, normalizedParams } = buildUrl(leaf, baseUrl, params, query);\n      const normalizedBody = zParse<InferBody<L>>(body, leaf.cfg.bodySchema);\n\n      // Optional: switch to FormData if your method declares bodyFiles\n      const isMultipart = Array.isArray(leaf.cfg.bodyFiles) && leaf.cfg.bodyFiles.length > 0;\n      const payload = isMultipart ? toFormData(normalizedBody as any) : normalizedBody;\n\n      const startedAt = Date.now();\n      const detail = isVerboseDebug\n        ? { params: normalizedParams, query: normalizedQuery }\n        : undefined;\n      emit(\n        decorateDebugEvent(\n          {\n            type: 'fetch',\n            stage: 'start',\n            method,\n            url,\n            leaf: leafLabel,\n            body: payload,\n          },\n          detail,\n        ),\n      );\n      try {\n        const out = await fetcher<unknown>({ url, method, body: payload });\n        const parsed = zParse<InferOutput<L>>(out, leaf.cfg.outputSchema);\n        emit(\n          decorateDebugEvent(\n            {\n              type: 'fetch',\n              stage: 'success',\n              method,\n              url,\n              leaf: leafLabel,\n              durationMs: Date.now() - startedAt,\n            },\n            isVerboseDebug\n              ? { params: normalizedParams, query: normalizedQuery, output: parsed }\n              : undefined,\n          ),\n        );\n        return parsed;\n      } catch (error) {\n        emit(\n          decorateDebugEvent(\n            {\n              type: 'fetch',\n              stage: 'error',\n              method,\n              url,\n              leaf: leafLabel,\n              durationMs: Date.now() - startedAt,\n              body: payload,\n              error,\n            },\n            detail,\n          ),\n        );\n        throw error;\n      }\n    };\n\n    const useEndpoint: BuiltMutation<L>['useEndpoint'] = (...tuple) => {\n      emit({ type: 'useEndpoint', leaf: leafLabel, variant: 'mutation' });\n      return useMutation<InferOutput<L>, unknown, InferBody<L>, unknown>({\n        ...(rqOpts as MutationBuildOptionsFor<L>),\n        mutationKey: key(...tuple),\n        mutationFn: (body: InferBody<L>) =>\n          fetchEndpoint(...([...tuple, body] as [...ArgsTuple<L>, InferBody<L>])),\n      }, queryClient);\n    };\n\n    return {\n      key,\n      invalidate: invalidateExact,\n      setData: setData as any,\n      useEndpoint,\n      fetch: fetchEndpoint,\n    } as BuiltForLeaf<L>;\n  }\n\n  return {\n    queryClient,\n    invalidate,\n    build: buildInternal as RouteClient<Names>['build'],\n  };\n}\n\n// -------------------------------------------------------------------------------------\n// Multipart helper\n// -------------------------------------------------------------------------------------\nfunction toFormData(body: Record<string, any>): FormData {\n  const fd = new FormData();\n  for (const [k, v] of Object.entries(body ?? {})) {\n    if (v == null) continue;\n    if (Array.isArray(v)) v.forEach((item, i) => fd.append(`${k}[${i}]`, item as any));\n    else fd.append(k, v as any);\n  }\n  return fd;\n}\n","// socket.client.index.ts\n\nimport { io, Socket } from 'socket.io-client';\nimport { z } from 'zod';\nimport type { SocketEvent } from '@emeryld/rrroutes-contract';\n\nexport type EventMap = Record<string, SocketEvent>;\nexport type Payload<T extends EventMap, K extends keyof T> = z.infer<T[K]['message']>;\n\nexport type ServerEnvelope<T extends EventMap, K extends keyof T & string> = {\n  eventName: K;\n  sentAt: string | Date;\n  sentTo: string[];\n  data?: Payload<T, K>;\n  metadata?: Record<string, unknown>;\n};\n\nexport type ClientCtx = {\n  receivedAt: Date;\n  latencyMs?: number;\n  nsp?: string;\n  socketId?: string;\n  rooms?: string[];\n  socket?: Socket;\n  reply?: (data?: unknown) => void;\n};\n\n/** === NEW: typed client debug === */\nexport type ClientStatsSnapshot = {\n  roomsCount: number;\n  totalHandlers: number;\n  rooms: { room: string; count: number }[];\n  handlers: { event: string; handlers: number }[];\n};\n\nexport type SocketClientDebugEvent<K extends string = string> =\n  | { type: 'connect'; id: string }\n  | { type: 'reconnect'; attempt: number }\n  | { type: 'disconnect'; reason: string }\n  | { type: 'connect_error'; err: string }\n  | { type: 'register'; event: K }\n  | { type: 'unregister'; event: K }\n  | { type: 'emit'; event: K; metadata?: Record<string, unknown> }\n  | { type: 'receive'; event: K; envelope?: { eventName: K; sentAt: string | Date; sentTo: string[]; metadata?: Record<string, unknown> } }\n  | { type: 'join'; rooms: string[]; stats?: ClientStatsSnapshot }\n  | { type: 'leave'; rooms: string[]; stats?: ClientStatsSnapshot }\n  | { type: 'stats'; value: ClientStatsSnapshot }\n  // NEW: heartbeat\n  | { type: 'ping_emit'; payload: unknown }\n  | { type: 'pong_recv'; latencyMs: number; payload?: unknown };\n\nexport type SocketClientDebugOptions<K extends string = string> = {\n  verbose?: boolean;\n  only?: K[];\n  logger?: (e: SocketClientDebugEvent<K>) => void;\n} & {\n  [P in SocketClientDebugEvent['type']]?: boolean;\n};\n\n/** === NEW: Heartbeat config (enforced) === */\nexport type HeartbeatClientOptions = {\n  /** Event names. Defaults are 'sys:ping' and 'sys:pong'. */\n  pingEvent?: string;\n  pongEvent?: string;\n  /** Interval between pings. Default 15_000. */\n  intervalMs?: number;\n  /** Give up waiting for pong after this many ms. Default 7_500. */\n  timeoutMs?: number;\n\n  /** Schema of the ping payload you will emit. */\n  pingSchema: z.ZodTypeAny;\n  /** Produce the ping payload on each tick. */\n  makePingPayload: (ctx: { socket: Socket }) => unknown;\n\n  /** Optional validation of the pong payload you receive. */\n  pongSchema?: z.ZodTypeAny;\n  /** Optional hook called on each pong. */\n  onPong?: (args: { latencyMs: number; payload?: unknown; socket: Socket }) => void;\n};\n\nexport type SocketClientOptions<T extends EventMap = EventMap> = {\n  url: string;\n  ioOptions?: Parameters<typeof io>[1];\n  roomJoinEvent?: string;\n  roomLeaveEvent?: string;\n  environment?: 'development' | 'production';\n  debug?: SocketClientDebugOptions<keyof T & string>;\n\n  /** NEW: required heartbeat config */\n  heartbeat: HeartbeatClientOptions;\n};\n\ntype HandlerEntry<T extends EventMap, K extends keyof T & string> = {\n  orig: (payload: Payload<T, K>, meta: { envelope: ServerEnvelope<T, K>; ctx: ClientCtx }) => void;\n  wrapped: (envelopeOrRaw: ServerEnvelope<T, K> | Payload<T, K>) => void;\n  errorWrapped: (e: unknown) => void;\n};\n\nexport class SocketClient<T extends EventMap> {\n  readonly socket: Socket;\n  private readonly events: T;\n  private readonly roomJoinEvent: string;\n  private readonly roomLeaveEvent: string;\n  private readonly environment: 'development' | 'production';\n  private readonly debug: SocketClientDebugOptions<keyof T & string>;\n\n  // NEW\n  private readonly hb: Required<Omit<HeartbeatClientOptions, 'pongSchema' | 'onPong'>> & {\n    pongSchema?: z.ZodTypeAny;\n    onPong?: HeartbeatClientOptions['onPong'];\n  };\n  private hbTimer: ReturnType<typeof setInterval> | null = null;\n\n  // stats\n  private readonly roomCounts = new Map<string, number>();\n  private readonly handlerMap = new Map<string, Set<HandlerEntry<T, any>>>();\n\n  constructor(events: T, opts: SocketClientOptions<T>) {\n    this.events = events;\n    this.socket = io(opts.url, { autoConnect: true, ...opts.ioOptions });\n    this.roomJoinEvent = opts.roomJoinEvent ?? 'room:join';\n    this.roomLeaveEvent = opts.roomLeaveEvent ?? 'room:leave';\n    this.environment = opts.environment ?? 'development';\n    this.debug = opts.debug ?? {};\n    // heartbeat\n    const hb = opts.heartbeat;\n    this.hb = {\n      pingEvent: hb.pingEvent ?? 'sys:ping',\n      pongEvent: hb.pongEvent ?? 'sys:pong',\n      intervalMs: hb.intervalMs ?? 15_000,\n      timeoutMs: hb.timeoutMs ?? 7_500,\n      pingSchema: hb.pingSchema,\n      makePingPayload: hb.makePingPayload,\n      pongSchema: hb.pongSchema,\n      onPong: hb.onPong,\n    };\n\n    const dbg = <K extends keyof T & string | 'connect' | 'disconnect' | 'reconnect' | 'connect_error' | 'join' | 'leave' | 'stats' | 'ping_emit' | 'pong_recv'>(\n      key: K,\n      e: SocketClientDebugEvent<any>\n    ) => {\n      const d = this.debug;\n      if (!d.logger) return;\n      if (!d[e.type]) return;\n      if (d.only && 'event' in e && typeof (e as any).event === 'string' && !d.only.includes((e as any).event)) return;\n      d.logger(e);\n    };\n\n    // socket lifecycle\n    this.socket.on('connect', () => {\n      dbg('connect', { type: 'connect', id: this.socket.id ?? '' });\n      this.startHeartbeat(dbg);\n    });\n    this.socket.on('reconnect', (attempt) => dbg('reconnect', { type: 'reconnect', attempt }));\n    this.socket.on('disconnect', (reason) => {\n      dbg('disconnect', { type: 'disconnect', reason: String(reason) });\n      this.stopHeartbeat();\n    });\n    this.socket.on('connect_error', (err) => dbg('connect_error', { type: 'connect_error', err: String(err) }));\n\n    // wire pong listener\n    this.socket.on(this.hb.pongEvent, (raw: any) => {\n      const receivedAt = Date.now();\n      const serverNowIso: string | undefined = raw?.serverNow;\n      const clientSentIso: string | undefined = raw?.clientEcho?.__clientSentAt;\n      let latencyMs: number | undefined;\n\n      if (clientSentIso) {\n        const sent = Date.parse(clientSentIso);\n        if (!Number.isNaN(sent)) latencyMs = Math.max(0, receivedAt - sent);\n      }\n\n      if (this.hb.pongSchema) {\n        const ok = this.hb.pongSchema.safeParse(raw);\n        if (!ok.success) return; // drop invalid\n      }\n\n      if (this.debug.logger && this.debug.pong_recv) {\n        this.debug.logger({ type: 'pong_recv', latencyMs: latencyMs ?? raw?.sinceMs ?? 0, payload: raw });\n      }\n      this.hb.onPong?.({ latencyMs: latencyMs ?? raw?.sinceMs ?? 0, payload: raw, socket: this.socket });\n    });\n  }\n\n  /** internal stats snapshot */\n  stats(): ClientStatsSnapshot {\n    const rooms = Array.from(this.roomCounts.entries()).map(([room, count]) => ({ room, count }));\n    const handlers = Array.from(this.handlerMap.entries()).map(([event, set]) => ({\n      event,\n      handlers: set.size,\n    }));\n    return {\n      roomsCount: rooms.length,\n      totalHandlers: handlers.reduce((a, b) => a + b.handlers, 0),\n      rooms,\n      handlers,\n    };\n  }\n\n  private toArray(rooms?: string[] | string): string[] {\n    return rooms == null ? [] : Array.isArray(rooms) ? rooms : [rooms];\n  }\n\n  /** === NEW: heartbeat control === */\n  private startHeartbeat(dbg: (k: any, e: SocketClientDebugEvent) => void) {\n    this.stopHeartbeat();\n    const tick = () => {\n      const basePayload = this.hb.makePingPayload({ socket: this.socket }) ?? {};\n      const candidate = { ...basePayload, __clientSentAt: new Date().toISOString() };\n\n      const check = this.hb.pingSchema.safeParse(candidate);\n      if (!check.success) {\n        if (this.environment === 'development') console.warn('[socket] ping schema validation failed', check.error.issues);\n        return;\n      }\n\n      // emit with ack timeout support\n      const timer = setTimeout(() => {\n        /* timeout, no-op here. consumer can observe missing pong if desired */\n      }, this.hb.timeoutMs);\n\n      this.socket.timeout(this.hb.timeoutMs).emit(this.hb.pingEvent, { payload: check.data }, () => {\n        clearTimeout(timer);\n      });\n      if (this.debug.logger && this.debug.ping_emit) {\n        dbg('ping_emit', { type: 'ping_emit', payload: check.data });\n      }\n    };\n\n    this.hbTimer = setInterval(tick, this.hb.intervalMs);\n    // fire first ping immediately\n    tick();\n  }\n\n  private stopHeartbeat() {\n    if (this.hbTimer) {\n      clearInterval(this.hbTimer);\n      this.hbTimer = null;\n    }\n  }\n\nemit<K extends keyof T & string>(\n  event: K,\n  payload: Payload<T, K>,\n  metadata?: Record<string, unknown>,\n  onAck?: (ack: unknown) => void,      \n  timeoutMs?: number                      \n): void {\n  const schema = this.events[event].message;\n  const parsed = schema.safeParse(payload);\n  if (!parsed.success) throw new Error(`Invalid payload for \"${event}\": ${parsed.error.message}`);\n\n  if (onAck) {\n    this.socket.timeout(timeoutMs ?? this.hb.timeoutMs).emit(String(event), parsed.data, (ack: unknown) => {\n      try { onAck(ack); } catch { /* noop */ }\n    });\n  } else {\n    this.socket.emit(String(event), parsed.data);\n  }\n\n  if (this.debug.logger && this.debug.emit) {\n    this.debug.logger({ type: 'emit', event, metadata: this.debug.verbose ? metadata : undefined } as any);\n  }\n}\n\n\n  joinRooms(rooms?: string[] | string): void {\n    const list = this.toArray(rooms);\n    const toJoin: string[] = [];\n    for (const r of list) {\n      const next = (this.roomCounts.get(r) ?? 0) + 1;\n      this.roomCounts.set(r, next);\n      if (next === 1) toJoin.push(r);\n    }\n    if (toJoin.length > 0) {\n      this.socket.emit(this.roomJoinEvent, { rooms: toJoin });\n      if (this.debug.logger && this.debug.join) {\n        this.debug.logger({ type: 'join', rooms: toJoin, stats: this.debug.stats || this.debug.verbose ? this.stats() : undefined });\n      }\n    }\n  }\n\n  leaveRooms(rooms?: string[] | string): void {\n    const list = this.toArray(rooms);\n    const toLeave: string[] = [];\n    for (const r of list) {\n      const curr = this.roomCounts.get(r) ?? 0;\n      const next = Math.max(0, curr - 1);\n      if (next === 0 && curr > 0) toLeave.push(r);\n      if (next === 0) this.roomCounts.delete(r);\n      else this.roomCounts.set(r, next);\n    }\n    if (toLeave.length > 0) {\n      this.socket.emit(this.roomLeaveEvent, { rooms: toLeave });\n      if (this.debug.logger && this.debug.leave) {\n        this.debug.logger({ type: 'leave', rooms: toLeave, stats: this.debug.stats || this.debug.verbose ? this.stats() : undefined });\n      }\n    }\n  }\n\n  on<K extends keyof T & string>(\n    event: K,\n    handler: (payload: Payload<T, K>, meta: { envelope: ServerEnvelope<T, K>; ctx: ClientCtx }) => void,\n  ): () => void {\n    const schema = this.events[event].message;\n\n    if (this.debug.logger && this.debug.register) {\n      this.debug.logger({ type: 'register', event } as any);\n    }\n\nconst wrapped = (envelopeOrRaw: ServerEnvelope<T, K> | Payload<T, K>, maybeAck?: (data?: unknown) => void) => {\n  const maybeEnvelope = envelopeOrRaw as any;\n  const rawData = maybeEnvelope?.data ?? maybeEnvelope;\n\n  const parsed = schema.safeParse(rawData);\n  if (!parsed.success) return;\n\n  const receivedAt = new Date();\n  const sentAt = maybeEnvelope?.sentAt ? new Date(maybeEnvelope.sentAt) : undefined;\n\n  const meta = {\n    envelope: {\n      eventName: (maybeEnvelope?.eventName ?? event) as K,\n      sentAt: maybeEnvelope?.sentAt ?? receivedAt.toISOString(),\n      sentTo: maybeEnvelope?.sentTo ?? [],\n      data: undefined,\n      metadata: maybeEnvelope?.metadata,\n    },\n    ctx: {\n      receivedAt,\n      latencyMs: sentAt ? Math.max(0, receivedAt.getTime() - sentAt.getTime()) : undefined,\n      nsp: (this.socket as any).nsp,\n      socketId: this.socket.id,\n      socket: this.socket,\n      reply: typeof maybeAck === 'function' ? (d?: unknown) => { try { maybeAck(d); } catch { /* noop */ } } : undefined, // NEW\n    },\n  } as const;\n\n  if (this.debug.logger && this.debug.receive) {\n    this.debug.logger({\n      type: 'receive',\n      event,\n      envelope: this.debug.verbose\n        ? { eventName: meta.envelope.eventName, sentAt: meta.envelope.sentAt, sentTo: meta.envelope.sentTo, metadata: meta.envelope.metadata }\n        : undefined,\n    } as any);\n  }\n\n  handler(parsed.data as any, meta as any);\n};\n\n\n    const errorWrapped = (e: unknown) => {\n      if (this.environment === 'development') {\n        // eslint-disable-next-line no-console\n        console.warn(`[socket] ${String(event)}:error`, e);\n      }\n    };\n\n    this.socket.on(String(event), wrapped);\n    this.socket.on(`${String(event)}:error`, errorWrapped);\n\n    let set = this.handlerMap.get(String(event));\n    if (!set) {\n      set = new Set();\n      this.handlerMap.set(String(event), set);\n    }\n    const entry: HandlerEntry<T, K> = { orig: handler, wrapped, errorWrapped };\n    set.add(entry);\n\n    return () => {\n      this.socket.off(String(event), wrapped);\n      this.socket.off(`${String(event)}:error`, errorWrapped);\n      const s = this.handlerMap.get(String(event));\n      if (s) {\n        s.delete(entry);\n        if (s.size === 0) this.handlerMap.delete(String(event));\n      }\n      if (this.debug.logger && this.debug.unregister) {\n        this.debug.logger({ type: 'unregister', event } as any);\n      }\n    };\n  }\n\n  disconnect(): void {\n    this.stopHeartbeat();\n    this.socket.disconnect();\n  }\n\n  connect(): void {\n    this.socket.connect();\n  }\n}\n"],"mappings":"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","names":["useEndpoint"]}

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

@@ -2,7 +2,7 @@ import React, { type DependencyList } from 'react';
 import { SocketClient, SocketClientOptions, EventMap, ClientCtx, Payload, ServerEnvelope } from './socket.client.index';
 type SocketProviderProps<T extends EventMap> = React.PropsWithChildren<{
     events: T;
-    options: SocketClientOptions;
+    options: SocketClientOptions<T>;
 }>;
 export declare function SocketProvider<T extends EventMap>({ events, options, children }: SocketProviderProps<T>): import("react/jsx-runtime").JSX.Element;
 export declare function useSocketClient<T extends EventMap>(): SocketClient<T>;

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

@@ -17,30 +17,111 @@ export type ClientCtx = {
     socketId?: string;
     rooms?: string[];
     socket?: Socket;
+    reply?: (data?: unknown) => void;
 };
-export type ClientDebugFlags = {
-    connect?: boolean;
-    disconnect?: boolean;
-    join?: boolean;
-    leave?: boolean;
-    receive?: boolean;
-    emit?: boolean;
-    stats?: boolean;
+/** === NEW: typed client debug === */
+export type ClientStatsSnapshot = {
+    roomsCount: number;
+    totalHandlers: number;
+    rooms: {
+        room: string;
+        count: number;
+    }[];
+    handlers: {
+        event: string;
+        handlers: number;
+    }[];
 };
-export type SocketClientDebug = {
-    enabled?: boolean;
+export type SocketClientDebugEvent<K extends string = string> = {
+    type: 'connect';
+    id: string;
+} | {
+    type: 'reconnect';
+    attempt: number;
+} | {
+    type: 'disconnect';
+    reason: string;
+} | {
+    type: 'connect_error';
+    err: string;
+} | {
+    type: 'register';
+    event: K;
+} | {
+    type: 'unregister';
+    event: K;
+} | {
+    type: 'emit';
+    event: K;
+    metadata?: Record<string, unknown>;
+} | {
+    type: 'receive';
+    event: K;
+    envelope?: {
+        eventName: K;
+        sentAt: string | Date;
+        sentTo: string[];
+        metadata?: Record<string, unknown>;
+    };
+} | {
+    type: 'join';
+    rooms: string[];
+    stats?: ClientStatsSnapshot;
+} | {
+    type: 'leave';
+    rooms: string[];
+    stats?: ClientStatsSnapshot;
+} | {
+    type: 'stats';
+    value: ClientStatsSnapshot;
+} | {
+    type: 'ping_emit';
+    payload: unknown;
+} | {
+    type: 'pong_recv';
+    latencyMs: number;
+    payload?: unknown;
+};
+export type SocketClientDebugOptions<K extends string = string> = {
     verbose?: boolean;
-    logger?: (e: any) => void;
-    flags?: ClientDebugFlags;
+    only?: K[];
+    logger?: (e: SocketClientDebugEvent<K>) => void;
+} & {
+    [P in SocketClientDebugEvent['type']]?: boolean;
+};
+/** === NEW: Heartbeat config (enforced) === */
+export type HeartbeatClientOptions = {
+    /** Event names. Defaults are 'sys:ping' and 'sys:pong'. */
+    pingEvent?: string;
+    pongEvent?: string;
+    /** Interval between pings. Default 15_000. */
+    intervalMs?: number;
+    /** Give up waiting for pong after this many ms. Default 7_500. */
+    timeoutMs?: number;
+    /** Schema of the ping payload you will emit. */
+    pingSchema: z.ZodTypeAny;
+    /** Produce the ping payload on each tick. */
+    makePingPayload: (ctx: {
+        socket: Socket;
+    }) => unknown;
+    /** Optional validation of the pong payload you receive. */
+    pongSchema?: z.ZodTypeAny;
+    /** Optional hook called on each pong. */
+    onPong?: (args: {
+        latencyMs: number;
+        payload?: unknown;
+        socket: Socket;
+    }) => void;
 };
-export type SocketClientOptions = {
+export type SocketClientOptions<T extends EventMap = EventMap> = {
     url: string;
     ioOptions?: Parameters<typeof io>[1];
     roomJoinEvent?: string;
     roomLeaveEvent?: string;
     environment?: 'development' | 'production';
-    /** [5] client-side debug logger */
-    debug?: SocketClientDebug;
+    debug?: SocketClientDebugOptions<keyof T & string>;
+    /** NEW: required heartbeat config */
+    heartbeat: HeartbeatClientOptions;
 };
 export declare class SocketClient<T extends EventMap> {
     readonly socket: Socket;
@@ -49,38 +130,24 @@ export declare class SocketClient<T extends EventMap> {
     private readonly roomLeaveEvent;
     private readonly environment;
     private readonly debug;
+    private readonly hb;
+    private hbTimer;
     private readonly roomCounts;
     private readonly handlerMap;
-    constructor(events: T, opts: SocketClientOptions);
-    /** [6] internal stats snapshot */
-    stats(): {
-        roomsCount: number;
-        totalHandlers: number;
-        rooms: {
-            room: string;
-            count: number;
-        }[];
-        handlers: {
-            event: string;
-            handlers: number;
-        }[];
-    };
-    private maybeLog;
-    emit<K extends keyof T & string>(event: K, payload: Payload<T, K>, 
-    /** [3] optional metadata forwarded to server and logger */
-    metadata?: Record<string, unknown>): void;
-    /** [6] refcount join. Only emits when transitioning 0->1 */
+    constructor(events: T, opts: SocketClientOptions<T>);
+    /** internal stats snapshot */
+    stats(): ClientStatsSnapshot;
+    private toArray;
+    /** === NEW: heartbeat control === */
+    private startHeartbeat;
+    private stopHeartbeat;
+    emit<K extends keyof T & string>(event: K, payload: Payload<T, K>, metadata?: Record<string, unknown>, onAck?: (ack: unknown) => void, timeoutMs?: number): void;
     joinRooms(rooms?: string[] | string): void;
-    /** [6] refcount leave. Only emits when transitioning 1->0 */
     leaveRooms(rooms?: string[] | string): void;
     on<K extends keyof T & string>(event: K, handler: (payload: Payload<T, K>, meta: {
         envelope: ServerEnvelope<T, K>;
         ctx: ClientCtx;
     }) => void): () => void;
-    /** [4] precise off: remove specific handler if provided, else all for event */
-    off<K extends keyof T & string>(event: K, handler?: (payload: Payload<T, K>, meta: {
-        envelope: ServerEnvelope<T, K>;
-        ctx: ClientCtx;
-    }) => void): void;
     disconnect(): void;
+    connect(): void;
 }

package/package.json

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