@jokio/rpc 0.7.0 → 0.7.2

package/README.md

@@ -14,7 +14,8 @@ A type-safe RPC framework for TypeScript with Zod validation, designed for Expre
 - Runtime validation using Zod schemas
 - Express.js integration for server-side
 - Flexible fetch-based client with custom fetch support
-- Query parameters and request body validation
+- Support for multiple HTTP methods (GET, POST, PUT, PATCH, DELETE, QUERY)
+- Path parameters, query parameters, and request body validation
 - Automatic response validation
 
 ## Installation
@@ -34,6 +35,9 @@ 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(),
@@ -54,6 +58,19 @@ const routes = defineRoutes({
       }),
     },
   },
+  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(),
+      }),
+    },
+  },
 })
 ```
 
@@ -70,7 +87,9 @@ const router = express.Router()
 
 registerExpressRoutes(router, routes, {
   GET: {
-    "/user/:id": async ({ params }) => {
+    "/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",
@@ -80,6 +99,7 @@ registerExpressRoutes(router, routes, {
   },
   POST: {
     "/user": async ({ body }) => {
+      // body is validated by Zod
       return {
         id: "2",
         name: body.name,
@@ -87,6 +107,16 @@ registerExpressRoutes(router, routes, {
       }
     },
   },
+  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",
+      }
+    },
+  },
 })
 
 app.use("/api", router)
@@ -103,13 +133,28 @@ const client = createClient(routes, {
   validate: true, // Optional: validate requests on client-side
 })
 
-// Fully typed API calls
-const user = await client.GET("/users/23")
+// Fully typed API calls with path parameters
+const user = await client.GET("/user/:id", {
+  params: { id: "23" },
+  queryParams: { include: "profile" },
+})
 
-const newUser = await client.POST("/users", {
+// POST request with body
+const newUser = await client.POST("/user", {
   name: "Jane Doe",
   email: "jane@example.com",
 })
+
+// PUT request with path parameters and body
+const updatedUser = await client.PUT(
+  "/user/:id",
+  {
+    name: "Jane Smith",
+  },
+  {
+    params: { id: "23" },
+  }
+)
 ```
 
 ## API Reference
@@ -120,7 +165,13 @@ Helper function to define routes with type inference.
 
 **Parameters:**
 
-- `routes`: Route definitions object containing GET and POST route configurations
+- `routes`: Route definitions object containing method configurations (GET, POST, PUT, PATCH, DELETE, QUERY)
+
+**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
 
 ### `registerExpressRoutes(router, routes, handlers)`
 
@@ -130,10 +181,14 @@ Registers route handlers to an Express router with automatic validation.
 
 - `router`: Express Router instance
 - `routes`: Route definitions object
-- `handlers`: Handler functions for each route with optional context factory
+- `handlers`: Handler functions for each route with optional configuration
   - `ctx`: Optional function `(req: Request) => TContext` to provide context to handlers
-  - `GET`: Handler functions that receive `(data, ctx)` parameters
-  - `POST`: Handler functions that receive `(data, ctx)` parameters
+  - `validation`: Optional boolean to enable response validation (default: false)
+  - `schemaFile`: Optional path to expose route schemas at `/__routes` endpoint
+  - `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)
 
 ### `createClient(routes, options)`
 
@@ -146,7 +201,21 @@ Creates a type-safe HTTP client.
   - `baseUrl`: Base URL for API requests
   - `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: false)
+  - `validate`: Enable client-side request validation (default: true)
+  - `debug`: Enable debug logging (default: false)
+
+**Client Methods:**
+
+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)
 
 ## Type Safety
 
@@ -154,13 +223,24 @@ The library provides end-to-end type safety:
 
 ```typescript
 // TypeScript knows the exact shape of requests and responses
-const result = await client.POST("/users", {
+const result = await client.POST("/user", {
   name: "John",
   email: "invalid-email", // Zod will catch this at runtime
 })
 
 // result is typed as { id: string; name: string; email: string }
 console.log(result.id)
+
+// Path parameters are type-safe
+const user = await client.GET("/user/:id", {
+  params: { id: "123" }, // TypeScript enforces correct parameter names
+})
+
+// Query parameters are validated
+const users = await client.GET("/user/:id", {
+  params: { id: "123" },
+  queryParams: { include: "profile" }, // Must match Zod schema
+})
 ```
 
 ## Error Handling
@@ -169,13 +249,23 @@ The library throws errors for:
 
 - HTTP errors (non-2xx responses)
 - Validation errors (invalid request/response data)
+- Missing path parameters
 
 ```typescript
 try {
-  await client.POST("/users", invalidData)
+  await client.POST("/user", invalidData)
 } catch (error) {
   // Handle validation or HTTP errors
 }
+
+// Missing path parameters will throw an error
+try {
+  await client.GET("/user/:id", {
+    params: {}, // Missing 'id' parameter
+  })
+} catch (error) {
+  // Error: Missing required parameter: "id" for path "/user/:id"
+}
 ```
 
 ## License

package/dist/index.d.mts

@@ -55,7 +55,7 @@ type RouteHandlers<T extends Partial<RouterConfig>, TContext> = {
 };
 declare const registerExpressRoutes: <T extends Partial<RouterConfig>, TContext>(router: Router, routes: T, handlers: RouteHandlers<T, TContext> & {
     ctx?: (req: Request) => TContext;
-    schemaFilePath?: string;
+    schemaFile?: string;
     validation?: boolean;
 }) => Router;
 

package/dist/index.d.ts

@@ -55,7 +55,7 @@ type RouteHandlers<T extends Partial<RouterConfig>, TContext> = {
 };
 declare const registerExpressRoutes: <T extends Partial<RouterConfig>, TContext>(router: Router, routes: T, handlers: RouteHandlers<T, TContext> & {
     ctx?: (req: Request) => TContext;
-    schemaFilePath?: string;
+    schemaFile?: string;
     validation?: boolean;
 }) => Router;
 

package/dist/index.js

@@ -1,7 +1,5 @@
 'use strict';
 
-var promises = require('fs/promises');
-
 // src/client.ts
 var replacePathParams = (path, params) => {
   const paramNames = /* @__PURE__ */ new Set();
@@ -91,7 +89,9 @@ var createClient = (routes, options) => {
   }
   return client;
 };
-var createRouteHandler = (method, routes, handlers, route) => {
+
+// src/server.ts
+var createRouteHandler = (method, routes, handlers, route, validation) => {
   return async (req, res, next) => {
     try {
       if (method === "QUERY" && req.method !== "QUERY") {
@@ -108,16 +108,14 @@ var createRouteHandler = (method, routes, handlers, route) => {
         }
       };
       const result = await handlers[method][route]?.(data, ctx);
-      res.json(
-        handlers.validation ? routeConfig?.response.parse(result) : result
-      );
+      res.json(validation ? routeConfig?.response.parse(result) : result);
     } catch (err) {
       next(err);
     }
   };
 };
 var registerExpressRoutes = (router, routes, handlers) => {
-  const { schemaFilePath } = handlers;
+  const { schemaFile, validation = true } = handlers;
   const expressMethodMap = {
     GET: "get",
     POST: "post",
@@ -133,15 +131,15 @@ var registerExpressRoutes = (router, routes, handlers) => {
     router = Object.keys(methodRoutes).reduce(
       (r, route) => r[routerMethod](
         route,
-        createRouteHandler(methodKey, routes, handlers, route)
+        createRouteHandler(methodKey, routes, handlers, route, validation)
       ),
       router
     );
   }
-  if (schemaFilePath) {
+  if (schemaFile) {
     router = router.get(
-      "/__schema",
-      async (_, res) => res.contentType("text/plain").send(await promises.readFile(schemaFilePath, "utf8"))
+      "/__routes",
+      async (_, res) => res.contentType("text/plain").send(schemaFile)
     );
   }
   return router;

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts","../src/server.ts","../src/types.ts"],"names":["options","readFile"],"mappings":";;;;;AA2CO,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,YAAA,GAAe,CAC1B,MAAA,EACA,OAAA,KACoB;AACpB,EAAA,MAAM;AAAA,IACJ,OAAA;AAAA,IACA,UAAA,GAAa,MAAM,OAAA,CAAQ,OAAA,CAAQ,EAAE,CAAA;AAAA,IACrC,OAAO,WAAA,GAAc,KAAA;AAAA,IACrB,QAAA,GAAW;AAAA,GACb,GAAI,OAAA;AAEJ,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,MACAA,QAAAA,KACG;AACH,IAAA,IAAI,CAAC,QAAA,EAAU;AAEf,IAAA,MAAM,WAAA,GAAe,MAAA,CAAO,MAAM,CAAA,GAAY,IAAI,CAAA;AAClD,IAAA,IAAI,IAAA,IAAQ,aAAa,IAAA,EAAM;AAC7B,MAAA,WAAA,CAAY,IAAA,CAAK,MAAM,IAAI,CAAA;AAAA,IAC7B;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,CAAO,MAAM,CAAA,GAAY,IAAI,CAAA;AAClD,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,MACAA,QAAAA,KACG;AACH,IAAA,gBAAA,CAAiB,MAAA,EAAQ,IAAA,EAAM,IAAA,EAAMA,QAAO,CAAA;AAE5C,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,SAAS,MAAA,EAAW;AACtB,MAAA,YAAA,CAAa,IAAA,GAAO,IAAA,CAAK,SAAA,CAAU,IAAI,CAAA;AAAA,IACzC;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,SAAS,EAAC;AAEhB,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,IAAA,EAAWA,aAClC,WAAA,CAAY,OAAA,EAAS,IAAA,EAAM,IAAA,EAAMA,QAAO,CAAA;AAAA,IAC1C,IAAA,EAAM,OAAO,IAAA,EAAW,IAAA,EAAWA,aACjC,WAAA,CAAY,MAAA,EAAQ,IAAA,EAAM,IAAA,EAAMA,QAAO,CAAA;AAAA,IACzC,GAAA,EAAK,OAAO,IAAA,EAAW,IAAA,EAAWA,aAChC,WAAA,CAAY,KAAA,EAAO,IAAA,EAAM,IAAA,EAAMA,QAAO,CAAA;AAAA,IACxC,KAAA,EAAO,OAAO,IAAA,EAAW,IAAA,EAAWA,aAClC,WAAA,CAAY,OAAA,EAAS,IAAA,EAAM,IAAA,EAAMA,QAAO,CAAA;AAAA,IAC1C,MAAA,EAAQ,OAAO,IAAA,EAAW,IAAA,EAAWA,aACnC,WAAA,CAAY,QAAA,EAAU,IAAA,EAAM,IAAA,EAAMA,QAAO;AAAA,GAC7C;AAEA,EAAA,KAAA,MAAW,MAAA,IAAU,MAAA,CAAO,IAAA,CAAK,MAAM,CAAA,EAEpC;AACD,IAAA,IAAI,UAAU,cAAA,EAAgB;AAC3B,MAAC,MAAA,CAAe,MAAM,CAAA,GAAI,cAAA,CAAe,MAAM,CAAA;AAAA,IAClD;AAAA,EACF;AAEA,EAAA,OAAO,MAAA;AACT;AC9JA,IAAM,kBAAA,GAAqB,CAKzB,MAAA,EACA,MAAA,EACA,UAIA,KAAA,KACG;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,GAAA,GAAO,QAAA,CAAS,GAAA,GAAM,GAAG,KAAK,EAAC;AACrC,MAAA,MAAM,WAAA,GAAe,MAAA,CAAO,MAAM,CAAA,CAAU,KAAK,CAAA;AAEjD,MAAA,MAAM,IAAA,GAAO;AAAA,QACX,QAAQ,GAAA,CAAI,MAAA;AAAA,QACZ,GAAI,WAAA,EAAa,IAAA,IAAQ,EAAE,IAAA,EAAM,YAAY,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,IAAI,CAAA,EAAE;AAAA,QAClE,GAAI,aAAa,WAAA,IAAe;AAAA,UAC9B,WAAA,EAAa,WAAA,CAAY,WAAA,CAAY,KAAA,CAAM,IAAI,KAAK;AAAA;AACtD,OACF;AAEA,MAAA,MAAM,MAAA,GAAS,MAAM,QAAA,CAAS,MAAM,EAAE,KAAK,CAAA,GAAI,MAAa,GAAG,CAAA;AAE/D,MAAA,GAAA,CAAI,IAAA;AAAA,QACF,SAAS,UAAA,GAAa,WAAA,EAAa,QAAA,CAAS,KAAA,CAAM,MAAM,CAAA,GAAI;AAAA,OAC9D;AAAA,IACF,SAAS,GAAA,EAAK;AACZ,MAAA,IAAA,CAAK,GAAG,CAAA;AAAA,IACV;AAAA,EACF,CAAA;AACF,CAAA;AAEO,IAAM,qBAAA,GAAwB,CAInC,MAAA,EACA,MAAA,EACA,QAAA,KAKG;AACH,EAAA,MAAM,EAAE,gBAAe,GAAI,QAAA;AAE3B,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,OAAO,SAAS,CAAA;AAErC,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,CAAmB,SAAA,EAAW,MAAA,EAAQ,QAAA,EAAU,KAAK;AAAA,OACvD;AAAA,MACF;AAAA,KACF;AAAA,EACF;AAEA,EAAA,IAAI,cAAA,EAAgB;AAClB,IAAA,MAAA,GAAS,MAAA,CAAO,GAAA;AAAA,MAAI,WAAA;AAAA,MAAa,OAAO,CAAA,EAAG,GAAA,KACzC,GAAA,CACG,WAAA,CAAY,YAAY,CAAA,CACxB,IAAA,CAAK,MAAMC,iBAAA,CAAS,cAAA,EAAiB,MAAM,CAAC;AAAA,KACjD;AAAA,EACF;AAEA,EAAA,OAAO,MAAA;AACT;;;ACrGO,IAAM,YAAA,GAAe,CAC1B,MAAA,KACM","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 = true,\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 { readFile } from \"node:fs/promises\"\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  handlers: RouteHandlers<T, TContext> & {\n    ctx?: (req: Request) => TContext\n    validation?: boolean\n  },\n  route: string\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 = (handlers.ctx?.(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(\n        handlers.validation ? routeConfig?.response.parse(result) : result\n      )\n    } catch (err) {\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  handlers: RouteHandlers<T, TContext> & {\n    ctx?: (req: Request) => TContext\n    schemaFilePath?: string\n    validation?: boolean\n  }\n) => {\n  const { schemaFilePath } = handlers\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(methodKey, routes, handlers, route)\n        ),\n      router\n    )\n  }\n\n  if (schemaFilePath) {\n    router = router.get(\"/__schema\", async (_, res) =>\n      res\n        .contentType(\"text/plain\")\n        .send(await readFile(schemaFilePath!, \"utf8\"))\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/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 = true,\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  handlers: RouteHandlers<T, TContext> & {\n    ctx?: (req: Request) => TContext\n  },\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 = (handlers.ctx?.(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) {\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  handlers: RouteHandlers<T, TContext> & {\n    ctx?: (req: Request) => TContext\n    schemaFile?: string\n    validation?: boolean\n  }\n) => {\n  const { schemaFile, validation = true } = handlers\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(methodKey, routes, handlers, route, validation)\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"]}

package/dist/index.mjs

@@ -1,5 +1,3 @@
-import { readFile } from 'fs/promises';
-
 // src/client.ts
 var replacePathParams = (path, params) => {
   const paramNames = /* @__PURE__ */ new Set();
@@ -89,7 +87,9 @@ var createClient = (routes, options) => {
   }
   return client;
 };
-var createRouteHandler = (method, routes, handlers, route) => {
+
+// src/server.ts
+var createRouteHandler = (method, routes, handlers, route, validation) => {
   return async (req, res, next) => {
     try {
       if (method === "QUERY" && req.method !== "QUERY") {
@@ -106,16 +106,14 @@ var createRouteHandler = (method, routes, handlers, route) => {
         }
       };
       const result = await handlers[method][route]?.(data, ctx);
-      res.json(
-        handlers.validation ? routeConfig?.response.parse(result) : result
-      );
+      res.json(validation ? routeConfig?.response.parse(result) : result);
     } catch (err) {
       next(err);
     }
   };
 };
 var registerExpressRoutes = (router, routes, handlers) => {
-  const { schemaFilePath } = handlers;
+  const { schemaFile, validation = true } = handlers;
   const expressMethodMap = {
     GET: "get",
     POST: "post",
@@ -131,15 +129,15 @@ var registerExpressRoutes = (router, routes, handlers) => {
     router = Object.keys(methodRoutes).reduce(
       (r, route) => r[routerMethod](
         route,
-        createRouteHandler(methodKey, routes, handlers, route)
+        createRouteHandler(methodKey, routes, handlers, route, validation)
       ),
       router
     );
   }
-  if (schemaFilePath) {
+  if (schemaFile) {
     router = router.get(
-      "/__schema",
-      async (_, res) => res.contentType("text/plain").send(await readFile(schemaFilePath, "utf8"))
+      "/__routes",
+      async (_, res) => res.contentType("text/plain").send(schemaFile)
     );
   }
   return router;

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 = true,\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 { readFile } from \"node:fs/promises\"\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  handlers: RouteHandlers<T, TContext> & {\n    ctx?: (req: Request) => TContext\n    validation?: boolean\n  },\n  route: string\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 = (handlers.ctx?.(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(\n        handlers.validation ? routeConfig?.response.parse(result) : result\n      )\n    } catch (err) {\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  handlers: RouteHandlers<T, TContext> & {\n    ctx?: (req: Request) => TContext\n    schemaFilePath?: string\n    validation?: boolean\n  }\n) => {\n  const { schemaFilePath } = handlers\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(methodKey, routes, handlers, route)\n        ),\n      router\n    )\n  }\n\n  if (schemaFilePath) {\n    router = router.get(\"/__schema\", async (_, res) =>\n      res\n        .contentType(\"text/plain\")\n        .send(await readFile(schemaFilePath!, \"utf8\"))\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/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 = true,\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  handlers: RouteHandlers<T, TContext> & {\n    ctx?: (req: Request) => TContext\n  },\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 = (handlers.ctx?.(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) {\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  handlers: RouteHandlers<T, TContext> & {\n    ctx?: (req: Request) => TContext\n    schemaFile?: string\n    validation?: boolean\n  }\n) => {\n  const { schemaFile, validation = true } = handlers\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(methodKey, routes, handlers, route, validation)\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"]}

package/package.json

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