@richie-rpc/core 1.2.1 → 1.2.3

package/README.md

@@ -23,17 +23,17 @@ const contract = defineContract({
     params: z.object({ id: z.string() }),
     responses: {
       [Status.OK]: z.object({ id: z.string(), name: z.string() }),
-      [Status.NotFound]: z.object({ error: z.string() })
-    }
+      [Status.NotFound]: z.object({ error: z.string() }),
+    },
   },
   createUser: {
     method: 'POST',
     path: '/users',
     body: z.object({ name: z.string(), email: z.string().email() }),
     responses: {
-      [Status.Created]: z.object({ id: z.string(), name: z.string(), email: z.string() })
-    }
-  }
+      [Status.Created]: z.object({ id: z.string(), name: z.string(), email: z.string() }),
+    },
+  },
 });
 ```
 
@@ -47,17 +47,102 @@ Each endpoint can have:
 - `query` (optional): Zod schema for query parameters
 - `headers` (optional): Zod schema for request headers
 - `body` (optional): Zod schema for request body
+- `contentType` (optional): Request content type (`'application/json'` or `'multipart/form-data'`)
 - `responses` (required): Object mapping status codes to Zod schemas
 
+### Streaming Endpoint
+
+For AI-style streaming responses using NDJSON:
+
+```typescript
+const contract = defineContract({
+  generateText: {
+    type: 'streaming',
+    method: 'POST',
+    path: '/generate',
+    body: z.object({ prompt: z.string() }),
+    chunk: z.object({ text: z.string() }),
+    finalResponse: z.object({ totalTokens: z.number() }),
+  },
+});
+```
+
+- `type: 'streaming'` (required): Marks this as a streaming endpoint
+- `method` (required): Must be `'POST'`
+- `chunk` (required): Zod schema for each streamed chunk
+- `finalResponse` (optional): Zod schema for the final response after stream ends
+
+### SSE Endpoint
+
+For server-to-client event streaming:
+
+```typescript
+const contract = defineContract({
+  notifications: {
+    type: 'sse',
+    method: 'GET',
+    path: '/notifications',
+    query: z.object({ userId: z.string() }),
+    events: {
+      message: z.object({ text: z.string(), timestamp: z.string() }),
+      userJoined: z.object({ userId: z.string() }),
+      heartbeat: z.object({ timestamp: z.string() }),
+    },
+  },
+});
+```
+
+- `type: 'sse'` (required): Marks this as an SSE endpoint
+- `method` (required): Must be `'GET'`
+- `events` (required): Object mapping event names to Zod schemas
+
+### WebSocket Contract
+
+For bidirectional real-time communication, use `defineWebSocketContract`:
+
+```typescript
+import { defineWebSocketContract } from '@richie-rpc/core';
+
+const wsContract = defineWebSocketContract({
+  chat: {
+    path: '/ws/chat/:roomId',
+    params: z.object({ roomId: z.string() }),
+    query: z.object({ token: z.string().optional() }),
+    clientMessages: {
+      sendMessage: { payload: z.object({ text: z.string() }) },
+      typing: { payload: z.object({ isTyping: z.boolean() }) },
+    },
+    serverMessages: {
+      message: { payload: z.object({ userId: z.string(), text: z.string() }) },
+      userTyping: { payload: z.object({ userId: z.string(), isTyping: z.boolean() }) },
+      error: { payload: z.object({ code: z.string(), message: z.string() }) },
+    },
+  },
+});
+```
+
+- `path` (required): WebSocket endpoint path with optional parameters
+- `params` (optional): Zod schema for path parameters
+- `query` (optional): Zod schema for query parameters
+- `clientMessages` (required): Messages the client can send to the server
+- `serverMessages` (required): Messages the server can send to the client
+
+Each message type has a `payload` field with a Zod schema for validation.
+
 ## Features
 
 - ✅ Type-safe contract definitions
 - ✅ Zod v4+ schema validation
+- ✅ HTTP Streaming endpoints (NDJSON)
+- ✅ Server-Sent Events (SSE) endpoints
+- ✅ WebSocket contracts with typed messages
 - ✅ Path parameter parsing and interpolation
 - ✅ Query parameter handling
 - ✅ Multiple response types per endpoint
 - ✅ Full TypeScript inference
 - ✅ Status code constants for cleaner code
+- ✅ File uploads with `multipart/form-data` support
+- ✅ Nested file structures in request bodies
 
 ## Utilities
 
@@ -94,6 +179,71 @@ buildUrl('http://api.example.com/api', '/users');
 
 The `buildUrl` function properly concatenates the baseUrl with the path, supporting basePath prefixes in the baseUrl.
 
+### File Upload / FormData Utilities
+
+The core package provides utilities for handling `multipart/form-data` requests with nested file structures.
+
+#### Defining File Upload Endpoints
+
+Use `contentType: 'multipart/form-data'` and `z.instanceof(File)` in your body schema:
+
+```typescript
+import { defineContract, Status } from '@richie-rpc/core';
+import { z } from 'zod';
+
+const contract = defineContract({
+  uploadDocuments: {
+    method: 'POST',
+    path: '/upload',
+    contentType: 'multipart/form-data',
+    body: z.object({
+      documents: z.array(
+        z.object({
+          file: z.instanceof(File),
+          name: z.string(),
+          tags: z.array(z.string()).optional(),
+        }),
+      ),
+      category: z.string(),
+    }),
+    responses: {
+      [Status.Created]: z.object({
+        uploadedCount: z.number(),
+        filenames: z.array(z.string()),
+      }),
+    },
+  },
+});
+```
+
+#### How It Works
+
+FormData is inherently flat, but Richie RPC supports nested structures using a hybrid JSON + Files approach:
+
+1. **Client-side**: Files are extracted from the object and replaced with `{ __fileRef__: "path" }` placeholders. The JSON structure is sent as `__json__` and files are sent as separate FormData entries.
+
+2. **Server-side**: The JSON is parsed, and `__fileRef__` placeholders are replaced with actual File objects from the FormData.
+
+#### Utility Functions
+
+```typescript
+import { objectToFormData, formDataToObject } from '@richie-rpc/core';
+
+// Client-side: Convert object with Files to FormData
+const formData = objectToFormData({
+  documents: [
+    { file: file1, name: 'doc1.pdf' },
+    { file: file2, name: 'doc2.pdf' },
+  ],
+  category: 'reports',
+});
+// Result: FormData with __json__ + files at "documents.0.file", "documents.1.file"
+
+// Server-side: Convert FormData back to object with Files
+const obj = formDataToObject(formData);
+// Result: { documents: [{ file: File, name: 'doc1.pdf' }, ...], category: 'reports' }
+```
+
 ## Status Codes
 
 Use the `Status` const object for type-safe status codes:
@@ -108,9 +258,9 @@ const contract = defineContract({
     params: z.object({ id: z.string() }),
     responses: {
       [Status.OK]: UserSchema,
-      [Status.NotFound]: ErrorSchema
-    }
-  }
+      [Status.NotFound]: ErrorSchema,
+    },
+  },
 });
 ```
 
@@ -122,6 +272,7 @@ return { status: Status.NotFound, body: { error: 'Not found' } };
 ```
 
 **Available constants:**
+
 - Success: `OK` (200), `Created` (201), `Accepted` (202), `NoContent` (204)
 - Client Errors: `BadRequest` (400), `Unauthorized` (401), `Forbidden` (403), `NotFound` (404), `Conflict` (409), `UnprocessableEntity` (422), `TooManyRequests` (429)
 - Server Errors: `InternalServerError` (500), `BadGateway` (502), `ServiceUnavailable` (503)
@@ -139,8 +290,8 @@ const contract = defineContract({
       [Status.OK]: z.object({ message: z.string() }),
       418: z.object({ message: z.string() }), // I'm a teapot
       451: z.object({ reason: z.string() }), // Unavailable for legal reasons
-    }
-  }
+    },
+  },
 });
 ```
 
@@ -169,4 +320,3 @@ The package exports several utility types for extracting types from endpoint def
 ## License
 
 MIT
-

package/dist/cjs/index.cjs

@@ -3,6 +3,23 @@
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __reExport = (target, mod, secondTarget) => {
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(target, key) && key !== "default")
+      __defProp(target, key, {
+        get: () => mod[key],
+        enumerable: true
+      });
+  if (secondTarget) {
+    for (let key of __getOwnPropNames(mod))
+      if (!__hasOwnProp.call(secondTarget, key) && key !== "default")
+        __defProp(secondTarget, key, {
+          get: () => mod[key],
+          enumerable: true
+        });
+    return secondTarget;
+  }
+};
 var __moduleCache = /* @__PURE__ */ new WeakMap;
 var __toCommonJS = (from) => {
   var entry = __moduleCache.get(from), desc;
@@ -32,13 +49,16 @@ var exports_core = {};
 __export(exports_core, {
   parseQuery: () => parseQuery,
   parsePathParams: () => parsePathParams,
+  objectToFormData: () => objectToFormData,
   matchPath: () => matchPath,
   interpolatePath: () => interpolatePath,
+  formDataToObject: () => formDataToObject,
   defineContract: () => defineContract,
   buildUrl: () => buildUrl,
   Status: () => Status
 });
 module.exports = __toCommonJS(exports_core);
+__reExport(exports_core, require("./websocket.cjs"), module.exports);
 var Status = {
   OK: 200,
   Created: 201,
@@ -126,6 +146,58 @@ function parseQuery(searchParams) {
 function defineContract(contract) {
   return contract;
 }
+function objectToFormData(obj) {
+  const formData = new FormData;
+  const files = [];
+  function traverse(value, path) {
+    if (value instanceof File) {
+      files.push({ path, file: value });
+      return { __fileRef__: path };
+    }
+    if (Array.isArray(value)) {
+      return value.map((item, i) => traverse(item, `${path}.${i}`));
+    }
+    if (value && typeof value === "object") {
+      const result = {};
+      for (const [k, v] of Object.entries(value)) {
+        result[k] = traverse(v, path ? `${path}.${k}` : k);
+      }
+      return result;
+    }
+    return value;
+  }
+  const jsonWithRefs = traverse(obj, "");
+  formData.append("__json__", JSON.stringify(jsonWithRefs));
+  for (const { path, file } of files) {
+    formData.append(path, file);
+  }
+  return formData;
+}
+function formDataToObject(formData) {
+  const jsonStr = formData.get("__json__");
+  if (typeof jsonStr !== "string") {
+    return Object.fromEntries(formData.entries());
+  }
+  const obj = JSON.parse(jsonStr);
+  function replaceRefs(value) {
+    if (value && typeof value === "object" && "__fileRef__" in value) {
+      const path = value.__fileRef__;
+      return formData.get(path);
+    }
+    if (Array.isArray(value)) {
+      return value.map(replaceRefs);
+    }
+    if (value && typeof value === "object") {
+      const result = {};
+      for (const [k, v] of Object.entries(value)) {
+        result[k] = replaceRefs(v);
+      }
+      return result;
+    }
+    return value;
+  }
+  return replaceRefs(obj);
+}
 })
 
-//# debugId=ACC9A49236395C2D64756E2164756E21
+//# debugId=7092E09755013A0164756E2164756E21

package/dist/cjs/index.cjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../index.ts"],
   "sourcesContent": [
-    "import type { z } from 'zod';\n\n// HTTP methods supported\nexport type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';\n\n// HTTP status codes as const object for type-safe responses without 'as const'\nexport const Status = {\n  // Success responses\n  OK: 200 as const,\n  Created: 201 as const,\n  Accepted: 202 as const,\n  NoContent: 204 as const,\n\n  // Redirection\n  MovedPermanently: 301 as const,\n  Found: 302 as const,\n  NotModified: 304 as const,\n\n  // Client errors\n  BadRequest: 400 as const,\n  Unauthorized: 401 as const,\n  Forbidden: 403 as const,\n  NotFound: 404 as const,\n  MethodNotAllowed: 405 as const,\n  Conflict: 409 as const,\n  UnprocessableEntity: 422 as const,\n  TooManyRequests: 429 as const,\n\n  // Server errors\n  InternalServerError: 500 as const,\n  NotImplemented: 501 as const,\n  BadGateway: 502 as const,\n  ServiceUnavailable: 503 as const,\n  GatewayTimeout: 504 as const,\n} as const;\n\n// Endpoint definition structure\nexport interface EndpointDefinition {\n  method: HttpMethod;\n  path: string;\n  params?: z.ZodTypeAny;\n  query?: z.ZodTypeAny;\n  headers?: z.ZodTypeAny;\n  body?: z.ZodTypeAny;\n  responses: Record<number, z.ZodTypeAny>;\n}\n\n// Contract is a collection of named endpoints\nexport type Contract = Record<string, EndpointDefinition>;\n\n// Extract the Zod type from a schema\nexport type InferZodType<T> = T extends z.ZodTypeAny ? z.infer<T> : never;\n\n// Extract params type from endpoint\nexport type ExtractParams<T extends EndpointDefinition> = T['params'] extends z.ZodTypeAny\n  ? InferZodType<T['params']>\n  : never;\n\n// Extract query type from endpoint\nexport type ExtractQuery<T extends EndpointDefinition> = T['query'] extends z.ZodTypeAny\n  ? InferZodType<T['query']>\n  : never;\n\n// Extract headers type from endpoint\nexport type ExtractHeaders<T extends EndpointDefinition> = T['headers'] extends z.ZodTypeAny\n  ? InferZodType<T['headers']>\n  : never;\n\n// Extract body type from endpoint\nexport type ExtractBody<T extends EndpointDefinition> = T['body'] extends z.ZodTypeAny\n  ? InferZodType<T['body']>\n  : never;\n\n// Extract response types for all status codes\nexport type ExtractResponses<T extends EndpointDefinition> = {\n  [K in keyof T['responses']]: T['responses'][K] extends z.ZodTypeAny\n    ? InferZodType<T['responses'][K]>\n    : never;\n};\n\n// Extract a specific response type by status code\nexport type ExtractResponse<\n  T extends EndpointDefinition,\n  Status extends number,\n> = Status extends keyof T['responses']\n  ? T['responses'][Status] extends z.ZodTypeAny\n    ? InferZodType<T['responses'][Status]>\n    : never\n  : never;\n\n// Path parameter extraction utilities\nexport type ExtractPathParams<T extends string> =\n  T extends `${infer _Start}:${infer Param}/${infer Rest}`\n    ? Param | ExtractPathParams<`/${Rest}`>\n    : T extends `${infer _Start}:${infer Param}`\n      ? Param\n      : never;\n\n// Convert path params to object type\nexport type PathParamsObject<T extends string> = {\n  [K in ExtractPathParams<T>]: string;\n};\n\n/**\n * Parse path parameters from a URL path pattern\n * e.g., \"/users/:id/posts/:postId\" => [\"id\", \"postId\"]\n */\nexport function parsePathParams(path: string): string[] {\n  const matches = path.match(/:([^/]+)/g);\n  if (!matches) return [];\n  return matches.map((match) => match.slice(1));\n}\n\n/**\n * Match a URL path against a pattern and extract parameters\n * e.g., matchPath(\"/users/:id\", \"/users/123\") => { id: \"123\" }\n */\nexport function matchPath(pattern: string, path: string): Record<string, string> | null {\n  const paramNames = parsePathParams(pattern);\n\n  // Convert pattern to regex\n  const regexPattern = pattern.replace(/:[^/]+/g, '([^/]+)').replace(/\\//g, '\\\\/');\n\n  const regex = new RegExp(`^${regexPattern}$`);\n  const match = path.match(regex);\n\n  if (!match) return null;\n\n  const params: Record<string, string> = {};\n  paramNames.forEach((name, index) => {\n    params[name] = match[index + 1] ?? '';\n  });\n\n  return params;\n}\n\n/**\n * Interpolate path parameters into a URL pattern\n * e.g., interpolatePath(\"/users/:id\", { id: \"123\" }) => \"/users/123\"\n */\nexport function interpolatePath(pattern: string, params: Record<string, string | number>): string {\n  let result = pattern;\n  for (const [key, value] of Object.entries(params)) {\n    result = result.replace(`:${key}`, String(value));\n  }\n  return result;\n}\n\n/**\n * Build a complete URL with query parameters\n */\nexport function buildUrl(\n  baseUrl: string,\n  path: string,\n  query?: Record<string, string | number | boolean | string[]>,\n): string {\n  // Normalize baseUrl - remove trailing slash\n  const normalizedBase = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl;\n\n  // Ensure path starts with /\n  const normalizedPath = path.startsWith('/') ? path : `/${path}`;\n\n  // Concatenate base and path\n  const fullPath = normalizedBase + normalizedPath;\n\n  const url = new URL(fullPath);\n\n  if (query) {\n    for (const [key, value] of Object.entries(query)) {\n      if (value !== undefined && value !== null) {\n        if (Array.isArray(value)) {\n          for (const v of value) {\n            url.searchParams.append(key, String(v));\n          }\n        } else {\n          url.searchParams.append(key, String(value));\n        }\n      }\n    }\n  }\n\n  return url.toString();\n}\n\n/**\n * Parse query parameters from URLSearchParams\n */\nexport function parseQuery(searchParams: URLSearchParams): Record<string, string | string[]> {\n  const result: Record<string, string | string[]> = {};\n\n  for (const [key, value] of searchParams.entries()) {\n    const existing = result[key];\n    if (existing) {\n      if (Array.isArray(existing)) {\n        existing.push(value);\n      } else {\n        result[key] = [existing, value];\n      }\n    } else {\n      result[key] = value;\n    }\n  }\n\n  return result;\n}\n\n// Type helper to ensure a value is a valid contract\nexport function defineContract<T extends Contract>(contract: T): T {\n  return contract;\n}\n"
+    "import type { z } from 'zod';\n\n// HTTP methods supported\nexport type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';\n\n// Content types supported for request bodies\nexport type ContentType = 'application/json' | 'multipart/form-data';\n\n// HTTP status codes as const object for type-safe responses without 'as const'\nexport const Status = {\n  // Success responses\n  OK: 200 as const,\n  Created: 201 as const,\n  Accepted: 202 as const,\n  NoContent: 204 as const,\n\n  // Redirection\n  MovedPermanently: 301 as const,\n  Found: 302 as const,\n  NotModified: 304 as const,\n\n  // Client errors\n  BadRequest: 400 as const,\n  Unauthorized: 401 as const,\n  Forbidden: 403 as const,\n  NotFound: 404 as const,\n  MethodNotAllowed: 405 as const,\n  Conflict: 409 as const,\n  UnprocessableEntity: 422 as const,\n  TooManyRequests: 429 as const,\n\n  // Server errors\n  InternalServerError: 500 as const,\n  NotImplemented: 501 as const,\n  BadGateway: 502 as const,\n  ServiceUnavailable: 503 as const,\n  GatewayTimeout: 504 as const,\n} as const;\n\n// Base fields shared by all endpoint types\ninterface BaseEndpointFields {\n  path: string;\n  params?: z.ZodTypeAny;\n  query?: z.ZodTypeAny;\n  headers?: z.ZodTypeAny;\n}\n\n// Standard HTTP endpoint\nexport interface StandardEndpointDefinition extends BaseEndpointFields {\n  type: 'standard';\n  method: HttpMethod;\n  body?: z.ZodTypeAny;\n  contentType?: ContentType;\n  responses: Record<number, z.ZodTypeAny>;\n}\n\n// Streaming response endpoint (NDJSON)\nexport interface StreamingEndpointDefinition extends BaseEndpointFields {\n  type: 'streaming';\n  method: 'POST';\n  body?: z.ZodTypeAny;\n  contentType?: ContentType;\n  /** Schema for each NDJSON chunk (type inference only, not validated) */\n  chunk: z.ZodTypeAny;\n  /** Optional final response after stream ends */\n  finalResponse?: z.ZodTypeAny;\n  /** Error responses for non-streaming failures */\n  errorResponses?: Record<number, z.ZodTypeAny>;\n}\n\n// SSE endpoint\nexport interface SSEEndpointDefinition extends BaseEndpointFields {\n  type: 'sse';\n  method: 'GET';\n  /** Event types: key = event name, value = data schema (type inference only) */\n  events: Record<string, z.ZodTypeAny>;\n  /** Error responses for connection failures */\n  errorResponses?: Record<number, z.ZodTypeAny>;\n}\n\n// Download endpoint (binary file response)\nexport interface DownloadEndpointDefinition extends BaseEndpointFields {\n  type: 'download';\n  method: 'GET'; // Downloads are GET-only\n  /** Error responses (non-2xx status codes) */\n  errorResponses?: Record<number, z.ZodTypeAny>;\n}\n\n// Union of all endpoint types\nexport type AnyEndpointDefinition =\n  | StandardEndpointDefinition\n  | StreamingEndpointDefinition\n  | SSEEndpointDefinition\n  | DownloadEndpointDefinition;\n\n// Alias for backwards compatibility in type utilities\nexport type EndpointDefinition = AnyEndpointDefinition;\n\n// Contract is a collection of named endpoints\nexport type Contract = Record<string, AnyEndpointDefinition>;\n\n// Extract the Zod type from a schema\nexport type InferZodType<T> = T extends z.ZodTypeAny ? z.infer<T> : never;\n\n// Extract params type from endpoint\nexport type ExtractParams<T extends EndpointDefinition> = T['params'] extends z.ZodTypeAny\n  ? InferZodType<T['params']>\n  : never;\n\n// Extract query type from endpoint\nexport type ExtractQuery<T extends EndpointDefinition> = T['query'] extends z.ZodTypeAny\n  ? InferZodType<T['query']>\n  : never;\n\n// Extract headers type from endpoint\nexport type ExtractHeaders<T extends EndpointDefinition> = T['headers'] extends z.ZodTypeAny\n  ? InferZodType<T['headers']>\n  : never;\n\n// Extract body type from endpoint (only standard and streaming have body)\nexport type ExtractBody<T extends EndpointDefinition> = T extends { body: z.ZodTypeAny }\n  ? InferZodType<T['body']>\n  : never;\n\n// Extract response types for all status codes (only standard has responses)\nexport type ExtractResponses<T extends EndpointDefinition> = T extends {\n  responses: Record<number, z.ZodTypeAny>;\n}\n  ? {\n      [K in keyof T['responses']]: T['responses'][K] extends z.ZodTypeAny\n        ? InferZodType<T['responses'][K]>\n        : never;\n    }\n  : never;\n\n// Extract a specific response type by status code (only standard has responses)\nexport type ExtractResponse<T extends EndpointDefinition, Status extends number> = T extends {\n  responses: Record<number, z.ZodTypeAny>;\n}\n  ? Status extends keyof T['responses']\n    ? T['responses'][Status] extends z.ZodTypeAny\n      ? InferZodType<T['responses'][Status]>\n      : never\n    : never\n  : never;\n\n// Extract chunk type from streaming endpoint\nexport type ExtractChunk<T extends StreamingEndpointDefinition> = T['chunk'] extends z.ZodTypeAny\n  ? InferZodType<T['chunk']>\n  : never;\n\n// Extract final response type from streaming endpoint\nexport type ExtractFinalResponse<T extends StreamingEndpointDefinition> =\n  T['finalResponse'] extends z.ZodTypeAny ? InferZodType<T['finalResponse']> : undefined;\n\n// Extract SSE event union type\nexport type ExtractSSEEvents<T extends SSEEndpointDefinition> = {\n  [K in keyof T['events']]: {\n    event: K;\n    data: T['events'][K] extends z.ZodTypeAny ? InferZodType<T['events'][K]> : never;\n    id?: string;\n  };\n}[keyof T['events']];\n\n// Extract specific SSE event data type\nexport type ExtractSSEEventData<\n  T extends SSEEndpointDefinition,\n  K extends keyof T['events'],\n> = T['events'][K] extends z.ZodTypeAny ? InferZodType<T['events'][K]> : never;\n\n// Extract error responses for download endpoint\nexport type ExtractDownloadErrorResponse<\n  T extends DownloadEndpointDefinition,\n  Status extends keyof T['errorResponses'],\n> =\n  T['errorResponses'] extends Record<number, z.ZodTypeAny>\n    ? Status extends keyof T['errorResponses']\n      ? T['errorResponses'][Status] extends z.ZodTypeAny\n        ? InferZodType<T['errorResponses'][Status]>\n        : never\n      : never\n    : never;\n\n// Upload progress event\nexport interface UploadProgressEvent {\n  loaded: number;\n  total: number;\n  progress: number; // 0-1 (percentage as decimal)\n}\n\n// Download progress event\nexport interface DownloadProgressEvent {\n  loaded: number;\n  total: number;\n  progress: number; // 0-1 (percentage as decimal), NaN if total unknown\n}\n\n// Path parameter extraction utilities\nexport type ExtractPathParams<T extends string> =\n  T extends `${infer _Start}:${infer Param}/${infer Rest}`\n    ? Param | ExtractPathParams<`/${Rest}`>\n    : T extends `${infer _Start}:${infer Param}`\n      ? Param\n      : never;\n\n// Convert path params to object type\nexport type PathParamsObject<T extends string> = {\n  [K in ExtractPathParams<T>]: string;\n};\n\n/**\n * Parse path parameters from a URL path pattern\n * e.g., \"/users/:id/posts/:postId\" => [\"id\", \"postId\"]\n */\nexport function parsePathParams(path: string): string[] {\n  const matches = path.match(/:([^/]+)/g);\n  if (!matches) return [];\n  return matches.map((match) => match.slice(1));\n}\n\n/**\n * Match a URL path against a pattern and extract parameters\n * e.g., matchPath(\"/users/:id\", \"/users/123\") => { id: \"123\" }\n */\nexport function matchPath(pattern: string, path: string): Record<string, string> | null {\n  const paramNames = parsePathParams(pattern);\n\n  // Convert pattern to regex\n  const regexPattern = pattern.replace(/:[^/]+/g, '([^/]+)').replace(/\\//g, '\\\\/');\n\n  const regex = new RegExp(`^${regexPattern}$`);\n  const match = path.match(regex);\n\n  if (!match) return null;\n\n  const params: Record<string, string> = {};\n  paramNames.forEach((name, index) => {\n    params[name] = match[index + 1] ?? '';\n  });\n\n  return params;\n}\n\n/**\n * Interpolate path parameters into a URL pattern\n * e.g., interpolatePath(\"/users/:id\", { id: \"123\" }) => \"/users/123\"\n */\nexport function interpolatePath(pattern: string, params: Record<string, string | number>): string {\n  let result = pattern;\n  for (const [key, value] of Object.entries(params)) {\n    result = result.replace(`:${key}`, String(value));\n  }\n  return result;\n}\n\n/**\n * Build a complete URL with query parameters\n */\nexport function buildUrl(\n  baseUrl: string,\n  path: string,\n  query?: Record<string, string | number | boolean | string[]>,\n): string {\n  // Normalize baseUrl - remove trailing slash\n  const normalizedBase = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl;\n\n  // Ensure path starts with /\n  const normalizedPath = path.startsWith('/') ? path : `/${path}`;\n\n  // Concatenate base and path\n  const fullPath = normalizedBase + normalizedPath;\n\n  const url = new URL(fullPath);\n\n  if (query) {\n    for (const [key, value] of Object.entries(query)) {\n      if (value !== undefined && value !== null) {\n        if (Array.isArray(value)) {\n          for (const v of value) {\n            url.searchParams.append(key, String(v));\n          }\n        } else {\n          url.searchParams.append(key, String(value));\n        }\n      }\n    }\n  }\n\n  return url.toString();\n}\n\n/**\n * Parse query parameters from URLSearchParams\n */\nexport function parseQuery(searchParams: URLSearchParams): Record<string, string | string[]> {\n  const result: Record<string, string | string[]> = {};\n\n  for (const [key, value] of searchParams.entries()) {\n    const existing = result[key];\n    if (existing) {\n      if (Array.isArray(existing)) {\n        existing.push(value);\n      } else {\n        result[key] = [existing, value];\n      }\n    } else {\n      result[key] = value;\n    }\n  }\n\n  return result;\n}\n\n// Type helper to ensure a value is a valid contract\nexport function defineContract<T extends Contract>(contract: T): T {\n  return contract;\n}\n\n/**\n * Convert an object to FormData using the hybrid JSON + Files approach.\n * Files are extracted and replaced with { __fileRef__: \"path\" } placeholders.\n * The resulting FormData contains __json__ with the serialized structure\n * and individual file entries at their path keys.\n */\nexport function objectToFormData(obj: Record<string, unknown>): FormData {\n  const formData = new FormData();\n  const files: Array<{ path: string; file: File }> = [];\n\n  function traverse(value: unknown, path: string): unknown {\n    if (value instanceof File) {\n      files.push({ path, file: value });\n      return { __fileRef__: path };\n    }\n    if (Array.isArray(value)) {\n      return value.map((item, i) => traverse(item, `${path}.${i}`));\n    }\n    if (value && typeof value === 'object') {\n      const result: Record<string, unknown> = {};\n      for (const [k, v] of Object.entries(value)) {\n        result[k] = traverse(v, path ? `${path}.${k}` : k);\n      }\n      return result;\n    }\n    return value;\n  }\n\n  const jsonWithRefs = traverse(obj, '');\n  formData.append('__json__', JSON.stringify(jsonWithRefs));\n\n  for (const { path, file } of files) {\n    formData.append(path, file);\n  }\n\n  return formData;\n}\n\n/**\n * Parse FormData back to an object, reconstructing the structure with File objects.\n * Expects FormData created by objectToFormData with __json__ and file entries.\n * Falls back to simple Object.fromEntries for FormData without __json__.\n */\nexport function formDataToObject(formData: FormData): Record<string, unknown> {\n  const jsonStr = formData.get('__json__');\n  if (typeof jsonStr !== 'string') {\n    return Object.fromEntries(formData.entries());\n  }\n\n  const obj = JSON.parse(jsonStr);\n\n  function replaceRefs(value: unknown): unknown {\n    if (value && typeof value === 'object' && '__fileRef__' in value) {\n      const path = (value as { __fileRef__: string }).__fileRef__;\n      return formData.get(path);\n    }\n    if (Array.isArray(value)) {\n      return value.map(replaceRefs);\n    }\n    if (value && typeof value === 'object') {\n      const result: Record<string, unknown> = {};\n      for (const [k, v] of Object.entries(value)) {\n        result[k] = replaceRefs(v);\n      }\n      return result;\n    }\n    return value;\n  }\n\n  return replaceRefs(obj) as Record<string, unknown>;\n}\n\n// Re-export WebSocket types\nexport * from './websocket.cjs';\n"
   ],
-  "mappings": "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",
-  "debugId": "ACC9A49236395C2D64756E2164756E21",
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuYA;AA9XO,IAAM,SAAS;AAAA,EAEpB,IAAI;AAAA,EACJ,SAAS;AAAA,EACT,UAAU;AAAA,EACV,WAAW;AAAA,EAGX,kBAAkB;AAAA,EAClB,OAAO;AAAA,EACP,aAAa;AAAA,EAGb,YAAY;AAAA,EACZ,cAAc;AAAA,EACd,WAAW;AAAA,EACX,UAAU;AAAA,EACV,kBAAkB;AAAA,EAClB,UAAU;AAAA,EACV,qBAAqB;AAAA,EACrB,iBAAiB;AAAA,EAGjB,qBAAqB;AAAA,EACrB,gBAAgB;AAAA,EAChB,YAAY;AAAA,EACZ,oBAAoB;AAAA,EACpB,gBAAgB;AAClB;AAiLO,SAAS,eAAe,CAAC,MAAwB;AAAA,EACtD,MAAM,UAAU,KAAK,MAAM,WAAW;AAAA,EACtC,IAAI,CAAC;AAAA,IAAS,OAAO,CAAC;AAAA,EACtB,OAAO,QAAQ,IAAI,CAAC,UAAU,MAAM,MAAM,CAAC,CAAC;AAAA;AAOvC,SAAS,SAAS,CAAC,SAAiB,MAA6C;AAAA,EACtF,MAAM,aAAa,gBAAgB,OAAO;AAAA,EAG1C,MAAM,eAAe,QAAQ,QAAQ,WAAW,SAAS,EAAE,QAAQ,OAAO,KAAK;AAAA,EAE/E,MAAM,QAAQ,IAAI,OAAO,IAAI,eAAe;AAAA,EAC5C,MAAM,QAAQ,KAAK,MAAM,KAAK;AAAA,EAE9B,IAAI,CAAC;AAAA,IAAO,OAAO;AAAA,EAEnB,MAAM,SAAiC,CAAC;AAAA,EACxC,WAAW,QAAQ,CAAC,MAAM,UAAU;AAAA,IAClC,OAAO,QAAQ,MAAM,QAAQ,MAAM;AAAA,GACpC;AAAA,EAED,OAAO;AAAA;AAOF,SAAS,eAAe,CAAC,SAAiB,QAAiD;AAAA,EAChG,IAAI,SAAS;AAAA,EACb,YAAY,KAAK,UAAU,OAAO,QAAQ,MAAM,GAAG;AAAA,IACjD,SAAS,OAAO,QAAQ,IAAI,OAAO,OAAO,KAAK,CAAC;AAAA,EAClD;AAAA,EACA,OAAO;AAAA;AAMF,SAAS,QAAQ,CACtB,SACA,MACA,OACQ;AAAA,EAER,MAAM,iBAAiB,QAAQ,SAAS,GAAG,IAAI,QAAQ,MAAM,GAAG,EAAE,IAAI;AAAA,EAGtE,MAAM,iBAAiB,KAAK,WAAW,GAAG,IAAI,OAAO,IAAI;AAAA,EAGzD,MAAM,WAAW,iBAAiB;AAAA,EAElC,MAAM,MAAM,IAAI,IAAI,QAAQ;AAAA,EAE5B,IAAI,OAAO;AAAA,IACT,YAAY,KAAK,UAAU,OAAO,QAAQ,KAAK,GAAG;AAAA,MAChD,IAAI,UAAU,aAAa,UAAU,MAAM;AAAA,QACzC,IAAI,MAAM,QAAQ,KAAK,GAAG;AAAA,UACxB,WAAW,KAAK,OAAO;AAAA,YACrB,IAAI,aAAa,OAAO,KAAK,OAAO,CAAC,CAAC;AAAA,UACxC;AAAA,QACF,EAAO;AAAA,UACL,IAAI,aAAa,OAAO,KAAK,OAAO,KAAK,CAAC;AAAA;AAAA,MAE9C;AAAA,IACF;AAAA,EACF;AAAA,EAEA,OAAO,IAAI,SAAS;AAAA;AAMf,SAAS,UAAU,CAAC,cAAkE;AAAA,EAC3F,MAAM,SAA4C,CAAC;AAAA,EAEnD,YAAY,KAAK,UAAU,aAAa,QAAQ,GAAG;AAAA,IACjD,MAAM,WAAW,OAAO;AAAA,IACxB,IAAI,UAAU;AAAA,MACZ,IAAI,MAAM,QAAQ,QAAQ,GAAG;AAAA,QAC3B,SAAS,KAAK,KAAK;AAAA,MACrB,EAAO;AAAA,QACL,OAAO,OAAO,CAAC,UAAU,KAAK;AAAA;AAAA,IAElC,EAAO;AAAA,MACL,OAAO,OAAO;AAAA;AAAA,EAElB;AAAA,EAEA,OAAO;AAAA;AAIF,SAAS,cAAkC,CAAC,UAAgB;AAAA,EACjE,OAAO;AAAA;AASF,SAAS,gBAAgB,CAAC,KAAwC;AAAA,EACvE,MAAM,WAAW,IAAI;AAAA,EACrB,MAAM,QAA6C,CAAC;AAAA,EAEpD,SAAS,QAAQ,CAAC,OAAgB,MAAuB;AAAA,IACvD,IAAI,iBAAiB,MAAM;AAAA,MACzB,MAAM,KAAK,EAAE,MAAM,MAAM,MAAM,CAAC;AAAA,MAChC,OAAO,EAAE,aAAa,KAAK;AAAA,IAC7B;AAAA,IACA,IAAI,MAAM,QAAQ,KAAK,GAAG;AAAA,MACxB,OAAO,MAAM,IAAI,CAAC,MAAM,MAAM,SAAS,MAAM,GAAG,QAAQ,GAAG,CAAC;AAAA,IAC9D;AAAA,IACA,IAAI,SAAS,OAAO,UAAU,UAAU;AAAA,MACtC,MAAM,SAAkC,CAAC;AAAA,MACzC,YAAY,GAAG,MAAM,OAAO,QAAQ,KAAK,GAAG;AAAA,QAC1C,OAAO,KAAK,SAAS,GAAG,OAAO,GAAG,QAAQ,MAAM,CAAC;AAAA,MACnD;AAAA,MACA,OAAO;AAAA,IACT;AAAA,IACA,OAAO;AAAA;AAAA,EAGT,MAAM,eAAe,SAAS,KAAK,EAAE;AAAA,EACrC,SAAS,OAAO,YAAY,KAAK,UAAU,YAAY,CAAC;AAAA,EAExD,aAAa,MAAM,UAAU,OAAO;AAAA,IAClC,SAAS,OAAO,MAAM,IAAI;AAAA,EAC5B;AAAA,EAEA,OAAO;AAAA;AAQF,SAAS,gBAAgB,CAAC,UAA6C;AAAA,EAC5E,MAAM,UAAU,SAAS,IAAI,UAAU;AAAA,EACvC,IAAI,OAAO,YAAY,UAAU;AAAA,IAC/B,OAAO,OAAO,YAAY,SAAS,QAAQ,CAAC;AAAA,EAC9C;AAAA,EAEA,MAAM,MAAM,KAAK,MAAM,OAAO;AAAA,EAE9B,SAAS,WAAW,CAAC,OAAyB;AAAA,IAC5C,IAAI,SAAS,OAAO,UAAU,YAAY,iBAAiB,OAAO;AAAA,MAChE,MAAM,OAAQ,MAAkC;AAAA,MAChD,OAAO,SAAS,IAAI,IAAI;AAAA,IAC1B;AAAA,IACA,IAAI,MAAM,QAAQ,KAAK,GAAG;AAAA,MACxB,OAAO,MAAM,IAAI,WAAW;AAAA,IAC9B;AAAA,IACA,IAAI,SAAS,OAAO,UAAU,UAAU;AAAA,MACtC,MAAM,SAAkC,CAAC;AAAA,MACzC,YAAY,GAAG,MAAM,OAAO,QAAQ,KAAK,GAAG;AAAA,QAC1C,OAAO,KAAK,YAAY,CAAC;AAAA,MAC3B;AAAA,MACA,OAAO;AAAA,IACT;AAAA,IACA,OAAO;AAAA;AAAA,EAGT,OAAO,YAAY,GAAG;AAAA;",
+  "debugId": "7092E09755013A0164756E2164756E21",
   "names": []
 }

package/dist/cjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "@richie-rpc/core",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "type": "commonjs"
 }

package/dist/mjs/index.mjs

@@ -1,5 +1,6 @@
 // @bun
 // packages/core/index.ts
+export * from "./websocket.mjs";
 var Status = {
   OK: 200,
   Created: 201,
@@ -87,14 +88,68 @@ function parseQuery(searchParams) {
 function defineContract(contract) {
   return contract;
 }
+function objectToFormData(obj) {
+  const formData = new FormData;
+  const files = [];
+  function traverse(value, path) {
+    if (value instanceof File) {
+      files.push({ path, file: value });
+      return { __fileRef__: path };
+    }
+    if (Array.isArray(value)) {
+      return value.map((item, i) => traverse(item, `${path}.${i}`));
+    }
+    if (value && typeof value === "object") {
+      const result = {};
+      for (const [k, v] of Object.entries(value)) {
+        result[k] = traverse(v, path ? `${path}.${k}` : k);
+      }
+      return result;
+    }
+    return value;
+  }
+  const jsonWithRefs = traverse(obj, "");
+  formData.append("__json__", JSON.stringify(jsonWithRefs));
+  for (const { path, file } of files) {
+    formData.append(path, file);
+  }
+  return formData;
+}
+function formDataToObject(formData) {
+  const jsonStr = formData.get("__json__");
+  if (typeof jsonStr !== "string") {
+    return Object.fromEntries(formData.entries());
+  }
+  const obj = JSON.parse(jsonStr);
+  function replaceRefs(value) {
+    if (value && typeof value === "object" && "__fileRef__" in value) {
+      const path = value.__fileRef__;
+      return formData.get(path);
+    }
+    if (Array.isArray(value)) {
+      return value.map(replaceRefs);
+    }
+    if (value && typeof value === "object") {
+      const result = {};
+      for (const [k, v] of Object.entries(value)) {
+        result[k] = replaceRefs(v);
+      }
+      return result;
+    }
+    return value;
+  }
+  return replaceRefs(obj);
+}
 export {
   parseQuery,
   parsePathParams,
+  objectToFormData,
   matchPath,
   interpolatePath,
+  formDataToObject,
   defineContract,
   buildUrl,
   Status
 };
 
-//# debugId=6A3EE2DEC11404CC64756E2164756E21
+//# debugId=D33EA4F40F08382064756E2164756E21

package/dist/mjs/index.mjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../index.ts"],
   "sourcesContent": [
-    "import type { z } from 'zod';\n\n// HTTP methods supported\nexport type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';\n\n// HTTP status codes as const object for type-safe responses without 'as const'\nexport const Status = {\n  // Success responses\n  OK: 200 as const,\n  Created: 201 as const,\n  Accepted: 202 as const,\n  NoContent: 204 as const,\n\n  // Redirection\n  MovedPermanently: 301 as const,\n  Found: 302 as const,\n  NotModified: 304 as const,\n\n  // Client errors\n  BadRequest: 400 as const,\n  Unauthorized: 401 as const,\n  Forbidden: 403 as const,\n  NotFound: 404 as const,\n  MethodNotAllowed: 405 as const,\n  Conflict: 409 as const,\n  UnprocessableEntity: 422 as const,\n  TooManyRequests: 429 as const,\n\n  // Server errors\n  InternalServerError: 500 as const,\n  NotImplemented: 501 as const,\n  BadGateway: 502 as const,\n  ServiceUnavailable: 503 as const,\n  GatewayTimeout: 504 as const,\n} as const;\n\n// Endpoint definition structure\nexport interface EndpointDefinition {\n  method: HttpMethod;\n  path: string;\n  params?: z.ZodTypeAny;\n  query?: z.ZodTypeAny;\n  headers?: z.ZodTypeAny;\n  body?: z.ZodTypeAny;\n  responses: Record<number, z.ZodTypeAny>;\n}\n\n// Contract is a collection of named endpoints\nexport type Contract = Record<string, EndpointDefinition>;\n\n// Extract the Zod type from a schema\nexport type InferZodType<T> = T extends z.ZodTypeAny ? z.infer<T> : never;\n\n// Extract params type from endpoint\nexport type ExtractParams<T extends EndpointDefinition> = T['params'] extends z.ZodTypeAny\n  ? InferZodType<T['params']>\n  : never;\n\n// Extract query type from endpoint\nexport type ExtractQuery<T extends EndpointDefinition> = T['query'] extends z.ZodTypeAny\n  ? InferZodType<T['query']>\n  : never;\n\n// Extract headers type from endpoint\nexport type ExtractHeaders<T extends EndpointDefinition> = T['headers'] extends z.ZodTypeAny\n  ? InferZodType<T['headers']>\n  : never;\n\n// Extract body type from endpoint\nexport type ExtractBody<T extends EndpointDefinition> = T['body'] extends z.ZodTypeAny\n  ? InferZodType<T['body']>\n  : never;\n\n// Extract response types for all status codes\nexport type ExtractResponses<T extends EndpointDefinition> = {\n  [K in keyof T['responses']]: T['responses'][K] extends z.ZodTypeAny\n    ? InferZodType<T['responses'][K]>\n    : never;\n};\n\n// Extract a specific response type by status code\nexport type ExtractResponse<\n  T extends EndpointDefinition,\n  Status extends number,\n> = Status extends keyof T['responses']\n  ? T['responses'][Status] extends z.ZodTypeAny\n    ? InferZodType<T['responses'][Status]>\n    : never\n  : never;\n\n// Path parameter extraction utilities\nexport type ExtractPathParams<T extends string> =\n  T extends `${infer _Start}:${infer Param}/${infer Rest}`\n    ? Param | ExtractPathParams<`/${Rest}`>\n    : T extends `${infer _Start}:${infer Param}`\n      ? Param\n      : never;\n\n// Convert path params to object type\nexport type PathParamsObject<T extends string> = {\n  [K in ExtractPathParams<T>]: string;\n};\n\n/**\n * Parse path parameters from a URL path pattern\n * e.g., \"/users/:id/posts/:postId\" => [\"id\", \"postId\"]\n */\nexport function parsePathParams(path: string): string[] {\n  const matches = path.match(/:([^/]+)/g);\n  if (!matches) return [];\n  return matches.map((match) => match.slice(1));\n}\n\n/**\n * Match a URL path against a pattern and extract parameters\n * e.g., matchPath(\"/users/:id\", \"/users/123\") => { id: \"123\" }\n */\nexport function matchPath(pattern: string, path: string): Record<string, string> | null {\n  const paramNames = parsePathParams(pattern);\n\n  // Convert pattern to regex\n  const regexPattern = pattern.replace(/:[^/]+/g, '([^/]+)').replace(/\\//g, '\\\\/');\n\n  const regex = new RegExp(`^${regexPattern}$`);\n  const match = path.match(regex);\n\n  if (!match) return null;\n\n  const params: Record<string, string> = {};\n  paramNames.forEach((name, index) => {\n    params[name] = match[index + 1] ?? '';\n  });\n\n  return params;\n}\n\n/**\n * Interpolate path parameters into a URL pattern\n * e.g., interpolatePath(\"/users/:id\", { id: \"123\" }) => \"/users/123\"\n */\nexport function interpolatePath(pattern: string, params: Record<string, string | number>): string {\n  let result = pattern;\n  for (const [key, value] of Object.entries(params)) {\n    result = result.replace(`:${key}`, String(value));\n  }\n  return result;\n}\n\n/**\n * Build a complete URL with query parameters\n */\nexport function buildUrl(\n  baseUrl: string,\n  path: string,\n  query?: Record<string, string | number | boolean | string[]>,\n): string {\n  // Normalize baseUrl - remove trailing slash\n  const normalizedBase = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl;\n\n  // Ensure path starts with /\n  const normalizedPath = path.startsWith('/') ? path : `/${path}`;\n\n  // Concatenate base and path\n  const fullPath = normalizedBase + normalizedPath;\n\n  const url = new URL(fullPath);\n\n  if (query) {\n    for (const [key, value] of Object.entries(query)) {\n      if (value !== undefined && value !== null) {\n        if (Array.isArray(value)) {\n          for (const v of value) {\n            url.searchParams.append(key, String(v));\n          }\n        } else {\n          url.searchParams.append(key, String(value));\n        }\n      }\n    }\n  }\n\n  return url.toString();\n}\n\n/**\n * Parse query parameters from URLSearchParams\n */\nexport function parseQuery(searchParams: URLSearchParams): Record<string, string | string[]> {\n  const result: Record<string, string | string[]> = {};\n\n  for (const [key, value] of searchParams.entries()) {\n    const existing = result[key];\n    if (existing) {\n      if (Array.isArray(existing)) {\n        existing.push(value);\n      } else {\n        result[key] = [existing, value];\n      }\n    } else {\n      result[key] = value;\n    }\n  }\n\n  return result;\n}\n\n// Type helper to ensure a value is a valid contract\nexport function defineContract<T extends Contract>(contract: T): T {\n  return contract;\n}\n"
+    "import type { z } from 'zod';\n\n// HTTP methods supported\nexport type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';\n\n// Content types supported for request bodies\nexport type ContentType = 'application/json' | 'multipart/form-data';\n\n// HTTP status codes as const object for type-safe responses without 'as const'\nexport const Status = {\n  // Success responses\n  OK: 200 as const,\n  Created: 201 as const,\n  Accepted: 202 as const,\n  NoContent: 204 as const,\n\n  // Redirection\n  MovedPermanently: 301 as const,\n  Found: 302 as const,\n  NotModified: 304 as const,\n\n  // Client errors\n  BadRequest: 400 as const,\n  Unauthorized: 401 as const,\n  Forbidden: 403 as const,\n  NotFound: 404 as const,\n  MethodNotAllowed: 405 as const,\n  Conflict: 409 as const,\n  UnprocessableEntity: 422 as const,\n  TooManyRequests: 429 as const,\n\n  // Server errors\n  InternalServerError: 500 as const,\n  NotImplemented: 501 as const,\n  BadGateway: 502 as const,\n  ServiceUnavailable: 503 as const,\n  GatewayTimeout: 504 as const,\n} as const;\n\n// Base fields shared by all endpoint types\ninterface BaseEndpointFields {\n  path: string;\n  params?: z.ZodTypeAny;\n  query?: z.ZodTypeAny;\n  headers?: z.ZodTypeAny;\n}\n\n// Standard HTTP endpoint\nexport interface StandardEndpointDefinition extends BaseEndpointFields {\n  type: 'standard';\n  method: HttpMethod;\n  body?: z.ZodTypeAny;\n  contentType?: ContentType;\n  responses: Record<number, z.ZodTypeAny>;\n}\n\n// Streaming response endpoint (NDJSON)\nexport interface StreamingEndpointDefinition extends BaseEndpointFields {\n  type: 'streaming';\n  method: 'POST';\n  body?: z.ZodTypeAny;\n  contentType?: ContentType;\n  /** Schema for each NDJSON chunk (type inference only, not validated) */\n  chunk: z.ZodTypeAny;\n  /** Optional final response after stream ends */\n  finalResponse?: z.ZodTypeAny;\n  /** Error responses for non-streaming failures */\n  errorResponses?: Record<number, z.ZodTypeAny>;\n}\n\n// SSE endpoint\nexport interface SSEEndpointDefinition extends BaseEndpointFields {\n  type: 'sse';\n  method: 'GET';\n  /** Event types: key = event name, value = data schema (type inference only) */\n  events: Record<string, z.ZodTypeAny>;\n  /** Error responses for connection failures */\n  errorResponses?: Record<number, z.ZodTypeAny>;\n}\n\n// Download endpoint (binary file response)\nexport interface DownloadEndpointDefinition extends BaseEndpointFields {\n  type: 'download';\n  method: 'GET'; // Downloads are GET-only\n  /** Error responses (non-2xx status codes) */\n  errorResponses?: Record<number, z.ZodTypeAny>;\n}\n\n// Union of all endpoint types\nexport type AnyEndpointDefinition =\n  | StandardEndpointDefinition\n  | StreamingEndpointDefinition\n  | SSEEndpointDefinition\n  | DownloadEndpointDefinition;\n\n// Alias for backwards compatibility in type utilities\nexport type EndpointDefinition = AnyEndpointDefinition;\n\n// Contract is a collection of named endpoints\nexport type Contract = Record<string, AnyEndpointDefinition>;\n\n// Extract the Zod type from a schema\nexport type InferZodType<T> = T extends z.ZodTypeAny ? z.infer<T> : never;\n\n// Extract params type from endpoint\nexport type ExtractParams<T extends EndpointDefinition> = T['params'] extends z.ZodTypeAny\n  ? InferZodType<T['params']>\n  : never;\n\n// Extract query type from endpoint\nexport type ExtractQuery<T extends EndpointDefinition> = T['query'] extends z.ZodTypeAny\n  ? InferZodType<T['query']>\n  : never;\n\n// Extract headers type from endpoint\nexport type ExtractHeaders<T extends EndpointDefinition> = T['headers'] extends z.ZodTypeAny\n  ? InferZodType<T['headers']>\n  : never;\n\n// Extract body type from endpoint (only standard and streaming have body)\nexport type ExtractBody<T extends EndpointDefinition> = T extends { body: z.ZodTypeAny }\n  ? InferZodType<T['body']>\n  : never;\n\n// Extract response types for all status codes (only standard has responses)\nexport type ExtractResponses<T extends EndpointDefinition> = T extends {\n  responses: Record<number, z.ZodTypeAny>;\n}\n  ? {\n      [K in keyof T['responses']]: T['responses'][K] extends z.ZodTypeAny\n        ? InferZodType<T['responses'][K]>\n        : never;\n    }\n  : never;\n\n// Extract a specific response type by status code (only standard has responses)\nexport type ExtractResponse<T extends EndpointDefinition, Status extends number> = T extends {\n  responses: Record<number, z.ZodTypeAny>;\n}\n  ? Status extends keyof T['responses']\n    ? T['responses'][Status] extends z.ZodTypeAny\n      ? InferZodType<T['responses'][Status]>\n      : never\n    : never\n  : never;\n\n// Extract chunk type from streaming endpoint\nexport type ExtractChunk<T extends StreamingEndpointDefinition> = T['chunk'] extends z.ZodTypeAny\n  ? InferZodType<T['chunk']>\n  : never;\n\n// Extract final response type from streaming endpoint\nexport type ExtractFinalResponse<T extends StreamingEndpointDefinition> =\n  T['finalResponse'] extends z.ZodTypeAny ? InferZodType<T['finalResponse']> : undefined;\n\n// Extract SSE event union type\nexport type ExtractSSEEvents<T extends SSEEndpointDefinition> = {\n  [K in keyof T['events']]: {\n    event: K;\n    data: T['events'][K] extends z.ZodTypeAny ? InferZodType<T['events'][K]> : never;\n    id?: string;\n  };\n}[keyof T['events']];\n\n// Extract specific SSE event data type\nexport type ExtractSSEEventData<\n  T extends SSEEndpointDefinition,\n  K extends keyof T['events'],\n> = T['events'][K] extends z.ZodTypeAny ? InferZodType<T['events'][K]> : never;\n\n// Extract error responses for download endpoint\nexport type ExtractDownloadErrorResponse<\n  T extends DownloadEndpointDefinition,\n  Status extends keyof T['errorResponses'],\n> =\n  T['errorResponses'] extends Record<number, z.ZodTypeAny>\n    ? Status extends keyof T['errorResponses']\n      ? T['errorResponses'][Status] extends z.ZodTypeAny\n        ? InferZodType<T['errorResponses'][Status]>\n        : never\n      : never\n    : never;\n\n// Upload progress event\nexport interface UploadProgressEvent {\n  loaded: number;\n  total: number;\n  progress: number; // 0-1 (percentage as decimal)\n}\n\n// Download progress event\nexport interface DownloadProgressEvent {\n  loaded: number;\n  total: number;\n  progress: number; // 0-1 (percentage as decimal), NaN if total unknown\n}\n\n// Path parameter extraction utilities\nexport type ExtractPathParams<T extends string> =\n  T extends `${infer _Start}:${infer Param}/${infer Rest}`\n    ? Param | ExtractPathParams<`/${Rest}`>\n    : T extends `${infer _Start}:${infer Param}`\n      ? Param\n      : never;\n\n// Convert path params to object type\nexport type PathParamsObject<T extends string> = {\n  [K in ExtractPathParams<T>]: string;\n};\n\n/**\n * Parse path parameters from a URL path pattern\n * e.g., \"/users/:id/posts/:postId\" => [\"id\", \"postId\"]\n */\nexport function parsePathParams(path: string): string[] {\n  const matches = path.match(/:([^/]+)/g);\n  if (!matches) return [];\n  return matches.map((match) => match.slice(1));\n}\n\n/**\n * Match a URL path against a pattern and extract parameters\n * e.g., matchPath(\"/users/:id\", \"/users/123\") => { id: \"123\" }\n */\nexport function matchPath(pattern: string, path: string): Record<string, string> | null {\n  const paramNames = parsePathParams(pattern);\n\n  // Convert pattern to regex\n  const regexPattern = pattern.replace(/:[^/]+/g, '([^/]+)').replace(/\\//g, '\\\\/');\n\n  const regex = new RegExp(`^${regexPattern}$`);\n  const match = path.match(regex);\n\n  if (!match) return null;\n\n  const params: Record<string, string> = {};\n  paramNames.forEach((name, index) => {\n    params[name] = match[index + 1] ?? '';\n  });\n\n  return params;\n}\n\n/**\n * Interpolate path parameters into a URL pattern\n * e.g., interpolatePath(\"/users/:id\", { id: \"123\" }) => \"/users/123\"\n */\nexport function interpolatePath(pattern: string, params: Record<string, string | number>): string {\n  let result = pattern;\n  for (const [key, value] of Object.entries(params)) {\n    result = result.replace(`:${key}`, String(value));\n  }\n  return result;\n}\n\n/**\n * Build a complete URL with query parameters\n */\nexport function buildUrl(\n  baseUrl: string,\n  path: string,\n  query?: Record<string, string | number | boolean | string[]>,\n): string {\n  // Normalize baseUrl - remove trailing slash\n  const normalizedBase = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl;\n\n  // Ensure path starts with /\n  const normalizedPath = path.startsWith('/') ? path : `/${path}`;\n\n  // Concatenate base and path\n  const fullPath = normalizedBase + normalizedPath;\n\n  const url = new URL(fullPath);\n\n  if (query) {\n    for (const [key, value] of Object.entries(query)) {\n      if (value !== undefined && value !== null) {\n        if (Array.isArray(value)) {\n          for (const v of value) {\n            url.searchParams.append(key, String(v));\n          }\n        } else {\n          url.searchParams.append(key, String(value));\n        }\n      }\n    }\n  }\n\n  return url.toString();\n}\n\n/**\n * Parse query parameters from URLSearchParams\n */\nexport function parseQuery(searchParams: URLSearchParams): Record<string, string | string[]> {\n  const result: Record<string, string | string[]> = {};\n\n  for (const [key, value] of searchParams.entries()) {\n    const existing = result[key];\n    if (existing) {\n      if (Array.isArray(existing)) {\n        existing.push(value);\n      } else {\n        result[key] = [existing, value];\n      }\n    } else {\n      result[key] = value;\n    }\n  }\n\n  return result;\n}\n\n// Type helper to ensure a value is a valid contract\nexport function defineContract<T extends Contract>(contract: T): T {\n  return contract;\n}\n\n/**\n * Convert an object to FormData using the hybrid JSON + Files approach.\n * Files are extracted and replaced with { __fileRef__: \"path\" } placeholders.\n * The resulting FormData contains __json__ with the serialized structure\n * and individual file entries at their path keys.\n */\nexport function objectToFormData(obj: Record<string, unknown>): FormData {\n  const formData = new FormData();\n  const files: Array<{ path: string; file: File }> = [];\n\n  function traverse(value: unknown, path: string): unknown {\n    if (value instanceof File) {\n      files.push({ path, file: value });\n      return { __fileRef__: path };\n    }\n    if (Array.isArray(value)) {\n      return value.map((item, i) => traverse(item, `${path}.${i}`));\n    }\n    if (value && typeof value === 'object') {\n      const result: Record<string, unknown> = {};\n      for (const [k, v] of Object.entries(value)) {\n        result[k] = traverse(v, path ? `${path}.${k}` : k);\n      }\n      return result;\n    }\n    return value;\n  }\n\n  const jsonWithRefs = traverse(obj, '');\n  formData.append('__json__', JSON.stringify(jsonWithRefs));\n\n  for (const { path, file } of files) {\n    formData.append(path, file);\n  }\n\n  return formData;\n}\n\n/**\n * Parse FormData back to an object, reconstructing the structure with File objects.\n * Expects FormData created by objectToFormData with __json__ and file entries.\n * Falls back to simple Object.fromEntries for FormData without __json__.\n */\nexport function formDataToObject(formData: FormData): Record<string, unknown> {\n  const jsonStr = formData.get('__json__');\n  if (typeof jsonStr !== 'string') {\n    return Object.fromEntries(formData.entries());\n  }\n\n  const obj = JSON.parse(jsonStr);\n\n  function replaceRefs(value: unknown): unknown {\n    if (value && typeof value === 'object' && '__fileRef__' in value) {\n      const path = (value as { __fileRef__: string }).__fileRef__;\n      return formData.get(path);\n    }\n    if (Array.isArray(value)) {\n      return value.map(replaceRefs);\n    }\n    if (value && typeof value === 'object') {\n      const result: Record<string, unknown> = {};\n      for (const [k, v] of Object.entries(value)) {\n        result[k] = replaceRefs(v);\n      }\n      return result;\n    }\n    return value;\n  }\n\n  return replaceRefs(obj) as Record<string, unknown>;\n}\n\n// Re-export WebSocket types\nexport * from './websocket.mjs';\n"
   ],
-  "mappings": "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",
-  "debugId": "6A3EE2DEC11404CC64756E2164756E21",
+  "mappings": "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",
+  "debugId": "D33EA4F40F08382064756E2164756E21",
   "names": []
 }

package/dist/mjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "@richie-rpc/core",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "type": "module"
 }

package/dist/types/index.d.ts

@@ -1,5 +1,6 @@
 import type { z } from 'zod';
 export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';
+export type ContentType = 'application/json' | 'multipart/form-data';
 export declare const Status: {
     readonly OK: 200;
     readonly Created: 201;
@@ -22,25 +23,84 @@ export declare const Status: {
     readonly ServiceUnavailable: 503;
     readonly GatewayTimeout: 504;
 };
-export interface EndpointDefinition {
-    method: HttpMethod;
+interface BaseEndpointFields {
     path: string;
     params?: z.ZodTypeAny;
     query?: z.ZodTypeAny;
     headers?: z.ZodTypeAny;
+}
+export interface StandardEndpointDefinition extends BaseEndpointFields {
+    type: 'standard';
+    method: HttpMethod;
     body?: z.ZodTypeAny;
+    contentType?: ContentType;
     responses: Record<number, z.ZodTypeAny>;
 }
-export type Contract = Record<string, EndpointDefinition>;
+export interface StreamingEndpointDefinition extends BaseEndpointFields {
+    type: 'streaming';
+    method: 'POST';
+    body?: z.ZodTypeAny;
+    contentType?: ContentType;
+    /** Schema for each NDJSON chunk (type inference only, not validated) */
+    chunk: z.ZodTypeAny;
+    /** Optional final response after stream ends */
+    finalResponse?: z.ZodTypeAny;
+    /** Error responses for non-streaming failures */
+    errorResponses?: Record<number, z.ZodTypeAny>;
+}
+export interface SSEEndpointDefinition extends BaseEndpointFields {
+    type: 'sse';
+    method: 'GET';
+    /** Event types: key = event name, value = data schema (type inference only) */
+    events: Record<string, z.ZodTypeAny>;
+    /** Error responses for connection failures */
+    errorResponses?: Record<number, z.ZodTypeAny>;
+}
+export interface DownloadEndpointDefinition extends BaseEndpointFields {
+    type: 'download';
+    method: 'GET';
+    /** Error responses (non-2xx status codes) */
+    errorResponses?: Record<number, z.ZodTypeAny>;
+}
+export type AnyEndpointDefinition = StandardEndpointDefinition | StreamingEndpointDefinition | SSEEndpointDefinition | DownloadEndpointDefinition;
+export type EndpointDefinition = AnyEndpointDefinition;
+export type Contract = Record<string, AnyEndpointDefinition>;
 export type InferZodType<T> = T extends z.ZodTypeAny ? z.infer<T> : never;
 export type ExtractParams<T extends EndpointDefinition> = T['params'] extends z.ZodTypeAny ? InferZodType<T['params']> : never;
 export type ExtractQuery<T extends EndpointDefinition> = T['query'] extends z.ZodTypeAny ? InferZodType<T['query']> : never;
 export type ExtractHeaders<T extends EndpointDefinition> = T['headers'] extends z.ZodTypeAny ? InferZodType<T['headers']> : never;
-export type ExtractBody<T extends EndpointDefinition> = T['body'] extends z.ZodTypeAny ? InferZodType<T['body']> : never;
-export type ExtractResponses<T extends EndpointDefinition> = {
+export type ExtractBody<T extends EndpointDefinition> = T extends {
+    body: z.ZodTypeAny;
+} ? InferZodType<T['body']> : never;
+export type ExtractResponses<T extends EndpointDefinition> = T extends {
+    responses: Record<number, z.ZodTypeAny>;
+} ? {
     [K in keyof T['responses']]: T['responses'][K] extends z.ZodTypeAny ? InferZodType<T['responses'][K]> : never;
-};
-export type ExtractResponse<T extends EndpointDefinition, Status extends number> = Status extends keyof T['responses'] ? T['responses'][Status] extends z.ZodTypeAny ? InferZodType<T['responses'][Status]> : never : never;
+} : never;
+export type ExtractResponse<T extends EndpointDefinition, Status extends number> = T extends {
+    responses: Record<number, z.ZodTypeAny>;
+} ? Status extends keyof T['responses'] ? T['responses'][Status] extends z.ZodTypeAny ? InferZodType<T['responses'][Status]> : never : never : never;
+export type ExtractChunk<T extends StreamingEndpointDefinition> = T['chunk'] extends z.ZodTypeAny ? InferZodType<T['chunk']> : never;
+export type ExtractFinalResponse<T extends StreamingEndpointDefinition> = T['finalResponse'] extends z.ZodTypeAny ? InferZodType<T['finalResponse']> : undefined;
+export type ExtractSSEEvents<T extends SSEEndpointDefinition> = {
+    [K in keyof T['events']]: {
+        event: K;
+        data: T['events'][K] extends z.ZodTypeAny ? InferZodType<T['events'][K]> : never;
+        id?: string;
+    };
+}[keyof T['events']];
+export type ExtractSSEEventData<T extends SSEEndpointDefinition, K extends keyof T['events']> = T['events'][K] extends z.ZodTypeAny ? InferZodType<T['events'][K]> : never;
+export type ExtractDownloadErrorResponse<T extends DownloadEndpointDefinition, Status extends keyof T['errorResponses']> = T['errorResponses'] extends Record<number, z.ZodTypeAny> ? Status extends keyof T['errorResponses'] ? T['errorResponses'][Status] extends z.ZodTypeAny ? InferZodType<T['errorResponses'][Status]> : never : never : never;
+export interface UploadProgressEvent {
+    loaded: number;
+    total: number;
+    progress: number;
+}
+export interface DownloadProgressEvent {
+    loaded: number;
+    total: number;
+    progress: number;
+}
 export type ExtractPathParams<T extends string> = T extends `${infer _Start}:${infer Param}/${infer Rest}` ? Param | ExtractPathParams<`/${Rest}`> : T extends `${infer _Start}:${infer Param}` ? Param : never;
 export type PathParamsObject<T extends string> = {
     [K in ExtractPathParams<T>]: string;
@@ -69,3 +129,17 @@ export declare function buildUrl(baseUrl: string, path: string, query?: Record<s
  */
 export declare function parseQuery(searchParams: URLSearchParams): Record<string, string | string[]>;
 export declare function defineContract<T extends Contract>(contract: T): T;
+/**
+ * Convert an object to FormData using the hybrid JSON + Files approach.
+ * Files are extracted and replaced with { __fileRef__: "path" } placeholders.
+ * The resulting FormData contains __json__ with the serialized structure
+ * and individual file entries at their path keys.
+ */
+export declare function objectToFormData(obj: Record<string, unknown>): FormData;
+/**
+ * Parse FormData back to an object, reconstructing the structure with File objects.
+ * Expects FormData created by objectToFormData with __json__ and file entries.
+ * Falls back to simple Object.fromEntries for FormData without __json__.
+ */
+export declare function formDataToObject(formData: FormData): Record<string, unknown>;
+export * from './websocket';

package/dist/types/websocket.d.ts

@@ -0,0 +1,66 @@
+import type { z } from 'zod';
+/**
+ * Definition for a single message type in WebSocket communication
+ */
+export interface WebSocketMessageDefinition {
+    payload: z.ZodTypeAny;
+}
+/**
+ * Definition for a WebSocket endpoint contract
+ */
+export interface WebSocketContractDefinition {
+    path: string;
+    params?: z.ZodTypeAny;
+    query?: z.ZodTypeAny;
+    headers?: z.ZodTypeAny;
+    /** Messages client sends to server (validated with Zod on server) */
+    clientMessages: Record<string, WebSocketMessageDefinition>;
+    /** Messages server sends to client (type inference only, NOT validated) */
+    serverMessages: Record<string, WebSocketMessageDefinition>;
+}
+/**
+ * A collection of named WebSocket endpoints
+ */
+export type WebSocketContract = Record<string, WebSocketContractDefinition>;
+/**
+ * Extract the union type of all client messages for a WebSocket endpoint
+ */
+export type ExtractClientMessage<T extends WebSocketContractDefinition> = {
+    [K in keyof T['clientMessages']]: {
+        type: K;
+        payload: z.infer<T['clientMessages'][K]['payload']>;
+    };
+}[keyof T['clientMessages']];
+/**
+ * Extract the union type of all server messages for a WebSocket endpoint
+ */
+export type ExtractServerMessage<T extends WebSocketContractDefinition> = {
+    [K in keyof T['serverMessages']]: {
+        type: K;
+        payload: z.infer<T['serverMessages'][K]['payload']>;
+    };
+}[keyof T['serverMessages']];
+/**
+ * Extract the payload type for a specific client message
+ */
+export type ExtractClientMessagePayload<T extends WebSocketContractDefinition, K extends keyof T['clientMessages']> = z.infer<T['clientMessages'][K]['payload']>;
+/**
+ * Extract the payload type for a specific server message
+ */
+export type ExtractServerMessagePayload<T extends WebSocketContractDefinition, K extends keyof T['serverMessages']> = z.infer<T['serverMessages'][K]['payload']>;
+/**
+ * Extract params type from WebSocket endpoint
+ */
+export type ExtractWSParams<T extends WebSocketContractDefinition> = T['params'] extends z.ZodTypeAny ? z.infer<T['params']> : never;
+/**
+ * Extract query type from WebSocket endpoint
+ */
+export type ExtractWSQuery<T extends WebSocketContractDefinition> = T['query'] extends z.ZodTypeAny ? z.infer<T['query']> : never;
+/**
+ * Extract headers type from WebSocket endpoint
+ */
+export type ExtractWSHeaders<T extends WebSocketContractDefinition> = T['headers'] extends z.ZodTypeAny ? z.infer<T['headers']> : never;
+/**
+ * Type helper to ensure a value is a valid WebSocket contract
+ */
+export declare function defineWebSocketContract<T extends WebSocketContract>(contract: T): T;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@richie-rpc/core",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "main": "./dist/cjs/index.cjs",
   "exports": {
     ".": {