@firtoz/hono-fetcher 2.3.2 → 2.4.1

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@firtoz/hono-fetcher",
-	"version": "2.3.2",
+	"version": "2.4.1",
 	"description": "Type-safe Hono API client with full TypeScript inference for routes, params, and payloads",
 	"main": "./src/index.ts",
 	"module": "./src/index.ts",
@@ -23,7 +23,7 @@
 		"README.md"
 	],
 	"scripts": {
-		"typecheck": "tsc --noEmit -p ./tsconfig.json",
+		"typecheck": "tsgo --noEmit -p ./tsconfig.json",
 		"lint": "biome check --write src",
 		"lint:ci": "biome ci src",
 		"format": "biome format src --write",
@@ -52,8 +52,8 @@
 		"url": "https://github.com/firtoz/fullstack-toolkit/issues"
 	},
 	"peerDependencies": {
-		"@cloudflare/workers-types": "^4.20251228.0",
-		"hono": "^4.11.4"
+		"@cloudflare/workers-types": "^4.20260329.1",
+		"hono": "^4.12.9"
 	},
 	"engines": {
 		"node": ">=18.0.0"
@@ -62,9 +62,9 @@
 		"access": "public"
 	},
 	"devDependencies": {
-		"@hono/node-server": "^1.19.9",
+		"@hono/node-server": "^1.19.11",
 		"@hono/zod-validator": "^0.7.6",
-		"bun-types": "^1.3.6",
-		"zod": "^4.3.5"
+		"bun-types": "^1.3.11",
+		"zod": "^4.3.6"
 	}
 }

package/src/honoFetcher.ts

@@ -33,14 +33,59 @@ type HasPathParams<T extends string> = T extends `${string}:${string}`
 	? true
 	: false;
 
+/**
+ * Values allowed in the optional `query` object on fetcher requests.
+ * `null` and `undefined` entries are omitted from the serialized query string.
+ */
+export type HonoFetcherQueryParamValue = string | number | boolean;
+
+export type HonoFetcherQueryParams = Record<
+	string,
+	HonoFetcherQueryParamValue | null | undefined
+>;
+
+function appendQueryString(
+	url: string,
+	query?: HonoFetcherQueryParams,
+): string {
+	if (!query) {
+		return url;
+	}
+	const searchParams = new URLSearchParams();
+	for (const [key, value] of Object.entries(query)) {
+		if (value === undefined || value === null) {
+			continue;
+		}
+		searchParams.append(key, String(value));
+	}
+	const serialized = searchParams.toString();
+	if (!serialized) {
+		return url;
+	}
+	const separator = url.includes("?") ? "&" : "?";
+	return `${url}${separator}${serialized}`;
+}
+
+/**
+ * `RequestInit` fields that honoFetcher sets must not be overwritten by spreading `...init` last.
+ */
+function restOfRequestInit(
+	init: RequestInit,
+): Omit<RequestInit, "headers" | "body" | "method"> {
+	const { headers: _h, body: _b, method: _m, ...rest } = init;
+	return rest;
+}
+
 type FetcherParams<SchemaPath extends string> =
 	HasPathParams<SchemaPath> extends true
 		? {
 				params: ParsePathParams<SchemaPath>;
+				query?: HonoFetcherQueryParams;
 				init?: RequestInit;
 			}
 		: {
 				params?: never;
+				query?: HonoFetcherQueryParams;
 				init?: RequestInit;
 			};
 
@@ -136,7 +181,7 @@ const createMethodFetcher = <T extends Hono, M extends HttpMethod>(
 	return (async (request) => {
 		let finalUrl: string = request.url;
 
-		const { init = {}, params } = request;
+		const { init = {}, params, query } = request;
 
 		if (params && typeof params === "object") {
 			finalUrl = Object.entries(params).reduce((acc, [key, value]) => {
@@ -144,6 +189,8 @@ const createMethodFetcher = <T extends Hono, M extends HttpMethod>(
 			}, finalUrl);
 		}
 
+		finalUrl = appendQueryString(finalUrl, query);
+
 		const requestAsOptionalFormBody = request as {
 			form?: unknown;
 			body?: unknown;
@@ -172,10 +219,10 @@ const createMethodFetcher = <T extends Hono, M extends HttpMethod>(
 
 		try {
 			return await fetcher(finalUrl, {
+				...restOfRequestInit(init),
 				method: method.toUpperCase(),
 				headers: newHeaders,
 				...(body ? { body } : {}),
-				...init,
 			});
 		} catch (error) {
 			console.error(`Error ${method}ing`, error);
@@ -193,7 +240,7 @@ const createWebSocketFetcher = <T extends Hono>(
 	return (async (request) => {
 		let finalUrl: string = request.url;
 
-		const { init = {}, params, config } = request;
+		const { init = {}, params, query, config } = request;
 		const autoAccept = config?.autoAccept ?? true; // Default to true
 
 		if (params && typeof params === "object") {
@@ -202,6 +249,8 @@ const createWebSocketFetcher = <T extends Hono>(
 			}, finalUrl);
 		}
 
+		finalUrl = appendQueryString(finalUrl, query);
+
 		const newHeaders = new Headers(
 			init.headers as unknown as ConstructorParameters<typeof Headers>[0],
 		);
@@ -209,9 +258,9 @@ const createWebSocketFetcher = <T extends Hono>(
 
 		try {
 			const response = await fetcher(finalUrl, {
+				...restOfRequestInit(init),
 				method: "GET",
 				headers: newHeaders,
-				...init,
 			});
 
 			// Auto-accept the WebSocket if configured (default: true)

package/src/index.ts

@@ -14,6 +14,8 @@ export {
 // Core fetcher functionality
 export {
 	type BaseTypedHonoFetcher,
+	type HonoFetcherQueryParamValue,
+	type HonoFetcherQueryParams,
 	type HonoSchemaKeys,
 	type HttpMethod,
 	honoFetcher,