@jokio/rpc 0.8.1 → 1.1.0

package/README.md

@@ -1,6 +1,6 @@
 # @jokio/rpc
 
-A type-safe RPC framework for TypeScript with Zod validation, designed for Express servers and HTTP clients.
+A type-safe RPC framework for TypeScript designed for Express servers and HTTP clients. Supports both Zod schemas (with runtime validation) and plain TypeScript types (for type safety without runtime overhead).
 
 <img width="400" height="400" alt="ChatGPT Image Jan 4, 2026 at 10_15_01 AM" src="https://github.com/user-attachments/assets/5ca6462a-4d3a-46d6-ac09-31ecbc4d06fb" />
 
@@ -11,71 +11,77 @@ A type-safe RPC framework for TypeScript with Zod validation, designed for Expre
 ## Features
 
 - Full TypeScript type safety from server to client
-- Runtime validation using Zod schemas
+- Two route definition styles: **Zod schemas** (with runtime validation) or **plain TypeScript types** (type-only, no runtime overhead)
 - Express.js integration for server-side
 - Flexible fetch-based client with custom fetch support
 - Support for multiple HTTP methods (GET, POST, PUT, PATCH, DELETE, QUERY)
-- Path parameters, query parameters, and request body validation
+- Path parameters, query parameters, and request payload validation
 - Automatic response validation
 
 ## Installation
 
 ```bash
-npm install @jokio/rpc zod
+npm install @jokio/rpc
+
+# Optional: install zod if you want runtime validation
+npm install zod
 ```
 
 ## Usage
 
 ### 1. Define Your Routes
 
+You can define routes using **Zod schemas** (enables runtime validation) or **plain TypeScript types** (type safety only, no runtime cost).
+
+#### Option A: Zod Schemas
+
 ```typescript
 import { defineRoutes } from "@jokio/rpc"
 import { z } from "zod"
 
 const routes = defineRoutes({
   GET: {
-    "/user/:id": {
-      queryParams: z.object({
-        include: z.string().optional(),
-      }),
-      response: z.object({
-        id: z.string(),
-        name: z.string(),
-        email: z.string(),
-      }),
+    "/room/:id": {
+      response: z.object({ name: z.string() }),
     },
-  },
-  POST: {
-    "/user": {
-      body: z.object({
-        name: z.string(),
-        email: z.string().email(),
-      }),
-      response: z.object({
-        id: z.string(),
-        name: z.string(),
-        email: z.string(),
-      }),
+    "/rooms": {
+      response: z.any(),
     },
   },
-  PUT: {
-    "/user/:id": {
-      body: z.object({
-        name: z.string().optional(),
-        email: z.string().email().optional(),
-      }),
-      response: z.object({
-        id: z.string(),
-        name: z.string(),
-        email: z.string(),
-      }),
+  POST: {
+    "/room": {
+      payload: z.any(),
+      response: z.any(),
     },
   },
 })
 ```
 
+#### Option B: Plain TypeScript Types
+
+```typescript
+type ApiRoutes = {
+  GET: {
+    "/room/:id": {
+      response: { name: string }
+    }
+    "/rooms": {
+      response: { count: number }
+    }
+  }
+  POST: {
+    "/room": {
+      payload: { name: string }
+      response: number
+    }
+  }
+}
+```
+
 ### 2. Set Up the Server
 
+#### With Zod Routes
+
 ```typescript
 import express from "express"
 import { registerExpressRoutes } from "@jokio/rpc"
@@ -85,37 +91,13 @@ app.use(express.json())
 
 const router = express.Router()
 
-registerExpressRoutes(router, routes, {
+registerExpressRoutes(router, { routes }, {
   GET: {
-    "/user/:id": async ({ params, queryParams }) => {
-      // params.id is type-safe and contains the :id from the path
-      // queryParams.include is validated by Zod
-      return {
-        id: params.id,
-        name: "John Doe",
-        email: "john@example.com",
-      }
-    },
+    "/room/:id": ({ params }) => ({ name: params.id }),
+    "/rooms": () => ({ count: 10 }),
   },
   POST: {
-    "/user": async ({ body }) => {
-      // body is validated by Zod
-      return {
-        id: "2",
-        name: body.name,
-        email: body.email,
-      }
-    },
-  },
-  PUT: {
-    "/user/:id": async ({ params, body }) => {
-      // Both params and body are type-safe
-      return {
-        id: params.id,
-        name: body.name ?? "John Doe",
-        email: body.email ?? "john@example.com",
-      }
-    },
+    "/room": ({ payload }) => ({ id: "1" }),
   },
 })
 
@@ -123,38 +105,38 @@ app.use("/api", router)
 app.listen(3000)
 ```
 
-### 3. Create a Type-Safe Client
+#### With TypeScript Types
+
+When using plain TypeScript types, pass the type as a generic parameter. No `routes` object is needed — you get full type safety without runtime validation.
 
 ```typescript
-import { createClient } from "@jokio/rpc"
+registerExpressRoutes<ApiRoutes, { userId: number }>(
+  router,
+  { ctx: (req) => ({ userId: 123 }) },
+  {
+    GET: {
+      "/room/:id": ({ params }) => ({ name: params.id }),
+      "/rooms": (_, ctx) => ({ count: ctx.userId }),
+    },
+    POST: {
+      "/room": ({ payload }) => payload.name.length,
+    },
+  },
+)
+```
 
-const client = createClient(routes, {
-  baseUrl: "http://localhost:3000/api",
-  validate: true, // Optional: validate requests on client-side
-})
+### 3. Create a Type-Safe Client
 
-// Fully typed API calls with path parameters
-const user = await client.GET("/user/:id", {
-  params: { id: "23" },
-  queryParams: { include: "profile" },
-})
+The client uses the Zod route definitions for both type inference and optional runtime validation.
 
-// POST request with body
-const newUser = await client.POST("/user", {
-  name: "Jane Doe",
-  email: "jane@example.com",
-})
+```typescript
+import { createClient } from "@jokio/rpc"
 
-// PUT request with path parameters and body
-const updatedUser = await client.PUT(
-  "/user/:id",
-  {
-    name: "Jane Smith",
-  },
-  {
-    params: { id: "23" },
-  }
-)
+const client = createClient("http://localhost:3000/api", { routes })
+
+// Fully typed response — .name is inferred from the Zod schema
+const room = await client.GET("/room/:id")
+console.log(room.name)
 ```
 
 ## API Reference
@@ -169,39 +151,44 @@ Helper function to define routes with type inference.
 
 **Route Configuration:**
 
-- `body`: Zod schema for request body (not available for GET)
-- `queryParams`: Zod schema for query parameters (optional)
-- `response`: Zod schema for response data
+Each route accepts the following fields as either a Zod schema or a plain TypeScript type:
 
-### `registerExpressRoutes(router, routes, handlers)`
+- `payload`: Request body (not available for GET)
+- `queryParams`: Query parameters (optional)
+- `response`: Response data
+
+### `registerExpressRoutes(router, config, handlers)`
 
 Registers route handlers to an Express router with automatic validation.
 
 **Parameters:**
 
 - `router`: Express Router instance
-- `routes`: Route definitions object
-- `handlers`: Handler functions for each route with optional configuration
+- `config`: Configuration object
+  - `routes`: Optional route definitions object (Zod schemas — omit when using plain TS types)
   - `ctx`: Optional function `(req: Request) => TContext` to provide context to handlers
-  - `validation`: Optional boolean to enable response validation (default: false)
-  - `schemaFile`: Optional path to expose route schemas at `/__routes` endpoint
+  - `validation`: Optional boolean to enable response validation (default: true)
+  - `schemaFile`: Optional string to expose route schemas at `/__routes` endpoint
+- `handlers`: Handler functions for each route
   - `GET`, `POST`, `PUT`, `PATCH`, `DELETE`, `QUERY`: Handler functions that receive `(data, ctx)` parameters
     - `data.params`: Path parameters (e.g., `:id` in `/user/:id`)
-    - `data.body`: Request body (validated by Zod)
-    - `data.queryParams`: Query parameters (validated by Zod)
+    - `data.payload`: Request payload (validated by Zod if schemas provided)
+    - `data.queryParams`: Query parameters (validated by Zod if schemas provided)
+
+When using plain TypeScript types, pass the type as a generic: `registerExpressRoutes<MyRoutes>(...)`. Zod validation is skipped since there are no schemas.
 
-### `createClient(routes, options)`
+### `createClient(baseUrl, options)`
 
 Creates a type-safe HTTP client.
 
 **Parameters:**
 
-- `routes`: Route definitions object (same as used on the server)
+- `baseUrl`: Base URL for API requests
 - `options`: Client configuration options
-  - `baseUrl`: Base URL for API requests
+  - `routes`: Route definitions object (Zod schemas for type inference)
   - `getHeaders`: Optional function that returns headers (sync or async)
   - `fetch`: Optional custom fetch function (useful for Node.js or testing)
-  - `validate`: Enable client-side request validation (default: true)
+  - `validate`: Enable client-side request validation (default: false)
   - `debug`: Enable debug logging (default: false)
 
 **Client Methods:**
@@ -211,35 +198,30 @@ Each HTTP method has a type-safe method on the client:
 - `GET(path, options?)`: For GET requests
   - `options.params`: Path parameters
   - `options.queryParams`: Query parameters
-- `POST(path, body, options?)`: For POST requests
-- `PUT(path, body, options?)`: For PUT requests
-- `PATCH(path, body, options?)`: For PATCH requests
-- `DELETE(path, body, options?)`: For DELETE requests
-- `QUERY(path, body, options?)`: For QUERY requests (custom method)
+- `POST(path, payload, options?)`: For POST requests
+- `PUT(path, payload, options?)`: For PUT requests
+- `PATCH(path, payload, options?)`: For PATCH requests
+- `DELETE(path, payload, options?)`: For DELETE requests
+- `QUERY(path, payload, options?)`: For QUERY requests (custom method)
 
 ## Type Safety
 
-The library provides end-to-end type safety:
-
-```typescript
-// TypeScript knows the exact shape of requests and responses
-const result = await client.POST("/user", {
-  name: "John",
-  email: "invalid-email", // Zod will catch this at runtime
-})
+The library provides end-to-end type safety with both approaches:
 
-// result is typed as { id: string; name: string; email: string }
-console.log(result.id)
+- **Zod schemas**: Types are inferred from schemas + runtime validation is available
+- **Plain TypeScript types**: Types are enforced at compile time with zero runtime overhead
 
-// Path parameters are type-safe
-const user = await client.GET("/user/:id", {
-  params: { id: "123" }, // TypeScript enforces correct parameter names
-})
+```typescript
+// With Zod — types are inferred, runtime validation available
+const client = createClient("http://localhost:3000/api", { routes })
+const room = await client.GET("/room/:id")
+room.name // string — inferred from z.object({ name: z.string() })
 
-// Query parameters are validated
-const users = await client.GET("/user/:id", {
-  params: { id: "123" },
-  queryParams: { include: "profile" }, // Must match Zod schema
+// With plain TS types — same type safety, no runtime cost
+registerExpressRoutes<ApiRoutes>(router, {}, {
+  POST: {
+    "/room": ({ payload }) => payload.name.length, // payload typed as { name: string }
+  },
 })
 ```
 

package/dist/index.d.mts

@@ -2,7 +2,7 @@ import z from 'zod';
 import { Router, Request } from 'express';
 
 type RouterConfig = {
-    GET: Record<string, Omit<RouteConfig, "body">>;
+    GET: Record<string, Omit<RouteConfig, "payload">>;
     QUERY: Record<string, RouteConfig>;
     POST: Record<string, RouteConfig>;
     PUT: Record<string, RouteConfig>;
@@ -10,12 +10,12 @@ type RouterConfig = {
     DELETE: Record<string, RouteConfig>;
 };
 type RouteConfig = {
-    body: z.ZodType;
-    queryParams?: z.ZodType;
-    response: z.ZodType;
+    payload: z.ZodType | unknown;
+    queryParams?: z.ZodType | unknown;
+    response: z.ZodType | unknown;
 };
-type InferRouteConfig<T extends RouteConfig | Omit<RouteConfig, "body">> = {
-    [K in keyof T]: T[K] extends z.ZodType ? z.infer<T[K]> : never;
+type InferRouteConfig<T extends RouteConfig | Omit<RouteConfig, "payload">> = {
+    [K in keyof T]: T[K] extends z.ZodType ? z.infer<T[K]> : T[K];
 };
 declare const defineRoutes: <T extends Partial<RouterConfig>>(routes: T) => T;
 type ExtractRouteParams<T extends string> = T extends `${infer _Start}:${infer Param}/${infer Rest}` ? Rest extends `:${string}` ? {
@@ -32,17 +32,17 @@ type ClientOptions<TConfig, K> = Omit<TConfig, "response"> & {
     params?: K extends string ? ExtractRouteParams<K> : unknown;
 };
 type RouterClient<T extends Partial<RouterConfig>> = {
-    [M in keyof T & keyof RouterConfig]: T[M] extends Record<string, any> ? M extends "GET" ? <K extends keyof T[M]>(path: K, options?: ClientOptions<Omit<InferRouteConfig<T[M][K]>, "body">, K>) => Promise<InferRouteConfig<T[M][K]>["response"]> : <K extends keyof T[M]>(path: K, body: InferRouteConfig<T[M][K]>["body"], options?: ClientOptions<Omit<InferRouteConfig<T[M][K]>, "body">, K>) => Promise<InferRouteConfig<T[M][K]>["response"]> : never;
+    [M in keyof T & keyof RouterConfig]: T[M] extends Record<string, any> ? M extends "GET" ? <K extends keyof T[M]>(path: K, options?: ClientOptions<Omit<InferRouteConfig<T[M][K]>, "payload">, K>) => Promise<InferRouteConfig<T[M][K]>["response"]> : <K extends keyof T[M]>(path: K, payload: InferRouteConfig<T[M][K]>["payload"], options?: ClientOptions<Omit<InferRouteConfig<T[M][K]>, "payload">, K>) => Promise<InferRouteConfig<T[M][K]>["response"]> : never;
 };
 type FetchFunction = (url: string, options: RequestInit) => Promise<Response>;
-type CreateClientOptions = {
-    baseUrl: string;
+type CreateClientOptions<T extends Partial<RouterConfig>> = {
+    routes?: T;
     getHeaders?: () => Promise<Record<string, string>> | Record<string, string>;
     fetch?: FetchFunction;
     validate?: boolean;
     debug?: boolean;
 };
-declare const createClient: <T extends Partial<RouterConfig>>(routes: T, options: CreateClientOptions) => RouterClient<T>;
+declare const createHttpClient: <T extends Partial<RouterConfig>>(baseUrl: string, options?: CreateClientOptions<T>) => RouterClient<T>;
 
 type MaybePromise<T> = Promise<T> | T;
 type HandlerData<TConfig, K> = Omit<TConfig, "response"> & {
@@ -50,13 +50,14 @@ type HandlerData<TConfig, K> = Omit<TConfig, "response"> & {
 };
 type RouteHandlers<T extends Partial<RouterConfig>, TContext> = {
     [M in keyof T & keyof RouterConfig]: T[M] extends Record<string, any> ? {
-        [K in keyof T[M]]: T[M][K] extends RouteConfig | Omit<RouteConfig, "body"> ? (data: M extends "GET" ? HandlerData<Omit<InferRouteConfig<T[M][K]>, "body">, K> : HandlerData<InferRouteConfig<T[M][K]>, K>, ctx: TContext) => MaybePromise<InferRouteConfig<T[M][K]>["response"]> : never;
+        [K in keyof T[M]]: T[M][K] extends RouteConfig | Omit<RouteConfig, "payload"> ? (data: M extends "GET" ? HandlerData<Omit<InferRouteConfig<T[M][K]>, "payload">, K> : HandlerData<InferRouteConfig<T[M][K]>, K>, ctx: TContext) => MaybePromise<InferRouteConfig<T[M][K]>["response"]> : never;
     } : never;
 };
-declare const registerExpressRoutes: <T extends Partial<RouterConfig>, TContext>(router: Router, routes: T, config: {
+declare const registerExpressRoutes: <T extends Partial<RouterConfig>, TContext>(router: Router, config: {
+    routes?: T;
     ctx?: (req: Request) => TContext;
     schemaFile?: string;
     validation?: boolean;
 }, handlers: RouteHandlers<T, TContext>) => Router;
 
-export { type ExtractRouteParams, type InferRouteConfig, type RouteConfig, type RouteHandlers, type RouterClient, type RouterConfig, createClient, defineRoutes, registerExpressRoutes };
+export { type ExtractRouteParams, type InferRouteConfig, type RouteConfig, type RouteHandlers, type RouterClient, type RouterConfig, createHttpClient, defineRoutes, registerExpressRoutes };

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import z from 'zod';
 import { Router, Request } from 'express';
 
 type RouterConfig = {
-    GET: Record<string, Omit<RouteConfig, "body">>;
+    GET: Record<string, Omit<RouteConfig, "payload">>;
     QUERY: Record<string, RouteConfig>;
     POST: Record<string, RouteConfig>;
     PUT: Record<string, RouteConfig>;
@@ -10,12 +10,12 @@ type RouterConfig = {
     DELETE: Record<string, RouteConfig>;
 };
 type RouteConfig = {
-    body: z.ZodType;
-    queryParams?: z.ZodType;
-    response: z.ZodType;
+    payload: z.ZodType | unknown;
+    queryParams?: z.ZodType | unknown;
+    response: z.ZodType | unknown;
 };
-type InferRouteConfig<T extends RouteConfig | Omit<RouteConfig, "body">> = {
-    [K in keyof T]: T[K] extends z.ZodType ? z.infer<T[K]> : never;
+type InferRouteConfig<T extends RouteConfig | Omit<RouteConfig, "payload">> = {
+    [K in keyof T]: T[K] extends z.ZodType ? z.infer<T[K]> : T[K];
 };
 declare const defineRoutes: <T extends Partial<RouterConfig>>(routes: T) => T;
 type ExtractRouteParams<T extends string> = T extends `${infer _Start}:${infer Param}/${infer Rest}` ? Rest extends `:${string}` ? {
@@ -32,17 +32,17 @@ type ClientOptions<TConfig, K> = Omit<TConfig, "response"> & {
     params?: K extends string ? ExtractRouteParams<K> : unknown;
 };
 type RouterClient<T extends Partial<RouterConfig>> = {
-    [M in keyof T & keyof RouterConfig]: T[M] extends Record<string, any> ? M extends "GET" ? <K extends keyof T[M]>(path: K, options?: ClientOptions<Omit<InferRouteConfig<T[M][K]>, "body">, K>) => Promise<InferRouteConfig<T[M][K]>["response"]> : <K extends keyof T[M]>(path: K, body: InferRouteConfig<T[M][K]>["body"], options?: ClientOptions<Omit<InferRouteConfig<T[M][K]>, "body">, K>) => Promise<InferRouteConfig<T[M][K]>["response"]> : never;
+    [M in keyof T & keyof RouterConfig]: T[M] extends Record<string, any> ? M extends "GET" ? <K extends keyof T[M]>(path: K, options?: ClientOptions<Omit<InferRouteConfig<T[M][K]>, "payload">, K>) => Promise<InferRouteConfig<T[M][K]>["response"]> : <K extends keyof T[M]>(path: K, payload: InferRouteConfig<T[M][K]>["payload"], options?: ClientOptions<Omit<InferRouteConfig<T[M][K]>, "payload">, K>) => Promise<InferRouteConfig<T[M][K]>["response"]> : never;
 };
 type FetchFunction = (url: string, options: RequestInit) => Promise<Response>;
-type CreateClientOptions = {
-    baseUrl: string;
+type CreateClientOptions<T extends Partial<RouterConfig>> = {
+    routes?: T;
     getHeaders?: () => Promise<Record<string, string>> | Record<string, string>;
     fetch?: FetchFunction;
     validate?: boolean;
     debug?: boolean;
 };
-declare const createClient: <T extends Partial<RouterConfig>>(routes: T, options: CreateClientOptions) => RouterClient<T>;
+declare const createHttpClient: <T extends Partial<RouterConfig>>(baseUrl: string, options?: CreateClientOptions<T>) => RouterClient<T>;
 
 type MaybePromise<T> = Promise<T> | T;
 type HandlerData<TConfig, K> = Omit<TConfig, "response"> & {
@@ -50,13 +50,14 @@ type HandlerData<TConfig, K> = Omit<TConfig, "response"> & {
 };
 type RouteHandlers<T extends Partial<RouterConfig>, TContext> = {
     [M in keyof T & keyof RouterConfig]: T[M] extends Record<string, any> ? {
-        [K in keyof T[M]]: T[M][K] extends RouteConfig | Omit<RouteConfig, "body"> ? (data: M extends "GET" ? HandlerData<Omit<InferRouteConfig<T[M][K]>, "body">, K> : HandlerData<InferRouteConfig<T[M][K]>, K>, ctx: TContext) => MaybePromise<InferRouteConfig<T[M][K]>["response"]> : never;
+        [K in keyof T[M]]: T[M][K] extends RouteConfig | Omit<RouteConfig, "payload"> ? (data: M extends "GET" ? HandlerData<Omit<InferRouteConfig<T[M][K]>, "payload">, K> : HandlerData<InferRouteConfig<T[M][K]>, K>, ctx: TContext) => MaybePromise<InferRouteConfig<T[M][K]>["response"]> : never;
     } : never;
 };
-declare const registerExpressRoutes: <T extends Partial<RouterConfig>, TContext>(router: Router, routes: T, config: {
+declare const registerExpressRoutes: <T extends Partial<RouterConfig>, TContext>(router: Router, config: {
+    routes?: T;
     ctx?: (req: Request) => TContext;
     schemaFile?: string;
     validation?: boolean;
 }, handlers: RouteHandlers<T, TContext>) => Router;
 
-export { type ExtractRouteParams, type InferRouteConfig, type RouteConfig, type RouteHandlers, type RouterClient, type RouterConfig, createClient, defineRoutes, registerExpressRoutes };
+export { type ExtractRouteParams, type InferRouteConfig, type RouteConfig, type RouteHandlers, type RouterClient, type RouterConfig, createHttpClient, defineRoutes, registerExpressRoutes };

package/dist/index.js

@@ -1,6 +1,6 @@
 'use strict';
 
-// src/client.ts
+// src/http.client.ts
 var replacePathParams = (path, params) => {
   const paramNames = /* @__PURE__ */ new Set();
   const paramPattern = /:([^/]+)/g;
@@ -19,23 +19,23 @@ var replacePathParams = (path, params) => {
     return String(params[paramName]);
   });
 };
-var createClient = (routes, options) => {
+var createHttpClient = (baseUrl, options) => {
   const {
-    baseUrl,
+    routes,
     getHeaders = () => Promise.resolve({}),
     fetch: customFetch = fetch,
     validate = false
-  } = options;
+  } = options ?? {};
   const buildUrl = (path, options2) => {
     const queryString = options2?.queryParams ? "?" + new URLSearchParams(options2.queryParams).toString() : "";
     const finalPath = path.includes(":") ? replacePathParams(path, options2?.params ?? {}) : path;
     return `${baseUrl}${finalPath}${queryString}`;
   };
-  const handleValidation = (method, path, body, options2) => {
+  const handleValidation = (method, path, payload, options2) => {
     if (!validate) return;
-    const routeConfig = routes[method]?.[path];
-    if (body && routeConfig?.body) {
-      routeConfig.body.parse(body);
+    const routeConfig = routes?.[method]?.[path];
+    if (payload && routeConfig?.payload) {
+      routeConfig.payload.parse(payload);
     }
     if (options2?.queryParams && routeConfig?.queryParams) {
       routeConfig.queryParams.parse(options2.queryParams);
@@ -49,7 +49,7 @@ var createClient = (routes, options) => {
       }
       throw new Error(error.message);
     }
-    const routeConfig = routes[method]?.[path];
+    const routeConfig = routes?.[method]?.[path];
     if (routeConfig?.response?.type === "void") {
       await response.text();
       return;
@@ -57,8 +57,8 @@ var createClient = (routes, options) => {
     const json = await response.json();
     return validate && routeConfig?.response ? routeConfig.response.parse(json) : json;
   };
-  const makeRequest = async (method, path, body, options2) => {
-    handleValidation(method, path, body, options2);
+  const makeRequest = async (method, path, payload, options2) => {
+    handleValidation(method, path, payload, options2);
     const url = buildUrl(path, options2);
     const fetchOptions = {
       method,
@@ -67,30 +67,25 @@ var createClient = (routes, options) => {
         ...await getHeaders()
       }
     };
-    if (body !== void 0) {
-      fetchOptions.body = JSON.stringify(body);
+    if (payload !== void 0) {
+      fetchOptions.body = JSON.stringify(payload);
     }
     const response = await customFetch(url, fetchOptions);
     return handleResponse(method, path, response, options2);
   };
-  const client = {};
   const methodHandlers = {
     GET: async (path, options2) => makeRequest("GET", path, void 0, options2),
-    QUERY: async (path, body, options2) => makeRequest("QUERY", path, body, options2),
-    POST: async (path, body, options2) => makeRequest("POST", path, body, options2),
-    PUT: async (path, body, options2) => makeRequest("PUT", path, body, options2),
-    PATCH: async (path, body, options2) => makeRequest("PATCH", path, body, options2),
-    DELETE: async (path, body, options2) => makeRequest("DELETE", path, body, options2)
+    QUERY: async (path, payload, options2) => makeRequest("QUERY", path, payload, options2),
+    POST: async (path, payload, options2) => makeRequest("POST", path, payload, options2),
+    PUT: async (path, payload, options2) => makeRequest("PUT", path, payload, options2),
+    PATCH: async (path, payload, options2) => makeRequest("PATCH", path, payload, options2),
+    DELETE: async (path, payload, options2) => makeRequest("DELETE", path, payload, options2)
   };
-  for (const method of Object.keys(routes)) {
-    if (method in methodHandlers) {
-      client[method] = methodHandlers[method];
-    }
-  }
+  const client = methodHandlers;
   return client;
 };
 
-// src/server.ts
+// src/http.server.ts
 var createRouteHandler = (method, routes, getCtx, handlers, route, validation) => {
   return async (req, res, next) => {
     try {
@@ -98,25 +93,39 @@ var createRouteHandler = (method, routes, getCtx, handlers, route, validation) =
         res.status(405).send("Method Not Allowed");
         return;
       }
+      const validationCheck = {
+        payload: typeof validation === "boolean" ? validation : validation.payload ?? false,
+        queryParams: typeof validation === "boolean" ? validation : validation.queryParams ?? false,
+        response: typeof validation === "boolean" ? validation : validation.response ?? false
+      };
       const ctx = getCtx(req) ?? {};
-      const routeConfig = routes[method][route];
+      const routeConfig = (routes?.[method])[route];
       const data = {
         params: req.params,
-        ...routeConfig?.body && { body: routeConfig.body.parse(req.body) },
-        ...routeConfig?.queryParams && {
+        ...routeConfig?.payload && validationCheck.payload && {
+          payload: routeConfig.payload.parse(req.body)
+        },
+        ...routeConfig?.queryParams && validationCheck.queryParams && {
           queryParams: routeConfig.queryParams.parse(req.query)
         }
       };
       const result = await handlers[method][route]?.(data, ctx);
-      res.json(validation ? routeConfig?.response.parse(result) : result);
+      res.json(
+        routeConfig?.response && validationCheck.response ? routeConfig?.response.parse(result) : result
+      );
     } catch (err) {
       console.warn(method, route, err?.message);
       next(err);
     }
   };
 };
-var registerExpressRoutes = (router, routes, config, handlers) => {
-  const { schemaFile, validation = true, ctx = () => null } = config;
+var registerExpressRoutes = (router, config, handlers) => {
+  const {
+    schemaFile,
+    validation = true,
+    ctx = () => null,
+    routes
+  } = config;
   const expressMethodMap = {
     GET: "get",
     POST: "post",
@@ -127,7 +136,7 @@ var registerExpressRoutes = (router, routes, config, handlers) => {
   };
   for (const [method, routerMethod] of Object.entries(expressMethodMap)) {
     const methodKey = method;
-    const methodRoutes = routes[methodKey];
+    const methodRoutes = handlers[methodKey];
     if (!methodRoutes) continue;
     router = Object.keys(methodRoutes).reduce(
       (r, route) => r[routerMethod](
@@ -156,7 +165,7 @@ var registerExpressRoutes = (router, routes, config, handlers) => {
 // src/types.ts
 var defineRoutes = (routes) => routes;
 
-exports.createClient = createClient;
+exports.createHttpClient = createHttpClient;
 exports.defineRoutes = defineRoutes;
 exports.registerExpressRoutes = registerExpressRoutes;
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts","../src/server.ts","../src/types.ts"],"names":["options"],"mappings":"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","file":"index.js","sourcesContent":["import {\n  type ExtractRouteParams,\n  type InferRouteConfig,\n  type RouterConfig,\n} from \"./types\"\n\n// Reusable type for client options with optional params\ntype ClientOptions<TConfig, K> = Omit<TConfig, \"response\"> & {\n  params?: K extends string ? ExtractRouteParams<K> : unknown\n}\n\nexport type RouterClient<T extends Partial<RouterConfig>> = {\n  [M in keyof T & keyof RouterConfig]: T[M] extends Record<string, any>\n    ? M extends \"GET\"\n      ? <K extends keyof T[M]>(\n          path: K,\n          options?: ClientOptions<Omit<InferRouteConfig<T[M][K]>, \"body\">, K>\n        ) => Promise<InferRouteConfig<T[M][K]>[\"response\"]>\n      : <K extends keyof T[M]>(\n          path: K,\n          body: InferRouteConfig<T[M][K]>[\"body\"],\n          options?: ClientOptions<Omit<InferRouteConfig<T[M][K]>, \"body\">, K>\n        ) => Promise<InferRouteConfig<T[M][K]>[\"response\"]>\n    : never\n}\n\ntype FetchFunction = (url: string, options: RequestInit) => Promise<Response>\n\ntype CreateClientOptions = {\n  baseUrl: string\n  getHeaders?: () => Promise<Record<string, string>> | Record<string, string>\n  fetch?: FetchFunction\n  validate?: boolean\n  debug?: boolean\n}\n\n/**\n * Replaces path parameters with their values.\n * @param path - The path template with parameters (e.g., \"/:id/test/:name/info\")\n * @param params - The parameter values (e.g., {id: \"123\", name: \"434\"})\n * @returns The resolved path (e.g., \"/123/test/434/info\")\n * @throws Error if a required parameter is missing\n */\nexport const replacePathParams = (\n  path: string,\n  params: Record<string, string | number>\n): string => {\n  const paramNames = new Set<string>()\n  const paramPattern = /:([^/]+)/g\n  let match: RegExpExecArray | null\n\n  // Extract all parameter names from the path\n  while ((match = paramPattern.exec(path)) !== null) {\n    paramNames.add(match[1])\n  }\n\n  // Check if all required parameters are provided\n  for (const paramName of paramNames) {\n    if (!(paramName in params)) {\n      throw new Error(\n        `Missing required parameter: \"${paramName}\" for path \"${path}\"`\n      )\n    }\n  }\n\n  // Replace all parameters with their values\n  return path.replace(/:([^/]+)/g, (_, paramName) => {\n    return String(params[paramName])\n  })\n}\n\nexport const createClient = <T extends Partial<RouterConfig>>(\n  routes: T,\n  options: CreateClientOptions\n): RouterClient<T> => {\n  const {\n    baseUrl,\n    getHeaders = () => Promise.resolve({}),\n    fetch: customFetch = fetch,\n    validate = false,\n  } = options\n\n  const buildUrl = (path: string, options?: any): string => {\n    const queryString = options?.queryParams\n      ? \"?\" + new URLSearchParams(options.queryParams).toString()\n      : \"\"\n\n    const finalPath = path.includes(\":\")\n      ? replacePathParams(path, options?.params ?? {})\n      : path\n\n    return `${baseUrl}${finalPath}${queryString}`\n  }\n\n  const handleValidation = (\n    method: keyof T & keyof RouterConfig,\n    path: string,\n    body?: any,\n    options?: any\n  ) => {\n    if (!validate) return\n\n    const routeConfig = (routes[method] as any)?.[path]\n    if (body && routeConfig?.body) {\n      routeConfig.body.parse(body)\n    }\n    if (options?.queryParams && routeConfig?.queryParams) {\n      routeConfig.queryParams.parse(options.queryParams)\n    }\n  }\n\n  const handleResponse = async (\n    method: keyof T & keyof RouterConfig,\n    path: string,\n    response: Response,\n    options?: any\n  ) => {\n    if (!response.ok) {\n      const error: any = await response.json()\n\n      if (options?.debug) {\n        console.debug(error)\n      }\n\n      throw new Error(error.message)\n    }\n\n    const routeConfig = (routes[method] as any)?.[path]\n    if (routeConfig?.response?.type === \"void\") {\n      await response.text()\n      return\n    }\n\n    const json = await response.json()\n\n    return validate && routeConfig?.response\n      ? routeConfig.response.parse(json)\n      : json\n  }\n\n  const makeRequest = async (\n    method: keyof T & keyof RouterConfig,\n    path: string,\n    body?: any,\n    options?: any\n  ) => {\n    handleValidation(method, path, body, options)\n\n    const url = buildUrl(path, options)\n    const fetchOptions: RequestInit = {\n      method: method as string,\n      headers: {\n        \"Content-Type\": \"application/json\",\n        ...(await getHeaders()),\n      },\n    }\n\n    if (body !== undefined) {\n      fetchOptions.body = JSON.stringify(body)\n    }\n\n    const response = await customFetch(url, fetchOptions)\n\n    return handleResponse(method, path, response, options)\n  }\n\n  const client = {} as RouterClient<T>\n\n  const methodHandlers = {\n    GET: async (path: any, options?: any) =>\n      makeRequest(\"GET\", path, undefined, options),\n    QUERY: async (path: any, body: any, options?: any) =>\n      makeRequest(\"QUERY\", path, body, options),\n    POST: async (path: any, body: any, options?: any) =>\n      makeRequest(\"POST\", path, body, options),\n    PUT: async (path: any, body: any, options?: any) =>\n      makeRequest(\"PUT\", path, body, options),\n    PATCH: async (path: any, body: any, options?: any) =>\n      makeRequest(\"PATCH\", path, body, options),\n    DELETE: async (path: any, body: any, options?: any) =>\n      makeRequest(\"DELETE\", path, body, options),\n  }\n\n  for (const method of Object.keys(routes) as Array<\n    keyof T & keyof RouterConfig\n  >) {\n    if (method in methodHandlers) {\n      ;(client as any)[method] = methodHandlers[method]\n    }\n  }\n\n  return client\n}\n","import type { Request, Router } from \"express\"\nimport {\n  type ExtractRouteParams,\n  type InferRouteConfig,\n  type RouteConfig,\n  type RouterConfig,\n} from \"./types\"\n\n// Reusable type for sync or async responses\ntype MaybePromise<T> = Promise<T> | T\n\n// Reusable type for handler data with params\ntype HandlerData<TConfig, K> = Omit<TConfig, \"response\"> & {\n  params: K extends string ? ExtractRouteParams<K> : unknown\n}\n\nexport type RouteHandlers<T extends Partial<RouterConfig>, TContext> = {\n  [M in keyof T & keyof RouterConfig]: T[M] extends Record<string, any>\n    ? {\n        [K in keyof T[M]]: T[M][K] extends\n          | RouteConfig\n          | Omit<RouteConfig, \"body\">\n          ? (\n              data: M extends \"GET\"\n                ? HandlerData<Omit<InferRouteConfig<T[M][K]>, \"body\">, K>\n                : HandlerData<InferRouteConfig<T[M][K]>, K>,\n              ctx: TContext\n            ) => MaybePromise<InferRouteConfig<T[M][K]>[\"response\"]>\n          : never\n      }\n    : never\n}\n\nconst createRouteHandler = <\n  T extends Partial<RouterConfig>,\n  TContext,\n  M extends keyof RouteHandlers<T, TContext>\n>(\n  method: M,\n  routes: T,\n  getCtx: (req: Request) => TContext,\n  handlers: RouteHandlers<T, TContext> & {},\n  route: string,\n  validation: boolean\n) => {\n  return async (req: Request, res: any, next: any) => {\n    try {\n      if (method === \"QUERY\" && req.method !== \"QUERY\") {\n        res.status(405).send(\"Method Not Allowed\")\n        return\n      }\n\n      const ctx = (getCtx(req) ?? {}) as TContext\n      const routeConfig = (routes[method] as any)[route]\n\n      const data = {\n        params: req.params,\n        ...(routeConfig?.body && { body: routeConfig.body.parse(req.body) }),\n        ...(routeConfig?.queryParams && {\n          queryParams: routeConfig.queryParams.parse(req.query),\n        }),\n      }\n\n      const result = await handlers[method][route]?.(data as any, ctx)\n\n      res.json(validation ? routeConfig?.response.parse(result) : result)\n    } catch (err: any) {\n      console.warn(method, route, err?.message)\n      next(err)\n    }\n  }\n}\n\nexport const registerExpressRoutes = <\n  T extends Partial<RouterConfig>,\n  TContext\n>(\n  router: Router,\n  routes: T,\n  config: {\n    ctx?: (req: Request) => TContext\n    schemaFile?: string\n    validation?: boolean\n  },\n  handlers: RouteHandlers<T, TContext>\n) => {\n  const { schemaFile, validation = true, ctx = () => null as TContext } = config\n\n  const expressMethodMap = {\n    GET: \"get\",\n    POST: \"post\",\n    PUT: \"put\",\n    PATCH: \"patch\",\n    DELETE: \"delete\",\n    QUERY: \"all\",\n  } as const\n\n  for (const [method, routerMethod] of Object.entries(expressMethodMap)) {\n    const methodKey = method as keyof RouteHandlers<T, TContext>\n    const methodRoutes = routes[methodKey]\n\n    if (!methodRoutes) continue\n\n    router = Object.keys(methodRoutes as object).reduce(\n      (r, route) =>\n        r[routerMethod](\n          route,\n          createRouteHandler(\n            methodKey,\n            routes,\n            ctx,\n            handlers,\n            route,\n            validation\n          )\n        ),\n      router\n    )\n  }\n\n  if (schemaFile) {\n    router = router.get(\"/__routes\", async (_, res) =>\n      res.contentType(\"text/plain\").send(schemaFile)\n    )\n  }\n\n  return router\n}\n","import type z from \"zod\"\n\nexport type RouterConfig = {\n  GET: Record<string, Omit<RouteConfig, \"body\">>\n  QUERY: Record<string, RouteConfig>\n  POST: Record<string, RouteConfig>\n  PUT: Record<string, RouteConfig>\n  PATCH: Record<string, RouteConfig>\n  DELETE: Record<string, RouteConfig>\n}\n\nexport type RouteConfig = {\n  body: z.ZodType\n  queryParams?: z.ZodType\n  response: z.ZodType\n}\n\nexport type InferRouteConfig<\n  T extends RouteConfig | Omit<RouteConfig, \"body\">\n> = {\n  [K in keyof T]: T[K] extends z.ZodType ? z.infer<T[K]> : never\n}\n\nexport const defineRoutes = <T extends Partial<RouterConfig>>(\n  routes: T\n): T => routes\n\n// Extract path parameters from route string\n// e.g., \"/user/:id\" -> { id: string }, \"/user/:id/info\" -> { id: string }, \"/user/:id/post/:postId\" -> { id: string, postId: string }\nexport type ExtractRouteParams<T extends string> =\n  T extends `${infer _Start}:${infer Param}/${infer Rest}`\n    ? Rest extends `:${string}`\n      ? {\n          [K in Param | keyof ExtractRouteParams<`/${Rest}`>]: string\n        }\n      : Rest extends `${string}/:${string}`\n      ? {\n          [K in Param | keyof ExtractRouteParams<`/${Rest}`>]: string\n        }\n      : { [K in Param]: string }\n    : T extends `${infer _Start}:${infer Param}`\n    ? { [K in Param]: string }\n    : Record<string, never>\n"]}
+{"version":3,"sources":["../src/http.client.ts","../src/http.server.ts","../src/types.ts"],"names":["options"],"mappings":";;;AAiDO,IAAM,iBAAA,GAAoB,CAC/B,IAAA,EACA,MAAA,KACW;AACX,EAAA,MAAM,UAAA,uBAAiB,GAAA,EAAY;AACnC,EAAA,MAAM,YAAA,GAAe,WAAA;AACrB,EAAA,IAAI,KAAA;AAGJ,EAAA,OAAA,CAAQ,KAAA,GAAQ,YAAA,CAAa,IAAA,CAAK,IAAI,OAAO,IAAA,EAAM;AACjD,IAAA,UAAA,CAAW,GAAA,CAAI,KAAA,CAAM,CAAC,CAAC,CAAA;AAAA,EACzB;AAGA,EAAA,KAAA,MAAW,aAAa,UAAA,EAAY;AAClC,IAAA,IAAI,EAAE,aAAa,MAAA,CAAA,EAAS;AAC1B,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,CAAA,6BAAA,EAAgC,SAAS,CAAA,YAAA,EAAe,IAAI,CAAA,CAAA;AAAA,OAC9D;AAAA,IACF;AAAA,EACF;AAGA,EAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,WAAA,EAAa,CAAC,GAAG,SAAA,KAAc;AACjD,IAAA,OAAO,MAAA,CAAO,MAAA,CAAO,SAAS,CAAC,CAAA;AAAA,EACjC,CAAC,CAAA;AACH,CAAA;AAEO,IAAM,gBAAA,GAAmB,CAC9B,OAAA,EACA,OAAA,KACoB;AACpB,EAAA,MAAM;AAAA,IACJ,MAAA;AAAA,IACA,UAAA,GAAa,MAAM,OAAA,CAAQ,OAAA,CAAQ,EAAE,CAAA;AAAA,IACrC,OAAO,WAAA,GAAc,KAAA;AAAA,IACrB,QAAA,GAAW;AAAA,GACb,GAAI,WAAW,EAAC;AAEhB,EAAA,MAAM,QAAA,GAAW,CAAC,IAAA,EAAcA,QAAAA,KAA0B;AACxD,IAAA,MAAM,WAAA,GAAcA,QAAAA,EAAS,WAAA,GACzB,GAAA,GAAM,IAAI,gBAAgBA,QAAAA,CAAQ,WAAW,CAAA,CAAE,QAAA,EAAS,GACxD,EAAA;AAEJ,IAAA,MAAM,SAAA,GAAY,IAAA,CAAK,QAAA,CAAS,GAAG,CAAA,GAC/B,iBAAA,CAAkB,IAAA,EAAMA,QAAAA,EAAS,MAAA,IAAU,EAAE,CAAA,GAC7C,IAAA;AAEJ,IAAA,OAAO,CAAA,EAAG,OAAO,CAAA,EAAG,SAAS,GAAG,WAAW,CAAA,CAAA;AAAA,EAC7C,CAAA;AAEA,EAAA,MAAM,gBAAA,GAAmB,CACvB,MAAA,EACA,IAAA,EACA,SACAA,QAAAA,KACG;AACH,IAAA,IAAI,CAAC,QAAA,EAAU;AAEf,IAAA,MAAM,WAAA,GAAe,MAAA,GAAS,MAAM,CAAA,GAAY,IAAI,CAAA;AACpD,IAAA,IAAI,OAAA,IAAW,aAAa,OAAA,EAAS;AACnC,MAAA,WAAA,CAAY,OAAA,CAAQ,MAAM,OAAO,CAAA;AAAA,IACnC;AACA,IAAA,IAAIA,QAAAA,EAAS,WAAA,IAAe,WAAA,EAAa,WAAA,EAAa;AACpD,MAAA,WAAA,CAAY,WAAA,CAAY,KAAA,CAAMA,QAAAA,CAAQ,WAAW,CAAA;AAAA,IACnD;AAAA,EACF,CAAA;AAEA,EAAA,MAAM,cAAA,GAAiB,OACrB,MAAA,EACA,IAAA,EACA,UACAA,QAAAA,KACG;AACH,IAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,MAAA,MAAM,KAAA,GAAa,MAAM,QAAA,CAAS,IAAA,EAAK;AAEvC,MAAA,IAAIA,UAAS,KAAA,EAAO;AAClB,QAAA,OAAA,CAAQ,MAAM,KAAK,CAAA;AAAA,MACrB;AAEA,MAAA,MAAM,IAAI,KAAA,CAAM,KAAA,CAAM,OAAO,CAAA;AAAA,IAC/B;AAEA,IAAA,MAAM,WAAA,GAAe,MAAA,GAAS,MAAM,CAAA,GAAY,IAAI,CAAA;AACpD,IAAA,IAAI,WAAA,EAAa,QAAA,EAAU,IAAA,KAAS,MAAA,EAAQ;AAC1C,MAAA,MAAM,SAAS,IAAA,EAAK;AACpB,MAAA;AAAA,IACF;AAEA,IAAA,MAAM,IAAA,GAAO,MAAM,QAAA,CAAS,IAAA,EAAK;AAEjC,IAAA,OAAO,YAAY,WAAA,EAAa,QAAA,GAC5B,YAAY,QAAA,CAAS,KAAA,CAAM,IAAI,CAAA,GAC/B,IAAA;AAAA,EACN,CAAA;AAEA,EAAA,MAAM,WAAA,GAAc,OAClB,MAAA,EACA,IAAA,EACA,SACAA,QAAAA,KACG;AACH,IAAA,gBAAA,CAAiB,MAAA,EAAQ,IAAA,EAAM,OAAA,EAASA,QAAO,CAAA;AAE/C,IAAA,MAAM,GAAA,GAAM,QAAA,CAAS,IAAA,EAAMA,QAAO,CAAA;AAClC,IAAA,MAAM,YAAA,GAA4B;AAAA,MAChC,MAAA;AAAA,MACA,OAAA,EAAS;AAAA,QACP,cAAA,EAAgB,kBAAA;AAAA,QAChB,GAAI,MAAM,UAAA;AAAW;AACvB,KACF;AAEA,IAAA,IAAI,YAAY,MAAA,EAAW;AACzB,MAAA,YAAA,CAAa,IAAA,GAAO,IAAA,CAAK,SAAA,CAAU,OAAO,CAAA;AAAA,IAC5C;AAEA,IAAA,MAAM,QAAA,GAAW,MAAM,WAAA,CAAY,GAAA,EAAK,YAAY,CAAA;AAEpD,IAAA,OAAO,cAAA,CAAe,MAAA,EAAQ,IAAA,EAAM,QAAA,EAAUA,QAAO,CAAA;AAAA,EACvD,CAAA;AAEA,EAAA,MAAM,cAAA,GAAiB;AAAA,IACrB,GAAA,EAAK,OAAO,IAAA,EAAWA,QAAAA,KACrB,YAAY,KAAA,EAAO,IAAA,EAAM,QAAWA,QAAO,CAAA;AAAA,IAC7C,KAAA,EAAO,OAAO,IAAA,EAAW,OAAA,EAAcA,aACrC,WAAA,CAAY,OAAA,EAAS,IAAA,EAAM,OAAA,EAASA,QAAO,CAAA;AAAA,IAC7C,IAAA,EAAM,OAAO,IAAA,EAAW,OAAA,EAAcA,aACpC,WAAA,CAAY,MAAA,EAAQ,IAAA,EAAM,OAAA,EAASA,QAAO,CAAA;AAAA,IAC5C,GAAA,EAAK,OAAO,IAAA,EAAW,OAAA,EAAcA,aACnC,WAAA,CAAY,KAAA,EAAO,IAAA,EAAM,OAAA,EAASA,QAAO,CAAA;AAAA,IAC3C,KAAA,EAAO,OAAO,IAAA,EAAW,OAAA,EAAcA,aACrC,WAAA,CAAY,OAAA,EAAS,IAAA,EAAM,OAAA,EAASA,QAAO,CAAA;AAAA,IAC7C,MAAA,EAAQ,OAAO,IAAA,EAAW,OAAA,EAAcA,aACtC,WAAA,CAAY,QAAA,EAAU,IAAA,EAAM,OAAA,EAASA,QAAO;AAAA,GAChD;AAEA,EAAA,MAAM,MAAA,GAAS,cAAA;AAEf,EAAA,OAAO,MAAA;AACT;;;AC7JA,IAAM,qBAAqB,CAKzB,MAAA,EACA,QACA,MAAA,EACA,QAAA,EACA,OACA,UAAA,KAOG;AACH,EAAA,OAAO,OAAO,GAAA,EAAc,GAAA,EAAU,IAAA,KAAc;AAClD,IAAA,IAAI;AACF,MAAA,IAAI,MAAA,KAAW,OAAA,IAAW,GAAA,CAAI,MAAA,KAAW,OAAA,EAAS;AAChD,QAAA,GAAA,CAAI,MAAA,CAAO,GAAG,CAAA,CAAE,IAAA,CAAK,oBAAoB,CAAA;AACzC,QAAA;AAAA,MACF;AAEA,MAAA,MAAM,eAAA,GAAkB;AAAA,QACtB,SACE,OAAO,UAAA,KAAe,SAAA,GAClB,UAAA,GACC,WAAW,OAAA,IAAW,KAAA;AAAA,QAE7B,aACE,OAAO,UAAA,KAAe,SAAA,GAClB,UAAA,GACC,WAAW,WAAA,IAAe,KAAA;AAAA,QAEjC,UACE,OAAO,UAAA,KAAe,SAAA,GAClB,UAAA,GACC,WAAW,QAAA,IAAY;AAAA,OAChC;AAEA,MAAA,MAAM,GAAA,GAAO,MAAA,CAAO,GAAG,CAAA,IAAK,EAAC;AAC7B,MAAA,MAAM,WAAA,GAAA,CAAe,MAAA,GAAS,MAAM,CAAA,EAAU,KAAK,CAAA;AAEnD,MAAA,MAAM,IAAA,GAAO;AAAA,QACX,QAAQ,GAAA,CAAI,MAAA;AAAA,QAEZ,GAAI,WAAA,EAAa,OAAA,IACf,eAAA,CAAgB,OAAA,IAAW;AAAA,UACzB,OAAA,EAAS,WAAA,CAAY,OAAA,CAAQ,KAAA,CAAM,IAAI,IAAI;AAAA,SAC7C;AAAA,QAEF,GAAI,WAAA,EAAa,WAAA,IACf,eAAA,CAAgB,WAAA,IAAe;AAAA,UAC7B,WAAA,EAAa,WAAA,CAAY,WAAA,CAAY,KAAA,CAAM,IAAI,KAAK;AAAA;AACtD,OACJ;AAEA,MAAA,MAAM,MAAA,GAAS,MAAM,QAAA,CAAS,MAAM,EAAE,KAAK,CAAA,GAAI,MAAa,GAAG,CAAA;AAE/D,MAAA,GAAA,CAAI,IAAA;AAAA,QACF,WAAA,EAAa,YAAY,eAAA,CAAgB,QAAA,GACrC,aAAa,QAAA,CAAS,KAAA,CAAM,MAAM,CAAA,GAClC;AAAA,OACN;AAAA,IACF,SAAS,GAAA,EAAU;AACjB,MAAA,OAAA,CAAQ,IAAA,CAAK,MAAA,EAAQ,KAAA,EAAO,GAAA,EAAK,OAAO,CAAA;AACxC,MAAA,IAAA,CAAK,GAAG,CAAA;AAAA,IACV;AAAA,EACF,CAAA;AACF,CAAA;AAEO,IAAM,qBAAA,GAAwB,CAInC,MAAA,EACA,MAAA,EAMA,QAAA,KACG;AACH,EAAA,MAAM;AAAA,IACJ,UAAA;AAAA,IACA,UAAA,GAAa,IAAA;AAAA,IACb,MAAM,MAAM,IAAA;AAAA,IACZ;AAAA,GACF,GAAI,MAAA;AAEJ,EAAA,MAAM,gBAAA,GAAmB;AAAA,IACvB,GAAA,EAAK,KAAA;AAAA,IACL,IAAA,EAAM,MAAA;AAAA,IACN,GAAA,EAAK,KAAA;AAAA,IACL,KAAA,EAAO,OAAA;AAAA,IACP,MAAA,EAAQ,QAAA;AAAA,IACR,KAAA,EAAO;AAAA,GACT;AAEA,EAAA,KAAA,MAAW,CAAC,MAAA,EAAQ,YAAY,KAAK,MAAA,CAAO,OAAA,CAAQ,gBAAgB,CAAA,EAAG;AACrE,IAAA,MAAM,SAAA,GAAY,MAAA;AAClB,IAAA,MAAM,YAAA,GAAe,SAAS,SAAS,CAAA;AAEvC,IAAA,IAAI,CAAC,YAAA,EAAc;AAEnB,IAAA,MAAA,GAAS,MAAA,CAAO,IAAA,CAAK,YAAsB,CAAA,CAAE,MAAA;AAAA,MAC3C,CAAC,CAAA,EAAG,KAAA,KACF,CAAA,CAAE,YAAY,CAAA;AAAA,QACZ,KAAA;AAAA,QACA,kBAAA;AAAA,UACE,SAAA;AAAA,UACA,MAAA;AAAA,UACA,GAAA;AAAA,UACA,QAAA;AAAA,UACA,KAAA;AAAA,UACA;AAAA;AACF,OACF;AAAA,MACF;AAAA,KACF;AAAA,EACF;AAEA,EAAA,IAAI,UAAA,EAAY;AACd,IAAA,MAAA,GAAS,MAAA,CAAO,GAAA;AAAA,MAAI,WAAA;AAAA,MAAa,OAAO,GAAG,GAAA,KACzC,GAAA,CAAI,YAAY,YAAY,CAAA,CAAE,KAAK,UAAU;AAAA,KAC/C;AAAA,EACF;AAEA,EAAA,OAAO,MAAA;AACT;;;AC9IO,IAAM,YAAA,GAAe,CAAkC,MAAA,KAC5D","file":"index.js","sourcesContent":["import {\n  type ExtractRouteParams,\n  type InferRouteConfig,\n  type RouterConfig,\n} from \"./types\"\n\n// Reusable type for client options with optional params\ntype ClientOptions<TConfig, K> = Omit<TConfig, \"response\"> & {\n  params?: K extends string ? ExtractRouteParams<K> : unknown\n}\n\nexport type RouterClient<T extends Partial<RouterConfig>> = {\n  [M in keyof T & keyof RouterConfig]: T[M] extends Record<string, any>\n    ? M extends \"GET\"\n      ? <K extends keyof T[M]>(\n          path: K,\n          options?: ClientOptions<\n            Omit<InferRouteConfig<T[M][K]>, \"payload\">,\n            K\n          >,\n        ) => Promise<InferRouteConfig<T[M][K]>[\"response\"]>\n      : <K extends keyof T[M]>(\n          path: K,\n          payload: InferRouteConfig<T[M][K]>[\"payload\"],\n          options?: ClientOptions<\n            Omit<InferRouteConfig<T[M][K]>, \"payload\">,\n            K\n          >,\n        ) => Promise<InferRouteConfig<T[M][K]>[\"response\"]>\n    : never\n}\n\ntype FetchFunction = (url: string, options: RequestInit) => Promise<Response>\n\ntype CreateClientOptions<T extends Partial<RouterConfig>> = {\n  routes?: T\n  getHeaders?: () => Promise<Record<string, string>> | Record<string, string>\n  fetch?: FetchFunction\n  validate?: boolean\n  debug?: boolean\n}\n\n/**\n * Replaces path parameters with their values.\n * @param path - The path template with parameters (e.g., \"/:id/test/:name/info\")\n * @param params - The parameter values (e.g., {id: \"123\", name: \"434\"})\n * @returns The resolved path (e.g., \"/123/test/434/info\")\n * @throws Error if a required parameter is missing\n */\nexport const replacePathParams = (\n  path: string,\n  params: Record<string, string | number>,\n): string => {\n  const paramNames = new Set<string>()\n  const paramPattern = /:([^/]+)/g\n  let match: RegExpExecArray | null\n\n  // Extract all parameter names from the path\n  while ((match = paramPattern.exec(path)) !== null) {\n    paramNames.add(match[1])\n  }\n\n  // Check if all required parameters are provided\n  for (const paramName of paramNames) {\n    if (!(paramName in params)) {\n      throw new Error(\n        `Missing required parameter: \"${paramName}\" for path \"${path}\"`,\n      )\n    }\n  }\n\n  // Replace all parameters with their values\n  return path.replace(/:([^/]+)/g, (_, paramName) => {\n    return String(params[paramName])\n  })\n}\n\nexport const createHttpClient = <T extends Partial<RouterConfig>>(\n  baseUrl: string,\n  options?: CreateClientOptions<T>,\n): RouterClient<T> => {\n  const {\n    routes,\n    getHeaders = () => Promise.resolve({}),\n    fetch: customFetch = fetch,\n    validate = false,\n  } = options ?? {}\n\n  const buildUrl = (path: string, options?: any): string => {\n    const queryString = options?.queryParams\n      ? \"?\" + new URLSearchParams(options.queryParams).toString()\n      : \"\"\n\n    const finalPath = path.includes(\":\")\n      ? replacePathParams(path, options?.params ?? {})\n      : path\n\n    return `${baseUrl}${finalPath}${queryString}`\n  }\n\n  const handleValidation = (\n    method: keyof T & keyof RouterConfig,\n    path: string,\n    payload?: any,\n    options?: any,\n  ) => {\n    if (!validate) return\n\n    const routeConfig = (routes?.[method] as any)?.[path]\n    if (payload && routeConfig?.payload) {\n      routeConfig.payload.parse(payload)\n    }\n    if (options?.queryParams && routeConfig?.queryParams) {\n      routeConfig.queryParams.parse(options.queryParams)\n    }\n  }\n\n  const handleResponse = async (\n    method: keyof T & keyof RouterConfig,\n    path: string,\n    response: Response,\n    options?: any,\n  ) => {\n    if (!response.ok) {\n      const error: any = await response.json()\n\n      if (options?.debug) {\n        console.debug(error)\n      }\n\n      throw new Error(error.message)\n    }\n\n    const routeConfig = (routes?.[method] as any)?.[path]\n    if (routeConfig?.response?.type === \"void\") {\n      await response.text()\n      return\n    }\n\n    const json = await response.json()\n\n    return validate && routeConfig?.response\n      ? routeConfig.response.parse(json)\n      : json\n  }\n\n  const makeRequest = async (\n    method: keyof T & keyof RouterConfig,\n    path: string,\n    payload?: any,\n    options?: any,\n  ) => {\n    handleValidation(method, path, payload, options)\n\n    const url = buildUrl(path, options)\n    const fetchOptions: RequestInit = {\n      method: method as string,\n      headers: {\n        \"Content-Type\": \"application/json\",\n        ...(await getHeaders()),\n      },\n    }\n\n    if (payload !== undefined) {\n      fetchOptions.body = JSON.stringify(payload)\n    }\n\n    const response = await customFetch(url, fetchOptions)\n\n    return handleResponse(method, path, response, options)\n  }\n\n  const methodHandlers = {\n    GET: async (path: any, options?: any) =>\n      makeRequest(\"GET\", path, undefined, options),\n    QUERY: async (path: any, payload: any, options?: any) =>\n      makeRequest(\"QUERY\", path, payload, options),\n    POST: async (path: any, payload: any, options?: any) =>\n      makeRequest(\"POST\", path, payload, options),\n    PUT: async (path: any, payload: any, options?: any) =>\n      makeRequest(\"PUT\", path, payload, options),\n    PATCH: async (path: any, payload: any, options?: any) =>\n      makeRequest(\"PATCH\", path, payload, options),\n    DELETE: async (path: any, payload: any, options?: any) =>\n      makeRequest(\"DELETE\", path, payload, options),\n  }\n\n  const client = methodHandlers as RouterClient<T>\n\n  return client\n}\n","import type { Request, Router } from \"express\"\nimport {\n  type ExtractRouteParams,\n  type InferRouteConfig,\n  type RouteConfig,\n  type RouterConfig,\n} from \"./types\"\n\n// Reusable type for sync or async responses\ntype MaybePromise<T> = Promise<T> | T\n\n// Reusable type for handler data with params\ntype HandlerData<TConfig, K> = Omit<TConfig, \"response\"> & {\n  params: K extends string ? ExtractRouteParams<K> : unknown\n}\n\nexport type RouteHandlers<T extends Partial<RouterConfig>, TContext> = {\n  [M in keyof T & keyof RouterConfig]: T[M] extends Record<string, any>\n    ? {\n        [K in keyof T[M]]: T[M][K] extends\n          | RouteConfig\n          | Omit<RouteConfig, \"payload\">\n          ? (\n              data: M extends \"GET\"\n                ? HandlerData<Omit<InferRouteConfig<T[M][K]>, \"payload\">, K>\n                : HandlerData<InferRouteConfig<T[M][K]>, K>,\n              ctx: TContext,\n            ) => MaybePromise<InferRouteConfig<T[M][K]>[\"response\"]>\n          : never\n      }\n    : never\n}\n\nconst createRouteHandler = <\n  T extends Partial<RouterConfig>,\n  TContext,\n  M extends keyof RouteHandlers<T, TContext>,\n>(\n  method: M,\n  routes: T | undefined,\n  getCtx: (req: Request) => TContext,\n  handlers: RouteHandlers<T, TContext> & {},\n  route: string,\n  validation:\n    | boolean\n    | {\n        payload?: boolean\n        queryParams?: boolean\n        response?: boolean\n      },\n) => {\n  return async (req: Request, res: any, next: any) => {\n    try {\n      if (method === \"QUERY\" && req.method !== \"QUERY\") {\n        res.status(405).send(\"Method Not Allowed\")\n        return\n      }\n\n      const validationCheck = {\n        payload:\n          typeof validation === \"boolean\"\n            ? validation\n            : (validation.payload ?? false),\n\n        queryParams:\n          typeof validation === \"boolean\"\n            ? validation\n            : (validation.queryParams ?? false),\n\n        response:\n          typeof validation === \"boolean\"\n            ? validation\n            : (validation.response ?? false),\n      }\n\n      const ctx = (getCtx(req) ?? {}) as TContext\n      const routeConfig = (routes?.[method] as any)[route]\n\n      const data = {\n        params: req.params,\n\n        ...(routeConfig?.payload &&\n          validationCheck.payload && {\n            payload: routeConfig.payload.parse(req.body),\n          }),\n\n        ...(routeConfig?.queryParams &&\n          validationCheck.queryParams && {\n            queryParams: routeConfig.queryParams.parse(req.query),\n          }),\n      }\n\n      const result = await handlers[method][route]?.(data as any, ctx)\n\n      res.json(\n        routeConfig?.response && validationCheck.response\n          ? routeConfig?.response.parse(result)\n          : result,\n      )\n    } catch (err: any) {\n      console.warn(method, route, err?.message)\n      next(err)\n    }\n  }\n}\n\nexport const registerExpressRoutes = <\n  T extends Partial<RouterConfig>,\n  TContext,\n>(\n  router: Router,\n  config: {\n    routes?: T\n    ctx?: (req: Request) => TContext\n    schemaFile?: string\n    validation?: boolean\n  },\n  handlers: RouteHandlers<T, TContext>,\n) => {\n  const {\n    schemaFile,\n    validation = true,\n    ctx = () => null as TContext,\n    routes,\n  } = config\n\n  const expressMethodMap = {\n    GET: \"get\",\n    POST: \"post\",\n    PUT: \"put\",\n    PATCH: \"patch\",\n    DELETE: \"delete\",\n    QUERY: \"all\",\n  } as const\n\n  for (const [method, routerMethod] of Object.entries(expressMethodMap)) {\n    const methodKey = method as keyof RouteHandlers<T, TContext>\n    const methodRoutes = handlers[methodKey]\n\n    if (!methodRoutes) continue\n\n    router = Object.keys(methodRoutes as object).reduce(\n      (r, route) =>\n        r[routerMethod](\n          route,\n          createRouteHandler(\n            methodKey,\n            routes,\n            ctx,\n            handlers,\n            route,\n            validation,\n          ),\n        ),\n      router,\n    )\n  }\n\n  if (schemaFile) {\n    router = router.get(\"/__routes\", async (_, res) =>\n      res.contentType(\"text/plain\").send(schemaFile),\n    )\n  }\n\n  return router\n}\n","import type z from \"zod\"\n\nexport type RouterConfig = {\n  GET: Record<string, Omit<RouteConfig, \"payload\">>\n  QUERY: Record<string, RouteConfig>\n  POST: Record<string, RouteConfig>\n  PUT: Record<string, RouteConfig>\n  PATCH: Record<string, RouteConfig>\n  DELETE: Record<string, RouteConfig>\n}\n\nexport type RouteConfig = {\n  payload: z.ZodType | unknown\n  queryParams?: z.ZodType | unknown\n  response: z.ZodType | unknown\n}\n\nexport type InferRouteConfig<\n  T extends RouteConfig | Omit<RouteConfig, \"payload\">,\n> = {\n  [K in keyof T]: T[K] extends z.ZodType ? z.infer<T[K]> : T[K]\n}\n\nexport const defineRoutes = <T extends Partial<RouterConfig>>(routes: T): T =>\n  routes\n\n// Extract path parameters from route string\n// e.g., \"/user/:id\" -> { id: string }, \"/user/:id/info\" -> { id: string }, \"/user/:id/post/:postId\" -> { id: string, postId: string }\nexport type ExtractRouteParams<T extends string> =\n  T extends `${infer _Start}:${infer Param}/${infer Rest}`\n    ? Rest extends `:${string}`\n      ? {\n          [K in Param | keyof ExtractRouteParams<`/${Rest}`>]: string\n        }\n      : Rest extends `${string}/:${string}`\n        ? {\n            [K in Param | keyof ExtractRouteParams<`/${Rest}`>]: string\n          }\n        : { [K in Param]: string }\n    : T extends `${infer _Start}:${infer Param}`\n      ? { [K in Param]: string }\n      : Record<string, never>\n"]}

package/dist/index.mjs

@@ -1,4 +1,4 @@
-// src/client.ts
+// src/http.client.ts
 var replacePathParams = (path, params) => {
   const paramNames = /* @__PURE__ */ new Set();
   const paramPattern = /:([^/]+)/g;
@@ -17,23 +17,23 @@ var replacePathParams = (path, params) => {
     return String(params[paramName]);
   });
 };
-var createClient = (routes, options) => {
+var createHttpClient = (baseUrl, options) => {
   const {
-    baseUrl,
+    routes,
     getHeaders = () => Promise.resolve({}),
     fetch: customFetch = fetch,
     validate = false
-  } = options;
+  } = options ?? {};
   const buildUrl = (path, options2) => {
     const queryString = options2?.queryParams ? "?" + new URLSearchParams(options2.queryParams).toString() : "";
     const finalPath = path.includes(":") ? replacePathParams(path, options2?.params ?? {}) : path;
     return `${baseUrl}${finalPath}${queryString}`;
   };
-  const handleValidation = (method, path, body, options2) => {
+  const handleValidation = (method, path, payload, options2) => {
     if (!validate) return;
-    const routeConfig = routes[method]?.[path];
-    if (body && routeConfig?.body) {
-      routeConfig.body.parse(body);
+    const routeConfig = routes?.[method]?.[path];
+    if (payload && routeConfig?.payload) {
+      routeConfig.payload.parse(payload);
     }
     if (options2?.queryParams && routeConfig?.queryParams) {
       routeConfig.queryParams.parse(options2.queryParams);
@@ -47,7 +47,7 @@ var createClient = (routes, options) => {
       }
       throw new Error(error.message);
     }
-    const routeConfig = routes[method]?.[path];
+    const routeConfig = routes?.[method]?.[path];
     if (routeConfig?.response?.type === "void") {
       await response.text();
       return;
@@ -55,8 +55,8 @@ var createClient = (routes, options) => {
     const json = await response.json();
     return validate && routeConfig?.response ? routeConfig.response.parse(json) : json;
   };
-  const makeRequest = async (method, path, body, options2) => {
-    handleValidation(method, path, body, options2);
+  const makeRequest = async (method, path, payload, options2) => {
+    handleValidation(method, path, payload, options2);
     const url = buildUrl(path, options2);
     const fetchOptions = {
       method,
@@ -65,30 +65,25 @@ var createClient = (routes, options) => {
         ...await getHeaders()
       }
     };
-    if (body !== void 0) {
-      fetchOptions.body = JSON.stringify(body);
+    if (payload !== void 0) {
+      fetchOptions.body = JSON.stringify(payload);
     }
     const response = await customFetch(url, fetchOptions);
     return handleResponse(method, path, response, options2);
   };
-  const client = {};
   const methodHandlers = {
     GET: async (path, options2) => makeRequest("GET", path, void 0, options2),
-    QUERY: async (path, body, options2) => makeRequest("QUERY", path, body, options2),
-    POST: async (path, body, options2) => makeRequest("POST", path, body, options2),
-    PUT: async (path, body, options2) => makeRequest("PUT", path, body, options2),
-    PATCH: async (path, body, options2) => makeRequest("PATCH", path, body, options2),
-    DELETE: async (path, body, options2) => makeRequest("DELETE", path, body, options2)
+    QUERY: async (path, payload, options2) => makeRequest("QUERY", path, payload, options2),
+    POST: async (path, payload, options2) => makeRequest("POST", path, payload, options2),
+    PUT: async (path, payload, options2) => makeRequest("PUT", path, payload, options2),
+    PATCH: async (path, payload, options2) => makeRequest("PATCH", path, payload, options2),
+    DELETE: async (path, payload, options2) => makeRequest("DELETE", path, payload, options2)
   };
-  for (const method of Object.keys(routes)) {
-    if (method in methodHandlers) {
-      client[method] = methodHandlers[method];
-    }
-  }
+  const client = methodHandlers;
   return client;
 };
 
-// src/server.ts
+// src/http.server.ts
 var createRouteHandler = (method, routes, getCtx, handlers, route, validation) => {
   return async (req, res, next) => {
     try {
@@ -96,25 +91,39 @@ var createRouteHandler = (method, routes, getCtx, handlers, route, validation) =
         res.status(405).send("Method Not Allowed");
         return;
       }
+      const validationCheck = {
+        payload: typeof validation === "boolean" ? validation : validation.payload ?? false,
+        queryParams: typeof validation === "boolean" ? validation : validation.queryParams ?? false,
+        response: typeof validation === "boolean" ? validation : validation.response ?? false
+      };
       const ctx = getCtx(req) ?? {};
-      const routeConfig = routes[method][route];
+      const routeConfig = (routes?.[method])[route];
       const data = {
         params: req.params,
-        ...routeConfig?.body && { body: routeConfig.body.parse(req.body) },
-        ...routeConfig?.queryParams && {
+        ...routeConfig?.payload && validationCheck.payload && {
+          payload: routeConfig.payload.parse(req.body)
+        },
+        ...routeConfig?.queryParams && validationCheck.queryParams && {
           queryParams: routeConfig.queryParams.parse(req.query)
         }
       };
       const result = await handlers[method][route]?.(data, ctx);
-      res.json(validation ? routeConfig?.response.parse(result) : result);
+      res.json(
+        routeConfig?.response && validationCheck.response ? routeConfig?.response.parse(result) : result
+      );
     } catch (err) {
       console.warn(method, route, err?.message);
       next(err);
     }
   };
 };
-var registerExpressRoutes = (router, routes, config, handlers) => {
-  const { schemaFile, validation = true, ctx = () => null } = config;
+var registerExpressRoutes = (router, config, handlers) => {
+  const {
+    schemaFile,
+    validation = true,
+    ctx = () => null,
+    routes
+  } = config;
   const expressMethodMap = {
     GET: "get",
     POST: "post",
@@ -125,7 +134,7 @@ var registerExpressRoutes = (router, routes, config, handlers) => {
   };
   for (const [method, routerMethod] of Object.entries(expressMethodMap)) {
     const methodKey = method;
-    const methodRoutes = routes[methodKey];
+    const methodRoutes = handlers[methodKey];
     if (!methodRoutes) continue;
     router = Object.keys(methodRoutes).reduce(
       (r, route) => r[routerMethod](
@@ -154,6 +163,6 @@ var registerExpressRoutes = (router, routes, config, handlers) => {
 // src/types.ts
 var defineRoutes = (routes) => routes;
 
-export { createClient, defineRoutes, registerExpressRoutes };
+export { createHttpClient, defineRoutes, registerExpressRoutes };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts","../src/server.ts","../src/types.ts"],"names":["options"],"mappings":"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","file":"index.mjs","sourcesContent":["import {\n  type ExtractRouteParams,\n  type InferRouteConfig,\n  type RouterConfig,\n} from \"./types\"\n\n// Reusable type for client options with optional params\ntype ClientOptions<TConfig, K> = Omit<TConfig, \"response\"> & {\n  params?: K extends string ? ExtractRouteParams<K> : unknown\n}\n\nexport type RouterClient<T extends Partial<RouterConfig>> = {\n  [M in keyof T & keyof RouterConfig]: T[M] extends Record<string, any>\n    ? M extends \"GET\"\n      ? <K extends keyof T[M]>(\n          path: K,\n          options?: ClientOptions<Omit<InferRouteConfig<T[M][K]>, \"body\">, K>\n        ) => Promise<InferRouteConfig<T[M][K]>[\"response\"]>\n      : <K extends keyof T[M]>(\n          path: K,\n          body: InferRouteConfig<T[M][K]>[\"body\"],\n          options?: ClientOptions<Omit<InferRouteConfig<T[M][K]>, \"body\">, K>\n        ) => Promise<InferRouteConfig<T[M][K]>[\"response\"]>\n    : never\n}\n\ntype FetchFunction = (url: string, options: RequestInit) => Promise<Response>\n\ntype CreateClientOptions = {\n  baseUrl: string\n  getHeaders?: () => Promise<Record<string, string>> | Record<string, string>\n  fetch?: FetchFunction\n  validate?: boolean\n  debug?: boolean\n}\n\n/**\n * Replaces path parameters with their values.\n * @param path - The path template with parameters (e.g., \"/:id/test/:name/info\")\n * @param params - The parameter values (e.g., {id: \"123\", name: \"434\"})\n * @returns The resolved path (e.g., \"/123/test/434/info\")\n * @throws Error if a required parameter is missing\n */\nexport const replacePathParams = (\n  path: string,\n  params: Record<string, string | number>\n): string => {\n  const paramNames = new Set<string>()\n  const paramPattern = /:([^/]+)/g\n  let match: RegExpExecArray | null\n\n  // Extract all parameter names from the path\n  while ((match = paramPattern.exec(path)) !== null) {\n    paramNames.add(match[1])\n  }\n\n  // Check if all required parameters are provided\n  for (const paramName of paramNames) {\n    if (!(paramName in params)) {\n      throw new Error(\n        `Missing required parameter: \"${paramName}\" for path \"${path}\"`\n      )\n    }\n  }\n\n  // Replace all parameters with their values\n  return path.replace(/:([^/]+)/g, (_, paramName) => {\n    return String(params[paramName])\n  })\n}\n\nexport const createClient = <T extends Partial<RouterConfig>>(\n  routes: T,\n  options: CreateClientOptions\n): RouterClient<T> => {\n  const {\n    baseUrl,\n    getHeaders = () => Promise.resolve({}),\n    fetch: customFetch = fetch,\n    validate = false,\n  } = options\n\n  const buildUrl = (path: string, options?: any): string => {\n    const queryString = options?.queryParams\n      ? \"?\" + new URLSearchParams(options.queryParams).toString()\n      : \"\"\n\n    const finalPath = path.includes(\":\")\n      ? replacePathParams(path, options?.params ?? {})\n      : path\n\n    return `${baseUrl}${finalPath}${queryString}`\n  }\n\n  const handleValidation = (\n    method: keyof T & keyof RouterConfig,\n    path: string,\n    body?: any,\n    options?: any\n  ) => {\n    if (!validate) return\n\n    const routeConfig = (routes[method] as any)?.[path]\n    if (body && routeConfig?.body) {\n      routeConfig.body.parse(body)\n    }\n    if (options?.queryParams && routeConfig?.queryParams) {\n      routeConfig.queryParams.parse(options.queryParams)\n    }\n  }\n\n  const handleResponse = async (\n    method: keyof T & keyof RouterConfig,\n    path: string,\n    response: Response,\n    options?: any\n  ) => {\n    if (!response.ok) {\n      const error: any = await response.json()\n\n      if (options?.debug) {\n        console.debug(error)\n      }\n\n      throw new Error(error.message)\n    }\n\n    const routeConfig = (routes[method] as any)?.[path]\n    if (routeConfig?.response?.type === \"void\") {\n      await response.text()\n      return\n    }\n\n    const json = await response.json()\n\n    return validate && routeConfig?.response\n      ? routeConfig.response.parse(json)\n      : json\n  }\n\n  const makeRequest = async (\n    method: keyof T & keyof RouterConfig,\n    path: string,\n    body?: any,\n    options?: any\n  ) => {\n    handleValidation(method, path, body, options)\n\n    const url = buildUrl(path, options)\n    const fetchOptions: RequestInit = {\n      method: method as string,\n      headers: {\n        \"Content-Type\": \"application/json\",\n        ...(await getHeaders()),\n      },\n    }\n\n    if (body !== undefined) {\n      fetchOptions.body = JSON.stringify(body)\n    }\n\n    const response = await customFetch(url, fetchOptions)\n\n    return handleResponse(method, path, response, options)\n  }\n\n  const client = {} as RouterClient<T>\n\n  const methodHandlers = {\n    GET: async (path: any, options?: any) =>\n      makeRequest(\"GET\", path, undefined, options),\n    QUERY: async (path: any, body: any, options?: any) =>\n      makeRequest(\"QUERY\", path, body, options),\n    POST: async (path: any, body: any, options?: any) =>\n      makeRequest(\"POST\", path, body, options),\n    PUT: async (path: any, body: any, options?: any) =>\n      makeRequest(\"PUT\", path, body, options),\n    PATCH: async (path: any, body: any, options?: any) =>\n      makeRequest(\"PATCH\", path, body, options),\n    DELETE: async (path: any, body: any, options?: any) =>\n      makeRequest(\"DELETE\", path, body, options),\n  }\n\n  for (const method of Object.keys(routes) as Array<\n    keyof T & keyof RouterConfig\n  >) {\n    if (method in methodHandlers) {\n      ;(client as any)[method] = methodHandlers[method]\n    }\n  }\n\n  return client\n}\n","import type { Request, Router } from \"express\"\nimport {\n  type ExtractRouteParams,\n  type InferRouteConfig,\n  type RouteConfig,\n  type RouterConfig,\n} from \"./types\"\n\n// Reusable type for sync or async responses\ntype MaybePromise<T> = Promise<T> | T\n\n// Reusable type for handler data with params\ntype HandlerData<TConfig, K> = Omit<TConfig, \"response\"> & {\n  params: K extends string ? ExtractRouteParams<K> : unknown\n}\n\nexport type RouteHandlers<T extends Partial<RouterConfig>, TContext> = {\n  [M in keyof T & keyof RouterConfig]: T[M] extends Record<string, any>\n    ? {\n        [K in keyof T[M]]: T[M][K] extends\n          | RouteConfig\n          | Omit<RouteConfig, \"body\">\n          ? (\n              data: M extends \"GET\"\n                ? HandlerData<Omit<InferRouteConfig<T[M][K]>, \"body\">, K>\n                : HandlerData<InferRouteConfig<T[M][K]>, K>,\n              ctx: TContext\n            ) => MaybePromise<InferRouteConfig<T[M][K]>[\"response\"]>\n          : never\n      }\n    : never\n}\n\nconst createRouteHandler = <\n  T extends Partial<RouterConfig>,\n  TContext,\n  M extends keyof RouteHandlers<T, TContext>\n>(\n  method: M,\n  routes: T,\n  getCtx: (req: Request) => TContext,\n  handlers: RouteHandlers<T, TContext> & {},\n  route: string,\n  validation: boolean\n) => {\n  return async (req: Request, res: any, next: any) => {\n    try {\n      if (method === \"QUERY\" && req.method !== \"QUERY\") {\n        res.status(405).send(\"Method Not Allowed\")\n        return\n      }\n\n      const ctx = (getCtx(req) ?? {}) as TContext\n      const routeConfig = (routes[method] as any)[route]\n\n      const data = {\n        params: req.params,\n        ...(routeConfig?.body && { body: routeConfig.body.parse(req.body) }),\n        ...(routeConfig?.queryParams && {\n          queryParams: routeConfig.queryParams.parse(req.query),\n        }),\n      }\n\n      const result = await handlers[method][route]?.(data as any, ctx)\n\n      res.json(validation ? routeConfig?.response.parse(result) : result)\n    } catch (err: any) {\n      console.warn(method, route, err?.message)\n      next(err)\n    }\n  }\n}\n\nexport const registerExpressRoutes = <\n  T extends Partial<RouterConfig>,\n  TContext\n>(\n  router: Router,\n  routes: T,\n  config: {\n    ctx?: (req: Request) => TContext\n    schemaFile?: string\n    validation?: boolean\n  },\n  handlers: RouteHandlers<T, TContext>\n) => {\n  const { schemaFile, validation = true, ctx = () => null as TContext } = config\n\n  const expressMethodMap = {\n    GET: \"get\",\n    POST: \"post\",\n    PUT: \"put\",\n    PATCH: \"patch\",\n    DELETE: \"delete\",\n    QUERY: \"all\",\n  } as const\n\n  for (const [method, routerMethod] of Object.entries(expressMethodMap)) {\n    const methodKey = method as keyof RouteHandlers<T, TContext>\n    const methodRoutes = routes[methodKey]\n\n    if (!methodRoutes) continue\n\n    router = Object.keys(methodRoutes as object).reduce(\n      (r, route) =>\n        r[routerMethod](\n          route,\n          createRouteHandler(\n            methodKey,\n            routes,\n            ctx,\n            handlers,\n            route,\n            validation\n          )\n        ),\n      router\n    )\n  }\n\n  if (schemaFile) {\n    router = router.get(\"/__routes\", async (_, res) =>\n      res.contentType(\"text/plain\").send(schemaFile)\n    )\n  }\n\n  return router\n}\n","import type z from \"zod\"\n\nexport type RouterConfig = {\n  GET: Record<string, Omit<RouteConfig, \"body\">>\n  QUERY: Record<string, RouteConfig>\n  POST: Record<string, RouteConfig>\n  PUT: Record<string, RouteConfig>\n  PATCH: Record<string, RouteConfig>\n  DELETE: Record<string, RouteConfig>\n}\n\nexport type RouteConfig = {\n  body: z.ZodType\n  queryParams?: z.ZodType\n  response: z.ZodType\n}\n\nexport type InferRouteConfig<\n  T extends RouteConfig | Omit<RouteConfig, \"body\">\n> = {\n  [K in keyof T]: T[K] extends z.ZodType ? z.infer<T[K]> : never\n}\n\nexport const defineRoutes = <T extends Partial<RouterConfig>>(\n  routes: T\n): T => routes\n\n// Extract path parameters from route string\n// e.g., \"/user/:id\" -> { id: string }, \"/user/:id/info\" -> { id: string }, \"/user/:id/post/:postId\" -> { id: string, postId: string }\nexport type ExtractRouteParams<T extends string> =\n  T extends `${infer _Start}:${infer Param}/${infer Rest}`\n    ? Rest extends `:${string}`\n      ? {\n          [K in Param | keyof ExtractRouteParams<`/${Rest}`>]: string\n        }\n      : Rest extends `${string}/:${string}`\n      ? {\n          [K in Param | keyof ExtractRouteParams<`/${Rest}`>]: string\n        }\n      : { [K in Param]: string }\n    : T extends `${infer _Start}:${infer Param}`\n    ? { [K in Param]: string }\n    : Record<string, never>\n"]}
+{"version":3,"sources":["../src/http.client.ts","../src/http.server.ts","../src/types.ts"],"names":["options"],"mappings":";AAiDO,IAAM,iBAAA,GAAoB,CAC/B,IAAA,EACA,MAAA,KACW;AACX,EAAA,MAAM,UAAA,uBAAiB,GAAA,EAAY;AACnC,EAAA,MAAM,YAAA,GAAe,WAAA;AACrB,EAAA,IAAI,KAAA;AAGJ,EAAA,OAAA,CAAQ,KAAA,GAAQ,YAAA,CAAa,IAAA,CAAK,IAAI,OAAO,IAAA,EAAM;AACjD,IAAA,UAAA,CAAW,GAAA,CAAI,KAAA,CAAM,CAAC,CAAC,CAAA;AAAA,EACzB;AAGA,EAAA,KAAA,MAAW,aAAa,UAAA,EAAY;AAClC,IAAA,IAAI,EAAE,aAAa,MAAA,CAAA,EAAS;AAC1B,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,CAAA,6BAAA,EAAgC,SAAS,CAAA,YAAA,EAAe,IAAI,CAAA,CAAA;AAAA,OAC9D;AAAA,IACF;AAAA,EACF;AAGA,EAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,WAAA,EAAa,CAAC,GAAG,SAAA,KAAc;AACjD,IAAA,OAAO,MAAA,CAAO,MAAA,CAAO,SAAS,CAAC,CAAA;AAAA,EACjC,CAAC,CAAA;AACH,CAAA;AAEO,IAAM,gBAAA,GAAmB,CAC9B,OAAA,EACA,OAAA,KACoB;AACpB,EAAA,MAAM;AAAA,IACJ,MAAA;AAAA,IACA,UAAA,GAAa,MAAM,OAAA,CAAQ,OAAA,CAAQ,EAAE,CAAA;AAAA,IACrC,OAAO,WAAA,GAAc,KAAA;AAAA,IACrB,QAAA,GAAW;AAAA,GACb,GAAI,WAAW,EAAC;AAEhB,EAAA,MAAM,QAAA,GAAW,CAAC,IAAA,EAAcA,QAAAA,KAA0B;AACxD,IAAA,MAAM,WAAA,GAAcA,QAAAA,EAAS,WAAA,GACzB,GAAA,GAAM,IAAI,gBAAgBA,QAAAA,CAAQ,WAAW,CAAA,CAAE,QAAA,EAAS,GACxD,EAAA;AAEJ,IAAA,MAAM,SAAA,GAAY,IAAA,CAAK,QAAA,CAAS,GAAG,CAAA,GAC/B,iBAAA,CAAkB,IAAA,EAAMA,QAAAA,EAAS,MAAA,IAAU,EAAE,CAAA,GAC7C,IAAA;AAEJ,IAAA,OAAO,CAAA,EAAG,OAAO,CAAA,EAAG,SAAS,GAAG,WAAW,CAAA,CAAA;AAAA,EAC7C,CAAA;AAEA,EAAA,MAAM,gBAAA,GAAmB,CACvB,MAAA,EACA,IAAA,EACA,SACAA,QAAAA,KACG;AACH,IAAA,IAAI,CAAC,QAAA,EAAU;AAEf,IAAA,MAAM,WAAA,GAAe,MAAA,GAAS,MAAM,CAAA,GAAY,IAAI,CAAA;AACpD,IAAA,IAAI,OAAA,IAAW,aAAa,OAAA,EAAS;AACnC,MAAA,WAAA,CAAY,OAAA,CAAQ,MAAM,OAAO,CAAA;AAAA,IACnC;AACA,IAAA,IAAIA,QAAAA,EAAS,WAAA,IAAe,WAAA,EAAa,WAAA,EAAa;AACpD,MAAA,WAAA,CAAY,WAAA,CAAY,KAAA,CAAMA,QAAAA,CAAQ,WAAW,CAAA;AAAA,IACnD;AAAA,EACF,CAAA;AAEA,EAAA,MAAM,cAAA,GAAiB,OACrB,MAAA,EACA,IAAA,EACA,UACAA,QAAAA,KACG;AACH,IAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,MAAA,MAAM,KAAA,GAAa,MAAM,QAAA,CAAS,IAAA,EAAK;AAEvC,MAAA,IAAIA,UAAS,KAAA,EAAO;AAClB,QAAA,OAAA,CAAQ,MAAM,KAAK,CAAA;AAAA,MACrB;AAEA,MAAA,MAAM,IAAI,KAAA,CAAM,KAAA,CAAM,OAAO,CAAA;AAAA,IAC/B;AAEA,IAAA,MAAM,WAAA,GAAe,MAAA,GAAS,MAAM,CAAA,GAAY,IAAI,CAAA;AACpD,IAAA,IAAI,WAAA,EAAa,QAAA,EAAU,IAAA,KAAS,MAAA,EAAQ;AAC1C,MAAA,MAAM,SAAS,IAAA,EAAK;AACpB,MAAA;AAAA,IACF;AAEA,IAAA,MAAM,IAAA,GAAO,MAAM,QAAA,CAAS,IAAA,EAAK;AAEjC,IAAA,OAAO,YAAY,WAAA,EAAa,QAAA,GAC5B,YAAY,QAAA,CAAS,KAAA,CAAM,IAAI,CAAA,GAC/B,IAAA;AAAA,EACN,CAAA;AAEA,EAAA,MAAM,WAAA,GAAc,OAClB,MAAA,EACA,IAAA,EACA,SACAA,QAAAA,KACG;AACH,IAAA,gBAAA,CAAiB,MAAA,EAAQ,IAAA,EAAM,OAAA,EAASA,QAAO,CAAA;AAE/C,IAAA,MAAM,GAAA,GAAM,QAAA,CAAS,IAAA,EAAMA,QAAO,CAAA;AAClC,IAAA,MAAM,YAAA,GAA4B;AAAA,MAChC,MAAA;AAAA,MACA,OAAA,EAAS;AAAA,QACP,cAAA,EAAgB,kBAAA;AAAA,QAChB,GAAI,MAAM,UAAA;AAAW;AACvB,KACF;AAEA,IAAA,IAAI,YAAY,MAAA,EAAW;AACzB,MAAA,YAAA,CAAa,IAAA,GAAO,IAAA,CAAK,SAAA,CAAU,OAAO,CAAA;AAAA,IAC5C;AAEA,IAAA,MAAM,QAAA,GAAW,MAAM,WAAA,CAAY,GAAA,EAAK,YAAY,CAAA;AAEpD,IAAA,OAAO,cAAA,CAAe,MAAA,EAAQ,IAAA,EAAM,QAAA,EAAUA,QAAO,CAAA;AAAA,EACvD,CAAA;AAEA,EAAA,MAAM,cAAA,GAAiB;AAAA,IACrB,GAAA,EAAK,OAAO,IAAA,EAAWA,QAAAA,KACrB,YAAY,KAAA,EAAO,IAAA,EAAM,QAAWA,QAAO,CAAA;AAAA,IAC7C,KAAA,EAAO,OAAO,IAAA,EAAW,OAAA,EAAcA,aACrC,WAAA,CAAY,OAAA,EAAS,IAAA,EAAM,OAAA,EAASA,QAAO,CAAA;AAAA,IAC7C,IAAA,EAAM,OAAO,IAAA,EAAW,OAAA,EAAcA,aACpC,WAAA,CAAY,MAAA,EAAQ,IAAA,EAAM,OAAA,EAASA,QAAO,CAAA;AAAA,IAC5C,GAAA,EAAK,OAAO,IAAA,EAAW,OAAA,EAAcA,aACnC,WAAA,CAAY,KAAA,EAAO,IAAA,EAAM,OAAA,EAASA,QAAO,CAAA;AAAA,IAC3C,KAAA,EAAO,OAAO,IAAA,EAAW,OAAA,EAAcA,aACrC,WAAA,CAAY,OAAA,EAAS,IAAA,EAAM,OAAA,EAASA,QAAO,CAAA;AAAA,IAC7C,MAAA,EAAQ,OAAO,IAAA,EAAW,OAAA,EAAcA,aACtC,WAAA,CAAY,QAAA,EAAU,IAAA,EAAM,OAAA,EAASA,QAAO;AAAA,GAChD;AAEA,EAAA,MAAM,MAAA,GAAS,cAAA;AAEf,EAAA,OAAO,MAAA;AACT;;;AC7JA,IAAM,qBAAqB,CAKzB,MAAA,EACA,QACA,MAAA,EACA,QAAA,EACA,OACA,UAAA,KAOG;AACH,EAAA,OAAO,OAAO,GAAA,EAAc,GAAA,EAAU,IAAA,KAAc;AAClD,IAAA,IAAI;AACF,MAAA,IAAI,MAAA,KAAW,OAAA,IAAW,GAAA,CAAI,MAAA,KAAW,OAAA,EAAS;AAChD,QAAA,GAAA,CAAI,MAAA,CAAO,GAAG,CAAA,CAAE,IAAA,CAAK,oBAAoB,CAAA;AACzC,QAAA;AAAA,MACF;AAEA,MAAA,MAAM,eAAA,GAAkB;AAAA,QACtB,SACE,OAAO,UAAA,KAAe,SAAA,GAClB,UAAA,GACC,WAAW,OAAA,IAAW,KAAA;AAAA,QAE7B,aACE,OAAO,UAAA,KAAe,SAAA,GAClB,UAAA,GACC,WAAW,WAAA,IAAe,KAAA;AAAA,QAEjC,UACE,OAAO,UAAA,KAAe,SAAA,GAClB,UAAA,GACC,WAAW,QAAA,IAAY;AAAA,OAChC;AAEA,MAAA,MAAM,GAAA,GAAO,MAAA,CAAO,GAAG,CAAA,IAAK,EAAC;AAC7B,MAAA,MAAM,WAAA,GAAA,CAAe,MAAA,GAAS,MAAM,CAAA,EAAU,KAAK,CAAA;AAEnD,MAAA,MAAM,IAAA,GAAO;AAAA,QACX,QAAQ,GAAA,CAAI,MAAA;AAAA,QAEZ,GAAI,WAAA,EAAa,OAAA,IACf,eAAA,CAAgB,OAAA,IAAW;AAAA,UACzB,OAAA,EAAS,WAAA,CAAY,OAAA,CAAQ,KAAA,CAAM,IAAI,IAAI;AAAA,SAC7C;AAAA,QAEF,GAAI,WAAA,EAAa,WAAA,IACf,eAAA,CAAgB,WAAA,IAAe;AAAA,UAC7B,WAAA,EAAa,WAAA,CAAY,WAAA,CAAY,KAAA,CAAM,IAAI,KAAK;AAAA;AACtD,OACJ;AAEA,MAAA,MAAM,MAAA,GAAS,MAAM,QAAA,CAAS,MAAM,EAAE,KAAK,CAAA,GAAI,MAAa,GAAG,CAAA;AAE/D,MAAA,GAAA,CAAI,IAAA;AAAA,QACF,WAAA,EAAa,YAAY,eAAA,CAAgB,QAAA,GACrC,aAAa,QAAA,CAAS,KAAA,CAAM,MAAM,CAAA,GAClC;AAAA,OACN;AAAA,IACF,SAAS,GAAA,EAAU;AACjB,MAAA,OAAA,CAAQ,IAAA,CAAK,MAAA,EAAQ,KAAA,EAAO,GAAA,EAAK,OAAO,CAAA;AACxC,MAAA,IAAA,CAAK,GAAG,CAAA;AAAA,IACV;AAAA,EACF,CAAA;AACF,CAAA;AAEO,IAAM,qBAAA,GAAwB,CAInC,MAAA,EACA,MAAA,EAMA,QAAA,KACG;AACH,EAAA,MAAM;AAAA,IACJ,UAAA;AAAA,IACA,UAAA,GAAa,IAAA;AAAA,IACb,MAAM,MAAM,IAAA;AAAA,IACZ;AAAA,GACF,GAAI,MAAA;AAEJ,EAAA,MAAM,gBAAA,GAAmB;AAAA,IACvB,GAAA,EAAK,KAAA;AAAA,IACL,IAAA,EAAM,MAAA;AAAA,IACN,GAAA,EAAK,KAAA;AAAA,IACL,KAAA,EAAO,OAAA;AAAA,IACP,MAAA,EAAQ,QAAA;AAAA,IACR,KAAA,EAAO;AAAA,GACT;AAEA,EAAA,KAAA,MAAW,CAAC,MAAA,EAAQ,YAAY,KAAK,MAAA,CAAO,OAAA,CAAQ,gBAAgB,CAAA,EAAG;AACrE,IAAA,MAAM,SAAA,GAAY,MAAA;AAClB,IAAA,MAAM,YAAA,GAAe,SAAS,SAAS,CAAA;AAEvC,IAAA,IAAI,CAAC,YAAA,EAAc;AAEnB,IAAA,MAAA,GAAS,MAAA,CAAO,IAAA,CAAK,YAAsB,CAAA,CAAE,MAAA;AAAA,MAC3C,CAAC,CAAA,EAAG,KAAA,KACF,CAAA,CAAE,YAAY,CAAA;AAAA,QACZ,KAAA;AAAA,QACA,kBAAA;AAAA,UACE,SAAA;AAAA,UACA,MAAA;AAAA,UACA,GAAA;AAAA,UACA,QAAA;AAAA,UACA,KAAA;AAAA,UACA;AAAA;AACF,OACF;AAAA,MACF;AAAA,KACF;AAAA,EACF;AAEA,EAAA,IAAI,UAAA,EAAY;AACd,IAAA,MAAA,GAAS,MAAA,CAAO,GAAA;AAAA,MAAI,WAAA;AAAA,MAAa,OAAO,GAAG,GAAA,KACzC,GAAA,CAAI,YAAY,YAAY,CAAA,CAAE,KAAK,UAAU;AAAA,KAC/C;AAAA,EACF;AAEA,EAAA,OAAO,MAAA;AACT;;;AC9IO,IAAM,YAAA,GAAe,CAAkC,MAAA,KAC5D","file":"index.mjs","sourcesContent":["import {\n  type ExtractRouteParams,\n  type InferRouteConfig,\n  type RouterConfig,\n} from \"./types\"\n\n// Reusable type for client options with optional params\ntype ClientOptions<TConfig, K> = Omit<TConfig, \"response\"> & {\n  params?: K extends string ? ExtractRouteParams<K> : unknown\n}\n\nexport type RouterClient<T extends Partial<RouterConfig>> = {\n  [M in keyof T & keyof RouterConfig]: T[M] extends Record<string, any>\n    ? M extends \"GET\"\n      ? <K extends keyof T[M]>(\n          path: K,\n          options?: ClientOptions<\n            Omit<InferRouteConfig<T[M][K]>, \"payload\">,\n            K\n          >,\n        ) => Promise<InferRouteConfig<T[M][K]>[\"response\"]>\n      : <K extends keyof T[M]>(\n          path: K,\n          payload: InferRouteConfig<T[M][K]>[\"payload\"],\n          options?: ClientOptions<\n            Omit<InferRouteConfig<T[M][K]>, \"payload\">,\n            K\n          >,\n        ) => Promise<InferRouteConfig<T[M][K]>[\"response\"]>\n    : never\n}\n\ntype FetchFunction = (url: string, options: RequestInit) => Promise<Response>\n\ntype CreateClientOptions<T extends Partial<RouterConfig>> = {\n  routes?: T\n  getHeaders?: () => Promise<Record<string, string>> | Record<string, string>\n  fetch?: FetchFunction\n  validate?: boolean\n  debug?: boolean\n}\n\n/**\n * Replaces path parameters with their values.\n * @param path - The path template with parameters (e.g., \"/:id/test/:name/info\")\n * @param params - The parameter values (e.g., {id: \"123\", name: \"434\"})\n * @returns The resolved path (e.g., \"/123/test/434/info\")\n * @throws Error if a required parameter is missing\n */\nexport const replacePathParams = (\n  path: string,\n  params: Record<string, string | number>,\n): string => {\n  const paramNames = new Set<string>()\n  const paramPattern = /:([^/]+)/g\n  let match: RegExpExecArray | null\n\n  // Extract all parameter names from the path\n  while ((match = paramPattern.exec(path)) !== null) {\n    paramNames.add(match[1])\n  }\n\n  // Check if all required parameters are provided\n  for (const paramName of paramNames) {\n    if (!(paramName in params)) {\n      throw new Error(\n        `Missing required parameter: \"${paramName}\" for path \"${path}\"`,\n      )\n    }\n  }\n\n  // Replace all parameters with their values\n  return path.replace(/:([^/]+)/g, (_, paramName) => {\n    return String(params[paramName])\n  })\n}\n\nexport const createHttpClient = <T extends Partial<RouterConfig>>(\n  baseUrl: string,\n  options?: CreateClientOptions<T>,\n): RouterClient<T> => {\n  const {\n    routes,\n    getHeaders = () => Promise.resolve({}),\n    fetch: customFetch = fetch,\n    validate = false,\n  } = options ?? {}\n\n  const buildUrl = (path: string, options?: any): string => {\n    const queryString = options?.queryParams\n      ? \"?\" + new URLSearchParams(options.queryParams).toString()\n      : \"\"\n\n    const finalPath = path.includes(\":\")\n      ? replacePathParams(path, options?.params ?? {})\n      : path\n\n    return `${baseUrl}${finalPath}${queryString}`\n  }\n\n  const handleValidation = (\n    method: keyof T & keyof RouterConfig,\n    path: string,\n    payload?: any,\n    options?: any,\n  ) => {\n    if (!validate) return\n\n    const routeConfig = (routes?.[method] as any)?.[path]\n    if (payload && routeConfig?.payload) {\n      routeConfig.payload.parse(payload)\n    }\n    if (options?.queryParams && routeConfig?.queryParams) {\n      routeConfig.queryParams.parse(options.queryParams)\n    }\n  }\n\n  const handleResponse = async (\n    method: keyof T & keyof RouterConfig,\n    path: string,\n    response: Response,\n    options?: any,\n  ) => {\n    if (!response.ok) {\n      const error: any = await response.json()\n\n      if (options?.debug) {\n        console.debug(error)\n      }\n\n      throw new Error(error.message)\n    }\n\n    const routeConfig = (routes?.[method] as any)?.[path]\n    if (routeConfig?.response?.type === \"void\") {\n      await response.text()\n      return\n    }\n\n    const json = await response.json()\n\n    return validate && routeConfig?.response\n      ? routeConfig.response.parse(json)\n      : json\n  }\n\n  const makeRequest = async (\n    method: keyof T & keyof RouterConfig,\n    path: string,\n    payload?: any,\n    options?: any,\n  ) => {\n    handleValidation(method, path, payload, options)\n\n    const url = buildUrl(path, options)\n    const fetchOptions: RequestInit = {\n      method: method as string,\n      headers: {\n        \"Content-Type\": \"application/json\",\n        ...(await getHeaders()),\n      },\n    }\n\n    if (payload !== undefined) {\n      fetchOptions.body = JSON.stringify(payload)\n    }\n\n    const response = await customFetch(url, fetchOptions)\n\n    return handleResponse(method, path, response, options)\n  }\n\n  const methodHandlers = {\n    GET: async (path: any, options?: any) =>\n      makeRequest(\"GET\", path, undefined, options),\n    QUERY: async (path: any, payload: any, options?: any) =>\n      makeRequest(\"QUERY\", path, payload, options),\n    POST: async (path: any, payload: any, options?: any) =>\n      makeRequest(\"POST\", path, payload, options),\n    PUT: async (path: any, payload: any, options?: any) =>\n      makeRequest(\"PUT\", path, payload, options),\n    PATCH: async (path: any, payload: any, options?: any) =>\n      makeRequest(\"PATCH\", path, payload, options),\n    DELETE: async (path: any, payload: any, options?: any) =>\n      makeRequest(\"DELETE\", path, payload, options),\n  }\n\n  const client = methodHandlers as RouterClient<T>\n\n  return client\n}\n","import type { Request, Router } from \"express\"\nimport {\n  type ExtractRouteParams,\n  type InferRouteConfig,\n  type RouteConfig,\n  type RouterConfig,\n} from \"./types\"\n\n// Reusable type for sync or async responses\ntype MaybePromise<T> = Promise<T> | T\n\n// Reusable type for handler data with params\ntype HandlerData<TConfig, K> = Omit<TConfig, \"response\"> & {\n  params: K extends string ? ExtractRouteParams<K> : unknown\n}\n\nexport type RouteHandlers<T extends Partial<RouterConfig>, TContext> = {\n  [M in keyof T & keyof RouterConfig]: T[M] extends Record<string, any>\n    ? {\n        [K in keyof T[M]]: T[M][K] extends\n          | RouteConfig\n          | Omit<RouteConfig, \"payload\">\n          ? (\n              data: M extends \"GET\"\n                ? HandlerData<Omit<InferRouteConfig<T[M][K]>, \"payload\">, K>\n                : HandlerData<InferRouteConfig<T[M][K]>, K>,\n              ctx: TContext,\n            ) => MaybePromise<InferRouteConfig<T[M][K]>[\"response\"]>\n          : never\n      }\n    : never\n}\n\nconst createRouteHandler = <\n  T extends Partial<RouterConfig>,\n  TContext,\n  M extends keyof RouteHandlers<T, TContext>,\n>(\n  method: M,\n  routes: T | undefined,\n  getCtx: (req: Request) => TContext,\n  handlers: RouteHandlers<T, TContext> & {},\n  route: string,\n  validation:\n    | boolean\n    | {\n        payload?: boolean\n        queryParams?: boolean\n        response?: boolean\n      },\n) => {\n  return async (req: Request, res: any, next: any) => {\n    try {\n      if (method === \"QUERY\" && req.method !== \"QUERY\") {\n        res.status(405).send(\"Method Not Allowed\")\n        return\n      }\n\n      const validationCheck = {\n        payload:\n          typeof validation === \"boolean\"\n            ? validation\n            : (validation.payload ?? false),\n\n        queryParams:\n          typeof validation === \"boolean\"\n            ? validation\n            : (validation.queryParams ?? false),\n\n        response:\n          typeof validation === \"boolean\"\n            ? validation\n            : (validation.response ?? false),\n      }\n\n      const ctx = (getCtx(req) ?? {}) as TContext\n      const routeConfig = (routes?.[method] as any)[route]\n\n      const data = {\n        params: req.params,\n\n        ...(routeConfig?.payload &&\n          validationCheck.payload && {\n            payload: routeConfig.payload.parse(req.body),\n          }),\n\n        ...(routeConfig?.queryParams &&\n          validationCheck.queryParams && {\n            queryParams: routeConfig.queryParams.parse(req.query),\n          }),\n      }\n\n      const result = await handlers[method][route]?.(data as any, ctx)\n\n      res.json(\n        routeConfig?.response && validationCheck.response\n          ? routeConfig?.response.parse(result)\n          : result,\n      )\n    } catch (err: any) {\n      console.warn(method, route, err?.message)\n      next(err)\n    }\n  }\n}\n\nexport const registerExpressRoutes = <\n  T extends Partial<RouterConfig>,\n  TContext,\n>(\n  router: Router,\n  config: {\n    routes?: T\n    ctx?: (req: Request) => TContext\n    schemaFile?: string\n    validation?: boolean\n  },\n  handlers: RouteHandlers<T, TContext>,\n) => {\n  const {\n    schemaFile,\n    validation = true,\n    ctx = () => null as TContext,\n    routes,\n  } = config\n\n  const expressMethodMap = {\n    GET: \"get\",\n    POST: \"post\",\n    PUT: \"put\",\n    PATCH: \"patch\",\n    DELETE: \"delete\",\n    QUERY: \"all\",\n  } as const\n\n  for (const [method, routerMethod] of Object.entries(expressMethodMap)) {\n    const methodKey = method as keyof RouteHandlers<T, TContext>\n    const methodRoutes = handlers[methodKey]\n\n    if (!methodRoutes) continue\n\n    router = Object.keys(methodRoutes as object).reduce(\n      (r, route) =>\n        r[routerMethod](\n          route,\n          createRouteHandler(\n            methodKey,\n            routes,\n            ctx,\n            handlers,\n            route,\n            validation,\n          ),\n        ),\n      router,\n    )\n  }\n\n  if (schemaFile) {\n    router = router.get(\"/__routes\", async (_, res) =>\n      res.contentType(\"text/plain\").send(schemaFile),\n    )\n  }\n\n  return router\n}\n","import type z from \"zod\"\n\nexport type RouterConfig = {\n  GET: Record<string, Omit<RouteConfig, \"payload\">>\n  QUERY: Record<string, RouteConfig>\n  POST: Record<string, RouteConfig>\n  PUT: Record<string, RouteConfig>\n  PATCH: Record<string, RouteConfig>\n  DELETE: Record<string, RouteConfig>\n}\n\nexport type RouteConfig = {\n  payload: z.ZodType | unknown\n  queryParams?: z.ZodType | unknown\n  response: z.ZodType | unknown\n}\n\nexport type InferRouteConfig<\n  T extends RouteConfig | Omit<RouteConfig, \"payload\">,\n> = {\n  [K in keyof T]: T[K] extends z.ZodType ? z.infer<T[K]> : T[K]\n}\n\nexport const defineRoutes = <T extends Partial<RouterConfig>>(routes: T): T =>\n  routes\n\n// Extract path parameters from route string\n// e.g., \"/user/:id\" -> { id: string }, \"/user/:id/info\" -> { id: string }, \"/user/:id/post/:postId\" -> { id: string, postId: string }\nexport type ExtractRouteParams<T extends string> =\n  T extends `${infer _Start}:${infer Param}/${infer Rest}`\n    ? Rest extends `:${string}`\n      ? {\n          [K in Param | keyof ExtractRouteParams<`/${Rest}`>]: string\n        }\n      : Rest extends `${string}/:${string}`\n        ? {\n            [K in Param | keyof ExtractRouteParams<`/${Rest}`>]: string\n          }\n        : { [K in Param]: string }\n    : T extends `${infer _Start}:${infer Param}`\n      ? { [K in Param]: string }\n      : Record<string, never>\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jokio/rpc",
-  "version": "0.8.1",
+  "version": "1.1.0",
   "description": "Type-safe RPC framework with Zod validation for Express and TypeScript",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",