@firtoz/hono-fetcher 1.0.0 → 1.1.0

package/README.md

@@ -1,5 +1,9 @@
 # @firtoz/hono-fetcher
 
+[![npm version](https://img.shields.io/npm/v/%40firtoz%2Fhono-fetcher.svg)](https://www.npmjs.com/package/@firtoz/hono-fetcher)
+[![npm downloads](https://img.shields.io/npm/dm/%40firtoz%2Fhono-fetcher.svg)](https://www.npmjs.com/package/@firtoz/hono-fetcher)
+[![license](https://img.shields.io/npm/l/%40firtoz%2Fhono-fetcher.svg)](https://github.com/firtoz/fullstack-toolkit/blob/main/LICENSE)
+
 Type-safe Hono API client with full TypeScript inference for routes, params, and payloads.
 
 ## Features
@@ -70,11 +74,30 @@ await api.post({
 
 ### Remote API Usage
 
+For remote APIs, you have two options:
+
+#### Option 1: Using `honoDirectFetcher` (Recommended)
+
+```typescript
+import { honoDirectFetcher } from '@firtoz/hono-fetcher';
+import type { AppType } from './backend/app'; // Your backend app type
+
+// Simply pass the base URL
+const api = honoDirectFetcher<AppType>('https://api.example.com');
+
+// Use it immediately
+const response = await api.get({
+  url: '/users/:id',
+  params: { id: '123' }
+});
+```
+
+#### Option 2: Using `honoFetcher` with Custom Fetch
+
 ```typescript
 import { honoFetcher } from '@firtoz/hono-fetcher';
 
-// For a remote API, you need to define the app type
-// (Usually exported from your backend)
+// For more control over the fetch behavior
 const api = honoFetcher<typeof app>((url, init) => {
   return fetch(`https://api.example.com${url}`, init);
 });
@@ -83,7 +106,7 @@ const api = honoFetcher<typeof app>((url, init) => {
 ### Durable Objects
 
 ```typescript
-import { honoDoFetcher, honoDoFetcherWithName } from '@firtoz/hono-fetcher/honoDoFetcher';
+import { honoDoFetcher, honoDoFetcherWithName } from '@firtoz/hono-fetcher';
 import { DurableObject } from 'cloudflare:workers';
 import { Hono } from 'hono';
 
@@ -140,6 +163,33 @@ A typed fetcher with methods for each HTTP verb: `get`, `post`, `put`, `delete`,
 const api = honoFetcher<typeof app>(app.request);
 ```
 
+### `honoDirectFetcher<T>(baseUrl)`
+
+Convenience wrapper around `honoFetcher` for remote APIs. Automatically prepends the base URL to all requests.
+
+#### Parameters
+
+- `baseUrl: string` - The base URL of your API (e.g., `'https://api.example.com'`)
+
+#### Returns
+
+A typed fetcher with methods for each HTTP verb: `get`, `post`, `put`, `delete`, `patch`
+
+#### Example
+
+```typescript
+import { honoDirectFetcher } from '@firtoz/hono-fetcher';
+import type { AppType } from './backend/app';
+
+const api = honoDirectFetcher<AppType>('https://api.example.com');
+
+// Make requests
+const response = await api.get({
+  url: '/users/:id',
+  params: { id: '123' }
+});
+```
+
 ### Method Signature
 
 All methods follow this signature:
@@ -318,7 +368,7 @@ type Params = ParsePathParams<'/users/:id/posts/:postId'>;
 Type for Durable Objects that expose a Hono app.
 
 ```typescript
-import type { DOWithHonoApp } from '@firtoz/hono-fetcher/honoDoFetcher';
+import type { DOWithHonoApp } from '@firtoz/hono-fetcher';
 
 export class MyDO extends DurableObject implements DOWithHonoApp {
   app = new Hono()

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@firtoz/hono-fetcher",
-	"version": "1.0.0",
+	"version": "1.1.0",
 	"description": "Type-safe Hono API client with full TypeScript inference for routes, params, and payloads",
 	"main": "./src/index.ts",
 	"module": "./src/index.ts",
@@ -24,7 +24,8 @@
 	],
 	"scripts": {
 		"typecheck": "tsc --noEmit",
-		"lint": "biome lint src --write",
+		"lint": "biome check --write src",
+		"lint:ci": "biome ci src",
 		"format": "biome format src --write",
 		"test": "bun test",
 		"test:watch": "bun test --watch"
@@ -51,8 +52,8 @@
 		"url": "https://github.com/firtoz/fullstack-toolkit/issues"
 	},
 	"peerDependencies": {
-		"@cloudflare/workers-types": "^4.20251004.0",
-		"hono": "^4.9.9"
+		"@cloudflare/workers-types": "^4.20251008.0",
+		"hono": "^4.9.10"
 	},
 	"engines": {
 		"node": ">=18.0.0"
@@ -61,9 +62,9 @@
 		"access": "public"
 	},
 	"devDependencies": {
-		"@hono/node-server": "^1.14.1",
-		"@hono/zod-validator": "^0.4.1",
+		"@hono/node-server": "^1.19.5",
+		"@hono/zod-validator": "^0.7.3",
 		"bun-types": "^1.2.23",
-		"zod": "^3.24.1"
+		"zod": "^4.1.12"
 	}
 }

package/src/honoDirectFetcher.ts

@@ -0,0 +1,10 @@
+import type { Hono } from "hono";
+import { honoFetcher, type TypedHonoFetcher } from "./honoFetcher";
+
+export const honoDirectFetcher = <T extends Hono>(
+	baseUrl: string,
+): TypedHonoFetcher<T> => {
+	return honoFetcher<T>((request, init) => {
+		return fetch(`${baseUrl}${request}`, init) as ReturnType<T["request"]>;
+	});
+};

package/src/index.ts

@@ -1,19 +1,23 @@
+// Convenience wrapper for direct HTTP fetching
+export { honoDirectFetcher } from "./honoDirectFetcher";
+// Durable Object integration
+export {
+	type DOSchemaKeys,
+	type DOSchemaMap,
+	type DOStubSchema,
+	type DOWithHonoApp,
+	honoDoFetcher,
+	honoDoFetcherWithId,
+	honoDoFetcherWithName,
+	type TypedDoFetcher,
+} from "./honoDoFetcher";
+// Core fetcher functionality
 export {
-	honoFetcher,
 	type BaseTypedHonoFetcher,
 	type HonoSchemaKeys,
 	type HttpMethod,
+	honoFetcher,
 	type JsonResponse,
 	type ParsePathParams,
 	type TypedHonoFetcher,
 } from "./honoFetcher";
-export {
-	honoDoFetcher,
-	honoDoFetcherWithId,
-	honoDoFetcherWithName,
-	type DOSchemaKeys,
-	type DOSchemaMap,
-	type DOStubSchema,
-	type DOWithHonoApp,
-	type TypedDoFetcher,
-} from "./honoDoFetcher";