@jokio/rpc 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,178 @@
+# jokRPC
+
+A type-safe RPC framework for TypeScript with Zod validation, designed for Express servers and HTTP clients.
+
+## Features
+
+- Full TypeScript type safety from server to client
+- Runtime validation using Zod schemas
+- Express.js integration for server-side
+- Flexible fetch-based client with custom fetch support
+- Support for both GET and POST routes
+- Query parameters and request body validation
+- Automatic response validation
+
+## Installation
+
+```bash
+npm install jokrpc zod express
+```
+
+## Usage
+
+### 1. Define Your Router Configuration
+
+```typescript
+import { defineRouterConfig } from 'jokrpc'
+import { z } from 'zod'
+
+const routerConfig = defineRouterConfig({
+  GET: {
+    '/users/:id': {
+      query: z.object({
+        include: z.enum(['posts', 'comments']).optional(),
+      }),
+      result: z.object({
+        id: z.string(),
+        name: z.string(),
+        email: z.string(),
+      }),
+    },
+  },
+  POST: {
+    '/users': {
+      body: z.object({
+        name: z.string(),
+        email: z.string().email(),
+      }),
+      query: z.object({
+        sendEmail: z.boolean().optional(),
+      }),
+      result: z.object({
+        id: z.string(),
+        name: z.string(),
+        email: z.string(),
+      }),
+    },
+  },
+})
+```
+
+### 2. Set Up the Server
+
+```typescript
+import express from 'express'
+import { applyConfigToExpressRouter } from 'jokrpc'
+
+const app = express()
+app.use(express.json())
+
+const router = express.Router()
+
+applyConfigToExpressRouter(router, routerConfig, {
+  GET: {
+    '/users/:id': async ({ query }) => {
+      // Handler implementation
+      return {
+        id: '1',
+        name: 'John Doe',
+        email: 'john@example.com',
+      }
+    },
+  },
+  POST: {
+    '/users': async ({ body, query }) => {
+      // Handler implementation
+      return {
+        id: '2',
+        name: body.name,
+        email: body.email,
+      }
+    },
+  },
+})
+
+app.use('/api', router)
+app.listen(3000)
+```
+
+### 3. Create a Type-Safe Client
+
+```typescript
+import { createClient } from 'jokrpc'
+
+const client = createClient(routerConfig, {
+  baseUrl: 'http://localhost:3000/api',
+  validateRequest: true, // Optional: validate requests on client-side
+})
+
+// Fully typed API calls
+const user = await client.GET['/users/:id']({
+  query: { include: 'posts' },
+})
+
+const newUser = await client.POST['/users']({
+  body: { name: 'Jane Doe', email: 'jane@example.com' },
+  query: { sendEmail: true },
+})
+```
+
+## API Reference
+
+### `defineRouterConfig(config)`
+
+Helper function to define a router configuration with type inference.
+
+### `applyConfigToExpressRouter(router, config, handlers)`
+
+Applies route handlers to an Express router with automatic validation.
+
+**Parameters:**
+- `router`: Express Router instance
+- `config`: Router configuration object
+- `handlers`: Handler functions for each route
+
+### `createClient(config, options)`
+
+Creates a type-safe HTTP client.
+
+**Options:**
+- `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)
+
+## Type Safety
+
+The library provides end-to-end type safety:
+
+```typescript
+// TypeScript knows the exact shape of requests and responses
+const result = await client.POST['/users']({
+  body: {
+    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)
+```
+
+## Error Handling
+
+The library throws errors for:
+- HTTP errors (non-2xx responses)
+- Validation errors (invalid request/response data)
+
+```typescript
+try {
+  await client.POST['/users']({ body: invalidData })
+} catch (error) {
+  // Handle validation or HTTP errors
+}
+```
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,48 @@
+import z from 'zod';
+import { Router } from 'express';
+
+type RouteConfig = {
+    body: z.ZodType;
+    query?: z.ZodType;
+    result: z.ZodType;
+};
+type RouterConfig = {
+    GET: Record<string, Omit<RouteConfig, 'body'>>;
+    POST: Record<string, RouteConfig>;
+};
+declare const defineRouterConfig: <T extends RouterConfig>(config: T) => T;
+
+type InferRouteConfig$1<T extends RouteConfig | Omit<RouteConfig, "body">> = {
+    [K in keyof T]: T[K] extends z.ZodType ? z.infer<T[K]> : never;
+};
+type RouterClient<T extends RouterConfig> = {
+    GET: {
+        [K in keyof T["GET"]]: (data?: Omit<Omit<InferRouteConfig$1<T["GET"][K]>, "body">, "result">) => Promise<InferRouteConfig$1<T["GET"][K]>["result"]>;
+    };
+    POST: {
+        [K in keyof T["POST"]]: (data: Omit<InferRouteConfig$1<T["POST"][K]>, "result">) => Promise<InferRouteConfig$1<T["POST"][K]>["result"]>;
+    };
+};
+type FetchFunction = (url: string, options: RequestInit) => Promise<Response>;
+type CreateClientOptions = {
+    baseUrl: string;
+    headers?: Record<string, string>;
+    fetch?: FetchFunction;
+    validateRequest?: boolean;
+};
+declare const createClient: <T extends RouterConfig>(config: T, options: CreateClientOptions) => RouterClient<T>;
+
+type InferRouteConfig<T extends RouteConfig | Omit<RouteConfig, "body">> = {
+    [K in keyof T]: T[K] extends z.ZodType ? z.infer<T[K]> : never;
+};
+type RouterHandlerConfig<T extends RouterConfig> = {
+    GET: {
+        [K in keyof T["GET"]]: (data: Omit<Omit<InferRouteConfig<T["GET"][K]>, "body">, "result">) => Promise<InferRouteConfig<T["GET"][K]>["result"]>;
+    };
+    POST: {
+        [K in keyof T["POST"]]: (data: Omit<InferRouteConfig<T["POST"][K]>, "result">) => Promise<InferRouteConfig<T["POST"][K]>["result"]>;
+    };
+};
+declare const applyConfigToExpressRouter: <T extends RouterConfig>(router: Router, config: T, handlers: RouterHandlerConfig<T>) => Router;
+
+export { type RouteConfig, type RouterClient, type RouterConfig, type RouterHandlerConfig, applyConfigToExpressRouter, createClient, defineRouterConfig };

package/dist/index.d.ts

@@ -0,0 +1,48 @@
+import z from 'zod';
+import { Router } from 'express';
+
+type RouteConfig = {
+    body: z.ZodType;
+    query?: z.ZodType;
+    result: z.ZodType;
+};
+type RouterConfig = {
+    GET: Record<string, Omit<RouteConfig, 'body'>>;
+    POST: Record<string, RouteConfig>;
+};
+declare const defineRouterConfig: <T extends RouterConfig>(config: T) => T;
+
+type InferRouteConfig$1<T extends RouteConfig | Omit<RouteConfig, "body">> = {
+    [K in keyof T]: T[K] extends z.ZodType ? z.infer<T[K]> : never;
+};
+type RouterClient<T extends RouterConfig> = {
+    GET: {
+        [K in keyof T["GET"]]: (data?: Omit<Omit<InferRouteConfig$1<T["GET"][K]>, "body">, "result">) => Promise<InferRouteConfig$1<T["GET"][K]>["result"]>;
+    };
+    POST: {
+        [K in keyof T["POST"]]: (data: Omit<InferRouteConfig$1<T["POST"][K]>, "result">) => Promise<InferRouteConfig$1<T["POST"][K]>["result"]>;
+    };
+};
+type FetchFunction = (url: string, options: RequestInit) => Promise<Response>;
+type CreateClientOptions = {
+    baseUrl: string;
+    headers?: Record<string, string>;
+    fetch?: FetchFunction;
+    validateRequest?: boolean;
+};
+declare const createClient: <T extends RouterConfig>(config: T, options: CreateClientOptions) => RouterClient<T>;
+
+type InferRouteConfig<T extends RouteConfig | Omit<RouteConfig, "body">> = {
+    [K in keyof T]: T[K] extends z.ZodType ? z.infer<T[K]> : never;
+};
+type RouterHandlerConfig<T extends RouterConfig> = {
+    GET: {
+        [K in keyof T["GET"]]: (data: Omit<Omit<InferRouteConfig<T["GET"][K]>, "body">, "result">) => Promise<InferRouteConfig<T["GET"][K]>["result"]>;
+    };
+    POST: {
+        [K in keyof T["POST"]]: (data: Omit<InferRouteConfig<T["POST"][K]>, "result">) => Promise<InferRouteConfig<T["POST"][K]>["result"]>;
+    };
+};
+declare const applyConfigToExpressRouter: <T extends RouterConfig>(router: Router, config: T, handlers: RouterHandlerConfig<T>) => Router;
+
+export { type RouteConfig, type RouterClient, type RouterConfig, type RouterHandlerConfig, applyConfigToExpressRouter, createClient, defineRouterConfig };

package/dist/index.js

@@ -0,0 +1,108 @@
+'use strict';
+
+// src/types.ts
+var defineRouterConfig = (config) => config;
+
+// src/client.ts
+var createClient = (config, options) => {
+  const {
+    baseUrl,
+    headers = {},
+    fetch: customFetch = fetch,
+    validateRequest = false
+  } = options;
+  const client = {
+    GET: {},
+    POST: {}
+  };
+  Object.keys(config.GET).forEach((path) => {
+    client.GET[path] = async (data) => {
+      if (validateRequest && data?.query) {
+        config.GET[path]?.query?.parse(data.query);
+      }
+      const queryString = data?.query ? "?" + new URLSearchParams(data.query).toString() : "";
+      const response = await customFetch(`${baseUrl}${path}${queryString}`, {
+        method: "GET",
+        headers: {
+          "Content-Type": "application/json",
+          ...headers
+        }
+      });
+      if (!response.ok) {
+        throw new Error(`HTTP error! status: ${response.status}`);
+      }
+      const json = await response.json();
+      return config.GET[path]?.result.parse(json);
+    };
+  });
+  Object.keys(config.POST).forEach((path) => {
+    client.POST[path] = async (data) => {
+      if (validateRequest) {
+        if (data?.body) {
+          config.POST[path]?.body?.parse(data.body);
+        }
+        if (data?.query) {
+          config.POST[path]?.query?.parse(data.query);
+        }
+      }
+      const queryString = data?.query ? "?" + new URLSearchParams(data.query).toString() : "";
+      const response = await customFetch(`${baseUrl}${path}${queryString}`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          ...headers
+        },
+        body: JSON.stringify(data.body)
+      });
+      if (!response.ok) {
+        throw new Error(`HTTP error! status: ${response.status}`);
+      }
+      const json = await response.json();
+      return config.POST[path]?.result.parse(json);
+    };
+  });
+  return client;
+};
+
+// src/server.ts
+var applyConfigToExpressRouter = (router, config, handlers) => {
+  const routes = Object.keys(config.GET);
+  routes.reduce(
+    (r, x) => r.get(x, async (req, res, next) => {
+      try {
+        const data = {
+          query: config.GET[x]?.query?.parse(req.query)
+        };
+        const result = await handlers.GET[x]?.(data);
+        const validatedResult = config.GET[x]?.result.parse(result);
+        res.json(validatedResult);
+      } catch (err) {
+        next(err);
+      }
+    }),
+    router
+  );
+  routes.reduce(
+    (r, x) => r.post(x, async (req, res, next) => {
+      try {
+        const data = {
+          body: config.POST[x]?.body.parse(req.body),
+          query: config.POST[x]?.query?.parse(req.query)
+        };
+        const result = await handlers.POST[x]?.(data);
+        const validatedResult = config.POST[x]?.result.parse(result);
+        res.json(validatedResult);
+      } catch (err) {
+        next(err);
+      }
+    }),
+    router
+  );
+  return router;
+};
+
+exports.applyConfigToExpressRouter = applyConfigToExpressRouter;
+exports.createClient = createClient;
+exports.defineRouterConfig = defineRouterConfig;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/client.ts","../src/server.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["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 const defineRouterConfig = <T extends RouterConfig>(config: T): T => config\n","import type z from \"zod\";\nimport type { RouteConfig, RouterConfig } from \"./types\";\n\ntype InferRouteConfig<T extends RouteConfig | Omit<RouteConfig, \"body\">> = {\n  [K in keyof T]: T[K] extends z.ZodType ? z.infer<T[K]> : never;\n};\n\nexport type RouterClient<T extends RouterConfig> = {\n  GET: {\n    [K in keyof T[\"GET\"]]: (\n      data?: Omit<Omit<InferRouteConfig<T[\"GET\"][K]>, \"body\">, \"result\">\n    ) => Promise<InferRouteConfig<T[\"GET\"][K]>[\"result\"]>;\n  };\n  POST: {\n    [K in keyof T[\"POST\"]]: (\n      data: Omit<InferRouteConfig<T[\"POST\"][K]>, \"result\">\n    ) => Promise<InferRouteConfig<T[\"POST\"][K]>[\"result\"]>;\n  };\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 RouterClient<T>[\"GET\"],\n    POST: {} as RouterClient<T>[\"POST\"],\n  };\n\n  Object.keys(config.GET).forEach((path) => {\n    (client.GET[path as keyof T[\"GET\"]] as any) = async (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      if (!response.ok) {\n        throw new Error(`HTTP error! status: ${response.status}`);\n      }\n      const json = await response.json();\n\n      return config.GET[path]?.result.parse(json);\n    };\n  });\n\n  Object.keys(config.POST).forEach((path) => {\n    (client.POST[path as keyof T[\"POST\"]] as any) = async (data: any) => {\n      if (validateRequest) {\n        if (data?.body) {\n          config.POST[path]?.body?.parse(data.body);\n        }\n        if (data?.query) {\n          config.POST[path]?.query?.parse(data.query);\n        }\n      }\n      const queryString = data?.query\n        ? \"?\" + new URLSearchParams(data.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(data.body),\n      });\n      if (!response.ok) {\n        throw new Error(`HTTP error! status: ${response.status}`);\n      }\n      const json = await response.json();\n\n      return config.POST[path]?.result.parse(json);\n    };\n  });\n\n  return client;\n};\n","import type { Router } from \"express\";\nimport type z from \"zod\";\nimport type { RouteConfig, RouterConfig } from \"./types\";\n\ntype InferRouteConfig<T extends RouteConfig | Omit<RouteConfig, \"body\">> = {\n  [K in keyof T]: T[K] extends z.ZodType ? z.infer<T[K]> : never;\n};\n\nexport type RouterHandlerConfig<T extends RouterConfig> = {\n  GET: {\n    [K in keyof T[\"GET\"]]: (\n      data: Omit<Omit<InferRouteConfig<T[\"GET\"][K]>, \"body\">, \"result\">\n    ) => Promise<InferRouteConfig<T[\"GET\"][K]>[\"result\"]>;\n  };\n  POST: {\n    [K in keyof T[\"POST\"]]: (\n      data: Omit<InferRouteConfig<T[\"POST\"][K]>, \"result\">\n    ) => Promise<InferRouteConfig<T[\"POST\"][K]>[\"result\"]>;\n  };\n};\n\nexport const applyConfigToExpressRouter = <T extends RouterConfig>(\n  router: Router,\n  config: T,\n  handlers: RouterHandlerConfig<T>\n) => {\n  const routes = Object.keys(config.GET);\n\n  routes.reduce(\n    (r, x) =>\n      r.get(x, async (req, res, next) => {\n        try {\n          const data = {\n            query: config.GET[x]?.query?.parse(req.query),\n          };\n          const result = await handlers.GET[x]?.(data as any);\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  routes.reduce(\n    (r, x) =>\n      r.post(x, async (req, res, next) => {\n        try {\n          const data = {\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);\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"]}

package/dist/index.mjs

@@ -0,0 +1,104 @@
+// src/types.ts
+var defineRouterConfig = (config) => config;
+
+// src/client.ts
+var createClient = (config, options) => {
+  const {
+    baseUrl,
+    headers = {},
+    fetch: customFetch = fetch,
+    validateRequest = false
+  } = options;
+  const client = {
+    GET: {},
+    POST: {}
+  };
+  Object.keys(config.GET).forEach((path) => {
+    client.GET[path] = async (data) => {
+      if (validateRequest && data?.query) {
+        config.GET[path]?.query?.parse(data.query);
+      }
+      const queryString = data?.query ? "?" + new URLSearchParams(data.query).toString() : "";
+      const response = await customFetch(`${baseUrl}${path}${queryString}`, {
+        method: "GET",
+        headers: {
+          "Content-Type": "application/json",
+          ...headers
+        }
+      });
+      if (!response.ok) {
+        throw new Error(`HTTP error! status: ${response.status}`);
+      }
+      const json = await response.json();
+      return config.GET[path]?.result.parse(json);
+    };
+  });
+  Object.keys(config.POST).forEach((path) => {
+    client.POST[path] = async (data) => {
+      if (validateRequest) {
+        if (data?.body) {
+          config.POST[path]?.body?.parse(data.body);
+        }
+        if (data?.query) {
+          config.POST[path]?.query?.parse(data.query);
+        }
+      }
+      const queryString = data?.query ? "?" + new URLSearchParams(data.query).toString() : "";
+      const response = await customFetch(`${baseUrl}${path}${queryString}`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          ...headers
+        },
+        body: JSON.stringify(data.body)
+      });
+      if (!response.ok) {
+        throw new Error(`HTTP error! status: ${response.status}`);
+      }
+      const json = await response.json();
+      return config.POST[path]?.result.parse(json);
+    };
+  });
+  return client;
+};
+
+// src/server.ts
+var applyConfigToExpressRouter = (router, config, handlers) => {
+  const routes = Object.keys(config.GET);
+  routes.reduce(
+    (r, x) => r.get(x, async (req, res, next) => {
+      try {
+        const data = {
+          query: config.GET[x]?.query?.parse(req.query)
+        };
+        const result = await handlers.GET[x]?.(data);
+        const validatedResult = config.GET[x]?.result.parse(result);
+        res.json(validatedResult);
+      } catch (err) {
+        next(err);
+      }
+    }),
+    router
+  );
+  routes.reduce(
+    (r, x) => r.post(x, async (req, res, next) => {
+      try {
+        const data = {
+          body: config.POST[x]?.body.parse(req.body),
+          query: config.POST[x]?.query?.parse(req.query)
+        };
+        const result = await handlers.POST[x]?.(data);
+        const validatedResult = config.POST[x]?.result.parse(result);
+        res.json(validatedResult);
+      } catch (err) {
+        next(err);
+      }
+    }),
+    router
+  );
+  return router;
+};
+
+export { applyConfigToExpressRouter, createClient, defineRouterConfig };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/client.ts","../src/server.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["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 const defineRouterConfig = <T extends RouterConfig>(config: T): T => config\n","import type z from \"zod\";\nimport type { RouteConfig, RouterConfig } from \"./types\";\n\ntype InferRouteConfig<T extends RouteConfig | Omit<RouteConfig, \"body\">> = {\n  [K in keyof T]: T[K] extends z.ZodType ? z.infer<T[K]> : never;\n};\n\nexport type RouterClient<T extends RouterConfig> = {\n  GET: {\n    [K in keyof T[\"GET\"]]: (\n      data?: Omit<Omit<InferRouteConfig<T[\"GET\"][K]>, \"body\">, \"result\">\n    ) => Promise<InferRouteConfig<T[\"GET\"][K]>[\"result\"]>;\n  };\n  POST: {\n    [K in keyof T[\"POST\"]]: (\n      data: Omit<InferRouteConfig<T[\"POST\"][K]>, \"result\">\n    ) => Promise<InferRouteConfig<T[\"POST\"][K]>[\"result\"]>;\n  };\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 RouterClient<T>[\"GET\"],\n    POST: {} as RouterClient<T>[\"POST\"],\n  };\n\n  Object.keys(config.GET).forEach((path) => {\n    (client.GET[path as keyof T[\"GET\"]] as any) = async (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      if (!response.ok) {\n        throw new Error(`HTTP error! status: ${response.status}`);\n      }\n      const json = await response.json();\n\n      return config.GET[path]?.result.parse(json);\n    };\n  });\n\n  Object.keys(config.POST).forEach((path) => {\n    (client.POST[path as keyof T[\"POST\"]] as any) = async (data: any) => {\n      if (validateRequest) {\n        if (data?.body) {\n          config.POST[path]?.body?.parse(data.body);\n        }\n        if (data?.query) {\n          config.POST[path]?.query?.parse(data.query);\n        }\n      }\n      const queryString = data?.query\n        ? \"?\" + new URLSearchParams(data.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(data.body),\n      });\n      if (!response.ok) {\n        throw new Error(`HTTP error! status: ${response.status}`);\n      }\n      const json = await response.json();\n\n      return config.POST[path]?.result.parse(json);\n    };\n  });\n\n  return client;\n};\n","import type { Router } from \"express\";\nimport type z from \"zod\";\nimport type { RouteConfig, RouterConfig } from \"./types\";\n\ntype InferRouteConfig<T extends RouteConfig | Omit<RouteConfig, \"body\">> = {\n  [K in keyof T]: T[K] extends z.ZodType ? z.infer<T[K]> : never;\n};\n\nexport type RouterHandlerConfig<T extends RouterConfig> = {\n  GET: {\n    [K in keyof T[\"GET\"]]: (\n      data: Omit<Omit<InferRouteConfig<T[\"GET\"][K]>, \"body\">, \"result\">\n    ) => Promise<InferRouteConfig<T[\"GET\"][K]>[\"result\"]>;\n  };\n  POST: {\n    [K in keyof T[\"POST\"]]: (\n      data: Omit<InferRouteConfig<T[\"POST\"][K]>, \"result\">\n    ) => Promise<InferRouteConfig<T[\"POST\"][K]>[\"result\"]>;\n  };\n};\n\nexport const applyConfigToExpressRouter = <T extends RouterConfig>(\n  router: Router,\n  config: T,\n  handlers: RouterHandlerConfig<T>\n) => {\n  const routes = Object.keys(config.GET);\n\n  routes.reduce(\n    (r, x) =>\n      r.get(x, async (req, res, next) => {\n        try {\n          const data = {\n            query: config.GET[x]?.query?.parse(req.query),\n          };\n          const result = await handlers.GET[x]?.(data as any);\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  routes.reduce(\n    (r, x) =>\n      r.post(x, async (req, res, next) => {\n        try {\n          const data = {\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);\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"]}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@jokio/rpc",
+  "version": "0.1.0",
+  "description": "Type-safe RPC framework with Zod validation for Express and TypeScript",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "require": "./dist/index.js",
+      "import": "./dist/index.mjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "prepublishOnly": "npm run build",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "rpc",
+    "typescript",
+    "zod",
+    "express",
+    "type-safe",
+    "api",
+    "validation",
+    "framework"
+  ],
+  "author": "",
+  "license": "MIT",
+  "peerDependencies": {
+    "express": "^4.0.0",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/node": "^20.10.0",
+    "express": "^4.18.2",
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3",
+    "zod": "^3.22.4"
+  },
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "bugs": {
+    "url": ""
+  },
+  "homepage": "",
+  "publishConfig": {
+    "access": "public"
+  }
+}