@richie-rpc/client 0.1.0

package/README.md

@@ -0,0 +1,193 @@
+# @richie-rpc/client
+
+Type-safe fetch client for Richie RPC contracts.
+
+## Installation
+
+```bash
+bun add @richie-rpc/client @richie-rpc/core zod
+```
+
+## Usage
+
+### Creating a Client
+
+```typescript
+import { createClient } from '@richie-rpc/client';
+import { contract } from './contract';
+
+const client = createClient(contract, {
+  baseUrl: 'https://api.example.com',
+  headers: {
+    'Authorization': 'Bearer token123'
+  }
+});
+```
+
+### Making Requests
+
+The client provides fully typed methods for each endpoint in your contract:
+
+```typescript
+// GET request with path parameters
+const user = await client.getUser({ 
+  params: { id: '123' } 
+});
+// user is typed based on the response schema
+
+// POST request with body
+const newUser = await client.createUser({
+  body: {
+    name: 'John Doe',
+    email: 'john@example.com'
+  }
+});
+
+// Request with query parameters
+const users = await client.listUsers({
+  query: {
+    limit: '10',
+    offset: '0'
+  }
+});
+
+// Request with custom headers
+const data = await client.getData({
+  headers: {
+    'X-Custom-Header': 'value'
+  }
+});
+```
+
+## Features
+
+- ✅ Full type safety based on contract
+- ✅ Automatic path parameter interpolation
+- ✅ Query parameter encoding
+- ✅ Request validation before sending
+- ✅ Response validation after receiving
+- ✅ Detailed error information
+- ✅ Support for all HTTP methods
+- ✅ Custom headers per request
+
+## Configuration
+
+### ClientConfig Options
+
+```typescript
+interface ClientConfig {
+  baseUrl: string;                    // Base URL for all requests
+  headers?: Record<string, string>;   // Default headers
+  validateRequest?: boolean;          // Validate before sending (default: true)
+  validateResponse?: boolean;         // Validate after receiving (default: true)
+}
+```
+
+## Response Format
+
+Responses include both the status code and data:
+
+```typescript
+const response = await client.getUser({ params: { id: '123' } });
+
+console.log(response.status); // 200, 404, etc.
+console.log(response.data);   // Typed response body
+```
+
+## Error Handling
+
+The client throws typed errors for different scenarios:
+
+### ClientValidationError
+
+Thrown when request data fails validation:
+
+```typescript
+try {
+  await client.createUser({
+    body: { email: 'invalid-email' }
+  });
+} catch (error) {
+  if (error instanceof ClientValidationError) {
+    console.log(error.field);  // 'body'
+    console.log(error.issues); // Zod validation issues
+  }
+}
+```
+
+### HTTPError
+
+Thrown for unexpected HTTP status codes:
+
+```typescript
+try {
+  await client.getUser({ params: { id: '999' } });
+} catch (error) {
+  if (error instanceof HTTPError) {
+    console.log(error.status);     // 404
+    console.log(error.statusText); // 'Not Found'
+    console.log(error.body);       // Response body
+  }
+}
+```
+
+## Type Safety
+
+All client methods are fully typed based on your contract:
+
+```typescript
+// ✅ Type-safe: required fields
+await client.createUser({
+  body: { name: 'John', email: 'john@example.com' }
+});
+
+// ❌ Type error: missing required field
+await client.createUser({
+  body: { name: 'John' }
+});
+
+// ✅ Type-safe: response data
+const user = await client.getUser({ params: { id: '123' } });
+console.log(user.data.name); // string
+
+// ❌ Type error: invalid property
+console.log(user.data.invalid);
+```
+
+## Request Options
+
+Each client method accepts an options object with the following fields (based on the endpoint definition):
+
+- `params`: Path parameters (if endpoint has params schema)
+- `query`: Query parameters (if endpoint has query schema)
+- `headers`: Custom headers (if endpoint has headers schema)
+- `body`: Request body (if endpoint has body schema)
+
+Only the fields defined in the contract are available and typed.
+
+## Validation
+
+By default, both request and response data are validated:
+
+- **Request validation**: Ensures data conforms to schema before sending
+- **Response validation**: Ensures server response matches expected schema
+
+You can disable validation:
+
+```typescript
+const client = createClient(contract, {
+  baseUrl: 'https://api.example.com',
+  validateRequest: false,  // Skip request validation
+  validateResponse: false  // Skip response validation
+});
+```
+
+## Links
+
+- **npm:** https://www.npmjs.com/package/@richie-rpc/client
+- **Repository:** https://github.com/ricsam/richie-rpc
+
+## License
+
+MIT
+

package/dist/cjs/index.cjs

@@ -0,0 +1,172 @@
+// @bun @bun-cjs
+(function(exports, require, module, __filename, __dirname) {var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __moduleCache = /* @__PURE__ */ new WeakMap;
+var __toCommonJS = (from) => {
+  var entry = __moduleCache.get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function")
+    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    }));
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+
+// packages/client/index.ts
+var exports_client = {};
+__export(exports_client, {
+  createTypedClient: () => createTypedClient,
+  createClient: () => createClient,
+  HTTPError: () => HTTPError,
+  ClientValidationError: () => ClientValidationError
+});
+module.exports = __toCommonJS(exports_client);
+var import_core = require("@richie-rpc/core");
+
+class ClientValidationError extends Error {
+  field;
+  issues;
+  constructor(field, issues) {
+    super(`Validation failed for ${field}`);
+    this.field = field;
+    this.issues = issues;
+    this.name = "ClientValidationError";
+  }
+}
+
+class HTTPError extends Error {
+  status;
+  statusText;
+  body;
+  constructor(status, statusText, body) {
+    super(`HTTP Error ${status}: ${statusText}`);
+    this.status = status;
+    this.statusText = statusText;
+    this.body = body;
+    this.name = "HTTPError";
+  }
+}
+function validateRequest(endpoint, options) {
+  if (endpoint.params && options.params) {
+    const result = endpoint.params.safeParse(options.params);
+    if (!result.success) {
+      throw new ClientValidationError("params", result.error.issues);
+    }
+  }
+  if (endpoint.query && options.query) {
+    const result = endpoint.query.safeParse(options.query);
+    if (!result.success) {
+      throw new ClientValidationError("query", result.error.issues);
+    }
+  }
+  if (endpoint.headers && options.headers) {
+    const result = endpoint.headers.safeParse(options.headers);
+    if (!result.success) {
+      throw new ClientValidationError("headers", result.error.issues);
+    }
+  }
+  if (endpoint.body && options.body) {
+    const result = endpoint.body.safeParse(options.body);
+    if (!result.success) {
+      throw new ClientValidationError("body", result.error.issues);
+    }
+  }
+}
+function validateResponse(endpoint, status, data) {
+  const responseSchema = endpoint.responses[status];
+  if (responseSchema) {
+    const result = responseSchema.safeParse(data);
+    if (!result.success) {
+      throw new ClientValidationError(`response[${status}]`, result.error.issues);
+    }
+  }
+}
+async function makeRequest(config, endpoint, options) {
+  if (config.validateRequest !== false) {
+    validateRequest(endpoint, options);
+  }
+  let path = endpoint.path;
+  if (options.params) {
+    path = import_core.interpolatePath(path, options.params);
+  }
+  const url = import_core.buildUrl(config.baseUrl, path, options.query);
+  const headers = new Headers(config.headers);
+  if (options.headers) {
+    for (const [key, value] of Object.entries(options.headers)) {
+      headers.set(key, String(value));
+    }
+  }
+  const init = {
+    method: endpoint.method,
+    headers
+  };
+  if (options.body !== undefined) {
+    headers.set("content-type", "application/json");
+    init.body = JSON.stringify(options.body);
+  }
+  const response = await fetch(url, init);
+  let data;
+  if (response.status === 204) {
+    data = {};
+  } else {
+    const contentType = response.headers.get("content-type") || "";
+    if (contentType.includes("application/json")) {
+      data = await response.json();
+    } else if (contentType.includes("text/")) {
+      data = await response.text();
+    } else {
+      const text = await response.text();
+      if (text) {
+        data = text;
+      } else {
+        data = {};
+      }
+    }
+  }
+  if (!response.ok && !(response.status in endpoint.responses)) {
+    throw new HTTPError(response.status, response.statusText, data);
+  }
+  if (config.validateResponse !== false) {
+    validateResponse(endpoint, response.status, data);
+  }
+  return {
+    status: response.status,
+    data
+  };
+}
+function createClient(contract, config) {
+  const client = {};
+  for (const [name, endpoint] of Object.entries(contract)) {
+    client[name] = (options = {}) => {
+      return makeRequest(config, endpoint, options);
+    };
+  }
+  return client;
+}
+function createTypedClient(_config) {
+  return new Proxy({}, {
+    get(_target, _prop) {
+      return async (_options = {}) => {
+        throw new Error("createTypedClient requires contract at runtime for validation. Use createClient instead.");
+      };
+    }
+  });
+}
+})
+
+//# debugId=BC1C6659CB2717F064756E2164756E21

package/dist/cjs/index.cjs.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../index.ts"],
+  "sourcesContent": [
+    "import type {\n  Contract,\n  EndpointDefinition,\n  ExtractBody,\n  ExtractHeaders,\n  ExtractParams,\n  ExtractQuery,\n} from '@richie-rpc/core';\nimport { buildUrl, interpolatePath } from '@richie-rpc/core';\nimport type { z } from 'zod';\n\n// Client configuration\nexport interface ClientConfig {\n  baseUrl: string;\n  headers?: Record<string, string>;\n  validateRequest?: boolean;\n  validateResponse?: boolean;\n}\n\n// Request options for an endpoint\nexport type EndpointRequestOptions<T extends EndpointDefinition> = {\n  params?: ExtractParams<T> extends never ? never : ExtractParams<T>;\n  query?: ExtractQuery<T> extends never ? never : ExtractQuery<T>;\n  headers?: ExtractHeaders<T> extends never ? never : ExtractHeaders<T>;\n  body?: ExtractBody<T> extends never ? never : ExtractBody<T>;\n};\n\n// Response type for an endpoint (union of all possible responses)\nexport type EndpointResponse<T extends EndpointDefinition> = {\n  [Status in keyof T['responses']]: {\n    status: Status;\n    data: T['responses'][Status] extends z.ZodTypeAny ? z.infer<T['responses'][Status]> : never;\n  };\n}[keyof T['responses']];\n\n// Client method type for an endpoint\nexport type ClientMethod<T extends EndpointDefinition> = (\n  options: EndpointRequestOptions<T>,\n) => Promise<EndpointResponse<T>>;\n\n// Client type for a contract\nexport type Client<T extends Contract> = {\n  [K in keyof T]: ClientMethod<T[K]>;\n};\n\n// Validation error\nexport class ClientValidationError extends Error {\n  constructor(\n    public field: string,\n    public issues: z.ZodIssue[],\n  ) {\n    super(`Validation failed for ${field}`);\n    this.name = 'ClientValidationError';\n  }\n}\n\n// HTTP error\nexport class HTTPError extends Error {\n  constructor(\n    public status: number,\n    public statusText: string,\n    public body: unknown,\n  ) {\n    super(`HTTP Error ${status}: ${statusText}`);\n    this.name = 'HTTPError';\n  }\n}\n\n/**\n * Validate request data before sending\n */\nfunction validateRequest<T extends EndpointDefinition>(\n  endpoint: T,\n  options: EndpointRequestOptions<T>,\n): void {\n  // Validate params\n  if (endpoint.params && options.params) {\n    const result = endpoint.params.safeParse(options.params);\n    if (!result.success) {\n      throw new ClientValidationError('params', result.error.issues);\n    }\n  }\n\n  // Validate query\n  if (endpoint.query && options.query) {\n    const result = endpoint.query.safeParse(options.query);\n    if (!result.success) {\n      throw new ClientValidationError('query', result.error.issues);\n    }\n  }\n\n  // Validate headers\n  if (endpoint.headers && options.headers) {\n    const result = endpoint.headers.safeParse(options.headers);\n    if (!result.success) {\n      throw new ClientValidationError('headers', result.error.issues);\n    }\n  }\n\n  // Validate body\n  if (endpoint.body && options.body) {\n    const result = endpoint.body.safeParse(options.body);\n    if (!result.success) {\n      throw new ClientValidationError('body', result.error.issues);\n    }\n  }\n}\n\n/**\n * Validate response data after receiving\n */\nfunction validateResponse<T extends EndpointDefinition>(\n  endpoint: T,\n  status: number,\n  data: unknown,\n): void {\n  const responseSchema = endpoint.responses[status];\n  if (responseSchema) {\n    const result = responseSchema.safeParse(data);\n    if (!result.success) {\n      throw new ClientValidationError(`response[${status}]`, result.error.issues);\n    }\n  }\n}\n\n/**\n * Make a request to an endpoint\n */\nasync function makeRequest<T extends EndpointDefinition>(\n  config: ClientConfig,\n  endpoint: T,\n  options: EndpointRequestOptions<T>,\n): Promise<EndpointResponse<T>> {\n  // Validate request if enabled\n  if (config.validateRequest !== false) {\n    validateRequest(endpoint, options);\n  }\n\n  // Build URL\n  let path = endpoint.path;\n  if (options.params) {\n    path = interpolatePath(path, options.params as Record<string, string | number>);\n  }\n\n  const url = buildUrl(\n    config.baseUrl,\n    path,\n    options.query as Record<string, string | number | boolean | string[]> | undefined,\n  );\n\n  // Build headers\n  const headers = new Headers(config.headers);\n  if (options.headers) {\n    for (const [key, value] of Object.entries(options.headers)) {\n      headers.set(key, String(value));\n    }\n  }\n\n  // Build request init\n  const init: RequestInit = {\n    method: endpoint.method,\n    headers,\n  };\n\n  // Add body if present\n  if (options.body !== undefined) {\n    headers.set('content-type', 'application/json');\n    init.body = JSON.stringify(options.body);\n  }\n\n  // Make request\n  const response = await fetch(url, init);\n\n  // Parse response\n  let data: unknown;\n\n  // Handle 204 No Content\n  if (response.status === 204) {\n    data = {};\n  } else {\n    const contentType = response.headers.get('content-type') || '';\n\n    if (contentType.includes('application/json')) {\n      data = await response.json();\n    } else if (contentType.includes('text/')) {\n      data = await response.text();\n    } else {\n      // Check if there's any content\n      const text = await response.text();\n      if (text) {\n        data = text;\n      } else {\n        data = {};\n      }\n    }\n  }\n\n  // Check for HTTP errors\n  if (!response.ok && !(response.status in endpoint.responses)) {\n    throw new HTTPError(response.status, response.statusText, data);\n  }\n\n  // Validate response if enabled\n  if (config.validateResponse !== false) {\n    validateResponse(endpoint, response.status, data);\n  }\n\n  return {\n    status: response.status,\n    data,\n  } as EndpointResponse<T>;\n}\n\n/**\n * Create a typesafe client for a contract\n */\nexport function createClient<T extends Contract>(contract: T, config: ClientConfig): Client<T> {\n  const client: Record<string, unknown> = {};\n\n  for (const [name, endpoint] of Object.entries(contract)) {\n    client[name] = (options: EndpointRequestOptions<EndpointDefinition> = {}) => {\n      return makeRequest(config, endpoint, options);\n    };\n  }\n\n  return client as Client<T>;\n}\n\n/**\n * Create a client without providing the contract at runtime\n * Useful when you only need types and want a lighter bundle\n */\nexport function createTypedClient<T extends Contract>(_config: ClientConfig): Client<T> {\n  return new Proxy({} as Client<T>, {\n    get(_target, _prop: string) {\n      return async (_options: EndpointRequestOptions<EndpointDefinition> = {}) => {\n        // Without the contract, we can't validate or infer the endpoint\n        // This is just a basic fetch wrapper with typing\n        throw new Error(\n          'createTypedClient requires contract at runtime for validation. Use createClient instead.',\n        );\n      };\n    },\n  });\n}\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQ0C,IAA1C;AAAA;AAsCO,MAAM,8BAA8B,MAAM;AAAA,EAEtC;AAAA,EACA;AAAA,EAFT,WAAW,CACF,OACA,QACP;AAAA,IACA,MAAM,yBAAyB,OAAO;AAAA,IAH/B;AAAA,IACA;AAAA,IAGP,KAAK,OAAO;AAAA;AAEhB;AAAA;AAGO,MAAM,kBAAkB,MAAM;AAAA,EAE1B;AAAA,EACA;AAAA,EACA;AAAA,EAHT,WAAW,CACF,QACA,YACA,MACP;AAAA,IACA,MAAM,cAAc,WAAW,YAAY;AAAA,IAJpC;AAAA,IACA;AAAA,IACA;AAAA,IAGP,KAAK,OAAO;AAAA;AAEhB;AAKA,SAAS,eAA6C,CACpD,UACA,SACM;AAAA,EAEN,IAAI,SAAS,UAAU,QAAQ,QAAQ;AAAA,IACrC,MAAM,SAAS,SAAS,OAAO,UAAU,QAAQ,MAAM;AAAA,IACvD,IAAI,CAAC,OAAO,SAAS;AAAA,MACnB,MAAM,IAAI,sBAAsB,UAAU,OAAO,MAAM,MAAM;AAAA,IAC/D;AAAA,EACF;AAAA,EAGA,IAAI,SAAS,SAAS,QAAQ,OAAO;AAAA,IACnC,MAAM,SAAS,SAAS,MAAM,UAAU,QAAQ,KAAK;AAAA,IACrD,IAAI,CAAC,OAAO,SAAS;AAAA,MACnB,MAAM,IAAI,sBAAsB,SAAS,OAAO,MAAM,MAAM;AAAA,IAC9D;AAAA,EACF;AAAA,EAGA,IAAI,SAAS,WAAW,QAAQ,SAAS;AAAA,IACvC,MAAM,SAAS,SAAS,QAAQ,UAAU,QAAQ,OAAO;AAAA,IACzD,IAAI,CAAC,OAAO,SAAS;AAAA,MACnB,MAAM,IAAI,sBAAsB,WAAW,OAAO,MAAM,MAAM;AAAA,IAChE;AAAA,EACF;AAAA,EAGA,IAAI,SAAS,QAAQ,QAAQ,MAAM;AAAA,IACjC,MAAM,SAAS,SAAS,KAAK,UAAU,QAAQ,IAAI;AAAA,IACnD,IAAI,CAAC,OAAO,SAAS;AAAA,MACnB,MAAM,IAAI,sBAAsB,QAAQ,OAAO,MAAM,MAAM;AAAA,IAC7D;AAAA,EACF;AAAA;AAMF,SAAS,gBAA8C,CACrD,UACA,QACA,MACM;AAAA,EACN,MAAM,iBAAiB,SAAS,UAAU;AAAA,EAC1C,IAAI,gBAAgB;AAAA,IAClB,MAAM,SAAS,eAAe,UAAU,IAAI;AAAA,IAC5C,IAAI,CAAC,OAAO,SAAS;AAAA,MACnB,MAAM,IAAI,sBAAsB,YAAY,WAAW,OAAO,MAAM,MAAM;AAAA,IAC5E;AAAA,EACF;AAAA;AAMF,eAAe,WAAyC,CACtD,QACA,UACA,SAC8B;AAAA,EAE9B,IAAI,OAAO,oBAAoB,OAAO;AAAA,IACpC,gBAAgB,UAAU,OAAO;AAAA,EACnC;AAAA,EAGA,IAAI,OAAO,SAAS;AAAA,EACpB,IAAI,QAAQ,QAAQ;AAAA,IAClB,OAAO,4BAAgB,MAAM,QAAQ,MAAyC;AAAA,EAChF;AAAA,EAEA,MAAM,MAAM,qBACV,OAAO,SACP,MACA,QAAQ,KACV;AAAA,EAGA,MAAM,UAAU,IAAI,QAAQ,OAAO,OAAO;AAAA,EAC1C,IAAI,QAAQ,SAAS;AAAA,IACnB,YAAY,KAAK,UAAU,OAAO,QAAQ,QAAQ,OAAO,GAAG;AAAA,MAC1D,QAAQ,IAAI,KAAK,OAAO,KAAK,CAAC;AAAA,IAChC;AAAA,EACF;AAAA,EAGA,MAAM,OAAoB;AAAA,IACxB,QAAQ,SAAS;AAAA,IACjB;AAAA,EACF;AAAA,EAGA,IAAI,QAAQ,SAAS,WAAW;AAAA,IAC9B,QAAQ,IAAI,gBAAgB,kBAAkB;AAAA,IAC9C,KAAK,OAAO,KAAK,UAAU,QAAQ,IAAI;AAAA,EACzC;AAAA,EAGA,MAAM,WAAW,MAAM,MAAM,KAAK,IAAI;AAAA,EAGtC,IAAI;AAAA,EAGJ,IAAI,SAAS,WAAW,KAAK;AAAA,IAC3B,OAAO,CAAC;AAAA,EACV,EAAO;AAAA,IACL,MAAM,cAAc,SAAS,QAAQ,IAAI,cAAc,KAAK;AAAA,IAE5D,IAAI,YAAY,SAAS,kBAAkB,GAAG;AAAA,MAC5C,OAAO,MAAM,SAAS,KAAK;AAAA,IAC7B,EAAO,SAAI,YAAY,SAAS,OAAO,GAAG;AAAA,MACxC,OAAO,MAAM,SAAS,KAAK;AAAA,IAC7B,EAAO;AAAA,MAEL,MAAM,OAAO,MAAM,SAAS,KAAK;AAAA,MACjC,IAAI,MAAM;AAAA,QACR,OAAO;AAAA,MACT,EAAO;AAAA,QACL,OAAO,CAAC;AAAA;AAAA;AAAA;AAAA,EAMd,IAAI,CAAC,SAAS,MAAM,EAAE,SAAS,UAAU,SAAS,YAAY;AAAA,IAC5D,MAAM,IAAI,UAAU,SAAS,QAAQ,SAAS,YAAY,IAAI;AAAA,EAChE;AAAA,EAGA,IAAI,OAAO,qBAAqB,OAAO;AAAA,IACrC,iBAAiB,UAAU,SAAS,QAAQ,IAAI;AAAA,EAClD;AAAA,EAEA,OAAO;AAAA,IACL,QAAQ,SAAS;AAAA,IACjB;AAAA,EACF;AAAA;AAMK,SAAS,YAAgC,CAAC,UAAa,QAAiC;AAAA,EAC7F,MAAM,SAAkC,CAAC;AAAA,EAEzC,YAAY,MAAM,aAAa,OAAO,QAAQ,QAAQ,GAAG;AAAA,IACvD,OAAO,QAAQ,CAAC,UAAsD,CAAC,MAAM;AAAA,MAC3E,OAAO,YAAY,QAAQ,UAAU,OAAO;AAAA;AAAA,EAEhD;AAAA,EAEA,OAAO;AAAA;AAOF,SAAS,iBAAqC,CAAC,SAAkC;AAAA,EACtF,OAAO,IAAI,MAAM,CAAC,GAAgB;AAAA,IAChC,GAAG,CAAC,SAAS,OAAe;AAAA,MAC1B,OAAO,OAAO,WAAuD,CAAC,MAAM;AAAA,QAG1E,MAAM,IAAI,MACR,0FACF;AAAA;AAAA;AAAA,EAGN,CAAC;AAAA;",
+  "debugId": "BC1C6659CB2717F064756E2164756E21",
+  "names": []
+}

package/dist/cjs/package.json

@@ -0,0 +1,5 @@
+{
+  "name": "@richie-rpc/client",
+  "version": "0.1.0",
+  "type": "commonjs"
+}

package/dist/mjs/index.mjs

@@ -0,0 +1,141 @@
+// @bun
+// packages/client/index.ts
+import { buildUrl, interpolatePath } from "@richie-rpc/core";
+
+class ClientValidationError extends Error {
+  field;
+  issues;
+  constructor(field, issues) {
+    super(`Validation failed for ${field}`);
+    this.field = field;
+    this.issues = issues;
+    this.name = "ClientValidationError";
+  }
+}
+
+class HTTPError extends Error {
+  status;
+  statusText;
+  body;
+  constructor(status, statusText, body) {
+    super(`HTTP Error ${status}: ${statusText}`);
+    this.status = status;
+    this.statusText = statusText;
+    this.body = body;
+    this.name = "HTTPError";
+  }
+}
+function validateRequest(endpoint, options) {
+  if (endpoint.params && options.params) {
+    const result = endpoint.params.safeParse(options.params);
+    if (!result.success) {
+      throw new ClientValidationError("params", result.error.issues);
+    }
+  }
+  if (endpoint.query && options.query) {
+    const result = endpoint.query.safeParse(options.query);
+    if (!result.success) {
+      throw new ClientValidationError("query", result.error.issues);
+    }
+  }
+  if (endpoint.headers && options.headers) {
+    const result = endpoint.headers.safeParse(options.headers);
+    if (!result.success) {
+      throw new ClientValidationError("headers", result.error.issues);
+    }
+  }
+  if (endpoint.body && options.body) {
+    const result = endpoint.body.safeParse(options.body);
+    if (!result.success) {
+      throw new ClientValidationError("body", result.error.issues);
+    }
+  }
+}
+function validateResponse(endpoint, status, data) {
+  const responseSchema = endpoint.responses[status];
+  if (responseSchema) {
+    const result = responseSchema.safeParse(data);
+    if (!result.success) {
+      throw new ClientValidationError(`response[${status}]`, result.error.issues);
+    }
+  }
+}
+async function makeRequest(config, endpoint, options) {
+  if (config.validateRequest !== false) {
+    validateRequest(endpoint, options);
+  }
+  let path = endpoint.path;
+  if (options.params) {
+    path = interpolatePath(path, options.params);
+  }
+  const url = buildUrl(config.baseUrl, path, options.query);
+  const headers = new Headers(config.headers);
+  if (options.headers) {
+    for (const [key, value] of Object.entries(options.headers)) {
+      headers.set(key, String(value));
+    }
+  }
+  const init = {
+    method: endpoint.method,
+    headers
+  };
+  if (options.body !== undefined) {
+    headers.set("content-type", "application/json");
+    init.body = JSON.stringify(options.body);
+  }
+  const response = await fetch(url, init);
+  let data;
+  if (response.status === 204) {
+    data = {};
+  } else {
+    const contentType = response.headers.get("content-type") || "";
+    if (contentType.includes("application/json")) {
+      data = await response.json();
+    } else if (contentType.includes("text/")) {
+      data = await response.text();
+    } else {
+      const text = await response.text();
+      if (text) {
+        data = text;
+      } else {
+        data = {};
+      }
+    }
+  }
+  if (!response.ok && !(response.status in endpoint.responses)) {
+    throw new HTTPError(response.status, response.statusText, data);
+  }
+  if (config.validateResponse !== false) {
+    validateResponse(endpoint, response.status, data);
+  }
+  return {
+    status: response.status,
+    data
+  };
+}
+function createClient(contract, config) {
+  const client = {};
+  for (const [name, endpoint] of Object.entries(contract)) {
+    client[name] = (options = {}) => {
+      return makeRequest(config, endpoint, options);
+    };
+  }
+  return client;
+}
+function createTypedClient(_config) {
+  return new Proxy({}, {
+    get(_target, _prop) {
+      return async (_options = {}) => {
+        throw new Error("createTypedClient requires contract at runtime for validation. Use createClient instead.");
+      };
+    }
+  });
+}
+export {
+  createTypedClient,
+  createClient,
+  HTTPError,
+  ClientValidationError
+};
+
+//# debugId=1B7C82F232BA1F0964756E2164756E21

package/dist/mjs/index.mjs.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../index.ts"],
+  "sourcesContent": [
+    "import type {\n  Contract,\n  EndpointDefinition,\n  ExtractBody,\n  ExtractHeaders,\n  ExtractParams,\n  ExtractQuery,\n} from '@richie-rpc/core';\nimport { buildUrl, interpolatePath } from '@richie-rpc/core';\nimport type { z } from 'zod';\n\n// Client configuration\nexport interface ClientConfig {\n  baseUrl: string;\n  headers?: Record<string, string>;\n  validateRequest?: boolean;\n  validateResponse?: boolean;\n}\n\n// Request options for an endpoint\nexport type EndpointRequestOptions<T extends EndpointDefinition> = {\n  params?: ExtractParams<T> extends never ? never : ExtractParams<T>;\n  query?: ExtractQuery<T> extends never ? never : ExtractQuery<T>;\n  headers?: ExtractHeaders<T> extends never ? never : ExtractHeaders<T>;\n  body?: ExtractBody<T> extends never ? never : ExtractBody<T>;\n};\n\n// Response type for an endpoint (union of all possible responses)\nexport type EndpointResponse<T extends EndpointDefinition> = {\n  [Status in keyof T['responses']]: {\n    status: Status;\n    data: T['responses'][Status] extends z.ZodTypeAny ? z.infer<T['responses'][Status]> : never;\n  };\n}[keyof T['responses']];\n\n// Client method type for an endpoint\nexport type ClientMethod<T extends EndpointDefinition> = (\n  options: EndpointRequestOptions<T>,\n) => Promise<EndpointResponse<T>>;\n\n// Client type for a contract\nexport type Client<T extends Contract> = {\n  [K in keyof T]: ClientMethod<T[K]>;\n};\n\n// Validation error\nexport class ClientValidationError extends Error {\n  constructor(\n    public field: string,\n    public issues: z.ZodIssue[],\n  ) {\n    super(`Validation failed for ${field}`);\n    this.name = 'ClientValidationError';\n  }\n}\n\n// HTTP error\nexport class HTTPError extends Error {\n  constructor(\n    public status: number,\n    public statusText: string,\n    public body: unknown,\n  ) {\n    super(`HTTP Error ${status}: ${statusText}`);\n    this.name = 'HTTPError';\n  }\n}\n\n/**\n * Validate request data before sending\n */\nfunction validateRequest<T extends EndpointDefinition>(\n  endpoint: T,\n  options: EndpointRequestOptions<T>,\n): void {\n  // Validate params\n  if (endpoint.params && options.params) {\n    const result = endpoint.params.safeParse(options.params);\n    if (!result.success) {\n      throw new ClientValidationError('params', result.error.issues);\n    }\n  }\n\n  // Validate query\n  if (endpoint.query && options.query) {\n    const result = endpoint.query.safeParse(options.query);\n    if (!result.success) {\n      throw new ClientValidationError('query', result.error.issues);\n    }\n  }\n\n  // Validate headers\n  if (endpoint.headers && options.headers) {\n    const result = endpoint.headers.safeParse(options.headers);\n    if (!result.success) {\n      throw new ClientValidationError('headers', result.error.issues);\n    }\n  }\n\n  // Validate body\n  if (endpoint.body && options.body) {\n    const result = endpoint.body.safeParse(options.body);\n    if (!result.success) {\n      throw new ClientValidationError('body', result.error.issues);\n    }\n  }\n}\n\n/**\n * Validate response data after receiving\n */\nfunction validateResponse<T extends EndpointDefinition>(\n  endpoint: T,\n  status: number,\n  data: unknown,\n): void {\n  const responseSchema = endpoint.responses[status];\n  if (responseSchema) {\n    const result = responseSchema.safeParse(data);\n    if (!result.success) {\n      throw new ClientValidationError(`response[${status}]`, result.error.issues);\n    }\n  }\n}\n\n/**\n * Make a request to an endpoint\n */\nasync function makeRequest<T extends EndpointDefinition>(\n  config: ClientConfig,\n  endpoint: T,\n  options: EndpointRequestOptions<T>,\n): Promise<EndpointResponse<T>> {\n  // Validate request if enabled\n  if (config.validateRequest !== false) {\n    validateRequest(endpoint, options);\n  }\n\n  // Build URL\n  let path = endpoint.path;\n  if (options.params) {\n    path = interpolatePath(path, options.params as Record<string, string | number>);\n  }\n\n  const url = buildUrl(\n    config.baseUrl,\n    path,\n    options.query as Record<string, string | number | boolean | string[]> | undefined,\n  );\n\n  // Build headers\n  const headers = new Headers(config.headers);\n  if (options.headers) {\n    for (const [key, value] of Object.entries(options.headers)) {\n      headers.set(key, String(value));\n    }\n  }\n\n  // Build request init\n  const init: RequestInit = {\n    method: endpoint.method,\n    headers,\n  };\n\n  // Add body if present\n  if (options.body !== undefined) {\n    headers.set('content-type', 'application/json');\n    init.body = JSON.stringify(options.body);\n  }\n\n  // Make request\n  const response = await fetch(url, init);\n\n  // Parse response\n  let data: unknown;\n\n  // Handle 204 No Content\n  if (response.status === 204) {\n    data = {};\n  } else {\n    const contentType = response.headers.get('content-type') || '';\n\n    if (contentType.includes('application/json')) {\n      data = await response.json();\n    } else if (contentType.includes('text/')) {\n      data = await response.text();\n    } else {\n      // Check if there's any content\n      const text = await response.text();\n      if (text) {\n        data = text;\n      } else {\n        data = {};\n      }\n    }\n  }\n\n  // Check for HTTP errors\n  if (!response.ok && !(response.status in endpoint.responses)) {\n    throw new HTTPError(response.status, response.statusText, data);\n  }\n\n  // Validate response if enabled\n  if (config.validateResponse !== false) {\n    validateResponse(endpoint, response.status, data);\n  }\n\n  return {\n    status: response.status,\n    data,\n  } as EndpointResponse<T>;\n}\n\n/**\n * Create a typesafe client for a contract\n */\nexport function createClient<T extends Contract>(contract: T, config: ClientConfig): Client<T> {\n  const client: Record<string, unknown> = {};\n\n  for (const [name, endpoint] of Object.entries(contract)) {\n    client[name] = (options: EndpointRequestOptions<EndpointDefinition> = {}) => {\n      return makeRequest(config, endpoint, options);\n    };\n  }\n\n  return client as Client<T>;\n}\n\n/**\n * Create a client without providing the contract at runtime\n * Useful when you only need types and want a lighter bundle\n */\nexport function createTypedClient<T extends Contract>(_config: ClientConfig): Client<T> {\n  return new Proxy({} as Client<T>, {\n    get(_target, _prop: string) {\n      return async (_options: EndpointRequestOptions<EndpointDefinition> = {}) => {\n        // Without the contract, we can't validate or infer the endpoint\n        // This is just a basic fetch wrapper with typing\n        throw new Error(\n          'createTypedClient requires contract at runtime for validation. Use createClient instead.',\n        );\n      };\n    },\n  });\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "1B7C82F232BA1F0964756E2164756E21",
+  "names": []
+}

package/dist/mjs/package.json

@@ -0,0 +1,5 @@
+{
+  "name": "@richie-rpc/client",
+  "version": "0.1.0",
+  "type": "module"
+}

package/dist/types/index.d.ts

@@ -0,0 +1,44 @@
+import type { Contract, EndpointDefinition, ExtractBody, ExtractHeaders, ExtractParams, ExtractQuery } from '@richie-rpc/core';
+import type { z } from 'zod';
+export interface ClientConfig {
+    baseUrl: string;
+    headers?: Record<string, string>;
+    validateRequest?: boolean;
+    validateResponse?: boolean;
+}
+export type EndpointRequestOptions<T extends EndpointDefinition> = {
+    params?: ExtractParams<T> extends never ? never : ExtractParams<T>;
+    query?: ExtractQuery<T> extends never ? never : ExtractQuery<T>;
+    headers?: ExtractHeaders<T> extends never ? never : ExtractHeaders<T>;
+    body?: ExtractBody<T> extends never ? never : ExtractBody<T>;
+};
+export type EndpointResponse<T extends EndpointDefinition> = {
+    [Status in keyof T['responses']]: {
+        status: Status;
+        data: T['responses'][Status] extends z.ZodTypeAny ? z.infer<T['responses'][Status]> : never;
+    };
+}[keyof T['responses']];
+export type ClientMethod<T extends EndpointDefinition> = (options: EndpointRequestOptions<T>) => Promise<EndpointResponse<T>>;
+export type Client<T extends Contract> = {
+    [K in keyof T]: ClientMethod<T[K]>;
+};
+export declare class ClientValidationError extends Error {
+    field: string;
+    issues: z.ZodIssue[];
+    constructor(field: string, issues: z.ZodIssue[]);
+}
+export declare class HTTPError extends Error {
+    status: number;
+    statusText: string;
+    body: unknown;
+    constructor(status: number, statusText: string, body: unknown);
+}
+/**
+ * Create a typesafe client for a contract
+ */
+export declare function createClient<T extends Contract>(contract: T, config: ClientConfig): Client<T>;
+/**
+ * Create a client without providing the contract at runtime
+ * Useful when you only need types and want a lighter bundle
+ */
+export declare function createTypedClient<T extends Contract>(_config: ClientConfig): Client<T>;

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@richie-rpc/client",
+  "version": "0.1.0",
+  "main": "./dist/cjs/index.cjs",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "require": "./dist/cjs/index.cjs",
+      "import": "./dist/mjs/index.mjs"
+    }
+  },
+  "dependencies": {
+    "@richie-rpc/core": "^0.1.0",
+    "zod": "^3.23.8"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "author": "Richie <oss@ricsam.dev>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ricsam/richie-rpc.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ricsam/richie-rpc/issues"
+  },
+  "homepage": "https://github.com/ricsam/richie-rpc#readme",
+  "keywords": [
+    "typescript",
+    "bun",
+    "zod",
+    "api",
+    "contract",
+    "rpc",
+    "rest",
+    "openapi",
+    "type-safe"
+  ],
+  "description": "Type-safe fetch client for Richie RPC contracts",
+  "module": "./dist/mjs/index.mjs",
+  "types": "./dist/types/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}