@emeryld/rrroutes-client 2.2.15 → 2.2.17

package/dist/routesV3.client.types.d.ts

@@ -16,7 +16,12 @@ export type FetchInput = {
     headers?: Record<string, string>;
 };
 /** Default signature for HTTP fetch implementations. */
-export type Fetcher = <T>(req: FetchInput) => Promise<T>;
+export type Fetcher = <T>(req: FetchInput) => Promise<FetcherOutput<T>> | FetcherOutput<T>;
+export type FetcherOutput<T> = {
+    data: T;
+    status: number;
+    headers: Record<string, any>;
+};
 /** Debug verbosity levels supported by the client. */
 export type RouteClientDebugMode = 'minimal' | 'complete';
 type RouteClientDebugEventBase = {
@@ -247,10 +252,51 @@ export type RouteClient<Names extends string = string> = {
     meta?: BuildMeta<Names>) => BuiltForLeaf<L>;
     /** Underlying React Query client (exposed for advanced scenarios). */
     queryClient: QueryClient;
+    /**
+     * Low-level fetch helper that does not depend on a leaf definition.
+     * Handles path param interpolation and enforces flat string query objects.
+     */
+    fetch: RouteClientFetch;
 };
 /**
  * Helper signature returned by `buildRouter`, enabling lookups by name instead of leaves.
  * Accepts the same build options/meta the underlying client does, narrowed per leaf shape.
  */
 export type RouterBuilder<Routes extends Record<PropertyKey, AnyLeafLowProfile>, Names extends string = string> = <K extends keyof Routes>(key: K, opts?: BuildOptionsFor<Routes[K]>, meta?: BuildMeta<Names>) => BuiltForLeaf<Routes[K]>;
+/**
+ * Arguments for the low-level RouteClient.fetch helper.
+ * This is intentionally NOT tied to AnyLeafLowProfile.
+ */
+export type RouteClientFetchArgs = {
+    /**
+     * Route template or concrete path, e.g. "/api/users/:id".
+     * Params from `params` will be interpolated into any `:name` segments.
+     */
+    path: string;
+    /**
+     * HTTP method. Can be provided as lowercase (HttpMethod) or uppercase;
+     * the client normalizes it to uppercase internally.
+     */
+    method: HttpMethod | Uppercase<HttpMethod>;
+    /**
+     * Flat query string object. Only string values are allowed.
+     * Nested objects/arrays will cause a runtime error in the client.
+     */
+    query?: Record<string, string>;
+    /**
+     * Path parameters used to fill `:name` segments in the `path`.
+     * Extra keys that do not match a path segment, or non-primitive values,
+     * will cause a runtime error in the client.
+     */
+    params?: Record<string, string | number | boolean | null | undefined>;
+    /**
+     * Optional request body (already normalized by the caller).
+     */
+    body?: unknown;
+};
+/**
+ * Signature of the low-level RouteClient.fetch helper.
+ * Callers may specify a response type parameter if desired.
+ */
+export type RouteClientFetch = (args: RouteClientFetchArgs) => Promise<any>;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emeryld/rrroutes-client",
-  "version": "2.2.15",
+  "version": "2.2.17",
   "private": false,
   "type": "module",
   "main": "dist/index.cjs",
@@ -19,7 +19,7 @@
     "dist"
   ],
   "dependencies": {
-    "@emeryld/rrroutes-contract": "^2.3.6",
+    "@emeryld/rrroutes-contract": "^2.3.9",
     "zod": "^4.1.13"
   },
   "peerDependencies": {