@jokio/rpc 0.3.1 → 0.4.0

package/README.md

@@ -2,6 +2,9 @@
 
 A type-safe RPC framework for TypeScript with Zod validation, designed for Express servers and HTTP clients.
 
+<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" />
+
+
 ## Features
 
 - Full TypeScript type safety from server to client
@@ -20,13 +23,13 @@ npm install @jokio/rpc
 
 ## Usage
 
-### 1. Define Your Router Configuration
+### 1. Define Your Routes
 
 ```typescript
-import { defineRouterConfig } from "@jokio/rpc"
+import { defineRoutes } from "@jokio/rpc"
 import { z } from "zod"
 
-const routerConfig = defineRouterConfig({
+const routes = defineRoutes({
   GET: {
     "/users/:id": {
       query: z.object({
@@ -62,14 +65,14 @@ const routerConfig = defineRouterConfig({
 
 ```typescript
 import express from "express"
-import { applyConfigToExpressRouter } from "@jokio/rpc"
+import { createExpressRouter } from "@jokio/rpc"
 
 const app = express()
 app.use(express.json())
 
 const router = express.Router()
 
-applyConfigToExpressRouter(router, routerConfig, {
+createExpressRouter(router, routes, {
   // Optional: Define a context factory function
   ctx: (req) => ({
     userId: req.headers["x-user-id"] as string,
@@ -108,9 +111,9 @@ app.listen(3000)
 ```typescript
 import { createClient } from "@jokio/rpc"
 
-const client = createClient(routerConfig, {
+const client = createClient(routes, {
   baseUrl: "http://localhost:3000/api",
-  validateRequest: true, // Optional: validate requests on client-side
+  validate: true, // Optional: validate requests on client-side
 })
 
 // Fully typed API calls
@@ -127,33 +130,38 @@ const newUser = await client.POST(
 
 ## API Reference
 
-### `defineRouterConfig(config)`
+### `defineRoutes(routes)`
 
-Helper function to define a router configuration with type inference.
+Helper function to define routes with type inference.
 
-### `applyConfigToExpressRouter(router, config, handlers)`
+**Parameters:**
+- `routes`: Route definitions object containing GET and POST route configurations
+
+### `createExpressRouter(router, routes, handlers)`
 
 Applies route handlers to an Express router with automatic validation.
 
 **Parameters:**
 
 - `router`: Express Router instance
-- `config`: Router configuration object
+- `routes`: Route definitions object
 - `handlers`: Handler functions for each route with optional context factory
   - `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
 
-### `createClient(config, options)`
+### `createClient(routes, options)`
 
 Creates a type-safe HTTP client.
 
-**Options:**
+**Parameters:**
 
-- `baseUrl`: Base URL for API requests
-- `headers`: Optional default headers
-- `fetch`: Optional custom fetch function (useful for Node.js or testing)
-- `validateRequest`: Enable client-side request validation (default: false)
+- `routes`: Route definitions object (same as used on the server)
+- `options`: Client configuration options
+  - `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)
 
 ## Type Safety
 

package/dist/index.d.mts

@@ -13,7 +13,7 @@ type RouterConfig = {
 type InferRouteConfig<T extends RouteConfig | Omit<RouteConfig, "body">> = {
     [K in keyof T]: T[K] extends z.ZodType ? z.infer<T[K]> : never;
 };
-declare const defineRouterConfig: <T extends RouterConfig>(config: T) => T;
+declare const defineRoutes: <T extends RouterConfig>(routes: T) => T;
 
 type RouterClient<T extends RouterConfig> = {
     GET: <K extends keyof T["GET"]>(path: K, options?: Omit<Omit<InferRouteConfig<T["GET"][K]>, "body">, "result">) => Promise<InferRouteConfig<T["GET"][K]>["result"]>;
@@ -22,18 +22,19 @@ type RouterClient<T extends RouterConfig> = {
 type FetchFunction = (url: string, options: RequestInit) => Promise<Response>;
 type CreateClientOptions = {
     baseUrl: string;
-    headers?: Record<string, string>;
+    getHeaders?: () => Promise<Record<string, string>> | Record<string, string>;
     fetch?: FetchFunction;
-    validateRequest?: boolean;
+    validate?: boolean;
+    debug?: boolean;
 };
-declare const createClient: <T extends RouterConfig>(config: T, options: CreateClientOptions) => RouterClient<T>;
+declare const createClient: <T extends RouterConfig>(routes: T, options: CreateClientOptions) => RouterClient<T>;
 
 type ExtractRouteParams<T extends string> = T extends `${infer _Start}:${infer Param}/${infer Rest}` ? {
     [K in Param | keyof ExtractRouteParams<`/${Rest}`>]: string;
 } : T extends `${infer _Start}:${infer Param}` ? {
     [K in Param]: string;
 } : Record<string, never>;
-type RouterHandlerConfig<T extends RouterConfig, TContext> = {
+type RouteHandlers<T extends RouterConfig, TContext> = {
     GET: {
         [K in keyof T["GET"]]: (data: Omit<Omit<InferRouteConfig<T["GET"][K]>, "body">, "result"> & {
             params: K extends string ? ExtractRouteParams<K> : unknown;
@@ -45,8 +46,9 @@ type RouterHandlerConfig<T extends RouterConfig, TContext> = {
         }, ctx: TContext) => Promise<InferRouteConfig<T["POST"][K]>["result"]> | InferRouteConfig<T["POST"][K]>["result"];
     };
 };
-declare const applyConfigToExpressRouter: <T extends RouterConfig, TContext>(router: Router, config: T, handlers: RouterHandlerConfig<T, TContext> & {
+declare const createExpressRouter: <T extends RouterConfig, TContext>(router: Router, routes: T, handlers: RouteHandlers<T, TContext> & {
     ctx?: (req: Request) => TContext;
+    schemaFilePath?: string;
 }) => Router;
 
-export { type InferRouteConfig, type RouteConfig, type RouterClient, type RouterConfig, type RouterHandlerConfig, applyConfigToExpressRouter, createClient, defineRouterConfig };
+export { type InferRouteConfig, type RouteConfig, type RouteHandlers, type RouterClient, type RouterConfig, createClient, createExpressRouter, defineRoutes };

package/dist/index.d.ts

@@ -13,7 +13,7 @@ type RouterConfig = {
 type InferRouteConfig<T extends RouteConfig | Omit<RouteConfig, "body">> = {
     [K in keyof T]: T[K] extends z.ZodType ? z.infer<T[K]> : never;
 };
-declare const defineRouterConfig: <T extends RouterConfig>(config: T) => T;
+declare const defineRoutes: <T extends RouterConfig>(routes: T) => T;
 
 type RouterClient<T extends RouterConfig> = {
     GET: <K extends keyof T["GET"]>(path: K, options?: Omit<Omit<InferRouteConfig<T["GET"][K]>, "body">, "result">) => Promise<InferRouteConfig<T["GET"][K]>["result"]>;
@@ -22,18 +22,19 @@ type RouterClient<T extends RouterConfig> = {
 type FetchFunction = (url: string, options: RequestInit) => Promise<Response>;
 type CreateClientOptions = {
     baseUrl: string;
-    headers?: Record<string, string>;
+    getHeaders?: () => Promise<Record<string, string>> | Record<string, string>;
     fetch?: FetchFunction;
-    validateRequest?: boolean;
+    validate?: boolean;
+    debug?: boolean;
 };
-declare const createClient: <T extends RouterConfig>(config: T, options: CreateClientOptions) => RouterClient<T>;
+declare const createClient: <T extends RouterConfig>(routes: T, options: CreateClientOptions) => RouterClient<T>;
 
 type ExtractRouteParams<T extends string> = T extends `${infer _Start}:${infer Param}/${infer Rest}` ? {
     [K in Param | keyof ExtractRouteParams<`/${Rest}`>]: string;
 } : T extends `${infer _Start}:${infer Param}` ? {
     [K in Param]: string;
 } : Record<string, never>;
-type RouterHandlerConfig<T extends RouterConfig, TContext> = {
+type RouteHandlers<T extends RouterConfig, TContext> = {
     GET: {
         [K in keyof T["GET"]]: (data: Omit<Omit<InferRouteConfig<T["GET"][K]>, "body">, "result"> & {
             params: K extends string ? ExtractRouteParams<K> : unknown;
@@ -45,8 +46,9 @@ type RouterHandlerConfig<T extends RouterConfig, TContext> = {
         }, ctx: TContext) => Promise<InferRouteConfig<T["POST"][K]>["result"]> | InferRouteConfig<T["POST"][K]>["result"];
     };
 };
-declare const applyConfigToExpressRouter: <T extends RouterConfig, TContext>(router: Router, config: T, handlers: RouterHandlerConfig<T, TContext> & {
+declare const createExpressRouter: <T extends RouterConfig, TContext>(router: Router, routes: T, handlers: RouteHandlers<T, TContext> & {
     ctx?: (req: Request) => TContext;
+    schemaFilePath?: string;
 }) => Router;
 
-export { type InferRouteConfig, type RouteConfig, type RouterClient, type RouterConfig, type RouterHandlerConfig, applyConfigToExpressRouter, createClient, defineRouterConfig };
+export { type InferRouteConfig, type RouteConfig, type RouteHandlers, type RouterClient, type RouterConfig, createClient, createExpressRouter, defineRoutes };

package/dist/index.js

@@ -1,78 +1,82 @@
 'use strict';
 
+var promises = require('fs/promises');
+
 // src/client.ts
-var createClient = (config, options) => {
+var createClient = (routes, options) => {
   const {
     baseUrl,
-    headers = {},
+    getHeaders = () => Promise.resolve({}),
     fetch: customFetch = fetch,
-    validateRequest = false
+    validate = false
   } = options;
   const client = {
     GET: {},
     POST: {}
   };
-  client.GET = async (path, data) => {
-    if (validateRequest && data?.query) {
-      config.GET[path]?.query?.parse(data.query);
+  client.GET = async (path, options2) => {
+    if (validate && options2?.query) {
+      routes.GET[path]?.query?.parse(options2.query);
     }
-    const queryString = data?.query ? "?" + new URLSearchParams(data.query).toString() : "";
+    const queryString = options2?.query ? "?" + new URLSearchParams(options2.query).toString() : "";
     const response = await customFetch(`${baseUrl}${path}${queryString}`, {
       method: "GET",
       headers: {
         "Content-Type": "application/json",
-        ...headers
+        ...await getHeaders()
       }
     });
     if (!response.ok) {
       const error = await response.json();
-      console.error(error);
+      if (options2.debug) {
+        console.debug(error);
+      }
       throw new Error(error.message);
     }
     const json = await response.json();
-    return config.GET[path]?.result.parse(json);
+    return routes.GET[path]?.result.parse(json);
   };
-  client.POST = async (path, body, rest) => {
-    if (validateRequest) {
+  client.POST = async (path, body, options2) => {
+    if (validate) {
       if (body) {
-        config.POST[path]?.body?.parse(body);
+        routes.POST[path]?.body?.parse(body);
       }
-      if (rest?.query) {
-        config.POST[path]?.query?.parse(rest.query);
+      if (options2?.query) {
+        routes.POST[path]?.query?.parse(options2.query);
       }
     }
-    const queryString = rest?.query ? "?" + new URLSearchParams(rest.query).toString() : "";
+    const queryString = options2?.query ? "?" + new URLSearchParams(options2.query).toString() : "";
     const response = await customFetch(`${baseUrl}${path}${queryString}`, {
       method: "POST",
       headers: {
         "Content-Type": "application/json",
-        ...headers
+        ...await getHeaders()
       },
       body: JSON.stringify(body)
     });
     if (!response.ok) {
       const error = await response.json();
-      console.error(error);
+      if (options2.debug) {
+        console.debug(error);
+      }
       throw new Error(error.message);
     }
     const json = await response.json();
-    return config.POST[path]?.result.parse(json);
+    return routes.POST[path]?.result.parse(json);
   };
   return client;
 };
-
-// src/server.ts
-var applyConfigToExpressRouter = (router, config, handlers) => {
-  router = Object.keys(config.GET).reduce(
+var createExpressRouter = (router, routes, handlers) => {
+  router = Object.keys(routes.GET).reduce(
     (r, x) => r.get(x, async (req, res, next) => {
       try {
         const ctx = handlers.ctx?.(req) ?? {};
         const data = {
           params: req.params,
-          query: config.GET[x]?.query?.parse(req.query)
+          query: routes.GET[x]?.query?.parse(req.query)
         };
         const result = await handlers.GET[x]?.(data, ctx);
-        const validatedResult = config.GET[x]?.result.parse(result);
+        const validatedResult = routes.GET[x]?.result.parse(result);
         res.json(validatedResult);
       } catch (err) {
         next(err);
@@ -80,17 +84,23 @@ var applyConfigToExpressRouter = (router, config, handlers) => {
     }),
     router
   );
-  router = Object.keys(config.POST).reduce(
+  if (handlers.schemaFilePath) {
+    router = router.get(
+      "/__schema",
+      async (_, res) => res.contentType("text/plain").send(await promises.readFile(handlers.schemaFilePath, "utf8"))
+    );
+  }
+  router = Object.keys(routes.POST).reduce(
     (r, x) => r.post(x, async (req, res, next) => {
       try {
         const ctx = handlers.ctx?.(req) ?? {};
         const data = {
           params: req.params,
-          body: config.POST[x]?.body.parse(req.body),
-          query: config.POST[x]?.query?.parse(req.query)
+          body: routes.POST[x]?.body.parse(req.body),
+          query: routes.POST[x]?.query?.parse(req.query)
         };
         const result = await handlers.POST[x]?.(data, ctx);
-        const validatedResult = config.POST[x]?.result.parse(result);
+        const validatedResult = routes.POST[x]?.result.parse(result);
         res.json(validatedResult);
       } catch (err) {
         next(err);
@@ -102,10 +112,10 @@ var applyConfigToExpressRouter = (router, config, handlers) => {
 };
 
 // src/types.ts
-var defineRouterConfig = (config) => config;
+var defineRoutes = (routes) => routes;
 
-exports.applyConfigToExpressRouter = applyConfigToExpressRouter;
 exports.createClient = createClient;
-exports.defineRouterConfig = defineRouterConfig;
+exports.createExpressRouter = createExpressRouter;
+exports.defineRoutes = defineRoutes;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts","../src/server.ts","../src/types.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { InferRouteConfig, RouterConfig } from \"./types\"\n\nexport type RouterClient<T extends RouterConfig> = {\n  GET: <K extends keyof T[\"GET\"]>(\n    path: K,\n    options?: Omit<Omit<InferRouteConfig<T[\"GET\"][K]>, \"body\">, \"result\">\n  ) => Promise<InferRouteConfig<T[\"GET\"][K]>[\"result\"]>\n  POST: <K extends keyof T[\"POST\"]>(\n    path: K,\n    body: InferRouteConfig<T[\"POST\"][K]>[\"body\"],\n    options?: Omit<InferRouteConfig<T[\"POST\"][K]>, \"body\" | \"result\">\n  ) => Promise<InferRouteConfig<T[\"POST\"][K]>[\"result\"]>\n}\n\ntype FetchFunction = (url: string, options: RequestInit) => Promise<Response>\n\ntype CreateClientOptions = {\n  baseUrl: string\n  headers?: Record<string, string>\n  fetch?: FetchFunction\n  validateRequest?: boolean\n}\n\nexport const createClient = <T extends RouterConfig>(\n  config: T,\n  options: CreateClientOptions\n): RouterClient<T> => {\n  const {\n    baseUrl,\n    headers = {},\n    fetch: customFetch = fetch,\n    validateRequest = false,\n  } = options\n\n  const client = {\n    GET: {} as any,\n    POST: {} as any,\n  }\n\n  client.GET = async (path: string, data?: any) => {\n    if (validateRequest && data?.query) {\n      config.GET[path]?.query?.parse(data.query)\n    }\n    const queryString = data?.query\n      ? \"?\" + new URLSearchParams(data.query).toString()\n      : \"\"\n    const response = await customFetch(`${baseUrl}${path}${queryString}`, {\n      method: \"GET\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        ...headers,\n      },\n    })\n\n    if (!response.ok) {\n      const error: any = await response.json()\n      console.error(error)\n      throw new Error(error.message)\n    }\n\n    const json = await response.json()\n\n    return config.GET[path]?.result.parse(json)\n  }\n\n  client.POST = async (path: string, body: any, rest?: any) => {\n    if (validateRequest) {\n      if (body) {\n        config.POST[path]?.body?.parse(body)\n      }\n      if (rest?.query) {\n        config.POST[path]?.query?.parse(rest.query)\n      }\n    }\n    const queryString = rest?.query\n      ? \"?\" + new URLSearchParams(rest.query).toString()\n      : \"\"\n    const response = await customFetch(`${baseUrl}${path}${queryString}`, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        ...headers,\n      },\n      body: JSON.stringify(body),\n    })\n\n    if (!response.ok) {\n      const error: any = await response.json()\n      console.error(error)\n      throw new Error(error.message)\n    }\n\n    const json = await response.json()\n\n    return config.POST[path]?.result.parse(json)\n  }\n\n  return client\n}\n","import type { Request, Router } from \"express\"\nimport type { InferRouteConfig, RouterConfig } from \"./types\"\n\n// Extract path parameters from route string\n// e.g., \"/user/:id\" -> { id: string }, \"/user/:id/post/:postId\" -> { id: string, postId: string }\ntype ExtractRouteParams<T extends string> =\n  T extends `${infer _Start}:${infer Param}/${infer Rest}`\n    ? { [K in Param | keyof ExtractRouteParams<`/${Rest}`>]: string }\n    : T extends `${infer _Start}:${infer Param}`\n    ? { [K in Param]: string }\n    : Record<string, never>\n\nexport type RouterHandlerConfig<T extends RouterConfig, TContext> = {\n  GET: {\n    [K in keyof T[\"GET\"]]: (\n      data: Omit<Omit<InferRouteConfig<T[\"GET\"][K]>, \"body\">, \"result\"> & {\n        params: K extends string ? ExtractRouteParams<K> : unknown\n      },\n      ctx: TContext\n    ) =>\n      | Promise<InferRouteConfig<T[\"GET\"][K]>[\"result\"]>\n      | InferRouteConfig<T[\"GET\"][K]>[\"result\"]\n  }\n  POST: {\n    [K in keyof T[\"POST\"]]: (\n      data: Omit<InferRouteConfig<T[\"POST\"][K]>, \"result\"> & {\n        params: K extends string ? ExtractRouteParams<K> : unknown\n      },\n      ctx: TContext\n    ) =>\n      | Promise<InferRouteConfig<T[\"POST\"][K]>[\"result\"]>\n      | InferRouteConfig<T[\"POST\"][K]>[\"result\"]\n  }\n}\n\nexport const applyConfigToExpressRouter = <T extends RouterConfig, TContext>(\n  router: Router,\n  config: T,\n  handlers: RouterHandlerConfig<T, TContext> & {\n    ctx?: (req: Request) => TContext\n  }\n) => {\n  router = Object.keys(config.GET).reduce(\n    (r, x) =>\n      r.get(x, async (req, res, next) => {\n        try {\n          const ctx = (handlers.ctx?.(req) ?? {}) as TContext\n\n          const data = {\n            params: req.params,\n            query: config.GET[x]?.query?.parse(req.query),\n          }\n          const result = await handlers.GET[x]?.(data as any, ctx)\n          const validatedResult = config.GET[x]?.result.parse(result)\n          res.json(validatedResult)\n        } catch (err) {\n          next(err)\n        }\n      }),\n    router\n  )\n\n  router = Object.keys(config.POST).reduce(\n    (r, x) =>\n      r.post(x, async (req, res, next) => {\n        try {\n          const ctx = (handlers.ctx?.(req) ?? {}) as TContext\n\n          const data = {\n            params: req.params,\n            body: config.POST[x]?.body.parse(req.body),\n            query: config.POST[x]?.query?.parse(req.query),\n          }\n          const result = await handlers.POST[x]?.(data as any, ctx)\n          const validatedResult = config.POST[x]?.result.parse(result)\n          res.json(validatedResult)\n        } catch (err) {\n          next(err)\n        }\n      }),\n    router\n  )\n\n  return router\n}\n","import type z from \"zod\";\n\nexport type RouteConfig = {\n  body: z.ZodType;\n  query?: z.ZodType;\n  result: z.ZodType;\n};\n\nexport type RouterConfig = {\n  GET: Record<string, Omit<RouteConfig, \"body\">>;\n  POST: Record<string, RouteConfig>;\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 defineRouterConfig = <T extends RouterConfig>(config: T): T =>\n  config;\n"]}
+{"version":3,"sources":["../src/client.ts","../src/server.ts","../src/types.ts"],"names":["options","readFile"],"mappings":"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","file":"index.js","sourcesContent":["import type { InferRouteConfig, RouterConfig } from \"./types\"\n\nexport type RouterClient<T extends RouterConfig> = {\n  GET: <K extends keyof T[\"GET\"]>(\n    path: K,\n    options?: Omit<Omit<InferRouteConfig<T[\"GET\"][K]>, \"body\">, \"result\">\n  ) => Promise<InferRouteConfig<T[\"GET\"][K]>[\"result\"]>\n  POST: <K extends keyof T[\"POST\"]>(\n    path: K,\n    body: InferRouteConfig<T[\"POST\"][K]>[\"body\"],\n    options?: Omit<InferRouteConfig<T[\"POST\"][K]>, \"body\" | \"result\">\n  ) => Promise<InferRouteConfig<T[\"POST\"][K]>[\"result\"]>\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\nexport const createClient = <T extends 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 client = {\n    GET: {} as any,\n    POST: {} as any,\n  }\n\n  client.GET = async (path: string, options?: any) => {\n    if (validate && options?.query) {\n      routes.GET[path]?.query?.parse(options.query)\n    }\n\n    const queryString = options?.query\n      ? \"?\" + new URLSearchParams(options.query).toString()\n      : \"\"\n\n    const response = await customFetch(`${baseUrl}${path}${queryString}`, {\n      method: \"GET\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        ...(await getHeaders()),\n      },\n    })\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 json = await response.json()\n\n    return routes.GET[path]?.result.parse(json)\n  }\n\n  client.POST = async (path: string, body: any, options?: any) => {\n    if (validate) {\n      if (body) {\n        routes.POST[path]?.body?.parse(body)\n      }\n      if (options?.query) {\n        routes.POST[path]?.query?.parse(options.query)\n      }\n    }\n\n    const queryString = options?.query\n      ? \"?\" + new URLSearchParams(options.query).toString()\n      : \"\"\n\n    const response = await customFetch(`${baseUrl}${path}${queryString}`, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        ...(await getHeaders()),\n      },\n      body: JSON.stringify(body),\n    })\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 json = await response.json()\n\n    return routes.POST[path]?.result.parse(json)\n  }\n\n  return client\n}\n","import type { Request, Router } from \"express\"\nimport { readFile } from \"node:fs/promises\"\nimport type { InferRouteConfig, RouterConfig } from \"./types\"\n\n// Extract path parameters from route string\n// e.g., \"/user/:id\" -> { id: string }, \"/user/:id/post/:postId\" -> { id: string, postId: string }\ntype ExtractRouteParams<T extends string> =\n  T extends `${infer _Start}:${infer Param}/${infer Rest}`\n    ? { [K in Param | keyof ExtractRouteParams<`/${Rest}`>]: string }\n    : T extends `${infer _Start}:${infer Param}`\n    ? { [K in Param]: string }\n    : Record<string, never>\n\nexport type RouteHandlers<T extends RouterConfig, TContext> = {\n  GET: {\n    [K in keyof T[\"GET\"]]: (\n      data: Omit<Omit<InferRouteConfig<T[\"GET\"][K]>, \"body\">, \"result\"> & {\n        params: K extends string ? ExtractRouteParams<K> : unknown\n      },\n      ctx: TContext\n    ) =>\n      | Promise<InferRouteConfig<T[\"GET\"][K]>[\"result\"]>\n      | InferRouteConfig<T[\"GET\"][K]>[\"result\"]\n  }\n  POST: {\n    [K in keyof T[\"POST\"]]: (\n      data: Omit<InferRouteConfig<T[\"POST\"][K]>, \"result\"> & {\n        params: K extends string ? ExtractRouteParams<K> : unknown\n      },\n      ctx: TContext\n    ) =>\n      | Promise<InferRouteConfig<T[\"POST\"][K]>[\"result\"]>\n      | InferRouteConfig<T[\"POST\"][K]>[\"result\"]\n  }\n}\n\nexport const createExpressRouter = <T extends RouterConfig, TContext>(\n  router: Router,\n  routes: T,\n  handlers: RouteHandlers<T, TContext> & {\n    ctx?: (req: Request) => TContext\n    schemaFilePath?: string\n  }\n) => {\n  router = Object.keys(routes.GET).reduce(\n    (r, x) =>\n      r.get(x, async (req, res, next) => {\n        try {\n          const ctx = (handlers.ctx?.(req) ?? {}) as TContext\n\n          const data = {\n            params: req.params,\n            query: routes.GET[x]?.query?.parse(req.query),\n          }\n          const result = await handlers.GET[x]?.(data as any, ctx)\n          const validatedResult = routes.GET[x]?.result.parse(result)\n\n          res.json(validatedResult)\n        } catch (err) {\n          next(err)\n        }\n      }),\n    router\n  )\n\n  if (handlers.schemaFilePath) {\n    router = router.get(\"/__schema\", async (_, res) =>\n      res\n        .contentType(\"text/plain\")\n        .send(await readFile(handlers.schemaFilePath!, \"utf8\"))\n    )\n  }\n\n  router = Object.keys(routes.POST).reduce(\n    (r, x) =>\n      r.post(x, async (req, res, next) => {\n        try {\n          const ctx = (handlers.ctx?.(req) ?? {}) as TContext\n\n          const data = {\n            params: req.params,\n            body: routes.POST[x]?.body.parse(req.body),\n            query: routes.POST[x]?.query?.parse(req.query),\n          }\n          const result = await handlers.POST[x]?.(data as any, ctx)\n          const validatedResult = routes.POST[x]?.result.parse(result)\n          res.json(validatedResult)\n        } catch (err) {\n          next(err)\n        }\n      }),\n    router\n  )\n\n  return router\n}\n","import type z from \"zod\"\n\nexport type RouteConfig = {\n  body: z.ZodType\n  query?: z.ZodType\n  result: z.ZodType\n}\n\nexport type RouterConfig = {\n  GET: Record<string, Omit<RouteConfig, \"body\">>\n  POST: Record<string, RouteConfig>\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 RouterConfig>(routes: T): T =>\n  routes\n"]}

package/dist/index.mjs

@@ -1,76 +1,80 @@
+import { readFile } from 'fs/promises';
+
 // src/client.ts
-var createClient = (config, options) => {
+var createClient = (routes, options) => {
   const {
     baseUrl,
-    headers = {},
+    getHeaders = () => Promise.resolve({}),
     fetch: customFetch = fetch,
-    validateRequest = false
+    validate = false
   } = options;
   const client = {
     GET: {},
     POST: {}
   };
-  client.GET = async (path, data) => {
-    if (validateRequest && data?.query) {
-      config.GET[path]?.query?.parse(data.query);
+  client.GET = async (path, options2) => {
+    if (validate && options2?.query) {
+      routes.GET[path]?.query?.parse(options2.query);
     }
-    const queryString = data?.query ? "?" + new URLSearchParams(data.query).toString() : "";
+    const queryString = options2?.query ? "?" + new URLSearchParams(options2.query).toString() : "";
     const response = await customFetch(`${baseUrl}${path}${queryString}`, {
       method: "GET",
       headers: {
         "Content-Type": "application/json",
-        ...headers
+        ...await getHeaders()
       }
     });
     if (!response.ok) {
       const error = await response.json();
-      console.error(error);
+      if (options2.debug) {
+        console.debug(error);
+      }
       throw new Error(error.message);
     }
     const json = await response.json();
-    return config.GET[path]?.result.parse(json);
+    return routes.GET[path]?.result.parse(json);
   };
-  client.POST = async (path, body, rest) => {
-    if (validateRequest) {
+  client.POST = async (path, body, options2) => {
+    if (validate) {
       if (body) {
-        config.POST[path]?.body?.parse(body);
+        routes.POST[path]?.body?.parse(body);
       }
-      if (rest?.query) {
-        config.POST[path]?.query?.parse(rest.query);
+      if (options2?.query) {
+        routes.POST[path]?.query?.parse(options2.query);
       }
     }
-    const queryString = rest?.query ? "?" + new URLSearchParams(rest.query).toString() : "";
+    const queryString = options2?.query ? "?" + new URLSearchParams(options2.query).toString() : "";
     const response = await customFetch(`${baseUrl}${path}${queryString}`, {
       method: "POST",
       headers: {
         "Content-Type": "application/json",
-        ...headers
+        ...await getHeaders()
       },
       body: JSON.stringify(body)
     });
     if (!response.ok) {
       const error = await response.json();
-      console.error(error);
+      if (options2.debug) {
+        console.debug(error);
+      }
       throw new Error(error.message);
     }
     const json = await response.json();
-    return config.POST[path]?.result.parse(json);
+    return routes.POST[path]?.result.parse(json);
   };
   return client;
 };
-
-// src/server.ts
-var applyConfigToExpressRouter = (router, config, handlers) => {
-  router = Object.keys(config.GET).reduce(
+var createExpressRouter = (router, routes, handlers) => {
+  router = Object.keys(routes.GET).reduce(
     (r, x) => r.get(x, async (req, res, next) => {
       try {
         const ctx = handlers.ctx?.(req) ?? {};
         const data = {
           params: req.params,
-          query: config.GET[x]?.query?.parse(req.query)
+          query: routes.GET[x]?.query?.parse(req.query)
         };
         const result = await handlers.GET[x]?.(data, ctx);
-        const validatedResult = config.GET[x]?.result.parse(result);
+        const validatedResult = routes.GET[x]?.result.parse(result);
         res.json(validatedResult);
       } catch (err) {
         next(err);
@@ -78,17 +82,23 @@ var applyConfigToExpressRouter = (router, config, handlers) => {
     }),
     router
   );
-  router = Object.keys(config.POST).reduce(
+  if (handlers.schemaFilePath) {
+    router = router.get(
+      "/__schema",
+      async (_, res) => res.contentType("text/plain").send(await readFile(handlers.schemaFilePath, "utf8"))
+    );
+  }
+  router = Object.keys(routes.POST).reduce(
     (r, x) => r.post(x, async (req, res, next) => {
       try {
         const ctx = handlers.ctx?.(req) ?? {};
         const data = {
           params: req.params,
-          body: config.POST[x]?.body.parse(req.body),
-          query: config.POST[x]?.query?.parse(req.query)
+          body: routes.POST[x]?.body.parse(req.body),
+          query: routes.POST[x]?.query?.parse(req.query)
         };
         const result = await handlers.POST[x]?.(data, ctx);
-        const validatedResult = config.POST[x]?.result.parse(result);
+        const validatedResult = routes.POST[x]?.result.parse(result);
         res.json(validatedResult);
       } catch (err) {
         next(err);
@@ -100,8 +110,8 @@ var applyConfigToExpressRouter = (router, config, handlers) => {
 };
 
 // src/types.ts
-var defineRouterConfig = (config) => config;
+var defineRoutes = (routes) => routes;
 
-export { applyConfigToExpressRouter, createClient, defineRouterConfig };
+export { createClient, createExpressRouter, defineRoutes };
 //# 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":[],"mappings":"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","file":"index.mjs","sourcesContent":["import type { InferRouteConfig, RouterConfig } from \"./types\"\n\nexport type RouterClient<T extends RouterConfig> = {\n  GET: <K extends keyof T[\"GET\"]>(\n    path: K,\n    options?: Omit<Omit<InferRouteConfig<T[\"GET\"][K]>, \"body\">, \"result\">\n  ) => Promise<InferRouteConfig<T[\"GET\"][K]>[\"result\"]>\n  POST: <K extends keyof T[\"POST\"]>(\n    path: K,\n    body: InferRouteConfig<T[\"POST\"][K]>[\"body\"],\n    options?: Omit<InferRouteConfig<T[\"POST\"][K]>, \"body\" | \"result\">\n  ) => Promise<InferRouteConfig<T[\"POST\"][K]>[\"result\"]>\n}\n\ntype FetchFunction = (url: string, options: RequestInit) => Promise<Response>\n\ntype CreateClientOptions = {\n  baseUrl: string\n  headers?: Record<string, string>\n  fetch?: FetchFunction\n  validateRequest?: boolean\n}\n\nexport const createClient = <T extends RouterConfig>(\n  config: T,\n  options: CreateClientOptions\n): RouterClient<T> => {\n  const {\n    baseUrl,\n    headers = {},\n    fetch: customFetch = fetch,\n    validateRequest = false,\n  } = options\n\n  const client = {\n    GET: {} as any,\n    POST: {} as any,\n  }\n\n  client.GET = async (path: string, data?: any) => {\n    if (validateRequest && data?.query) {\n      config.GET[path]?.query?.parse(data.query)\n    }\n    const queryString = data?.query\n      ? \"?\" + new URLSearchParams(data.query).toString()\n      : \"\"\n    const response = await customFetch(`${baseUrl}${path}${queryString}`, {\n      method: \"GET\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        ...headers,\n      },\n    })\n\n    if (!response.ok) {\n      const error: any = await response.json()\n      console.error(error)\n      throw new Error(error.message)\n    }\n\n    const json = await response.json()\n\n    return config.GET[path]?.result.parse(json)\n  }\n\n  client.POST = async (path: string, body: any, rest?: any) => {\n    if (validateRequest) {\n      if (body) {\n        config.POST[path]?.body?.parse(body)\n      }\n      if (rest?.query) {\n        config.POST[path]?.query?.parse(rest.query)\n      }\n    }\n    const queryString = rest?.query\n      ? \"?\" + new URLSearchParams(rest.query).toString()\n      : \"\"\n    const response = await customFetch(`${baseUrl}${path}${queryString}`, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        ...headers,\n      },\n      body: JSON.stringify(body),\n    })\n\n    if (!response.ok) {\n      const error: any = await response.json()\n      console.error(error)\n      throw new Error(error.message)\n    }\n\n    const json = await response.json()\n\n    return config.POST[path]?.result.parse(json)\n  }\n\n  return client\n}\n","import type { Request, Router } from \"express\"\nimport type { InferRouteConfig, RouterConfig } from \"./types\"\n\n// Extract path parameters from route string\n// e.g., \"/user/:id\" -> { id: string }, \"/user/:id/post/:postId\" -> { id: string, postId: string }\ntype ExtractRouteParams<T extends string> =\n  T extends `${infer _Start}:${infer Param}/${infer Rest}`\n    ? { [K in Param | keyof ExtractRouteParams<`/${Rest}`>]: string }\n    : T extends `${infer _Start}:${infer Param}`\n    ? { [K in Param]: string }\n    : Record<string, never>\n\nexport type RouterHandlerConfig<T extends RouterConfig, TContext> = {\n  GET: {\n    [K in keyof T[\"GET\"]]: (\n      data: Omit<Omit<InferRouteConfig<T[\"GET\"][K]>, \"body\">, \"result\"> & {\n        params: K extends string ? ExtractRouteParams<K> : unknown\n      },\n      ctx: TContext\n    ) =>\n      | Promise<InferRouteConfig<T[\"GET\"][K]>[\"result\"]>\n      | InferRouteConfig<T[\"GET\"][K]>[\"result\"]\n  }\n  POST: {\n    [K in keyof T[\"POST\"]]: (\n      data: Omit<InferRouteConfig<T[\"POST\"][K]>, \"result\"> & {\n        params: K extends string ? ExtractRouteParams<K> : unknown\n      },\n      ctx: TContext\n    ) =>\n      | Promise<InferRouteConfig<T[\"POST\"][K]>[\"result\"]>\n      | InferRouteConfig<T[\"POST\"][K]>[\"result\"]\n  }\n}\n\nexport const applyConfigToExpressRouter = <T extends RouterConfig, TContext>(\n  router: Router,\n  config: T,\n  handlers: RouterHandlerConfig<T, TContext> & {\n    ctx?: (req: Request) => TContext\n  }\n) => {\n  router = Object.keys(config.GET).reduce(\n    (r, x) =>\n      r.get(x, async (req, res, next) => {\n        try {\n          const ctx = (handlers.ctx?.(req) ?? {}) as TContext\n\n          const data = {\n            params: req.params,\n            query: config.GET[x]?.query?.parse(req.query),\n          }\n          const result = await handlers.GET[x]?.(data as any, ctx)\n          const validatedResult = config.GET[x]?.result.parse(result)\n          res.json(validatedResult)\n        } catch (err) {\n          next(err)\n        }\n      }),\n    router\n  )\n\n  router = Object.keys(config.POST).reduce(\n    (r, x) =>\n      r.post(x, async (req, res, next) => {\n        try {\n          const ctx = (handlers.ctx?.(req) ?? {}) as TContext\n\n          const data = {\n            params: req.params,\n            body: config.POST[x]?.body.parse(req.body),\n            query: config.POST[x]?.query?.parse(req.query),\n          }\n          const result = await handlers.POST[x]?.(data as any, ctx)\n          const validatedResult = config.POST[x]?.result.parse(result)\n          res.json(validatedResult)\n        } catch (err) {\n          next(err)\n        }\n      }),\n    router\n  )\n\n  return router\n}\n","import type z from \"zod\";\n\nexport type RouteConfig = {\n  body: z.ZodType;\n  query?: z.ZodType;\n  result: z.ZodType;\n};\n\nexport type RouterConfig = {\n  GET: Record<string, Omit<RouteConfig, \"body\">>;\n  POST: Record<string, RouteConfig>;\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 defineRouterConfig = <T extends RouterConfig>(config: T): T =>\n  config;\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 type { InferRouteConfig, RouterConfig } from \"./types\"\n\nexport type RouterClient<T extends RouterConfig> = {\n  GET: <K extends keyof T[\"GET\"]>(\n    path: K,\n    options?: Omit<Omit<InferRouteConfig<T[\"GET\"][K]>, \"body\">, \"result\">\n  ) => Promise<InferRouteConfig<T[\"GET\"][K]>[\"result\"]>\n  POST: <K extends keyof T[\"POST\"]>(\n    path: K,\n    body: InferRouteConfig<T[\"POST\"][K]>[\"body\"],\n    options?: Omit<InferRouteConfig<T[\"POST\"][K]>, \"body\" | \"result\">\n  ) => Promise<InferRouteConfig<T[\"POST\"][K]>[\"result\"]>\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\nexport const createClient = <T extends 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 client = {\n    GET: {} as any,\n    POST: {} as any,\n  }\n\n  client.GET = async (path: string, options?: any) => {\n    if (validate && options?.query) {\n      routes.GET[path]?.query?.parse(options.query)\n    }\n\n    const queryString = options?.query\n      ? \"?\" + new URLSearchParams(options.query).toString()\n      : \"\"\n\n    const response = await customFetch(`${baseUrl}${path}${queryString}`, {\n      method: \"GET\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        ...(await getHeaders()),\n      },\n    })\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 json = await response.json()\n\n    return routes.GET[path]?.result.parse(json)\n  }\n\n  client.POST = async (path: string, body: any, options?: any) => {\n    if (validate) {\n      if (body) {\n        routes.POST[path]?.body?.parse(body)\n      }\n      if (options?.query) {\n        routes.POST[path]?.query?.parse(options.query)\n      }\n    }\n\n    const queryString = options?.query\n      ? \"?\" + new URLSearchParams(options.query).toString()\n      : \"\"\n\n    const response = await customFetch(`${baseUrl}${path}${queryString}`, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        ...(await getHeaders()),\n      },\n      body: JSON.stringify(body),\n    })\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 json = await response.json()\n\n    return routes.POST[path]?.result.parse(json)\n  }\n\n  return client\n}\n","import type { Request, Router } from \"express\"\nimport { readFile } from \"node:fs/promises\"\nimport type { InferRouteConfig, RouterConfig } from \"./types\"\n\n// Extract path parameters from route string\n// e.g., \"/user/:id\" -> { id: string }, \"/user/:id/post/:postId\" -> { id: string, postId: string }\ntype ExtractRouteParams<T extends string> =\n  T extends `${infer _Start}:${infer Param}/${infer Rest}`\n    ? { [K in Param | keyof ExtractRouteParams<`/${Rest}`>]: string }\n    : T extends `${infer _Start}:${infer Param}`\n    ? { [K in Param]: string }\n    : Record<string, never>\n\nexport type RouteHandlers<T extends RouterConfig, TContext> = {\n  GET: {\n    [K in keyof T[\"GET\"]]: (\n      data: Omit<Omit<InferRouteConfig<T[\"GET\"][K]>, \"body\">, \"result\"> & {\n        params: K extends string ? ExtractRouteParams<K> : unknown\n      },\n      ctx: TContext\n    ) =>\n      | Promise<InferRouteConfig<T[\"GET\"][K]>[\"result\"]>\n      | InferRouteConfig<T[\"GET\"][K]>[\"result\"]\n  }\n  POST: {\n    [K in keyof T[\"POST\"]]: (\n      data: Omit<InferRouteConfig<T[\"POST\"][K]>, \"result\"> & {\n        params: K extends string ? ExtractRouteParams<K> : unknown\n      },\n      ctx: TContext\n    ) =>\n      | Promise<InferRouteConfig<T[\"POST\"][K]>[\"result\"]>\n      | InferRouteConfig<T[\"POST\"][K]>[\"result\"]\n  }\n}\n\nexport const createExpressRouter = <T extends RouterConfig, TContext>(\n  router: Router,\n  routes: T,\n  handlers: RouteHandlers<T, TContext> & {\n    ctx?: (req: Request) => TContext\n    schemaFilePath?: string\n  }\n) => {\n  router = Object.keys(routes.GET).reduce(\n    (r, x) =>\n      r.get(x, async (req, res, next) => {\n        try {\n          const ctx = (handlers.ctx?.(req) ?? {}) as TContext\n\n          const data = {\n            params: req.params,\n            query: routes.GET[x]?.query?.parse(req.query),\n          }\n          const result = await handlers.GET[x]?.(data as any, ctx)\n          const validatedResult = routes.GET[x]?.result.parse(result)\n\n          res.json(validatedResult)\n        } catch (err) {\n          next(err)\n        }\n      }),\n    router\n  )\n\n  if (handlers.schemaFilePath) {\n    router = router.get(\"/__schema\", async (_, res) =>\n      res\n        .contentType(\"text/plain\")\n        .send(await readFile(handlers.schemaFilePath!, \"utf8\"))\n    )\n  }\n\n  router = Object.keys(routes.POST).reduce(\n    (r, x) =>\n      r.post(x, async (req, res, next) => {\n        try {\n          const ctx = (handlers.ctx?.(req) ?? {}) as TContext\n\n          const data = {\n            params: req.params,\n            body: routes.POST[x]?.body.parse(req.body),\n            query: routes.POST[x]?.query?.parse(req.query),\n          }\n          const result = await handlers.POST[x]?.(data as any, ctx)\n          const validatedResult = routes.POST[x]?.result.parse(result)\n          res.json(validatedResult)\n        } catch (err) {\n          next(err)\n        }\n      }),\n    router\n  )\n\n  return router\n}\n","import type z from \"zod\"\n\nexport type RouteConfig = {\n  body: z.ZodType\n  query?: z.ZodType\n  result: z.ZodType\n}\n\nexport type RouterConfig = {\n  GET: Record<string, Omit<RouteConfig, \"body\">>\n  POST: Record<string, RouteConfig>\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 RouterConfig>(routes: T): T =>\n  routes\n"]}

package/package.json

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