@firtoz/hono-fetcher 2.3.1 → 2.4.0

package/README.md

@@ -6,6 +6,8 @@
 
 Type-safe Hono API client with full TypeScript inference for routes, params, and payloads.
 
+> **⚠️ Early WIP Notice:** This package is in very early development and is **not production-ready**. It is TypeScript-only and may have breaking changes. While I (the maintainer) have limited time, I'm open to PRs for features, bug fixes, or additional support (like JS builds). Please feel free to try it out and contribute! See [CONTRIBUTING.md](../../CONTRIBUTING.md) for details.
+
 ## Features
 
 - 🔒 **Fully Type-Safe** - Complete TypeScript inference for routes, parameters, request bodies, and responses

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@firtoz/hono-fetcher",
-	"version": "2.3.1",
+	"version": "2.4.0",
 	"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.20251008.0",
-		"hono": "^4.10.1"
+		"@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.5",
-		"@hono/zod-validator": "^0.7.4",
-		"bun-types": "^1.3.0",
-		"zod": "^4.1.12"
+		"@hono/node-server": "^1.19.11",
+		"@hono/zod-validator": "^0.7.6",
+		"bun-types": "^1.3.11",
+		"zod": "^4.3.6"
 	}
 }

package/src/honoFetcher.ts

@@ -33,14 +33,49 @@ 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}`;
+}
+
 type FetcherParams<SchemaPath extends string> =
 	HasPathParams<SchemaPath> extends true
 		? {
 				params: ParsePathParams<SchemaPath>;
+				query?: HonoFetcherQueryParams;
 				init?: RequestInit;
 			}
 		: {
 				params?: never;
+				query?: HonoFetcherQueryParams;
 				init?: RequestInit;
 			};
 
@@ -136,7 +171,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 +179,8 @@ const createMethodFetcher = <T extends Hono, M extends HttpMethod>(
 			}, finalUrl);
 		}
 
+		finalUrl = appendQueryString(finalUrl, query);
+
 		const requestAsOptionalFormBody = request as {
 			form?: unknown;
 			body?: unknown;
@@ -193,7 +230,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 +239,8 @@ const createWebSocketFetcher = <T extends Hono>(
 			}, finalUrl);
 		}
 
+		finalUrl = appendQueryString(finalUrl, query);
+
 		const newHeaders = new Headers(
 			init.headers as unknown as ConstructorParameters<typeof Headers>[0],
 		);

package/src/index.ts

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