@firtoz/hono-fetcher 2.7.2 → 2.8.1

package/README.md

@@ -136,7 +136,7 @@ export class ChatRoomDO extends DurableObject {
 }
 
 // `using api` disposes the stub. Returning the DO `Response` directly is a common pass-through pattern;
-// if you consume the body in this worker instead, also dispose the RPC result (e.g. `using res`).
+// do not `using res` when you return the value to the client (see disposal section below).
 // See https://developers.cloudflare.com/workers/runtime-apis/rpc/lifecycle/
 export default {
   async fetch(request: Request, env: Env): Promise<Response> {
@@ -468,7 +468,7 @@ Cloudflare Workers RPC gives **separate disposers** for the **Durable Object stu
 
 - **Stub (`using api = honoDoFetcherWithName(...)`):** Releases the **stub** when the block ends. This does **not** release RPC **`Response`** objects from individual requests.
 - **Response (HTTP / WebSocket upgrade):** On a **real stub** (`TypedDoFetcher`), TypeScript types those results as **`Disposable`** so **`using res`** / **`using wsRes`** is valid. At runtime, **`[Symbol.dispose]`** is present when Workers RPC attaches it (often in production); **minimal `fetch`-only mocks** are typed as **non-**`Disposable` **`Response`**s because disposers are usually absent. Prefer **`using res`** when types allow it; otherwise call **`res[Symbol.dispose]()`** or use a **`DisposableStack`** as described in Cloudflare’s **[Workers RPC lifecycle](https://developers.cloudflare.com/workers/runtime-apis/rpc/lifecycle/)** documentation. Reading the body does **not** implicitly dispose the RPC result in this library.
-- **Returning `Response` to the client:** **Do not** use **`using res`** on a response you **`return`** from your Worker—disposal can run on scope exit before the runtime finishes serving it. Return the value directly; see **[Workers RPC lifecycle](https://developers.cloudflare.com/workers/runtime-apis/rpc/lifecycle/)** for pass-through patterns.
+- **Returning `Response` to the client:** **Do not** use **`using res`** on a response you **`return`** from your Worker—disposal can run on scope exit before the runtime finishes serving it. Return the value directly (`return api.get(...)`). In **local dev** (Miniflare, Alchemy), RPC responses may **not** implement **`Symbol.dispose`** even when TypeScript types them as **`Disposable`** — **`using res = await …`** can throw **`TypeError: Object not disposable`**. Prefer **`using api`** on the stub only and **`const res`** / direct **`return`** for individual responses. **`TypedDoFetcher`** HTTP results are **`RpcDisposableJsonResponse`** (not Hono’s **`HandlerResponse`** union); that typing mismatch for proxy routes is a known gap—track fixing return types rather than papering over with casts.
 - **Vite SSR, some Miniflare setups, or test mocks** may expose stubs or **`Response`** objects without **`Symbol.dispose`**; there is nothing to call in that case.
 - **Errors from `Symbol.dispose`:** If the runtime’s dispose implementation throws (for example during unwind after your code threw), the library catches the error and logs it with **`console.error`**. It does **not** rethrow, so your original error is not masked by a `SuppressedError`.
 - **TypeScript `using`:** Add **`"ESNext.Disposable"`** to the `compilerOptions.lib` array in your **`tsconfig.json`** (alongside your existing libs) so `using` and `Disposable` type-check. TypeScript 5.2+ is required for `using`. That applies to **`TypedDoFetcher`** (full **`DurableObjectStub`** path): **`RpcDisposableJsonResponse`** / **`Response & Disposable`** on **`websocket`**. **`Pick<stub, "fetch">`** clients get ordinary **`TypedHonoFetcher`** return types without **`Disposable`** on responses. Cloudflare’s runtime rules for RPC disposal are documented under **[Workers RPC lifecycle](https://developers.cloudflare.com/workers/runtime-apis/rpc/lifecycle/)**.
@@ -543,6 +543,97 @@ export class MyDO extends DurableObject implements DOWithHonoApp {
 }
 ```
 
+### `DoRpcWithApp<T>`
+
+Nameable RPC surface for `Env` bindings and generated worker types (avoids Alchemy **`TS2883`** when the full DO class cannot be named in exports):
+
+```typescript
+import type { DoRpcWithApp } from '@firtoz/hono-fetcher';
+
+export class ChatroomDo extends DurableObject {
+  app = new Hono().get('/messages', (c) => c.json({ messages: [] }));
+}
+
+export type ChatroomDoRpc = DoRpcWithApp<ChatroomDo>;
+
+type Env = {
+  CHATROOM: DurableObjectNamespace<ChatroomDoRpc>;
+};
+```
+
+### Query parameters
+
+All HTTP methods accept an optional **`query`** object. **`null`** and **`undefined`** values are omitted from the serialized string:
+
+```typescript
+await api.get({
+  url: '/items',
+  query: { sort: 'name', limit: 10, active: undefined },
+});
+
+// With exactOptionalPropertyTypes, optional query may be omitted or set — not `{ query: undefined }`:
+const limit: number | undefined = undefined;
+await api.get({
+  url: '/items',
+  ...(limit === undefined ? {} : { query: { limit } }),
+});
+```
+
+### `honoFetcherMounted(appOrFetcher, mountPath)`
+
+Typed client for routes under a mount prefix (auth worker `/admin`, service binding sub-app, etc.).
+
+**Local / in-process** — pass the Hono app; types and transport (`app.request`) are inferred:
+
+```typescript
+const admin = honoFetcherMounted(workerApp, '/admin');
+await admin.get({ url: '/users' }); // GET /admin/users, admin response type
+```
+
+**Production** — pass a fetcher when transport is not `app.request` (service bindings, DO stubs, browser `fetch`):
+
+```typescript
+const admin = honoFetcherMounted<typeof workerApp, '/admin'>(
+  (url, init) => env.AUTH.fetch(new Request(`https://auth${url}`, init)),
+  '/admin',
+);
+```
+
+When you pass a fetcher, you must supply the app type (`typeof workerApp`) because the callback carries no route schema. The second type arg (`'/admin'`) is only needed if you also wrote an explicit first type arg — otherwise `'/admin'` is inferred from the argument.
+
+**Sub-app type** — routes on the type omit the mount (`/users`); pass the worker mount string:
+
+```typescript
+const admin = honoFetcherMounted<typeof adminRoutes>(
+  (url, init) => env.AUTH.fetch(new Request(`https://auth${url}`, init)),
+  '/admin',
+);
+
+await admin.get({ url: '/users' }); // GET …/admin/users
+```
+
+**Worker app type** — schema keys are full paths (`/admin/users`, `/admin/users/:id`). `mountPath` must be a {@link ValidMountPrefix} (derived from routes like `/admin/...`). Client `url` values are **after** the mount:
+
+```typescript
+import { honoFetcherMounted } from '@firtoz/hono-fetcher';
+
+// Routes: /users, /admin/users, /admin/users/:id, /a/b, /a/c, /a/:d
+
+const admin = honoFetcherMounted(workerApp, '/admin');
+await admin.get({ url: '/users' }); // GET …/admin/users — not url: '/admin/users'
+
+const aRoutes = honoFetcherMounted(workerApp, '/a');
+await aRoutes.get({ url: '/b' }); // GET …/a/b
+await aRoutes.get({ url: '/:d', params: { d: 'room-1' } }); // GET …/a/room-1
+
+const deep = honoFetcherMounted(workerApp, '/nested/deep');
+await deep.get({ url: '/foo' }); // GET …/nested/deep/foo
+
+const level1 = honoFetcherMounted(workerApp, '/level1/:param', { param: 'room-1' });
+await level1.get({ url: '/foo' }); // GET …/level1/room-1/foo
+await level1.get({ url: '/bar' }); // GET …/level1/room-1/bar
+```
+
 ## Advanced Usage
 
 ### Sharing Types Between Frontend and Backend

package/dist/chunk-2V3BY5GN.js

@@ -0,0 +1,41 @@
+import { honoFetcher } from './chunk-IL7N6DHV.js';
+import { Hono } from 'hono';
+
+function normalizeMountPath(mountPath) {
+  const trimmed = mountPath.trim();
+  if (trimmed === "" || trimmed === "/") {
+    return "";
+  }
+  const withLeading = trimmed.startsWith("/") ? trimmed : `/${trimmed}`;
+  return withLeading.endsWith("/") ? withLeading.slice(0, -1) : withLeading;
+}
+function substitutePathParams(path, params) {
+  return Object.entries(params).reduce(
+    (acc, [key, value]) => acc.replace(`:${key}`, value),
+    path
+  );
+}
+function createMountedFetcher(parentFetcher, mountPath, mountParams) {
+  const normalized = normalizeMountPath(mountPath);
+  const prefix = mountParams === void 0 ? normalized : substitutePathParams(normalized, mountParams);
+  return honoFetcher((request, init) => {
+    const path = request.startsWith("/") ? request : `/${request}`;
+    const url = prefix === "" ? path : `${prefix}${path}`;
+    return parentFetcher(url, init);
+  });
+}
+function isHonoApp(value) {
+  return value instanceof Hono;
+}
+function honoFetcherMounted(appOrFetcher, mountPath, mountParams) {
+  const parentFetcher = isHonoApp(appOrFetcher) ? (url, init) => appOrFetcher.request(url, init) : appOrFetcher;
+  return createMountedFetcher(
+    parentFetcher,
+    mountPath,
+    mountParams
+  );
+}
+
+export { honoFetcherMounted };
+//# sourceMappingURL=chunk-2V3BY5GN.js.map
+//# sourceMappingURL=chunk-2V3BY5GN.js.map

package/dist/chunk-2V3BY5GN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/honoFetcherMounted.ts"],"names":["HonoClass"],"mappings":";;;AAmGA,SAAS,mBAAmB,SAAA,EAA2B;AACtD,EAAA,MAAM,OAAA,GAAU,UAAU,IAAA,EAAK;AAC/B,EAAA,IAAI,OAAA,KAAY,EAAA,IAAM,OAAA,KAAY,GAAA,EAAK;AACtC,IAAA,OAAO,EAAA;AAAA,EACR;AACA,EAAA,MAAM,cAAc,OAAA,CAAQ,UAAA,CAAW,GAAG,CAAA,GAAI,OAAA,GAAU,IAAI,OAAO,CAAA,CAAA;AACnE,EAAA,OAAO,WAAA,CAAY,SAAS,GAAG,CAAA,GAAI,YAAY,KAAA,CAAM,CAAA,EAAG,EAAE,CAAA,GAAI,WAAA;AAC/D;AAEA,SAAS,oBAAA,CACR,MACA,MAAA,EACS;AACT,EAAA,OAAO,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA,CAAE,MAAA;AAAA,IAC7B,CAAC,GAAA,EAAK,CAAC,GAAA,EAAK,KAAK,CAAA,KAAM,GAAA,CAAI,OAAA,CAAQ,CAAA,CAAA,EAAI,GAAG,CAAA,CAAA,EAAI,KAAK,CAAA;AAAA,IACnD;AAAA,GACD;AACD;AAOA,SAAS,oBAAA,CAIR,aAAA,EACA,SAAA,EACA,WAAA,EAGC;AACD,EAAA,MAAM,UAAA,GAAa,mBAAmB,SAAS,CAAA;AAC/C,EAAA,MAAM,SACL,WAAA,KAAgB,MAAA,GACb,UAAA,GACA,oBAAA,CAAqB,YAAY,WAAqC,CAAA;AAC1E,EAAA,OAAO,WAAA,CAAqC,CAAC,OAAA,EAAS,IAAA,KAAS;AAC9D,IAAA,MAAM,OAAO,OAAA,CAAQ,UAAA,CAAW,GAAG,CAAA,GAAI,OAAA,GAAU,IAAI,OAAO,CAAA,CAAA;AAC5D,IAAA,MAAM,MAAM,MAAA,KAAW,EAAA,GAAK,OAAO,CAAA,EAAG,MAAM,GAAG,IAAI,CAAA,CAAA;AACnD,IAAA,OAAO,aAAA,CAAc,KAAK,IAAI,CAAA;AAAA,EAG/B,CAAC,CAAA;AAGF;AAEA,SAAS,UAAU,KAAA,EAA4C;AAC9D,EAAA,OAAO,KAAA,YAAiBA,IAAA;AACzB;AA2DO,SAAS,kBAAA,CAIf,YAAA,EACA,SAAA,EACA,WAAA,EAC8D;AAC9D,EAAA,MAAM,aAAA,GAAgB,SAAA,CAAU,YAAY,CAAA,GACzC,CAAC,GAAA,EAAa,IAAA,KAAuB,YAAA,CAAa,OAAA,CAAQ,GAAA,EAAK,IAAI,CAAA,GACnE,YAAA;AACH,EAAA,OAAO,oBAAA;AAAA,IACN,aAAA;AAAA,IACA,SAAA;AAAA,IACA;AAAA,GACD;AACD","file":"chunk-2V3BY5GN.js","sourcesContent":["import type { Hono } from \"hono\";\nimport { Hono as HonoClass } from \"hono\";\nimport type { Env, Schema } from \"hono/types\";\nimport type { ExtractSchema } from \"hono/types\";\nimport {\n\thonoFetcher,\n\ttype ParsePathParams,\n\ttype TypedHonoFetcher,\n} from \"./honoFetcher\";\n\ntype SchemaRouteKeys<T extends Hono> = string & keyof ExtractSchema<T>;\n\n/**\n * Client-side view of a Hono app: same routes/schema as the server app but without\n * server `Bindings` (service-binding and browser clients do not send Worker env).\n *\n * Use with a **sub-app** type when the mount path is only on the worker (e.g. mount\n * `/admin` but routes on the type are `/users`). For typed mount prefixes derived from\n * full worker paths, pass the **worker app** type and use {@link MountedClientApp}.\n */\nexport type HonoClientApp<T extends Hono> =\n\tT extends Hono<\n\t\tinfer E extends Env,\n\t\tinfer S extends Schema,\n\t\tinfer BasePath extends string\n\t>\n\t\t? Hono<Omit<E, \"Bindings\">, S, BasePath>\n\t\t: never;\n\ntype HasMorePathSegments<Rest extends string> = Rest extends\n\t| `${string}/${string}`\n\t| `:${string}/${string}`\n\t? true\n\t: false;\n\ntype MountPrefixesWithPrefix<\n\tPrefix extends string,\n\tRoute extends string,\n> = Route extends `/${infer Seg}/${infer Rest}`\n\t? HasMorePathSegments<Rest> extends true\n\t\t?\n\t\t\t\t| `${Prefix}/${Seg}`\n\t\t\t\t| MountPrefixesWithPrefix<`${Prefix}/${Seg}`, `/${Rest}`>\n\t\t: `${Prefix}/${Seg}`\n\t: never;\n\n/** Every mount prefix along a route (`/a/b/c` → `/a` | `/a/b`). */\ntype MountPrefixesOfRoute<Route extends string> =\n\tRoute extends `/${infer Seg}/${infer Rest}`\n\t\t? HasMorePathSegments<Rest> extends true\n\t\t\t? `/${Seg}` | MountPrefixesWithPrefix<`/${Seg}`, `/${Rest}`>\n\t\t\t: `/${Seg}`\n\t\t: never;\n\n/**\n * Mount prefix valid when the worker app schema has routes under `${M}/…`.\n * Includes multi-segment prefixes (`/nested/deep`) and param segments (`/level1/:param`).\n * Excludes top-level-only routes (`/users`, `/x`) — use {@link honoFetcher} for those.\n */\nexport type ValidMountPrefix<T extends Hono> = MountPrefixesOfRoute<\n\tSchemaRouteKeys<T>\n>;\n\n/** Path params required when the mount path contains `:param` segments. */\nexport type MountPathParams<M extends string> = ParsePathParams<M>;\n\ntype StripMountRoute<\n\tRoute extends string,\n\tMount extends string,\n> = Route extends `${Mount}/${infer Rest}` ? `/${Rest}` : never;\n\ntype MountedSchema<T extends Hono, Mount extends string> = {\n\t[Route in SchemaRouteKeys<T> as StripMountRoute<\n\t\tRoute,\n\t\tMount\n\t> extends infer Stripped extends string\n\t\t? Stripped\n\t\t: never]: ExtractSchema<T>[Route];\n} & Schema;\n\n/**\n * Client view of routes under `Mount` on a **worker app** whose schema keys are full\n * paths (e.g. `/admin/users` → client `url: \"/users\"` when `Mount` is `\"/admin\"`).\n */\nexport type MountedClientApp<T extends Hono, Mount extends string> =\n\tT extends Hono<\n\t\tinfer E extends Env,\n\t\tinfer _S extends Schema,\n\t\tinfer BasePath extends string\n\t>\n\t\t? Hono<Omit<E, \"Bindings\">, MountedSchema<T, Mount>, BasePath>\n\t\t: never;\n\ntype ClientAppForMount<T extends Hono, M extends string> =\n\tM extends ValidMountPrefix<T> ? MountedClientApp<T, M> : HonoClientApp<T>;\n\ntype MountParamsArg<M extends string> =\n\tParsePathParams<M> extends never ? undefined : ParsePathParams<M>;\n\nfunction normalizeMountPath(mountPath: string): string {\n\tconst trimmed = mountPath.trim();\n\tif (trimmed === \"\" || trimmed === \"/\") {\n\t\treturn \"\";\n\t}\n\tconst withLeading = trimmed.startsWith(\"/\") ? trimmed : `/${trimmed}`;\n\treturn withLeading.endsWith(\"/\") ? withLeading.slice(0, -1) : withLeading;\n}\n\nfunction substitutePathParams(\n\tpath: string,\n\tparams: Record<string, string>,\n): string {\n\treturn Object.entries(params).reduce(\n\t\t(acc, [key, value]) => acc.replace(`:${key}`, value),\n\t\tpath,\n\t);\n}\n\ntype ParentFetcher = (\n\trequest: string,\n\tinit?: RequestInit,\n) => Response | Promise<Response>;\n\nfunction createMountedFetcher<\n\tT extends Hono,\n\tconst M extends ValidMountPrefix<T> | string,\n>(\n\tparentFetcher: ParentFetcher,\n\tmountPath: M,\n\tmountParams?: MountParamsArg<M>,\n): TypedHonoFetcher<\n\tM extends ValidMountPrefix<T> ? MountedClientApp<T, M> : HonoClientApp<T>\n> {\n\tconst normalized = normalizeMountPath(mountPath);\n\tconst prefix =\n\t\tmountParams === undefined\n\t\t\t? normalized\n\t\t\t: substitutePathParams(normalized, mountParams as Record<string, string>);\n\treturn honoFetcher<ClientAppForMount<T, M>>((request, init) => {\n\t\tconst path = request.startsWith(\"/\") ? request : `/${request}`;\n\t\tconst url = prefix === \"\" ? path : `${prefix}${path}`;\n\t\treturn parentFetcher(url, init) as ReturnType<\n\t\t\tClientAppForMount<T, M>[\"request\"]\n\t\t>;\n\t}) as TypedHonoFetcher<\n\t\tM extends ValidMountPrefix<T> ? MountedClientApp<T, M> : HonoClientApp<T>\n\t>;\n}\n\nfunction isHonoApp(value: ParentFetcher | Hono): value is Hono {\n\treturn value instanceof HonoClass;\n}\n\n/**\n * Typed client for routes under `mountPath`, using `app.request` as transport.\n * Infers both the app schema and (when valid) stripped mount paths — no type args needed.\n *\n * When `mountPath` contains `:param` segments, pass `mountParams` (same shape as route\n * `params` on {@link honoFetcher}).\n */\nexport function honoFetcherMounted<\n\tT extends Hono,\n\tconst M extends ValidMountPrefix<T>,\n>(\n\tapp: T,\n\tmountPath: M,\n\tmountParams: MountPathParams<M>,\n): TypedHonoFetcher<MountedClientApp<T, M>>;\n\nexport function honoFetcherMounted<\n\tT extends Hono,\n\tconst M extends ValidMountPrefix<T>,\n>(app: T, mountPath: M): TypedHonoFetcher<MountedClientApp<T, M>>;\n\n/**\n * Typed client for routes under `mountPath` on a parent fetcher.\n *\n * Use when transport is not `app.request` (service bindings, DO stubs, browser `fetch`, etc.).\n *\n * - **Worker app type** (schema keys include the mount, e.g. `/admin/users`): pass\n *   `typeof workerApp` and a {@link ValidMountPrefix}; client `url` values are paths\n *   **after** the mount (`/users`, not `/admin/users`). Prefer {@link honoFetcherMounted}\n *   with the app instance when using `app.request`.\n * - **Sub-app type** (routes are `/users` on the sub-app, mount is only on the worker):\n *   pass `typeof adminRoutes` and the worker mount string (`\"/admin\"`); client URLs\n *   match the sub-app schema.\n */\nexport function honoFetcherMounted<T extends Hono>(\n\tparentFetcher: ParentFetcher,\n\tmountPath: string,\n\tmountParams?: Record<string, string>,\n): TypedHonoFetcher<HonoClientApp<T>>;\n\nexport function honoFetcherMounted<\n\tT extends Hono,\n\tconst M extends ValidMountPrefix<T>,\n>(\n\tparentFetcher: ParentFetcher,\n\tmountPath: M,\n\tmountParams: MountPathParams<M>,\n): TypedHonoFetcher<MountedClientApp<T, M>>;\n\nexport function honoFetcherMounted<\n\tT extends Hono,\n\tconst M extends ValidMountPrefix<T>,\n>(\n\tparentFetcher: ParentFetcher,\n\tmountPath: M,\n): TypedHonoFetcher<MountedClientApp<T, M>>;\n\nexport function honoFetcherMounted<\n\tT extends Hono,\n\tconst M extends ValidMountPrefix<T> | string,\n>(\n\tappOrFetcher: T | ParentFetcher,\n\tmountPath: M,\n\tmountParams?: MountParamsArg<M>,\n): TypedHonoFetcher<HonoClientApp<T> | MountedClientApp<T, M>> {\n\tconst parentFetcher = isHonoApp(appOrFetcher)\n\t\t? (url: string, init?: RequestInit) => appOrFetcher.request(url, init)\n\t\t: appOrFetcher;\n\treturn createMountedFetcher<T, M>(\n\t\tparentFetcher,\n\t\tmountPath,\n\t\tmountParams,\n\t) as TypedHonoFetcher<HonoClientApp<T> | MountedClientApp<T, M>>;\n}\n"]}

package/dist/{chunk-WN4MD3WJ.js → chunk-CHQGE36J.js}

@@ -1,4 +1,4 @@
-import { honoFetcher } from './chunk-5KDMHM65.js';
+import { honoFetcher } from './chunk-IL7N6DHV.js';
 
 // src/honoDoFetcher.ts
 var DUMMY_URL = "http://dummy-url";
@@ -39,5 +39,5 @@ var honoDoFetcherWithId = (namespace, id) => {
 };
 
 export { honoDoFetcher, honoDoFetcherWithId, honoDoFetcherWithName };
-//# sourceMappingURL=chunk-WN4MD3WJ.js.map
-//# sourceMappingURL=chunk-WN4MD3WJ.js.map
+//# sourceMappingURL=chunk-CHQGE36J.js.map
+//# sourceMappingURL=chunk-CHQGE36J.js.map

package/dist/chunk-CHQGE36J.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/honoDoFetcher.ts"],"names":[],"mappings":";;;AAQA,IAAM,SAAA,GAAY,kBAAA;AA+DlB,SAAS,eAAA,CAIR,MAEA,GAAA,EAE+C;AAC/C,EAAA,OAAO,MAAA,CAAO,OAAO,GAAA,EAAK;AAAA,IACzB,CAAC,MAAA,CAAO,OAAO,CAAA,GAAI;AAElB,MAAA,MAAM,SAAA,GAAY,OAAA,CAAQ,GAAA,CAAI,IAAA,EAAM,OAAO,OAAO,CAAA;AAClD,MAAA,IAAI,OAAO,cAAc,UAAA,EAAY;AACpC,QAAA;AAAA,MACD;AACA,MAAA,IAAI;AACH,QAAA,SAAA,CAAU,KAAK,IAAI,CAAA;AAAA,MACpB,SAAS,CAAA,EAAG;AACX,QAAA,OAAA,CAAQ,KAAA;AAAA,UACP,2DAAA;AAAA,UACA;AAAA,SACD;AAAA,MACD;AAAA,IACD;AAAA,GACA,CAAA;AACF;AAkBO,IAAM,aAAA,GAAgB,CAC5B,aAAA,KAGyC;AAIzC,EAAA,MAAM,GAAA,GAAM,WAAA,CAAkC,CAAC,GAAA,EAAK,IAAA,KAAS;AAC5D,IAAA,OAAO,cAAc,KAAA,CAAM,CAAA,EAAG,SAAS,CAAA,EAAG,GAAG,IAAI,IAAI,CAAA;AAAA,EACtD,CAAC,CAAA;AACD,EAAA,OAAO,eAAA;AAAA,IACN,aAAA;AAAA,IACA;AAAA,GACD;AAGD;AAEO,IAAM,qBAAA,GAAwB,CAGpC,SAAA,EACA,IAAA,KACuD;AACvD,EAAA,OAAO,aAAA,CAAc,SAAA,CAAU,SAAA,CAAU,IAAI,CAAC,CAAA;AAI/C;AAEO,IAAM,mBAAA,GAAsB,CAGlC,SAAA,EACA,EAAA,KACuD;AACvD,EAAA,OAAO,aAAA;AAAA,IACN,SAAA,CAAU,GAAA,CAAI,SAAA,CAAU,YAAA,CAAa,EAAE,CAAC;AAAA,GACzC;AACD","file":"chunk-CHQGE36J.js","sourcesContent":["import type { Hono, Schema } from \"hono\";\nimport type { ExtractSchema } from \"hono/types\";\nimport {\n\thonoFetcher,\n\ttype BaseDisposableTypedHonoFetcher,\n\ttype TypedHonoFetcher,\n} from \"./honoFetcher\";\n\nconst DUMMY_URL = \"http://dummy-url\";\n\nexport type DOWithHonoApp<S extends Schema = Schema> =\n\tRpc.DurableObjectBranded & {\n\t\t// biome-ignore lint/suspicious/noExplicitAny: We need to be able to pass in any schema\n\t\tapp: Hono<any, S>;\n\t};\n\n/**\n * Nameable RPC surface for a Durable Object class that exposes a Hono `app`.\n * Use when exporting types for `Env` bindings (avoids Alchemy `TS2883` when the\n * full DO class type cannot be named in generated declarations).\n *\n * @example\n * ```ts\n * export type ChatroomDoRpc = DoRpcWithApp<ChatroomDo>;\n * // Env: { CHATROOM: DurableObjectNamespace<ChatroomDoRpc> }\n * ```\n */\nexport type DoRpcWithApp<T extends { app: Hono }> = Rpc.DurableObjectBranded &\n\tPick<T, \"app\">;\n\nexport type DOSchemaMap<T extends DOWithHonoApp> = T extends DOWithHonoApp\n\t? ExtractSchema<T[\"app\"]>\n\t: never;\n\nexport type DOSchemaKeys<T extends DOWithHonoApp> = string &\n\tkeyof DOSchemaMap<T>;\n\nexport type DOStubSchema<T extends DurableObjectStub> =\n\tT extends DurableObjectStub<infer S>\n\t\t? S extends DOWithHonoApp\n\t\t\t? ExtractSchema<S[\"app\"]>\n\t\t\t: never\n\t\t: never;\n\n/**\n * Fetcher for a **real** `DurableObjectStub`: HTTP results are {@link RpcDisposableJsonResponse}\n * and `websocket` returns `Response & Disposable`, matching Workers RPC when the runtime attaches\n * disposers. Use with {@link honoDoFetcher} / {@link honoDoFetcherWithName} / {@link honoDoFetcherWithId}\n * when `T` is a full stub—not with a minimal `Pick<stub, \"fetch\">` mock (that path uses plain\n * {@link TypedHonoFetcher} responses instead).\n *\n * @see https://developers.cloudflare.com/workers/runtime-apis/rpc/lifecycle/\n */\nexport type TypedDoFetcher<T extends DurableObjectStub> =\n\tBaseDisposableTypedHonoFetcher<\n\t\t// biome-ignore lint/suspicious/noExplicitAny: Generic parameter needs flexibility\n\t\tHono<any, DOStubSchema<T>>\n\t>;\n\n/**\n * Argument to {@link honoDoFetcher}: a **full** {@link DurableObjectStub} (production) or a minimal\n * **`{ fetch }`** mock. Only the full stub is typed as {@link TypedDoFetcher} with disposable RPC\n * responses; **`Pick<stub, \"fetch\">`** is typed as {@link TypedHonoFetcher} for `Hono` with ordinary\n * `JsonResponse` / `Response` (no `Disposable` on results—matches mocks without `Symbol.dispose`).\n *\n * @see https://developers.cloudflare.com/workers/runtime-apis/rpc/lifecycle/\n */\nexport type HonoDoFetcherStubInput =\n\t| DurableObjectStub<DOWithHonoApp>\n\t| Pick<DurableObjectStub<DOWithHonoApp>, \"fetch\">;\n\nfunction withStubDispose<\n\tTStub extends Pick<DurableObjectStub<DOWithHonoApp>, \"fetch\">,\n\tTS extends Schema,\n>(\n\tstub: TStub,\n\t// biome-ignore lint/suspicious/noExplicitAny: Matches honoFetcher generic pattern for schema-driven apps\n\tapi: TypedHonoFetcher<Hono<any, TS>>,\n\t// biome-ignore lint/suspicious/noExplicitAny: Matches honoFetcher generic pattern for schema-driven apps\n): TypedHonoFetcher<Hono<any, TS>> & Disposable {\n\treturn Object.assign(api, {\n\t\t[Symbol.dispose]() {\n\t\t\t// Stubs may omit Symbol.dispose (e.g. Vite mocks); DurableObjectStub types may not list it.\n\t\t\tconst disposeFn = Reflect.get(stub, Symbol.dispose);\n\t\t\tif (typeof disposeFn !== \"function\") {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tdisposeFn.call(stub);\n\t\t\t} catch (e) {\n\t\t\t\tconsole.error(\n\t\t\t\t\t\"[@firtoz/hono-fetcher] Durable Object stub dispose failed\",\n\t\t\t\t\te,\n\t\t\t\t);\n\t\t\t}\n\t\t},\n\t});\n}\n\n/**\n * Typed fetcher for a Durable Object stub.\n *\n * - **Full `DurableObjectStub`:** return type is {@link TypedDoFetcher} **`& Disposable`** — each\n *   HTTP/WebSocket result is typed as disposable (`RpcDisposableJsonResponse` / `Response & Disposable`)\n *   so **`using res = await …`** type-checks when `\"ESNext.Disposable\"` is in `lib`, matching Workers RPC\n *   when the runtime attaches `[Symbol.dispose]` (see `@see` below).\n * - **`Pick<stub, \"fetch\">` only (e.g. tests):** return type is **`TypedHonoFetcher<Hono> & Disposable`**\n *   — same **`JsonResponse` / `Response`** shapes as {@link honoFetcher}; results are **not** typed as\n *   `Disposable` so typings are not faked for mocks that lack RPC disposers.\n *\n * Disposing only the fetcher (`using api = …`) releases the **stub**; RPC **`Response`** disposal\n * (when applicable) is separate — prefer **`using res`**, **`res[Symbol.dispose]()`**, or **`DisposableStack`**.\n *\n * @see https://developers.cloudflare.com/workers/runtime-apis/rpc/lifecycle/\n */\nexport const honoDoFetcher = <const T extends HonoDoFetcherStubInput>(\n\tdurableObject: T,\n): T extends DurableObjectStub<DOWithHonoApp>\n\t? TypedDoFetcher<T> & Disposable\n\t: TypedHonoFetcher<Hono> & Disposable => {\n\ttype OutSchema =\n\t\tT extends DurableObjectStub<DOWithHonoApp> ? DOStubSchema<T> : Schema;\n\t// biome-ignore lint/suspicious/noExplicitAny: Generic parameter needs flexibility\n\tconst api = honoFetcher<Hono<any, OutSchema>>((url, init) => {\n\t\treturn durableObject.fetch(`${DUMMY_URL}${url}`, init);\n\t});\n\treturn withStubDispose(\n\t\tdurableObject,\n\t\tapi,\n\t) as T extends DurableObjectStub<DOWithHonoApp>\n\t\t? TypedDoFetcher<T> & Disposable\n\t\t: TypedHonoFetcher<Hono> & Disposable;\n};\n\nexport const honoDoFetcherWithName = <\n\tconst T extends Rpc.DurableObjectBranded & DOWithHonoApp,\n>(\n\tnamespace: DurableObjectNamespace<T>,\n\tname: string,\n): TypedDoFetcher<DurableObjectStub<T>> & Disposable => {\n\treturn honoDoFetcher(namespace.getByName(name)) as TypedDoFetcher<\n\t\tDurableObjectStub<T>\n\t> &\n\t\tDisposable;\n};\n\nexport const honoDoFetcherWithId = <\n\tconst T extends Rpc.DurableObjectBranded & DOWithHonoApp,\n>(\n\tnamespace: DurableObjectNamespace<T>,\n\tid: string,\n): TypedDoFetcher<DurableObjectStub<T>> & Disposable => {\n\treturn honoDoFetcher(\n\t\tnamespace.get(namespace.idFromString(id)),\n\t) as TypedDoFetcher<DurableObjectStub<T>> & Disposable;\n};\n"]}

package/dist/{chunk-5KDMHM65.js → chunk-IL7N6DHV.js}

@@ -109,5 +109,5 @@ var honoFetcher = (fetcher) => {
 };
 
 export { honoFetcher };
-//# sourceMappingURL=chunk-5KDMHM65.js.map
-//# sourceMappingURL=chunk-5KDMHM65.js.map
+//# sourceMappingURL=chunk-IL7N6DHV.js.map
+//# sourceMappingURL=chunk-IL7N6DHV.js.map

package/dist/chunk-IL7N6DHV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/honoFetcher.ts"],"names":[],"mappings":"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","file":"chunk-IL7N6DHV.js","sourcesContent":["import type { Hono } from \"hono\";\nimport type { ExtractSchema } from \"hono/types\";\n\nexport type ParsePathParams<T extends string> =\n\tT extends `${infer _Start}/:${infer Param}/${infer Rest}`\n\t\t? { [K in Param | keyof ParsePathParams<`/${Rest}`>]: string }\n\t\t: T extends `${infer _Start}/:${infer Param}`\n\t\t\t? { [K in Param]: string }\n\t\t\t: never;\n\nexport type HttpMethod = \"get\" | \"post\" | \"put\" | \"delete\" | \"patch\";\n\nexport type HonoSchemaKeys<T extends Hono> = string & keyof ExtractSchema<T>;\n\ntype FilterKeysByMethod<\n\tTApp extends ExtractSchema<unknown>,\n\tTMethod extends HttpMethod,\n> = {\n\t[K in keyof TApp as TApp[K] extends { [key in `$${TMethod}`]: unknown }\n\t\t? K\n\t\t: never]: TApp[K];\n};\n\ntype HonoSchema<TApp extends Hono> = {\n\t[M in HttpMethod]: FilterKeysByMethod<ExtractSchema<TApp>, M>;\n};\n\nexport type JsonResponse<T> = Omit<Response, \"json\"> & {\n\tjson: () => Promise<T>;\n};\n\n/**\n * {@link JsonResponse} intersected with `Disposable` for Workers RPC: `Response`\n * values from `DurableObjectStub#fetch()` may implement `[Symbol.dispose]` even\n * though `Fetcher.fetch` is still typed as `Promise<Response>`. Use with\n * {@link BaseDisposableTypedHonoFetcher} (and `TypedDoFetcher` from `./honoDoFetcher`) so\n * `using resp = await api.get(...)` type-checks when `\"ESNext.Disposable\"` is in `lib`.\n *\n * @see https://developers.cloudflare.com/workers/runtime-apis/rpc/lifecycle/\n */\nexport type RpcDisposableJsonResponse<T> = JsonResponse<T> & Disposable;\n\ntype HasPathParams<T extends string> = T extends `${string}:${string}`\n\t? true\n\t: false;\n\n/**\n * Values allowed in the optional `query` object on fetcher requests.\n * `null` and `undefined` entries are omitted from the serialized query string.\n */\nexport type HonoFetcherQueryParamValue = string | number | boolean;\n\nexport type HonoFetcherQueryParams = Record<\n\tstring,\n\tHonoFetcherQueryParamValue | null | undefined\n>;\n\nfunction appendQueryString(\n\turl: string,\n\tquery?: HonoFetcherQueryParams,\n): string {\n\tif (!query) {\n\t\treturn url;\n\t}\n\tconst searchParams = new URLSearchParams();\n\tfor (const [key, value] of Object.entries(query)) {\n\t\tif (value === undefined || value === null) {\n\t\t\tcontinue;\n\t\t}\n\t\tsearchParams.append(key, String(value));\n\t}\n\tconst serialized = searchParams.toString();\n\tif (!serialized) {\n\t\treturn url;\n\t}\n\tconst separator = url.includes(\"?\") ? \"&\" : \"?\";\n\treturn `${url}${separator}${serialized}`;\n}\n\n/**\n * `RequestInit` fields that honoFetcher sets must not be overwritten by spreading `...init` last.\n */\nfunction restOfRequestInit(\n\tinit: RequestInit,\n): Omit<RequestInit, \"headers\" | \"body\" | \"method\"> {\n\tconst { headers: _h, body: _b, method: _m, ...rest } = init;\n\treturn rest;\n}\n\ntype FetcherParams<SchemaPath extends string> =\n\tHasPathParams<SchemaPath> extends true\n\t\t? {\n\t\t\t\tparams: ParsePathParams<SchemaPath>;\n\t\t\t\tquery?: HonoFetcherQueryParams | undefined;\n\t\t\t\tinit?: RequestInit | undefined;\n\t\t\t}\n\t\t: {\n\t\t\t\tparams?: never;\n\t\t\t\tquery?: HonoFetcherQueryParams | undefined;\n\t\t\t\tinit?: RequestInit | undefined;\n\t\t\t};\n\n// biome-ignore lint/complexity/noBannedTypes: We need an empty object to remove the body and form keys from the request object\ntype EmptyObject = {};\n\ntype TypedMethodFetcher<T extends Hono, M extends HttpMethod> = <\n\tSchemaPath extends string & keyof HonoSchema<T>[M],\n>(\n\trequest: {\n\t\turl: SchemaPath;\n\t} & FetcherParams<SchemaPath> &\n\t\t(M extends \"get\" | \"delete\" ? EmptyObject : BodyParams<T, M, SchemaPath>),\n) => Promise<SchemaOutput<T, M, SchemaPath>>;\n\n/**\n * `@hono/zod-validator` (0.8+) unions Zod 400 JSON bodies into route `output`.\n * Fetcher clients only model successful handler responses.\n */\ntype ExcludeZodValidatorFailureOutput<T> = Exclude<\n\tT,\n\t{ success: false; error: unknown }\n>;\n\ntype HonoRouteOutput<\n\tT extends Hono,\n\tM extends HttpMethod,\n\tSchemaPath extends string & keyof HonoSchema<T>[M],\n\tDollarM extends `$${M}` & keyof HonoSchema<T>[M][SchemaPath] = `$${M}` &\n\t\tkeyof HonoSchema<T>[M][SchemaPath],\n> = \"output\" extends keyof HonoSchema<T>[M][SchemaPath][DollarM]\n\t? ExcludeZodValidatorFailureOutput<\n\t\t\tHonoSchema<T>[M][SchemaPath][DollarM][\"output\"]\n\t\t>\n\t: never;\n\ntype SchemaOutput<\n\tT extends Hono,\n\tM extends HttpMethod,\n\tSchemaPath extends string & keyof HonoSchema<T>[M],\n\tDollarM extends `$${M}` & keyof HonoSchema<T>[M][SchemaPath] = `$${M}` &\n\t\tkeyof HonoSchema<T>[M][SchemaPath],\n> = \"output\" extends keyof HonoSchema<T>[M][SchemaPath][DollarM]\n\t? JsonResponse<HonoRouteOutput<T, M, SchemaPath, DollarM>>\n\t: never;\n\ntype DoSchemaOutput<\n\tT extends Hono,\n\tM extends HttpMethod,\n\tSchemaPath extends string & keyof HonoSchema<T>[M],\n\tDollarM extends `$${M}` & keyof HonoSchema<T>[M][SchemaPath] = `$${M}` &\n\t\tkeyof HonoSchema<T>[M][SchemaPath],\n> = \"output\" extends keyof HonoSchema<T>[M][SchemaPath][DollarM]\n\t? RpcDisposableJsonResponse<HonoRouteOutput<T, M, SchemaPath, DollarM>>\n\t: never;\n\ntype BodyParams<\n\tTApp extends Hono,\n\tTMethod extends HttpMethod,\n\tSchemaPath extends string & keyof HonoSchema<TApp>[TMethod],\n\tDollarMethod extends `$${TMethod}` &\n\t\tkeyof HonoSchema<TApp>[TMethod][SchemaPath] = `$${TMethod}` &\n\t\tkeyof HonoSchema<TApp>[TMethod][SchemaPath],\n> = \"input\" extends keyof HonoSchema<TApp>[TMethod][SchemaPath][DollarMethod]\n\t? \"json\" extends keyof HonoSchema<TApp>[TMethod][SchemaPath][DollarMethod][\"input\"]\n\t\t? \"form\" extends keyof HonoSchema<TApp>[TMethod][SchemaPath][DollarMethod][\"input\"]\n\t\t\t?\n\t\t\t\t\t| {\n\t\t\t\t\t\t\tbody: HonoSchema<TApp>[TMethod][SchemaPath][DollarMethod][\"input\"][\"json\"];\n\t\t\t\t\t  }\n\t\t\t\t\t| {\n\t\t\t\t\t\t\tform: HonoSchema<TApp>[TMethod][SchemaPath][DollarMethod][\"input\"][\"form\"];\n\t\t\t\t\t  }\n\t\t\t: {\n\t\t\t\t\tbody: HonoSchema<TApp>[TMethod][SchemaPath][DollarMethod][\"input\"][\"json\"];\n\t\t\t\t}\n\t\t: \"form\" extends keyof HonoSchema<TApp>[TMethod][SchemaPath][DollarMethod][\"input\"]\n\t\t\t? {\n\t\t\t\t\tform: HonoSchema<TApp>[TMethod][SchemaPath][DollarMethod][\"input\"][\"form\"];\n\t\t\t\t}\n\t\t\t: { body?: unknown } | { form?: unknown }\n\t: EmptyObject;\n\ntype AvailableMethods<T extends Hono> = {\n\t[M in HttpMethod]: keyof HonoSchema<T>[M] extends never ? never : M;\n}[HttpMethod];\n\nexport interface WebSocketConfig {\n\t/**\n\t * Whether to automatically call accept() on the WebSocket before returning.\n\t * Defaults to true for convenience.\n\t *\n\t * In Cloudflare Workers, you must call accept() before using a WebSocket.\n\t * Setting this to false allows you to call accept() manually if needed.\n\t *\n\t * @default true\n\t */\n\tautoAccept?: boolean | undefined;\n\t/**\n\t * Arguments for Cloudflare’s `WebSocket#accept` (e.g. `{ allowHalfOpen: true }` when\n\t * [proxying](https://developers.cloudflare.com/workers/runtime-apis/websockets/#close-behavior)\n\t * and coordinating close on both sides). Used only when `autoAccept` is true.\n\t */\n\tacceptOptions?: WebSocketAcceptOptions | undefined;\n}\n\nexport type TypedWebSocketFetcher<T extends Hono> = <\n\tSchemaPath extends string & keyof HonoSchema<T>[\"get\"],\n>(\n\trequest: {\n\t\turl: SchemaPath;\n\t\tconfig?: WebSocketConfig;\n\t} & FetcherParams<SchemaPath>,\n) => Promise<Response>;\n\nexport type BaseTypedHonoFetcher<T extends Hono> = {\n\t[M in AvailableMethods<T>]: TypedMethodFetcher<T, M>;\n} & (keyof HonoSchema<T>[\"get\"] extends never\n\t? // biome-ignore lint/complexity/noBannedTypes: We really do want an empty object if the get method is not available\n\t\t{}\n\t: { websocket: TypedWebSocketFetcher<T> });\n\ntype TypedDisposableMethodFetcher<T extends Hono, M extends HttpMethod> = <\n\tSchemaPath extends string & keyof HonoSchema<T>[M],\n>(\n\trequest: {\n\t\turl: SchemaPath;\n\t} & FetcherParams<SchemaPath> &\n\t\t(M extends \"get\" | \"delete\" ? EmptyObject : BodyParams<T, M, SchemaPath>),\n) => Promise<DoSchemaOutput<T, M, SchemaPath>>;\n\nexport type TypedDisposableWebSocketFetcher<T extends Hono> = <\n\tSchemaPath extends string & keyof HonoSchema<T>[\"get\"],\n>(\n\trequest: {\n\t\turl: SchemaPath;\n\t\tconfig?: WebSocketConfig;\n\t} & FetcherParams<SchemaPath>,\n) => Promise<Response & Disposable>;\n\n/**\n * Same shape as {@link BaseTypedHonoFetcher} but HTTP methods return\n * {@link RpcDisposableJsonResponse} and `websocket` returns `Response & Disposable`\n * so `using` on RPC results type-checks for Durable Object clients.\n *\n * @see https://developers.cloudflare.com/workers/runtime-apis/rpc/lifecycle/\n */\nexport type BaseDisposableTypedHonoFetcher<T extends Hono> = {\n\t[M in AvailableMethods<T>]: TypedDisposableMethodFetcher<T, M>;\n} & (keyof HonoSchema<T>[\"get\"] extends never\n\t? // biome-ignore lint/complexity/noBannedTypes: We really do want an empty object if the get method is not available\n\t\t{}\n\t: { websocket: TypedDisposableWebSocketFetcher<T> });\n\nconst createMethodFetcher = <T extends Hono, M extends HttpMethod>(\n\tfetcher: (\n\t\trequest: string,\n\t\tinit?: RequestInit,\n\t) => ReturnType<T[\"request\"]> | Promise<ReturnType<T[\"request\"]>>,\n\tmethod: M,\n): TypedMethodFetcher<T, M> => {\n\treturn (async (request) => {\n\t\tlet finalUrl: string = request.url;\n\n\t\tconst { init = {}, params, query } = request;\n\n\t\tif (params && typeof params === \"object\") {\n\t\t\tfinalUrl = Object.entries(params).reduce((acc, [key, value]) => {\n\t\t\t\treturn acc.replace(`:${key}`, value as string);\n\t\t\t}, finalUrl);\n\t\t}\n\n\t\tfinalUrl = appendQueryString(finalUrl, query);\n\n\t\tconst requestAsOptionalFormBody = request as {\n\t\t\tform?: unknown;\n\t\t\tbody?: unknown;\n\t\t};\n\n\t\tlet body: BodyInit | undefined;\n\t\tif (requestAsOptionalFormBody.form) {\n\t\t\tconst formData = new FormData();\n\t\t\tfor (const [key, value] of Object.entries(\n\t\t\t\trequestAsOptionalFormBody.form,\n\t\t\t)) {\n\t\t\t\tformData.append(key, value as string);\n\t\t\t}\n\t\t\tbody = formData;\n\t\t} else if (requestAsOptionalFormBody.body) {\n\t\t\tbody = JSON.stringify(requestAsOptionalFormBody.body) as BodyInit;\n\t\t}\n\n\t\tconst newHeaders = new Headers(\n\t\t\tinit.headers as unknown as ConstructorParameters<typeof Headers>[0],\n\t\t);\n\n\t\tif (body && !requestAsOptionalFormBody.form) {\n\t\t\tnewHeaders.set(\"Content-Type\", \"application/json\");\n\t\t}\n\n\t\ttry {\n\t\t\treturn await fetcher(finalUrl, {\n\t\t\t\t...restOfRequestInit(init),\n\t\t\t\tmethod: method.toUpperCase(),\n\t\t\t\theaders: newHeaders,\n\t\t\t\t...(body ? { body } : {}),\n\t\t\t});\n\t\t} catch (error) {\n\t\t\tconsole.error(`Error ${method}ing`, error);\n\t\t\tthrow new Error(`Failed to ${method} ${finalUrl}: ${error}`);\n\t\t}\n\t}) as TypedMethodFetcher<T, M>;\n};\n\nconst createWebSocketFetcher = <T extends Hono>(\n\tfetcher: (\n\t\trequest: string,\n\t\tinit?: RequestInit,\n\t) => ReturnType<T[\"request\"]> | Promise<ReturnType<T[\"request\"]>>,\n): TypedWebSocketFetcher<T> => {\n\treturn (async (request) => {\n\t\tlet finalUrl: string = request.url;\n\n\t\tconst { init = {}, params, query, config } = request;\n\t\tconst autoAccept = config?.autoAccept ?? true;\n\t\tconst acceptOptions = config?.acceptOptions;\n\n\t\tif (params && typeof params === \"object\") {\n\t\t\tfinalUrl = Object.entries(params).reduce((acc, [key, value]) => {\n\t\t\t\treturn acc.replace(`:${key}`, value as string);\n\t\t\t}, finalUrl);\n\t\t}\n\n\t\tfinalUrl = appendQueryString(finalUrl, query);\n\n\t\tconst newHeaders = new Headers(\n\t\t\tinit.headers as unknown as ConstructorParameters<typeof Headers>[0],\n\t\t);\n\t\tnewHeaders.set(\"Upgrade\", \"websocket\");\n\n\t\ttry {\n\t\t\tconst response = await fetcher(finalUrl, {\n\t\t\t\t...restOfRequestInit(init),\n\t\t\t\tmethod: \"GET\",\n\t\t\t\theaders: newHeaders,\n\t\t\t});\n\n\t\t\tif (autoAccept && response.webSocket) {\n\t\t\t\tresponse.webSocket.accept(acceptOptions);\n\t\t\t}\n\n\t\t\treturn response;\n\t\t} catch (error) {\n\t\t\tconsole.error(\"Error upgrading to WebSocket\", error);\n\t\t\tthrow new Error(`Failed to upgrade WebSocket at ${finalUrl}: ${error}`);\n\t\t}\n\t}) as TypedWebSocketFetcher<T>;\n};\n\nexport type TypedHonoFetcher<T extends Hono> = BaseTypedHonoFetcher<T>;\n\nexport const honoFetcher = <T extends Hono>(\n\tfetcher: (\n\t\trequest: string,\n\t\tinit?: RequestInit,\n\t) => ReturnType<T[\"request\"]> | Promise<ReturnType<T[\"request\"]>>,\n): TypedHonoFetcher<T> => {\n\tconst methods = [\"get\", \"post\", \"put\", \"delete\", \"patch\"] as const;\n\n\tconst result = methods.reduce(\n\t\t(acc, method) => {\n\t\t\t(\n\t\t\t\tacc as TypedHonoFetcher<T> & {\n\t\t\t\t\t[M in typeof method]: TypedMethodFetcher<T, M>;\n\t\t\t\t}\n\t\t\t)[method] = createMethodFetcher(fetcher, method) as TypedMethodFetcher<\n\t\t\t\tT,\n\t\t\t\ttypeof method\n\t\t\t>;\n\t\t\treturn acc;\n\t\t},\n\t\t{} as TypedHonoFetcher<T>,\n\t);\n\n\t// Add websocket method\n\t(\n\t\tresult as TypedHonoFetcher<T> & { websocket?: TypedWebSocketFetcher<T> }\n\t).websocket = createWebSocketFetcher(fetcher);\n\n\treturn result;\n};\n"]}

package/dist/{chunk-MZBZTJN5.js → chunk-QEZAY63D.js}

@@ -1,4 +1,4 @@
-import { honoFetcher } from './chunk-5KDMHM65.js';
+import { honoFetcher } from './chunk-IL7N6DHV.js';
 
 // src/honoDirectFetcher.ts
 var honoDirectFetcher = (baseUrl) => {
@@ -8,5 +8,5 @@ var honoDirectFetcher = (baseUrl) => {
 };
 
 export { honoDirectFetcher };
-//# sourceMappingURL=chunk-MZBZTJN5.js.map
-//# sourceMappingURL=chunk-MZBZTJN5.js.map
+//# sourceMappingURL=chunk-QEZAY63D.js.map
+//# sourceMappingURL=chunk-QEZAY63D.js.map

package/dist/{chunk-MZBZTJN5.js.map → chunk-QEZAY63D.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/honoDirectFetcher.ts"],"names":[],"mappings":";;;AAGO,IAAM,iBAAA,GAAoB,CAChC,OAAA,KACyB;AACzB,EAAA,OAAO,WAAA,CAAe,CAAC,OAAA,EAAS,IAAA,KAAS;AACxC,IAAA,OAAO,MAAM,CAAA,EAAG,OAAO,CAAA,EAAG,OAAO,IAAI,IAAI,CAAA;AAAA,EAC1C,CAAC,CAAA;AACF","file":"chunk-MZBZTJN5.js","sourcesContent":["import type { Hono } from \"hono\";\nimport { honoFetcher, type TypedHonoFetcher } from \"./honoFetcher\";\n\nexport const honoDirectFetcher = <T extends Hono>(\n\tbaseUrl: string,\n): TypedHonoFetcher<T> => {\n\treturn honoFetcher<T>((request, init) => {\n\t\treturn fetch(`${baseUrl}${request}`, init) as ReturnType<T[\"request\"]>;\n\t});\n};\n"]}
+{"version":3,"sources":["../src/honoDirectFetcher.ts"],"names":[],"mappings":";;;AAGO,IAAM,iBAAA,GAAoB,CAChC,OAAA,KACyB;AACzB,EAAA,OAAO,WAAA,CAAe,CAAC,OAAA,EAAS,IAAA,KAAS;AACxC,IAAA,OAAO,MAAM,CAAA,EAAG,OAAO,CAAA,EAAG,OAAO,IAAI,IAAI,CAAA;AAAA,EAC1C,CAAC,CAAA;AACF","file":"chunk-QEZAY63D.js","sourcesContent":["import type { Hono } from \"hono\";\nimport { honoFetcher, type TypedHonoFetcher } from \"./honoFetcher\";\n\nexport const honoDirectFetcher = <T extends Hono>(\n\tbaseUrl: string,\n): TypedHonoFetcher<T> => {\n\treturn honoFetcher<T>((request, init) => {\n\t\treturn fetch(`${baseUrl}${request}`, init) as ReturnType<T[\"request\"]>;\n\t});\n};\n"]}

package/dist/honoDirectFetcher.js

@@ -1,4 +1,4 @@
-export { honoDirectFetcher } from './chunk-MZBZTJN5.js';
-import './chunk-5KDMHM65.js';
+export { honoDirectFetcher } from './chunk-QEZAY63D.js';
+import './chunk-IL7N6DHV.js';
 //# sourceMappingURL=honoDirectFetcher.js.map
 //# sourceMappingURL=honoDirectFetcher.js.map

package/dist/honoDoFetcher.d.ts

@@ -4,6 +4,20 @@ import { type BaseDisposableTypedHonoFetcher, type TypedHonoFetcher } from "./ho
 export type DOWithHonoApp<S extends Schema = Schema> = Rpc.DurableObjectBranded & {
     app: Hono<any, S>;
 };
+/**
+ * Nameable RPC surface for a Durable Object class that exposes a Hono `app`.
+ * Use when exporting types for `Env` bindings (avoids Alchemy `TS2883` when the
+ * full DO class type cannot be named in generated declarations).
+ *
+ * @example
+ * ```ts
+ * export type ChatroomDoRpc = DoRpcWithApp<ChatroomDo>;
+ * // Env: { CHATROOM: DurableObjectNamespace<ChatroomDoRpc> }
+ * ```
+ */
+export type DoRpcWithApp<T extends {
+    app: Hono;
+}> = Rpc.DurableObjectBranded & Pick<T, "app">;
 export type DOSchemaMap<T extends DOWithHonoApp> = T extends DOWithHonoApp ? ExtractSchema<T["app"]> : never;
 export type DOSchemaKeys<T extends DOWithHonoApp> = string & keyof DOSchemaMap<T>;
 export type DOStubSchema<T extends DurableObjectStub> = T extends DurableObjectStub<infer S> ? S extends DOWithHonoApp ? ExtractSchema<S["app"]> : never : never;

package/dist/honoDoFetcher.js

@@ -1,4 +1,4 @@
-export { honoDoFetcher, honoDoFetcherWithId, honoDoFetcherWithName } from './chunk-WN4MD3WJ.js';
-import './chunk-5KDMHM65.js';
+export { honoDoFetcher, honoDoFetcherWithId, honoDoFetcherWithName } from './chunk-CHQGE36J.js';
+import './chunk-IL7N6DHV.js';
 //# sourceMappingURL=honoDoFetcher.js.map
 //# sourceMappingURL=honoDoFetcher.js.map

package/dist/honoFetcher.d.ts

@@ -37,19 +37,28 @@ export type HonoFetcherQueryParamValue = string | number | boolean;
 export type HonoFetcherQueryParams = Record<string, HonoFetcherQueryParamValue | null | undefined>;
 type FetcherParams<SchemaPath extends string> = HasPathParams<SchemaPath> extends true ? {
     params: ParsePathParams<SchemaPath>;
-    query?: HonoFetcherQueryParams;
-    init?: RequestInit;
+    query?: HonoFetcherQueryParams | undefined;
+    init?: RequestInit | undefined;
 } : {
     params?: never;
-    query?: HonoFetcherQueryParams;
-    init?: RequestInit;
+    query?: HonoFetcherQueryParams | undefined;
+    init?: RequestInit | undefined;
 };
 type EmptyObject = {};
 type TypedMethodFetcher<T extends Hono, M extends HttpMethod> = <SchemaPath extends string & keyof HonoSchema<T>[M]>(request: {
     url: SchemaPath;
 } & FetcherParams<SchemaPath> & (M extends "get" | "delete" ? EmptyObject : BodyParams<T, M, SchemaPath>)) => Promise<SchemaOutput<T, M, SchemaPath>>;
-type SchemaOutput<T extends Hono, M extends HttpMethod, SchemaPath extends string & keyof HonoSchema<T>[M], DollarM extends `$${M}` & keyof HonoSchema<T>[M][SchemaPath] = `$${M}` & keyof HonoSchema<T>[M][SchemaPath]> = "output" extends keyof HonoSchema<T>[M][SchemaPath][DollarM] ? JsonResponse<HonoSchema<T>[M][SchemaPath][DollarM]["output"]> : never;
-type DoSchemaOutput<T extends Hono, M extends HttpMethod, SchemaPath extends string & keyof HonoSchema<T>[M], DollarM extends `$${M}` & keyof HonoSchema<T>[M][SchemaPath] = `$${M}` & keyof HonoSchema<T>[M][SchemaPath]> = "output" extends keyof HonoSchema<T>[M][SchemaPath][DollarM] ? RpcDisposableJsonResponse<HonoSchema<T>[M][SchemaPath][DollarM]["output"]> : never;
+/**
+ * `@hono/zod-validator` (0.8+) unions Zod 400 JSON bodies into route `output`.
+ * Fetcher clients only model successful handler responses.
+ */
+type ExcludeZodValidatorFailureOutput<T> = Exclude<T, {
+    success: false;
+    error: unknown;
+}>;
+type HonoRouteOutput<T extends Hono, M extends HttpMethod, SchemaPath extends string & keyof HonoSchema<T>[M], DollarM extends `$${M}` & keyof HonoSchema<T>[M][SchemaPath] = `$${M}` & keyof HonoSchema<T>[M][SchemaPath]> = "output" extends keyof HonoSchema<T>[M][SchemaPath][DollarM] ? ExcludeZodValidatorFailureOutput<HonoSchema<T>[M][SchemaPath][DollarM]["output"]> : never;
+type SchemaOutput<T extends Hono, M extends HttpMethod, SchemaPath extends string & keyof HonoSchema<T>[M], DollarM extends `$${M}` & keyof HonoSchema<T>[M][SchemaPath] = `$${M}` & keyof HonoSchema<T>[M][SchemaPath]> = "output" extends keyof HonoSchema<T>[M][SchemaPath][DollarM] ? JsonResponse<HonoRouteOutput<T, M, SchemaPath, DollarM>> : never;
+type DoSchemaOutput<T extends Hono, M extends HttpMethod, SchemaPath extends string & keyof HonoSchema<T>[M], DollarM extends `$${M}` & keyof HonoSchema<T>[M][SchemaPath] = `$${M}` & keyof HonoSchema<T>[M][SchemaPath]> = "output" extends keyof HonoSchema<T>[M][SchemaPath][DollarM] ? RpcDisposableJsonResponse<HonoRouteOutput<T, M, SchemaPath, DollarM>> : never;
 type BodyParams<TApp extends Hono, TMethod extends HttpMethod, SchemaPath extends string & keyof HonoSchema<TApp>[TMethod], DollarMethod extends `$${TMethod}` & keyof HonoSchema<TApp>[TMethod][SchemaPath] = `$${TMethod}` & keyof HonoSchema<TApp>[TMethod][SchemaPath]> = "input" extends keyof HonoSchema<TApp>[TMethod][SchemaPath][DollarMethod] ? "json" extends keyof HonoSchema<TApp>[TMethod][SchemaPath][DollarMethod]["input"] ? "form" extends keyof HonoSchema<TApp>[TMethod][SchemaPath][DollarMethod]["input"] ? {
     body: HonoSchema<TApp>[TMethod][SchemaPath][DollarMethod]["input"]["json"];
 } | {
@@ -76,13 +85,13 @@ export interface WebSocketConfig {
      *
      * @default true
      */
-    autoAccept?: boolean;
+    autoAccept?: boolean | undefined;
     /**
      * Arguments for Cloudflare’s `WebSocket#accept` (e.g. `{ allowHalfOpen: true }` when
      * [proxying](https://developers.cloudflare.com/workers/runtime-apis/websockets/#close-behavior)
      * and coordinating close on both sides). Used only when `autoAccept` is true.
      */
-    acceptOptions?: WebSocketAcceptOptions;
+    acceptOptions?: WebSocketAcceptOptions | undefined;
 }
 export type TypedWebSocketFetcher<T extends Hono> = <SchemaPath extends string & keyof HonoSchema<T>["get"]>(request: {
     url: SchemaPath;

package/dist/honoFetcher.js

@@ -1,3 +1,3 @@
-export { honoFetcher } from './chunk-5KDMHM65.js';
+export { honoFetcher } from './chunk-IL7N6DHV.js';
 //# sourceMappingURL=honoFetcher.js.map
 //# sourceMappingURL=honoFetcher.js.map

package/dist/honoFetcherMounted.d.ts

@@ -0,0 +1,62 @@
+import type { Hono } from "hono";
+import type { Env, Schema } from "hono/types";
+import type { ExtractSchema } from "hono/types";
+import { type ParsePathParams, type TypedHonoFetcher } from "./honoFetcher";
+type SchemaRouteKeys<T extends Hono> = string & keyof ExtractSchema<T>;
+/**
+ * Client-side view of a Hono app: same routes/schema as the server app but without
+ * server `Bindings` (service-binding and browser clients do not send Worker env).
+ *
+ * Use with a **sub-app** type when the mount path is only on the worker (e.g. mount
+ * `/admin` but routes on the type are `/users`). For typed mount prefixes derived from
+ * full worker paths, pass the **worker app** type and use {@link MountedClientApp}.
+ */
+export type HonoClientApp<T extends Hono> = T extends Hono<infer E extends Env, infer S extends Schema, infer BasePath extends string> ? Hono<Omit<E, "Bindings">, S, BasePath> : never;
+type HasMorePathSegments<Rest extends string> = Rest extends `${string}/${string}` | `:${string}/${string}` ? true : false;
+type MountPrefixesWithPrefix<Prefix extends string, Route extends string> = Route extends `/${infer Seg}/${infer Rest}` ? HasMorePathSegments<Rest> extends true ? `${Prefix}/${Seg}` | MountPrefixesWithPrefix<`${Prefix}/${Seg}`, `/${Rest}`> : `${Prefix}/${Seg}` : never;
+/** Every mount prefix along a route (`/a/b/c` → `/a` | `/a/b`). */
+type MountPrefixesOfRoute<Route extends string> = Route extends `/${infer Seg}/${infer Rest}` ? HasMorePathSegments<Rest> extends true ? `/${Seg}` | MountPrefixesWithPrefix<`/${Seg}`, `/${Rest}`> : `/${Seg}` : never;
+/**
+ * Mount prefix valid when the worker app schema has routes under `${M}/…`.
+ * Includes multi-segment prefixes (`/nested/deep`) and param segments (`/level1/:param`).
+ * Excludes top-level-only routes (`/users`, `/x`) — use {@link honoFetcher} for those.
+ */
+export type ValidMountPrefix<T extends Hono> = MountPrefixesOfRoute<SchemaRouteKeys<T>>;
+/** Path params required when the mount path contains `:param` segments. */
+export type MountPathParams<M extends string> = ParsePathParams<M>;
+type StripMountRoute<Route extends string, Mount extends string> = Route extends `${Mount}/${infer Rest}` ? `/${Rest}` : never;
+type MountedSchema<T extends Hono, Mount extends string> = {
+    [Route in SchemaRouteKeys<T> as StripMountRoute<Route, Mount> extends infer Stripped extends string ? Stripped : never]: ExtractSchema<T>[Route];
+} & Schema;
+/**
+ * Client view of routes under `Mount` on a **worker app** whose schema keys are full
+ * paths (e.g. `/admin/users` → client `url: "/users"` when `Mount` is `"/admin"`).
+ */
+export type MountedClientApp<T extends Hono, Mount extends string> = T extends Hono<infer E extends Env, infer _S extends Schema, infer BasePath extends string> ? Hono<Omit<E, "Bindings">, MountedSchema<T, Mount>, BasePath> : never;
+type ParentFetcher = (request: string, init?: RequestInit) => Response | Promise<Response>;
+/**
+ * Typed client for routes under `mountPath`, using `app.request` as transport.
+ * Infers both the app schema and (when valid) stripped mount paths — no type args needed.
+ *
+ * When `mountPath` contains `:param` segments, pass `mountParams` (same shape as route
+ * `params` on {@link honoFetcher}).
+ */
+export declare function honoFetcherMounted<T extends Hono, const M extends ValidMountPrefix<T>>(app: T, mountPath: M, mountParams: MountPathParams<M>): TypedHonoFetcher<MountedClientApp<T, M>>;
+export declare function honoFetcherMounted<T extends Hono, const M extends ValidMountPrefix<T>>(app: T, mountPath: M): TypedHonoFetcher<MountedClientApp<T, M>>;
+/**
+ * Typed client for routes under `mountPath` on a parent fetcher.
+ *
+ * Use when transport is not `app.request` (service bindings, DO stubs, browser `fetch`, etc.).
+ *
+ * - **Worker app type** (schema keys include the mount, e.g. `/admin/users`): pass
+ *   `typeof workerApp` and a {@link ValidMountPrefix}; client `url` values are paths
+ *   **after** the mount (`/users`, not `/admin/users`). Prefer {@link honoFetcherMounted}
+ *   with the app instance when using `app.request`.
+ * - **Sub-app type** (routes are `/users` on the sub-app, mount is only on the worker):
+ *   pass `typeof adminRoutes` and the worker mount string (`"/admin"`); client URLs
+ *   match the sub-app schema.
+ */
+export declare function honoFetcherMounted<T extends Hono>(parentFetcher: ParentFetcher, mountPath: string, mountParams?: Record<string, string>): TypedHonoFetcher<HonoClientApp<T>>;
+export declare function honoFetcherMounted<T extends Hono, const M extends ValidMountPrefix<T>>(parentFetcher: ParentFetcher, mountPath: M, mountParams: MountPathParams<M>): TypedHonoFetcher<MountedClientApp<T, M>>;
+export declare function honoFetcherMounted<T extends Hono, const M extends ValidMountPrefix<T>>(parentFetcher: ParentFetcher, mountPath: M): TypedHonoFetcher<MountedClientApp<T, M>>;
+export {};

package/dist/honoFetcherMounted.js

@@ -0,0 +1,4 @@
+export { honoFetcherMounted } from './chunk-2V3BY5GN.js';
+import './chunk-IL7N6DHV.js';
+//# sourceMappingURL=honoFetcherMounted.js.map
+//# sourceMappingURL=honoFetcherMounted.js.map

package/dist/honoFetcherMounted.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"honoFetcherMounted.js"}

package/dist/index.d.ts

@@ -1,5 +1,7 @@
-export { honoDirectFetcher } from "./honoDirectFetcher.js";
-export type { DOSchemaKeys, DOSchemaMap, DOStubSchema, DOWithHonoApp, HonoDoFetcherStubInput, TypedDoFetcher, } from "./honoDoFetcher.js";
-export { honoDoFetcher, honoDoFetcherWithId, honoDoFetcherWithName, } from "./honoDoFetcher.js";
-export type { BaseDisposableTypedHonoFetcher, BaseTypedHonoFetcher, HonoFetcherQueryParamValue, HonoFetcherQueryParams, HonoSchemaKeys, HttpMethod, JsonResponse, ParsePathParams, RpcDisposableJsonResponse, TypedDisposableWebSocketFetcher, TypedHonoFetcher, TypedWebSocketFetcher, WebSocketConfig, } from "./honoFetcher.js";
-export { honoFetcher } from "./honoFetcher.js";
+export { honoDirectFetcher } from "./honoDirectFetcher";
+export type { HonoClientApp, MountedClientApp, MountPathParams, ValidMountPrefix, } from "./honoFetcherMounted";
+export { honoFetcherMounted } from "./honoFetcherMounted";
+export type { DoRpcWithApp, DOSchemaKeys, DOSchemaMap, DOStubSchema, DOWithHonoApp, HonoDoFetcherStubInput, TypedDoFetcher, } from "./honoDoFetcher";
+export { honoDoFetcher, honoDoFetcherWithId, honoDoFetcherWithName, } from "./honoDoFetcher";
+export type { BaseDisposableTypedHonoFetcher, BaseTypedHonoFetcher, HonoFetcherQueryParamValue, HonoFetcherQueryParams, HonoSchemaKeys, HttpMethod, JsonResponse, ParsePathParams, RpcDisposableJsonResponse, TypedDisposableWebSocketFetcher, TypedHonoFetcher, TypedWebSocketFetcher, WebSocketConfig, } from "./honoFetcher";
+export { honoFetcher } from "./honoFetcher";

package/dist/index.js

@@ -1,5 +1,6 @@
-export { honoDirectFetcher } from './chunk-MZBZTJN5.js';
-export { honoDoFetcher, honoDoFetcherWithId, honoDoFetcherWithName } from './chunk-WN4MD3WJ.js';
-export { honoFetcher } from './chunk-5KDMHM65.js';
+export { honoDirectFetcher } from './chunk-QEZAY63D.js';
+export { honoDoFetcher, honoDoFetcherWithId, honoDoFetcherWithName } from './chunk-CHQGE36J.js';
+export { honoFetcherMounted } from './chunk-2V3BY5GN.js';
+export { honoFetcher } from './chunk-IL7N6DHV.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@firtoz/hono-fetcher",
-	"version": "2.7.2",
+	"version": "2.8.1",
 	"description": "Type-safe Hono API client with full TypeScript inference for routes, params, and payloads",
 	"type": "module",
 	"main": "./dist/index.js",
@@ -56,8 +56,8 @@
 		"url": "https://github.com/firtoz/fullstack-toolkit/issues"
 	},
 	"peerDependencies": {
-		"@cloudflare/workers-types": "^4.20260423.1",
-		"hono": "^4.12.14"
+		"@cloudflare/workers-types": "^4.20260529.1",
+		"hono": "^4.12.23"
 	},
 	"engines": {
 		"node": ">=18.0.0"
@@ -66,9 +66,9 @@
 		"access": "public"
 	},
 	"devDependencies": {
-		"@hono/node-server": "^2.0.0",
-		"@hono/zod-validator": "^0.7.6",
-		"bun-types": "^1.3.13",
-		"zod": "^4.3.6"
+		"@hono/node-server": "^2.0.4",
+		"@hono/zod-validator": "^0.8.0",
+		"bun-types": "^1.3.14",
+		"zod": "^4.4.3"
 	}
 }

package/src/honoDoFetcher.ts

@@ -14,6 +14,20 @@ export type DOWithHonoApp<S extends Schema = Schema> =
 		app: Hono<any, S>;
 	};
 
+/**
+ * Nameable RPC surface for a Durable Object class that exposes a Hono `app`.
+ * Use when exporting types for `Env` bindings (avoids Alchemy `TS2883` when the
+ * full DO class type cannot be named in generated declarations).
+ *
+ * @example
+ * ```ts
+ * export type ChatroomDoRpc = DoRpcWithApp<ChatroomDo>;
+ * // Env: { CHATROOM: DurableObjectNamespace<ChatroomDoRpc> }
+ * ```
+ */
+export type DoRpcWithApp<T extends { app: Hono }> = Rpc.DurableObjectBranded &
+	Pick<T, "app">;
+
 export type DOSchemaMap<T extends DOWithHonoApp> = T extends DOWithHonoApp
 	? ExtractSchema<T["app"]>
 	: never;

package/src/honoFetcher.ts

@@ -91,13 +91,13 @@ type FetcherParams<SchemaPath extends string> =
 	HasPathParams<SchemaPath> extends true
 		? {
 				params: ParsePathParams<SchemaPath>;
-				query?: HonoFetcherQueryParams;
-				init?: RequestInit;
+				query?: HonoFetcherQueryParams | undefined;
+				init?: RequestInit | undefined;
 			}
 		: {
 				params?: never;
-				query?: HonoFetcherQueryParams;
-				init?: RequestInit;
+				query?: HonoFetcherQueryParams | undefined;
+				init?: RequestInit | undefined;
 			};
 
 // biome-ignore lint/complexity/noBannedTypes: We need an empty object to remove the body and form keys from the request object
@@ -112,6 +112,27 @@ type TypedMethodFetcher<T extends Hono, M extends HttpMethod> = <
 		(M extends "get" | "delete" ? EmptyObject : BodyParams<T, M, SchemaPath>),
 ) => Promise<SchemaOutput<T, M, SchemaPath>>;
 
+/**
+ * `@hono/zod-validator` (0.8+) unions Zod 400 JSON bodies into route `output`.
+ * Fetcher clients only model successful handler responses.
+ */
+type ExcludeZodValidatorFailureOutput<T> = Exclude<
+	T,
+	{ success: false; error: unknown }
+>;
+
+type HonoRouteOutput<
+	T extends Hono,
+	M extends HttpMethod,
+	SchemaPath extends string & keyof HonoSchema<T>[M],
+	DollarM extends `$${M}` & keyof HonoSchema<T>[M][SchemaPath] = `$${M}` &
+		keyof HonoSchema<T>[M][SchemaPath],
+> = "output" extends keyof HonoSchema<T>[M][SchemaPath][DollarM]
+	? ExcludeZodValidatorFailureOutput<
+			HonoSchema<T>[M][SchemaPath][DollarM]["output"]
+		>
+	: never;
+
 type SchemaOutput<
 	T extends Hono,
 	M extends HttpMethod,
@@ -119,7 +140,7 @@ type SchemaOutput<
 	DollarM extends `$${M}` & keyof HonoSchema<T>[M][SchemaPath] = `$${M}` &
 		keyof HonoSchema<T>[M][SchemaPath],
 > = "output" extends keyof HonoSchema<T>[M][SchemaPath][DollarM]
-	? JsonResponse<HonoSchema<T>[M][SchemaPath][DollarM]["output"]>
+	? JsonResponse<HonoRouteOutput<T, M, SchemaPath, DollarM>>
 	: never;
 
 type DoSchemaOutput<
@@ -129,7 +150,7 @@ type DoSchemaOutput<
 	DollarM extends `$${M}` & keyof HonoSchema<T>[M][SchemaPath] = `$${M}` &
 		keyof HonoSchema<T>[M][SchemaPath],
 > = "output" extends keyof HonoSchema<T>[M][SchemaPath][DollarM]
-	? RpcDisposableJsonResponse<HonoSchema<T>[M][SchemaPath][DollarM]["output"]>
+	? RpcDisposableJsonResponse<HonoRouteOutput<T, M, SchemaPath, DollarM>>
 	: never;
 
 type BodyParams<
@@ -173,13 +194,13 @@ export interface WebSocketConfig {
 	 *
 	 * @default true
 	 */
-	autoAccept?: boolean;
+	autoAccept?: boolean | undefined;
 	/**
 	 * Arguments for Cloudflare’s `WebSocket#accept` (e.g. `{ allowHalfOpen: true }` when
 	 * [proxying](https://developers.cloudflare.com/workers/runtime-apis/websockets/#close-behavior)
 	 * and coordinating close on both sides). Used only when `autoAccept` is true.
 	 */
-	acceptOptions?: WebSocketAcceptOptions;
+	acceptOptions?: WebSocketAcceptOptions | undefined;
 }
 
 export type TypedWebSocketFetcher<T extends Hono> = <

package/src/honoFetcherMounted.ts

@@ -0,0 +1,227 @@
+import type { Hono } from "hono";
+import { Hono as HonoClass } from "hono";
+import type { Env, Schema } from "hono/types";
+import type { ExtractSchema } from "hono/types";
+import {
+	honoFetcher,
+	type ParsePathParams,
+	type TypedHonoFetcher,
+} from "./honoFetcher";
+
+type SchemaRouteKeys<T extends Hono> = string & keyof ExtractSchema<T>;
+
+/**
+ * Client-side view of a Hono app: same routes/schema as the server app but without
+ * server `Bindings` (service-binding and browser clients do not send Worker env).
+ *
+ * Use with a **sub-app** type when the mount path is only on the worker (e.g. mount
+ * `/admin` but routes on the type are `/users`). For typed mount prefixes derived from
+ * full worker paths, pass the **worker app** type and use {@link MountedClientApp}.
+ */
+export type HonoClientApp<T extends Hono> =
+	T extends Hono<
+		infer E extends Env,
+		infer S extends Schema,
+		infer BasePath extends string
+	>
+		? Hono<Omit<E, "Bindings">, S, BasePath>
+		: never;
+
+type HasMorePathSegments<Rest extends string> = Rest extends
+	| `${string}/${string}`
+	| `:${string}/${string}`
+	? true
+	: false;
+
+type MountPrefixesWithPrefix<
+	Prefix extends string,
+	Route extends string,
+> = Route extends `/${infer Seg}/${infer Rest}`
+	? HasMorePathSegments<Rest> extends true
+		?
+				| `${Prefix}/${Seg}`
+				| MountPrefixesWithPrefix<`${Prefix}/${Seg}`, `/${Rest}`>
+		: `${Prefix}/${Seg}`
+	: never;
+
+/** Every mount prefix along a route (`/a/b/c` → `/a` | `/a/b`). */
+type MountPrefixesOfRoute<Route extends string> =
+	Route extends `/${infer Seg}/${infer Rest}`
+		? HasMorePathSegments<Rest> extends true
+			? `/${Seg}` | MountPrefixesWithPrefix<`/${Seg}`, `/${Rest}`>
+			: `/${Seg}`
+		: never;
+
+/**
+ * Mount prefix valid when the worker app schema has routes under `${M}/…`.
+ * Includes multi-segment prefixes (`/nested/deep`) and param segments (`/level1/:param`).
+ * Excludes top-level-only routes (`/users`, `/x`) — use {@link honoFetcher} for those.
+ */
+export type ValidMountPrefix<T extends Hono> = MountPrefixesOfRoute<
+	SchemaRouteKeys<T>
+>;
+
+/** Path params required when the mount path contains `:param` segments. */
+export type MountPathParams<M extends string> = ParsePathParams<M>;
+
+type StripMountRoute<
+	Route extends string,
+	Mount extends string,
+> = Route extends `${Mount}/${infer Rest}` ? `/${Rest}` : never;
+
+type MountedSchema<T extends Hono, Mount extends string> = {
+	[Route in SchemaRouteKeys<T> as StripMountRoute<
+		Route,
+		Mount
+	> extends infer Stripped extends string
+		? Stripped
+		: never]: ExtractSchema<T>[Route];
+} & Schema;
+
+/**
+ * Client view of routes under `Mount` on a **worker app** whose schema keys are full
+ * paths (e.g. `/admin/users` → client `url: "/users"` when `Mount` is `"/admin"`).
+ */
+export type MountedClientApp<T extends Hono, Mount extends string> =
+	T extends Hono<
+		infer E extends Env,
+		infer _S extends Schema,
+		infer BasePath extends string
+	>
+		? Hono<Omit<E, "Bindings">, MountedSchema<T, Mount>, BasePath>
+		: never;
+
+type ClientAppForMount<T extends Hono, M extends string> =
+	M extends ValidMountPrefix<T> ? MountedClientApp<T, M> : HonoClientApp<T>;
+
+type MountParamsArg<M extends string> =
+	ParsePathParams<M> extends never ? undefined : ParsePathParams<M>;
+
+function normalizeMountPath(mountPath: string): string {
+	const trimmed = mountPath.trim();
+	if (trimmed === "" || trimmed === "/") {
+		return "";
+	}
+	const withLeading = trimmed.startsWith("/") ? trimmed : `/${trimmed}`;
+	return withLeading.endsWith("/") ? withLeading.slice(0, -1) : withLeading;
+}
+
+function substitutePathParams(
+	path: string,
+	params: Record<string, string>,
+): string {
+	return Object.entries(params).reduce(
+		(acc, [key, value]) => acc.replace(`:${key}`, value),
+		path,
+	);
+}
+
+type ParentFetcher = (
+	request: string,
+	init?: RequestInit,
+) => Response | Promise<Response>;
+
+function createMountedFetcher<
+	T extends Hono,
+	const M extends ValidMountPrefix<T> | string,
+>(
+	parentFetcher: ParentFetcher,
+	mountPath: M,
+	mountParams?: MountParamsArg<M>,
+): TypedHonoFetcher<
+	M extends ValidMountPrefix<T> ? MountedClientApp<T, M> : HonoClientApp<T>
+> {
+	const normalized = normalizeMountPath(mountPath);
+	const prefix =
+		mountParams === undefined
+			? normalized
+			: substitutePathParams(normalized, mountParams as Record<string, string>);
+	return honoFetcher<ClientAppForMount<T, M>>((request, init) => {
+		const path = request.startsWith("/") ? request : `/${request}`;
+		const url = prefix === "" ? path : `${prefix}${path}`;
+		return parentFetcher(url, init) as ReturnType<
+			ClientAppForMount<T, M>["request"]
+		>;
+	}) as TypedHonoFetcher<
+		M extends ValidMountPrefix<T> ? MountedClientApp<T, M> : HonoClientApp<T>
+	>;
+}
+
+function isHonoApp(value: ParentFetcher | Hono): value is Hono {
+	return value instanceof HonoClass;
+}
+
+/**
+ * Typed client for routes under `mountPath`, using `app.request` as transport.
+ * Infers both the app schema and (when valid) stripped mount paths — no type args needed.
+ *
+ * When `mountPath` contains `:param` segments, pass `mountParams` (same shape as route
+ * `params` on {@link honoFetcher}).
+ */
+export function honoFetcherMounted<
+	T extends Hono,
+	const M extends ValidMountPrefix<T>,
+>(
+	app: T,
+	mountPath: M,
+	mountParams: MountPathParams<M>,
+): TypedHonoFetcher<MountedClientApp<T, M>>;
+
+export function honoFetcherMounted<
+	T extends Hono,
+	const M extends ValidMountPrefix<T>,
+>(app: T, mountPath: M): TypedHonoFetcher<MountedClientApp<T, M>>;
+
+/**
+ * Typed client for routes under `mountPath` on a parent fetcher.
+ *
+ * Use when transport is not `app.request` (service bindings, DO stubs, browser `fetch`, etc.).
+ *
+ * - **Worker app type** (schema keys include the mount, e.g. `/admin/users`): pass
+ *   `typeof workerApp` and a {@link ValidMountPrefix}; client `url` values are paths
+ *   **after** the mount (`/users`, not `/admin/users`). Prefer {@link honoFetcherMounted}
+ *   with the app instance when using `app.request`.
+ * - **Sub-app type** (routes are `/users` on the sub-app, mount is only on the worker):
+ *   pass `typeof adminRoutes` and the worker mount string (`"/admin"`); client URLs
+ *   match the sub-app schema.
+ */
+export function honoFetcherMounted<T extends Hono>(
+	parentFetcher: ParentFetcher,
+	mountPath: string,
+	mountParams?: Record<string, string>,
+): TypedHonoFetcher<HonoClientApp<T>>;
+
+export function honoFetcherMounted<
+	T extends Hono,
+	const M extends ValidMountPrefix<T>,
+>(
+	parentFetcher: ParentFetcher,
+	mountPath: M,
+	mountParams: MountPathParams<M>,
+): TypedHonoFetcher<MountedClientApp<T, M>>;
+
+export function honoFetcherMounted<
+	T extends Hono,
+	const M extends ValidMountPrefix<T>,
+>(
+	parentFetcher: ParentFetcher,
+	mountPath: M,
+): TypedHonoFetcher<MountedClientApp<T, M>>;
+
+export function honoFetcherMounted<
+	T extends Hono,
+	const M extends ValidMountPrefix<T> | string,
+>(
+	appOrFetcher: T | ParentFetcher,
+	mountPath: M,
+	mountParams?: MountParamsArg<M>,
+): TypedHonoFetcher<HonoClientApp<T> | MountedClientApp<T, M>> {
+	const parentFetcher = isHonoApp(appOrFetcher)
+		? (url: string, init?: RequestInit) => appOrFetcher.request(url, init)
+		: appOrFetcher;
+	return createMountedFetcher<T, M>(
+		parentFetcher,
+		mountPath,
+		mountParams,
+	) as TypedHonoFetcher<HonoClientApp<T> | MountedClientApp<T, M>>;
+}

package/src/index.ts

@@ -1,19 +1,28 @@
 // Convenience wrapper for direct HTTP fetching
-export { honoDirectFetcher } from "./honoDirectFetcher.js";
+export { honoDirectFetcher } from "./honoDirectFetcher";
+// Mounted sub-app client
+export type {
+	HonoClientApp,
+	MountedClientApp,
+	MountPathParams,
+	ValidMountPrefix,
+} from "./honoFetcherMounted";
+export { honoFetcherMounted } from "./honoFetcherMounted";
 // Durable Object integration
 export type {
+	DoRpcWithApp,
 	DOSchemaKeys,
 	DOSchemaMap,
 	DOStubSchema,
 	DOWithHonoApp,
 	HonoDoFetcherStubInput,
 	TypedDoFetcher,
-} from "./honoDoFetcher.js";
+} from "./honoDoFetcher";
 export {
 	honoDoFetcher,
 	honoDoFetcherWithId,
 	honoDoFetcherWithName,
-} from "./honoDoFetcher.js";
+} from "./honoDoFetcher";
 // Core fetcher functionality
 export type {
 	BaseDisposableTypedHonoFetcher,
@@ -29,5 +38,5 @@ export type {
 	TypedHonoFetcher,
 	TypedWebSocketFetcher,
 	WebSocketConfig,
-} from "./honoFetcher.js";
-export { honoFetcher } from "./honoFetcher.js";
+} from "./honoFetcher";
+export { honoFetcher } from "./honoFetcher";

package/dist/chunk-5KDMHM65.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/honoFetcher.ts"],"names":[],"mappings":"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","file":"chunk-5KDMHM65.js","sourcesContent":["import type { Hono } from \"hono\";\nimport type { ExtractSchema } from \"hono/types\";\n\nexport type ParsePathParams<T extends string> =\n\tT extends `${infer _Start}/:${infer Param}/${infer Rest}`\n\t\t? { [K in Param | keyof ParsePathParams<`/${Rest}`>]: string }\n\t\t: T extends `${infer _Start}/:${infer Param}`\n\t\t\t? { [K in Param]: string }\n\t\t\t: never;\n\nexport type HttpMethod = \"get\" | \"post\" | \"put\" | \"delete\" | \"patch\";\n\nexport type HonoSchemaKeys<T extends Hono> = string & keyof ExtractSchema<T>;\n\ntype FilterKeysByMethod<\n\tTApp extends ExtractSchema<unknown>,\n\tTMethod extends HttpMethod,\n> = {\n\t[K in keyof TApp as TApp[K] extends { [key in `$${TMethod}`]: unknown }\n\t\t? K\n\t\t: never]: TApp[K];\n};\n\ntype HonoSchema<TApp extends Hono> = {\n\t[M in HttpMethod]: FilterKeysByMethod<ExtractSchema<TApp>, M>;\n};\n\nexport type JsonResponse<T> = Omit<Response, \"json\"> & {\n\tjson: () => Promise<T>;\n};\n\n/**\n * {@link JsonResponse} intersected with `Disposable` for Workers RPC: `Response`\n * values from `DurableObjectStub#fetch()` may implement `[Symbol.dispose]` even\n * though `Fetcher.fetch` is still typed as `Promise<Response>`. Use with\n * {@link BaseDisposableTypedHonoFetcher} (and `TypedDoFetcher` from `./honoDoFetcher`) so\n * `using resp = await api.get(...)` type-checks when `\"ESNext.Disposable\"` is in `lib`.\n *\n * @see https://developers.cloudflare.com/workers/runtime-apis/rpc/lifecycle/\n */\nexport type RpcDisposableJsonResponse<T> = JsonResponse<T> & Disposable;\n\ntype HasPathParams<T extends string> = T extends `${string}:${string}`\n\t? true\n\t: false;\n\n/**\n * Values allowed in the optional `query` object on fetcher requests.\n * `null` and `undefined` entries are omitted from the serialized query string.\n */\nexport type HonoFetcherQueryParamValue = string | number | boolean;\n\nexport type HonoFetcherQueryParams = Record<\n\tstring,\n\tHonoFetcherQueryParamValue | null | undefined\n>;\n\nfunction appendQueryString(\n\turl: string,\n\tquery?: HonoFetcherQueryParams,\n): string {\n\tif (!query) {\n\t\treturn url;\n\t}\n\tconst searchParams = new URLSearchParams();\n\tfor (const [key, value] of Object.entries(query)) {\n\t\tif (value === undefined || value === null) {\n\t\t\tcontinue;\n\t\t}\n\t\tsearchParams.append(key, String(value));\n\t}\n\tconst serialized = searchParams.toString();\n\tif (!serialized) {\n\t\treturn url;\n\t}\n\tconst separator = url.includes(\"?\") ? \"&\" : \"?\";\n\treturn `${url}${separator}${serialized}`;\n}\n\n/**\n * `RequestInit` fields that honoFetcher sets must not be overwritten by spreading `...init` last.\n */\nfunction restOfRequestInit(\n\tinit: RequestInit,\n): Omit<RequestInit, \"headers\" | \"body\" | \"method\"> {\n\tconst { headers: _h, body: _b, method: _m, ...rest } = init;\n\treturn rest;\n}\n\ntype FetcherParams<SchemaPath extends string> =\n\tHasPathParams<SchemaPath> extends true\n\t\t? {\n\t\t\t\tparams: ParsePathParams<SchemaPath>;\n\t\t\t\tquery?: HonoFetcherQueryParams;\n\t\t\t\tinit?: RequestInit;\n\t\t\t}\n\t\t: {\n\t\t\t\tparams?: never;\n\t\t\t\tquery?: HonoFetcherQueryParams;\n\t\t\t\tinit?: RequestInit;\n\t\t\t};\n\n// biome-ignore lint/complexity/noBannedTypes: We need an empty object to remove the body and form keys from the request object\ntype EmptyObject = {};\n\ntype TypedMethodFetcher<T extends Hono, M extends HttpMethod> = <\n\tSchemaPath extends string & keyof HonoSchema<T>[M],\n>(\n\trequest: {\n\t\turl: SchemaPath;\n\t} & FetcherParams<SchemaPath> &\n\t\t(M extends \"get\" | \"delete\" ? EmptyObject : BodyParams<T, M, SchemaPath>),\n) => Promise<SchemaOutput<T, M, SchemaPath>>;\n\ntype SchemaOutput<\n\tT extends Hono,\n\tM extends HttpMethod,\n\tSchemaPath extends string & keyof HonoSchema<T>[M],\n\tDollarM extends `$${M}` & keyof HonoSchema<T>[M][SchemaPath] = `$${M}` &\n\t\tkeyof HonoSchema<T>[M][SchemaPath],\n> = \"output\" extends keyof HonoSchema<T>[M][SchemaPath][DollarM]\n\t? JsonResponse<HonoSchema<T>[M][SchemaPath][DollarM][\"output\"]>\n\t: never;\n\ntype DoSchemaOutput<\n\tT extends Hono,\n\tM extends HttpMethod,\n\tSchemaPath extends string & keyof HonoSchema<T>[M],\n\tDollarM extends `$${M}` & keyof HonoSchema<T>[M][SchemaPath] = `$${M}` &\n\t\tkeyof HonoSchema<T>[M][SchemaPath],\n> = \"output\" extends keyof HonoSchema<T>[M][SchemaPath][DollarM]\n\t? RpcDisposableJsonResponse<HonoSchema<T>[M][SchemaPath][DollarM][\"output\"]>\n\t: never;\n\ntype BodyParams<\n\tTApp extends Hono,\n\tTMethod extends HttpMethod,\n\tSchemaPath extends string & keyof HonoSchema<TApp>[TMethod],\n\tDollarMethod extends `$${TMethod}` &\n\t\tkeyof HonoSchema<TApp>[TMethod][SchemaPath] = `$${TMethod}` &\n\t\tkeyof HonoSchema<TApp>[TMethod][SchemaPath],\n> = \"input\" extends keyof HonoSchema<TApp>[TMethod][SchemaPath][DollarMethod]\n\t? \"json\" extends keyof HonoSchema<TApp>[TMethod][SchemaPath][DollarMethod][\"input\"]\n\t\t? \"form\" extends keyof HonoSchema<TApp>[TMethod][SchemaPath][DollarMethod][\"input\"]\n\t\t\t?\n\t\t\t\t\t| {\n\t\t\t\t\t\t\tbody: HonoSchema<TApp>[TMethod][SchemaPath][DollarMethod][\"input\"][\"json\"];\n\t\t\t\t\t  }\n\t\t\t\t\t| {\n\t\t\t\t\t\t\tform: HonoSchema<TApp>[TMethod][SchemaPath][DollarMethod][\"input\"][\"form\"];\n\t\t\t\t\t  }\n\t\t\t: {\n\t\t\t\t\tbody: HonoSchema<TApp>[TMethod][SchemaPath][DollarMethod][\"input\"][\"json\"];\n\t\t\t\t}\n\t\t: \"form\" extends keyof HonoSchema<TApp>[TMethod][SchemaPath][DollarMethod][\"input\"]\n\t\t\t? {\n\t\t\t\t\tform: HonoSchema<TApp>[TMethod][SchemaPath][DollarMethod][\"input\"][\"form\"];\n\t\t\t\t}\n\t\t\t: { body?: unknown } | { form?: unknown }\n\t: EmptyObject;\n\ntype AvailableMethods<T extends Hono> = {\n\t[M in HttpMethod]: keyof HonoSchema<T>[M] extends never ? never : M;\n}[HttpMethod];\n\nexport interface WebSocketConfig {\n\t/**\n\t * Whether to automatically call accept() on the WebSocket before returning.\n\t * Defaults to true for convenience.\n\t *\n\t * In Cloudflare Workers, you must call accept() before using a WebSocket.\n\t * Setting this to false allows you to call accept() manually if needed.\n\t *\n\t * @default true\n\t */\n\tautoAccept?: boolean;\n\t/**\n\t * Arguments for Cloudflare’s `WebSocket#accept` (e.g. `{ allowHalfOpen: true }` when\n\t * [proxying](https://developers.cloudflare.com/workers/runtime-apis/websockets/#close-behavior)\n\t * and coordinating close on both sides). Used only when `autoAccept` is true.\n\t */\n\tacceptOptions?: WebSocketAcceptOptions;\n}\n\nexport type TypedWebSocketFetcher<T extends Hono> = <\n\tSchemaPath extends string & keyof HonoSchema<T>[\"get\"],\n>(\n\trequest: {\n\t\turl: SchemaPath;\n\t\tconfig?: WebSocketConfig;\n\t} & FetcherParams<SchemaPath>,\n) => Promise<Response>;\n\nexport type BaseTypedHonoFetcher<T extends Hono> = {\n\t[M in AvailableMethods<T>]: TypedMethodFetcher<T, M>;\n} & (keyof HonoSchema<T>[\"get\"] extends never\n\t? // biome-ignore lint/complexity/noBannedTypes: We really do want an empty object if the get method is not available\n\t\t{}\n\t: { websocket: TypedWebSocketFetcher<T> });\n\ntype TypedDisposableMethodFetcher<T extends Hono, M extends HttpMethod> = <\n\tSchemaPath extends string & keyof HonoSchema<T>[M],\n>(\n\trequest: {\n\t\turl: SchemaPath;\n\t} & FetcherParams<SchemaPath> &\n\t\t(M extends \"get\" | \"delete\" ? EmptyObject : BodyParams<T, M, SchemaPath>),\n) => Promise<DoSchemaOutput<T, M, SchemaPath>>;\n\nexport type TypedDisposableWebSocketFetcher<T extends Hono> = <\n\tSchemaPath extends string & keyof HonoSchema<T>[\"get\"],\n>(\n\trequest: {\n\t\turl: SchemaPath;\n\t\tconfig?: WebSocketConfig;\n\t} & FetcherParams<SchemaPath>,\n) => Promise<Response & Disposable>;\n\n/**\n * Same shape as {@link BaseTypedHonoFetcher} but HTTP methods return\n * {@link RpcDisposableJsonResponse} and `websocket` returns `Response & Disposable`\n * so `using` on RPC results type-checks for Durable Object clients.\n *\n * @see https://developers.cloudflare.com/workers/runtime-apis/rpc/lifecycle/\n */\nexport type BaseDisposableTypedHonoFetcher<T extends Hono> = {\n\t[M in AvailableMethods<T>]: TypedDisposableMethodFetcher<T, M>;\n} & (keyof HonoSchema<T>[\"get\"] extends never\n\t? // biome-ignore lint/complexity/noBannedTypes: We really do want an empty object if the get method is not available\n\t\t{}\n\t: { websocket: TypedDisposableWebSocketFetcher<T> });\n\nconst createMethodFetcher = <T extends Hono, M extends HttpMethod>(\n\tfetcher: (\n\t\trequest: string,\n\t\tinit?: RequestInit,\n\t) => ReturnType<T[\"request\"]> | Promise<ReturnType<T[\"request\"]>>,\n\tmethod: M,\n): TypedMethodFetcher<T, M> => {\n\treturn (async (request) => {\n\t\tlet finalUrl: string = request.url;\n\n\t\tconst { init = {}, params, query } = request;\n\n\t\tif (params && typeof params === \"object\") {\n\t\t\tfinalUrl = Object.entries(params).reduce((acc, [key, value]) => {\n\t\t\t\treturn acc.replace(`:${key}`, value as string);\n\t\t\t}, finalUrl);\n\t\t}\n\n\t\tfinalUrl = appendQueryString(finalUrl, query);\n\n\t\tconst requestAsOptionalFormBody = request as {\n\t\t\tform?: unknown;\n\t\t\tbody?: unknown;\n\t\t};\n\n\t\tlet body: BodyInit | undefined;\n\t\tif (requestAsOptionalFormBody.form) {\n\t\t\tconst formData = new FormData();\n\t\t\tfor (const [key, value] of Object.entries(\n\t\t\t\trequestAsOptionalFormBody.form,\n\t\t\t)) {\n\t\t\t\tformData.append(key, value as string);\n\t\t\t}\n\t\t\tbody = formData;\n\t\t} else if (requestAsOptionalFormBody.body) {\n\t\t\tbody = JSON.stringify(requestAsOptionalFormBody.body) as BodyInit;\n\t\t}\n\n\t\tconst newHeaders = new Headers(\n\t\t\tinit.headers as unknown as ConstructorParameters<typeof Headers>[0],\n\t\t);\n\n\t\tif (body && !requestAsOptionalFormBody.form) {\n\t\t\tnewHeaders.set(\"Content-Type\", \"application/json\");\n\t\t}\n\n\t\ttry {\n\t\t\treturn await fetcher(finalUrl, {\n\t\t\t\t...restOfRequestInit(init),\n\t\t\t\tmethod: method.toUpperCase(),\n\t\t\t\theaders: newHeaders,\n\t\t\t\t...(body ? { body } : {}),\n\t\t\t});\n\t\t} catch (error) {\n\t\t\tconsole.error(`Error ${method}ing`, error);\n\t\t\tthrow new Error(`Failed to ${method} ${finalUrl}: ${error}`);\n\t\t}\n\t}) as TypedMethodFetcher<T, M>;\n};\n\nconst createWebSocketFetcher = <T extends Hono>(\n\tfetcher: (\n\t\trequest: string,\n\t\tinit?: RequestInit,\n\t) => ReturnType<T[\"request\"]> | Promise<ReturnType<T[\"request\"]>>,\n): TypedWebSocketFetcher<T> => {\n\treturn (async (request) => {\n\t\tlet finalUrl: string = request.url;\n\n\t\tconst { init = {}, params, query, config } = request;\n\t\tconst autoAccept = config?.autoAccept ?? true;\n\t\tconst acceptOptions = config?.acceptOptions;\n\n\t\tif (params && typeof params === \"object\") {\n\t\t\tfinalUrl = Object.entries(params).reduce((acc, [key, value]) => {\n\t\t\t\treturn acc.replace(`:${key}`, value as string);\n\t\t\t}, finalUrl);\n\t\t}\n\n\t\tfinalUrl = appendQueryString(finalUrl, query);\n\n\t\tconst newHeaders = new Headers(\n\t\t\tinit.headers as unknown as ConstructorParameters<typeof Headers>[0],\n\t\t);\n\t\tnewHeaders.set(\"Upgrade\", \"websocket\");\n\n\t\ttry {\n\t\t\tconst response = await fetcher(finalUrl, {\n\t\t\t\t...restOfRequestInit(init),\n\t\t\t\tmethod: \"GET\",\n\t\t\t\theaders: newHeaders,\n\t\t\t});\n\n\t\t\tif (autoAccept && response.webSocket) {\n\t\t\t\tresponse.webSocket.accept(acceptOptions);\n\t\t\t}\n\n\t\t\treturn response;\n\t\t} catch (error) {\n\t\t\tconsole.error(\"Error upgrading to WebSocket\", error);\n\t\t\tthrow new Error(`Failed to upgrade WebSocket at ${finalUrl}: ${error}`);\n\t\t}\n\t}) as TypedWebSocketFetcher<T>;\n};\n\nexport type TypedHonoFetcher<T extends Hono> = BaseTypedHonoFetcher<T>;\n\nexport const honoFetcher = <T extends Hono>(\n\tfetcher: (\n\t\trequest: string,\n\t\tinit?: RequestInit,\n\t) => ReturnType<T[\"request\"]> | Promise<ReturnType<T[\"request\"]>>,\n): TypedHonoFetcher<T> => {\n\tconst methods = [\"get\", \"post\", \"put\", \"delete\", \"patch\"] as const;\n\n\tconst result = methods.reduce(\n\t\t(acc, method) => {\n\t\t\t(\n\t\t\t\tacc as TypedHonoFetcher<T> & {\n\t\t\t\t\t[M in typeof method]: TypedMethodFetcher<T, M>;\n\t\t\t\t}\n\t\t\t)[method] = createMethodFetcher(fetcher, method) as TypedMethodFetcher<\n\t\t\t\tT,\n\t\t\t\ttypeof method\n\t\t\t>;\n\t\t\treturn acc;\n\t\t},\n\t\t{} as TypedHonoFetcher<T>,\n\t);\n\n\t// Add websocket method\n\t(\n\t\tresult as TypedHonoFetcher<T> & { websocket?: TypedWebSocketFetcher<T> }\n\t).websocket = createWebSocketFetcher(fetcher);\n\n\treturn result;\n};\n"]}

package/dist/chunk-WN4MD3WJ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/honoDoFetcher.ts"],"names":[],"mappings":";;;AAQA,IAAM,SAAA,GAAY,kBAAA;AAiDlB,SAAS,eAAA,CAIR,MAEA,GAAA,EAE+C;AAC/C,EAAA,OAAO,MAAA,CAAO,OAAO,GAAA,EAAK;AAAA,IACzB,CAAC,MAAA,CAAO,OAAO,CAAA,GAAI;AAElB,MAAA,MAAM,SAAA,GAAY,OAAA,CAAQ,GAAA,CAAI,IAAA,EAAM,OAAO,OAAO,CAAA;AAClD,MAAA,IAAI,OAAO,cAAc,UAAA,EAAY;AACpC,QAAA;AAAA,MACD;AACA,MAAA,IAAI;AACH,QAAA,SAAA,CAAU,KAAK,IAAI,CAAA;AAAA,MACpB,SAAS,CAAA,EAAG;AACX,QAAA,OAAA,CAAQ,KAAA;AAAA,UACP,2DAAA;AAAA,UACA;AAAA,SACD;AAAA,MACD;AAAA,IACD;AAAA,GACA,CAAA;AACF;AAkBO,IAAM,aAAA,GAAgB,CAC5B,aAAA,KAGyC;AAIzC,EAAA,MAAM,GAAA,GAAM,WAAA,CAAkC,CAAC,GAAA,EAAK,IAAA,KAAS;AAC5D,IAAA,OAAO,cAAc,KAAA,CAAM,CAAA,EAAG,SAAS,CAAA,EAAG,GAAG,IAAI,IAAI,CAAA;AAAA,EACtD,CAAC,CAAA;AACD,EAAA,OAAO,eAAA;AAAA,IACN,aAAA;AAAA,IACA;AAAA,GACD;AAGD;AAEO,IAAM,qBAAA,GAAwB,CAGpC,SAAA,EACA,IAAA,KACuD;AACvD,EAAA,OAAO,aAAA,CAAc,SAAA,CAAU,SAAA,CAAU,IAAI,CAAC,CAAA;AAI/C;AAEO,IAAM,mBAAA,GAAsB,CAGlC,SAAA,EACA,EAAA,KACuD;AACvD,EAAA,OAAO,aAAA;AAAA,IACN,SAAA,CAAU,GAAA,CAAI,SAAA,CAAU,YAAA,CAAa,EAAE,CAAC;AAAA,GACzC;AACD","file":"chunk-WN4MD3WJ.js","sourcesContent":["import type { Hono, Schema } from \"hono\";\nimport type { ExtractSchema } from \"hono/types\";\nimport {\n\thonoFetcher,\n\ttype BaseDisposableTypedHonoFetcher,\n\ttype TypedHonoFetcher,\n} from \"./honoFetcher\";\n\nconst DUMMY_URL = \"http://dummy-url\";\n\nexport type DOWithHonoApp<S extends Schema = Schema> =\n\tRpc.DurableObjectBranded & {\n\t\t// biome-ignore lint/suspicious/noExplicitAny: We need to be able to pass in any schema\n\t\tapp: Hono<any, S>;\n\t};\n\nexport type DOSchemaMap<T extends DOWithHonoApp> = T extends DOWithHonoApp\n\t? ExtractSchema<T[\"app\"]>\n\t: never;\n\nexport type DOSchemaKeys<T extends DOWithHonoApp> = string &\n\tkeyof DOSchemaMap<T>;\n\nexport type DOStubSchema<T extends DurableObjectStub> =\n\tT extends DurableObjectStub<infer S>\n\t\t? S extends DOWithHonoApp\n\t\t\t? ExtractSchema<S[\"app\"]>\n\t\t\t: never\n\t\t: never;\n\n/**\n * Fetcher for a **real** `DurableObjectStub`: HTTP results are {@link RpcDisposableJsonResponse}\n * and `websocket` returns `Response & Disposable`, matching Workers RPC when the runtime attaches\n * disposers. Use with {@link honoDoFetcher} / {@link honoDoFetcherWithName} / {@link honoDoFetcherWithId}\n * when `T` is a full stub—not with a minimal `Pick<stub, \"fetch\">` mock (that path uses plain\n * {@link TypedHonoFetcher} responses instead).\n *\n * @see https://developers.cloudflare.com/workers/runtime-apis/rpc/lifecycle/\n */\nexport type TypedDoFetcher<T extends DurableObjectStub> =\n\tBaseDisposableTypedHonoFetcher<\n\t\t// biome-ignore lint/suspicious/noExplicitAny: Generic parameter needs flexibility\n\t\tHono<any, DOStubSchema<T>>\n\t>;\n\n/**\n * Argument to {@link honoDoFetcher}: a **full** {@link DurableObjectStub} (production) or a minimal\n * **`{ fetch }`** mock. Only the full stub is typed as {@link TypedDoFetcher} with disposable RPC\n * responses; **`Pick<stub, \"fetch\">`** is typed as {@link TypedHonoFetcher} for `Hono` with ordinary\n * `JsonResponse` / `Response` (no `Disposable` on results—matches mocks without `Symbol.dispose`).\n *\n * @see https://developers.cloudflare.com/workers/runtime-apis/rpc/lifecycle/\n */\nexport type HonoDoFetcherStubInput =\n\t| DurableObjectStub<DOWithHonoApp>\n\t| Pick<DurableObjectStub<DOWithHonoApp>, \"fetch\">;\n\nfunction withStubDispose<\n\tTStub extends Pick<DurableObjectStub<DOWithHonoApp>, \"fetch\">,\n\tTS extends Schema,\n>(\n\tstub: TStub,\n\t// biome-ignore lint/suspicious/noExplicitAny: Matches honoFetcher generic pattern for schema-driven apps\n\tapi: TypedHonoFetcher<Hono<any, TS>>,\n\t// biome-ignore lint/suspicious/noExplicitAny: Matches honoFetcher generic pattern for schema-driven apps\n): TypedHonoFetcher<Hono<any, TS>> & Disposable {\n\treturn Object.assign(api, {\n\t\t[Symbol.dispose]() {\n\t\t\t// Stubs may omit Symbol.dispose (e.g. Vite mocks); DurableObjectStub types may not list it.\n\t\t\tconst disposeFn = Reflect.get(stub, Symbol.dispose);\n\t\t\tif (typeof disposeFn !== \"function\") {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tdisposeFn.call(stub);\n\t\t\t} catch (e) {\n\t\t\t\tconsole.error(\n\t\t\t\t\t\"[@firtoz/hono-fetcher] Durable Object stub dispose failed\",\n\t\t\t\t\te,\n\t\t\t\t);\n\t\t\t}\n\t\t},\n\t});\n}\n\n/**\n * Typed fetcher for a Durable Object stub.\n *\n * - **Full `DurableObjectStub`:** return type is {@link TypedDoFetcher} **`& Disposable`** — each\n *   HTTP/WebSocket result is typed as disposable (`RpcDisposableJsonResponse` / `Response & Disposable`)\n *   so **`using res = await …`** type-checks when `\"ESNext.Disposable\"` is in `lib`, matching Workers RPC\n *   when the runtime attaches `[Symbol.dispose]` (see `@see` below).\n * - **`Pick<stub, \"fetch\">` only (e.g. tests):** return type is **`TypedHonoFetcher<Hono> & Disposable`**\n *   — same **`JsonResponse` / `Response`** shapes as {@link honoFetcher}; results are **not** typed as\n *   `Disposable` so typings are not faked for mocks that lack RPC disposers.\n *\n * Disposing only the fetcher (`using api = …`) releases the **stub**; RPC **`Response`** disposal\n * (when applicable) is separate — prefer **`using res`**, **`res[Symbol.dispose]()`**, or **`DisposableStack`**.\n *\n * @see https://developers.cloudflare.com/workers/runtime-apis/rpc/lifecycle/\n */\nexport const honoDoFetcher = <const T extends HonoDoFetcherStubInput>(\n\tdurableObject: T,\n): T extends DurableObjectStub<DOWithHonoApp>\n\t? TypedDoFetcher<T> & Disposable\n\t: TypedHonoFetcher<Hono> & Disposable => {\n\ttype OutSchema =\n\t\tT extends DurableObjectStub<DOWithHonoApp> ? DOStubSchema<T> : Schema;\n\t// biome-ignore lint/suspicious/noExplicitAny: Generic parameter needs flexibility\n\tconst api = honoFetcher<Hono<any, OutSchema>>((url, init) => {\n\t\treturn durableObject.fetch(`${DUMMY_URL}${url}`, init);\n\t});\n\treturn withStubDispose(\n\t\tdurableObject,\n\t\tapi,\n\t) as T extends DurableObjectStub<DOWithHonoApp>\n\t\t? TypedDoFetcher<T> & Disposable\n\t\t: TypedHonoFetcher<Hono> & Disposable;\n};\n\nexport const honoDoFetcherWithName = <\n\tconst T extends Rpc.DurableObjectBranded & DOWithHonoApp,\n>(\n\tnamespace: DurableObjectNamespace<T>,\n\tname: string,\n): TypedDoFetcher<DurableObjectStub<T>> & Disposable => {\n\treturn honoDoFetcher(namespace.getByName(name)) as TypedDoFetcher<\n\t\tDurableObjectStub<T>\n\t> &\n\t\tDisposable;\n};\n\nexport const honoDoFetcherWithId = <\n\tconst T extends Rpc.DurableObjectBranded & DOWithHonoApp,\n>(\n\tnamespace: DurableObjectNamespace<T>,\n\tid: string,\n): TypedDoFetcher<DurableObjectStub<T>> & Disposable => {\n\treturn honoDoFetcher(\n\t\tnamespace.get(namespace.idFromString(id)),\n\t) as TypedDoFetcher<DurableObjectStub<T>> & Disposable;\n};\n"]}