@fresho/router 0.3.2 → 0.5.0

package/README.md

@@ -39,7 +39,7 @@ export default { fetch: api.handler() };
 
 ## Features
 
-- **Type-safe path params** — `$id` creates dynamic segments, typed via `route.ctx<>()`
+- **Type-safe path params** — `$id` creates dynamic segments whose names are inferred by handlers and clients
 - **Schema validation** — query and body validated at runtime, typed at compile time
 - **Property-based routing** — property names become URL segments
 - **Typed HTTP client** — call your API with full type safety
@@ -210,7 +210,7 @@ const api = router(
 );
 ```
 
-Built-in middleware: `cors`, `errorHandler`, `logger`, `rateLimit`, `requestId`, `timeout`, `basicAuth`, `bearerAuth`, `jwtAuth`, `contentType`.
+Built-in middleware: `cors`, `errorHandler`, `logger`, `rateLimit`, `requestId`, `timeout`, `basicAuth`, `bearerAuth`, `jwtAuth`, `contentType`, `cookies`.
 
 See **[Middleware Documentation](docs/middleware.md)** for detailed usage.
 
@@ -278,6 +278,26 @@ await client.users.$get();                    // GET /users
 await client.users.$post({ body: { name: "Bob" } }); // POST /users
 ```
 
+The `$id` segment determines the `id` key in the client's `path` option, so missing or misspelled
+parameter names are caught at compile time.
+
+### Routers Built by a Factory
+
+If your router is created inside a factory so its handlers can close over injected dependencies,
+derive the API type from the factory's return type. The type-only import keeps server code out of the
+client bundle:
+
+```typescript
+import { createHttpClient } from "@fresho/router";
+import type { createServer } from "./server";
+
+type Api = ReturnType<typeof createServer>["api"];
+
+const client = createHttpClient<Api>({
+	baseUrl: "https://api.example.com",
+});
+```
+
 ### HTTP Method Syntax
 
 HTTP methods are prefixed with `$` to distinguish them from path navigation:
@@ -295,6 +315,27 @@ client.api.get.$get();   // GET /api/get (navigate to "get", then execute GET)
 
 This allows routes with path segments named after HTTP methods (e.g., `/api/get`, `/resources/delete`).
 
+### Building URLs Without Fetching
+
+Use `$url` to derive a URL string from the typed routes without firing a request. It accepts the
+same `path`/`query` options as a real call, including the parameter names inferred from `$id`
+segments:
+
+```typescript
+// Absolute URL when baseUrl is configured:
+client.media.playlist.$url({ query: { channel: "classics", chunks: 1 } });
+// → "https://api.example.com/media/playlist?channel=classics&chunks=1"
+
+client.users.$id.$url({ path: { id: "123" } });
+// → "https://api.example.com/users/123"
+
+// Relative URL (pathname + search) when no baseUrl is set:
+createHttpClient<typeof api>({}).users.$id.$url({ path: { id: "123" } });
+// → "/users/123"
+```
+
+This keeps route paths as the single source of truth for URLs embedded in response bodies, deep links, or server-side URL generation — cases where `raw: true` can't help, since `Response.url` only exists after a request runs.
+
 ## Local Client
 
 Test handlers directly without HTTP overhead:
@@ -336,16 +377,36 @@ const docs = router({
 ```typescript
 import { sseResponse } from "@fresho/router";
 
+export interface ItemEvents {
+	message: { connected: boolean };
+	update: { count: number };
+	removed: { id: string };
+}
+
 events: router({
 	get: async () =>
-		sseResponse(async (send, close) => {
-			send({ data: "connected" });
+		sseResponse<ItemEvents>(async (send, close) => {
+			send({ data: { connected: true } });
 			send({ event: "update", data: { count: 1 } });
+			send({ event: "removed", data: { id: "item-1" } });
 			close();
 		}),
 });
 ```
 
+The event map checks event names and their corresponding payloads. The reserved `message` key types
+events that omit the `event` field. Export the map for consumers, or extract it from a typed client
+method:
+
+```typescript
+import type { SSEEventsOf } from "@fresho/router";
+
+type ClientEvents = SSEEventsOf<ReturnType<typeof client.events>>;
+```
+
+HTTP and local clients return streaming routes as raw `Response` objects instead of parsing their
+bodies as JSON, so callers can consume `response.body` as data arrives.
+
 ### JSON Lines
 
 ```typescript

package/dist/index.d.mts

@@ -75,7 +75,7 @@ interface CtxBuilder<Ctx> {
  * export default { fetch: api.handler() };
  * ```
  */
-declare function router<T extends RouterRoutes, M$1 extends Middleware<any>[]>(routes: T, ...middleware: M$1): Router<T>;
+declare function router<T extends RouterRoutes, M extends Middleware<any>[]>(routes: T, ...middleware: M): Router<T>;
 //#endregion
 //#region src/docs.d.ts
 /** Generates OpenAPI documentation from a router. */
@@ -92,7 +92,7 @@ type LowercaseMethods = 'get' | 'post' | 'put' | 'patch' | 'delete';
 /** Map lowercase method to $-prefixed version. */
 type PrefixedMethod<T extends LowercaseMethods> = T extends 'get' ? '$get' : T extends 'post' ? '$post' : T extends 'put' ? '$put' : T extends 'patch' ? '$patch' : T extends 'delete' ? '$delete' : never;
 /** Extract return type from a handler. */
-type ExtractReturn<T> = T extends ((...args: unknown[]) => infer R) ? R extends Promise<infer U> ? U : R : unknown;
+type ExtractReturn<T> = T extends ((...args: never[]) => infer R) ? R extends Promise<infer U> ? U : R : unknown;
 /** Detects if a type is `any`. */
 type IsAny<T> = 0 extends 1 & T ? true : false;
 /** Checks if a schema type should require a property. */
@@ -102,7 +102,7 @@ type SafeInferSchema<T> = IsAny<T> extends true ? {} : keyof T extends never ? {
 /** Check if router tree contains any $param properties. */
 type HasParams<Path extends string[]> = Path extends [infer Head, ...infer Rest extends string[]] ? Head extends `$${string}` ? true : HasParams<Rest> : false;
 /** Extract the MethodEntry part from a union type. */
-type ExtractMethod<T> = Extract<T, RouteDefinition<any, any, any, any, any> | ((...args: unknown[]) => unknown)>;
+type ExtractMethod<T> = T extends RouteDefinition<infer _Q, infer _B, infer _R, infer _P, infer _Ctx> ? T : T extends ((...args: never[]) => unknown) ? T : never;
 /** Remove string/number index signatures from a type. */
 type RemoveIndex<T> = { [K in keyof T as string extends K ? never : number extends K ? never : K]: T[K] };
 /** Header value that can be static or dynamic. */
@@ -116,8 +116,8 @@ interface BaseRequestOptions {
 /** Full request options including client-specific extras. */
 type RequestOptions<Extra> = BaseRequestOptions & Extra;
 /** Build options type based on whether path params are needed. */
-type BuildOptions<HasPathParams extends boolean, Q$1, B$1, Extra> = HasPathParams extends true ? {
-  path: Record<string, string>;
+type BuildOptions<Path extends string[], Q$1, B$1, Extra> = HasParams<Path> extends true ? {
+  path: CollectPathParams<Path>;
 } & (RequiresProperty<Q$1> extends true ? {
   query?: Q$1;
 } : {}) & (RequiresProperty<B$1> extends true ? {
@@ -128,19 +128,33 @@ type BuildOptions<HasPathParams extends boolean, Q$1, B$1, Extra> = HasPathParam
   body: B$1;
 } : {}) & Extra;
 /** Client type for a method entry (route or bare function). */
-type MethodClient<T, Extra, HasPathParams extends boolean = false> = T extends RouteDefinition<infer Q, infer B, infer R, any, any> ? (options?: BuildOptions<HasPathParams, SafeInferSchema<Q>, SafeInferSchema<B>, Extra>) => Promise<R> : T extends ((...args: unknown[]) => unknown) ? (options?: BuildOptions<HasPathParams, {}, {}, Extra>) => Promise<ExtractReturn<T>> : never;
+type MethodClient<T, Extra, Path extends string[] = []> = T extends RouteDefinition<infer Q, infer B, infer R, infer _P, infer _Ctx> ? (options?: BuildOptions<Path, SafeInferSchema<Q>, SafeInferSchema<B>, Extra>) => Promise<R> : T extends ((...args: never[]) => unknown) ? (options?: BuildOptions<Path, {}, {}, Extra>) => Promise<ExtractReturn<T>> : never;
 /** Helper to extract return type for implicit GET calls. */
-type ImplicitGetCall<T extends RouterRoutes, Extra, Path extends string[] = []> = 'get' extends keyof T ? ExtractMethod<T['get']> extends RouteDefinition<infer _Q, infer _B, infer R, any, any> ? HasParams<Path> extends true ? (options: {
-  path: Record<string, string>;
+type ImplicitGetCall<T extends RouterRoutes, Extra, Path extends string[] = []> = 'get' extends keyof T ? ExtractMethod<T['get']> extends RouteDefinition<infer _Q, infer _B, infer R, infer _P, infer _Ctx> ? HasParams<Path> extends true ? (options: {
+  path: CollectPathParams<Path>;
 } & {
   query?: Record<string, unknown>;
-} & Extra) => Promise<R> : (options?: RequestOptions<Extra>) => Promise<R> : ExtractMethod<T['get']> extends ((...args: unknown[]) => unknown) ? HasParams<Path> extends true ? (options: {
-  path: Record<string, string>;
+} & Extra) => Promise<R> : (options?: RequestOptions<Extra>) => Promise<R> : ExtractMethod<T['get']> extends ((...args: never[]) => unknown) ? HasParams<Path> extends true ? (options: {
+  path: CollectPathParams<Path>;
 } & {
   query?: Record<string, unknown>;
 } & Extra) => Promise<ExtractReturn<ExtractMethod<T['get']>>> : (options?: RequestOptions<Extra>) => Promise<ExtractReturn<ExtractMethod<T['get']>>> : (options?: RequestOptions<Extra>) => Promise<unknown> : (options?: RequestOptions<Extra>) => Promise<unknown>;
+/**
+ * Builds a URL string from the route path without executing a request.
+ *
+ * Path params are required when the path contains `$param` segments. Query
+ * params are always optional and untyped, since `$url` is method-agnostic.
+ */
+type UrlMethod<Path extends string[]> = HasParams<Path> extends true ? (options: {
+  path: CollectPathParams<Path>;
+  query?: Record<string, unknown>;
+}) => string : (options?: {
+  query?: Record<string, unknown>;
+}) => string;
 /** Client type for a router. */
-type RouterClient<T extends RouterRoutes, Extra, Path extends string[] = []> = { [K in keyof RemoveIndex<T> as K extends LowercaseMethods ? PrefixedMethod<K> : never]: ExtractMethod<T[K]> extends infer M ? M extends RouteDefinition<any, any, any, any, any> | ((...args: unknown[]) => unknown) ? MethodClient<M, Extra, HasParams<Path>> : never : never } & { [K in keyof RemoveIndex<T>]: IsAny<T[K]> extends true ? never : Extract<T[K], Router<any>> extends infer R ? R extends Router<infer Routes> ? RouterClient<Routes, Extra, [...Path, K & string]> & ImplicitGetCall<Routes, Extra, [...Path, K & string]> : never : never } & ImplicitGetCall<T, Extra, Path>;
+type RouterClient<T extends RouterRoutes, Extra, Path extends string[] = []> = {
+  $url: UrlMethod<Path>;
+} & { [K in keyof RemoveIndex<T> as K extends LowercaseMethods ? PrefixedMethod<K> : never]: MethodClient<ExtractMethod<T[K]>, Extra, Path> } & { [K in keyof RemoveIndex<T>]: IsAny<T[K]> extends true ? never : Extract<T[K], Router<RouterRoutes>> extends infer R ? R extends Router<infer Routes> ? RouterClient<Routes, Extra, [...Path, K & string]> & ImplicitGetCall<Routes, Extra, [...Path, K & string]> : never : never } & ImplicitGetCall<T, Extra, Path>;
 //#endregion
 //#region src/http-client.d.ts
 /** HTTP client configuration. */
@@ -197,6 +211,18 @@ type HttpClient<T extends Router<RouterRoutes>> = {
  * // GET /api/get
  * await client.api.get.$get();
  * ```
+ *
+ * @example Router built by a dependency-injected factory:
+ * ```typescript
+ * import type { createServer } from './server';
+ * import { createHttpClient } from '@fresho/router';
+ *
+ * type Api = ReturnType<typeof createServer>['api'];
+ *
+ * const client = createHttpClient<Api>({
+ *   baseUrl: 'https://api.example.com',
+ * });
+ * ```
  */
 declare function createHttpClient<T extends Router<RouterRoutes>>(config?: HttpClientConfig): HttpClient<T>;
 //#endregion
@@ -246,10 +272,14 @@ declare function createLocalClient<T extends Router<RouterRoutes>>(routerDef: T)
  * ```typescript
  * import { router, sseResponse, streamJsonLines } from '@fresho/router';
  *
+ * interface Events {
+ *   tick: { count: number };
+ * }
+ *
  * const api = router({
  *   // SSE for real-time updates
  *   events: router({
- *     get: async () => sseResponse(async (send, close) => {
+ *     get: async () => sseResponse<Events>(async (send, close) => {
  *       for (let i = 0; i < 10; i++) {
  *         send({ event: 'tick', data: { count: i } });
  *         await sleep(1000);
@@ -280,27 +310,77 @@ interface SSEOptions {
   keepAliveInterval?: number;
 }
 /**
- * Server-Sent Event message structure.
+ * Data supported by an SSE message.
  */
-interface SSEMessage {
-  /** Event type (optional). */
-  event?: string;
-  /** Event data. */
-  data: string | object;
+type SSEData = string | object;
+/**
+ * Untyped map of SSE event names to their payloads.
+ *
+ * Define a narrower map and pass it to {@link sseResponse} to type-check event
+ * names and their corresponding data.
+ */
+type SSEEventMap = Record<string, SSEData>;
+type ValidSSEEventMap<Events$1> = { [Name in keyof Events$1]: SSEData };
+interface SSEMessageMetadata {
   /** Event ID (optional). */
   id?: string;
   /** Retry interval hint for client (optional). */
   retry?: number;
 }
+/**
+ * Server-Sent Event message structure without a typed event map.
+ */
+interface SSEMessage extends SSEMessageMetadata {
+  /** Event type (optional). */
+  event?: string;
+  /** Event data. */
+  data: SSEData;
+}
+type NamedSSEMessage<Events$1> = { [Name in Exclude<keyof Events$1 & string, 'message'>]: {
+  event: Name;
+  data: Events$1[Name];
+} }[Exclude<keyof Events$1 & string, 'message'>];
+type DefaultSSEMessage<Events$1> = 'message' extends keyof Events$1 ? {
+  /** Omit the event name to dispatch the default `message` event. */
+  event?: 'message';
+  data: Events$1['message'];
+} : never;
+/**
+ * Server-Sent Event message structure.
+ *
+ * For a typed event map, each event name is coupled to its payload type. Use
+ * the reserved `message` key to type messages that omit the `event` field.
+ */
+type SSEEventMessage<Events$1 extends ValidSSEEventMap<Events$1>> = (string extends keyof Events$1 ? SSEMessage : NamedSSEMessage<Events$1> | DefaultSSEMessage<Events$1>) & SSEMessageMetadata;
+declare const SSE_EVENTS: unique symbol;
+/**
+ * Response carrying its SSE event map at the type level.
+ */
+type SSEResponse<Events$1 extends ValidSSEEventMap<Events$1> = SSEEventMap> = Response & {
+  readonly [SSE_EVENTS]: Events$1;
+};
+/**
+ * Extracts the event map carried by an SSE response or typed client method.
+ *
+ * @example
+ * ```typescript
+ * type Events = SSEEventsOf<ReturnType<typeof client.events>>;
+ * ```
+ */
+type SSEEventsOf<T> = Awaited<T> extends SSEResponse<infer Events> ? Events : never;
 /**
  * Creates a Server-Sent Events (SSE) response.
  *
  * @example
  * ```typescript
+ * interface CounterEvents {
+ *   tick: { count: number };
+ * }
+ *
  * const handler = async (c) => {
- *   return sseResponse(async (send, close) => {
+ *   return sseResponse<CounterEvents>(async (send, close) => {
  *     for (let i = 0; i < 5; i++) {
- *       await send({ data: { count: i } });
+ *       send({ event: 'tick', data: { count: i } });
  *       await new Promise(r => setTimeout(r, 1000));
  *     }
  *     close();
@@ -308,7 +388,7 @@ interface SSEMessage {
  * };
  * ```
  */
-declare function sseResponse(handler: (send: (message: SSEMessage) => void, close: () => void) => void | Promise<void>, options?: SSEOptions): Response;
+declare function sseResponse<Events$1 extends ValidSSEEventMap<Events$1> = SSEEventMap>(handler: (send: (message: SSEEventMessage<Events$1>) => void, close: () => void) => void | Promise<void>, options?: SSEOptions): SSEResponse<Events$1>;
 /**
  * Creates a streaming JSON response where each line is a JSON object.
  *
@@ -331,5 +411,5 @@ declare function streamJsonLines(handler: (send: (data: object) => void, close:
   headers?: HeadersInit;
 }): Response;
 //#endregion
-export { type CollectPathParams, type CompiledSchema, type Context, type ExecutionContext, type FetchHandler, type HttpClient, type HttpClientConfig, type HttpRequestOptions, type InferSchema, type LocalClient, type LocalClientConfig, type LocalRequestOptions, type Method, type MethodEntry, type Middleware, type MiddlewareContext, type MiddlewareNext, type RouteDefinition, type Router, type RouterBrand, type RouterRoutes, type SSEMessage, type SSEOptions, type SchemaDefinition, type SchemaType, type SchemaTypeMap, type TypedHandler, type TypedResponse, type ValidationResult, compileSchema, createHttpClient, createLocalClient, generateDocs, isFunction, isRoute, isRouter, route, router, runMiddleware, sseResponse, streamJsonLines };
+export { type CollectPathParams, type CompiledSchema, type Context, type ExecutionContext, type FetchHandler, type HttpClient, type HttpClientConfig, type HttpRequestOptions, type InferSchema, type LocalClient, type LocalClientConfig, type LocalRequestOptions, type Method, type MethodEntry, type Middleware, type MiddlewareContext, type MiddlewareNext, type RouteDefinition, type Router, type RouterBrand, type RouterRoutes, type SSEData, type SSEEventMap, type SSEEventMessage, type SSEEventsOf, type SSEMessage, type SSEOptions, type SSEResponse, type SchemaDefinition, type SchemaType, type SchemaTypeMap, type TypedHandler, type TypedResponse, type ValidationResult, compileSchema, createHttpClient, createLocalClient, generateDocs, isFunction, isRoute, isRouter, route, router, runMiddleware, sseResponse, streamJsonLines };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/core.ts","../src/docs.ts","../src/client-types.ts","../src/http-client.ts","../src/local-client.ts","../src/streaming.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/core.ts","../src/docs.ts","../src/client-types.ts","../src/http-client.ts","../src/local-client.ts","../src/streaming.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/index.mjs

@@ -706,6 +706,7 @@ function createRecursiveProxy(config, segments = []) {
 		get(_target, prop) {
 			if (typeof prop !== "string") return void 0;
 			if (prop === "apply" || prop === "call" || prop === "bind" || prop === "toString" || prop === "toJSON") return _target[prop];
+			if (prop === "$url" && config.onBuildUrl) return (options) => config.onBuildUrl(segments, options);
 			if (PREFIXED_HTTP_METHODS.has(prop)) {
 				const method = prop.slice(1);
 				return (options) => {
@@ -720,6 +721,22 @@ function createRecursiveProxy(config, segments = []) {
 	});
 }
 
+//#endregion
+//#region src/client-response.ts
+const STREAMING_CONTENT_TYPES = new Set([
+	"text/event-stream",
+	"application/x-ndjson",
+	"application/ndjson"
+]);
+/**
+* Parses ordinary client responses as JSON while preserving streaming bodies.
+*/
+async function parseClientResponse(response, raw = false) {
+	const contentType = response.headers.get("Content-Type")?.split(";", 1)[0].trim().toLowerCase();
+	if (raw || contentType && STREAMING_CONTENT_TYPES.has(contentType)) return response;
+	return response.json();
+}
+
 //#endregion
 //#region src/http-client.ts
 /**
@@ -795,15 +812,30 @@ const BODY_METHODS = new Set([
 * // GET /api/get
 * await client.api.get.$get();
 * ```
+*
+* @example Router built by a dependency-injected factory:
+* ```typescript
+* import type { createServer } from './server';
+* import { createHttpClient } from '@fresho/router';
+*
+* type Api = ReturnType<typeof createServer>['api'];
+*
+* const client = createHttpClient<Api>({
+*   baseUrl: 'https://api.example.com',
+* });
+* ```
 */
 function createHttpClient(config = {}) {
 	const sharedConfig = { current: { ...config } };
 	const client = { configure(newConfig) {
 		Object.assign(sharedConfig.current, newConfig);
 	} };
-	const proxy = createRecursiveProxy({ onRequest: (segments, method, options) => {
-		return executeRequest(sharedConfig, segments, method, options);
-	} });
+	const proxy = createRecursiveProxy({
+		onRequest: (segments, method, options) => {
+			return executeRequest(sharedConfig, segments, method, options);
+		},
+		onBuildUrl: (segments, options) => buildUrl(sharedConfig.current, segments, options)
+	});
 	return new Proxy(client, {
 		get(target, prop) {
 			if (prop === "configure") return target.configure;
@@ -825,15 +857,24 @@ function buildPath(segments, pathParams) {
 	} else parts.push(segment);
 	return `/${parts.join("/")}`;
 }
-/** Executes an HTTP request. */
-async function executeRequest(sharedConfig, segments, method, options) {
-	const config = sharedConfig.current;
+/**
+* Builds a URL string from path segments and options without executing a request.
+*
+* Returns an absolute URL when a `baseUrl` is configured, otherwise a relative
+* `pathname + search` string suitable for same-origin fetches.
+*/
+function buildUrl(config, segments, options) {
 	const path = buildPath(segments, options?.path);
 	const baseUrl = config.baseUrl || (typeof window !== "undefined" ? window.location?.origin : "");
 	const url = new URL(path, baseUrl || "http://localhost");
 	if (options?.query) {
 		for (const [key, value] of Object.entries(options.query)) if (value !== void 0) url.searchParams.set(key, String(value));
 	}
+	return config.baseUrl ? url.toString() : url.pathname + url.search;
+}
+/** Executes an HTTP request. */
+async function executeRequest(sharedConfig, segments, method, options) {
+	const config = sharedConfig.current;
 	const headers = new Headers();
 	if (config.headers) for (const [key, value] of Object.entries(config.headers)) {
 		const resolved = typeof value === "function" ? await value() : value;
@@ -849,11 +890,10 @@ async function executeRequest(sharedConfig, segments, method, options) {
 		headers.set("Content-Type", "application/json");
 		init.body = JSON.stringify(options.body);
 	}
-	const fetchUrl = config.baseUrl ? url.toString() : url.pathname + url.search;
+	const fetchUrl = buildUrl(config, segments, options);
 	const response = await (config.fetch || fetch)(fetchUrl, init);
 	if (!response.ok) throw new Error(await response.text() || response.statusText);
-	if (options?.raw) return response;
-	return response.json();
+	return parseClientResponse(response, options?.raw);
 }
 
 //#endregion
@@ -938,9 +978,12 @@ function createLocalClient(routerDef) {
 	const client = { configure(config) {
 		Object.assign(sharedConfig.current, config);
 	} };
-	const proxy = createRecursiveProxy({ onRequest: (segments, method, options) => {
-		return invokeHandler(sharedConfig, routerDef, segments, method, options);
-	} });
+	const proxy = createRecursiveProxy({
+		onRequest: (segments, method, options) => {
+			return invokeHandler(sharedConfig, routerDef, segments, method, options);
+		},
+		onBuildUrl: (segments, options) => buildLocalUrl(segments, options)
+	});
 	return new Proxy(client, {
 		get(target, prop) {
 			if (prop === "configure") return target.configure;
@@ -951,6 +994,21 @@ function createLocalClient(routerDef) {
 		}
 	});
 }
+/**
+* Builds a relative URL string from path segments and options.
+*
+* The local client has no baseUrl, so it returns a relative `pathname + search`
+* string. Mirrors the synthetic URL construction used in {@link invokeHandler}.
+*/
+function buildLocalUrl(segments, options) {
+	const pathParams = collectPathParams(segments, options?.path);
+	const pathParts = segments.map((s) => s.startsWith("$") ? encodeURIComponent(pathParams[s.slice(1)]) : s);
+	const url = new URL(`/${pathParts.join("/")}`, "http://localhost");
+	if (options?.query) {
+		for (const [key, value] of Object.entries(options.query)) if (value !== void 0) url.searchParams.set(key, String(value));
+	}
+	return url.pathname + url.search;
+}
 /** Invokes a handler directly. */
 async function invokeHandler(sharedConfig, routerDef, segments, method, options) {
 	const config = sharedConfig.current;
@@ -992,7 +1050,7 @@ async function invokeHandler(sharedConfig, routerDef, segments, method, options)
 		executionCtx: options?.ctx ?? config.ctx
 	};
 	const result = await routeInfo.handler(context);
-	if (result instanceof Response) return result.json();
+	if (result instanceof Response) return parseClientResponse(result);
 	return result;
 }
 
@@ -1015,10 +1073,14 @@ function formatSSEMessage(message) {
 *
 * @example
 * ```typescript
+* interface CounterEvents {
+*   tick: { count: number };
+* }
+*
 * const handler = async (c) => {
-*   return sseResponse(async (send, close) => {
+*   return sseResponse<CounterEvents>(async (send, close) => {
 *     for (let i = 0; i < 5; i++) {
-*       await send({ data: { count: i } });
+*       send({ event: 'tick', data: { count: i } });
 *       await new Promise(r => setTimeout(r, 1000));
 *     }
 *     close();