@firtoz/hono-fetcher 1.0.0 → 2.0.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
@@ -25,12 +29,14 @@ This package requires the following peer dependencies:
 bun add hono
 ```
 
-For Durable Object support:
+For Durable Object support, use `wrangler types` to generate accurate types:
 
 ```bash
-bun add @cloudflare/workers-types
+wrangler types
 ```
 
+This generates `worker-configuration.d.ts` with types for your specific environment bindings.
+
 ## Quick Start
 
 ### Basic Usage
@@ -70,11 +76,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 +108,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';
 
@@ -106,11 +131,11 @@ export class ChatRoomDO extends DurableObject {
 // In your worker
 export default {
   async fetch(request: Request, env: Env): Promise<Response> {
-    // Option 1: From a stub
-    const stub = env.CHAT_ROOM.get(env.CHAT_ROOM.idFromName('room-1'));
+    // Option 1: From a stub (using new getByName API)
+    const stub = env.CHAT_ROOM.getByName('room-1');
     const api = honoDoFetcher(stub);
     
-    // Option 2: Directly with name
+    // Option 2: Directly with name (recommended)
     const api2 = honoDoFetcherWithName(env.CHAT_ROOM, 'room-1');
     
     // Use it!
@@ -140,6 +165,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:
@@ -253,7 +305,7 @@ await api.get({
 Creates a typed fetcher for a Durable Object stub.
 
 ```typescript
-const stub = env.MY_DO.get(env.MY_DO.idFromName('example'));
+const stub = env.MY_DO.getByName('example');
 const api = honoDoFetcher(stub);
 
 await api.get({ url: '/status' });
@@ -318,7 +370,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": "2.0.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",
-		"bun-types": "^1.2.23",
-		"zod": "^3.24.1"
+		"@hono/node-server": "^1.19.5",
+		"@hono/zod-validator": "^0.7.4",
+		"bun-types": "^1.3.0",
+		"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/honoDoFetcher.ts

@@ -44,7 +44,7 @@ export const honoDoFetcherWithName = <
 	namespace: DurableObjectNamespace<T>,
 	name: string,
 ): TypedDoFetcher<DurableObjectStub<T>> => {
-	return honoDoFetcher(namespace.get(namespace.idFromName(name)));
+	return honoDoFetcher(namespace.getByName(name));
 };
 
 export const honoDoFetcherWithId = <

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";