@emeryld/rrroutes-client 2.2.14 → 2.2.15

package/dist/index.cjs

@@ -69,22 +69,20 @@ var defaultFetcher = async (req) => {
 };
 
 // src/routesV3.client.index.ts
-var import_react = require("react");
+var import_rrroutes_contract = require("@emeryld/rrroutes-contract");
 var import_react_query = require("@tanstack/react-query");
+var import_react = require("react");
 var import_zod = require("zod");
-var import_rrroutes_contract = require("@emeryld/rrroutes-contract");
 var toUpper = (m) => m.toUpperCase();
-var defaultFeedQuerySchema = import_zod.z.object({
-  cursor: import_zod.z.string().optional(),
-  limit: import_zod.z.coerce.number().min(1).max(100).default(20)
-});
+var paginationQueryShape = {
+  pagination_cursor: import_zod.z.string().optional(),
+  pagination_limit: import_zod.z.coerce.number().min(1).max(100).default(20)
+};
+var defaultFeedQuerySchema = import_zod.z.object(paginationQueryShape);
 var defaultFeedOutputSchema = import_zod.z.object({
   items: import_zod.z.array(import_zod.z.unknown()),
   nextCursor: import_zod.z.string().optional()
 });
-function zParse(value, schema) {
-  return schema ? schema.parse(value) : value;
-}
 function toSearchString(query) {
   if (!query) return "";
   const params = new URLSearchParams();
@@ -183,41 +181,51 @@ function extractArgs(args) {
 function toArgsTuple(args) {
   return typeof args === "undefined" ? [] : [args];
 }
+function getZodShape(schema) {
+  const shapeOrGetter = schema.shape ? schema.shape : schema._def?.shape?.();
+  if (!shapeOrGetter) return {};
+  return typeof shapeOrGetter === "function" ? shapeOrGetter.call(schema) : shapeOrGetter;
+}
 function augmentFeedQuerySchema(schema) {
   if (!schema) return defaultFeedQuerySchema;
-  if (schema instanceof import_zod.z.ZodObject) {
-    const shape = schema.shape ? schema.shape : schema._def?.shape?.();
-    return schema.extend({
-      ...shape ?? {},
-      cursor: defaultFeedQuerySchema.shape.cursor,
-      limit: defaultFeedQuerySchema.shape.limit
-    });
+  if (!(schema instanceof import_zod.z.ZodObject)) {
+    console.warn("Feed queries must be a ZodObject; default pagination applied.");
+    return defaultFeedQuerySchema;
   }
-  return import_zod.z.intersection(schema, defaultFeedQuerySchema);
+  return schema.extend(paginationQueryShape);
 }
 function augmentFeedOutputSchema(schema) {
   if (!schema) return defaultFeedOutputSchema;
-  if (schema instanceof import_zod.z.ZodObject) {
-    const shape = schema.shape ? schema.shape : schema._def?.shape?.();
-    const hasItems = Boolean(shape?.items);
-    if (hasItems) return schema.extend({ nextCursor: import_zod.z.string().optional() });
+  if (schema instanceof import_zod.z.ZodArray) {
     return import_zod.z.object({
-      items: import_zod.z.array(schema),
+      items: schema,
       nextCursor: import_zod.z.string().optional()
     });
   }
-  if (schema instanceof import_zod.z.ZodArray) {
+  if (schema instanceof import_zod.z.ZodObject) {
+    const shape = getZodShape(schema);
+    if (shape?.items) {
+      return schema.extend({
+        nextCursor: import_zod.z.string().optional()
+      });
+    }
     return import_zod.z.object({
-      items: schema,
+      items: import_zod.z.array(schema),
       nextCursor: import_zod.z.string().optional()
     });
   }
-  return defaultFeedOutputSchema;
+  return import_zod.z.object({
+    items: import_zod.z.array(schema),
+    nextCursor: import_zod.z.string().optional()
+  });
 }
 function buildUrl(leaf, baseUrl, params, query) {
-  const normalizedParams = zParse(params, leaf.cfg.paramsSchema);
-  const normalizedQuery = zParse(query, leaf.cfg.querySchema);
-  const path = (0, import_rrroutes_contract.compilePath)(leaf.path, normalizedParams ?? {});
+  const normalizedParams = leaf.cfg.paramsSchema ? (0, import_rrroutes_contract.lowProfileParse)(leaf.cfg.paramsSchema, params) : {};
+  const normalizedQuery = leaf.cfg.querySchema ? (0, import_rrroutes_contract.lowProfileParse)(leaf.cfg.querySchema, query) : {};
+  const path = (0, import_rrroutes_contract.compilePath)(
+    leaf.path,
+    normalizedParams ?? {}
+  );
   const url = `${baseUrl ?? ""}${path}${toSearchString(normalizedQuery)}`;
   return { url, normalizedQuery, normalizedParams };
 }
@@ -225,10 +233,13 @@ function createRouteClient(opts) {
   const queryClient = opts.queryClient;
   const fetcher = opts.fetcher ?? defaultFetcher;
   const baseUrl = opts.baseUrl;
-  const cursorParam = opts.cursorParam ?? "cursor";
+  const cursorParam = opts.cursorParam ?? "pagination_cursor";
   const getNextCursor = opts.getNextCursor ?? defaultGetNextCursor;
   const environment = opts.environment ?? void 0;
-  const { emit: emitDebug, mode: debugMode } = createDebugEmitter(opts.debug, environment);
+  const { emit: emitDebug, mode: debugMode } = createDebugEmitter(
+    opts.debug,
+    environment
+  );
   const isVerboseDebug = debugMode === "complete";
   const decorateDebugEvent = (event, details) => {
     if (!isVerboseDebug || !details) return event;
@@ -242,11 +253,12 @@ function createRouteClient(opts) {
   function buildInternal(leaf, rqOpts, meta) {
     const isGet = leaf.method === "get";
     const isFeed = !!leaf.cfg.feed;
+    const rawLeafCfg = leaf.cfg;
     const leafCfg = isFeed ? {
-      ...leaf.cfg,
-      querySchema: augmentFeedQuerySchema(leaf.cfg.querySchema),
-      outputSchema: augmentFeedOutputSchema(leaf.cfg.outputSchema)
-    } : leaf.cfg;
+      ...rawLeafCfg,
+      querySchema: augmentFeedQuerySchema(rawLeafCfg.querySchema),
+      outputSchema: augmentFeedOutputSchema(rawLeafCfg.outputSchema)
+    } : rawLeafCfg;
     const method = toUpper(leaf.method);
     const expectsArgs = Boolean(leafCfg.paramsSchema || leafCfg.querySchema);
     const leafLabel = `${leaf.method.toUpperCase()} ${String(leaf.path)}`;
@@ -302,9 +314,13 @@ function createRouteClient(opts) {
       const acceptsBody = Boolean(leafCfg.bodySchema);
       const requiresBody = options?.requireBody ?? (!isGet && acceptsBody);
       if (typeof options?.body !== "undefined") {
-        const normalizedBody = zParse(options.body, leafCfg.bodySchema);
+        const normalizedBody = leafCfg.bodySchema ? (0, import_rrroutes_contract.lowProfileParse)(leafCfg.bodySchema, options.body) : void 0;
         const isMultipart = Array.isArray(leafCfg.bodyFiles) && leafCfg.bodyFiles.length > 0;
-        payload = isMultipart ? toFormData(normalizedBody) : normalizedBody;
+        if (isMultipart && normalizedBody && typeof normalizedBody === "object") {
+          payload = toFormData(normalizedBody);
+        } else {
+          payload = normalizedBody;
+        }
       } else if (requiresBody) {
         throw new Error("Body is required when invoking a mutation fetch.");
       }
@@ -327,7 +343,7 @@ function createRouteClient(opts) {
         const out = await fetcher(
           payload === void 0 ? { url, method } : { url, method, body: payload }
         );
-        const parsed = zParse(out, leafCfg.outputSchema);
+        const parsed = leafCfg.outputSchema ? (0, import_rrroutes_contract.lowProfileParse)(leafCfg.outputSchema, out) : void 0;
         emit(
           decorateDebugEvent(
             {
@@ -338,7 +354,11 @@ function createRouteClient(opts) {
               leaf: leafLabel,
               durationMs: Date.now() - startedAt
             },
-            isVerboseDebug ? { params: normalizedParams, query: normalizedQuery, output: parsed } : void 0
+            isVerboseDebug ? {
+              params: normalizedParams,
+              query: normalizedQuery,
+              output: parsed
+            } : void 0
           )
         );
         options?.onReceive?.(parsed);
@@ -369,7 +389,11 @@ function createRouteClient(opts) {
       const hasBodyCandidate = acceptsBody && tupleLength > maybeBodyIndex;
       const body = hasBodyCandidate ? tupleWithBody[tupleLength - 1] : void 0;
       const tuple = hasBodyCandidate ? tupleWithBody.slice(0, tupleLength - 1) : tupleWithBody;
-      return fetchEndpoint(tuple, { body, onReceive: buildOnReceive, requireBody: false });
+      return fetchEndpoint(tuple, {
+        body,
+        onReceive: buildOnReceive,
+        requireBody: false
+      });
     };
     if (isGet && isFeed) {
       const useEndpoint2 = (...useArgs) => {
@@ -380,13 +404,10 @@ function createRouteClient(opts) {
         const query = args?.query;
         const buildOptions = rqOpts ?? {};
         const listenersRef = (0, import_react.useRef)(/* @__PURE__ */ new Set());
-        const notifyOnReceive = (0, import_react.useCallback)(
-          (data) => {
-            buildOptions?.onReceive?.(data);
-            listenersRef.current.forEach((listener) => listener(data));
-          },
-          []
-        );
+        const notifyOnReceive = (0, import_react.useCallback)((data) => {
+          buildOptions?.onReceive?.(data);
+          listenersRef.current.forEach((listener) => listener(data));
+        }, []);
         const registerOnReceive = (0, import_react.useCallback)(
           (listener) => {
             listenersRef.current.add(listener);
@@ -402,24 +423,27 @@ function createRouteClient(opts) {
           params,
           query
         );
-        const queryResult = (0, import_react_query.useInfiniteQuery)({
-          ...buildOptions,
-          queryKey: getQueryKeys(...tuple),
-          initialPageParam: void 0,
-          getNextPageParam: (lastPage) => getNextCursor(lastPage),
-          placeholderData: import_react_query.keepPreviousData,
-          queryFn: ({ pageParam }) => {
-            const pageQuery = {
-              ...normalizedQuery,
-              ...pageParam ? { [cursorParam]: pageParam } : {}
-            };
-            return fetchEndpoint(tuple, {
-              queryOverride: pageQuery,
-              onReceive: notifyOnReceive
-            });
-          }
-          // NOTE: TData is InfiniteData<T>, so we don't need a select here.
-        }, queryClient);
+        const queryResult = (0, import_react_query.useInfiniteQuery)(
+          {
+            ...buildOptions,
+            queryKey: getQueryKeys(...tuple),
+            initialPageParam: void 0,
+            getNextPageParam: (lastPage) => getNextCursor(lastPage),
+            placeholderData: import_react_query.keepPreviousData,
+            queryFn: ({ pageParam }) => {
+              const pageQuery = {
+                ...normalizedQuery,
+                ...pageParam ? { [cursorParam]: pageParam } : {}
+              };
+              return fetchEndpoint(tuple, {
+                queryOverride: pageQuery,
+                onReceive: notifyOnReceive
+              });
+            }
+            // NOTE: TData is InfiniteData<T>, so we don't need a select here.
+          },
+          queryClient
+        );
         return { ...queryResult, onReceive: registerOnReceive };
       };
       return {
@@ -439,13 +463,10 @@ function createRouteClient(opts) {
         const query = args?.query;
         const buildOptions = rqOpts ?? {};
         const listenersRef = (0, import_react.useRef)(/* @__PURE__ */ new Set());
-        const notifyOnReceive = (0, import_react.useCallback)(
-          (data) => {
-            buildOptions?.onReceive?.(data);
-            listenersRef.current.forEach((listener) => listener(data));
-          },
-          []
-        );
+        const notifyOnReceive = (0, import_react.useCallback)((data) => {
+          buildOptions?.onReceive?.(data);
+          listenersRef.current.forEach((listener) => listener(data));
+        }, []);
         const registerOnReceive = (0, import_react.useCallback)(
           (listener) => {
             listenersRef.current.add(listener);
@@ -456,14 +477,17 @@ function createRouteClient(opts) {
           []
         );
         buildUrl({ ...leaf, cfg: leafCfg }, baseUrl, params, query);
-        const queryResult = (0, import_react_query.useQuery)({
-          ...buildOptions,
-          queryKey: getQueryKeys(...tuple),
-          placeholderData: import_react_query.keepPreviousData,
-          queryFn: () => fetchEndpoint(tuple, {
-            onReceive: notifyOnReceive
-          })
-        }, queryClient);
+        const queryResult = (0, import_react_query.useQuery)(
+          {
+            ...buildOptions,
+            queryKey: getQueryKeys(...tuple),
+            placeholderData: import_react_query.keepPreviousData,
+            queryFn: () => fetchEndpoint(tuple, {
+              onReceive: notifyOnReceive
+            })
+          },
+          queryClient
+        );
         return { ...queryResult, onReceive: registerOnReceive };
       };
       return {
@@ -497,21 +521,29 @@ function createRouteClient(opts) {
       const notifyListeners = (0, import_react.useCallback)((data) => {
         listenersRef.current.forEach((listener) => listener(data));
       }, []);
-      const registerOnReceive = (0, import_react.useCallback)((listener) => {
-        listenersRef.current.add(listener);
-        return () => {
-          listenersRef.current.delete(listener);
-        };
-      }, []);
-      const mutationResult = (0, import_react_query.useMutation)({
-        ...mutationBuildOptions,
-        mutationKey: getQueryKeys(...tuple),
-        mutationFn: async (body) => {
-          const result = await fetchMutation(...[...tuple, body]);
-          notifyListeners(result);
-          return result;
-        }
-      }, queryClient);
+      const registerOnReceive = (0, import_react.useCallback)(
+        (listener) => {
+          listenersRef.current.add(listener);
+          return () => {
+            listenersRef.current.delete(listener);
+          };
+        },
+        []
+      );
+      const mutationResult = (0, import_react_query.useMutation)(
+        {
+          ...mutationBuildOptions,
+          mutationKey: getQueryKeys(...tuple),
+          mutationFn: async (body) => {
+            const result = await fetchMutation(
+              ...[...tuple, body]
+            );
+            notifyListeners(result);
+            return result;
+          }
+        },
+        queryClient
+      );
       return { ...mutationResult, onReceive: registerOnReceive };
     };
     return {
@@ -530,13 +562,18 @@ function createRouteClient(opts) {
 }
 function buildRouter(routeClient, routes) {
   const buildLeaf = routeClient.build;
-  return ((key, opts, meta) => buildLeaf(routes[key], opts, meta));
+  return ((key, opts, meta) => buildLeaf(
+    routes[key],
+    opts,
+    meta
+  ));
 }
 function toFormData(body) {
   const fd = new FormData();
   for (const [k, v] of Object.entries(body ?? {})) {
     if (v == null) continue;
-    if (Array.isArray(v)) v.forEach((item, i) => fd.append(`${k}[${i}]`, item));
+    if (Array.isArray(v))
+      v.forEach((item, i) => fd.append(`${k}[${i}]`, item));
     else fd.append(k, v);
   }
   return fd;
@@ -799,7 +836,21 @@ function roomsFromData(data, toRooms) {
   if (data == null) return { rooms: [] };
   let state = { rooms: [] };
   const add = (input) => {
-    state = mergeRoomState(state, toRooms(input));
+    const mergeForValue = (value) => {
+      state = mergeRoomState(state, toRooms(value));
+    };
+    if (Array.isArray(input)) {
+      input.forEach((entry) => mergeForValue(entry));
+      return;
+    }
+    if (input && typeof input === "object") {
+      const maybeItems = input.items;
+      if (Array.isArray(maybeItems)) {
+        maybeItems.forEach((entry) => mergeForValue(entry));
+        return;
+      }
+    }
+    mergeForValue(input);
   };
   const maybePages = data?.pages;
   if (Array.isArray(maybePages)) {
@@ -813,22 +864,34 @@ function buildSocketedRoute(options) {
   const { built, toRooms, applySocket, useSocketClient: useSocketClient2 } = options;
   return (...useArgs) => {
     const client = useSocketClient2();
-    const endpointResult = built.useEndpoint(...useArgs);
+    const endpointResult = built.useEndpoint(
+      ...useArgs
+    );
     const argsKey = (0, import_react2.useMemo)(() => JSON.stringify(useArgs[0] ?? null), [useArgs]);
     const [roomState, setRoomState] = (0, import_react2.useState)(
       () => roomsFromData(endpointResult.data, toRooms)
     );
     const roomsKey = (0, import_react2.useMemo)(() => roomState.rooms.join("|"), [roomState.rooms]);
-    const joinMetaKey = (0, import_react2.useMemo)(() => JSON.stringify(roomState.joinMeta ?? null), [roomState.joinMeta]);
-    const leaveMetaKey = (0, import_react2.useMemo)(() => JSON.stringify(roomState.leaveMeta ?? null), [roomState.leaveMeta]);
+    const joinMetaKey = (0, import_react2.useMemo)(
+      () => JSON.stringify(roomState.joinMeta ?? null),
+      [roomState.joinMeta]
+    );
+    const leaveMetaKey = (0, import_react2.useMemo)(
+      () => JSON.stringify(roomState.leaveMeta ?? null),
+      [roomState.leaveMeta]
+    );
     (0, import_react2.useEffect)(() => {
       const unsubscribe = endpointResult.onReceive((data) => {
-        setRoomState((prev) => mergeRoomState(prev, toRooms(data)));
+        setRoomState(
+          (prev) => mergeRoomState(prev, toRooms(data))
+        );
       });
       return unsubscribe;
     }, [endpointResult, toRooms]);
     (0, import_react2.useEffect)(() => {
-      setRoomState(roomsFromData(endpointResult.data, toRooms));
+      setRoomState(
+        roomsFromData(endpointResult.data, toRooms)
+      );
     }, [endpointResult.data, toRooms]);
     (0, import_react2.useEffect)(() => {
       if (roomState.rooms.length === 0) return;
@@ -847,7 +910,14 @@ function buildSocketedRoute(options) {
         void client.leaveRooms(roomState.rooms, leaveMeta).catch(() => {
         });
       };
-    }, [client, roomsKey, roomState.joinMeta, roomState.leaveMeta, joinMetaKey, leaveMetaKey]);
+    }, [
+      client,
+      roomsKey,
+      roomState.joinMeta,
+      roomState.leaveMeta,
+      joinMetaKey,
+      leaveMetaKey
+    ]);
     (0, import_react2.useEffect)(() => {
       const entries = Object.entries(applySocket).filter(
         ([_event, fn]) => typeof fn === "function"
@@ -856,7 +926,9 @@ function buildSocketedRoute(options) {
         ([ev, fn]) => client.on(ev, (payload, meta) => {
           built.setData((prev) => {
             const next = fn(prev, payload, meta);
-            setRoomState(roomsFromData(next, toRooms));
+            setRoomState(
+              roomsFromData(next, toRooms)
+            );
             return next;
           }, ...useArgs);
         })
@@ -905,7 +977,11 @@ var SocketClient = class {
     }
     this.onConnect = async () => {
       if (!this.socket) {
-        this.dbg({ type: "connection", phase: "connect_event", err: "Socket is null" });
+        this.dbg({
+          type: "connection",
+          phase: "connect_event",
+          err: "Socket is null"
+        });
         throw new Error("Socket is null in onConnect handler");
       }
       this.dbg({
@@ -924,7 +1000,11 @@ var SocketClient = class {
     };
     this.onReconnect = async (attempt) => {
       if (!this.socket) {
-        this.dbg({ type: "connection", phase: "reconnect_event", err: "Socket is null" });
+        this.dbg({
+          type: "connection",
+          phase: "reconnect_event",
+          err: "Socket is null"
+        });
         throw new Error("Socket is null in onReconnect handler");
       }
       this.dbg({
@@ -945,7 +1025,11 @@ var SocketClient = class {
     };
     this.onDisconnect = async (reason) => {
       if (!this.socket) {
-        this.dbg({ type: "connection", phase: "disconnect_event", err: "Socket is null" });
+        this.dbg({
+          type: "connection",
+          phase: "disconnect_event",
+          err: "Socket is null"
+        });
         throw new Error("Socket is null in onDisconnect handler");
       }
       this.dbg({
@@ -965,7 +1049,11 @@ var SocketClient = class {
     };
     this.onConnectError = async (err) => {
       if (!this.socket) {
-        this.dbg({ type: "connection", phase: "connect_error_event", err: "Socket is null" });
+        this.dbg({
+          type: "connection",
+          phase: "connect_error_event",
+          err: "Socket is null"
+        });
         throw new Error("Socket is null in onConnectError handler");
       }
       this.dbg({
@@ -983,7 +1071,11 @@ var SocketClient = class {
     };
     this.onPong = async (raw) => {
       if (!this.socket) {
-        this.dbg({ type: "heartbeat", phase: "pong_recv", err: "Socket is null" });
+        this.dbg({
+          type: "heartbeat",
+          phase: "pong_recv",
+          err: "Socket is null"
+        });
         throw new Error("Socket is null in onPong handler");
       }
       const parsed = this.config.pongPayload.safeParse(raw);
@@ -1083,11 +1175,15 @@ var SocketClient = class {
   }
   /** 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]) => ({
-      event,
-      handlers: set.size
-    }));
+    const rooms = Array.from(this.roomCounts.entries()).map(
+      ([room, count]) => ({ room, count })
+    );
+    const handlers = Array.from(this.handlerMap.entries()).map(
+      ([event, set]) => ({
+        event,
+        handlers: set.size
+      })
+    );
     return {
       roomsCount: rooms.length,
       totalHandlers: handlers.reduce((a, b) => a + b.handlers, 0),
@@ -1159,7 +1255,10 @@ var SocketClient = class {
           details: this.getValidationDetails(check.error)
         });
         if (this.environment === "development") {
-          console.warn("[socket] ping schema validation failed", check.error.issues);
+          console.warn(
+            "[socket] ping schema validation failed",
+            check.error.issues
+          );
         }
         return;
       }
@@ -1218,7 +1317,12 @@ var SocketClient = class {
   }
   async joinRooms(rooms, meta) {
     if (!this.socket) {
-      this.dbg({ type: "room", phase: "join", rooms: this.toArray(rooms), err: "Socket is null" });
+      this.dbg({
+        type: "room",
+        phase: "join",
+        rooms: this.toArray(rooms),
+        err: "Socket is null"
+      });
       throw new Error("Socket is null in joinRooms method");
     }
     if (!await this.getSysEvent("sys:room_join")({
@@ -1271,7 +1375,12 @@ var SocketClient = class {
   }
   async leaveRooms(rooms, meta) {
     if (!this.socket) {
-      this.dbg({ type: "room", phase: "leave", rooms: this.toArray(rooms), err: "Socket is null" });
+      this.dbg({
+        type: "room",
+        phase: "leave",
+        rooms: this.toArray(rooms),
+        err: "Socket is null"
+      });
       throw new Error("Socket is null in leaveRooms method");
     }
     if (!await this.getSysEvent("sys:room_leave")({
@@ -1323,7 +1432,12 @@ var SocketClient = class {
     const schema = this.events[event].message;
     this.dbg({ type: "register", phase: "register", event });
     if (!this.socket) {
-      this.dbg({ type: "register", phase: "register", event, err: "Socket is null" });
+      this.dbg({
+        type: "register",
+        phase: "register",
+        event,
+        err: "Socket is null"
+      });
       return () => {
       };
     }